insika 0.3.0 → 0.7.0

data/lib/insika.rb

@@ -1,5 +1,13 @@
 # frozen_string_literal: true
 
+# Templates under lib/insika/templates/*/agent.rb open with a bare
+# `require "insika"` (the line a standalone `ruby agent.rb` run needs) and
+# Templates.evaluate instance_evals that same source in-process — so this
+# file's own directory must be on $LOAD_PATH, or that require raises
+# LoadError whenever nothing else already activated the "insika" gem
+# (no Bundler.setup, no globally installed gem).
+$LOAD_PATH.unshift(__dir__) unless $LOAD_PATH.include?(__dir__)
+
 require_relative "insika/version"
 require_relative "insika/errors"
 # the payload selection + the domain-boundary audit yardstick.
@@ -27,6 +35,20 @@ require_relative "insika/contact_store"
 require_relative "insika/followup_store"
 # the tick-driven firer — rides the same tick as retention/funnel.
 require_relative "insika/followup_engine"
+# IANA zone resolution through the OS tz database — the stdlib-only route
+# to a zone NAME (Follow-up quiet hours, the cron scheduler, the doctor).
+require_relative "insika/timezone"
+# the recurring schedule: the five-field cron subset + next-fire
+# materialization, the declaration parse, the per-agent rows, and the
+# tick-driven firer (the recurring half of the tick).
+require_relative "insika/cron"
+require_relative "insika/schedule"
+require_relative "insika/schedule_store"
+require_relative "insika/schedule_engine"
+# the report destination — one record per run, no
+# versioning; the signing half of the sharing link (HMAC, no secret stored).
+require_relative "insika/artifact_store"
+require_relative "insika/artifact_signing"
 require_relative "insika/commands/freeze_funnel_baseline"
 require_relative "insika/channels/webhook"
 require_relative "insika/coercion"
@@ -81,6 +103,7 @@ require_relative "insika/context/providers/skill"
 require_relative "insika/context/providers/skill_trigger"
 require_relative "insika/context/providers/tool_search"
 require_relative "insika/context/providers/memory"
+require_relative "insika/context/providers/knowledge"
 require_relative "insika/context/providers/session"
 require_relative "insika/context/providers/briefing"
 # the cache-prefix hash chain + the per-agent cache-hit series.
@@ -112,6 +135,7 @@ require_relative "insika/outbox_store"
 require_relative "insika/shadow_pair_store"
 require_relative "insika/inbound_log"
 require_relative "insika/memory_store"
+require_relative "insika/knowledge_store"
 # the operator-mutation audit trail. After memory_store (no
 # mutual deps). Pure stdlib — `load_guard_spec` stays green.
 require_relative "insika/memory_audit_store"
@@ -172,6 +196,10 @@ require_relative "insika/evals/runner"
 require_relative "insika/evals/report"
 require_relative "insika/evals/baseline"
 require_relative "insika/evals/transport"
+# simulated users: the persona data + the conversation driver.
+# Pure — the persona model is an injected ask, the target rides the Transport.
+require_relative "insika/evals/persona"
+require_relative "insika/evals/simulator"
 # shadow parity: the frozen criterion and the mechanical
 # fold over the pair store (C6). Pure — no store, no provider gem.
 require_relative "insika/parity/criterion"
@@ -189,6 +217,14 @@ require_relative "insika/refinement/panel"
 require_relative "insika/mcp_store"
 require_relative "insika/mcp_http_client"
 require_relative "insika/mcp_tool_ingestor"
+# require "ruby_llm/mcp" itself is LAZY, inside .for — this require_relative only
+# loads the thin factory (see spec/insika/load_guard_spec.rb).
+require_relative "insika/mcp_client"
+# insika/mcp_live_tool (< RubyLLM::Tool) is NOT required here — McpToolRegistry
+# require_relative's it lazily on the 1st instance (turn time), same as
+# OverlayToolRegistry does for tools/data_defined_tool.
+require_relative "insika/mcp_tool_registry"
+require_relative "insika/mcp_json"
 require_relative "insika/system_file_store"
 require_relative "insika/recovery"
 require_relative "insika/command_bus"
