@springbrand/agent-runtime 0.3.0-alpha.1 → 0.3.0-alpha.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springbrand/agent-runtime",
-  "version": "0.3.0-alpha.1",
+  "version": "0.3.0-alpha.2",
   "type": "module",
   "files": [
     "src",

package/src/adapter/cloudflare/agent.ts

@@ -668,11 +668,13 @@ export abstract class AgentRuntimeKernel<
       return submission;
     }
     if (submission.abortReason && submission.status === "pending") {
-      return this.submissions.finish(
+      const terminal = await this.submissions.finish(
         submission,
         "aborted",
         submission.abortReason,
       );
+      await this.projectTerminal(terminal);
+      return terminal;
     }
     if (mode === "recovery") {
       this.telemetry.capture("turnRecovering", {
@@ -683,7 +685,11 @@ export abstract class AgentRuntimeKernel<
       await this.broadcastApprovals();
     }
     try {
-      return await this.executeHarnessSubmission(submission, mode);
+      const outcome = await this.executeHarnessSubmission(submission, mode);
+      if (isTerminalSubmissionStatus(outcome.status)) {
+        await this.projectTerminal(outcome);
+      }
+      return outcome;
     } catch (error) {
       const failed = await this.submissions.finish(
         submission,
@@ -697,10 +703,57 @@ export abstract class AgentRuntimeKernel<
           : undefined,
         mode !== "fresh",
       );
+      await this.projectTerminal(failed);
       return failed;
     }
   }
 
+  /** Project one authoritative Submission terminal after Harness and client settlement. */
+  private async projectTerminal(submission: StoredSubmission): Promise<void> {
+    if (!isTerminalSubmissionStatus(submission.status)) {
+      throw new Error(`Cannot project unfinished Submission: ${submission.submissionId}`);
+    }
+    const events = this.activeRuntime?.snapshot.bindings.turnEvents;
+    if (!events) return;
+    const messages = await this.getMessages();
+    try {
+      await events.onResponse(
+        messages.flatMap((message) =>
+          message.role === "user" || message.role === "assistant"
+            ? [{
+                role: message.role,
+                text: message.parts
+                  .filter(
+                    (
+                      part,
+                    ): part is Extract<UIMessage["parts"][number], { type: "text" }> =>
+                      part.type === "text",
+                  )
+                  .map((part) => part.text)
+                  .join(""),
+              }]
+            : []
+        ),
+      );
+    } catch (error) {
+      console.warn("[runtime-turn-projection:degraded]", json({
+        error: errorText(error),
+      }));
+    }
+    try {
+      await events.onSubmissionTerminal?.({
+        submissionId: submission.submissionId,
+        status: submission.status,
+        ...(submission.error ? { error: submission.error } : {}),
+        resultMessageId: submission.assistantMessageId,
+      });
+    } catch (error) {
+      console.warn("[runtime-terminal-projection:degraded]", json({
+        error: errorText(error),
+      }));
+    }
+  }
+
   /** Run or recover the Submission through Pi's single durable AgentHarness. */
   private async executeHarnessSubmission(
     submission: StoredSubmission,

package/src/submission/repository.ts

@@ -23,7 +23,7 @@ const TERMINAL_SUBMISSION_STATUSES: ReadonlySet<SubmissionStatus> = new Set([
 // 终态集合收口在一处防止各生命周期的判断漂移；增加状态时必须先确认它是否真的不可再继续。
 export function isTerminalSubmissionStatus(
   status: SubmissionStatus,
-): boolean {
+): status is Exclude<SubmissionStatus, "pending" | "running"> {
   return TERMINAL_SUBMISSION_STATUSES.has(status);
 }