@sema-agent/core 7.0.1 → 7.1.0

package/dist/orchestration/run-workflow-tool.js

@@ -332,8 +332,13 @@ export async function createRunWorkflowTool(d) {
             "body (equivalently, pass { phase: 'Fix' } in an agent's opts). Give each stage a phase so progress " +
             "renders as stage groups; use the same titles you declared in meta.phases.\n" +
             "• spec.modelName works only when the deployment configured a workflow model allowlist, and its legal " +
-            "values are that deployment's own model CATALOG KEYS — not generic tier words (a bare 'opus'/'sonnet'/" +
-            "'haiku' is a name the catalog almost certainly does not hold, and is refused rather than approximated). " +
+            "values are the names on THAT allowlist which the deployment's model CATALOG KEYS also hold — a name " +
+            "off the allowlist, and a listed name the catalog lacks, are both refused rather than approximated. " +
+            "Generic tier words ('opus'/'sonnet'/'haiku'/'pro'/'flash'/'best') are not a separate namespace: on a " +
+            "deployment that configured tier bindings they become ordinary catalog keys, but only the ones its " +
+            "bindings actually resolve; on one that did not they are simply absent, unless its catalog happens to " +
+            "declare that literal name. Either way the allowlist is the gate, so a tier word is legal here only " +
+            "when this deployment allowlisted it, never as a shortcut around it. " +
             "It also goes on the SPEC (the first argument), never in an agent()'s options object; `model` is accepted " +
             "there as an alias for the same field. If unsure, omit it and the agent runs on the deployment's default " +
             "role.\n" +
@@ -515,12 +520,17 @@ export async function createRunWorkflowTool(d) {
                     ...(() => {
                         if ("memoryCaptureOptedOut" in ctx) {
                             return {
-                                parentMemoryCaptureState: () => ({
-                                    optedOut: ctx.memoryCaptureOptedOut === true,
-                                    indeterminate: ctx.memoryCaptureIndeterminate === true,
-                                    ...(ctx.memoryCaptureControlDir !== undefined ? { controlDir: ctx.memoryCaptureControlDir } : {}),
-                                    ...(ctx.memoryCaptureAncestors !== undefined ? { ancestors: ctx.memoryCaptureAncestors } : {}),
-                                }),
+                                parentMemoryCaptureState: () => {
+                                    const o = ctx.memoryCaptureOptedOut ?? false;
+                                    const i = ctx.memoryCaptureIndeterminate ?? false;
+                                    const build = (optedOut, indeterminate) => ({
+                                        optedOut: optedOut === true,
+                                        indeterminate: indeterminate === true,
+                                        ...(ctx.memoryCaptureControlDir !== undefined ? { controlDir: ctx.memoryCaptureControlDir } : {}),
+                                        ...(ctx.memoryCaptureAncestors !== undefined ? { ancestors: ctx.memoryCaptureAncestors } : {}),
+                                    });
+                                    return o instanceof Promise || i instanceof Promise ? Promise.all([o, i]).then(([ov, iv]) => build(ov, iv)) : build(o, i);
+                                },
                             };
                         }
                         return d.parentMemoryCaptureState !== undefined ? { parentMemoryCaptureState: d.parentMemoryCaptureState } : {};

package/dist/orchestration/workflow-governance.js

@@ -99,7 +99,7 @@ export function resolveModelName(name, allowlist, models) {
     if (!allowlist.includes(name)) {
         throw new WorkflowModelNotAllowedError(name, `not in the workflow model allowlist [${allowlist.join(", ")}]`);
     }
-    const model = models?.[name];
+    const model = models !== undefined && Object.hasOwn(models, name) ? models[name] : undefined;
     if (!model) {
         throw new WorkflowModelNotAllowedError(name, "allowed by name but not present in RunnerDeps.models");
     }

package/dist/orchestration/workflow-types.d.ts

@@ -392,6 +392,7 @@ export type WorkflowEvent = {
     output?: string;
     errorCode?: string;
     toolCalls?: number;
+    modelResolved?: string;
     replayed?: boolean;
     ts: number;
 } | {

package/dist/orchestration/workflow.d.ts

@@ -405,7 +405,15 @@ export interface RunWorkflowOptions {
             sessionId: string;
             controlDir?: string;
         }>;
-    };
+    } | Promise<{
+        optedOut: boolean;
+        indeterminate: boolean;
+        controlDir?: string;
+        ancestors?: ReadonlyArray<{
+            sessionId: string;
+            controlDir?: string;
+        }>;
+    }>;
     /** Call-time getter for the HOST run's RESOLVED Model object. A spawned agent whose
      *  fold chain (script spec → agentType → governance baseline) produced NO model inherits the
      *  parent's full object — baseUrl/key routing included — instead of falling to a string/role

package/dist/orchestration/workflow.js

@@ -60,7 +60,7 @@ function workflowModelLabel(spec, catalog) {
         return undefined;
     if (typeof model !== "string")
         return model.id ?? model.name;
-    const served = catalog?.[model]?.id;
+    const served = catalog !== undefined && Object.hasOwn(catalog, model) ? catalog[model]?.id : undefined;
     return served ?? resolveModelDisplayLabel(model);
 }
 export const WORKFLOW_SUBAGENT_PROMPT = `You are a subagent spawned by a workflow orchestration script. Use the tools available to complete the task.
@@ -619,8 +619,8 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
         ...(opts.placementRoot !== undefined ? { placementRoot: opts.placementRoot } : {}),
         ...(opts.originatingSessionId !== undefined ? { parentSessionId: opts.originatingSessionId } : {}),
     };
-    const captureFloorSeatsNow = () => {
-        const s = opts.parentMemoryCaptureState?.();
+    const captureFloorSeatsNow = async () => {
+        const s = await opts.parentMemoryCaptureState?.();
         if (s === undefined)
             return {};
         return {
@@ -1255,7 +1255,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
                         opts.onForwardEvent(e.type === "task_progress" ? { ...e, workflowRunId: runId, workflowAgentLabel: label } : e);
                     }
                     : undefined;
-                const baseInternals = { ...(agentOpts.isolation ? { isolation: agentOpts.isolation } : {}), ...(opts.parentCwd !== undefined ? { parentCwd: opts.parentCwd } : {}), ...spawnAttribution, ...captureFloorSeatsNow(), ...(enrichedForward !== undefined ? { onForwardEvent: enrichedForward } : {}), delegationTaskType: "workflow", agentName: label, onWorkspaceResolved: createWorkspaceObserver(rec) };
+                const baseInternals = { ...(agentOpts.isolation ? { isolation: agentOpts.isolation } : {}), ...(opts.parentCwd !== undefined ? { parentCwd: opts.parentCwd } : {}), ...spawnAttribution, ...(await captureFloorSeatsNow()), ...(enrichedForward !== undefined ? { onForwardEvent: enrichedForward } : {}), delegationTaskType: "workflow", agentName: label, onWorkspaceResolved: createWorkspaceObserver(rec) };
                 let attempts = 0;
                 let throttleRetried = false;
                 let lastAttemptReason;
@@ -1574,7 +1574,7 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
                     ...(agentOpts.isolation ? { isolation: agentOpts.isolation } : {}),
                     ...(opts.parentCwd !== undefined ? { parentCwd: opts.parentCwd } : {}),
                     ...spawnAttribution,
-                    ...captureFloorSeatsNow(),
+                    ...(await captureFloorSeatsNow()),
                     ...(enrichedForwardS !== undefined ? { onForwardEvent: enrichedForwardS } : {}),
                     delegationTaskType: "workflow",
                     agentName: label,

package/dist/stores/file/mailbox-store.d.ts

@@ -30,7 +30,8 @@ export declare class FileMailboxStore implements MailboxStore {
      * file can never disagree. Before this, `AgentOne` and `agentone` produced two DIFFERENT shared-state
      * keys but the SAME file on a case-insensitive filesystem (macOS/Windows default) — one recipient read
      * the other's messages after a restart. Folding is also the semantically correct answer, not just the
-     * safe one: the addressing layer's `normalizeAgentName` (task-registry.ts:621) already lowercases, so
+     * safe one: the addressing layer's `normalizeAgentName` (defined in core/task-registry-shared.ts and
+     * re-exported by task-registry.ts) already lowercases, so
      * two case-variant handles ARE the same agent; this makes the storage layer say so explicitly instead of
      * depending on an upstream coincidence, and behave identically on case-SENSITIVE filesystems (Linux),
      * where the old code silently split one logical agent's mail across two boxes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/core",
-  "version": "7.0.1",
+  "version": "7.1.0",
   "description": "Stateless, task-oriented AI agent core",
   "type": "module",
   "license": "BUSL-1.1",

package/test/export-surface.snapshot.json

@@ -1,7 +1,7 @@
 {
   "_comment": "design/87 L3 — frozen public export surface of src/index.ts (name -> kind). DO NOT edit by hand to silence a red test. A removed/changed entry = a SemVer-BREAKING change; bump MAJOR and update this fixture in the SAME commit (design/87 §4.2 / §5.2). Regenerate via REGEN in test/export-surface.test.ts.",
   "_tierComment": "#435 v1 — machine-readable layering of the public surface: stable = demonstrated by README.md / src/examples; internal = an `Internal`-marked name or a runner/engine deep-subtree declaration (the model seam src/engine/llm is excluded — it is the BYOM contract, not an engine internal); advanced = a supported export the front door does not walk you through. THIS IS AN INITIAL HEURISTIC, derived mechanically and expected to be refined ticket by ticket: no human reviewed these 1700+ entries one by one, and nothing here claims otherwise. Known bias: a short or English-word export name (ok, err, Result, Usage) can match ordinary prose in README.md and land `stable` on a coincidence. Every export MUST carry a tier — a new export with no row fails the gate in export-surface.test.ts.",
-  "count": 1841,
+  "count": 1842,
   "exports": {
     "A2ATaskState": "type",
     "A2ATaskStateReversal": "type",
@@ -996,6 +996,7 @@
     "SessionCaptureOptOutRecord": "interface",
     "SessionCaptureRecordStore": "interface",
     "SessionError": "class",
+    "SessionMemoryStatus": "interface",
     "SessionMetadata": "interface",
     "SessionPermissionRules": "interface",
     "SessionPlacement": "interface",
@@ -2839,6 +2840,7 @@
     "SessionCaptureOptOutRecord": "advanced",
     "SessionCaptureRecordStore": "advanced",
     "SessionError": "stable",
+    "SessionMemoryStatus": "advanced",
     "SessionMetadata": "stable",
     "SessionPermissionRules": "advanced",
     "SessionPlacement": "advanced",