@framers/agentos 0.1.126 → 0.1.128

package/README.md

@@ -124,8 +124,8 @@
 | **@framers/agentos** | Core orchestration runtime | [![npm](https://img.shields.io/npm/v/@framers/agentos?style=flat-square&logo=npm&label=)](https://www.npmjs.com/package/@framers/agentos) · [GitHub](https://github.com/framersai/agentos) |
 | **@framers/agentos-extensions** | Official extension registry (45+ extensions) | [![npm](https://img.shields.io/npm/v/@framers/agentos-extensions?style=flat-square&logo=npm&label=)](https://www.npmjs.com/package/@framers/agentos-extensions) · [GitHub](https://github.com/framersai/agentos-extensions) |
 | **@framers/agentos-extensions-registry** | Curated manifest builder | [![npm](https://img.shields.io/npm/v/@framers/agentos-extensions-registry?style=flat-square&logo=npm&label=)](https://www.npmjs.com/package/@framers/agentos-extensions-registry) · [GitHub](https://github.com/framersai/agentos-extensions-registry) |
-| **@framers/agentos-skills-registry** | 28+ curated SKILL.md files | [![npm](https://img.shields.io/npm/v/@framers/agentos-skills-registry?style=flat-square&logo=npm&label=)](https://www.npmjs.com/package/@framers/agentos-skills-registry) · [GitHub](https://github.com/framersai/agentos-skills-registry) |
-| **@framers/agentos-skills** | Skills runtime loader (reads SKILL.md → agent prompt) | [![npm](https://img.shields.io/npm/v/@framers/agentos-skills?style=flat-square&logo=npm&label=)](https://www.npmjs.com/package/@framers/agentos-skills) · [GitHub](https://github.com/framersai/agentos-skills) |
+| **@framers/agentos-skills-registry** | Skills catalog SDK (query helpers + snapshot factories) | [![npm](https://img.shields.io/npm/v/@framers/agentos-skills-registry?style=flat-square&logo=npm&label=)](https://www.npmjs.com/package/@framers/agentos-skills-registry) · [GitHub](https://github.com/framersai/agentos-skills-registry) |
+| **@framers/agentos-skills** | Skills content (69 SKILL.md files + registry.json) | [![npm](https://img.shields.io/npm/v/@framers/agentos-skills?style=flat-square&logo=npm&label=)](https://www.npmjs.com/package/@framers/agentos-skills) · [GitHub](https://github.com/framersai/agentos-skills) |
 | **docs.agentos.sh** | Documentation site (Docusaurus) | [GitHub](https://github.com/framersai/agentos-live-docs) · [docs.agentos.sh](https://docs.agentos.sh) |
 
 ### Guardrail Extensions
@@ -150,8 +150,8 @@ npm install @framers/agentos
 
 **Start here:**
 
-- Use [`agency()`](./docs/AGENCY_API.md) to coordinate a team of agents with a single call.
-- Use [`generateText()` / `streamText()` / `generateObject()` / `streamObject()` / `embedText()` / `generateImage()` / `agent()`](./docs/HIGH_LEVEL_API.md) for the fastest path from prompt to working code.
+- Use [`agency()`](./docs/orchestration/AGENCY_API.md) to coordinate a team of agents with a single call.
+- Use [`generateText()` / `streamText()` / `generateObject()` / `streamObject()` / `embedText()` / `generateImage()` / `agent()`](./docs/getting-started/HIGH_LEVEL_API.md) for the fastest path from prompt to working code.
 - Use [`AgentOS`](#advanced-agentgraph-and-full-runtime) when you need extensions, workflows, personas, or full runtime lifecycle control.
 - Browse the live docs at [docs.agentos.sh/getting-started/high-level-api](https://docs.agentos.sh/getting-started/high-level-api) and [docs.agentos.sh/api](https://docs.agentos.sh/api).
 
@@ -206,7 +206,7 @@ const team = agency({
 Add guardrails, HITL, resource controls, observability, `listen()` for voice
 transport, `connect()` for channel adapters, RAG context injection, and real
 per-agent stream events in the same config object — see
-[`docs/AGENCY_API.md`](./docs/AGENCY_API.md) for the full reference.
+[`docs/orchestration/AGENCY_API.md`](./docs/orchestration/AGENCY_API.md) for the full reference.
 
 ### Single-Agent and Low-Level Helpers
 
@@ -352,8 +352,8 @@ for await (const chunk of agent.processRequest({
 }
 ```
 
-See [`docs/AGENT_GRAPH.md`](./docs/AGENT_GRAPH.md) for the `AgentGraph` programmatic
-graph builder and [`docs/WORKFLOW_DSL.md`](./docs/WORKFLOW_DSL.md) for the workflow
+See [`docs/architecture/AGENT_GRAPH.md`](./docs/architecture/AGENT_GRAPH.md) for the `AgentGraph` programmatic
+graph builder and [`docs/orchestration/WORKFLOW_DSL.md`](./docs/orchestration/WORKFLOW_DSL.md) for the workflow
 DSL.
 
 ---
@@ -529,6 +529,7 @@ graph TB
   - **Episodic memory** -- Timestamped events and interactions
   - **Semantic memory** -- Extracted facts, entity relationships, domain knowledge
   - **Procedural memory** -- Learned skills, patterns, and execution strategies
+  - **Cognitive mechanisms** (`memory/mechanisms/`) -- 8 optional neuroscience-grounded mechanisms: reconsolidation drift (Nader et al., 2000), retrieval-induced forgetting (Anderson et al., 1994), involuntary recall (Berntsen, 2009), metacognitive feeling-of-knowing (Nelson & Narens, 1990), temporal gist extraction (Reyna & Brainerd, 1995), schema encoding (Bartlett, 1932), source confidence decay (Johnson et al., 1993), emotion regulation (Gross, 1998). All HEXACO personality-modulated, individually configurable. See `docs/memory/COGNITIVE_MECHANISMS.md`.
 
 ---
 
@@ -729,7 +730,7 @@ type ExtensionPackResolver =
 
 ### Planning Engine
 
-**Location:** `src/core/planning/`
+**Location:** `src/orchestration/planner/`
 
 The planning engine enables multi-step task decomposition and execution using ReAct (Reasoning + Acting) patterns.
 
@@ -751,7 +752,7 @@ Plans are composed of typed steps that the agent executes sequentially, with the
 - **HITL** for human approval of high-risk steps
 - **Memory** for persisting plan state across sessions
 
-See [`docs/PLANNING_ENGINE.md`](docs/PLANNING_ENGINE.md) for the full planning system specification.
+See [`docs/orchestration/PLANNING_ENGINE.md`](./docs/orchestration/PLANNING_ENGINE.md) for the full planning system specification.
 
 ---
 
@@ -834,7 +835,7 @@ import { Neo4jGraphRAGEngine } from '@framers/agentos/rag/graphrag';
 import type { GraphRAGConfig, GraphEntity, GraphRelationship } from '@framers/agentos/rag/graphrag';
 ```
 
-See [`docs/RAG_MEMORY_CONFIGURATION.md`](docs/RAG_MEMORY_CONFIGURATION.md) and [`docs/MULTIMODAL_RAG.md`](docs/MULTIMODAL_RAG.md) for detailed configuration guides.
+See [`docs/memory/RAG_MEMORY_CONFIGURATION.md`](./docs/memory/RAG_MEMORY_CONFIGURATION.md) and [`docs/memory/MULTIMODAL_RAG.md`](./docs/memory/MULTIMODAL_RAG.md) for detailed configuration guides.
 
 **Memory Scaling:**
 
@@ -853,17 +854,17 @@ AgentOS provides a 4-tier vector storage scaling path that grows with your deplo
 - **HNSW sidecar auto-activation** — transparently upgrades from brute-force to approximate nearest neighbors at 1K vectors
 - **`embed()` config option** — opt-in query-time embedding generation for dynamic content
 
-See [`docs/MEMORY_SCALING.md`](docs/MEMORY_SCALING.md), [`docs/POSTGRES_BACKEND.md`](docs/POSTGRES_BACKEND.md), [`docs/QDRANT_BACKEND.md`](docs/QDRANT_BACKEND.md), and [`docs/PINECONE_BACKEND.md`](docs/PINECONE_BACKEND.md) for backend-specific guides.
+See [`docs/memory/MEMORY_SCALING.md`](./docs/memory/MEMORY_SCALING.md), [`docs/memory/POSTGRES_BACKEND.md`](./docs/memory/POSTGRES_BACKEND.md), [`docs/memory/QDRANT_BACKEND.md`](./docs/memory/QDRANT_BACKEND.md), and [`docs/memory/PINECONE_BACKEND.md`](./docs/memory/PINECONE_BACKEND.md) for backend-specific guides.
 
 ---
 
 ### Safety and Guardrails
 
-**Location:** `src/core/safety/` and `src/core/guardrails/`
+**Location:** `src/safety/runtime/` and `src/safety/guardrails/`
 
 AgentOS provides defense-in-depth safety through two complementary systems.
 
-#### Safety Primitives (`core/safety/`)
+#### Safety Primitives (`safety/runtime/`)
 
 Five runtime safety components:
 
@@ -882,12 +883,12 @@ import {
   StuckDetector,
   ActionDeduplicator,
   ToolExecutionGuard,
-} from '@framers/agentos/core/safety';
+} from '@framers/agentos/safety/runtime';
 ```
 
-See [`docs/SAFETY_PRIMITIVES.md`](docs/SAFETY_PRIMITIVES.md) for the full safety API reference.
+See [`docs/safety/SAFETY_PRIMITIVES.md`](./docs/safety/SAFETY_PRIMITIVES.md) for the full safety API reference.
 
-#### Guardrails (`core/guardrails/`)
+#### Guardrails (`safety/guardrails/`)
 
 Content-level input/output filtering:
 
@@ -919,13 +920,13 @@ When multiple guardrails are registered, AgentOS uses a **two-phase dispatcher**
 
 Multiple guardrails can be composed via the extension system, and each receives full context (user ID, session ID, persona ID, conversation ID, metadata) for context-aware policy decisions.
 
-See [`docs/GUARDRAILS_USAGE.md`](docs/GUARDRAILS_USAGE.md) for implementation patterns.
+See [`docs/safety/GUARDRAILS_USAGE.md`](./docs/safety/GUARDRAILS_USAGE.md) for implementation patterns.
 
 ---
 
 ### Human-in-the-Loop (HITL)
 
-**Location:** `src/core/hitl/`
+**Location:** `src/orchestration/hitl/`
 
 The HITL system enables agents to request human approval, clarification, and collaboration at key decision points.
 
@@ -960,7 +961,7 @@ interface PendingAction {
 
 HITL integrates with the planning engine so individual plan steps can require approval, and with the extension system via `EXTENSION_KIND_HITL_HANDLER` for custom approval UIs.
 
-See [`docs/HUMAN_IN_THE_LOOP.md`](docs/HUMAN_IN_THE_LOOP.md) for the full HITL specification.
+See [`docs/safety/HUMAN_IN_THE_LOOP.md`](./docs/safety/HUMAN_IN_THE_LOOP.md) for the full HITL specification.
 
 ---
 
@@ -1006,7 +1007,7 @@ engagement_metrics, scheduling, dm_automation, content_discovery
 
 Channel adapters are registered as extensions via `EXTENSION_KIND_MESSAGING_CHANNEL`.
 
-See [`docs/PLATFORM_SUPPORT.md`](docs/PLATFORM_SUPPORT.md) for platform-specific configuration.
+See [`docs/architecture/PLATFORM_SUPPORT.md`](./docs/architecture/PLATFORM_SUPPORT.md) for platform-specific configuration.
 
 ---
 
@@ -1106,13 +1107,13 @@ const researcher = mission('research')
 const plan = await researcher.explain({ topic: 'AI safety' }); // preview plan without executing
 ```
 
-See [`docs/UNIFIED_ORCHESTRATION.md`](docs/UNIFIED_ORCHESTRATION.md), [`docs/AGENT_GRAPH.md`](docs/AGENT_GRAPH.md), [`docs/WORKFLOW_DSL.md`](docs/WORKFLOW_DSL.md), [`docs/MISSION_API.md`](docs/MISSION_API.md), [`docs/CHECKPOINTING.md`](docs/CHECKPOINTING.md).
+See [`docs/orchestration/UNIFIED_ORCHESTRATION.md`](./docs/orchestration/UNIFIED_ORCHESTRATION.md), [`docs/architecture/AGENT_GRAPH.md`](./docs/architecture/AGENT_GRAPH.md), [`docs/orchestration/WORKFLOW_DSL.md`](./docs/orchestration/WORKFLOW_DSL.md), [`docs/orchestration/MISSION_API.md`](./docs/orchestration/MISSION_API.md), [`docs/orchestration/CHECKPOINTING.md`](./docs/orchestration/CHECKPOINTING.md).
 
 Runnable examples: [`examples/agent-graph.mjs`](./examples/agent-graph.mjs), [`examples/workflow-dsl.mjs`](./examples/workflow-dsl.mjs), [`examples/mission-api.mjs`](./examples/mission-api.mjs)
 
 #### Legacy WorkflowEngine
 
-The original `WorkflowEngine` (`src/core/workflows/`) continues to work for existing consumers. The new orchestration layer is opt-in and runs alongside it.
+The original `WorkflowEngine` (`src/orchestration/workflows/`) continues to work for existing consumers. The new orchestration layer is opt-in and runs alongside it.
 
 ```typescript
 const definitions = agent.listWorkflowDefinitions();
@@ -1124,7 +1125,7 @@ const status = await agent.getWorkflow(instance.workflowId);
 
 ### Multi-Agent Coordination
 
-**Location:** `src/core/agency/`
+**Location:** `src/agents/agency/`
 
 Enables teams of agents to collaborate on shared goals.
 
@@ -1146,13 +1147,13 @@ graph TD
     style Mem fill:#151520,stroke:#8b5cf6,color:#f2f2fa
 ```
 
-See [`docs/AGENT_COMMUNICATION.md`](docs/AGENT_COMMUNICATION.md) for the full multi-agent specification.
+See [`docs/architecture/AGENT_COMMUNICATION.md`](./docs/architecture/AGENT_COMMUNICATION.md) for the full multi-agent specification.
 
 ---
 
 ### Observability
 
-**Location:** `src/core/observability/`
+**Location:** `src/evaluation/observability/`
 
 OpenTelemetry-native observability for tracing, metrics, and cost tracking.
 
@@ -1171,7 +1172,7 @@ configureAgentOSObservability({
 });
 ```
 
-See [`docs/OBSERVABILITY.md`](docs/OBSERVABILITY.md) and [`docs/COST_OPTIMIZATION.md`](docs/COST_OPTIMIZATION.md) for setup guides.
+See [`docs/observability/OBSERVABILITY.md`](./docs/observability/OBSERVABILITY.md) and [`docs/safety/COST_OPTIMIZATION.md`](./docs/safety/COST_OPTIMIZATION.md) for setup guides.
 
 ---
 
@@ -1185,13 +1186,13 @@ Skills are portable, self-describing agent capabilities defined in `SKILL.md` fi
 - **SkillLoader** -- Parses SKILL.md format (YAML frontmatter + markdown body)
 - **SKILL.md format** -- Declarative skill definition with name, description, required tools, and behavioral instructions
 
-See [`docs/SKILLS.md`](docs/SKILLS.md) for the skill authoring guide.
+See [`docs/extensions/SKILLS.md`](./docs/extensions/SKILLS.md) for the skill authoring guide.
 
 ---
 
 ### Structured Output
 
-**Location:** `src/core/structured/`
+**Location:** `src/structured/output/`
 
 Extract typed, validated data from unstructured text using JSON Schema.
 
@@ -1200,7 +1201,7 @@ Extract typed, validated data from unstructured text using JSON Schema.
 - **Parallel function calls** -- Multiple tool invocations in a single LLM turn
 - **Entity extraction** -- Named entity recognition with schema constraints
 
-See [`docs/STRUCTURED_OUTPUT.md`](docs/STRUCTURED_OUTPUT.md) for usage patterns.
+See [`docs/orchestration/STRUCTURED_OUTPUT.md`](./docs/orchestration/STRUCTURED_OUTPUT.md) for usage patterns.
 
 ---
 
@@ -1210,7 +1211,7 @@ See [`docs/STRUCTURED_OUTPUT.md`](docs/STRUCTURED_OUTPUT.md) for usage patterns.
 
 Agents with `emergent: true` create new tools at runtime — compose existing tools via a step DSL or write sandboxed JavaScript. An LLM-as-judge evaluates safety and correctness. Tools earn trust through tiered promotion: session (in-memory) → agent (persisted, auto-promoted after 5+ uses with >0.8 confidence) → shared (human-approved HITL gate).
 
-See [`docs/EMERGENT_CAPABILITIES.md`](docs/EMERGENT_CAPABILITIES.md) for details.
+See [`docs/architecture/EMERGENT_CAPABILITIES.md`](./docs/architecture/EMERGENT_CAPABILITIES.md) for details.
 
 ---
 
@@ -1526,7 +1527,7 @@ const preview = await researcher.explain({ topic: 'AI safety' });
 console.log(preview.steps.map((step) => step.id));
 ```
 
-For deeper examples, see [`docs/AGENT_GRAPH.md`](docs/AGENT_GRAPH.md), [`docs/WORKFLOW_DSL.md`](docs/WORKFLOW_DSL.md), [`docs/MISSION_API.md`](docs/MISSION_API.md), the runnable examples [`examples/agent-graph.mjs`](./examples/agent-graph.mjs), [`examples/workflow-dsl.mjs`](./examples/workflow-dsl.mjs), [`examples/mission-api.mjs`](./examples/mission-api.mjs), and the legacy dependency-ordered example [`examples/multi-agent-workflow.mjs`](./examples/multi-agent-workflow.mjs).
+For deeper examples, see [`docs/architecture/AGENT_GRAPH.md`](./docs/architecture/AGENT_GRAPH.md), [`docs/orchestration/WORKFLOW_DSL.md`](./docs/orchestration/WORKFLOW_DSL.md), [`docs/orchestration/MISSION_API.md`](./docs/orchestration/MISSION_API.md), the runnable examples [`examples/agent-graph.mjs`](./examples/agent-graph.mjs), [`examples/workflow-dsl.mjs`](./examples/workflow-dsl.mjs), [`examples/mission-api.mjs`](./examples/mission-api.mjs), and the legacy dependency-ordered example [`examples/multi-agent-workflow.mjs`](./examples/multi-agent-workflow.mjs).
 
 ### Streaming Chat
 
@@ -1848,7 +1849,7 @@ await agent.initialize({ ...config, guardrailService: piiGuardrail });
 > **For production PII redaction**, use the built-in `createPiiRedactionGuardrail()` extension
 > instead of hand-rolled regex. It provides four-tier detection (regex + NLP + BERT NER +
 > LLM-as-judge), streaming support, and configurable redaction styles. See
-> [GUARDRAILS_USAGE.md](docs/GUARDRAILS_USAGE.md) for full examples.
+> [GUARDRAILS_USAGE.md](./docs/safety/GUARDRAILS_USAGE.md) for full examples.
 
 ### Channel Adapters
 
@@ -1931,17 +1932,17 @@ import { AgentOS, AgentOSResponseChunkType, /* ... */ } from '@framers/agentos';
 import { createAgentOSConfig, createTestAgentOSConfig } from '@framers/agentos/config/AgentOSConfig';
 
 // Safety primitives
-import { CircuitBreaker, CostGuard, StuckDetector } from '@framers/agentos/core/safety';
+import { CircuitBreaker, CostGuard, StuckDetector } from '@framers/agentos/safety/runtime';
 
 // Guardrails
-import { GuardrailAction } from '@framers/agentos/core/guardrails';
-import { ParallelGuardrailDispatcher } from '@framers/agentos/core/guardrails';
+import { GuardrailAction } from '@framers/agentos/safety/guardrails';
+import { ParallelGuardrailDispatcher } from '@framers/agentos/safety/guardrails';
 
 // Tools
 import type { ITool, ToolExecutionResult } from '@framers/agentos/core/tools';
 
 // HITL
-import type { IHumanInteractionManager } from '@framers/agentos/core/hitl';
+import type { IHumanInteractionManager } from '@framers/agentos/orchestration/hitl';
 
 // RAG
 import { VectorStoreManager, EmbeddingManager, RetrievalAugmentor } from '@framers/agentos/rag';
@@ -1959,7 +1960,7 @@ import { createCodeSafetyGuardrail } from '@framers/agentos-ext-code-safety';
 import { createGroundingGuardrail } from '@framers/agentos-ext-grounding-guard';
 
 // Deep imports (wildcard exports)
-import { SomeType } from '@framers/agentos/core/safety/CircuitBreaker';
+import { SomeType } from '@framers/agentos/safety/runtime/CircuitBreaker';
 import { SomeConfig } from '@framers/agentos/config/ToolOrchestratorConfig';
 ```
 
@@ -1977,32 +1978,32 @@ The `docs/` directory contains specification and reference documents:
 
 | Document | Description |
 |----------|-------------|
-| [`AGENCY_API.md`](docs/AGENCY_API.md) | `agency()` reference: all 5 strategies, HITL, guardrails, RAG, voice, nested agencies, full-featured example |
-| [`HIGH_LEVEL_API.md`](docs/HIGH_LEVEL_API.md) | `generateText()`, `streamText()`, `generateObject()`, `streamObject()`, `embedText()`, `generateImage()`, single `agent()` |
-| [`ARCHITECTURE.md`](docs/ARCHITECTURE.md) | Complete system architecture with data flow diagrams |
-| [`SAFETY_PRIMITIVES.md`](docs/SAFETY_PRIMITIVES.md) | Circuit breaker, cost guard, stuck detection, dedup API reference |
-| [`PLANNING_ENGINE.md`](docs/PLANNING_ENGINE.md) | ReAct reasoning, multi-step task planning specification |
-| [`HUMAN_IN_THE_LOOP.md`](docs/HUMAN_IN_THE_LOOP.md) | Approval workflows, clarification, escalation patterns |
-| [`GUARDRAILS_USAGE.md`](docs/GUARDRAILS_USAGE.md) | Input/output guardrail implementation patterns |
-| [`RAG_MEMORY_CONFIGURATION.md`](docs/RAG_MEMORY_CONFIGURATION.md) | Vector store setup, embedding models, data source config |
-| [`MULTIMODAL_RAG.md`](docs/MULTIMODAL_RAG.md) | Image, audio, and document RAG pipelines |
-| [`STRUCTURED_OUTPUT.md`](docs/STRUCTURED_OUTPUT.md) | JSON schema validation, entity extraction, function calling |
-| [`AGENT_COMMUNICATION.md`](docs/AGENT_COMMUNICATION.md) | Inter-agent messaging, handoffs, shared memory |
-| [`TOOL_CALLING_AND_LOADING.md`](docs/TOOL_CALLING_AND_LOADING.md) | Tool registration, discovery, execution pipeline |
-| [`OBSERVABILITY.md`](docs/OBSERVABILITY.md) | OpenTelemetry setup, custom spans, metrics export |
-| [`COST_OPTIMIZATION.md`](docs/COST_OPTIMIZATION.md) | Token usage monitoring, caching strategies, model routing |
-| [`SKILLS.md`](docs/SKILLS.md) | SKILL.md format specification, skill authoring guide |
-| [`PLATFORM_SUPPORT.md`](docs/PLATFORM_SUPPORT.md) | Channel platform capabilities and adapter configuration |
-| [`ECOSYSTEM.md`](docs/ECOSYSTEM.md) | Extension ecosystem, official packs, community extensions |
-| [`PROVENANCE_IMMUTABILITY.md`](docs/PROVENANCE_IMMUTABILITY.md) | Sealed agents, signed event ledger, external anchoring |
-| [`IMMUTABLE_AGENTS.md`](docs/IMMUTABLE_AGENTS.md) | Agent sealing, toolset manifests, revision tracking |
-| [`RFC_EXTENSION_STANDARDS.md`](docs/RFC_EXTENSION_STANDARDS.md) | Extension pack authoring standards and conventions |
-| [`EVALUATION_FRAMEWORK.md`](docs/EVALUATION_FRAMEWORK.md) | Agent evaluation, benchmarking, quality metrics |
-| [`RECURSIVE_SELF_BUILDING_AGENTS.md`](docs/RECURSIVE_SELF_BUILDING_AGENTS.md) | Self-modifying agent patterns |
-| [`LOGGING.md`](docs/LOGGING.md) | Structured logging configuration with pino |
-| [`CLIENT_SIDE_STORAGE.md`](docs/CLIENT_SIDE_STORAGE.md) | Browser-compatible storage adapters |
-| [`SQL_STORAGE_QUICKSTART.md`](docs/SQL_STORAGE_QUICKSTART.md) | SQLite/Postgres setup with `@framers/sql-storage-adapter` |
-| [`RELEASING.md`](docs/RELEASING.md) | Release process and semantic versioning |
+| [`AGENCY_API.md`](./docs/orchestration/AGENCY_API.md) | `agency()` reference: all 5 strategies, HITL, guardrails, RAG, voice, nested agencies, full-featured example |
+| [`HIGH_LEVEL_API.md`](./docs/getting-started/HIGH_LEVEL_API.md) | `generateText()`, `streamText()`, `generateObject()`, `streamObject()`, `embedText()`, `generateImage()`, single `agent()` |
+| [`ARCHITECTURE.md`](./docs/architecture/ARCHITECTURE.md) | Complete system architecture with data flow diagrams |
+| [`SAFETY_PRIMITIVES.md`](./docs/safety/SAFETY_PRIMITIVES.md) | Circuit breaker, cost guard, stuck detection, dedup API reference |
+| [`PLANNING_ENGINE.md`](./docs/orchestration/PLANNING_ENGINE.md) | ReAct reasoning, multi-step task planning specification |
+| [`HUMAN_IN_THE_LOOP.md`](./docs/safety/HUMAN_IN_THE_LOOP.md) | Approval workflows, clarification, escalation patterns |
+| [`GUARDRAILS_USAGE.md`](./docs/safety/GUARDRAILS_USAGE.md) | Input/output guardrail implementation patterns |
+| [`RAG_MEMORY_CONFIGURATION.md`](./docs/memory/RAG_MEMORY_CONFIGURATION.md) | Vector store setup, embedding models, data source config |
+| [`MULTIMODAL_RAG.md`](./docs/memory/MULTIMODAL_RAG.md) | Image, audio, and document RAG pipelines |
+| [`STRUCTURED_OUTPUT.md`](./docs/orchestration/STRUCTURED_OUTPUT.md) | JSON schema validation, entity extraction, function calling |
+| [`AGENT_COMMUNICATION.md`](./docs/architecture/AGENT_COMMUNICATION.md) | Inter-agent messaging, handoffs, shared memory |
+| [`TOOL_CALLING_AND_LOADING.md`](./docs/extensions/TOOL_CALLING_AND_LOADING.md) | Tool registration, discovery, execution pipeline |
+| [`OBSERVABILITY.md`](./docs/observability/OBSERVABILITY.md) | OpenTelemetry setup, custom spans, metrics export |
+| [`COST_OPTIMIZATION.md`](./docs/safety/COST_OPTIMIZATION.md) | Token usage monitoring, caching strategies, model routing |
+| [`SKILLS.md`](./docs/extensions/SKILLS.md) | SKILL.md format specification, skill authoring guide |
+| [`PLATFORM_SUPPORT.md`](./docs/architecture/PLATFORM_SUPPORT.md) | Channel platform capabilities and adapter configuration |
+| [`ECOSYSTEM.md`](./docs/architecture/ECOSYSTEM.md) | Extension ecosystem, official packs, community extensions |
+| [`PROVENANCE_IMMUTABILITY.md`](./docs/safety/PROVENANCE_IMMUTABILITY.md) | Sealed agents, signed event ledger, external anchoring |
+| [`IMMUTABLE_AGENTS.md`](./docs/safety/IMMUTABLE_AGENTS.md) | Agent sealing, toolset manifests, revision tracking |
+| [`RFC_EXTENSION_STANDARDS.md`](./docs/extensions/RFC_EXTENSION_STANDARDS.md) | Extension pack authoring standards and conventions |
+| [`EVALUATION_FRAMEWORK.md`](./docs/observability/EVALUATION_FRAMEWORK.md) | Agent evaluation, benchmarking, quality metrics |
+| [`RECURSIVE_SELF_BUILDING_AGENTS.md`](./docs/architecture/RECURSIVE_SELF_BUILDING_AGENTS.md) | Self-modifying agent patterns |
+| [`LOGGING.md`](./docs/observability/LOGGING.md) | Structured logging configuration with pino |
+| [`CLIENT_SIDE_STORAGE.md`](./docs/memory/CLIENT_SIDE_STORAGE.md) | Browser-compatible storage adapters |
+| [`SQL_STORAGE_QUICKSTART.md`](./docs/getting-started/SQL_STORAGE_QUICKSTART.md) | SQLite/Postgres setup with `@framers/sql-storage-adapter` |
+| [`RELEASING.md`](./docs/getting-started/RELEASING.md) | Release process and semantic versioning |
 
 ---
 

package/dist/agents/agency/AgencyMemoryManager.d.ts

@@ -0,0 +1,300 @@
+/**
+ * @file AgencyMemoryManager.ts
+ * @description Manages shared RAG memory for Agency (multi-GMI) collectives.
+ * Enables GMIs within an agency to share context, collaborate effectively,
+ * and maintain collective memory across conversations.
+ *
+ * @module AgentOS/Agency
+ * @version 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const memoryManager = new AgencyMemoryManager(vectorStoreManager, logger);
+ *
+ * // Initialize shared memory for an agency
+ * await memoryManager.initializeAgencyMemory(agencySession);
+ *
+ * // Ingest document to shared memory
+ * await memoryManager.ingestToSharedMemory(agencyId, {
+ *   content: 'Important context from GMI-1',
+ *   contributorGmiId: 'gmi-1',
+ *   contributorRoleId: 'researcher',
+ * });
+ *
+ * // Query shared memory
+ * const results = await memoryManager.querySharedMemory(agencyId, {
+ *   query: 'What did the researcher find?',
+ *   requestingGmiId: 'gmi-2',
+ *   requestingRoleId: 'analyst',
+ * });
+ * ```
+ */
+import type { ILogger } from '../../logging/ILogger';
+import type { IVectorStoreManager } from '../../core/vector-store/IVectorStoreManager';
+import type { AgencySession, AgencyMemoryConfig, AgencyMemoryOperationResult, AgencyMemoryQueryOptions } from './AgencyTypes';
+/**
+ * Input for ingesting documents to agency shared memory.
+ */
+export interface AgencyMemoryIngestInput {
+    /** Document content */
+    content: string;
+    /** GMI that contributed this content */
+    contributorGmiId: string;
+    /** Role of the contributing GMI */
+    contributorRoleId: string;
+    /** Document category */
+    category?: 'communication' | 'finding' | 'decision' | 'summary' | 'context';
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Optional pre-computed embedding */
+    embedding?: number[];
+}
+/**
+ * Retrieved chunk from agency shared memory.
+ */
+export interface AgencyMemoryChunk {
+    /** Chunk ID */
+    chunkId: string;
+    /** Document ID */
+    documentId: string;
+    /** Content text */
+    content: string;
+    /** Similarity score */
+    score: number;
+    /** Contributing GMI */
+    contributorGmiId: string;
+    /** Contributing role */
+    contributorRoleId: string;
+    /** Document category */
+    category: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result of querying agency shared memory.
+ */
+export interface AgencyMemoryQueryResult {
+    /** Whether query succeeded */
+    success: boolean;
+    /** Retrieved chunks */
+    chunks: AgencyMemoryChunk[];
+    /** Total matching results */
+    totalResults: number;
+    /** Query processing time in ms */
+    processingTimeMs: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Statistics for agency memory.
+ */
+export interface AgencyMemoryStats {
+    /** Total documents in shared memory */
+    totalDocuments: number;
+    /** Total chunks */
+    totalChunks: number;
+    /** Documents by role */
+    documentsByRole: Record<string, number>;
+    /** Documents by category */
+    documentsByCategory: Record<string, number>;
+    /** Last ingestion timestamp */
+    lastIngestionAt?: string;
+}
+/**
+ * Manages shared RAG memory for Agency collectives.
+ *
+ * @remarks
+ * This manager provides:
+ * - Initialization of dedicated data sources for agencies
+ * - Ingestion with role-based access control
+ * - Cross-GMI context queries with permission checks
+ * - Memory lifecycle management (retention, eviction)
+ *
+ * Architecture:
+ * ```
+ * AgencyMemoryManager
+ *         │
+ *         ├─► VectorStoreManager (storage backend)
+ *         │
+ *         ├─► AgencyRegistry (session state)
+ *         │
+ *         └─► Per-Agency Collections
+ *              └─► agency-{agencyId}-shared
+ * ```
+ */
+export declare class AgencyMemoryManager {
+    private readonly vectorStoreManager;
+    private readonly logger?;
+    /** Collection name prefix for agency shared memory */
+    private static readonly COLLECTION_PREFIX;
+    /** Default memory configuration */
+    private static readonly DEFAULT_CONFIG;
+    /** Tracks initialized agencies */
+    private readonly initializedAgencies;
+    /**
+     * Creates a new AgencyMemoryManager instance.
+     *
+     * @param vectorStoreManager - Vector store manager for RAG operations
+     * @param logger - Optional logger for diagnostics
+     */
+    constructor(vectorStoreManager: IVectorStoreManager | null, logger?: ILogger | undefined);
+    /**
+     * Initializes shared memory for an agency.
+     * Creates dedicated collection and applies configuration.
+     *
+     * @param session - Agency session to initialize memory for
+     * @returns Operation result
+     */
+    initializeAgencyMemory(session: AgencySession): Promise<AgencyMemoryOperationResult>;
+    /**
+     * Ingests a document to agency shared memory.
+     *
+     * @param agencyId - Target agency
+     * @param input - Document to ingest
+     * @param config - Agency memory configuration
+     * @returns Operation result
+     */
+    ingestToSharedMemory(agencyId: string, input: AgencyMemoryIngestInput, config?: AgencyMemoryConfig): Promise<AgencyMemoryOperationResult>;
+    /**
+     * Queries agency shared memory.
+     *
+     * @param agencyId - Target agency
+     * @param options - Query options
+     * @param config - Agency memory configuration
+     * @returns Query result with retrieved chunks
+     */
+    querySharedMemory(agencyId: string, options: AgencyMemoryQueryOptions, config?: AgencyMemoryConfig): Promise<AgencyMemoryQueryResult>;
+    /**
+     * Gets statistics for agency shared memory.
+     *
+     * @param agencyId - Target agency
+     * @returns Memory statistics
+     */
+    getStats(agencyId: string): Promise<AgencyMemoryStats | null>;
+    /**
+     * Cleans up agency memory when agency is removed.
+     *
+     * @param agencyId - Agency to clean up
+     * @returns Operation result
+     */
+    cleanupAgencyMemory(agencyId: string): Promise<AgencyMemoryOperationResult>;
+    /**
+     * Gets the collection ID for an agency's shared memory.
+     */
+    private getCollectionId;
+    /**
+     * Resolves configuration with defaults.
+     */
+    private resolveConfig;
+    /**
+     * Checks if agency memory is initialized.
+     */
+    isInitialized(agencyId: string): boolean;
+    /**
+     * Broadcasts context from one GMI to all others in the agency.
+     * This is useful for sharing discoveries, decisions, or important updates.
+     *
+     * @param agencyId - Target agency
+     * @param input - Broadcast input
+     * @param config - Agency memory configuration
+     * @returns Operation result with broadcast metadata
+     *
+     * @example
+     * ```typescript
+     * await memoryManager.broadcastToAgency(agencyId, {
+     *   content: 'Found critical security vulnerability in auth module',
+     *   senderGmiId: 'security-analyst-gmi',
+     *   senderRoleId: 'security-analyst',
+     *   broadcastType: 'finding',
+     *   priority: 'high',
+     * });
+     * ```
+     */
+    broadcastToAgency(agencyId: string, input: {
+        content: string;
+        senderGmiId: string;
+        senderRoleId: string;
+        broadcastType: 'finding' | 'decision' | 'update' | 'request' | 'alert';
+        priority?: 'low' | 'normal' | 'high' | 'critical';
+        targetRoles?: string[];
+        metadata?: Record<string, unknown>;
+    }, config?: AgencyMemoryConfig): Promise<AgencyMemoryOperationResult>;
+    /**
+     * Gets recent context contributions from specific roles.
+     * Enables GMIs to selectively query context from collaborators.
+     *
+     * @param agencyId - Target agency
+     * @param options - Query options with role filtering
+     * @param config - Agency memory configuration
+     * @returns Query result filtered by contributor roles
+     *
+     * @example
+     * ```typescript
+     * // Get recent findings from the researcher role
+     * const findings = await memoryManager.getContextFromRoles(agencyId, {
+     *   fromRoles: ['researcher', 'analyst'],
+     *   categories: ['finding', 'summary'],
+     *   requestingGmiId: 'coordinator-gmi',
+     *   requestingRoleId: 'coordinator',
+     *   limit: 10,
+     * });
+     * ```
+     */
+    getContextFromRoles(agencyId: string, options: {
+        fromRoles: string[];
+        categories?: ('communication' | 'finding' | 'decision' | 'summary' | 'context')[];
+        requestingGmiId: string;
+        requestingRoleId: string;
+        limit?: number;
+        minScore?: number;
+    }, config?: AgencyMemoryConfig): Promise<AgencyMemoryQueryResult>;
+    /**
+     * Shares a synthesis or summary across all GMIs in the agency.
+     * Typically used by coordinator or synthesizer roles.
+     *
+     * @param agencyId - Target agency
+     * @param summary - Summary content and metadata
+     * @param config - Agency memory configuration
+     * @returns Operation result
+     */
+    shareSynthesis(agencyId: string, summary: {
+        content: string;
+        synthesizerId: string;
+        synthesizerRoleId: string;
+        sourceRoles?: string[];
+        summaryType: 'interim' | 'final' | 'action_items' | 'consensus';
+        metadata?: Record<string, unknown>;
+    }, config?: AgencyMemoryConfig): Promise<AgencyMemoryOperationResult>;
+    /**
+     * Records a decision made by the agency for future reference.
+     *
+     * @param agencyId - Target agency
+     * @param decision - Decision details
+     * @param config - Agency memory configuration
+     * @returns Operation result
+     */
+    recordDecision(agencyId: string, decision: {
+        content: string;
+        decisionMakerId: string;
+        decisionMakerRoleId: string;
+        decisionType: 'consensus' | 'delegation' | 'escalation' | 'resolution';
+        affectedRoles?: string[];
+        rationale?: string;
+        metadata?: Record<string, unknown>;
+    }, config?: AgencyMemoryConfig): Promise<AgencyMemoryOperationResult>;
+    /**
+     * Gets all decisions made by the agency.
+     *
+     * @param agencyId - Target agency
+     * @param options - Query options
+     * @param config - Agency memory configuration
+     * @returns Query result with decision chunks
+     */
+    getDecisions(agencyId: string, options: {
+        requestingGmiId: string;
+        requestingRoleId: string;
+        decisionTypes?: ('consensus' | 'delegation' | 'escalation' | 'resolution')[];
+        limit?: number;
+    }, config?: AgencyMemoryConfig): Promise<AgencyMemoryQueryResult>;
+}
+//# sourceMappingURL=AgencyMemoryManager.d.ts.map

package/dist/agents/agency/AgencyMemoryManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgencyMemoryManager.d.ts","sourceRoot":"","sources":["../../../src/agents/agency/AgencyMemoryManager.ts"],"names":[],"mappings":"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"}