@framers/agentos 0.13.1 → 0.13.3

package/README.md

@@ -8,7 +8,7 @@
 
 # **AgentOS** · TypeScript AI Agent Framework
 
-**Agents that remember, forge their own tools, and survive long-running sessions.** Persistent cognitive memory, optional HEXACO personality, multi-agent orchestration, and one dispatch interface across 11 LLM providers. Apache-2.0.
+**Agents that remember, forge their own tools, and survive long-running sessions.** Persistent cognitive memory, optional HEXACO personality, multi-agent orchestration, and one dispatch interface across 13 LLM providers. Apache-2.0.
 
 [![npm](https://img.shields.io/npm/v/@framers/agentos?style=flat-square&logo=npm&color=cb3837)](https://www.npmjs.com/package/@framers/agentos)
 [![CI](https://img.shields.io/github/actions/workflow/status/framerslab/agentos/ci.yml?branch=master&style=flat-square&logo=github&label=CI)](https://github.com/framerslab/agentos/actions/workflows/ci.yml)
@@ -31,9 +31,9 @@
 AgentOS is an open-source TypeScript framework for AI agents that **remember, adapt, and write their own tools**.
 
 - **Top open-source memory benchmarks:** [85.6% on LongMemEval-S](https://github.com/framerslab/agentos-bench/blob/master/results/LEADERBOARD.md) at $0.0090/correct (gpt-4o), and 70.2% on LongMemEval-M, the only open-source library above 65% on M with reproducible methodology.
-- **Runtime tool forging.** An agent writes a JavaScript function with JSON Schemas for its input and output, an LLM judge approves it, and it runs in a `node:vm` context or, with `QuickJSExecutor`, in a QuickJS WebAssembly instance of its own for each call, before joining the catalog for the rest of the session.
-- **Persistent [cognitive memory](https://docs.agentos.sh/features/cognitive-memory)** with 8 neuroscience-backed mechanisms: Ebbinghaus decay, retrieval-induced forgetting, reconsolidation, source-confidence decay.
-- **Optional [HEXACO personality](https://docs.agentos.sh/features/hexaco-personality)**, [6 orchestration strategies](https://docs.agentos.sh/features/agency-collaboration), [guardrails](https://docs.agentos.sh/features/guardrails-architecture), and [voice](https://docs.agentos.sh/features/voice-pipeline) across **11 LLM providers**; 100+ extensions and 88 skills auto-load at startup.
+- **Runtime tool forging.** An agent writes a JavaScript function with JSON Schemas for its input and output, the declared test cases run it, an LLM judge reviews the result, and on approval the tool joins the session's tool list. Forged code runs in an in-process `node:vm` context or, with `QuickJSExecutor`, in a QuickJS WebAssembly instance of its own for each call.
+- **Persistent [cognitive memory](https://docs.agentos.sh/features/cognitive-memory)** with Ebbinghaus decay and 8 neuroscience-backed mechanisms, among them retrieval-induced forgetting, reconsolidation and source-confidence decay.
+- **Optional [HEXACO personality](https://docs.agentos.sh/features/hexaco-personality)**, [6 orchestration strategies](https://docs.agentos.sh/features/agency-collaboration), [guardrails](https://docs.agentos.sh/features/guardrails-architecture), and [voice](https://docs.agentos.sh/features/voice-pipeline) across **13 LLM providers**; 100+ extensions and 88 skills auto-load at startup.
 
 ---
 
@@ -90,11 +90,11 @@ bounded.reseed([{ role: 'user', content: 'compact resume snapshot' }]);
 
 ## Emergent Design
 
-Three things accumulate across a session and compose into behavior: **memory** (what was said, decided, retrieved), the **tool surface** (which grows when an agent forges a tool the judge approves), and an optional **HEXACO personality** vector that biases retrieval, routing, and decisions. Each is configurable and observable.
+Three things accumulate across a session and compose into behavior: **memory** (what was said, decided, retrieved), the **tool surface** (which grows when an agent forges a tool the judge approves), and an optional **HEXACO personality** vector that shapes the prompt and scales memory encoding. Each is configurable and observable.
 
-**Runtime tool forging.** When no tool covers a sub-task, the agent writes a JavaScript function with JSON Schemas for its input and output; a separate LLM judge approves it; it runs in a `node:vm` context (5s wall clock, no `eval`/`require`/`process`) or, with `QuickJSExecutor`, in a QuickJS WebAssembly instance of its own for each call with its memory limited, then joins a discoverable index for the rest of the session. First forge costs full tokens; reuse costs tens. Promoted tools export as `SKILL.md` skills. [Emergent capabilities ->](https://docs.agentos.sh/features/emergent-capabilities)
+**Runtime tool forging.** When no tool covers a sub-task, the agent calls `forge_tool` with a chain of existing tools or a JavaScript function, JSON Schemas for input and output, and test cases. Code mode is off until the host sets `emergentConfig.allowSandboxTools`. Source that uses `eval`, `require` or `process` is rejected before it runs. Forged code runs in an in-process `node:vm` context by default, with a 5 s timeout, and `node:vm` is not a security boundary; with `QuickJSExecutor`, each call runs in a QuickJS WebAssembly instance of its own with its memory limited. A separate LLM judge reviews the candidate with its test results, and an approved tool joins the session's tool list. A forged tool exports as a `SKILL.md` skill. [Emergent capabilities ->](https://docs.agentos.sh/features/emergent-capabilities)
 
-**HEXACO personality (optional).** Off by default; the runtime behaves identically without it. When supplied, the kernel weights retrieval, specialist routing, and tool selection by trait values, so the same prompt and tools yield measurably different decision sequences. It lives in the kernel, not the prompt, so it persists under context pressure. [HEXACO docs ->](https://docs.agentos.sh/features/hexaco-personality)
+**HEXACO personality (optional).** Off by default. `agent()` writes the trait values into the system prompt as directives, one for each trait above 0.65 or below 0.35. A cognitive memory manager given the same traits scales its encoding and seven of its eight mechanisms by them, and an `AgentGraph` branches on a trait with `addPersonalityEdge()`. [HEXACO docs ->](https://docs.agentos.sh/features/hexaco-personality)
 
 **Soul files.** Identity, voice, hard limits, and HEXACO scores can live in a `SOUL.md` workspace. Its `memory/` directory is a markdown wiki (an `index.md` catalog plus `entities/`, `concepts/`, `log/` pages with `[[wikilinks]]`) that *is* the agent's long-term memory: markdown is the source of truth, the vector/graph index is rebuilt from it, and [`souledAgent()`](https://docs.agentos.sh/getting-started/high-level-api) wires it end to end. [Soul Files ->](https://docs.agentos.sh/features/soul-files)
 
@@ -161,7 +161,7 @@ for await (const chunk of agentos.processRequest({
 
 | Category | Highlights |
 |---|---|
-| **LLM Providers** | 11 (9 API-key + 2 local CLI): OpenAI, Anthropic, Gemini, Groq, Ollama, OpenRouter, Together, Mistral, xAI, Claude CLI, Gemini CLI. Plus image/video/audio generation providers. |
+| **LLM Providers** | 13 (11 by API key or base URL + 2 local CLI): OpenAI, Anthropic, Gemini, Groq, Ollama, OpenRouter, Requesty, LiteLLM, Together, Mistral, xAI, Claude CLI, Gemini CLI. Plus image/video/audio generation providers. |
 | **Prompt Caching** | Zero config on every provider: automatic Anthropic breakpoints incl. multi-turn history (direct + OpenRouter) * OpenAI cache-key routing * normalized cache usage + leak detection * per-call TTL/opt-out * [guide](https://docs.agentos.sh/features/prompt-caching) |
 | **Cognitive Memory** | 8 mechanisms: reconsolidation, retrieval-induced forgetting, involuntary recall, FOK, gist extraction, schema encoding, source decay, emotion regulation |
 | **HEXACO Personality** | 6 traits modulate memory, retrieval bias, response style |
@@ -202,7 +202,7 @@ Strategies: `sequential`, `parallel`, `debate`, `review-loop`, `hierarchical`, `
 
 | Package | Role |
 |---|---|
-| [`@framers/agentos`](https://www.npmjs.com/package/@framers/agentos) | Core runtime: agents, cognitive memory, orchestration, guardrails, voice, 11 LLM providers. Apache-2.0. |
+| [`@framers/agentos`](https://www.npmjs.com/package/@framers/agentos) | Core runtime: agents, cognitive memory, orchestration, guardrails, voice, 13 LLM providers. Apache-2.0. |
 | [`@framers/agentos-extensions`](https://www.npmjs.com/package/@framers/agentos-extensions) | 100+ first-party extensions: channel adapters, tool packs, integrations, guardrail packs. |
 | [`@framers/agentos-extensions-registry`](https://www.npmjs.com/package/@framers/agentos-extensions-registry) | Discovery + auto-loader for the extensions catalog. |
 | [`@framers/agentos-skills`](https://www.npmjs.com/package/@framers/agentos-skills) | 88 curated `SKILL.md` skills. |
@@ -218,7 +218,7 @@ Extensions and skills auto-load at startup. [Extensions architecture ->](https:/
 
 ## Configure API Keys
 
-Three layers, highest priority first: inline `apiKey` on the call, a module-level `setDefaultProvider()` at boot, or environment-variable auto-detection (`OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, and the rest, resolved in priority order and reorderable with `setProviderPriority([...])`). Comma-separated keys auto-rotate on quota.
+Three layers, highest priority first: inline `apiKey` on the call, a module-level `setDefaultProvider()` at boot, or environment-variable auto-detection (`OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, and the rest, resolved in priority order and reorderable with `setProviderPriority([...])`). A comma-separated list of keys rotates per request on the providers that support it ([Key rotation](https://github.com/framerslab/agentos/blob/master/docs/KEY_ROTATION.md)).
 
 [Full credential resolution + default models per provider ->](https://docs.agentos.sh/architecture/llm-providers)
 
@@ -227,7 +227,7 @@ Three layers, highest priority first: inline `apiKey` on the call, a module-leve
 ## API Surfaces
 
 - **`agent()`**: lightweight stateful agent. Prompts, sessions, personality, hooks, tools, memory.
-- **`agency()`**: multi-agent teams built from `agent()` members, with emergent tooling, guardrails, RAG, voice and HITL. It wires no channels; channel adapters run on the full runtime or with `ChannelRouter`.
+- **`agency()`**: multi-agent teams built from `agent()` members, with HITL approval gates, run limits, structured output, provenance and, on the hierarchical strategy, specialists spawned at runtime. Its `guardrails` and `rag` options are reported or logged and not applied, and `voice.enabled` serves the agency as JSON text over a local WebSocket. It wires no channels; channel adapters run on the full runtime or with `ChannelRouter`.
 - **`generateText()` / `streamText()` / `generateObject()` / `generateImage()` / `generateVideo()` / `generateMusic()` / `performOCR()` / `embedText()`**: low-level multi-modal helpers with native tool calling.
 - **`workflow()` / `AgentGraph` / `mission()`**: three orchestration authoring APIs over one graph runtime.
 

package/dist/api/AgentOS.d.ts

@@ -67,6 +67,7 @@ import { StreamingManagerConfig, StreamId } from '../core/streaming/StreamingMan
 import { ILogger } from '../core/logging/ILogger';
 import { type AgentOSObservabilityConfig } from '../safety/evaluation/observability/otel';
 import type { IGuardrailService } from '../safety/guardrails/IGuardrailService';
+import { type RequiredGuardrailSpec } from '../safety/guardrails/requiredGuardrails';
 import { type ISpendMeter } from '../safety/runtime/SpendMeter';
 import type { EmergentConfig } from '../cognition/emergent/types.js';
 import type { IPersonaLoader } from '../cognition/substrate/personas/IPersonaLoader';
@@ -310,6 +311,18 @@ export interface AgentOSConfig {
     subscriptionService?: ISubscriptionService;
     /** Optional guardrail service implementation used for policy enforcement. */
     guardrailService?: IGuardrailService;
+    /**
+     * Guards the deployment cannot run without, by id and stage. `initialize()` refuses to finish when one is missing
+     * or does not implement a named stage; `processRequest()` refuses a request (`SYS_GUARDRAIL_REQUIRED_MISSING`) when
+     * one has gone missing since. Each runs fail-closed with its deadline, and a guard required on `output` puts the
+     * output in hold mode.
+     */
+    requiredGuardrails?: RequiredGuardrailSpec[];
+    /**
+     * `hold`: no TEXT_DELTA reaches the caller before the output guards have judged the whole reply. Default `stream`;
+     * forced to `hold` when a required guard covers the output stage.
+     */
+    guardrailOutputMode?: 'stream' | 'hold';
     /** Optional map of secretId -> value for extension/tool credentials. */
     extensionSecrets?: Record<string, string>;
     /**
@@ -648,8 +661,24 @@ export declare class AgentOS implements IAgentOS {
      * with `code` set to `GMIErrorCode.CONFIGURATION_ERROR`.
      */
     private validateConfiguration;
+    /** True when the overrides disable the guard given in `config.guardrailService`. */
+    private configGuardrailDisabled;
     private registerConfigGuardrailService;
+    /** Every active guard with the id a required guard is named by: its own `id`, else its descriptor's. */
+    private listActiveGuardrails;
+    /** The required guards' report for this moment, or null when the deployment requires none. */
+    private requiredGuardrailReport;
     private getActiveGuardrailServices;
+    /**
+     * With conversational persistence on, the orchestrator stores the model's reply before the output guards run. When
+     * a guard replaced or rewrote it, the stored message is made to hold what the person saw, so the history never
+     * carries a reply the guards refused. A reply blocked with no replacement is emptied, with the reason recorded.
+     */
+    private recordGuardedReply;
+    /** Hold mode: set, or forced by a guard required on the output stage. */
+    private holdsOutputUntilFinal;
+    /** The error chunk a request is refused with while a required guard is missing. */
+    private requiredGuardrailMissingChunk;
     private ensureUtilityAIService;
     private buildDefaultUtilityAI;
     /**

package/dist/api/AgentOS.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentOS.d.ts","sourceRoot":"","sources":["../../src/api/AgentOS.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EACV,iCAAiC,EACjC,uCAAuC,EACxC,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EACL,eAAe,EAIhB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAChC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC7B,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEvF,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAG/E,OAAO,EAEL,2BAA2B,EAC5B,MAAM,kDAAkD,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gDAAgD,CAAC;AAC/F,OAAO,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAEtE,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAChG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAC;AAC9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAC3F,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,gDAAgD,CAAC;AACtG,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAEL,sBAAsB,EACtB,QAAQ,EACT,MAAM,oCAAoC,CAAC;AAI5C,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAoB,MAAM,wCAAwC,CAAC;AAClG,OAAO,EAA8B,KAAK,WAAW,EAAwB,MAAM,8BAA8B,CAAC;AAClH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAQrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,EACL,gBAAgB,EAOhB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0DAA0D,CAAC;AAC5G,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yCAAyC,CAAC;AACtE,OAAO,KAAK,EACV,wCAAwC,EACxC,yCAAyC,EAC1C,MAAM,8DAA8D,CAAC;AACtE,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAA+B,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAS7F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,KAAK,EACV,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,kBAAkB,EACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AACvF,OAAO,KAAK,EACV,kBAAkB,EAElB,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACf,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,mDAAmD,CAAC;AAwH3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,iCAAiC;IAChD,MAAM,CAAC,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC1C,UAAU,CAAC,EAAE,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAClD,QAAQ,CAAC,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC9C,SAAS,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACnC,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,SAAS,CAAC,EAAE,WAAW,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,GAAG;QACxD;;;WAGG;QACH,MAAM,CAAC,EAAE,0BAA0B,CAAC;QACpC;;;WAGG;QACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B;;WAEG;QACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B;;WAEG;QACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B;;WAEG;QACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B;;WAEG;QACH,MAAM,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAC5C;;WAEG;QACH,OAAO,CAAC,EAAE,iCAAiC,CAAC;KAC7C,CAAC;CACH;AAED,MAAM,WAAW,wBAAyB,SAAQ,2BAA2B;IAC3E;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAErE;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC,GACpD,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;IAE5D;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,SAAS,GAAG,iBAAiB,CAAC,CAAC;IAE3F;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,GAAG,wCAAwC,CAAC;IAEvE;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,GAAG,yCAAyC,CAAC;CAC1E;AAED;;;;;GAKG;AACH,yGAAyG;AACzG,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,WAAW,CAAC;IACnB,wFAAwF;IACxF,WAAW,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC;IAC1C,+CAA+C;IAC/C,OAAO,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC;CACvC;AAoBD,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,yDAAyD;IACzD,kBAAkB,EAAE,yBAAyB,CAAC;IAC9C;;;OAGG;IACH,wBAAwB,CAAC,EAAE,yBAAyB,CAAC;IACrD;;;OAGG;IACH,uBAAuB,CAAC,EAAE,wBAAwB,CAAC;IACnD;;;OAGG;IACH,yBAAyB,CAAC,EAAE,0BAA0B,CAAC;IACvD;;;;OAIG;IACH,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IACzC;;;OAGG;IACH,iCAAiC,CAAC,EAAE,OAAO,CAAC;IAC5C;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,EAAE;QACV,2EAA2E;QAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,mFAAmF;QACnF,sBAAsB,EAAE,sBAAsB,CAAC;QAC/C,sDAAsD;QACtD,wBAAwB,EAAE,wBAAwB,CAAC;QACnD,+DAA+D;QAC/D,iBAAiB,EAAE,mBAAmB,EAAE,CAAC;QACzC,wEAAwE;QACxE,wBAAwB,EAAE,+BAA+B,CAAC;QAC1D;;;WAGG;QACH,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B;;;;WAIG;QACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;IACF,2CAA2C;IAC3C,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,+CAA+C;IAC/C,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,uEAAuE;IACvE,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC,qDAAqD;IACrD,2BAA2B,EAAE,2BAA2B,CAAC;IACzD,yDAAyD;IACzD,yBAAyB,EAAE,yBAAyB,CAAC;IACrD,wDAAwD;IACxD,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,4DAA4D;IAC5D,0BAA0B,EAAE,4BAA4B,CAAC;IACzD,4EAA4E;IAC5E,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;;;;;;;;;;;OAeG;IACH,MAAM,EAAE,YAAY,CAAC;IACrB,uHAAuH;IACvH,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,6HAA6H;IAC7H,mBAAmB,CAAC,EAAE,oBAAoB,CAAC;IAC3C,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,6BAA6B,CAAC;IACjD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,EAAE;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB;;;WAGG;QACH,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,6FAA6F;QAC7F,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB;;;;;WAKG;QACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;IACF;;;;;OAKG;IACH,YAAY,CAAC,EAAE,yBAAyB,CAAC;IACzC;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,UAAU,GAAG,sBAAsB,CAAC;IACvD,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,cAAc,CAAC,EAAE,OAAO,8BAA8B,EAAE,mBAAmB,CAAC;IAC5E,8CAA8C;IAC9C,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,0FAA0F;IAC1F,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,wFAAwF;IACxF,cAAc,CAAC,EAAE,OAAO,2BAA2B,EAAE,qBAAqB,CAAC;IAC3E,0EAA0E;IAC1E,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAChC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAEzC;;;OAGG;IACH,aAAa,CAAC,EAAE,0BAA0B,CAAC;CAC5C;AAED,MAAM,WAAW,iCAAiC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,qBAAqB,EAAE,MAAM,CAAC;QAC9B,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE;QACR,mBAAmB,EAAE,OAAO,CAAC;QAC7B,gBAAgB,EAAE,OAAO,CAAC;QAC1B,gBAAgB,EAAE,OAAO,CAAC;QAC1B,oBAAoB,EAAE,OAAO,CAAC;QAC9B,kBAAkB,EAAE,OAAO,CAAC;QAC5B,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACjC,CAAC;IACF,UAAU,EAAE;QACV,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,aAAa,EAAE;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,iCAAiC,EAAE,CAAC;KAC5C,CAAC;IACF,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,wBAAwB,EAAE,CAAC;KACnC,CAAC;CACH;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,OAAQ,YAAW,QAAQ;IAgC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IA/BnC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,sBAAsB,CAAiC;IAE/D,OAAO,CAAC,oBAAoB,CAA0B;IACtD,OAAO,CAAC,gBAAgB,CAAuC;IAC/D,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,qBAAqB,CAA0B;IACvD,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,eAAe,CAAC,CAAsD;IAC9E,OAAO,CAAC,gBAAgB,CAAC,CAAoB;IAC7C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,oBAAoB,CAAC,CAAiC;IAE9D,OAAO,CAAC,oBAAoB,CAAwB;IAEpD,OAAO,CAAC,WAAW,CAAC,CAAe;IAEnC,OAAO,CAAC,mBAAmB,CAAC,CAAuB;IACnD,OAAO,CAAC,MAAM,CAAgB;IAE9B;;;OAGG;gBAC0B,MAAM,GAAE,OAAiC;IAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;WACiB,MAAM,CACxB,SAAS,GAAE,OAAO,CAAC,aAAa,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO,EACrF,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,OAAO,CAAC;IAYnB;;;;;;;;;;;;OAYG;IACU,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA4W7D;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;YA+Ff,8BAA8B;IAiB5C,OAAO,CAAC,0BAA0B;YAgBpB,sBAAsB;YAWtB,qBAAqB;IAiBnC;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IAUZ,kBAAkB,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAuG3D,sBAAsB,IAAI,mBAAmB;IAK7C,aAAa,IAAI,UAAU;IAK3B,mBAAmB,IAAI,gBAAgB;IAK9C;;;;;OAKG;IACI,eAAe,IAAI,kBAAkB,EAAE;IASvC,mBAAmB,IAAI,iBAAiB;IAKxC,uBAAuB,IAAI,oBAAoB,GAAG,SAAS;IAK3D,uBAAuB,IAAI,oBAAoB,EAAE;IAKjD,uBAAuB,IAAI,sBAAsB;IAKxD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACW,cAAc,CAC1B,KAAK,EAAE,YAAY,GAClB,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;IAqQnD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACW,gBAAgB,CAC5B,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,GAAG,EACf,SAAS,EAAE,OAAO,EAClB,YAAY,CAAC,EAAE,MAAM,GACpB,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;IAYrC,iBAAiB,CAC7B,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,sBAAsB,EAAE,GACpC,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;IAgF5C,uBAAuB,IAAI,kBAAkB,EAAE;IAKzC,aAAa,CACxB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,GACL,OAAO,CAAC,gBAAgB,CAAC;IAKf,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAKjE,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAK1E,mBAAmB,CAC9B,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAK5B,oBAAoB,CAC/B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAKtB,wBAAwB,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,kBAAkB,EAAE,GAC5B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAKnC;;;;;;;;;;;OAWG;IACU,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;IAiB3F;;;;;;;;;;;;OAYG;IACU,sBAAsB,CACjC,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAwCzB,6BAA6B,CACxC,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iCAAiC,GAAG,IAAI,CAAC;IAYtC,yBAAyB,CACrC,cAAc,EAAE,iCAAiC,EACjD,WAAW,EAAE,sBAAsB,EAAE,EACrC,OAAO,GAAE,uCAA4C,GACpD,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;IAyEnD;;;;;;;;;;;;;;OAcG;IACU,eAAe,CAC1B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,mBAAmB,GACnC,OAAO,CAAC,IAAI,CAAC;IA0BhB;;;;;;;;OAQG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA2EvC"}
+{"version":3,"file":"AgentOS.d.ts","sourceRoot":"","sources":["../../src/api/AgentOS.ts"],"names":[],"mappings":"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"}

package/dist/api/AgentOS.js

@@ -55,6 +55,8 @@ import { GMIError, GMIErrorCode } from '../core/utils/errors.js';
 import { uuidv4 } from '../core/utils/uuid.js';
 import { createLogger } from '../core/logging/loggerFactory.js';
 import { configureAgentOSObservability, } from '../safety/evaluation/observability/otel.js';
+import { MessageRole } from '../core/conversation/ConversationMessage.js';
+import { assertRequiredGuardrails, checkRequiredGuardrails, withRequiredPosture, } from '../safety/guardrails/requiredGuardrails.js';
 import { SpendMeterUnavailableError } from '../safety/runtime/SpendMeter.js';
 // SelfImprovementToolDeps reserved for emergent capability integration
 import { GuardrailAction } from '../safety/guardrails/IGuardrailService.js';
@@ -320,6 +322,14 @@ export class AgentOS {
         const extensionLifecycleContext = { logger: this.logger };
         await this.extensionManager.loadManifest(extensionLifecycleContext);
         await this.registerConfigGuardrailService(extensionLifecycleContext);
+        if (this.config.requiredGuardrails?.length) {
+            try {
+                assertRequiredGuardrails(this.listActiveGuardrails(), this.config.requiredGuardrails);
+            }
+            catch (error) {
+                throw AgentOSServiceError.wrap(error, GMIErrorCode.CONFIGURATION_ERROR, 'A required guardrail is missing.', 'AgentOS.initialize');
+            }
+        }
         if (this.config.schemaOnDemandTools?.enabled === true) {
             const allowPackages = typeof this.config.schemaOnDemandTools.allowPackages === 'boolean'
                 ? this.config.schemaOnDemandTools.allowPackages
@@ -609,8 +619,12 @@ export class AgentOS {
             });
         }
     }
+    /** True when the overrides disable the guard given in `config.guardrailService`. */
+    configGuardrailDisabled() {
+        return this.config.extensionOverrides?.guardrails?.['config-guardrail-service']?.enabled === false;
+    }
     async registerConfigGuardrailService(context) {
-        if (!this.config.guardrailService) {
+        if (!this.config.guardrailService || this.configGuardrailDisabled()) {
             return;
         }
         const registry = this.extensionManager.getRegistry(EXTENSION_KIND_GUARDRAIL);
@@ -622,16 +636,82 @@ export class AgentOS {
             metadata: { origin: 'config' },
         }, context);
     }
-    getActiveGuardrailServices() {
-        const services = [];
+    /** Every active guard with the id a required guard is named by: its own `id`, else its descriptor's. */
+    listActiveGuardrails() {
+        const active = [];
         if (this.extensionManager) {
             const registry = this.extensionManager.getRegistry(EXTENSION_KIND_GUARDRAIL);
-            services.push(...registry.listActive().map((descriptor) => descriptor.payload));
+            for (const descriptor of registry.listActive()) {
+                active.push({ id: descriptor.payload?.id ?? descriptor.id, service: descriptor.payload });
+            }
         }
-        if (this.guardrailService && !services.includes(this.guardrailService)) {
-            services.push(this.guardrailService);
+        if (this.guardrailService && !this.configGuardrailDisabled() && !active.some((a) => a.service === this.guardrailService)) {
+            active.push({ id: this.guardrailService.id ?? 'config-guardrail-service', service: this.guardrailService });
         }
-        return services;
+        return active;
+    }
+    /** The required guards' report for this moment, or null when the deployment requires none. */
+    requiredGuardrailReport() {
+        const required = this.config.requiredGuardrails;
+        if (!required?.length)
+            return null;
+        return checkRequiredGuardrails(this.listActiveGuardrails(), required);
+    }
+    getActiveGuardrailServices() {
+        const required = this.config.requiredGuardrails ?? [];
+        return this.listActiveGuardrails().map(({ id, service }) => {
+            const spec = required.find((r) => r.id === id);
+            return spec ? withRequiredPosture(id, service, spec) : service;
+        });
+    }
+    /**
+     * With conversational persistence on, the orchestrator stores the model's reply before the output guards run. When
+     * a guard replaced or rewrote it, the stored message is made to hold what the person saw, so the history never
+     * carries a reply the guards refused. A reply blocked with no replacement is emptied, with the reason recorded.
+     */
+    async recordGuardedReply(conversationKey, verdict) {
+        const rewritten = verdict.action === GuardrailAction.SANITIZE || verdict.action === GuardrailAction.BLOCK;
+        // a verdict on a streamed delta judged no whole reply, and the orchestrator stores the reply only once the turn
+        // ends: that case is left to hold mode, where nothing streams before the final verdict
+        if (!rewritten || verdict.originalText === null || !this.config.orchestratorConfig?.enableConversationalPersistence || !this.conversationManager)
+            return;
+        try {
+            const context = await this.conversationManager.getConversation(conversationKey);
+            if (!context)
+                return;
+            // the message the verdict was about, by its text (the orchestrator stored the same string the guards judged):
+            // the newest such message is this turn's, and an earlier turn's reply is never touched
+            const stored = [...context.getAllMessages()].reverse().find((m) => m.role === MessageRole.ASSISTANT && m.metadata?.source === 'agentos_output' && m.content === verdict.originalText);
+            if (!stored)
+                return;
+            context.replaceMessageContent(stored.id, verdict.finalText ?? '', {
+                modificationInfo: { strategy: 'filtered', reason: `guardrail:${verdict.reasonCode ?? verdict.action}` },
+            });
+            await this.conversationManager.saveConversation(context);
+        }
+        catch (error) {
+            this.logger.warn('The guarded reply could not be written to the conversation', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    /** Hold mode: set, or forced by a guard required on the output stage. */
+    holdsOutputUntilFinal() {
+        return this.config.guardrailOutputMode === 'hold' || (this.config.requiredGuardrails ?? []).some((r) => r.stages.includes('output'));
+    }
+    /** The error chunk a request is refused with while a required guard is missing. */
+    requiredGuardrailMissingChunk(report, streamId, personaId) {
+        return {
+            type: AgentOSResponseChunkType.ERROR,
+            streamId,
+            gmiInstanceId: 'guardrail',
+            personaId,
+            isFinal: true,
+            timestamp: new Date().toISOString(),
+            code: GMIErrorCode.GUARDRAIL_REQUIRED_MISSING,
+            message: 'A guardrail this deployment requires is not active, so the request was not run.',
+            details: { missing: report.missing, missingStage: report.missingStage },
+        };
     }
     async ensureUtilityAIService() {
         if (this.utilityAIService) {
@@ -836,6 +916,12 @@ export class AgentOS {
             conversationId: input.conversationId,
             metadata: input.options?.customFlags,
         };
+        const requiredReport = this.requiredGuardrailReport();
+        if (requiredReport && !requiredReport.ok) {
+            this.logger.error('A required guardrail is missing; the request was not run', { missing: requiredReport.missing, missingStage: requiredReport.missingStage });
+            yield this.requiredGuardrailMissingChunk(requiredReport, input.sessionId || `agentos-guardrail-${Date.now()}`, effectivePersonaId);
+            return;
+        }
         const guardrailServices = this.getActiveGuardrailServices();
         const guardrailReadyInput = {
             ...input,
@@ -956,6 +1042,8 @@ export class AgentOS {
                 streamId: streamIdToListen,
                 personaId: effectivePersonaId,
                 inputEvaluations: guardrailInputOutcome.evaluations ?? [],
+                holdUntilFinal: this.holdsOutputUntilFinal(),
+                onVerdict: (verdict) => this.recordGuardedReply(orchestratorInput.conversationId || orchestratorInput.sessionId, verdict),
             });
             if (orchestratorInput.workflowRequest) {
                 const wfRequest = orchestratorInput.workflowRequest;
@@ -1102,11 +1190,32 @@ export class AgentOS {
             // Register the bridge client to listen for new chunks on the existing stream
             await this.streamingManager.registerClient(streamId, bridge);
             console.log(`AgentOS.handleToolResults: Bridge client ${bridge.id} registered to stream ${streamId}.`);
+            // The stream's identity and the required guards, before the continuation starts: a missing guard means no
+            // model call, and a continuation that ends the turn removes the stream's context when it finishes.
+            const identity = this.agentOSOrchestrator.getStreamIdentity(streamId);
+            const continuationContext = {
+                userId: identity?.userId ?? 'unknown_user',
+                sessionId: identity?.sessionId ?? streamId,
+                personaId: identity?.personaId,
+                conversationId: identity?.conversationId,
+            };
+            const continuationReport = this.requiredGuardrailReport();
+            if (continuationReport && !continuationReport.ok) {
+                yield this.requiredGuardrailMissingChunk(continuationReport, streamId, identity?.personaId ?? 'unknown_persona');
+                return;
+            }
             // This call is `async Promise<void>`; it triggers the orchestrator to process the tool result(s)
             // and push new chunks to the StreamingManager for the given streamId.
             await this.agentOSOrchestrator.orchestrateToolResults(streamId, toolResults);
-            // Yield new chunks received by our bridge client on the same stream
-            for await (const chunk of bridge.consume()) {
+            // Yield new chunks received by our bridge client on the same stream, through the same output guards a turn has
+            const continuationKey = identity?.conversationId || identity?.sessionId || streamId;
+            const guardedContinuation = wrapOutputGuardrails(this.getActiveGuardrailServices(), continuationContext, bridge.consume(), {
+                streamId,
+                personaId: identity?.personaId,
+                holdUntilFinal: this.holdsOutputUntilFinal(),
+                onVerdict: (verdict) => this.recordGuardedReply(continuationKey, verdict),
+            });
+            for await (const chunk of guardedContinuation) {
                 yield chunk;
                 if (isActionableToolCallRequestChunk(chunk)) {
                     break;
@@ -1254,9 +1363,27 @@ export class AgentOS {
         let shouldDeregisterBridge = false;
         const bridge = new AsyncStreamClientBridge(`client-resumeToolReq-${pendingRequest.conversationId}-${Date.now()}`);
         try {
+            // the required guards, before the resumed turn starts: a missing guard means no model call
+            const resumeReport = this.requiredGuardrailReport();
+            if (resumeReport && !resumeReport.ok) {
+                yield this.requiredGuardrailMissingChunk(resumeReport, pendingRequest.streamId, pendingRequest.personaId);
+                return;
+            }
             streamIdToListen = await this.agentOSOrchestrator.orchestrateResumedToolResults(pendingRequest, toolResults, options);
             await this.streamingManager.registerClient(streamIdToListen, bridge);
-            for await (const chunk of bridge.consume()) {
+            const resumeContext = {
+                userId: pendingRequest.userId,
+                sessionId: pendingRequest.sessionId,
+                personaId: pendingRequest.personaId,
+                conversationId: pendingRequest.conversationId,
+            };
+            const guardedResume = wrapOutputGuardrails(this.getActiveGuardrailServices(), resumeContext, bridge.consume(), {
+                streamId: streamIdToListen,
+                personaId: pendingRequest.personaId,
+                holdUntilFinal: this.holdsOutputUntilFinal(),
+                onVerdict: (verdict) => this.recordGuardedReply(pendingRequest.conversationId, verdict),
+            });
+            for await (const chunk of guardedResume) {
                 yield chunk;
                 if (isActionableToolCallRequestChunk(chunk)) {
                     shouldDeregisterBridge = true;