@springbrand/agent-runtime 0.2.0-alpha.43 → 0.2.0-alpha.44

package/package.json

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

package/src/kernel/bindings.ts

@@ -855,6 +855,10 @@ export interface RuntimeTurnEventsPort {
     readonly submissionId: string;
     readonly approvalExecutionId: string;
   }): Promise<void>;
+  /**
+   * 至少一次投当前 Session Activity；Host 应按 revision 幂等处理重试。
+   * Runtime 恢复时会略过已过时的 revision，避免重放旧 working 状态。
+   */
   onActivityChanged?(
     projection: RuntimeActivityProjection,
   ): Promise<void>;

package/src/runtime.ts

@@ -48,6 +48,7 @@ import type {
 } from "./kernel/extensions";
 import type {
   RuntimeActivity,
+  RuntimeActivityProjection,
   RuntimeState,
   RuntimeTurnState,
 } from "./kernel/state";
@@ -153,6 +154,7 @@ const CHAT_RECOVERY_TERMINAL_MESSAGE =
 
 type RuntimeEventOutboxPayload =
   | { readonly type: "model-usage"; readonly event: RuntimeModelUsageEvent }
+  | { readonly type: "activity"; readonly projection: RuntimeActivityProjection }
   | {
       readonly type: "tool-settlement";
       readonly event: RuntimeToolSettlementEvent;
@@ -1105,12 +1107,12 @@ export abstract class AgentRuntimeKernel<
   async onStart(): Promise<void> {
     this.runtimeLoad.reset();
     this.telemetry.recover(() => this.ensureRuntimeReady());
+    await this.broadcastApprovals();
     if (this.db.runtimeEvents.hasPending()) {
       this.ctx.waitUntil(
         this.ensureRuntimeReady().then(() => this.drainRuntimeEvents()),
       );
     }
-    await this.broadcastApprovals();
     await this.approvals.dispatchPendingContinuations();
     const running = this.db.submissions.findRunning() as StoredSubmission | null;
     if (running) {
@@ -1134,6 +1136,13 @@ export abstract class AgentRuntimeKernel<
         const payload = JSON.parse(row.body) as RuntimeEventOutboxPayload;
         if (payload.type === "model-usage") {
           await turnEvents.onModelUsage?.(payload.event);
+        } else if (payload.type === "activity") {
+          if (
+            !this.state.activity ||
+            payload.projection.revision >= this.state.activity.revision
+          ) {
+            await turnEvents.onActivityChanged?.(payload.projection);
+          }
         } else if (payload.type === "tool-settlement") {
           await turnEvents.onToolSettled?.(payload.event);
         } else if (payload.type === "subagent-usage") {
@@ -4598,6 +4607,13 @@ export abstract class AgentRuntimeKernel<
             backgroundWork,
             revision: (currentActivity?.revision ?? 0) + 1,
           };
+      this.db.transaction(() => {
+        this.db.runtimeEvents.insert({
+          eventId: `session-activity:${nextActivity.revision}`,
+          body: json({ type: "activity", projection: nextActivity }),
+          createdAt: Date.now(),
+        });
+      });
       if (
         this.state?.approvals === undefined ||
         json(this.state.approvals) !== json(approvals) ||
@@ -4611,14 +4627,9 @@ export abstract class AgentRuntimeKernel<
           turn,
         });
       }
-      const projection = this.turnEventsPort()?.onActivityChanged?.(nextActivity);
-      if (projection) {
-        this.ctx.waitUntil(
-          projection.catch(() => undefined),
-        );
-      }
+      this.ctx.waitUntil(this.drainRuntimeEvents());
     } catch {
-      // Approval projection is best effort and must not block execution.
+      // Rebuilding UI state is best effort; queued activity delivery retries independently.
     }
   }