@sema-agent/core 2.0.0 → 2.1.0

package/dist/core/runner/prepare-memory.js

@@ -178,6 +178,7 @@ export async function prepareMemory(input) {
         }
     }
     let memoryBlock;
+    let seedFiles;
     if (memorySpec && memorySpec.enabled && !useMemoryEngine) {
         const detail = "TaskSpec.memory is enabled but RunnerDeps.memoryBackend is not configured; memory is inactive for this task (the legacy memoryStore fallback was retired in design/138 S4 and the dep was removed in design/157 B19).";
         deps.onError?.(new Error(detail), { phase: "config", sessionId });
@@ -186,6 +187,8 @@ export async function prepareMemory(input) {
         const injection = memoryEngineSession.inject();
         if (injection.block.trim())
             memoryBlock = injection.block;
+        if (memoryBlock !== undefined && injection.indexSeed !== undefined)
+            seedFiles = [injection.indexSeed];
     }
-    return { memoryEngineSession, memoryBlock };
+    return { memoryEngineSession, memoryBlock, ...(seedFiles !== undefined ? { seedFiles } : {}) };
 }

package/dist/core/runner/prepare-task.d.ts

@@ -4,7 +4,7 @@ import { type MaterializedMcp } from "../mcp.js";
 import type { HarvestReport, MemorySessionHandle } from "../memory-engine/types.js";
 import { StoredSession } from "../session.js";
 import type { SessionStore } from "../session.js";
-import { SubagentRetainLedger } from "../../agents/subagent.js";
+import { SubagentRetainLedger } from "../../agents/retain-ledger.js";
 import type { OnAsk, ToolPolicy } from "../tool-policy.js";
 import { type ActiveSkillFrame } from "./active-skill-scope.js";
 import { type CutKillRegistry } from "./cut-kill.js";
