@sema-agent/core 5.8.0 → 5.9.0

package/dist/engine/llm/types.d.ts

@@ -68,15 +68,9 @@ export interface SimpleStreamOptions extends StreamOptions {
 }
 export type StreamFunction<TApi extends Api = Api, TOptions extends StreamOptions = StreamOptions> = (model: Model<TApi>, context: Context, options?: TOptions) => AssistantMessageEventStreamContract;
 export type ImagesFunction<TApi extends ImagesApi = ImagesApi, TOptions extends ImagesOptions = ImagesOptions> = (model: ImagesModel<TApi>, context: ImagesContext, options?: TOptions) => Promise<AssistantImages>;
-export interface TextSignatureV1 {
-    v: 1;
-    id: string;
-    phase?: "commentary" | "final_answer";
-}
 export interface TextContent {
     type: "text";
     text: string;
-    textSignature?: string;
 }
 export interface ThinkingContent {
     type: "thinking";
@@ -99,7 +93,6 @@ export interface ToolCall {
     id: string;
     name: string;
     arguments: Record<string, unknown>;
-    thoughtSignature?: string;
     executionMode?: "sequential" | "parallel";
 }
 export interface Usage {
@@ -259,28 +252,15 @@ export interface AssistantMessageEventStreamLike extends AsyncIterable<Assistant
     result(): Promise<AssistantMessage>;
 }
 export interface OpenAICompletionsCompat {
-    supportsStore?: boolean;
-    supportsDeveloperRole?: boolean;
     supportsReasoningEffort?: boolean;
     reasoningEffortLevels?: ThinkingLevel[];
-    supportsUsageInStreaming?: boolean;
     maxTokensField?: "max_completion_tokens" | "max_tokens";
-    requiresToolResultName?: boolean;
-    requiresAssistantAfterToolResult?: boolean;
-    requiresThinkingAsText?: boolean;
     requiresReasoningContentOnAssistantMessages?: boolean;
     thinkingFormat?: "openai" | "openrouter" | "deepseek" | "together" | "zai" | "qwen" | "qwen-chat-template";
-    openRouterRouting?: OpenRouterRouting;
-    vercelGatewayRouting?: VercelGatewayRouting;
-    zaiToolStream?: boolean;
-    supportsStrictMode?: boolean;
-    cacheControlFormat?: "anthropic";
-    sendSessionAffinityHeaders?: boolean;
-    supportsLongCacheRetention?: boolean;
 }
 export interface OpenAIResponsesCompat {
-    sendSessionIdHeader?: boolean;
-    supportsLongCacheRetention?: boolean;
+    supportsReasoningEffort?: boolean;
+    reasoningEffortLevels?: ThinkingLevel[];
 }
 export interface AnthropicMessagesCompat {
     thinkingMode?: "budget" | "adaptive";
@@ -288,48 +268,6 @@ export interface AnthropicMessagesCompat {
     supportsTemperature?: boolean;
     contextManagement?: boolean;
     interleavedThinking?: boolean;
-    supportsEagerToolInputStreaming?: boolean;
-    supportsLongCacheRetention?: boolean;
-    sendSessionAffinityHeaders?: boolean;
-    supportsCacheControlOnTools?: boolean;
-}
-export interface OpenRouterRouting {
-    allow_fallbacks?: boolean;
-    require_parameters?: boolean;
-    data_collection?: "deny" | "allow";
-    zdr?: boolean;
-    enforce_distillable_text?: boolean;
-    order?: string[];
-    only?: string[];
-    ignore?: string[];
-    quantizations?: string[];
-    sort?: string | {
-        by?: string;
-        partition?: string | null;
-    };
-    max_price?: {
-        prompt?: number | string;
-        completion?: number | string;
-        image?: number | string;
-        audio?: number | string;
-        request?: number | string;
-    };
-    preferred_min_throughput?: number | {
-        p50?: number;
-        p75?: number;
-        p90?: number;
-        p99?: number;
-    };
-    preferred_max_latency?: number | {
-        p50?: number;
-        p75?: number;
-        p90?: number;
-        p99?: number;
-    };
-}
-export interface VercelGatewayRouting {
-    only?: string[];
-    order?: string[];
 }
 export interface Model<TApi extends Api = Api> {
     id: string;
@@ -357,15 +295,6 @@ export interface Model<TApi extends Api = Api> {
     headers?: Record<string, string>;
     promptGuidance?: string[];
     compat?: TApi extends "openai-completions" ? OpenAICompletionsCompat : TApi extends "openai-responses" ? OpenAIResponsesCompat : TApi extends "anthropic-messages" ? AnthropicMessagesCompat : never;
-    mediaInput?: {
-        image?: {
-            maxBytes?: number;
-            maxPixels?: number;
-            maxSidePx?: number;
-            preferredSidePx?: number;
-            tokenMode?: "tile" | "detail" | "provider";
-        };
-    };
 }
 export interface ImagesModel<TApi extends ImagesApi = ImagesApi> extends Omit<Model, "api" | "provider" | "reasoning" | "contextWindow" | "maxTokens" | "compat"> {
     api: TApi;

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

@@ -495,7 +495,7 @@ async function executeToolCallsSequential(currentContext, assistantMessage, tool
             };
         }
         else {
-            const executed = await executePreparedToolCall(preparation, signal, emit);
+            const executed = await executePreparedToolCall(preparation, signal, emit, config.abortResultDetails);
             finalized = await finalizeExecutedToolCall(currentContext, assistantMessage, preparation, executed, config, signal);
         }
         await emitToolExecutionEnd(finalized, emit);
@@ -625,7 +625,7 @@ async function executeToolCallsPartitioned(currentContext, assistantMessage, too
     return { messages, terminate: shouldTerminateToolBatch(allFinalized) };
     async function settleBatch(entries, concurrent) {
         const runOne = (entry) => async () => {
-            const executed = await executePreparedToolCall(entry.prepared, signal, emit);
+            const executed = await executePreparedToolCall(entry.prepared, signal, emit, config.abortResultDetails);
             const finalized = await finalizeExecutedToolCall(currentContext, assistantMessage, entry.prepared, executed, config, signal);
             await emitToolExecutionEnd(finalized, emit);
             return finalized;
@@ -707,7 +707,7 @@ class StreamToolExecutor {
                 return;
             }
             entry.prepared = preparation;
-            entry.executed = await executePreparedToolCall(preparation, this.signal, this.emit);
+            entry.executed = await executePreparedToolCall(preparation, this.signal, this.emit, this.config.abortResultDetails);
         }
         catch (error) {
             entry.immediate = {
@@ -829,7 +829,7 @@ async function prepareToolCall(currentContext, assistantMessage, toolCall, confi
             if (signal?.aborted) {
                 return {
                     kind: "immediate",
-                    result: createErrorToolResult("Operation aborted"),
+                    result: createErrorToolResult("Operation aborted", { details: config.abortResultDetails?.() }),
                     isError: true,
                 };
             }
@@ -869,11 +869,11 @@ async function prepareToolCall(currentContext, assistantMessage, toolCall, confi
         };
     }
 }
-async function executePreparedToolCall(prepared, signal, emit) {
+async function executePreparedToolCall(prepared, signal, emit, abortResultDetails) {
     const updateEvents = [];
     let acceptingUpdates = true;
     if (signal?.aborted) {
-        return { result: createErrorToolResult("operation aborted before execution"), isError: true };
+        return { result: createErrorToolResult("operation aborted before execution", { details: abortResultDetails?.() }), isError: true };
     }
     const work = (async () => {
         try {

package/dist/engine/loop/types.d.ts

@@ -85,6 +85,7 @@ export interface AgentLoopConfig extends SimpleStreamOptions {
     getFollowUpMessages?: () => Promise<AgentMessage[]>;
     toolExecution?: ToolExecutionMode;
     beforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult | undefined>;
+    abortResultDetails?: () => Record<string, unknown> | undefined;
     afterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult | undefined>;
 }
 export type ThinkingLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";

package/dist/engine/session/repo-utils.d.ts

@@ -1,9 +1,8 @@
-import { type FileError, type Result, type SessionMetadata, type SessionStorage, type SessionTreeEntry } from "../harness/types.js";
+import { type SessionMetadata, type SessionStorage, type SessionTreeEntry } from "../harness/types.js";
 import type { Session } from "../harness/types.js";
 export declare function createSessionId(): string;
 export declare function createTimestamp(): string;
 export declare function toSession<TMetadata extends SessionMetadata>(storage: SessionStorage<TMetadata>): Session<TMetadata>;
-export declare function getFileSystemResultOrThrow<TValue>(result: Result<TValue, FileError>, message: string): TValue;
 export declare function getEntriesToFork(storage: SessionStorage, options: {
     entryId?: string;
     position?: "before" | "at";

package/dist/engine/session/repo-utils.js

@@ -10,13 +10,6 @@ export function createTimestamp() {
 export function toSession(storage) {
     return new StoredSession(storage);
 }
-export function getFileSystemResultOrThrow(result, message) {
-    if (!result.ok) {
-        const code = result.error.code === "not_found" ? "not_found" : "storage";
-        throw new SessionError(code, `${message}: ${result.error.message}`, result.error);
-    }
-    return result.value;
-}
 function rerootIfHeadless(storage, entries) {
     const head = entries[0];
     if (head === undefined || head.parentId === null)

package/dist/index.d.ts

@@ -113,7 +113,7 @@ export type { SchedulerCapability, SchedulerErrorCode, ScheduledIntent, Schedule
 export { createSchedulerTools, type SchedulerToolContext, SCHEDULE_WAKEUP_TOOL_NAME, AUTONOMOUS_LOOP_SENTINEL, AUTONOMOUS_LOOP_DYNAMIC_SENTINEL, } from "./tools/scheduler-tools.js";
 export { resolveAutonomousLoopPrompt, AUTONOMOUS_LOOP_PREAMBLE, AUTONOMOUS_LOOP_PREAMBLE_PERSISTENT, type AutonomousLoopPromptOptions, } from "./tools/loop-tick.js";
 export { tightenTaskSpec, TaskSpecTightenError } from "./core/tighten-task-spec.js";
-export { createAllowDenyPolicy, createApprovalPolicy, COARSE_SHELL_TOOLS, createCoarseCommandNamePolicy, createTranscriptIntegrityPolicy, createUnverifiableDeletePolicy, findUnverifiableRecursiveDelete, combinePolicies, decisionText, resolveAsk, toolPolicyNameSets, type ToolPolicyNameSets, type NamedToolPolicy, type ToolPolicy, type ToolCallRequest, type PermissionResult, type DecisionReason, type OnAsk, type AskOutcome, type ResolvedAsk, type AskRequest, } from "./core/tool-policy.js";
+export { createAllowDenyPolicy, createApprovalPolicy, COARSE_SHELL_TOOLS, createCoarseCommandNamePolicy, createTranscriptIntegrityPolicy, createUnverifiableDeletePolicy, findUnverifiableRecursiveDelete, combinePolicies, decisionText, resolveAsk, toolPolicyNameSets, type ToolPolicyNameSets, type NamedToolPolicy, type ToolPolicy, type ToolCallRequest, type PermissionResult, type DecisionReason, type OnAsk, type AskOutcome, type ResolvedAsk, type AskRequest, type AskDelegationProvenance, } from "./core/tool-policy.js";
 export { parseAutoModeResponse, createAutoModeDecider, type AutoModeVerdict, type AutoModeDecider, type AutoModeDeciderOptions, type AutoModeClassifyFn, type AutoModeClassifyInput, } from "./core/auto-mode.js";
 export { buildAutoModePrompt, renderAutoModeWindow, renderAutoModeAction, AUTO_MODE_DEFAULTS_SENTINEL, type AutoModeRules, type BuildAutoModePromptOptions, type AutoModeWindowOptions, } from "./core/auto-mode-prompt.js";
 export { AUTO_MODE_BASE_PROMPT, AUTO_MODE_PERMISSIONS_EXTERNAL } from "./core/auto-mode-prompt-assets.js";
@@ -151,7 +151,7 @@ export { runSpec, type RunSpecOptions, type RunSpecResult, type RunSpecOracleRep
 export { isSelfOrchestrationActive, workflowsCapability, selfOrchestrationFailClosedReason, type WorkflowScriptRunner, type WorkflowMeta, type WorkflowPrimitives, } from "./orchestration/workflow-script-runner.js";
 export { devWorkflowScriptRunner } from "./orchestration/dev-vm-script-runner.js";
 export { parseWorkflowMeta, splitWorkflowMeta, WorkflowScriptError, workflowScriptReadsClockOrRandom } from "./orchestration/workflow-meta.js";
-export { assertWorkflowSandboxConformance, assertWorkflowPrimitivesWiring } from "./orchestration/workflow-sandbox-conformance.js";
+export { assertWorkflowSandboxConformance, assertWorkflowPrimitivesWiring, assertWorkflowDeterminism } from "./orchestration/workflow-sandbox-conformance.js";
 export { WorkflowModelNotAllowedError, type WorkflowAgentSpec } from "./orchestration/workflow-governance.js";
 export { WorkflowMaxAgentsError, WorkflowResultTooLargeError } from "./orchestration/workflow.js";
 export { createFileWorkflowScriptStore, mergeWorkflowArgs, type WorkflowScriptStore, type NamedWorkflowResolution, type NamedWorkflowListing, } from "./orchestration/workflow-script-store.js";
@@ -195,6 +195,7 @@ export { createTaskServer, type TaskServerOptions, type TaskRequestBody, } from
 export { clearStaleToolResults, COMPACTABLE_TOOLS, editBudget, type ContextEditOptions, } from "./core/context-edit.js";
 export { createOpenAIBrain, type OpenAIBrainConfig } from "./brain/openai.js";
 export { createAnthropicBrain, type AnthropicBrainConfig } from "./brain/anthropic.js";
+export { createOpenResponsesBrain, type OpenResponsesBrainConfig } from "./brain/open-responses.js";
 export { FABLE_5_COMPAT, fable5Model } from "./brain/model-presets.js";
 export { createFailoverBrain } from "./brain/failover.js";
 export { createRoutingBrain, type RoutingBrainOptions } from "./brain/routing.js";

package/dist/index.js

@@ -135,7 +135,7 @@ export { runSpec } from "./orchestration/run-spec.js";
 export { isSelfOrchestrationActive, workflowsCapability, selfOrchestrationFailClosedReason, } from "./orchestration/workflow-script-runner.js";
 export { devWorkflowScriptRunner } from "./orchestration/dev-vm-script-runner.js";
 export { parseWorkflowMeta, splitWorkflowMeta, WorkflowScriptError, workflowScriptReadsClockOrRandom } from "./orchestration/workflow-meta.js";
-export { assertWorkflowSandboxConformance, assertWorkflowPrimitivesWiring } from "./orchestration/workflow-sandbox-conformance.js";
+export { assertWorkflowSandboxConformance, assertWorkflowPrimitivesWiring, assertWorkflowDeterminism } from "./orchestration/workflow-sandbox-conformance.js";
 export { WorkflowModelNotAllowedError } from "./orchestration/workflow-governance.js";
 export { WorkflowMaxAgentsError, WorkflowResultTooLargeError } from "./orchestration/workflow.js";
 export { createFileWorkflowScriptStore, mergeWorkflowArgs, } from "./orchestration/workflow-script-store.js";
@@ -177,6 +177,7 @@ export { createTaskServer, } from "./server/http.js";
 export { clearStaleToolResults, COMPACTABLE_TOOLS, editBudget, } from "./core/context-edit.js";
 export { createOpenAIBrain } from "./brain/openai.js";
 export { createAnthropicBrain } from "./brain/anthropic.js";
+export { createOpenResponsesBrain } from "./brain/open-responses.js";
 export { FABLE_5_COMPAT, fable5Model } from "./brain/model-presets.js";
 export { createFailoverBrain } from "./brain/failover.js";
 export { createRoutingBrain } from "./brain/routing.js";

package/dist/internal/llm.d.ts

@@ -1,2 +1,2 @@
 export { createAssistantMessageEventStream, stripEngineMetadata } from "../engine/llm/index.js";
-export type { AnthropicMessagesCompat, AssistantMessage, AssistantMessageDiagnostic, AssistantMessageEvent, CompleteSimpleFn, Context, DocumentContent, ImageContent, Message, Model, ResilienceOptions, SimpleStreamOptions, StallTimeouts, StopReason, StreamFn, TextContent, ThinkingContent, Tool, ToolCall, ToolResultMessage, Usage, UserMessage, } from "../engine/llm/index.js";
+export type { AnthropicMessagesCompat, OpenAICompletionsCompat, OpenAIResponsesCompat, AssistantMessage, AssistantMessageDiagnostic, AssistantMessageEvent, CompleteSimpleFn, Context, DocumentContent, ImageContent, Message, Model, ResilienceOptions, SimpleStreamOptions, StallTimeouts, StopReason, StreamFn, TextContent, ThinkingContent, Tool, ToolCall, ToolResultMessage, Usage, UserMessage, } from "../engine/llm/index.js";

package/dist/orchestration/workflow.js

@@ -222,6 +222,14 @@ function normalizeWorkflowHardCap(name, v) {
     }
     return v;
 }
+function normalizeWorkflowStallMs(v) {
+    if (v === undefined)
+        return WORKFLOW_AGENT_STALL_MS;
+    if (!Number.isFinite(v)) {
+        throw new Error(`runWorkflow: stallMs must be a finite number of milliseconds (got ${v}); 0 or a negative value is the documented explicit "off", not NaN/Infinity`);
+    }
+    return v;
+}
 function createSemaphore(max) {
     let active = 0;
     const waiters = [];
@@ -307,12 +315,13 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
     const maxAgents = normalizeWorkflowHardCap("maxAgents", opts.maxAgents);
     const maxLogChars = normalizeWorkflowHardCap("maxLogChars", opts.maxLogChars);
     const maxResultChars = normalizeWorkflowHardCap("maxResultChars", opts.maxResultChars);
-    const stallMs = opts.stallMs ?? WORKFLOW_AGENT_STALL_MS;
-    const agentMaxRetries = opts.agentMaxRetries ?? WORKFLOW_AGENT_MAX_RETRIES;
-    const throttleBackoffMs = opts.throttleBackoffMs ?? WORKFLOW_AGENT_THROTTLE_BACKOFF_MS;
+    const totalTimeoutMs = normalizeWorkflowHardCap("totalTimeoutMs", opts.totalTimeoutMs);
+    const stallMs = normalizeWorkflowStallMs(opts.stallMs);
+    const agentMaxRetries = normalizeWorkflowHardCap("agentMaxRetries", opts.agentMaxRetries) ?? WORKFLOW_AGENT_MAX_RETRIES;
+    const throttleBackoffMs = normalizeWorkflowHardCap("throttleBackoffMs", opts.throttleBackoffMs) ?? WORKFLOW_AGENT_THROTTLE_BACKOFF_MS;
     const timers = opts.timers ?? REAL_WORKFLOW_TIMERS;
     const cancelController = new AbortController();
-    const timeoutController = opts.totalTimeoutMs !== undefined ? new AbortController() : undefined;
+    const timeoutController = totalTimeoutMs !== undefined ? new AbortController() : undefined;
     const signalSources = [cancelController.signal];
     if (opts.signal)
         signalSources.push(opts.signal);
@@ -375,7 +384,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
     };
     markWorkflowActive(runId, scope);
     if (timeoutController) {
-        timeoutTimer = setTimeout(() => timeoutController.abort(new Error("workflow total timeout")), opts.totalTimeoutMs);
+        timeoutTimer = setTimeout(() => timeoutController.abort(new Error("workflow total timeout")), totalTimeoutMs);
         timeoutTimer.unref?.();
     }
     emit({ type: "run_start", runId, scope, ts: t0 });

package/dist/tools/web.js

@@ -3,11 +3,28 @@ import { defineTool, errorResult } from "../core/tools.js";
 import { delimitUntrusted, inlineUntrusted } from "../core/untrusted-text.js";
 import { redactSecrets } from "../core/untrusted-egress.js";
 import { isPrivateHost } from "../core/runner/image.js";
+import { binaryMagicFormat } from "./fs/safety.js";
+import { pdfMagicMatches } from "./fs/pdf.js";
 const MAX_REDIRECTS = 10;
 const MAX_URL_LENGTH = 2048;
 const WEBFETCH_ACCEPT = "text/markdown, text/html, */*";
 const DEFAULT_WEBFETCH_USER_AGENT = "Sema-User (@sema-agent/core WebFetch)";
 const DEFAULT_MAX_BYTES = 2 * 1024 * 1024;
+function resolveWebMaxBytes(value) {
+    if (value === undefined)
+        return DEFAULT_MAX_BYTES;
+    if (value === Number.POSITIVE_INFINITY || value === Number.NEGATIVE_INFINITY) {
+        const e = new Error(`WebFetch maxBytes cannot be ${value === Number.POSITIVE_INFINITY ? "Infinity" : "-Infinity"} — the byte cap cannot be turned off, only widened; pass a large finite value instead (got ${String(value)})`);
+        e.code = "config.web_max_bytes_invalid";
+        throw e;
+    }
+    if (!Number.isFinite(value) || value <= 0) {
+        const e = new Error(`WebFetch maxBytes must be a positive finite number of bytes (got ${String(value)})`);
+        e.code = "config.web_max_bytes_invalid";
+        throw e;
+    }
+    return value;
+}
 const DEFAULT_FETCH_TIMEOUT_MS = 30_000;
 const ERROR_BODY_EXCERPT_CHARS = 2048;
 const ERROR_BODY_CONVERT_MAX_CHARS = 64 * 1024;
@@ -126,25 +143,9 @@ function isBinaryContentType(contentType) {
     return true;
 }
 function sniffBinarySignature(b) {
-    const at = (i) => b[i] ?? -1;
-    const ascii = (str, off = 0) => [...str].every((ch, i) => at(off + i) === ch.charCodeAt(0));
-    if (ascii("%PDF"))
+    if (pdfMagicMatches(b))
         return "PDF";
-    if (at(0) === 0x89 && ascii("PNG", 1))
-        return "PNG";
-    if (at(0) === 0xff && at(1) === 0xd8 && at(2) === 0xff)
-        return "JPEG";
-    if (ascii("GIF8"))
-        return "GIF";
-    if (at(0) === 0x1f && at(1) === 0x8b)
-        return "gzip";
-    if (ascii("PK") && ((at(2) === 3 && at(3) === 4) || (at(2) === 5 && at(3) === 6)))
-        return "zip";
-    if (at(0) === 0x7f && ascii("ELF", 1))
-        return "ELF binary";
-    if (at(0) === 0x00 && ascii("asm", 1))
-        return "WebAssembly";
-    return undefined;
+    return binaryMagicFormat(b);
 }
 function isPermittedRedirectHop(from, to) {
     const upgrade = from.protocol === "http:" && to.protocol === "https:";
@@ -209,7 +210,7 @@ async function fetchAllowlisted(doFetch, start, allowHosts, userAgent, signal, o
     return { ok: false, error: "too many redirects" };
 }
 export function webFetchToolSpec(config = {}) {
-    const maxBytes = config.maxBytes ?? DEFAULT_MAX_BYTES;
+    const maxBytes = resolveWebMaxBytes(config.maxBytes);
     const doFetch = config.fetchImpl ?? globalThis.fetch;
     const canSummarize = config.summarize !== undefined;
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/core",
-  "version": "5.8.0",
+  "version": "5.9.0",
   "description": "Stateless, task-oriented AI agent core",
   "type": "module",
   "license": "BUSL-1.1",
@@ -61,7 +61,9 @@
     "gate:message-branching": "node scripts/verify-no-message-branching.mjs",
     "gate:failloud": "node scripts/verify-failloud.mjs",
     "gate:domain-lexicon": "node scripts/verify-domain-lexicon.mjs",
-    "gate:single-mint": "node scripts/verify-single-mint.mjs"
+    "gate:single-mint": "node scripts/verify-single-mint.mjs",
+    "gate:nuia": "node scripts/verify-nuia-baseline.mjs",
+    "gate:field-liveness": "node scripts/verify-field-liveness.mjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.30.0",