@tangle-network/agent-runtime 0.102.0 → 0.102.1

package/dist/loops.js

@@ -1,23 +1,20 @@
 import {
   FileCorpus,
   InMemoryCorpus,
+  McpSpawnFault,
   SandboxRunAbortError,
-  adaptiveRefine,
   analyzeTrace,
   anytimeReport,
   assertStrategyContract,
   assertTraceDerivedFindings,
   auditIntent,
   authorStrategy,
-  breadthStrategy,
   buildSteerContext,
   builtinShapes,
-  canDisplace,
   collectAgentTurn,
-  compareCheckOutcomes,
   completionAuthorizes,
-  composeCheckSources,
   computeFindingId,
+  connectStdioMcp,
   createMcpEnvironment,
   createPushTraceSource,
   createScopeAnalyst,
@@ -25,22 +22,17 @@ import {
   createVerifierEnvironment,
   createWaterfallCollector,
   decodeToolPart,
-  defaultAnalystInstruction,
   defaultAuditorInstruction,
-  defaultExtractCandidate,
-  defaultStructuralRolloutPolicy,
   defaultToolDetectors,
   defineLeaderboard,
   definePersona,
-  defineStrategy,
-  depthStrategy,
   deterministicCompletion,
   discriminatingMeans,
   dumbDriver,
+  envKeyProvider,
   equalKOnCost,
   failuresAnalyst,
   fanout,
-  filterAuthoredAsserts,
   flatWidenGate,
   gitWorkspace,
   harvestCorpus,
@@ -48,15 +40,15 @@ import {
   inlineSandboxClient,
   jjWorkspace,
   leaderboard,
+  localSandboxClient,
   localShell,
   loopCampaignDispatch,
   loopDispatch,
   loopUntil,
   makeFinding,
-  modelAuthoredChecks,
+  materializeLocalMcp,
+  mcpSecretEnvMetadataKey,
   naiveDriver,
-  observe,
-  officialChecksFromMeta,
   openSandboxRun,
   pairwiseSignificance,
   panel,
@@ -65,7 +57,6 @@ import {
   pipeline,
   printBenchmarkReport,
   promotionGate,
-  refine,
   registerShape,
   registryScopeAnalyst,
   renderAnytimeTable,
@@ -74,35 +65,29 @@ import {
   renderLeaderboardMarkdown,
   renderLeaderboardSvg,
   renderPairwiseMarkdown,
-  renderReport,
   reportLoopUsage,
-  resolveEntrySymbol,
   resolveSandboxClient,
-  runAgentic,
+  resolveSecretEnv,
   runBenchmark,
   runInWorkspace,
   runPersonified,
   runStrategyEvolution,
-  sample,
-  sampleThenRefine,
-  sandboxCheckRunner,
   sandboxSessionTraceSource,
-  selectBestIndex,
+  sanitizeMcpToolSchema,
+  secretEnvOfMcpServer,
   selectChampion,
   selectValidWinner,
   sentinelCompletion,
   stopSentinel,
   strategyAuthorContract,
   streamAgentTurn,
-  structuralRollout,
   superviseSurface,
   trajectoryReport,
   verify,
-  visibleCheckScore,
   watchTrace,
   widen,
   worktreeFanout
-} from "./chunk-MAONWP4R.js";
+} from "./chunk-KPHTCHQ4.js";
 import "./chunk-Q2JSAVQ3.js";
 import {
   acquireSandbox,
@@ -110,15 +95,12 @@ import {
   assessAuthoredProfile,
   authoredWorker,
   cliWorktreeExecutor,
-  createBudgetPool,
   createEventBus,
   createExecutor,
   createExecutorRegistry,
   createInMemoryRunContext,
   createInbox,
   createSandboxLineage,
-  createScope,
-  createSupervisor,
   createWorktreeCliExecutor,
   defaultDelegateBudget,
   defaultProfileRichnessThresholds,
@@ -129,24 +111,54 @@ import {
   gateOnDeliverable,
   probeSandboxCapabilities,
   profileRichnessFinding,
-  routerBrain,
-  routerChatWithTools,
-  routerChatWithUsage,
-  routerToolLoop,
   runLoop,
   serveCoordinationMcp,
-  settledToIteration,
-  spendFromUsageEvents,
   supervise,
   supervisorAgent,
   supervisorInstructions,
   workerFromBackend
-} from "./chunk-KVJQV342.js";
+} from "./chunk-6MR4IJRW.js";
 import "./chunk-DPEUKJRO.js";
+import {
+  adaptiveRefine,
+  breadthStrategy,
+  canDisplace,
+  compareCheckOutcomes,
+  composeCheckSources,
+  defaultAnalystInstruction,
+  defaultExtractCandidate,
+  defaultStructuralRolloutPolicy,
+  defineStrategy,
+  depthStrategy,
+  filterAuthoredAsserts,
+  modelAuthoredChecks,
+  observe,
+  officialChecksFromMeta,
+  refine,
+  renderReport,
+  resolveEntrySymbol,
+  runAgentic,
+  sample,
+  sampleThenRefine,
+  sandboxCheckRunner,
+  selectBestIndex,
+  structuralRollout,
+  visibleCheckScore
+} from "./chunk-ROILMKDL.js";
+import "./chunk-UPWGXKXB.js";
 import "./chunk-2VZYRB55.js";
 import {
-  assertModelAllowed
-} from "./chunk-IKGCKPDX.js";
+  assertModelAllowed,
+  createBudgetPool,
+  createScope,
+  createSupervisor,
+  routerBrain,
+  routerChatWithTools,
+  routerChatWithUsage,
+  routerToolLoop,
+  settledToIteration,
+  spendFromUsageEvents
+} from "./chunk-SQ3ZJH3Y.js";
 import {
   InMemoryResultBlobStore,
   InMemorySpawnJournal,
@@ -173,6 +185,7 @@ export {
   InMemoryCorpus,
   InMemoryResultBlobStore,
   InMemorySpawnJournal,
+  McpSpawnFault,
   SandboxRunAbortError,
   acquireSandbox,
   adaptiveRefine,
@@ -196,6 +209,7 @@ export {
   completionAuthorizes,
   composeCheckSources,
   computeFindingId,
+  connectStdioMcp,
   contentAddress,
   createAgentEnvironmentProviderRegistry,
   createBudgetPool,
@@ -233,6 +247,7 @@ export {
   discriminatingMeans,
   driverAgent,
   dumbDriver,
+  envKeyProvider,
   equalKOnCost,
   extractLlmCallEvent,
   failuresAnalyst,
@@ -247,6 +262,7 @@ export {
   inlineSandboxClient,
   jjWorkspace,
   leaderboard,
+  localSandboxClient,
   localShell,
   loopCampaignDispatch,
   loopDispatch,
@@ -254,6 +270,8 @@ export {
   makeFinding,
   mapSandboxEvent,
   mapSandboxToolEvent,
+  materializeLocalMcp,
+  mcpSecretEnvMetadataKey,
   modelAuthoredChecks,
   naiveDriver,
   observe,
@@ -284,6 +302,7 @@ export {
   resolveAgentEnvironmentProvider,
   resolveEntrySymbol,
   resolveSandboxClient,
+  resolveSecretEnv,
   routerBrain,
   routerChatWithTools,
   routerChatWithUsage,
@@ -299,6 +318,8 @@ export {
   sandboxCheckRunner,
   sandboxClientAsProvider,
   sandboxSessionTraceSource,
+  sanitizeMcpToolSchema,
+  secretEnvOfMcpServer,
   selectBestIndex,
   selectChampion,
   selectValidWinner,

package/dist/mcp/bin.js

@@ -9,10 +9,10 @@ import {
   DelegationTaskQueue,
   FileDelegationStore,
   createMcpServer
-} from "../chunk-KVJQV342.js";
+} from "../chunk-6MR4IJRW.js";
 import "../chunk-DPEUKJRO.js";
 import "../chunk-2VZYRB55.js";
-import "../chunk-IKGCKPDX.js";
+import "../chunk-SQ3ZJH3Y.js";
 import "../chunk-IMSNJSXH.js";
 import "../chunk-M6MD6JBS.js";
 import "../chunk-3MDZX7YU.js";

package/dist/mcp/index.d.ts

@@ -1,19 +1,19 @@
-import { S as SandboxClient, a as LoopSandboxPlacement } from '../types-B3vAW0Oq.js';
-import { F as FleetHandle, D as DelegationExecutor, a as DelegationTaskQueue, b as FeedbackStore, c as DelegateFeedbackResult, d as DelegateFeedbackArgs, U as UiAuditorDelegate, e as DelegateUiAuditArgs, f as DelegateUiAuditResult, g as DelegationHistoryResult, h as DelegationHistoryArgs, i as DelegationStatusResult, j as DelegationStatusArgs } from '../coordination-BFE3Den7.js';
-export { A as AnalystRegistry, C as CappedDelegationTrace, k as CoderDelegate, l as CoderReview, m as CoderReviewer, n as CoordinationEvent, o as CoordinationTools, p as CoordinationToolsOptions, q as DELEGATE_DESCRIPTION, r as DELEGATE_INPUT_SCHEMA, s as DELEGATE_TOOL_NAME, t as DELEGATION_TRACE_MAX_BYTES, u as DELEGATION_TRACE_MAX_SPANS, v as DelegateArgs, w as DelegateCodeArgs, x as DelegateCodeConfig, y as DelegateCodeResult, z as DelegateHandlerOptions, B as DelegateResearchArgs, G as DelegateResearchConfig, H as DelegateResearchResult, I as DelegateResult, J as DelegateRunCtx, K as DelegateUiAuditConfig, L as DelegateUiAuditRoute, N as DelegationError, O as DelegationFeedbackSnapshot, P as DelegationHistoryEntry, Q as DelegationPersistenceError, R as DelegationProfile, S as DelegationProgress, T as DelegationRecord, V as DelegationResultPayload, W as DelegationResumeContext, X as DelegationResumeDriver, Y as DelegationResumeTick, Z as DelegationRunContext, _ as DelegationStateCorruptError, $ as DelegationStatus, a0 as DelegationStore, a1 as DelegationTaskQueueOptions, a2 as DelegationTraceCaps, a3 as DelegationTraceCollector, a4 as DelegationTraceSpan, a5 as DetachedSessionDelegateOptions, a6 as DetachedSessionRefParts, a7 as DetachedTurn, a8 as DetachedTurnResumeDriverOptions, a9 as DetachedWinnerSelection, aa as DriveTurnCapableBox, ab as DriveTurnTick, ac as FeedbackEvent, ad as FeedbackRating, ae as FeedbackRefersTo, af as FileDelegationStore, ag as FileDelegationStoreOptions, ah as FleetWorkspaceExecutorOptions, ai as InMemoryDelegationStore, aj as InMemoryFeedbackStore, ak as JsonRpcMessage, al as JsonRpcResponse, M as MakeWorkerAgent, am as McpServer, an as McpServerOptions, ao as McpToolDescriptor, ap as McpTransport, aq as Question, ar as QuestionDecision, as as QuestionPolicy, at as QuestionRecord, au as ResearchOutputShape, av as ResearchSource, aw as RunDetachedTurnOptions, ax as SettleDetachedCoderTurnOptions, ay as SettledWorker, az as SiblingSandboxExecutorOptions, aA as SubmitInput, aB as SubmitOutput, aC as TraceContext, aD as UiAuditorDelegationOutput, aE as buildDelegationTraceSpans, aF as capDelegationTrace, aG as coderTaskFromArgs, aH as composeLoopTraceEmitters, aI as createCoordinationTools, aJ as createDelegateHandler, aK as createDelegationTraceCollector, aL as createDetachedTurnResumeDriver, aM as createFleetWorkspaceExecutor, aN as createInProcessTransport, aO as createMcpServer, aP as createPropagatingTraceEmitter, aQ as createSiblingSandboxExecutor, aR as detachedSessionDelegate, aS as detachedTurnEvents, aT as eventToSnapshot, aU as formatDetachedSessionRef, aV as hashIdempotencyInput, aW as parseDetachedSessionRef, aX as readTraceContextFromEnv, aY as runDetachedTurn, aZ as settleDetachedCoderTurn, a_ as traceContextToEnv, a$ as validateDelegateArgs } from '../coordination-BFE3Den7.js';
-import { L as LocalHarness, r as runLocalHarness } from '../local-harness-ZqCx51u7.js';
-export { a as CodexExecutionEvidence, c as CodexExecutionPolicy, C as CodexTokenUsage, b as LocalHarnessResult, R as RunLocalHarnessOptions, p as parseCodexTokenUsage } from '../local-harness-ZqCx51u7.js';
-import { G as GitRunner } from '../completion-gate-C80jiRfN.js';
-export { C as CreateWorktreeOptions, b as DiffOptions, c as DiffResult, R as RemoveWorktreeOptions, d as WorktreeHandle, e as captureWorktreeDiff, f as createWorktree, r as removeWorktree } from '../completion-gate-C80jiRfN.js';
+import { S as SandboxClient, b as LoopSandboxPlacement } from '../types-CLat4bT9.js';
+import { F as FleetHandle, D as DelegationExecutor, a as DelegationTaskQueue, b as FeedbackStore, c as DelegateFeedbackResult, d as DelegateFeedbackArgs, U as UiAuditorDelegate, e as DelegateUiAuditArgs, f as DelegateUiAuditResult, g as DelegationHistoryResult, h as DelegationHistoryArgs, i as DelegationStatusResult, j as DelegationStatusArgs } from '../coordination-D9l_YmwW.js';
+export { A as AnalystRegistry, C as CappedDelegationTrace, k as CoderDelegate, l as CoderReview, m as CoderReviewer, n as CoordinationEvent, o as CoordinationTools, p as CoordinationToolsOptions, q as DELEGATE_DESCRIPTION, r as DELEGATE_INPUT_SCHEMA, s as DELEGATE_TOOL_NAME, t as DELEGATION_TRACE_MAX_BYTES, u as DELEGATION_TRACE_MAX_SPANS, v as DelegateArgs, w as DelegateCodeArgs, x as DelegateCodeConfig, y as DelegateCodeResult, z as DelegateHandlerOptions, B as DelegateResearchArgs, G as DelegateResearchConfig, H as DelegateResearchResult, I as DelegateResult, J as DelegateRunCtx, K as DelegateUiAuditConfig, L as DelegateUiAuditRoute, N as DelegationError, O as DelegationFeedbackSnapshot, P as DelegationHistoryEntry, Q as DelegationPersistenceError, R as DelegationProfile, S as DelegationProgress, T as DelegationRecord, V as DelegationResultPayload, W as DelegationResumeContext, X as DelegationResumeDriver, Y as DelegationResumeTick, Z as DelegationRunContext, _ as DelegationStateCorruptError, $ as DelegationStatus, a0 as DelegationStore, a1 as DelegationTaskQueueOptions, a2 as DelegationTraceCaps, a3 as DelegationTraceCollector, a4 as DelegationTraceSpan, a5 as DetachedSessionDelegateOptions, a6 as DetachedSessionRefParts, a7 as DetachedTurn, a8 as DetachedTurnResumeDriverOptions, a9 as DetachedWinnerSelection, aa as DriveTurnCapableBox, ab as DriveTurnTick, ac as FeedbackEvent, ad as FeedbackRating, ae as FeedbackRefersTo, af as FileDelegationStore, ag as FileDelegationStoreOptions, ah as FleetWorkspaceExecutorOptions, ai as InMemoryDelegationStore, aj as InMemoryFeedbackStore, ak as JsonRpcMessage, al as JsonRpcResponse, M as MakeWorkerAgent, am as McpServer, an as McpServerOptions, ao as McpToolDescriptor, ap as McpTransport, aq as Question, ar as QuestionDecision, as as QuestionPolicy, at as QuestionRecord, au as ResearchOutputShape, av as ResearchSource, aw as RunDetachedTurnOptions, ax as SettleDetachedCoderTurnOptions, ay as SettledWorker, az as SiblingSandboxExecutorOptions, aA as SubmitInput, aB as SubmitOutput, aC as TraceContext, aD as UiAuditorDelegationOutput, aE as buildDelegationTraceSpans, aF as capDelegationTrace, aG as coderTaskFromArgs, aH as composeLoopTraceEmitters, aI as createCoordinationTools, aJ as createDelegateHandler, aK as createDelegationTraceCollector, aL as createDetachedTurnResumeDriver, aM as createFleetWorkspaceExecutor, aN as createInProcessTransport, aO as createMcpServer, aP as createPropagatingTraceEmitter, aQ as createSiblingSandboxExecutor, aR as detachedSessionDelegate, aS as detachedTurnEvents, aT as eventToSnapshot, aU as formatDetachedSessionRef, aV as hashIdempotencyInput, aW as parseDetachedSessionRef, aX as readTraceContextFromEnv, aY as runDetachedTurn, aZ as settleDetachedCoderTurn, a_ as traceContextToEnv, a$ as validateDelegateArgs } from '../coordination-D9l_YmwW.js';
+import { L as LocalHarness, r as runLocalHarness } from '../local-harness-CtK9dSny.js';
+export { a as CodexExecutionEvidence, c as CodexExecutionPolicy, C as CodexTokenUsage, b as LocalHarnessResult, R as RunLocalHarnessOptions, p as parseCodexTokenUsage } from '../local-harness-CtK9dSny.js';
+import { G as GitRunner } from '../completion-gate-C6dhVN-N.js';
+export { C as CreateWorktreeOptions, b as DiffOptions, c as DiffResult, R as RemoveWorktreeOptions, d as WorktreeHandle, e as captureWorktreeDiff, f as createWorktree, r as removeWorktree } from '../completion-gate-C6dhVN-N.js';
 export { C as CreateKbGateOptions, F as FactCandidate, a as FactJudge, b as FactJudgeVerdict, K as KbGateResult, c as createKbGate } from '../kb-gate-CwHO0vz6.js';
+import { AgentProfileMcpServer } from '@tangle-network/agent-interface';
 export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from '../openai-tools-fnj6SRVg.js';
 import { AnalystFinding } from '@tangle-network/agent-eval';
-import { U as UiLens } from '../substrate-DO2GHNg2.js';
+import { a as UiLens } from '../substrate-Dyiqmd3o.js';
 import '@tangle-network/sandbox';
 import '../types-BwoZWq-i.js';
-import '../types-CmnA2iL3.js';
-import '@tangle-network/agent-interface';
-import '../sanitize-BTSsdBXw.js';
+import '../types-D870JlH0.js';
+import '../sanitize-DEbPNtyI.js';
 import '../environment-provider.js';
 import '@tangle-network/agent-interface/environment-provider';
 import 'node:child_process';
@@ -25,6 +25,7 @@ interface CodexExecutionFailureDiagnostic {
     exitCode: number | null;
     killedBySignal: NodeJS.Signals | null;
     timedOut: boolean;
+    aborted?: boolean;
     durationMs: number;
     stdout: string;
     stderr: string;
@@ -120,6 +121,177 @@ interface InProcessExecutorDescribePlacement extends LoopSandboxPlacement {
  */
 declare function createInProcessExecutor(options: InProcessExecutorOptions): DelegationExecutor;
 
+/**
+ * `createStdioToolServer` — the generic newline-delimited JSON-RPC 2.0 MCP
+ * server core: `initialize` / `notifications/initialized` / `tools/list` /
+ * `tools/call` over a stdio-shaped transport, protocol 2024-11-05.
+ *
+ * Extracted from `createMcpServer` (server.ts) so every in-repo MCP server —
+ * the delegation server, the memory server — serves the ONE wire protocol the
+ * same-host client (`connectStdioMcp`, runtime/stdio-mcp-client.ts) speaks.
+ * A second hand-rolled serve loop could drift from what the client expects;
+ * this core makes that impossible by construction.
+ *
+ * @experimental
+ */
+/** @experimental */
+interface McpToolDescriptor {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    handler: (raw: unknown) => Promise<unknown>;
+}
+/** @experimental */
+interface McpTransport {
+    input: NodeJS.ReadableStream;
+    output: NodeJS.WritableStream;
+}
+/** @experimental */
+interface JsonRpcMessage {
+    jsonrpc: '2.0';
+    id?: number | string | null;
+    method: string;
+    params?: unknown;
+}
+/** @experimental */
+interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: number | string | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/** @experimental */
+interface StdioToolServerOptions {
+    /** Server display name surfaced via `initialize`. */
+    serverName: string;
+    /** Server version surfaced via `initialize`. */
+    serverVersion: string;
+    /** The tools to serve. Duplicate names throw — a silent shadow would hide a tool. */
+    tools: readonly McpToolDescriptor[];
+}
+/** @experimental */
+interface StdioToolServer {
+    /** Tools currently registered, keyed by name. */
+    readonly tools: ReadonlyMap<string, McpToolDescriptor>;
+    /** Handle a single parsed JSON-RPC message. Returns the response object (or `null` for notifications). */
+    handle(message: JsonRpcMessage): Promise<JsonRpcResponse | null>;
+    /** Drive the server on a stdio-shaped transport until `stop()` is called. */
+    serve(transport?: McpTransport): Promise<void>;
+    /** Stop a `serve` call. Subsequent requests are rejected. */
+    stop(): void;
+}
+/** Build the generic stdio JSON-RPC tool server. */
+declare function createStdioToolServer(options: StdioToolServerOptions): StdioToolServer;
+
+/**
+ * Memory MCP server — the LIVE serving half of the `memory` profile surface
+ * (Phase 5). A curated memory (lessons distilled from prior runs) is only
+ * real if the DRIVEN agent can query it mid-task; this module serves a flat
+ * store of `MemoryItem` rows as `memory_search` / `memory_get` tools over the
+ * ONE in-repo stdio JSON-RPC core (`createStdioToolServer`), so the exact
+ * wire protocol the same-host client (`connectStdioMcp` /
+ * `materializeLocalMcp`, runtime/stdio-mcp-client.ts) speaks is guaranteed by
+ * construction — serve and consume cannot drift.
+ *
+ * Retrieval is DETERMINISTIC lexical overlap (no vectors, no LLM): a lift
+ * measured with this memory mounted is attributable to the lessons
+ * themselves, never to retrieval-model noise — the same discipline as
+ * agent-eval's `memoryCurationProposer` (deterministic curation). Every
+ * `memory_search` can append one JSONL row to a retrieval log (`logPath`) —
+ * the per-query record an off-policy retrieval estimator (agent-knowledge's
+ * `RetrievalHoldout`) consumes. agent-knowledge is NOT a dependency of this
+ * repo, so the log file is the flagged cross-package seam, not an import.
+ *
+ * Fail-loud discipline (mirrors `materializeLocalMcp`): an EMPTY memory is
+ * never served — a profile without memory simply omits the artifact, and
+ * silently serving zero rows would fake the with/without ablation.
+ *
+ * @experimental
+ */
+
+/** One row of agent memory: a crisp lesson/fact with provenance. */
+interface MemoryItem {
+    /** Stable id (content-hash by convention; see `memoryArtifactFromLessons`). */
+    id: string;
+    /** The lesson itself — one imperative or observation the agent should recall. */
+    text: string;
+    /** Optional retrieval tags, matched by `memory_search` alongside the text. */
+    tags?: string[];
+    /** Provenance: the finding / trace / curation pass this row came from. */
+    source?: string;
+}
+/**
+ * The `memory` artifact payload — HOW a profile's memory is stored and served:
+ *
+ *   - `store: 'file'` — served by the in-repo memory bin
+ *     (`agent-runtime-memory-mcp`, src/mcp/memory-bin.ts): rows load from
+ *     `path` (a JSON array or JSONL file of `MemoryItem`) and/or the inline
+ *     `items` seed (inline wins on id collision). At least one of
+ *     `path`/`items` is required.
+ *   - `store: 'mcp'`  — an EXTERNAL, already-runnable MCP server that exposes
+ *     the memory tools itself; `server` is required and mounts verbatim.
+ *
+ * `logPath` makes the served memory append one JSONL row per `memory_search`
+ * — the retrieval log a holdout estimator reads (see module doc).
+ */
+interface AgentMemorySpec {
+    store: 'file' | 'mcp';
+    /** `store:'file'` — host path to the durable row store (JSON array or JSONL). */
+    path?: string;
+    /** Inline seed rows, served alongside (and winning over) `path` rows. */
+    items?: MemoryItem[];
+    /** `store:'mcp'` — the external server that already serves memory tools. */
+    server?: AgentProfileMcpServer;
+    /** JSONL retrieval log: one row per `memory_search` (ts, query, k, returned). */
+    logPath?: string;
+}
+/** Env var naming the durable row store file the memory bin loads (the
+ *  `memoryMcpServer` ↔ memory-bin contract). */
+declare const MEMORY_FILE_ENV = "AGENT_MEMORY_FILE";
+/** Env var carrying inline JSON `MemoryItem` rows (win over file rows on id). */
+declare const MEMORY_ITEMS_ENV = "AGENT_MEMORY_ITEMS";
+/** Env var naming the JSONL retrieval log (one row per `memory_search`). */
+declare const MEMORY_LOG_ENV = "AGENT_MEMORY_LOG";
+/** Env var overriding the served display name (default 'agent-memory'). */
+declare const MEMORY_NAME_ENV = "AGENT_MEMORY_NAME";
+interface CreateMemoryToolServerOptions {
+    /** The rows to serve. MUST be non-empty (an empty memory is never served). */
+    items: readonly MemoryItem[];
+    /** Server display name surfaced via `initialize`. Default 'agent-memory'. */
+    serverName?: string;
+    /** Server version surfaced via `initialize`. Default '0'. */
+    serverVersion?: string;
+    /** Default result count for `memory_search`. Default 5. */
+    defaultK?: number;
+    /** Append one JSONL row per `memory_search` (the retrieval-holdout seam). */
+    logPath?: string;
+}
+/**
+ * Build the memory MCP server: `memory_search` (lexical top-k over the rows)
+ * and `memory_get` (one row by id) on the generic stdio JSON-RPC core.
+ */
+declare function createMemoryToolServer(opts: CreateMemoryToolServerOptions): StdioToolServer;
+/** Coerce an untrusted JSON array into validated `MemoryItem` rows. */
+declare function parseMemoryItems(value: unknown, source: string): MemoryItem[];
+/** Read a memory store file: a JSON array, or JSONL (one `MemoryItem` per line). */
+declare function readMemoryItemsFile(path: string): MemoryItem[];
+/** What the memory bin resolved from its environment. */
+interface ResolvedMemoryEnv {
+    items: MemoryItem[];
+    serverName?: string;
+    logPath?: string;
+}
+/**
+ * Resolve the bin's memory from `AGENT_MEMORY_FILE` (durable store) and/or
+ * `AGENT_MEMORY_ITEMS` (inline JSON rows; wins on id collision). Zero rows is
+ * a boot FAILURE, matching the fail-closed materialization discipline.
+ */
+declare function resolveMemoryFromEnv(env: Record<string, string | undefined>): ResolvedMemoryEnv;
+
 /**
  *
  * The trace-analyst KIND directory — the operator's lenses, as composable DATA.
@@ -457,4 +629,4 @@ interface DelegationStatusHandlerOptions {
 /** Build the MCP tool handler that polls a `DelegationTaskQueue` for task status. @experimental */
 declare function createDelegationStatusHandler(options: DelegationStatusHandlerOptions): (raw: unknown) => Promise<DelegationStatusResult>;
 
-export { type Check, type CheckRunnerOptions, CodexExecutionDiagnosticError, type CodexExecutionFailureDiagnostic, DELEGATE_FEEDBACK_DESCRIPTION, DELEGATE_FEEDBACK_INPUT_SCHEMA, DELEGATE_FEEDBACK_TOOL_NAME, DELEGATE_UI_AUDIT_DESCRIPTION, DELEGATE_UI_AUDIT_INPUT_SCHEMA, DELEGATE_UI_AUDIT_TOOL_NAME, DELEGATION_HISTORY_DESCRIPTION, DELEGATION_HISTORY_INPUT_SCHEMA, DELEGATION_HISTORY_TOOL_NAME, DELEGATION_STATUS_DESCRIPTION, DELEGATION_STATUS_INPUT_SCHEMA, DELEGATION_STATUS_TOOL_NAME, DelegateFeedbackArgs, DelegateFeedbackResult, DelegateUiAuditArgs, DelegateUiAuditResult, DelegationExecutor, DelegationHistoryArgs, DelegationHistoryResult, DelegationStatusArgs, DelegationStatusResult, DelegationTaskQueue, type DetectExecutorArgs, FeedbackStore, FleetHandle, GitRunner, type InProcessExecutorDescribePlacement, type InProcessExecutorOptions, LocalHarness, UiAuditorDelegate, createDelegateFeedbackHandler, createDelegateUiAuditHandler, createDelegationHistoryHandler, createDelegationStatusHandler, createInProcessExecutor, defaultChecks, detectExecutor, liftFindings, makeCheckRunner, renderTrace, runCheck, runLocalHarness, validateDelegateFeedbackArgs, validateDelegateUiAuditArgs, validateDelegationHistoryArgs, validateDelegationStatusArgs };
+export { type AgentMemorySpec, type Check, type CheckRunnerOptions, CodexExecutionDiagnosticError, type CodexExecutionFailureDiagnostic, type CreateMemoryToolServerOptions, DELEGATE_FEEDBACK_DESCRIPTION, DELEGATE_FEEDBACK_INPUT_SCHEMA, DELEGATE_FEEDBACK_TOOL_NAME, DELEGATE_UI_AUDIT_DESCRIPTION, DELEGATE_UI_AUDIT_INPUT_SCHEMA, DELEGATE_UI_AUDIT_TOOL_NAME, DELEGATION_HISTORY_DESCRIPTION, DELEGATION_HISTORY_INPUT_SCHEMA, DELEGATION_HISTORY_TOOL_NAME, DELEGATION_STATUS_DESCRIPTION, DELEGATION_STATUS_INPUT_SCHEMA, DELEGATION_STATUS_TOOL_NAME, DelegateFeedbackArgs, DelegateFeedbackResult, DelegateUiAuditArgs, DelegateUiAuditResult, DelegationExecutor, DelegationHistoryArgs, DelegationHistoryResult, DelegationStatusArgs, DelegationStatusResult, DelegationTaskQueue, type DetectExecutorArgs, FeedbackStore, FleetHandle, GitRunner, type InProcessExecutorDescribePlacement, type InProcessExecutorOptions, LocalHarness, MEMORY_FILE_ENV, MEMORY_ITEMS_ENV, MEMORY_LOG_ENV, MEMORY_NAME_ENV, type MemoryItem, type ResolvedMemoryEnv, type McpToolDescriptor as StdioToolDescriptor, type StdioToolServer, type StdioToolServerOptions, UiAuditorDelegate, createDelegateFeedbackHandler, createDelegateUiAuditHandler, createDelegationHistoryHandler, createDelegationStatusHandler, createInProcessExecutor, createMemoryToolServer, createStdioToolServer, defaultChecks, detectExecutor, liftFindings, makeCheckRunner, parseMemoryItems, readMemoryItemsFile, renderTrace, resolveMemoryFromEnv, runCheck, runLocalHarness, validateDelegateFeedbackArgs, validateDelegateUiAuditArgs, validateDelegationHistoryArgs, validateDelegationStatusArgs };

package/dist/mcp/index.js

@@ -6,10 +6,21 @@ import {
   readTraceContextFromEnv,
   traceContextToEnv
 } from "../chunk-AYU35OTU.js";
+import {
+  MEMORY_FILE_ENV,
+  MEMORY_ITEMS_ENV,
+  MEMORY_LOG_ENV,
+  MEMORY_NAME_ENV,
+  createMemoryToolServer,
+  createStdioToolServer,
+  parseMemoryItems,
+  readMemoryItemsFile,
+  resolveMemoryFromEnv
+} from "../chunk-L5DST3QC.js";
 import {
   mcpToolsForRuntimeMcp,
   mcpToolsForRuntimeMcpSubset
-} from "../chunk-KSBUSEUA.js";
+} from "../chunk-KJ2Q4T7F.js";
 import {
   createKbGate
 } from "../chunk-SGKPNBXE.js";
@@ -17,7 +28,7 @@ import {
   assertTraceDerivedFindings,
   runCoderChecks,
   selectValidWinner
-} from "../chunk-MAONWP4R.js";
+} from "../chunk-KPHTCHQ4.js";
 import "../chunk-Q2JSAVQ3.js";
 import {
   DELEGATE_DESCRIPTION,
@@ -45,7 +56,6 @@ import {
   InMemoryFeedbackStore,
   buildDelegationTraceSpans,
   capDelegationTrace,
-  captureWorktreeDiff,
   composeLoopTraceEmitters,
   createCoordinationTools,
   createDelegateFeedbackHandler,
@@ -57,25 +67,28 @@ import {
   createInProcessTransport,
   createMcpServer,
   createSandboxForSpec,
-  createWorktree,
   eventToSnapshot,
   hashIdempotencyInput,
-  removeWorktree,
   runLoop,
-  runWorktreeHarness,
   validateDelegateArgs,
   validateDelegateFeedbackArgs,
   validateDelegateUiAuditArgs,
   validateDelegationHistoryArgs,
   validateDelegationStatusArgs
-} from "../chunk-KVJQV342.js";
+} from "../chunk-6MR4IJRW.js";
 import "../chunk-DPEUKJRO.js";
+import "../chunk-ROILMKDL.js";
+import "../chunk-UPWGXKXB.js";
 import "../chunk-2VZYRB55.js";
 import {
   CodexExecutionDiagnosticError,
+  captureWorktreeDiff,
+  createWorktree,
   parseCodexTokenUsage,
-  runLocalHarness
-} from "../chunk-IKGCKPDX.js";
+  removeWorktree,
+  runLocalHarness,
+  runWorktreeHarness
+} from "../chunk-SQ3ZJH3Y.js";
 import "../chunk-IMSNJSXH.js";
 import "../chunk-M6MD6JBS.js";
 import {
@@ -1208,6 +1221,10 @@ export {
   FileDelegationStore,
   InMemoryDelegationStore,
   InMemoryFeedbackStore,
+  MEMORY_FILE_ENV,
+  MEMORY_ITEMS_ENV,
+  MEMORY_LOG_ENV,
+  MEMORY_NAME_ENV,
   buildDelegationTraceSpans,
   capDelegationTrace,
   captureWorktreeDiff,
@@ -1226,8 +1243,10 @@ export {
   createInProcessTransport,
   createKbGate,
   createMcpServer,
+  createMemoryToolServer,
   createPropagatingTraceEmitter,
   createSiblingSandboxExecutor,
+  createStdioToolServer,
   createWorktree,
   defaultChecks,
   detachedSessionDelegate,
@@ -1242,9 +1261,12 @@ export {
   mcpToolsForRuntimeMcpSubset,
   parseCodexTokenUsage,
   parseDetachedSessionRef,
+  parseMemoryItems,
+  readMemoryItemsFile,
   readTraceContextFromEnv,
   removeWorktree,
   renderTrace,
+  resolveMemoryFromEnv,
   runCheck,
   runDetachedTurn,
   runLocalHarness,