@@ -207,6 +207,12 @@ export interface Prepared {
     }>;
     toolsDeltaRef?: {
         pending: string[];
+        pendingRemoved: string[];
+        pendingReadded: string[];
+        pendingFailed: Array<{
+            name: string;
+            error?: string;
+        }>;
     };
     agentListing?: {
         entries: ReadonlyArray<{
@@ -311,7 +317,7 @@ export interface RunInternals {
     parentNotify?: (notification: TaskNotificationPayload, opts?: {
         priority?: import("../task-notification.js").SystemInjectionPriority;
     }) => void;
-    parentRetainLedger?: import("../../agents/subagent.js").SubagentRetainLedger;
+    parentRetainLedger?: import("../../agents/retain-ledger.js").SubagentRetainLedger;
     onNotifyInjectorReady?: (inject: (notification: TaskNotificationPayload, opts?: {
         priority?: import("../task-notification.js").SystemInjectionPriority;
     }) => Promise<"queued" | "parked" | "dropped_duplicate">) => void;

package/dist/core/runner/prepare-task.js

@@ -12,12 +12,16 @@ import { materializeMcpTools } from "../mcp.js";
 import { Type } from "typebox";
 import { brainToRuntime } from "../runtime.js";
 import { StoredSession, isSessionConflict, hasSessionFork } from "../session.js";
-import { createAgentTranscriptTool, createSendMessageTool, createSubagentWorktreeHelper, forkGovernanceDenial, AGENT_TRANSCRIPT_TOOL_NAME, SEND_MESSAGE_TOOL_NAME, SubagentRetainLedger } from "../../agents/subagent.js";
+import { createSubagentWorktreeHelper, forkGovernanceDenial } from "../../agents/subagent.js";
+import { createAgentTranscriptTool, AGENT_TRANSCRIPT_TOOL_NAME } from "../../agents/agent-transcript-tool.js";
+import { createSendMessageTool, SEND_MESSAGE_TOOL_NAME } from "../../agents/send-message-tool.js";
+import { SubagentRetainLedger } from "../../agents/retain-ledger.js";
 import { combinePolicies, createTranscriptIntegrityPolicy, createUnverifiableDeletePolicy, resolveAsk, toolPolicyNameSets } from "../tool-policy.js";
 import { ActiveSkillScope, createActiveSkillScopePolicy } from "./active-skill-scope.js";
 import { computeCallCap, createCallCapRef, softExecDeadlineMs, toolCutDeadlineMs, WALLTIME_STALL_CONNECT_MS, WALLTIME_STALL_FIRST_TOKEN_MS, WALLTIME_STALL_IDLE_MS } from "./call-cap.js";
 import { createCutKillRegistry } from "./cut-kill.js";
-import { CHANGED_FILES_MTIME_EPS_MS, renderAgentListingDelta } from "./turn-attachments.js";
+import { CHANGED_FILES_MTIME_EPS_MS, fenceMcpServerInstructions, renderAgentListingDelta } from "./turn-attachments.js";
+import { inlineUntrusted } from "../untrusted-text.js";
 import { emitTrace } from "../trace.js";
 import { createSessionRulePolicy } from "./session-rule-policy.js";
 import { cloneObserverInput, formatHookFeedback, runToolGate } from "../hooks.js";
@@ -27,7 +31,7 @@ import { reservedCollisions, reservedFor } from "../../brain/request-params.js";
 import { defineTool } from "../tools.js";
 import { canonicalToolName } from "../tool-name-aliases.js";
 import { pathToUri } from "../lsp-protocol.js";
-import { DEFAULT_TOOL_RESULT_THRESHOLD_CHARS, firstPartyOffloadPolicy, InMemoryToolResultStore, RunnerSharedToolResultStore, ScopedToolResultStore, isVolatileOffloadStore, OFFLOAD_TOOL_NAME, createReadToolResultTool, withToolResultOffload, } from "../tool-result-store.js";
+import { DEFAULT_TOOL_RESULT_THRESHOLD_CHARS, buildToolResultRef, firstPartyOffloadPolicy, InMemoryToolResultStore, RunnerSharedToolResultStore, ScopedToolResultStore, isVolatileOffloadStore, OFFLOAD_TOOL_NAME, createReadToolResultTool, withToolResultOffload, } from "../tool-result-store.js";
 import { OUTPUT_TOOL_NAME, REPORT_FINDINGS_TOOL_NAME, SKILL_CONTENT_MAX_CHARS, SKILL_TOOL_NAME, createOutputTool, createReportBlockedTool, createReportFindingsTool, createSkillTool, normalizeSkills } from "./synthetic-tools.js";
 import { compileOutputSchema } from "./strict-output-schema.js";
 import { TOOL_SEARCH_NAME, buildDeferredRegistry, classifyDeferred, extractDiscoveredToolNames, createPlaceholderTool, createToolSearchTool, } from "./tool-disclosure.js";
@@ -1362,8 +1366,16 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
                     .catch(() => undefined);
             }
             : undefined;
-        const { memoryEngineSession, memoryBlock: memoryBlockFromEngine } = await prepareMemory({ spec, deps, sessionId, taskRootPath, memoryWriteGateRef });
+        const { memoryEngineSession, memoryBlock: memoryBlockFromEngine, seedFiles: memorySeedFiles } = await prepareMemory({ spec, deps, sessionId, taskRootPath, memoryWriteGateRef });
         let memoryBlock = memoryBlockFromEngine;
+        if (memorySeedFiles?.length && seedContextFiles) {
+            try {
+                await seedContextFiles(memorySeedFiles);
+            }
+            catch (err) {
+                deps.onError?.(err instanceof Error ? err : new Error(String(err)), { phase: "config", sessionId });
+            }
+        }
         let instructionSources;
         if (deps.loadProjectMemory) {
             let projectMemoryPhase = spec.sessionId ? "resume" : "fresh";
@@ -1478,7 +1490,7 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
         const userSystemPrompt = spec.systemPrompt ?? resolvedRole.systemPrompt ?? internals?.defaultSystemPrompt;
         const userAppendSystemPrompt = spec.appendSystemPrompt;
         const mcpInstructionsBlock = mcp.serverInstructions.length
-            ? `# MCP Server Instructions\n${mcp.serverInstructions.map((s) => `## ${s.server}\n${s.text}`).join("\n\n")}`
+            ? `# MCP Server Instructions\n${mcp.serverInstructions.map((s) => fenceMcpServerInstructions(s.server, s.text)).join("\n\n")}`
             : undefined;
         const userTz = spec.clientContext?.timeZone;
         const tzValid = userTz !== undefined && isValidTimeZone(userTz);
@@ -1760,7 +1772,13 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
         }
         const turnSnapshotRef = {};
         let harnessTools = tools;
+        const failedMcpServers = mcp.statuses
+            .filter((s) => s.status === "failed")
+            .map((s) => ({ name: inlineUntrusted(s.name, 160), ...(s.error !== undefined ? { error: inlineUntrusted(s.error, 240) } : {}) }));
         let toolsDeltaRef;
+        if (deferred.size > 0 || failedMcpServers.length > 0) {
+            toolsDeltaRef = { pending: [], pendingRemoved: [], pendingReadded: [], pendingFailed: failedMcpServers };
+        }
         const listingRideRef = {};
         if (deferred.size > 0) {
             if (deferred.has(TOOL_SEARCH_NAME) || tools.some((t) => t.name === TOOL_SEARCH_NAME)) {
@@ -1787,7 +1805,7 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
                 return list;
             };
             const announcedTools = new Set(activeTools);
-            toolsDeltaRef = { pending: [] };
+            const withdrawnTools = new Set();
             const deltaRef = toolsDeltaRef;
             const rematerialize = async (active) => {
                 const list = buildToolList(active);
@@ -1795,10 +1813,23 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
                 if (fpRef.current)
                     fpRef.current.tools = toolsToFingerprintInputs(list);
                 turnSnapshotRef.current?.refreshTools(toolsToFingerprintInputs(list));
+                const live = new Set(list.map((t) => t.name));
+                for (const n of [...announcedTools]) {
+                    if (!live.has(n)) {
+                        announcedTools.delete(n);
+                        withdrawnTools.add(n);
+                        deltaRef.pendingRemoved.push(n);
+                    }
+                }
                 for (const n of active) {
+                    if (!live.has(n))
+                        continue;
                     if (!announcedTools.has(n)) {
                         announcedTools.add(n);
-                        deltaRef.pending.push(n);
+                        if (withdrawnTools.delete(n))
+                            deltaRef.pendingReadded.push(n);
+                        else
+                            deltaRef.pending.push(n);
                     }
                 }
             };
@@ -3035,7 +3066,7 @@ export async function prepareTask(spec, deps, sessions, resume, internals, runne
                     ? {
                         offload: {
                             persist: (toolCallId, fullText) => {
-                                const ref = `tr_${sessionId}_${toolCallId}`;
+                                const ref = buildToolResultRef(sessionId, toolCallId);
                                 void offloadStore.put(ref, fullText);
                                 return ref;
                             },