@@ -236,6 +272,9 @@ require_relative "insika/commands/export_customer_memory"
 # record; revoke a contact + fall its pending records atomically).
 require_relative "insika/commands/cancel_followup"
 require_relative "insika/commands/revoke_contact"
+# the report destination's Studio mutation — delete one artifact
+# (a bus command, like every Studio mutation).
+require_relative "insika/commands/delete_artifact"
 # session distillation — the distiller (pure, injected ask)
 # and the proposal store (proposals + the latched dedup ledger + the
 # per-session distilled marker).
@@ -259,6 +298,15 @@ require_relative "insika/commands/promote_harvest"
 require_relative "insika/commands/rollback_harvest"
 require_relative "insika/commands/reject_harvest"
 require_relative "insika/harvest_engine"
+# post-turn learning — the extractor (pure, injected ask) and the
+# concept format itself (markdown + YAML frontmatter, the SkillCatalog
+# split). The provider touch stays inside ExtractorFactory's lazy ask
+# (load_guard stays green).
+require_relative "insika/knowledge"
+require_relative "insika/commands/backfill_knowledge"
+require_relative "insika/commands/write_concept"
+require_relative "insika/commands/delete_concept"
+require_relative "insika/commands/restore_concept"
 require_relative "insika/commands/upsert_mcp"
 require_relative "insika/commands/delete_mcp"
 require_relative "insika/commands/write_system_file"
@@ -269,6 +317,14 @@ require_relative "insika/commands/delete_data_tool"
 require_relative "insika/commands/restore_data_tool"
 require_relative "insika/commands/import_tools"
 require_relative "insika/commands/import_mcp_tools"
+require_relative "insika/commands/refresh_mcp_tools"
+# the demo seed (OSS onboarding): one bundled agent + golden
+# set + the Seeder that populates every loop's stores at once, and its bus
+# adapter for `insika demo:seed` and the Studio's "Seed demo data" button.
+require_relative "insika/demo/agent_attrs"
+require_relative "insika/demo/golden_cases"
+require_relative "insika/demo/seeder"
+require_relative "insika/commands/seed_demo_data"
 require_relative "insika/event_stream"
 require_relative "insika/task_actor"
 require_relative "insika/queue_policy"
@@ -290,6 +346,7 @@ require_relative "insika/shutdown"
 require_relative "insika/tick"
 require_relative "insika/pack"
 require_relative "insika/pack_importer"
+require_relative "insika/templates"
 require_relative "insika/telemetry"
 # Strict config + diagnosis. Doctor reads the config stores above;
 # EnvSchema (required at the top) is its env layer.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: insika
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Guilherme Lages Santos
@@ -37,6 +37,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.15'
+- !ruby/object:Gem::Dependency
+  name: ruby_llm-mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: falcon
   requirement: !ruby/object:Gem::Requirement
@@ -143,6 +157,7 @@ email:
 - guilherme@devconnit.com
 executables:
 - insika
+- insika-router
 extensions: []
 extra_rdoc_files: []
 files:
@@ -150,42 +165,68 @@ files:
 - LICENSE
 - README.md
 - bin/insika
+- bin/insika-router
 - docs/AGENTS.md
 - docs/API.md
 - docs/ARCHITECTURE.md
+- docs/ARTIFACTS.md
 - docs/BENCHMARK.md
 - docs/CHANNELS.md
 - docs/CONTEXT.md
+- docs/DEMO.md
 - docs/DEPLOY.md
 - docs/EMBEDDING.md
 - docs/EVALS.md
 - docs/FACTS.md
 - docs/HARVEST.md
+- docs/KNOWLEDGE.md
 - docs/LOADTEST.md
+- docs/MEDIA.md
 - docs/OBSERVABILITY.md
+- docs/OUTCOMES.md
 - docs/PLUGINS.md
+- docs/POLICY.md
 - docs/REFINEMENT.md
 - docs/RELEASING.md
