Module: Insika

Defined in:: lib/insika/evals/golden.rb,
lib/insika/dsl.rb,
lib/insika/pack.rb,
lib/insika/event.rb,
lib/insika/hooks.rb,
lib/insika/store.rb,
lib/insika/doctor.rb,
lib/insika/errors.rb,
lib/insika/plugin.rb,
lib/insika/command.rb,
lib/insika/sandbox.rb,
lib/insika/version.rb,
lib/insika/coercion.rb,
lib/insika/executor.rb,
lib/insika/recovery.rb,
lib/insika/registry.rb,
lib/insika/shutdown.rb,
lib/insika/workflow.rb,
lib/insika/allowlist.rb,
lib/insika/mcp_store.rb,
lib/insika/telemetry.rb,
lib/insika/checkpoint.rb,
lib/insika/dsl/system.rb,
lib/insika/env_schema.rb,
lib/insika/middleware.rb,
lib/insika/onboarding.rb,
lib/insika/server/app.rb,
lib/insika/task_actor.rb,
lib/insika/task_store.rb,
lib/insika/tool_store.rb,
lib/insika/turn_state.rb,
lib/insika/command_bus.rb,
lib/insika/dsl/runtime.rb,
lib/insika/evals/judge.rb,
lib/insika/frontmatter.rb,
lib/insika/http_client.rb,
lib/insika/inbound_log.rb,
lib/insika/server/boot.rb,
lib/insika/skill_store.rb,
lib/insika/turn_output.rb,
lib/insika/turn_timing.rb,
lib/insika/channels/web.rb,
lib/insika/chat_builder.rb,
lib/insika/config_store.rb,
lib/insika/edge_limiter.rb,
lib/insika/egress_guard.rb,
lib/insika/evals/report.rb,
lib/insika/evals/runner.rb,
lib/insika/event_stream.rb,
lib/insika/golden_store.rb,
lib/insika/memory_store.rb,
lib/insika/model_policy.rb,
lib/insika/outbox_store.rb,
lib/insika/queue_policy.rb,
lib/insika/schema_guard.rb,
lib/insika/tool_catalog.rb,
lib/insika/usage_ledger.rb,
lib/insika/wiring/graph.rb,
lib/insika/agent_profile.rb,
lib/insika/pack_importer.rb,
lib/insika/plugin/loader.rb,
lib/insika/policy/engine.rb,
lib/insika/policy/policy.rb,
lib/insika/safety/config.rb,
lib/insika/sandbox/local.rb,
lib/insika/session_actor.rb,
lib/insika/session_store.rb,
lib/insika/skill_catalog.rb,
lib/insika/stores/memory.rb,
lib/insika/stores/sqlite.rb,
lib/insika/tool_assembly.rb,
lib/insika/tool_envelope.rb,
lib/insika/tool_manifest.rb,
lib/insika/tool_registry.rb,
lib/insika/baseline_store.rb,
lib/insika/channels/relay.rb,
lib/insika/dsl/definition.rb,
lib/insika/evals/baseline.rb,
lib/insika/evals/pairwise.rb,
lib/insika/message_origin.rb,
lib/insika/model_resolver.rb,
lib/insika/profile_source.rb,
lib/insika/prompt_catalog.rb,
lib/insika/safety/factory.rb,
lib/insika/sandbox/docker.rb,
lib/insika/sandbox/runner.rb,
lib/insika/secret_masking.rb,
lib/insika/server/a2a/app.rb,
lib/insika/settings_store.rb,
lib/insika/steer_injector.rb,
lib/insika/subagent_graph.rb,
lib/insika/tools/remember.rb,
lib/insika/tools/subagent.rb,
lib/insika/context/builder.rb,
lib/insika/dsl/server_boot.rb,
lib/insika/evals/transport.rb,
lib/insika/mcp_http_client.rb,
lib/insika/model_selection.rb,
lib/insika/policy_registry.rb,
lib/insika/refinement/gate.rb,
lib/insika/server/a2a/http.rb,
lib/insika/server/rack_app.rb,
lib/insika/server/sse_body.rb,
lib/insika/token_estimator.rb,
lib/insika/tool_definition.rb,
lib/insika/tools/subagents.rb,
lib/insika/agent_file_store.rb,
lib/insika/channel_delivery.rb,
lib/insika/channel_registry.rb,
lib/insika/checkpoint_store.rb,
lib/insika/context/fragment.rb,
lib/insika/context/priority.rb,
lib/insika/context/provider.rb,
lib/insika/delegation_store.rb,
lib/insika/evals/assertions.rb,
lib/insika/llm_configurator.rb,
lib/insika/refinement/panel.rb,
lib/insika/refinement_store.rb,
lib/insika/safety/detectors.rb,
lib/insika/safety/moderator.rb,
lib/insika/sandbox/boundary.rb,
lib/insika/server/responses.rb,
lib/insika/tool_trace_store.rb,
lib/insika/tools/a2a_remote.rb,
lib/insika/tools/agent_enum.rb,
lib/insika/tools/load_skill.rb,
lib/insika/mcp_tool_ingestor.rb,
lib/insika/server/a2a/client.rb,
lib/insika/server/a2a/errors.rb,
lib/insika/server/admin_auth.rb,
lib/insika/system_file_store.rb,
lib/insika/telemetry/pricing.rb,
lib/insika/tools/concurrency.rb,
lib/insika/tools/tool_search.rb,
lib/insika/workflow_registry.rb,
lib/insika/llm_provider_store.rb,
lib/insika/server/a2a/message.rb,
lib/insika/server/a2a/remotes.rb,
lib/insika/telemetry/recorder.rb,
lib/insika/capability_registry.rb,
lib/insika/commands/delete_mcp.rb,
lib/insika/commands/pause_task.rb,
lib/insika/commands/upsert_mcp.rb,
lib/insika/refinement/proposer.rb,
lib/insika/server/a2a/protocol.rb,
lib/insika/commands/cancel_task.rb,
lib/insika/commands/resume_task.rb,
lib/insika/commands/write_skill.rb,
lib/insika/dsl/workflow_adapter.rb,
lib/insika/pending_action_store.rb,
lib/insika/refinement/candidate.rb,
lib/insika/safety/output_filter.rb,
lib/insika/commands/create_agent.rb,
lib/insika/commands/delete_agent.rb,
lib/insika/commands/import_tools.rb,
lib/insika/commands/send_message.rb,
lib/insika/commands/update_agent.rb,
lib/insika/commands/write_golden.rb,
lib/insika/overlay_tool_registry.rb,
lib/insika/safety/safe_responses.rb,
lib/insika/server/a2a/agent_card.rb,
lib/insika/commands/agent_payload.rb,
lib/insika/safety/input_guardrail.rb,
lib/insika/commands/approve_action.rb,
lib/insika/commands/create_session.rb,
lib/insika/commands/run_refinement.rb,
lib/insika/context/providers/skill.rb,
lib/insika/safety/output_validator.rb,
lib/insika/tools/data_defined_tool.rb,
lib/insika/capability/resolved_tool.rb,
lib/insika/commands/gate_refinement.rb,
lib/insika/commands/memory_add_note.rb,
lib/insika/commands/memory_put_fact.rb,
lib/insika/commands/set_agent_tools.rb,
lib/insika/commands/update_settings.rb,
lib/insika/commands/write_data_tool.rb,
lib/insika/context/catalog_provider.rb,
lib/insika/context/providers/memory.rb,
lib/insika/context/providers/prompt.rb,
lib/insika/commands/delete_data_tool.rb,
lib/insika/commands/import_mcp_tools.rb,
lib/insika/commands/set_skill_agents.rb,
lib/insika/commands/trigger_workflow.rb,
lib/insika/commands/write_agent_file.rb,
lib/insika/context/providers/request.rb,
lib/insika/context/providers/session.rb,
lib/insika/commands/delete_agent_file.rb,
lib/insika/commands/restore_data_tool.rb,
lib/insika/commands/write_system_file.rb,
lib/insika/server/a2a/task_projection.rb,
lib/insika/commands/delete_system_file.rb,
lib/insika/commands/memory_forget_fact.rb,
lib/insika/commands/resolve_refinement.rb,
lib/insika/commands/restore_agent_file.rb,
lib/insika/commands/delete_llm_provider.rb,
lib/insika/commands/restore_system_file.rb,
lib/insika/commands/upsert_llm_provider.rb,
lib/insika/context/providers/tool_search.rb,
lib/insika/refinement/evidence_collector.rb

