@springbrand/agent-runtime 0.2.0-alpha.69 → 0.2.0-alpha.70

package/package.json

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

package/src/runtime-agent-context.ts

@@ -60,6 +60,8 @@ export interface RuntimeAgentConfigContext<
   readonly parentPath: readonly RuntimeAgentPathStep[];
   /** Runtime 根据 Agent facet 父子关系自动判定，不是外部配置项。 */
   readonly role: RuntimeAgentRole;
+  /** Current/preparing Submission and durable identities that may still resume. */
+  readonly submission?: { readonly id: string | undefined; readonly unfinishedIds: readonly string[] };
   /** 向当前 Agent facet 的已连接客户端发送实时消息。 */
   broadcast(message: string): void;
   /**

package/src/runtime-agent.ts

@@ -449,10 +449,15 @@ export function defineRuntimeAgent<
         return this.ensureConfig();
       }
 
-      protected async prepareRuntimeForSubmission(): Promise<void> {
+      protected async prepareRuntimeForSubmission(submissionId: string): Promise<void> {
         const beforeSubmission = definition.beforeSubmission as RuntimeAgentDefinitionBase<Env, Config, Command, Change>["beforeSubmission"];
-        const changed = await beforeSubmission?.(this.createDefinitionContext());
-        await this.ensureConfig(undefined, changed === true);
+        try {
+          const changed = await beforeSubmission?.(this.createDefinitionContext(undefined, submissionId));
+          await this.ensureConfig(undefined, changed === true);
+        } catch (error) {
+          this.hasLoadedRuntime = false;
+          throw error;
+        }
       }
 
       // 作用：加载默认 Runtime，或切换到调用方指定的 key。
@@ -669,6 +674,9 @@ export function defineRuntimeAgent<
             // Host 的会话列表把装配后的第一次投影当作「facet 已就绪」的信号。
             await this.broadcastApprovals();
           })().catch((error) => {
+            // A failed replacement must be retried even when Host inputs have
+            // not changed again since that failed attempt.
+            this.hasLoadedRuntime = false;
             logRuntimeLoadFailure("runtime", error);
             this.runtimeLoad.fail();
             throw error;
@@ -831,6 +839,7 @@ export function defineRuntimeAgent<
 
       protected createDefinitionContext(
         runtimeConfig?: { value: Config },
+        submissionId?: string,
       ): RuntimeAgentPlanningContext<
         Env,
         Command,
@@ -849,6 +858,10 @@ export function defineRuntimeAgent<
           get role() {
             return agent.role;
           },
+          get submission() {
+            const current = agent.submissionContext;
+            return { ...current, id: submissionId ?? current.id };
+          },
           broadcast: (message) => agent.broadcast(message),
           ...(agent.role === "primary"
             ? {

package/src/runtime.ts

@@ -418,9 +418,15 @@ export abstract class AgentRuntimeKernel<
 
   protected abstract ensureRuntimeReady(): Promise<void>;
   /** Runs only before the first pin of a newly activated Submission. */
-  protected prepareRuntimeForSubmission(): Promise<void> {
+  protected prepareRuntimeForSubmission(_submissionId: string): Promise<void> {
     return this.ensureRuntimeReady();
   }
+  protected get submissionContext() {
+    return {
+      id: this.submissions.currentActive()?.submissionId ?? this.db.submissions.findRunning()?.submissionId,
+      unfinishedIds: this.db.submissions.listUnfinishedIds(),
+    };
+  }
 
   /** Let the Host prepare a validated client response before Tool settlement. */
   protected prepareToolInteractionResponse(
@@ -1535,11 +1541,11 @@ export abstract class AgentRuntimeKernel<
   // 作用：为新 Submission 生成包含当前 Context 的不可变装配描述。
   // 调用：Submission 通过去重和忙碌检查后，在真正写入前调用。
   // 原因：把动态 Context 和执行档位固定在准入时，恢复时才能按原配置继续。
-  private async admissionPin(fresh: boolean): Promise<{
+  private async admissionPin(fresh: boolean, submissionId: string): Promise<{
     revision: string;
     descriptor: string;
   }> {
-    if (fresh) await this.prepareRuntimeForSubmission();
+    if (fresh) await this.prepareRuntimeForSubmission(submissionId);
     else await this.ensureRuntimeReady();
     return this.currentAssemblyPin();
   }
@@ -1592,7 +1598,7 @@ export abstract class AgentRuntimeKernel<
     if (submission.assemblyRevision || submission.assemblyDescriptor) {
       throw new Error("Submission assembly pin is incomplete");
     }
-    const { revision, descriptor } = await this.admissionPin(mode === 'fresh');
+    const { revision, descriptor } = await this.admissionPin(mode === 'fresh', submission.submissionId);
     this.db.submissions.pinAssembly(
       submission.submissionId,
       revision,