+- docs/ROUTER.md
 - docs/RUNNING-LOCAL.md
 - docs/SANDBOX.md
+- docs/SCHEDULING.md
 - docs/SECURITY.md
 - docs/SKILLS.md
 - docs/SOAK.md
+- docs/TEMPLATES.md
 - docs/TOOLS.md
 - docs/WHY.md
 - docs/WORKFLOWS.md
-- docs/build.md
+- docs/_includes/head_custom.html
+- docs/_includes/title.html
+- docs/_sass/color_schemes/insika.scss
+- docs/_sass/custom/custom.scss
+- docs/_sass/custom/setup.scss
+- docs/assets/img/favicon.svg
+- docs/assets/img/insika-mark.svg
+- docs/core-concepts.md
 - docs/domain.md
+- docs/improve.md
 - docs/index.md
+- docs/integrate.md
 - docs/onboarding/start.md
 - docs/operate.md
+- docs/prompts/ADD-TOOL.md
+- docs/prompts/DIAGNOSE-TURN.md
+- docs/prompts/GO-LIVE.md
+- docs/prompts/RUN-EXAMPLES.md
+- docs/reference.md
 - docs/ship.md
-- docs/understand.md
+- docs/start-here.md
 - lib/insika.rb
 - lib/insika/agent_file_store.rb
 - lib/insika/agent_profile.rb
 - lib/insika/alert_dispatcher.rb
 - lib/insika/allowlist.rb
+- lib/insika/artifact_signing.rb
+- lib/insika/artifact_store.rb
 - lib/insika/balloon_splitter.rb
 - lib/insika/baseline_store.rb
 - lib/insika/budget_ledger.rb
@@ -207,12 +248,15 @@ files:
 - lib/insika/command_bus.rb
 - lib/insika/commands/agent_payload.rb
 - lib/insika/commands/approve_action.rb
+- lib/insika/commands/backfill_knowledge.rb
 - lib/insika/commands/cancel_followup.rb
 - lib/insika/commands/cancel_task.rb
 - lib/insika/commands/create_agent.rb
 - lib/insika/commands/create_session.rb
 - lib/insika/commands/delete_agent.rb
 - lib/insika/commands/delete_agent_file.rb
+- lib/insika/commands/delete_artifact.rb
+- lib/insika/commands/delete_concept.rb
 - lib/insika/commands/delete_data_tool.rb
 - lib/insika/commands/delete_llm_provider.rb
 - lib/insika/commands/delete_mcp.rb
@@ -235,10 +279,12 @@ files:
 - lib/insika/commands/promote_harvest.rb
 - lib/insika/commands/record_outcome.rb
 - lib/insika/commands/record_shadow_reply.rb
+- lib/insika/commands/refresh_mcp_tools.rb
 - lib/insika/commands/reject_harvest.rb
 - lib/insika/commands/resolve_proposal.rb
 - lib/insika/commands/resolve_refinement.rb
 - lib/insika/commands/restore_agent_file.rb
+- lib/insika/commands/restore_concept.rb
 - lib/insika/commands/restore_data_tool.rb
 - lib/insika/commands/restore_system_file.rb
 - lib/insika/commands/resume_task.rb
@@ -249,6 +295,7 @@ files:
 - lib/insika/commands/run_distillation.rb
 - lib/insika/commands/run_harvest.rb
 - lib/insika/commands/run_refinement.rb
+- lib/insika/commands/seed_demo_data.rb
 - lib/insika/commands/send_message.rb
 - lib/insika/commands/session_purge.rb
 - lib/insika/commands/set_agent_tools.rb
@@ -259,6 +306,7 @@ files:
 - lib/insika/commands/upsert_llm_provider.rb
 - lib/insika/commands/upsert_mcp.rb
 - lib/insika/commands/write_agent_file.rb
+- lib/insika/commands/write_concept.rb
 - lib/insika/commands/write_data_tool.rb
 - lib/insika/commands/write_golden.rb
 - lib/insika/commands/write_skill.rb
