@goah/cli 0.13.2 → 0.13.4

package/dist/{dist-KNR2XL6J.js → dist-QW77PKUJ.js}

@@ -15,7 +15,7 @@ import {
   renderDashboard,
   runSupervisorDaemon,
   selectRecoveryEvents
-} from "./chunk-QBD6EJ2Z.js";
+} from "./chunk-SQJZ5OFH.js";
 import "./chunk-4KA63VNZ.js";
 import "./chunk-KAO7WIXG.js";
 import "./chunk-R6I3VKME.js";

package/dist/execution.d.ts

@@ -304,6 +304,7 @@ type HandoffValidationResult = {
     token: string;
     goalId: string;
     goalRevision: number;
+    messageItemId: string;
 } | {
     accepted: false;
     fatal: boolean;
@@ -312,6 +313,7 @@ type HandoffValidationResult = {
 };
 interface HandoffValidationRequest {
     handoff: AgentHandoff;
+    candidateMessageId: string;
     candidateMessage: string;
 }
 interface TurnOutput {
@@ -418,9 +420,6 @@ interface TurnContext {
     activeGoal: GoalSnapshot | null;
     goalCommitment: GoalCommitment | null;
 }
-interface AssistantResponse {
-    content: string;
-}
 /** Canonical user-visible assistant prose. Raw provider events remain unchanged. */
 declare function normalizeAssistantText(text: string): string;
 interface RunRequest {
@@ -436,7 +435,7 @@ interface RunRequest {
 }
 type RunnerCandidateResult = {
     outcome: "completed";
-    response: AssistantResponse;
+    finalMessageId: string;
     handoff?: TurnOutput;
 } | {
     outcome: "abnormal";
@@ -514,7 +513,8 @@ interface Ledger extends EventStore {
     renewTurnLease(id: string, leaseToken: string, leaseUntil: string, now: string): TurnSnapshot;
     appendTurnEvent(input: EventInput, leaseToken: string): EventRecord;
     repairTurnAttempt(id: string, reason: string, now: string, actor: string): TurnItemSnapshot[];
-    finishTurn(id: string, status: "completed" | "failed" | "interrupted", error: JsonValue | null, now: string, actor: string, mailIds?: string[]): TurnSnapshot;
+    finishTurn(id: string, status: "failed" | "interrupted", error: JsonValue, now: string, actor: string): TurnSnapshot;
+    commitTurnResponse(id: string, responseItemId: string, now: string, actor: string, mailIds?: string[]): TurnSnapshot;
     releaseTurnProcess(id: string, actor: string): TurnSnapshot;
     putMail(mail: MailSnapshot, actor: string, wakeId?: string): EventRecord;
     putMails(mail: MailSnapshot[], actor: string, wakeId?: string): EventRecord[];
@@ -554,4 +554,4 @@ declare function assertTurnOutput(value: TurnOutput): void;
 declare function assertGoalSnapshot(value: GoalSnapshot): void;
 
 export { assertAgentHandoff, assertGoalSnapshot, assertGoalTransition, assertHandoff, assertTurnOutput, assertWakeTransition, goalAutomaticTarget, goalCommitment, goalRoute, humanInboxRoute, humanRequestRoute, noGoalCommitment, normalizeAssistantText, specialistAutomaticTarget, specialistInboxRoute };
-export type { AgentCapability, AgentHandoff, AgentProfile, AgentRole, AssistantResponse, AutomaticTarget, CommittedTurnOutput, DelegationRequest, DelegationResult, GoalChangeAuthority, GoalChangeMetadata, GoalChangeOperation, GoalChangedData, GoalCommitment, GoalCompletionRequest, GoalHandoff, GoalOutcome, GoalPhase, GoalSnapshot, Handoff, HandoffCommit, HandoffValidationIssue, HandoffValidationRequest, HandoffValidationResult, HumanTurnAdmissionRequest, HumanTurnAdmissionResult, Ledger, MailLevel, MailRoute, MailSnapshot, ReassignmentRequest, ReassignmentResult, RunRequest, Runner, RunnerCandidateResult, RunnerChoice, RunnerCommandResult, RunnerConfigurator, RunnerControlMethod, RunnerDiagnostic, RunnerHandle, RunnerManifest, RunnerProfile, RunnerRpcMethod, RunnerSetupInteraction, RunnerSetupProgress, RunnerSetupTransaction, RunnerTraceEvent, ScheduleSnapshot, ScheduleStatus, SpecialistRole, TeamMemberMotion, TeamMemberView, ThreadSnapshot, TurnContext, TurnItemSnapshot, TurnItemStatus, TurnItemType, TurnOutput, TurnSnapshot, TurnStatus, TurnTrigger, TurnTriggerKind, WakeSnapshot, WakeStatus, WakeTriggerSnapshot, WakeTriggerStatus, WorkRecordDiff, WorkRecordSnapshot, WorkRecordUpdateRequest };
+export type { AgentCapability, AgentHandoff, AgentProfile, AgentRole, AutomaticTarget, CommittedTurnOutput, DelegationRequest, DelegationResult, GoalChangeAuthority, GoalChangeMetadata, GoalChangeOperation, GoalChangedData, GoalCommitment, GoalCompletionRequest, GoalHandoff, GoalOutcome, GoalPhase, GoalSnapshot, Handoff, HandoffCommit, HandoffValidationIssue, HandoffValidationRequest, HandoffValidationResult, HumanTurnAdmissionRequest, HumanTurnAdmissionResult, Ledger, MailLevel, MailRoute, MailSnapshot, ReassignmentRequest, ReassignmentResult, RunRequest, Runner, RunnerCandidateResult, RunnerChoice, RunnerCommandResult, RunnerConfigurator, RunnerControlMethod, RunnerDiagnostic, RunnerHandle, RunnerManifest, RunnerProfile, RunnerRpcMethod, RunnerSetupInteraction, RunnerSetupProgress, RunnerSetupTransaction, RunnerTraceEvent, ScheduleSnapshot, ScheduleStatus, SpecialistRole, TeamMemberMotion, TeamMemberView, ThreadSnapshot, TurnContext, TurnItemSnapshot, TurnItemStatus, TurnItemType, TurnOutput, TurnSnapshot, TurnStatus, TurnTrigger, TurnTriggerKind, WakeSnapshot, WakeStatus, WakeTriggerSnapshot, WakeTriggerStatus, WorkRecordDiff, WorkRecordSnapshot, WorkRecordUpdateRequest };

package/dist/faux-runner-worker.js

@@ -2,7 +2,7 @@ import { createRequire as __goahCreateRequire } from "node:module";
 const require = __goahCreateRequire(import.meta.url);
 import {
   runProcessWorker
-} from "./chunk-7E7V6OIU.js";
+} from "./chunk-EK6BTCFG.js";
 import "./chunk-6M3OOCKO.js";
 import "./chunk-K26BVR6O.js";
 import "./chunk-IIJQ3DW4.js";
@@ -32,6 +32,7 @@ await runProcessWorker(async (request, emit, rpc) => {
   const steps = triggerSteps ?? byAgent[request.agent] ?? JSON.parse(process.env.GOAH_FAUX_STEPS ?? "[]");
   let goalCommitment = request.turn?.goalCommitment;
   let recordUpdated = false;
+  let messageSequence = 0;
   for (const step of steps) {
     if (step.write) {
       const path = join(process.cwd(), step.write.path);
@@ -54,8 +55,11 @@ await runProcessWorker(async (request, emit, rpc) => {
       await new Promise((resolve) => setTimeout(resolve, step.delayMs));
     if (step.hang)
       await new Promise(() => void 0);
-    if (step.response !== void 0)
-      return { outcome: "completed", response: { content: step.response } };
+    if (step.response !== void 0) {
+      const finalMessageId = `faux:${request.execution.id}:attempt:${request.execution.attempt}:message:${++messageSequence}`;
+      emit({ type: "message.assistant.completed", data: { message: { id: finalMessageId, role: "assistant", content: [{ type: "text", text: step.response }] }, commitState: "committed" } });
+      return { outcome: "completed", finalMessageId };
+    }
     if (step.handoff) {
       const draft = step.handoff;
       if (goalCommitment && !recordUpdated) {
@@ -64,16 +68,19 @@ await runProcessWorker(async (request, emit, rpc) => {
         const evidence = sourceSeqs(request.context);
         await rpc("work_record.update", { expectedRevision: Number(record.recordRevision ?? 0), content: handoffRecord(draft.handoff, request.execution.id), reason: "record faux Goal progress", evidence: evidence.length ? [Math.max(...evidence)] : [] });
       }
-      const validation = await rpc("goal.handoff.validate", { handoff: draft.handoff, candidateMessage: draft.response.content });
-      emit({ type: "message.assistant.completed", data: { message: { id: `faux:${request.execution.id}:handoff:${validation.attemptId}`, role: "assistant", content: [{ type: "text", text: draft.response.content }], stopReason: "toolUse" }, commitState: "provisional" } });
+      const messageItemId = `faux:${request.execution.id}:attempt:${request.execution.attempt}:message:${++messageSequence}`;
+      const validation = await rpc("goal.handoff.validate", { handoff: draft.handoff, candidateMessageId: messageItemId, candidateMessage: draft.response.content });
+      emit({ type: "message.assistant.completed", data: { message: { id: messageItemId, role: "assistant", content: [{ type: "text", text: draft.response.content }], stopReason: "toolUse" }, commitState: "provisional" } });
       if (!validation.accepted) {
         emit({ type: "runner.handoff_rejected", data: { attemptId: validation.attemptId, issues: validation.issues } });
         if (validation.fatal)
           return { outcome: "abnormal", reason: validation.issues.map((issue) => issue.message).join("; ") };
         continue;
       }
+      if (validation.messageItemId !== messageItemId)
+        return { outcome: "abnormal", reason: "Handoff validation returned a different assistant message identity" };
       const output = { validationAttemptId: validation.attemptId, validationToken: validation.token, handoff: draft.handoff };
-      return { outcome: "completed", response: draft.response, handoff: output };
+      return { outcome: "completed", finalMessageId: messageItemId, handoff: output };
     }
   }
   return { outcome: "abnormal", reason: "faux worker stopped without handoff" };

package/dist/index.d.ts

@@ -337,9 +337,6 @@ interface TurnContext {
     activeGoal: GoalSnapshot | null;
     goalCommitment: GoalCommitment | null;
 }
-interface AssistantResponse {
-    content: string;
-}
 interface RunRequest {
     agent: string;
     execution: TurnSnapshot;
@@ -353,7 +350,7 @@ interface RunRequest {
 }
 type RunnerCandidateResult = {
     outcome: "completed";
-    response: AssistantResponse;
+    finalMessageId: string;
     handoff?: TurnOutput;
 } | {
     outcome: "abnormal";
@@ -431,7 +428,8 @@ interface Ledger extends EventStore {
     renewTurnLease(id: string, leaseToken: string, leaseUntil: string, now: string): TurnSnapshot;
     appendTurnEvent(input: EventInput, leaseToken: string): EventRecord;
     repairTurnAttempt(id: string, reason: string, now: string, actor: string): TurnItemSnapshot[];
-    finishTurn(id: string, status: "completed" | "failed" | "interrupted", error: JsonValue | null, now: string, actor: string, mailIds?: string[]): TurnSnapshot;
+    finishTurn(id: string, status: "failed" | "interrupted", error: JsonValue, now: string, actor: string): TurnSnapshot;
+    commitTurnResponse(id: string, responseItemId: string, now: string, actor: string, mailIds?: string[]): TurnSnapshot;
     releaseTurnProcess(id: string, actor: string): TurnSnapshot;
     putMail(mail: MailSnapshot, actor: string, wakeId?: string): EventRecord;
     putMails(mail: MailSnapshot[], actor: string, wakeId?: string): EventRecord[];
@@ -518,7 +516,8 @@ declare class SqliteLedger implements Ledger {
     renewTurnLease(id: string, leaseToken: string, leaseUntil: string, now: string): TurnSnapshot;
     appendTurnEvent(input: EventInput, leaseToken: string): EventRecord;
     repairTurnAttempt(id: string, reason: string, now: string, actor: string): TurnItemSnapshot[];
-    finishTurn(id: string, status: "completed" | "failed" | "interrupted", error: JsonValue | null, now: string, actor: string, mailIds?: string[]): TurnSnapshot;
+    finishTurn(id: string, status: "failed" | "interrupted", error: JsonValue, now: string, actor: string): TurnSnapshot;
+    commitTurnResponse(id: string, responseItemId: string, now: string, actor: string, mailIds?: string[]): TurnSnapshot;
     releaseTurnProcess(id: string, actor: string): TurnSnapshot;
     putMail(mail: MailSnapshot, actor: string, wakeId?: string): EventRecord;
     putMails(mails: MailSnapshot[], actor: string, wakeId?: string): EventRecord[];

package/dist/index.js

@@ -31,11 +31,11 @@ import {
   updateWorkspaceRunnerProfile,
   writeDefaultConfig,
   writeDefaultRunnerProfile
-} from "./chunk-KJ4HJCTK.js";
-import "./chunk-D2DVAH37.js";
-import "./chunk-YH6YJ2IB.js";
-import "./chunk-QBD6EJ2Z.js";
-import "./chunk-7E7V6OIU.js";
+} from "./chunk-5PZFP5CO.js";
+import "./chunk-R6GKCNTB.js";
+import "./chunk-CDELLMIJ.js";
+import "./chunk-SQJZ5OFH.js";
+import "./chunk-EK6BTCFG.js";
 import "./chunk-6M3OOCKO.js";
 import "./chunk-K26BVR6O.js";
 import "./chunk-IIJQ3DW4.js";

package/dist/pi-worker.js

@@ -5,7 +5,7 @@ import {
 } from "./chunk-XALZLRYK.js";
 import {
   runProcessWorker
-} from "./chunk-7E7V6OIU.js";
+} from "./chunk-EK6BTCFG.js";
 import {
   createPiModel,
   fauxAssistantMessage,
@@ -35,6 +35,9 @@ import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { delimiter, dirname, join, resolve, sep } from "node:path";
 import { homedir, tmpdir } from "node:os";
 import { fileURLToPath } from "node:url";
+var GOAL_TURN_POLICY = `A Goal commitment starts a sustained work session, not a short status round. Continue working while any safe, useful action can be executed now with current tools and authority. Use the Work Record as a durable checkpoint whenever the semantic state changes; updating it does not end the Turn. Planning, partial progress, decomposition, or scheduling a future Wake are not by themselves reasons to stop. Before Handoff, ask whether another useful action can be completed without new authority, unavailable data, another Agent's result, or the passage of time; if yes, do it now.
+
+Call handoff exactly once, only at a genuine control boundary: the current actionable frontier is exhausted after meaningful work, an explicit external wait is required, a real blocker prevents safe progress, or completion evidence is ready for review. Use outcome progress only for the first case, waiting only for the second, blocked only for the third, and completion_proposed only for the fourth. Write a concise human-readable assistant message describing what happened, and keep Handoff machine-readable with only outcome and evidence. Treat the supplied context as authoritative.`;
 function compactMessages(messages, maxRecent = 8) {
   if (messages.length <= maxRecent + 1)
     return messages;
@@ -100,8 +103,10 @@ Follow the current Goal and explicit tools.
 `;
         const finalResponse = fauxAssistantMessage([fauxText(String(handoff.message ?? `Goal work recorded with outcome ${outcome}.`)), fauxToolCall("handoff", { outcome, evidence: handoffEvidence })], { stopReason: "toolUse" });
         const recordResponse = fauxAssistantMessage(fauxToolCall("work_record_update", { expectedRevision: Number(current.recordRevision ?? 0), content: record, reason: "record faux Goal progress", evidence: evidence.length ? [Math.max(...evidence)] : [] }), { stopReason: "toolUse" });
+        const narratedScheduleResponse = fauxAssistantMessage([fauxText(String(handoff.message ?? "Work Record updated; the next wake is scheduled.")), fauxToolCall("schedule_wake", { at: new Date(Date.parse(request.execution.startedAt) + 6e4).toISOString(), reason: "continue Goal work" })], { stopReason: "toolUse" });
+        const toolOnlyHandoff = fauxAssistantMessage(fauxToolCall("handoff", { outcome, evidence: handoffEvidence }), { stopReason: "toolUse" });
         const fatalBatch = fauxAssistantMessage([fauxText("Stale completion attempt."), fauxToolCall("handoff", { outcome, evidence: handoffEvidence }), fauxToolCall("write", { path: "fatal.txt", content: "must not be written" })], { stopReason: "toolUse" });
-        faux.setResponses(process.env.GOAH_PI_FAUX_FATAL_BATCH === "1" ? [fatalBatch] : process.env.GOAH_PI_FAUX_HANDOFF_REPAIR === "1" ? [fauxAssistantMessage([fauxText("Premature completion attempt."), fauxToolCall("handoff", { outcome, evidence: handoffEvidence })], { stopReason: "toolUse" }), recordResponse, finalResponse] : [recordResponse, finalResponse]);
+        faux.setResponses(process.env.GOAH_PI_FAUX_FATAL_BATCH === "1" ? [fatalBatch] : process.env.GOAH_PI_FAUX_HANDOFF_REPAIR === "1" ? [fauxAssistantMessage([fauxText("Premature completion attempt."), fauxToolCall("handoff", { outcome, evidence: handoffEvidence })], { stopReason: "toolUse" }), recordResponse, finalResponse] : process.env.GOAH_PI_FAUX_TOOL_ONLY_HANDOFF === "1" ? [recordResponse, narratedScheduleResponse, toolOnlyHandoff] : [recordResponse, finalResponse]);
       } else if (!goalState.bound) {
         faux.setResponses([fauxAssistantMessage([fauxText(process.env.GOAH_PI_FAUX_RESPONSE ?? "Hello from Goah.")])]);
       } else {
@@ -113,7 +118,7 @@ Follow the current Goal and explicit tools.
     let output = null;
     let acceptedHandoff = null;
     let revokedReason = "";
-    let response = "";
+    let lastReadableMessage = null;
     let responseFailure = "";
     let compactions = 0;
     let messageCounter = 0;
@@ -125,7 +130,7 @@ Follow the current Goal and explicit tools.
       const existing = messageIds.get(message);
       if (existing)
         return existing;
-      const id = `message:${++messageCounter}`;
+      const id = `${request.execution.id}:attempt:${request.execution.attempt}:message:${++messageCounter}`;
       messageIds.set(message, id);
       return id;
     };
@@ -145,8 +150,11 @@ Follow the current Goal and explicit tools.
     const sourceSeqs = Array.isArray(contextRecord.sourceSeqs) ? contextRecord.sourceSeqs.filter((value) => Number.isInteger(value)) : [];
     const basePrompt = process.env.GOAH_PI_SYSTEM_PROMPT ?? suppliedPrompt ?? (request.turn?.trigger.kind === "user_message" ? "You are Goah's primary Agent. Respond naturally to the Human." : `You are Goah Agent ${request.agent}. Inspect the supplied context and respond appropriately.`);
     const systemPrompt = goalState.bound ? `${basePrompt}
-This Turn has a Goal commitment. You must update its Work Record, write a concise human-readable assistant message describing what happened, and call handoff exactly once with only machine-readable outcome and evidence. The message and Handoff are separate outputs. Treat the supplied context as authoritative.` : request.turn?.trigger.kind === "user_message" ? `${basePrompt}
-The active Goal, when supplied, is context rather than an assignment. Finish with an ordinary response unless a Goal tool establishes a commitment during this Turn. After commitment, update that Goal's Work Record, write a concise human-readable assistant message, and call handoff exactly once with separate machine-readable outcome and evidence. Treat the supplied context as authoritative.` : `${basePrompt}
+
+${GOAL_TURN_POLICY}` : request.turn?.trigger.kind === "user_message" ? `${basePrompt}
+The active Goal, when supplied, is context rather than an assignment. Finish with an ordinary response unless a Goal tool establishes a commitment during this Turn. If a Goal commitment is established, follow this policy for the rest of the Turn:
+
+${GOAL_TURN_POLICY}` : `${basePrompt}
 This Turn has no Goal commitment. Finish with an ordinary response and do not call handoff. Treat the supplied context as authoritative.`;
     const agent = new Agent({
       initialState: {
@@ -196,10 +204,16 @@ This Turn has no Goal commitment. Finish with an ordinary response and do not ca
         acceptedHandoff = null;
         output = null;
         const handoff = args;
+        const currentText = assistantResponseText(assistantMessage);
+        const candidate = currentText ? { id: idFor(assistantMessage), text: currentText } : lastReadableMessage;
         try {
-          const result = await rpc("goal.handoff.validate", { handoff, candidateMessage: assistantResponseText(assistantMessage) });
+          const result = await rpc("goal.handoff.validate", { handoff, candidateMessageId: candidate?.id ?? "", candidateMessage: candidate?.text ?? "" });
           if (result.accepted) {
-            acceptedHandoff = { attemptId: result.attemptId, token: result.token, handoff };
+            if (!candidate || result.messageItemId !== candidate.id) {
+              revokedReason = "Handoff validation returned a different assistant message identity";
+              return { block: true, reason: revokedReason, terminate: true };
+            }
+            acceptedHandoff = { attemptId: result.attemptId, token: result.token, messageItemId: result.messageItemId, handoff };
             return;
           }
           const reason = result.issues.map((issue) => `- ${issue.message}`).join("\n");
@@ -234,11 +248,14 @@ ${reason}`, terminate: result.fatal };
       } else if (event.type === "message_update") {
         emit({ type: "message.assistant.delta", data: { messageId: idFor(event.message), delta: JSON.parse(JSON.stringify(event.assistantMessageEvent)) } });
       } else if (event.type === "message_end" && event.message.role === "assistant") {
-        response = assistantResponseText(event.message);
+        const messageId = idFor(event.message);
+        const text = assistantResponseText(event.message);
+        if (text)
+          lastReadableMessage = { id: messageId, text };
         if ((event.message.stopReason === "error" || event.message.stopReason === "aborted") && event.message.errorMessage)
           responseFailure = event.message.errorMessage;
         const handoffIntent = hasAgentToolCall(event.message, "handoff");
-        emit({ type: "message.assistant.completed", data: { message: transcriptMessage(event.message, idFor(event.message)), commitState: handoffIntent ? "provisional" : "committed" } });
+        emit({ type: "message.assistant.completed", data: { message: transcriptMessage(event.message, messageId), commitState: handoffIntent ? "provisional" : "committed" } });
       } else if (event.type === "tool_execution_start")
         emit({ type: "tool.called", data: { callId: event.toolCallId, name: event.toolName, arguments: JSON.parse(JSON.stringify(event.args)) } });
       else if (event.type === "tool_execution_end")
@@ -262,13 +279,17 @@ Runner root: ${root}. Manage local files directly when the goal requires them.`)
     }
     if (revokedReason)
       return { outcome: "abnormal", reason: revokedReason };
+    const finalMessage = lastReadableMessage;
     if (!goalState.bound)
-      return response ? { outcome: "completed", response: { content: response } } : { outcome: "abnormal", reason: responseFailure || "Pi worker exited without a response" };
+      return finalMessage ? { outcome: "completed", finalMessageId: finalMessage.id } : { outcome: "abnormal", reason: responseFailure || "Pi worker exited without a response" };
     if (responseFailure)
       return { outcome: "abnormal", reason: responseFailure };
     if (!output)
       return { outcome: "abnormal", reason: "Pi worker exited without an accepted Handoff" };
-    return { outcome: "completed", response: { content: response }, handoff: output };
+    const finalHandoff = acceptedHandoff;
+    if (!finalHandoff)
+      return { outcome: "abnormal", reason: "Pi worker exited without an accepted Handoff message" };
+    return { outcome: "completed", finalMessageId: finalHandoff.messageItemId, handoff: output };
   });
 }
 function snapshotModelConfig(options) {
@@ -294,7 +315,7 @@ function createTools(root, handoff, rpc, capabilities, goalState, protectedPaths
   const handoffTool = {
     name: "handoff",
     label: "Handoff",
-    description: "Record a structured handoff and end a Turn with a Goal commitment.",
+    description: "End the current Goal Turn at a genuine control boundary. Do not call while another safe and useful action can be completed now. Planning, partial progress, a Work Record update, or a scheduled Wake does not by itself justify Handoff.",
     parameters: typebox_exports.Object({
       outcome: typebox_exports.Union([typebox_exports.Literal("progress"), typebox_exports.Literal("waiting"), typebox_exports.Literal("blocked"), typebox_exports.Literal("completion_proposed")]),
       evidence: typebox_exports.Array(typebox_exports.Number())
@@ -488,7 +509,7 @@ function createRpcTools(rpc, allowed, onResult) {
     ["ledger.search", tool("ledger_search", "Search durable ledger facts.", "ledger.search", typebox_exports.Object({ query: typebox_exports.String(), limit: typebox_exports.Optional(typebox_exports.Number()) }))],
     ["memory.append", tool("memory_append", "Append a durable working-memory note that is injected into your future wakes. Record procedural knowledge, active hypotheses, and abandoned approaches with the reason; keep notes concise.", "memory.append", typebox_exports.Object({ note: typebox_exports.String() }))],
     ["mail.send", tool("send_mail", "Send durable Mail to another Goal owner. goalId is required and routes the Mail into that owner's next committed Turn. Human communication must use request_human.", "mail.send", typebox_exports.Object({ to: typebox_exports.String(), goalId: typebox_exports.String(), level: typebox_exports.Union([typebox_exports.Literal("fyi"), typebox_exports.Literal("decision"), typebox_exports.Literal("emergency")]), body: typebox_exports.Any() }))],
-    ["schedule.set", tool("schedule_wake", "Schedule this agent's next wake.", "schedule.set", typebox_exports.Object({ at: typebox_exports.String(), reason: typebox_exports.String() }))],
+    ["schedule.set", tool("schedule_wake", "Schedule genuinely time-dependent future observation. Scheduling does not end the current Turn; continue all useful work that can be completed before waiting.", "schedule.set", typebox_exports.Object({ at: typebox_exports.String(), reason: typebox_exports.String() }))],
     ["team.list", tool("team_list", "Read the ledger-derived team roster and liveness state.", "team.list", typebox_exports.Object({}))],
     ["goal.get", tool("get_goal", "Read the active Goal visible to this Turn. Visibility does not establish a Goal commitment.", "goal.get", typebox_exports.Object({}))],
     ["goal.create", tool("create_goal", "Create a Root Goal from durable Human intent and bind this Turn. Do not use for greetings, questions, or routine single-turn work.", "goal.create", typebox_exports.Object({ objective: typebox_exports.String(), id: typebox_exports.Optional(typebox_exports.String()) }))],

package/dist/runner-pi.d.ts

@@ -87,6 +87,7 @@ type HandoffValidationResult = {
     token: string;
     goalId: string;
     goalRevision: number;
+    messageItemId: string;
 } | {
     accepted: false;
     fatal: boolean;
@@ -181,9 +182,6 @@ interface TurnContext {
     activeGoal: GoalSnapshot | null;
     goalCommitment: GoalCommitment | null;
 }
-interface AssistantResponse {
-    content: string;
-}
 interface RunRequest {
     agent: string;
     execution: TurnSnapshot;
@@ -197,7 +195,7 @@ interface RunRequest {
 }
 type RunnerCandidateResult = {
     outcome: "completed";
-    response: AssistantResponse;
+    finalMessageId: string;
     handoff?: TurnOutput;
 } | {
     outcome: "abnormal";
@@ -267,14 +265,17 @@ interface EnvSpecSource {
  */
 declare function resolveEnvSpec(spec: Record<string, string> | undefined, source: EnvSpecSource | undefined): Record<string, string>;
 
+interface PiAssistantResponse {
+    content: string;
+}
 interface PiStep {
     trace?: Array<{
         type: string;
         data: JsonValue;
     }>;
-    response?: AssistantResponse;
+    response?: PiAssistantResponse;
     handoff?: {
-        response: AssistantResponse;
+        response: PiAssistantResponse;
         handoff: AgentHandoff;
     };
     stopped?: boolean;
@@ -339,4 +340,4 @@ type WorkerRun = (request: WorkerRequest, emit: (event: {
 declare function runProcessWorker(run: WorkerRun): Promise<void>;
 
 export { LOCAL_PROVIDERS, PiRunnerAdapter, ProcessRunner, createPiProcessRunner, defaultAuthFile, modelCatalog, piConfig, piEnvironment, piRunnerConfigurator, piWorkerPath, providerCatalog, resolveEnvSpec, runProcessWorker, verificationWorkerPath };
-export type { ModelSummary, PiDriver, PiRunnerConfig, PiRunnerSession, PiStep, ProcessRunnerOptions, ProviderSummary, WorkerControls, WorkerRpc, WorkerRun };
+export type { ModelSummary, PiAssistantResponse, PiDriver, PiRunnerConfig, PiRunnerSession, PiStep, ProcessRunnerOptions, ProviderSummary, WorkerControls, WorkerRpc, WorkerRun };

package/dist/runner-pi.js

@@ -11,7 +11,7 @@ import {
   resolveEnvSpec,
   runProcessWorker,
   verificationWorkerPath
-} from "./chunk-7E7V6OIU.js";
+} from "./chunk-EK6BTCFG.js";
 import {
   LOCAL_PROVIDERS,
   defaultAuthFile,

package/dist/{runner-registry-GD4BYCQC.js → runner-registry-3WSOMXRW.js}

@@ -3,8 +3,8 @@ const require = __goahCreateRequire(import.meta.url);
 import {
   runnerManifests,
   runnerPlugin
-} from "./chunk-D2DVAH37.js";
-import "./chunk-7E7V6OIU.js";
+} from "./chunk-R6GKCNTB.js";
+import "./chunk-EK6BTCFG.js";
 import "./chunk-6M3OOCKO.js";
 import "./chunk-K26BVR6O.js";
 import "./chunk-IIJQ3DW4.js";

package/dist/sqlite.d.ts

@@ -320,7 +320,8 @@ interface Ledger extends EventStore {
     renewTurnLease(id: string, leaseToken: string, leaseUntil: string, now: string): TurnSnapshot;
     appendTurnEvent(input: EventInput, leaseToken: string): EventRecord;
     repairTurnAttempt(id: string, reason: string, now: string, actor: string): TurnItemSnapshot[];
-    finishTurn(id: string, status: "completed" | "failed" | "interrupted", error: JsonValue | null, now: string, actor: string, mailIds?: string[]): TurnSnapshot;
+    finishTurn(id: string, status: "failed" | "interrupted", error: JsonValue, now: string, actor: string): TurnSnapshot;
+    commitTurnResponse(id: string, responseItemId: string, now: string, actor: string, mailIds?: string[]): TurnSnapshot;
     releaseTurnProcess(id: string, actor: string): TurnSnapshot;
     putMail(mail: MailSnapshot, actor: string, wakeId?: string): EventRecord;
     putMails(mail: MailSnapshot[], actor: string, wakeId?: string): EventRecord[];
@@ -408,7 +409,8 @@ declare class SqliteLedger implements Ledger {
     renewTurnLease(id: string, leaseToken: string, leaseUntil: string, now: string): TurnSnapshot;
     appendTurnEvent(input: EventInput, leaseToken: string): EventRecord;
     repairTurnAttempt(id: string, reason: string, now: string, actor: string): TurnItemSnapshot[];
-    finishTurn(id: string, status: "completed" | "failed" | "interrupted", error: JsonValue | null, now: string, actor: string, mailIds?: string[]): TurnSnapshot;
+    finishTurn(id: string, status: "failed" | "interrupted", error: JsonValue, now: string, actor: string): TurnSnapshot;
+    commitTurnResponse(id: string, responseItemId: string, now: string, actor: string, mailIds?: string[]): TurnSnapshot;
     releaseTurnProcess(id: string, actor: string): TurnSnapshot;
     putMail(mail: MailSnapshot, actor: string, wakeId?: string): EventRecord;
     putMails(mails: MailSnapshot[], actor: string, wakeId?: string): EventRecord[];

package/dist/sqlite.js

@@ -3,7 +3,7 @@ const require = __goahCreateRequire(import.meta.url);
 import {
   SQLITE_SCHEMA_VERSION,
   SqliteLedger
-} from "./chunk-YH6YJ2IB.js";
+} from "./chunk-CDELLMIJ.js";
 import "./chunk-4KA63VNZ.js";
 import "./chunk-KAO7WIXG.js";
 import "./chunk-R6I3VKME.js";

package/dist/supervisor.d.ts

@@ -304,9 +304,6 @@ interface TurnContext {
     activeGoal: GoalSnapshot | null;
     goalCommitment: GoalCommitment | null;
 }
-interface AssistantResponse {
-    content: string;
-}
 interface RunRequest {
     agent: string;
     execution: TurnSnapshot;
@@ -320,7 +317,7 @@ interface RunRequest {
 }
 type RunnerCandidateResult = {
     outcome: "completed";
-    response: AssistantResponse;
+    finalMessageId: string;
     handoff?: TurnOutput;
 } | {
     outcome: "abnormal";
@@ -398,7 +395,8 @@ interface Ledger extends EventStore {
     renewTurnLease(id: string, leaseToken: string, leaseUntil: string, now: string): TurnSnapshot;
     appendTurnEvent(input: EventInput, leaseToken: string): EventRecord;
     repairTurnAttempt(id: string, reason: string, now: string, actor: string): TurnItemSnapshot[];
-    finishTurn(id: string, status: "completed" | "failed" | "interrupted", error: JsonValue | null, now: string, actor: string, mailIds?: string[]): TurnSnapshot;
+    finishTurn(id: string, status: "failed" | "interrupted", error: JsonValue, now: string, actor: string): TurnSnapshot;
+    commitTurnResponse(id: string, responseItemId: string, now: string, actor: string, mailIds?: string[]): TurnSnapshot;
     releaseTurnProcess(id: string, actor: string): TurnSnapshot;
     putMail(mail: MailSnapshot, actor: string, wakeId?: string): EventRecord;
     putMails(mail: MailSnapshot[], actor: string, wakeId?: string): EventRecord[];

package/dist/supervisor.js

@@ -15,7 +15,7 @@ import {
   renderDashboard,
   runSupervisorDaemon,
   selectRecoveryEvents
-} from "./chunk-QBD6EJ2Z.js";
+} from "./chunk-SQJZ5OFH.js";
 import "./chunk-4KA63VNZ.js";
 import "./chunk-KAO7WIXG.js";
 import "./chunk-R6I3VKME.js";

package/dist/testkit.d.ts

@@ -269,6 +269,7 @@ type HandoffValidationResult = {
     token: string;
     goalId: string;
     goalRevision: number;
+    messageItemId: string;
 } | {
     accepted: false;
     fatal: boolean;
@@ -296,9 +297,6 @@ interface TurnContext {
     activeGoal: GoalSnapshot | null;
     goalCommitment: GoalCommitment | null;
 }
-interface AssistantResponse {
-    content: string;
-}
 interface RunRequest {
     agent: string;
     execution: TurnSnapshot;
@@ -370,7 +368,8 @@ interface Ledger extends EventStore {
     renewTurnLease(id: string, leaseToken: string, leaseUntil: string, now: string): TurnSnapshot;
     appendTurnEvent(input: EventInput, leaseToken: string): EventRecord;
     repairTurnAttempt(id: string, reason: string, now: string, actor: string): TurnItemSnapshot[];
-    finishTurn(id: string, status: "completed" | "failed" | "interrupted", error: JsonValue | null, now: string, actor: string, mailIds?: string[]): TurnSnapshot;
+    finishTurn(id: string, status: "failed" | "interrupted", error: JsonValue, now: string, actor: string): TurnSnapshot;
+    commitTurnResponse(id: string, responseItemId: string, now: string, actor: string, mailIds?: string[]): TurnSnapshot;
     releaseTurnProcess(id: string, actor: string): TurnSnapshot;
     putMail(mail: MailSnapshot, actor: string, wakeId?: string): EventRecord;
     putMails(mail: MailSnapshot[], actor: string, wakeId?: string): EventRecord[];
@@ -457,7 +456,8 @@ declare class SqliteLedger implements Ledger {
     renewTurnLease(id: string, leaseToken: string, leaseUntil: string, now: string): TurnSnapshot;
     appendTurnEvent(input: EventInput, leaseToken: string): EventRecord;
     repairTurnAttempt(id: string, reason: string, now: string, actor: string): TurnItemSnapshot[];
-    finishTurn(id: string, status: "completed" | "failed" | "interrupted", error: JsonValue | null, now: string, actor: string, mailIds?: string[]): TurnSnapshot;
+    finishTurn(id: string, status: "failed" | "interrupted", error: JsonValue, now: string, actor: string): TurnSnapshot;
+    commitTurnResponse(id: string, responseItemId: string, now: string, actor: string, mailIds?: string[]): TurnSnapshot;
     releaseTurnProcess(id: string, actor: string): TurnSnapshot;
     putMail(mail: MailSnapshot, actor: string, wakeId?: string): EventRecord;
     putMails(mails: MailSnapshot[], actor: string, wakeId?: string): EventRecord[];
@@ -491,14 +491,17 @@ declare class SqliteLedger implements Ledger {
     rebuildProjections(): void;
 }
 
+interface PiAssistantResponse {
+    content: string;
+}
 interface PiStep {
     trace?: Array<{
         type: string;
         data: JsonValue;
     }>;
-    response?: AssistantResponse;
+    response?: PiAssistantResponse;
     handoff?: {
-        response: AssistantResponse;
+        response: PiAssistantResponse;
         handoff: AgentHandoff;
     };
     stopped?: boolean;

package/dist/testkit.js

@@ -2,7 +2,7 @@ import { createRequire as __goahCreateRequire } from "node:module";
 const require = __goahCreateRequire(import.meta.url);
 import {
   SqliteLedger
-} from "./chunk-YH6YJ2IB.js";
+} from "./chunk-CDELLMIJ.js";
 import "./chunk-4KA63VNZ.js";
 import "./chunk-KAO7WIXG.js";
 import "./chunk-R6I3VKME.js";
@@ -107,6 +107,10 @@ function assertLedgerConformance(create) {
     throw new Error("ledger conformance: consumed Wake did not link its Turn");
   if (ledger.wakeTriggers("z").some((trigger) => trigger.status !== "resolved"))
     throw new Error("ledger conformance: consumed Wake retained pending triggers");
+  ledger.putTurnItem({ id: "turn:a:answer", turnId: turn.id, ordinal: 1, type: "assistant_message", status: "completed", data: { text: "verified" }, createdAt: clock.now().toISOString(), completedAt: clock.now().toISOString() }, "a");
+  ledger.commitTurnResponse(turn.id, "turn:a:answer", clock.now().toISOString(), "supervisor");
+  if (ledger.turn(turn.id)?.status !== "completed" || !ledger.readStream(`turn:${turn.id}`).some((item) => item.type === "response.committed" && item.data.messageItemId === "turn:a:answer"))
+    throw new Error("ledger conformance: canonical Assistant response was not committed");
   if (first.event.ts !== clock.now().toISOString())
     throw new Error("ledger conformance: injected clock was ignored");
   const informational = ledger.appendEvent({ streamId: "conformance:events", ts: clock.now().toISOString(), actor: "a", type: "transcript.conformance_info", data: {}, ignorable: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goah/cli",
-  "version": "0.13.2",
+  "version": "0.13.4",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",