@sema-agent/core 5.16.0 → 5.17.0-pre.0

package/dist/core/task-registry-agent.d.ts

@@ -120,7 +120,7 @@ export declare function deliverToRunningAgentLane(core: DurableAgentCore, id: st
     disposition: "queued" | "parked" | "pending";
 } | {
     ok: false;
-    reason: "not_found" | "not_running" | "no_channel";
+    reason: "not_found" | "not_running" | "no_channel" | "queue_full";
 }>;
 export declare function runningBackgroundAgentLabelsLane(core: DurableAgentCore, access: TaskAccess): string[];
 export declare function runningAgentFooterLane(core: DurableAgentCore, access: TaskAccess): {

package/dist/core/task-registry-agent.js

@@ -1102,7 +1102,7 @@ export async function deliverToRunningAgentLane(core, id, access, notification,
             return { ok: false, reason: "no_channel" };
         const q = (handle.preAttachQueue ??= []);
         if (q.length >= 8)
-            return { ok: false, reason: "no_channel" };
+            return { ok: false, reason: "queue_full" };
         return bounded(new Promise((resolve) => {
             q.push([notification, opts, resolve]);
         }), { ok: true, disposition: "pending" });

package/dist/core/task-registry.d.ts

@@ -195,7 +195,7 @@ export declare class TaskRegistry {
         disposition: "queued" | "parked" | "pending";
     } | {
         ok: false;
-        reason: "not_found" | "not_running" | "no_channel";
+        reason: "not_found" | "not_running" | "no_channel" | "queue_full";
     }>;
     runningBackgroundAgentLabels(access: TaskAccess): string[];
     private pollBackgroundAgent;

package/dist/core/task-registry.js

@@ -957,6 +957,8 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
         for (const [id, handle] of this.handles) {
             if (handle.status === "running" || handle.status === "pending")
                 continue;
+            if (this.claimingHandles.has(id) || this.reapingHandles.has(id))
+                continue;
             if (now - handle.updatedAt < terminalTtlMs)
                 continue;
             this.handles.delete(id);

package/dist/core/types.d.ts

@@ -90,8 +90,13 @@ export interface ToolExecuteContext {
             outcome: import("./checkpoint-store.js").ResumeOutcome;
             inheritedGate?: import("./runner/prepare-task.js").InheritedGate;
         };
+        peerSeed?: {
+            hopChain: string[];
+        };
     };
     spawnedAgentName?: string;
+    peerSelfRef?: import("../agents/peer-admission.js").PeerSelfRef;
+    peerInboundChainRef?: import("../agents/peer-admission.js").PeerInboundChainRef;
     roster?: import("../agents/roster-store.js").RosterStore;
     hostSessionFork?: () => Promise<{
         sessionId: string;
@@ -792,6 +797,7 @@ export interface RunnerDeps {
     workflowRunStore?: import("./workflow-run-store.js").WorkflowRunStore;
     backgroundAgentStore?: import("./background-agent-store.js").BackgroundAgentStore;
     mailboxStore?: import("./mailbox-store.js").MailboxStore;
+    peerAdmission?: Partial<import("../agents/peer-admission.js").PeerAdmissionConfig>;
     usageWindows?: readonly import("./usage-window-store.js").UsageWindow[];
     usageWindowStore?: import("./usage-window-store.js").UsageWindowStore;
     workflowJournalStore?: import("./workflow-journal-store.js").WorkflowJournalStore;
@@ -802,6 +808,7 @@ export interface RunnerDeps {
     brainCallGuardrailMs?: import("../brain/timeout.js").BrainCallGuardrailKnob;
     now?: () => number;
     memoryBackend?: import("./memory-engine/types.js").MemoryBackend;
+    sharedMemoryStores?: import("./shared-memory/types.js").SharedMemoryStoreProvider;
     memoryEngineDir?: string;
     onMemoryHarvestReport?: (report: import("./memory-engine/types.js").HarvestReport, info: {
         sessionId: string;

package/dist/core/untrusted-text.d.ts

@@ -23,5 +23,6 @@ export declare function cutEngineSegments(text: string, segments: unknown): {
 };
 export declare function flattenableUserText(content: unknown): string | undefined;
 export declare function defuseFenceMarkers(body: string): string;
+export declare function defuseControlChars(text: string): string;
 export declare function inlineUntrusted(text: string, maxLen?: number): string;
 export declare function delimitUntrusted(label: string, text: string, maxBody?: number): string;

package/dist/core/untrusted-text.js

@@ -87,6 +87,16 @@ export function flattenableUserText(content) {
 export function defuseFenceMarkers(body) {
     return body.replace(/<{3,}|>{3,}/g, (run) => run.match(/.{1,2}/g).join(ZWSP));
 }
+const REPLACEMENT = "�";
+export function defuseControlChars(text) {
+    let out = "";
+    for (const ch of text.replace(/\r\n?/g, "\n")) {
+        const cp = ch.codePointAt(0) ?? 0;
+        const control = cp !== 9 && cp !== 10 && (cp < 32 || (cp >= 127 && cp <= 159));
+        out += control ? REPLACEMENT : ch;
+    }
+    return out;
+}
 const LABEL_MAX = 160;
 export function inlineUntrusted(text, maxLen = LABEL_MAX) {
     const oneLine = text.replace(/[\s\u0000-\u001f\u007f\u0085]+/g, " ").trim();

package/dist/engine/harness/agent-harness.d.ts

@@ -36,6 +36,7 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
     private model;
     private thinkingLevel;
     onUndrainedEngineNotes?: (payloads: unknown[]) => void;
+    onEngineNoteConsumed?: (payload: unknown) => void;
     recoverUndrainedEngineNotes(): void;
     private sweepUndrainedEngineNotes;
     private systemPrompt;

package/dist/engine/harness/agent-harness.js

@@ -158,6 +158,7 @@ export class AgentHarness {
     model;
     thinkingLevel;
     onUndrainedEngineNotes;
+    onEngineNoteConsumed;
     recoverUndrainedEngineNotes() {
         this.sweepUndrainedEngineNotes([this.nextTurnQueue, this.steerQueue, this.followUpQueue]);
     }
@@ -438,8 +439,17 @@ export class AgentHarness {
         }
         try {
             await this.emitQueueUpdate();
-            for (const m of messages)
+            for (const m of messages) {
+                const payload = engineNotePayloads.get(m);
+                if (payload !== undefined) {
+                    try {
+                        this.onEngineNoteConsumed?.(payload);
+                    }
+                    catch {
+                    }
+                }
                 engineNotePayloads.delete(m);
+            }
             return messages;
         }
         catch (error) {
@@ -648,8 +658,17 @@ export class AgentHarness {
                 this.nextTurnQueue.unshift(...queuedMessages);
                 throw normalizeHookError(error);
             }
-            for (const m of queuedMessages)
+            for (const m of queuedMessages) {
+                const payload = engineNotePayloads.get(m);
+                if (payload !== undefined) {
+                    try {
+                        this.onEngineNoteConsumed?.(payload);
+                    }
+                    catch {
+                    }
+                }
                 engineNotePayloads.delete(m);
+            }
             messages = [...queuedMessages, messages[0]];
         }
         const beforeResult = await this.emitHook({

package/dist/index.d.ts

@@ -129,6 +129,8 @@ export { createPermissionRulePolicy, validatePermissionRules, parsePermissionRul
 export { formatHookFeedback, runToolGate, createHookEnvCapabilities, type Hooks, type HookToolContext, type HookEnvCapabilities, type HookToolOutput, type PreToolUseResult, type PostToolUseResult, type UserPromptSubmitResult, type HookToolFailure, type PostToolUseFailureResult, type PostToolBatchCall, type PostToolBatchResult, type PreCompactContext, type PreCompactResult, type PostCompactContext, type StopFailureContext, type PermissionDeniedPayload, type PermissionDeniedSource, } from "./core/hooks.js";
 export { InMemoryMemoryStore, composeMemoryBlock, composeLayeredMemoryBlock, normalizeMemorySpec, type NormalizedMemorySpec, type MemorySpecInput, supportsConsolidation, supportsPeriodicConsolidation, firstSentence, expandLexicalTerms, lexicalSearchMatch, type Embedder, classifyPromotable, enforcePromotableWriteGate, guardedMemoryStore, MemoryGateError, detectSecret, enforceSecretWriteGate, enforceStructuredNoteSecretGate, type UtilityGate, type MemoryStore, type MemoryVectorMode, type ScoredMemory, type MemoryNoteHeader, type MemoryNoteRecord, type MemoryNoteType, type StructuredNoteInput, } from "./core/memory.js";
 export { MemoryEngine, FileMemoryEngineBackend, memoryBackendContract, assertMemoryBackendSearchEquivalence, type MemoryBackendContractHooks, buildMemoryInstruction, truncateIndex, scanEntryFiles, deriveRepoKey, deriveRepoMemoryDir, deriveControlPlaneDir, deriveRepoControlPlaneDir, resolveMemoryEngineRoot, scopeDirName, ControlPlaneCorruptError, parseEntryFile, serializeEntryFile, computeEntryRev, entryFromFile, MEMORY_INSTRUCTION_TEMPLATE, MEMORY_INDEX_FILENAME, MEMORY_INDEX_MAX_LINES, MEMORY_INDEX_MAX_BYTES, STUB_ARCHIVED_LINE, DEFAULT_MAX_MEMORY_FILES, DEFAULT_MAX_ENTRY_DEPTH, DEFAULT_HARVEST_DEADLINE_MS, DEFAULT_HARVEST_FILE_BUDGET, MASS_DELETION_FUSE_RATIO, scanMemoryWrite, scanMemoryFileName, scanRemediation, MEMORY_FILENAME_SEGMENT_RE, renderAnnouncements, enqueueMemoryAnnouncement, drainMemoryAnnouncements, peekMemoryAnnouncements, bumpScanFuse, scanFuseCount, clearScanFuse, ANNOUNCEMENTS_FILE, MEMORY_ANNOUNCEMENTS_MAX, SCAN_FUSE_FILE, SCAN_FUSE_THRESHOLD, type MemoryAnnouncement, type ScanFinding, type MemoryEngineOptions, type MemoryInjection, type MemoryBackend, type MemoryEntry, type MemoryEntryFrontmatter, type MemoryEntryHeader, type ScoredMemoryEntry, type NotePatch, type PatchReport, type MaterializedFile, type MemorySessionHandle, type HarvestReport, type HarvestRejection, type HarvestRejectionCode, type ParsedEntryFile, type ScannedEntryFile, SCOPE_SEGMENT_MAX_ENCODED, PROJECT_MARKER_PATH, encodeScopeSegment, decodeScopeSegment, parseScopeKey, formatUserScope, formatOrgScope, formatProjScope, formatUserProjScope, isPersonalScope, assertScopeContractPlacement, formatProjectMarker, parseProjectMarker, resolveProjectId, PROJECT_ID_REGEX, type ParsedScopeKey, migrateScope, type MigrateScopeReport, materializeEntriesToFiles, harvestFilesToPatches, projectionsToWriteBack, screenInboundEntries, REMOTE_HARVEST_PER_FILE_BYTES, REMOTE_MASS_DELETION_FUSE_RATIO, type RemoteMemoryFile, type RemoteMemoryBaseline, type RemoteMaterialization, type RemoteHarvestResult, type InboundEntryFinding, deriveProjectMemoryDir, deriveProjectControlDir, recordProjectIdHint, lookupProjectIdHint, PROJECT_ID_HINTS_FILE, reconcileMemoryEntries, nextSyncBaseline, mergeRecallHits, type MemorySyncCursor, type MemorySyncConflict, type MemorySyncPlan, type RecallSource, syncMemoryScope, type MemorySyncTransport, type MemorySyncRequestBody, type MemorySyncResponseBody, type MemorySyncClientConflict, type SyncMemoryScopeOptions, type MemorySyncClientResult, } from "./core/memory-engine/index.js";
+export { SHARED_MEMORY_READ_CAP_BYTES, SHARED_MEMORY_LIST_PAGE_SIZE, SharedMemoryStoreError, type SharedMemoryStoreProvider, type SharedMemoryStoreReader, type SharedMemoryStoreInfo, type SharedMemoryDocumentEntry, type SharedMemorySnapshot, type SharedMemoryRequestContext, type MemoryListDetails, type MemoryReadDetails, } from "./core/shared-memory/types.js";
+export { sharedMemoryStoreContract, type SharedMemoryFixture, type SharedMemoryStoreContractHooks, } from "./core/shared-memory/contract.js";
 export { termSet, jaccardDistance, cosineDistance } from "./core/memory-vector.js";
 export { encodeSurfacedKey, buildManifestText, validateSelectedIds, composeSelectiveBody, formatMemoryAge, resolveLinkedIds, RECALL_CAVEAT, DEFAULT_MAX_SELECTED, DEFAULT_MAX_LINKED, type MemorySelector, type MemorySelectRequest, type SelectiveRecallOptions, type SelectiveRecallResult, type LayeredRecallOptions, type LayeredRecallResult, type ScopedNoteHeader, type ScopedNoteRecord, } from "./core/memory-recall.js";
 export { runMemoryConsolidation, CONSOLIDATION_SYSTEM_PROMPT, DEFAULT_CONSOLIDATION_BAND, DEFAULT_CONSOLIDATION_SEARCH_LIMIT, DEFAULT_CONSOLIDATION_MAX_NOTES, DEFAULT_CONSOLIDATION_TIMEOUT_SEC, normalizeForExactMatch, type ConsolidationParams, type ConsolidationStats, type ConsolidationNote, type ConsolidationLLM, } from "./core/runner/memory-consolidation.js";
@@ -195,6 +197,7 @@ export { COORDINATOR_ROLE_PROMPT, TEAMMATE_COMMUNICATION_ADDENDUM, TEAMMATE_TASK
 export { createSubagentTool, FORK_SUBAGENT_TYPE, GENERAL_PURPOSE_SUBAGENT_TYPE, agentWhenToUseText, FORK_DIRECTIVE_FRAME, SUBAGENT_SYSTEM_NOTE, type SubagentToolOptions, type SubagentSpawnContext, type SubagentSteerHandle, type SubagentStep, type SubagentEditedFile, } from "./agents/subagent.js";
 export { getSessionRetainLedger, releaseSessionRetainLedger, } from "./agents/retain-ledger.js";
 export { createSendMessageTool, SEND_MESSAGE_TOOL_NAME, type SendMessageToolOptions } from "./agents/send-message-tool.js";
+export { createPeerAdmission, peerAdmissionFor, judgePeerAdmission, resolvePeerAdmissionConfig, PEER_ADMISSION_DEFAULTS, PEER_HOP_CHAIN_WINDOW, PEER_MESSAGE_NOTICE, createPeerSelfRef, createPeerInboundChainRef, peerAxisToken, appendHopToken, type PeerAdmission, type PeerAdmissionConfig, type PeerAdmissionOptions, type PeerAdmissionRequest, type PeerAdmissionVerdict, type PeerAdmissionRefusal, type PeerRefusalCode, type PeerAxisTag, type PeerIdentity, type PeerSelfRef, type PeerInboundChainRef, } from "./agents/peer-admission.js";
 export { createAgentTranscriptTool, AGENT_TRANSCRIPT_TOOL_NAME, type AgentTranscriptToolOptions, } from "./agents/agent-transcript-tool.js";
 export { defineAgent } from "./agents/agent-definition.js";
 export { builtinAgentDefinitions, BUILTIN_READONLY_DENY_TOOLS, EXPLORE_WHEN_TO_USE, EXPLORE_WHEN_TO_USE_LEAN, PLAN_WHEN_TO_USE, EXPLORE_SYSTEM_PROMPT, PLAN_SYSTEM_PROMPT, } from "./agents/builtin-agents.js";

package/dist/index.js

@@ -114,6 +114,8 @@ export { createPermissionRulePolicy, validatePermissionRules, parsePermissionRul
 export { formatHookFeedback, runToolGate, createHookEnvCapabilities, } from "./core/hooks.js";
 export { InMemoryMemoryStore, composeMemoryBlock, composeLayeredMemoryBlock, normalizeMemorySpec, supportsConsolidation, supportsPeriodicConsolidation, firstSentence, expandLexicalTerms, lexicalSearchMatch, classifyPromotable, enforcePromotableWriteGate, guardedMemoryStore, MemoryGateError, detectSecret, enforceSecretWriteGate, enforceStructuredNoteSecretGate, } from "./core/memory.js";
 export { MemoryEngine, FileMemoryEngineBackend, memoryBackendContract, assertMemoryBackendSearchEquivalence, buildMemoryInstruction, truncateIndex, scanEntryFiles, deriveRepoKey, deriveRepoMemoryDir, deriveControlPlaneDir, deriveRepoControlPlaneDir, resolveMemoryEngineRoot, scopeDirName, ControlPlaneCorruptError, parseEntryFile, serializeEntryFile, computeEntryRev, entryFromFile, MEMORY_INSTRUCTION_TEMPLATE, MEMORY_INDEX_FILENAME, MEMORY_INDEX_MAX_LINES, MEMORY_INDEX_MAX_BYTES, STUB_ARCHIVED_LINE, DEFAULT_MAX_MEMORY_FILES, DEFAULT_MAX_ENTRY_DEPTH, DEFAULT_HARVEST_DEADLINE_MS, DEFAULT_HARVEST_FILE_BUDGET, MASS_DELETION_FUSE_RATIO, scanMemoryWrite, scanMemoryFileName, scanRemediation, MEMORY_FILENAME_SEGMENT_RE, renderAnnouncements, enqueueMemoryAnnouncement, drainMemoryAnnouncements, peekMemoryAnnouncements, bumpScanFuse, scanFuseCount, clearScanFuse, ANNOUNCEMENTS_FILE, MEMORY_ANNOUNCEMENTS_MAX, SCAN_FUSE_FILE, SCAN_FUSE_THRESHOLD, SCOPE_SEGMENT_MAX_ENCODED, PROJECT_MARKER_PATH, encodeScopeSegment, decodeScopeSegment, parseScopeKey, formatUserScope, formatOrgScope, formatProjScope, formatUserProjScope, isPersonalScope, assertScopeContractPlacement, formatProjectMarker, parseProjectMarker, resolveProjectId, PROJECT_ID_REGEX, migrateScope, materializeEntriesToFiles, harvestFilesToPatches, projectionsToWriteBack, screenInboundEntries, REMOTE_HARVEST_PER_FILE_BYTES, REMOTE_MASS_DELETION_FUSE_RATIO, deriveProjectMemoryDir, deriveProjectControlDir, recordProjectIdHint, lookupProjectIdHint, PROJECT_ID_HINTS_FILE, reconcileMemoryEntries, nextSyncBaseline, mergeRecallHits, syncMemoryScope, } from "./core/memory-engine/index.js";
+export { SHARED_MEMORY_READ_CAP_BYTES, SHARED_MEMORY_LIST_PAGE_SIZE, SharedMemoryStoreError, } from "./core/shared-memory/types.js";
+export { sharedMemoryStoreContract, } from "./core/shared-memory/contract.js";
 export { termSet, jaccardDistance, cosineDistance } from "./core/memory-vector.js";
 export { encodeSurfacedKey, buildManifestText, validateSelectedIds, composeSelectiveBody, formatMemoryAge, resolveLinkedIds, RECALL_CAVEAT, DEFAULT_MAX_SELECTED, DEFAULT_MAX_LINKED, } from "./core/memory-recall.js";
 export { runMemoryConsolidation, CONSOLIDATION_SYSTEM_PROMPT, DEFAULT_CONSOLIDATION_BAND, DEFAULT_CONSOLIDATION_SEARCH_LIMIT, DEFAULT_CONSOLIDATION_MAX_NOTES, DEFAULT_CONSOLIDATION_TIMEOUT_SEC, normalizeForExactMatch, } from "./core/runner/memory-consolidation.js";
@@ -177,6 +179,7 @@ export { COORDINATOR_ROLE_PROMPT, TEAMMATE_COMMUNICATION_ADDENDUM, TEAMMATE_TASK
 export { createSubagentTool, FORK_SUBAGENT_TYPE, GENERAL_PURPOSE_SUBAGENT_TYPE, agentWhenToUseText, FORK_DIRECTIVE_FRAME, SUBAGENT_SYSTEM_NOTE, } from "./agents/subagent.js";
 export { getSessionRetainLedger, releaseSessionRetainLedger, } from "./agents/retain-ledger.js";
 export { createSendMessageTool, SEND_MESSAGE_TOOL_NAME } from "./agents/send-message-tool.js";
+export { createPeerAdmission, peerAdmissionFor, judgePeerAdmission, resolvePeerAdmissionConfig, PEER_ADMISSION_DEFAULTS, PEER_HOP_CHAIN_WINDOW, PEER_MESSAGE_NOTICE, createPeerSelfRef, createPeerInboundChainRef, peerAxisToken, appendHopToken, } from "./agents/peer-admission.js";
 export { createAgentTranscriptTool, AGENT_TRANSCRIPT_TOOL_NAME, } from "./agents/agent-transcript-tool.js";
 export { defineAgent } from "./agents/agent-definition.js";
 export { builtinAgentDefinitions, BUILTIN_READONLY_DENY_TOOLS, EXPLORE_WHEN_TO_USE, EXPLORE_WHEN_TO_USE_LEAN, PLAN_WHEN_TO_USE, EXPLORE_SYSTEM_PROMPT, PLAN_SYSTEM_PROMPT, } from "./agents/builtin-agents.js";

package/dist/stores/cc/mailbox-store.js

@@ -149,6 +149,7 @@ export function createCcFileMailboxStore(opts) {
                     msgV: 1,
                     msg_id: randomUUID(),
                     read: false,
+                    ...(msg.hopChain !== undefined ? { hopChain: [...msg.hopChain] } : {}),
                 });
                 saveBox(path, box);
                 return box.length;
@@ -174,6 +175,9 @@ export function createCcFileMailboxStore(opts) {
                 ...(typeof e.from === "string" ? { from: e.from } : {}),
                 content: typeof e.text === "string" ? e.text : "",
                 sentAt: typeof e.timestamp === "string" ? Date.parse(e.timestamp) || 0 : 0,
+                ...(Array.isArray(e.hopChain) && e.hopChain.every((h) => typeof h === "string")
+                    ? { hopChain: e.hopChain.filter((h) => typeof h === "string") }
+                    : {}),
             }));
             if (pending.length === 0)
                 return Promise.resolve(null);

package/dist/stores/file/mailbox-store.js

@@ -116,7 +116,7 @@ export class FileMailboxStore {
         return withPathLock(this.lockKey(scope, handle), () => {
             const b = this.load(scope, handle);
             const seq = b.nextSeq;
-            const m = { seq, ...(msg.from !== undefined ? { from: msg.from } : {}), content: msg.content, sentAt: msg.sentAt };
+            const m = { seq, ...(msg.from !== undefined ? { from: msg.from } : {}), content: msg.content, sentAt: msg.sentAt, ...(msg.hopChain !== undefined ? { hopChain: [...msg.hopChain] } : {}) };
             this.commit(b, this.boxPath(scope, handle), { t: "append", m });
             return seq;
         });
@@ -130,7 +130,7 @@ export class FileMailboxStore {
                 return null;
             const maxSeq = b.messages[b.messages.length - 1].seq;
             this.commit(b, this.boxPath(scope, handle), { t: "lease", owner, expiresAt: now + ttlMs, maxSeq });
-            return { messages: b.messages.map((m) => ({ ...m })), maxSeq };
+            return { messages: b.messages.map((m) => ({ ...m, ...(m.hopChain !== undefined ? { hopChain: [...m.hopChain] } : {}) })), maxSeq };
         });
     }
     async ack(scope, handle, owner, upToSeq) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/core",
-  "version": "5.16.0",
+  "version": "5.17.0-pre.0",
   "description": "Stateless, task-oriented AI agent core",
   "type": "module",
   "license": "BUSL-1.1",