@@ -271,6 +319,7 @@ files:
 - lib/insika/context/priority.rb
 - lib/insika/context/provider.rb
 - lib/insika/context/providers/briefing.rb
+- lib/insika/context/providers/knowledge.rb
 - lib/insika/context/providers/memory.rb
 - lib/insika/context/providers/prompt.rb
 - lib/insika/context/providers/request.rb
@@ -279,7 +328,11 @@ files:
 - lib/insika/context/providers/skill_trigger.rb
 - lib/insika/context/providers/tool_search.rb
 - lib/insika/context_trace_store.rb
+- lib/insika/cron.rb
 - lib/insika/delegation_store.rb
+- lib/insika/demo/agent_attrs.rb
+- lib/insika/demo/golden_cases.rb
+- lib/insika/demo/seeder.rb
 - lib/insika/distill.rb
 - lib/insika/distill_engine.rb
 - lib/insika/doctor.rb
@@ -298,8 +351,10 @@ files:
 - lib/insika/evals/golden.rb
 - lib/insika/evals/judge.rb
 - lib/insika/evals/pairwise.rb
+- lib/insika/evals/persona.rb
 - lib/insika/evals/report.rb
 - lib/insika/evals/runner.rb
+- lib/insika/evals/simulator.rb
 - lib/insika/evals/transport.rb
 - lib/insika/event.rb
 - lib/insika/event_stream.rb
@@ -325,12 +380,18 @@ files:
 - lib/insika/hooks.rb
 - lib/insika/http_client.rb
 - lib/insika/inbound_log.rb
+- lib/insika/knowledge.rb
+- lib/insika/knowledge_store.rb
 - lib/insika/llm_configurator.rb
 - lib/insika/llm_provider_store.rb
 - lib/insika/loop_detector.rb
+- lib/insika/mcp_client.rb
 - lib/insika/mcp_http_client.rb
+- lib/insika/mcp_json.rb
+- lib/insika/mcp_live_tool.rb
 - lib/insika/mcp_store.rb
 - lib/insika/mcp_tool_ingestor.rb
+- lib/insika/mcp_tool_registry.rb
 - lib/insika/media.rb
 - lib/insika/memory_audit_store.rb
 - lib/insika/memory_store.rb
@@ -372,6 +433,12 @@ files:
 - lib/insika/registry.rb
 - lib/insika/reliability.rb
 - lib/insika/retention.rb
+- lib/insika/router.rb
+- lib/insika/router/app.rb
+- lib/insika/router/backend_pool.rb
+- lib/insika/router/hash_ring.rb
+- lib/insika/router/proxy_body.rb
+- lib/insika/router/session_key.rb
 - lib/insika/routing.rb
 - lib/insika/safety/config.rb
 - lib/insika/safety/corpus.rb
@@ -389,6 +456,9 @@ files:
 - lib/insika/sandbox/docker.rb
 - lib/insika/sandbox/local.rb
 - lib/insika/sandbox/runner.rb
+- lib/insika/schedule.rb
+- lib/insika/schedule_engine.rb
+- lib/insika/schedule_store.rb
 - lib/insika/schema_guard.rb
 - lib/insika/secret_masking.rb
 - lib/insika/server/a2a/agent_card.rb
@@ -426,10 +496,21 @@ files:
 - lib/insika/studio/assets/dist/favicon.svg
 - lib/insika/studio/forms.rb
 - lib/insika/studio/nav_icons.rb
+- lib/insika/studio/views/_agent_tab_cache.erb
+- lib/insika/studio/views/_agent_tab_config.erb
+- lib/insika/studio/views/_agent_tab_history.erb
+- lib/insika/studio/views/_agent_tab_loops.erb
+- lib/insika/studio/views/_agent_tab_memory.erb
+- lib/insika/studio/views/_agent_tab_outcomes.erb
+- lib/insika/studio/views/_agent_tab_prompts.erb
+- lib/insika/studio/views/_agent_tab_skills.erb
+- lib/insika/studio/views/_agents_master.erb
 - lib/insika/studio/views/_message.erb
 - lib/insika/studio/views/agent_detail.erb
 - lib/insika/studio/views/agents.erb
 - lib/insika/studio/views/approvals.erb