Overview

D4 (RFC-0009): the PII/secret patterns live in the RUNTIME (single source of truth) — the eval consumes them rather than keeping a divergent copy. Since the module moved under lib/, Safety::Detectors is loaded by insika.rb before this file; the explicit climb out of evals/ that used to be here is gone.

Defined Under Namespace

Modules: Allowlist, Capability, Channels, Coercion, Commands, Context, DSL, EgressGuard, EnvSchema, Evals, Frontmatter, MessageOrigin, ModelPolicy, Plugin, Policy, ProfileSource, Refinement, Safety, Sandbox, SchemaGuard, SecretMasking, Server, Store, Stores, SubagentGraph, Telemetry, TokenEstimator, Tools, Wiring, Workflow Classes: AgentFileStore, AgentProfile, BaselineStore, CancelledError, CapabilityAmbiguous, CapabilityError, CapabilityRegistry, CapabilityUnavailable, ChannelDelivery, ChannelRegistry, ChatBuilder, Checkpoint, CheckpointStore, Command, CommandBus, ConfigError, ConfigStore, ContextBuilder, ContextError, ContextFragment, ContextPackage, ContextProvider, ContextRequest, DelegationStore, DeliveryError, Doctor, EdgeLimiter, Error, Event, EventStream, Executor, GoldenStore, Hooks, HttpClient, InboundLog, LLMConfigurator, LLMProviderStore, McpHttpClient, McpStore, McpToolIngestor, MemoryStore, Middleware, MiddlewareStack, ModelResolver, ModelSelection, NotFoundError, Onboarding, OutboxStore, OverlayToolRegistry, Pack, PackImporter, PendingActionStore, PolicyDenied, PolicyRegistry, PromptCatalog, ProviderError, QueuePolicy, Recovery, RefinementStore, Registry, SessionActor, SessionStore, SettingsStore, Shutdown, SkillCatalog, SkillStore, StaticProfileSource, SteerInjector, StoreError, StoredProfileSource, SubagentCycleError, SubagentDepthExceeded, SubagentError, SystemFileStore, TaskActor, TaskStore, TimeoutError, ToolAssembly, ToolCatalog, ToolDefinition, ToolEnvelope, ToolManifest, ToolRegistry, ToolStore, ToolTraceStore, TurnOutput, TurnState, TurnTiming, UsageLedger, ValidationError, WorkflowRegistry, WorkflowSchemaError

