@sema-agent/core 7.55.0 → 7.56.0

package/dist/agents/cascade.js

@@ -206,7 +206,7 @@ export async function runCascade(runner, spec, config, internals) {
         return {
             taskId: spec.taskId ?? "",
             sessionId: "",
-            result: `runCascade: the overall wall-clock budget (totalTimeoutMs ${config.totalTimeoutMs}ms) was already spent when the ladder was entered — no rung dispatched`,
+            result: `runCascade: the overall wall-clock budget (totalTimeoutMs ${config.totalTimeoutMs}ms) was already spent when the ladder was entered — no rung dispatched`, resultEntryIds: [],
             terminal: { kind: "failed", code: CASCADE_NO_DISPATCH_ERROR_CODE },
             stats: { tokens: 0, turns: 0, costMicroUsd: 0 },
             cascadeOutcome: "exhausted",

package/dist/agents/cc-peer-directory.js

@@ -107,6 +107,7 @@ export function createCcPeerDirectory(opts) {
             ...(typeof r["peerProtocol"] === "number" ? { peerProtocol: r["peerProtocol"] } : {}),
             ...(features !== undefined ? { peerFeatures: features } : {}),
             sockPath,
+            where: "this_machine",
         });
         if (!read.ok)
             return void skip(file, "invalid_row", read.field !== undefined ? `${read.reason}: ${read.field}` : read.reason);

package/dist/agents/child-model-seat.d.ts

@@ -18,17 +18,6 @@ export declare function deploymentStatesSubagentModel(roles: ModelRoles | undefi
  * already reflects when the parent ran on it).
  */
 export declare function deploymentSubagentThinking(roles: ModelRoles | undefined): ThinkingLevel | undefined;
-/**
- * Did the deployment STATE a system prompt for its subagents — and which? The `systemPrompt` member of an
- * object-form `roles.subagent` entry; a string ref, a `Model` object or an entry without the member states
- * none. The third axis, read off the SAME seat as {@link deploymentSubagentThinking}. It has no parent rung:
- * a child never inherits its PARENT's system prompt, only the deployment's statement for subagents. Which
- * station needs to read it: one whose default persona is written onto the spec itself (the workflow lane
- * frames an empty `systemPrompt` with the workflow-subagent persona, so the preset must be written first, as
- * a custom persona to that frame); the delegation station's default rides the trusted internals channel
- * below the role chain, so prepare reads the preset there without this helper.
- */
-export declare function deploymentSubagentSystemPrompt(roles: ModelRoles | undefined): string | undefined;
 /**
  * The child run's THINKING seat — {@link childModelSeat}'s sister, the same rung order on the other axis
  * (#651): an EXPLICIT level for this spawn wins (the agent definition's `thinking`; a fork's explicit is the

package/dist/agents/child-model-seat.js

@@ -23,9 +23,6 @@ export function deploymentStatesSubagentModel(roles) {
 export function deploymentSubagentThinking(roles) {
     return subagentRolePresets(roles)?.thinking;
 }
-export function deploymentSubagentSystemPrompt(roles) {
-    return subagentRolePresets(roles)?.systemPrompt;
-}
 function subagentRolePresets(roles) {
     const s = roles?.subagent;
     if (s == null || typeof s === "string")

package/dist/agents/list-agents-tool.d.ts

@@ -1,7 +1,7 @@
 import { Type } from "typebox";
 import type { TaskAccess } from "../core/task-registry.js";
 import { type RosterEntry } from "./roster-store.js";
-import { type PeerDirectory, type PeerPresence, type PeerSessionRecord } from "./peer-directory.js";
+import { type PeerDirectory, type PeerPresence, type PeerSessionRecord, type PeerSessionWhere } from "./peer-directory.js";
 import type { SubagentTranscriptTier } from "../core/wiring-manifest.js";
 import { formatAgo, type AgentState, type AgentStateSource } from "../core/agent-state.js";
 import type { CheckpointSeat } from "../core/checkpoint-seat.js";
@@ -89,6 +89,8 @@ export interface ListAgentsRow {
     cwd?: string;
     /** Peer rows: the session's self-reported presence, when it reported any. */
     presence?: PeerPresence;
+    /** Peer rows: where the session runs, as the directory's row says it ({@link PeerSessionWhere}). */
+    where?: PeerSessionWhere;
     /** What SendMessage accepts: on both AGENT lanes the registry `task_id` VERBATIM (no prefixing or
      *  re-minting), never the child's session id — a different domain, tabled in INTEGRATION-CORE §1.6a.
      *  Peer rows carry the `session.<id>` box handle instead. */

package/dist/agents/list-agents-tool.js

@@ -3,7 +3,7 @@ import { defineTool } from "../core/tools.js";
 import { inlineUntrusted } from "../core/untrusted-text.js";
 import { formatPeerNameRef } from "./cross-session-ref.js";
 import { entryAccessible } from "./roster-store.js";
-import { mintPeerSessionCandidates, PEER_PRESENCE_MAX_CHARS, peerSessionBoxHandle } from "./peer-directory.js";
+import { listPeerDirectory, mintPeerSessionCandidates, PEER_PRESENCE_MAX_CHARS, PEER_SESSION_WHERE_LABELS, peerSessionBoxHandle } from "./peer-directory.js";
 import { PEER_LANE_DEFAULTS } from "./peer-admission.js";
 import { mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
 import { thrownText } from "../core/thrown-value.js";
@@ -45,8 +45,7 @@ const PEER_ROW_STATE = {
 function peerRowState(r) {
     if (r.liveness === "dead")
         return "offline";
-    const tempo = r.tempo;
-    return tempo !== undefined && Object.hasOwn(PEER_ROW_STATE, tempo) ? PEER_ROW_STATE[tempo] : "unknown";
+    return r.tempo !== undefined ? PEER_ROW_STATE[r.tempo] : "unknown";
 }
 function renderPresence(p) {
     const parts = [...(p.agent !== undefined ? [`agent=${inlineUntrusted(p.agent, PEER_PRESENCE_MAX_CHARS)}`] : []), ...(p.intent !== undefined ? [`intent=${inlineUntrusted(p.intent, PEER_PRESENCE_MAX_CHARS)}`] : [])];
@@ -66,7 +65,7 @@ export function createListAgentsTool(opts) {
         isConcurrencySafe: () => true,
         description: `List the agents${peers ? " and peer sessions" : ""} you can message with SendMessage. ` +
             (peers
-                ? `Peer sessions are other sessions of this engine running for the same user, shown as \`name [ref] · state · active <N> ago · <directory> · self: agent=…, intent=…\`; send to one with its name (or \`name [ref]\` ` +
+                ? `Peer sessions are other sessions of this engine running for the same user, shown as \`name [ref] · state · active <N> ago · <directory> · self: agent=…, intent=… · peer session <where>\` (where it runs: ${Object.values(PEER_SESSION_WHERE_LABELS).join(", or ")}); send to one with its name (or \`name [ref]\` ` +
                     `when a name is ambiguous, or its \`session.<id>\` address). By default only FRESH peers are listed (working now, or active within the last ${formatAgo(windowMs)}); ` +
                     `pass includeAll: true to also list stale and offline ones. A peer that is offline or unlisted still accepts messages — they are parked ` +
                     `durably in its session box and delivered when it next runs. `
@@ -84,7 +83,7 @@ export function createListAgentsTool(opts) {
             let directoryFault;
             if (opts.peerDirectory !== undefined) {
                 try {
-                    peerRows = await opts.peerDirectory.listPeerSessions({ scope: opts.self.scope });
+                    peerRows = await listPeerDirectory(opts.peerDirectory, { scope: opts.self.scope });
                 }
                 catch (e) {
                     directoryFault = thrownText(e);
@@ -108,6 +107,7 @@ export function createListAgentsTool(opts) {
                     ...(r.liveness === "live" ? { lastActiveAt: r.updatedAt } : r.diedAt !== undefined ? { offlineAt: r.diedAt } : {}),
                     ...(r.cwd !== undefined ? { cwd: cwdTail(r.cwd) } : {}),
                     ...(presence.agent !== undefined || presence.intent !== undefined ? { presence } : {}),
+                    where: r.where,
                 });
             }
             let registryCapped = false;
@@ -172,13 +172,13 @@ export function createListAgentsTool(opts) {
                 const age = r.kind !== "peer_session" ? undefined : r.lastActiveAt !== undefined ? `active ${formatAgo(now - r.lastActiveAt)} ago` : r.offlineAt !== undefined ? `offline ${formatAgo(now - r.offlineAt)} ago` : "offline";
                 const activity = r.agentState !== undefined ? agentActivityClause(r.agentState) : undefined;
                 const approval = r.agentState?.approval !== undefined ? agentApprovalClause(r.agentState.approval, r.agentState.readAt) : undefined;
-                const cols = [label, r.state, age, activity, approval, r.cwd !== undefined ? inlineUntrusted(r.cwd, 64) : undefined, r.presence !== undefined ? renderPresence(r.presence) : undefined, r.kind === "peer_session" ? "peer session" : r.kind === "roster" ? rosterLabel : "agent", r.address];
+                const cols = [label, r.state, age, activity, approval, r.cwd !== undefined ? inlineUntrusted(r.cwd, 64) : undefined, r.presence !== undefined ? renderPresence(r.presence) : undefined, r.kind === "peer_session" ? `peer session ${PEER_SESSION_WHERE_LABELS[r.where]}` : r.kind === "roster" ? rosterLabel : "agent", r.address];
                 return cols.filter((c) => c !== undefined).join("  ·  ");
             });
             const finishedCount = rows.filter((r) => r.state === "finished").length;
             const header = rows.length === 0 ? "No agents or peer sessions are listed right now." : `${rows.length} listed:`;
             const finishedNote = finishedCount > 0 ? `\n(${finishedCount} finished agent(s): continuable by SendMessage only ${finishedReach} — otherwise SendMessage answers with an honest refusal)` : "";
-            const fault = (directoryFault !== undefined ? `\n(peer-session directory unreadable: ${inlineUntrusted(directoryFault, 200)} — peer rows may be missing)` : "") +
+            const fault = (directoryFault !== undefined ? `\n(peer-session directory unreadable: ${inlineUntrusted(directoryFault, 200)} — no peer row is listed until its host fixes it)` : "") +
                 (registryCapped ? "\n(the live task list is at its 500-row window: older background agents may be missing from this listing — address them by task_id)" : "");
             let content = `${header}${lines.length > 0 ? `\n${lines.join("\n")}` : ""}${finishedNote}${fault}`;
             if (content.length > LIST_AGENTS_MAX_RESULT_CHARS)

package/dist/agents/peer-directory.d.ts

@@ -22,8 +22,20 @@ export declare function peerPresenceLabelValid(v: unknown): v is string | undefi
 /** Prepare's door: `TaskSpec.peerPresence` is a plain object whose `agent` / `intent` each pass {@link peerPresenceLabelValid}
  *  — else `config.peer_presence_invalid`, naming the field. */
 export declare function assertPeerPresenceValue(v: unknown): void;
+/**
+ * WHERE a peer session runs — the directory's word, like `liveness`. `this_machine` = a process on the ACCESSOR's
+ * machine, said only by a directory that reads that machine ({@link PeerDirectoryAccess} names a scope, not a
+ * machine); `hosted` = a session a hosting service runs, reached only through the store. `pid` / `procStartMs` /
+ * `sockPath` ride a `this_machine` row only ({@link readPeerSessionRecord}), so none of their readers reads `where` —
+ * for a row of plain data members: the reader does not snapshot an accessor member, which can answer differently per read.
+ */
+export declare const PEER_SESSION_WHERE_VALUES: readonly ["this_machine", "hosted"];
+export type PeerSessionWhere = (typeof PEER_SESSION_WHERE_VALUES)[number];
+/** THE wording of each value — the listing's kind column and the ambiguity error read this one table. */
+export declare const PEER_SESSION_WHERE_LABELS: Readonly<Record<PeerSessionWhere, string>>;
 /** The registration row. Field set = CC's load-bearing subset + sema's `scope` axis + the sema-only
- *  liveness/tombstone members. A host writes it; every terminal reads it through {@link readPeerSessionRecord}. */
+ *  liveness/tombstone/where members. A host writes it; every terminal reads it through {@link readPeerSessionRecord}
+ *  (the engine: {@link listPeerDirectory}; `peerDirectoryContract` checks a directory lists only rows it accepts). */
 export interface PeerSessionRecord {
     schemaVersion: number;
     /** The session's durable identity: its box address is `session.<sessionId>` ({@link peerSessionBoxHandle}). */
@@ -52,6 +64,8 @@ export interface PeerSessionRecord {
     liveness: PeerSessionLiveness;
     /** Present iff `liveness !== "live"`: when the row was marked dead (or the tombstone was written). */
     diedAt?: number;
+    /** Where the session runs ({@link PeerSessionWhere}) — the directory's word, never derived from the other members. */
+    where: PeerSessionWhere;
     /** The host's activity word. A stale `tempo` is the host's to clear: a row that says `active` is
      *  listed as fresh regardless of its age. */
     tempo?: PeerSessionTempo;
@@ -135,10 +149,10 @@ export interface PeerLivenessProbe {
 export declare const defaultPeerLivenessProbe: PeerLivenessProbe;
 /**
  * Is the row's process alive? `false` when the pid is gone, OR when the probe knows a start time and it
- * disagrees with the row's (PID reuse — a different process wears the number). A row with no pid has
- * no process to probe and is judged by its declared liveness alone.
+ * disagrees with the row's (PID reuse — a different process wears the number). A row with no LOCAL process
+ * (no pid, or not `this_machine`: its pid is not this machine's to signal) is judged by its declared liveness alone.
  */
-export declare function isPeerSessionProcessAlive(record: Pick<PeerSessionRecord, "pid" | "procStartMs" | "liveness">, probe?: PeerLivenessProbe): boolean;
+export declare function isPeerSessionProcessAlive(record: Pick<PeerSessionRecord, "pid" | "procStartMs" | "liveness" | "where">, probe?: PeerLivenessProbe): boolean;
 export interface PeerDirectoryAccess {
     /** The accessor's scope — rows of any other scope are never returned (§10 wall). */
     scope: string;
@@ -167,6 +181,10 @@ export interface PeerDirectory {
      */
     restorePeerSession?(record: PeerSessionRecord): boolean | Promise<boolean>;
 }
+/** THE engine's read of a directory: every listed row through {@link readPeerSessionRecord}. A row it refuses
+ *  faults the WHOLE listing (thrown, so each consumer's fault arm speaks), never a partial set — refs are minted and
+ *  names resolved over the full set, and dropping one row would change both. */
+export declare function listPeerDirectory(dir: PeerDirectory, access: PeerDirectoryAccess): Promise<PeerSessionRecord[]>;
 export interface PeerSessionCandidate {
     record: PeerSessionRecord;
     /** The listing-minted ref (6..12 hex) of this row — stable across the live/dead filter because it is

package/dist/agents/peer-directory.js

@@ -19,6 +19,12 @@ export function assertPeerPresenceValue(v) {
     e.code = "config.peer_presence_invalid";
     throw e;
 }
+export const PEER_SESSION_WHERE_VALUES = Object.freeze(["this_machine", "hosted"]);
+function isPeerSessionWhere(v) {
+    return PEER_SESSION_WHERE_VALUES.some((w) => w === v);
+}
+export const PEER_SESSION_WHERE_LABELS = Object.freeze({ this_machine: "on this machine", hosted: "hosted by the service" });
+const MACHINE_BOUND_MEMBERS = ["pid", "procStartMs", "sockPath"];
 export const SEMA_MAILBOX_FEATURE_PREFIX = "sema_mailbox_v1_";
 export function semaMailboxFeature(storeIdentity) {
     return `${SEMA_MAILBOX_FEATURE_PREFIX}${createHash("sha256").update(storeIdentity).digest("hex").slice(0, 16)}`;
@@ -109,6 +115,12 @@ export function readPeerSessionRecord(raw) {
     const inboundPosture = r["inboundPosture"];
     if (inboundPosture !== undefined && inboundPosture !== "available" && inboundPosture !== "unavailable")
         return bad("inboundPosture");
+    const where = r["where"];
+    if (!isPeerSessionWhere(where))
+        return bad("where");
+    const misplaced = where === "this_machine" ? undefined : MACHINE_BOUND_MEMBERS.find((k) => r[k] !== undefined);
+    if (misplaced !== undefined)
+        return bad(misplaced);
     const record = {
         schemaVersion: r["schemaVersion"],
         sessionId: r["sessionId"],
@@ -125,6 +137,7 @@ export function readPeerSessionRecord(raw) {
         updatedAt: r["updatedAt"],
         liveness,
         ...(r["diedAt"] !== undefined ? { diedAt: r["diedAt"] } : {}),
+        where,
         ...(tempo !== undefined ? { tempo } : {}),
         ...(r["entrypoint"] !== undefined ? { entrypoint: r["entrypoint"] } : {}),
         ...(r["peerProtocol"] !== undefined ? { peerProtocol: r["peerProtocol"] } : {}),
@@ -148,7 +161,7 @@ export const defaultPeerLivenessProbe = {
 export function isPeerSessionProcessAlive(record, probe = defaultPeerLivenessProbe) {
     if (record.liveness !== "live")
         return false;
-    if (record.pid === undefined)
+    if (record.pid === undefined || record.where !== "this_machine")
         return true;
     if (!probe.processExists(record.pid))
         return false;
@@ -159,6 +172,15 @@ export function isPeerSessionProcessAlive(record, probe = defaultPeerLivenessPro
     }
     return true;
 }
+export async function listPeerDirectory(dir, access) {
+    return (await dir.listPeerSessions(access)).map((raw) => {
+        const read = readPeerSessionRecord(raw);
+        if (read.ok)
+            return read.record;
+        const id = typeof raw?.sessionId === "string" ? inlineUntrusted(raw.sessionId, 80) : "(no session id)";
+        throw new Error(`the directory listed a row this engine cannot read (${id}: ${read.reason}${read.field !== undefined ? `: ${read.field}` : ""}); no peer row is used until its host fixes it`);
+    });
+}
 export function mintPeerSessionCandidates(records, self) {
     const entries = records.map((record) => ({ kind: "session", id: record.sessionId.toLowerCase(), record }));
     const selfEntry = self !== undefined && !records.some((r) => r.sessionId.toLowerCase() === self.sessionId.toLowerCase()) ? { kind: "session", id: self.sessionId.toLowerCase() } : undefined;
@@ -166,7 +188,7 @@ export function mintPeerSessionCandidates(records, self) {
 }
 function describeCandidate(c) {
     const state = c.record.liveness === "live" ? "" : c.record.liveness === "dead" ? " (offline)" : " (deleted)";
-    return `${formatPeerNameRef(inlineUntrusted(c.record.name, 64), c.ref)}${state} → ${peerSessionBoxHandle(c.record.sessionId)}`;
+    return `${formatPeerNameRef(inlineUntrusted(c.record.name, 64), c.ref)}${state}, ${PEER_SESSION_WHERE_LABELS[c.record.where]} → ${peerSessionBoxHandle(c.record.sessionId)}`;
 }
 export function resolvePeerSessions(records, to, self) {
     const candidates = mintPeerSessionCandidates(records, self);

package/dist/agents/peer-session-drain.js

@@ -7,7 +7,7 @@ import { deliverEngineNotice } from "../core/types.js";
 import { buildCrossSessionEnvelope, CrossSessionCodecError, encodePeerAddress } from "./cross-session-envelope.js";
 import { judgeCrossSessionInbound, principalInboundLayers, resolveCrossSessionInboundSetting } from "./cross-session-judge.js";
 import { judgePeerAdmission, peerAxisToken, resolvePeerLaneConfig } from "./peer-admission.js";
-import { isPeerSessionId, PEER_SESSION_ID_GRAMMAR, peerSessionBoxHandle } from "./peer-directory.js";
+import { isPeerSessionId, listPeerDirectory, PEER_SESSION_ID_GRAMMAR, peerSessionBoxHandle } from "./peer-directory.js";
 import { inlineUntrusted } from "../core/untrusted-text.js";
 import { createListAgentsTool, LIST_AGENTS_TOOL_ALIAS, LIST_AGENTS_TOOL_NAME } from "./list-agents-tool.js";
 import { foldPermissionModeClass } from "./cross-session-judge.js";
@@ -830,7 +830,7 @@ export function bindPeerLaneDrain(harness, args) {
         if (deps.peerDirectory === undefined)
             return;
         try {
-            const rows = await deps.peerDirectory.listPeerSessions({ scope: args.scope });
+            const rows = await listPeerDirectory(deps.peerDirectory, { scope: args.scope });
             rowName = rows.find((r) => r.sessionId.toLowerCase() === args.sessionId.toLowerCase())?.name;
         }
         catch {

package/dist/agents/repair-loop.js

@@ -48,7 +48,7 @@ export async function runRepairLoop(runner, implSpec, config) {
         const oracle = { tier: "none", passed: false, flaky: false, retries: 0 };
         return {
             taskId: implSpec.taskId ?? "",
-            result: `oracle isolation check failed: ${reason}`,
+            result: `oracle isolation check failed: ${reason}`, resultEntryIds: [],
             terminal: { kind: "failed", code: "oracle.unprotected", message: `oracle isolation check failed: ${reason}` },
             sessionId: "",
             stats: { tokens: 0, turns: 0, costMicroUsd: 0 },
@@ -160,7 +160,7 @@ export async function runRepairLoop(runner, implSpec, config) {
     };
     const exhaustedBeforeDispatch = (message, errorCode) => ({
         taskId: implSpec.taskId ?? "",
-        result: message ?? `repair loop: attempt budget already spent (attemptCount ${bundle.attemptCount} >= maxAttempts ${maxAttempts}) — no attempt dispatched`,
+        result: message ?? `repair loop: attempt budget already spent (attemptCount ${bundle.attemptCount} >= maxAttempts ${maxAttempts}) — no attempt dispatched`, resultEntryIds: [],
         terminal: { kind: "failed", code: errorCode ?? "repair.attempts_exhausted", message: message ?? `repair loop: attempt budget already spent (attemptCount ${bundle.attemptCount} >= maxAttempts ${maxAttempts}) — no attempt dispatched` },
         sessionId: implSpec.sessionId ?? "",
         stats: { tokens: 0, turns: 0, costMicroUsd: 0 },

package/dist/agents/send-message-tool.js

@@ -6,7 +6,7 @@ import { announceTranscriptIntegrityGapOnce, canAccessAgentRecord, clearRevivedR
 import { uuidv7 } from "../internal/harness.js";
 import { MAILBOX_TOMBSTONED_RECIPIENT_CODE, mailboxCrossProcessMountVerdict } from "../core/mailbox-store.js";
 import { peerSendVerdictSeverity } from "./cross-session-judge.js";
-import { parsePeerSessionAddress, peerSessionBoxHandle, peerSessionLane, resolvePeerSessions } from "./peer-directory.js";
+import { listPeerDirectory, parsePeerSessionAddress, peerSessionBoxHandle, peerSessionLane, resolvePeerSessions } from "./peer-directory.js";
 import { peerIdleMachineFor } from "./peer-idle.js";
 import { PEER_IDLE_OUTSTANDING_CAP, PEER_IDLE_SUBSCRIPTION_TTL_MS, peerIdleNoticeLabel } from "./peer-notices.js";
 import { escapeAttributeValue, escapeEnvelopeTag, isObserverTaskId, OBSERVER_SENDMESSAGE_SENDER_REFUSAL, OBSERVER_SENDMESSAGE_TARGET_REFUSAL, } from "./observer.js";
@@ -263,7 +263,7 @@ export function createSendMessageTool(opts) {
             let ownRowName;
             const resolvePeerTarget = async () => {
                 try {
-                    const rows = await opts.peerDirectory.listPeerSessions({ scope: peerScope ?? "" });
+                    const rows = await listPeerDirectory(opts.peerDirectory, { scope: peerScope ?? "" });
                     if (peerSelfSessionId !== undefined)
                         ownRowName = rows.find((r) => r.sessionId.toLowerCase() === peerSelfSessionId.toLowerCase())?.name;
                     return resolvePeerSessions(rows, to, peerSelfSessionId !== undefined ? { sessionId: peerSelfSessionId } : undefined);
@@ -349,7 +349,7 @@ export function createSendMessageTool(opts) {
                 const doorbell = opts.peerChannel !== undefined && record.sockPath !== undefined && record.liveness === "live" && (seq !== undefined || subscriptionSeq !== undefined) ? await opts.peerChannel.nudge(record.sockPath).catch(() => false) : undefined;
                 let rowRestored = "present";
                 try {
-                    const rowsNow = await opts.peerDirectory.listPeerSessions({ scope: peerScope });
+                    const rowsNow = await listPeerDirectory(opts.peerDirectory, { scope: peerScope });
                     const nowRow = rowsNow.find((r) => r.sessionId.toLowerCase() === record.sessionId.toLowerCase());
                     if (nowRow?.liveness === "deleted")
                         rowRestored = "deleted_meanwhile";
@@ -906,7 +906,7 @@ export function createSendMessageTool(opts) {
                             (suggestion !== undefined ? ` Did you mean: ${suggestion}?` : "") +
                             (labels.length > 0 ? ` Running background agents: ${labels.join(", ")}.` : "") +
                             ` Reachable from here: ${reachable.join("; ").slice(0, 300)}.` +
-                            ` Note: a completed foreground agent is not resumable (its transcript is not retained) — spawn with run_in_background to keep an agent addressable, or launch a new agent.`,
+                            ` Note: a completed foreground agent is not addressable (nothing retains its transcript) — name an agent or run it in the background to keep it addressable (a named agent always runs in the background), or launch a new agent.`,
                         details: { error: "not_found", to, ...(suggestion !== undefined ? { suggestion } : {}) },
                         isError: true,
                     };

package/dist/agents/subagent.d.ts

@@ -168,9 +168,6 @@ export interface SubagentWorktreeIsolation {
     /** CC "auto-cleaned if unchanged": remove the worktree when clean, keep it when the child made changes. */
     finish(worktreeDir: string): Promise<"pruned" | "kept">;
 }
-/** Is `result` one of the delegation tool's refusals before any child ran ({@link notStartedResult})? The brand only: the identity
- *  of its `details` object, never what the result says. */
-export declare function isNotStartedDelegationResult(result: unknown): boolean;
 /**
  * Build the {@link SubagentWorktreeIsolation} helper over a base env + repo root. Called by `prepare-task`
  * (closure over the run's ExecutionEnv/taskRootPath — trusted, mirrors the scheduler/fork mounts). The
@@ -672,10 +669,15 @@ export interface SubagentToolOptions {
     allowTools?: string[];
     /** Tool-level denylist (design/38 1A), used when no `agent` is selected: the denied half of the child's own selector layer (a deny wins). */
     denyTools?: string[];
-    /** System prompt / persona for the child. Default (since 1.259.0): the LEAN
+    /** System prompt / persona for the child, by TEXT — the child's own role-base statement, written on its task seat (an
+     *  agent definition's `systemPrompt` wins over it). Default (since 1.259.0): the LEAN
      *  {@link SUBAGENT_PROMPT} (agent persona + return contract), NOT the full default constitution role
      *  base — pass `DEFAULT_SYSTEM_PROMPT` here explicitly to restore the pre-1.259 behavior. */
     systemPrompt?: string;
+    /** The child's role base by WORD (`TaskSpec.promptRole`'s closed set: `"code"` gives the children the catalog's coding
+     *  base): the same seat as {@link systemPrompt} (text beside it replaces the base this word selects) — so a role
+     *  preset never overtakes it. Outside the closed set ⇒ refused when the tool is built (`config.prompt_selector_invalid`). */
+    promptRole?: import("../prompt-assembly/catalog/schema.js").HostRole;
     /** Tool name exposed to the parent. Default "Agent". */
     name?: string;
     /** What the child is for (shown to the parent in the tool description). */