+- lib/insika/studio/views/artifact.erb
+- lib/insika/studio/views/artifacts.erb
 - lib/insika/studio/views/chats.erb
 - lib/insika/studio/views/customer.erb
 - lib/insika/studio/views/customers.erb
@@ -439,6 +520,7 @@ files:
 - lib/insika/studio/views/funnel.erb
 - lib/insika/studio/views/harvest.erb
 - lib/insika/studio/views/home.erb
+- lib/insika/studio/views/knowledge.erb
 - lib/insika/studio/views/layout.erb
 - lib/insika/studio/views/login.erb
 - lib/insika/studio/views/mcp.erb
@@ -461,8 +543,22 @@ files:
 - lib/insika/telemetry.rb
 - lib/insika/telemetry/pricing.rb
 - lib/insika/telemetry/recorder.rb
+- lib/insika/templates.rb
+- lib/insika/templates/browser-agent/README.md
+- lib/insika/templates/browser-agent/agent.rb
+- lib/insika/templates/daily-digest/README.md
+- lib/insika/templates/daily-digest/agent.rb
+- lib/insika/templates/repo-explorer/README.md
+- lib/insika/templates/repo-explorer/agent.rb
+- lib/insika/templates/research-analyst/README.md
+- lib/insika/templates/research-analyst/agent.rb
+- lib/insika/templates/review-panel/README.md
+- lib/insika/templates/review-panel/agent.rb
+- lib/insika/templates/travel-planner/README.md
+- lib/insika/templates/travel-planner/agent.rb
 - lib/insika/testing/store_contract.rb
 - lib/insika/tick.rb
+- lib/insika/timezone.rb
 - lib/insika/token_estimator.rb
 - lib/insika/token_store.rb
 - lib/insika/tool_assembly.rb
@@ -479,8 +575,11 @@ files:
 - lib/insika/tools/concurrency.rb
 - lib/insika/tools/data_defined_tool.rb
 - lib/insika/tools/generate_image.rb
+- lib/insika/tools/load_knowledge.rb
 - lib/insika/tools/load_skill.rb
 - lib/insika/tools/remember.rb
+- lib/insika/tools/run_persona_eval.rb
+- lib/insika/tools/save_artifact.rb
 - lib/insika/tools/schedule_followup.rb
 - lib/insika/tools/stuck_signal.rb
 - lib/insika/tools/subagent.rb
@@ -495,16 +594,17 @@ files:
 - lib/insika/version.rb
 - lib/insika/vitals.rb
 - lib/insika/wiring/graph.rb
+- lib/insika/wiring/graph_chat.rb
 - lib/insika/workflow.rb
 - lib/insika/workflow_registry.rb
 homepage: https://github.com/guizaols/insika
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/guizaols/insika
+  homepage_uri: https://guizaols.github.io/insika/
   source_code_uri: https://github.com/guizaols/insika
   changelog_uri: https://github.com/guizaols/insika/blob/main/CHANGELOG.md
-  documentation_uri: https://guizaols.github.io/insika/
+  documentation_uri: https://guizaols.github.io/insika/start-here/
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:

data/docs/build.md

@@ -1,14 +0,0 @@
----
-title: Build an agent
-nav_order: 3
-has_children: true
-permalink: /build/
----
-
-# Build an agent
-
-An agent is data: a profile, its tools, its skills, and what fills its prompt. Start
-with [Agents](AGENTS.md), then add capability one doc at a time — and when config is not
-enough, [Plugins](PLUGINS.md) covers the two ways to extend the engine itself. Every one of these has a
-runnable counterpart under
-[`examples/`](https://github.com/guizaols/insika/tree/main/examples/).

data/docs/understand.md

@@ -1,10 +0,0 @@
----
-title: Understand the idea
-nav_order: 2
-has_children: true
-permalink: /understand/
----
-
-# Understand the idea
-
-What Insika is for, what it replaces, and how a turn actually runs end to end.