Constant Summary collapse

VERSION =

"0.1.0"

Class Method Summary collapse

.agent(id, &block) ⇒ Object
Top-level entry point (see Insika::DSL).
.embed(backend:, &block) ⇒ Object
RFC-0017 A1 — the front door for MOUNTING Insika into an app you already have.
.system(&block) ⇒ Object
Several agents in one runtime — the shape every multi-agent pattern needs (delegation, fan-out/fan-in, routing).

Class Method Details

.agent(id, &block) ⇒ `Object`

Top-level entry point (see Insika::DSL). Returns a Insika::DSL::Definition.



274
275
276

# File 'lib/insika/dsl.rb', line 274

def agent(id, &block)
  DSL.agent(id, &block)
end

.embed(backend:, &block) ⇒ `Object`

RFC-0017 A1 — the front door for MOUNTING Insika into an app you already have. Same block as Insika.system, one added obligation: the caller names the store, so the graph stops discovering it from INSIKA_DB and two graphs in one process can no longer read each other's sessions.

INSIKA = Insika.embed(backend: Insika::Stores::SQLite.new(path: "storage/insika.sqlite3")) do
agent "support" do
  model "deepseek-chat"
  instructions "…"
end
end
# config/routes.rb — mount the /v1 transport as a value:
mount Insika::Server.rack_app(INSIKA, token: ENV.fetch("INSIKA_TOKEN")), at: "/ai"

It is a thin front door over the SAME assembly Insika.system uses — there is one pipeline (RFC-0001), and the parity spec holds it to that. What an embedded graph owns, and what it still shares with the process, is docs/EMBEDDING.md.



301
302
303

# File 'lib/insika/dsl.rb', line 301

def embed(backend:, &block)
  DSL.embed(backend: backend, &block)
end

.system(&block) ⇒ `Object`

Several agents in one runtime — the shape every multi-agent pattern needs (delegation, fan-out/fan-in, routing). Returns a Insika::DSL::System.



280
281
282

# File 'lib/insika/dsl.rb', line 280

def system(&block)
  DSL.system(&block)
end