@springbrand/agent-runtime 0.2.0-alpha.13 → 0.2.0-alpha.15

package/package.json

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

package/src/adapter/cloudflare/universal-agent/preparation.ts

@@ -15,7 +15,7 @@ import type { RuntimeDegradation } from "../../../kernel/degradation";
 import type { RuntimeMemoryProfile } from "../../../kernel/profile";
 import { AGENT_TYPES } from "../../../layers/orchestration/subagents/agent-types/registry";
 import type { RuntimeAgentConfigContext } from "../../../runtime-agent-context";
-import { createWorkspaceCodeExecutionPort } from "../../../pi/tool/core-host";
+import { createWorkspaceCodeExecutionFactory } from "../../../pi/tool/core-host";
 import {
   createCloudflareSandboxAdapter,
   type SandboxAdmission,
@@ -127,7 +127,7 @@ export async function prepareWorkspace<Env extends Cloudflare.Env>(
   if (!workspace.value) return { degradations: workspace.degradations };
   return {
     workspace: workspace.value,
-    codeExecution: createWorkspaceCodeExecutionPort({
+    codeExecution: createWorkspaceCodeExecutionFactory({
       ctx: context.ctx,
       loader: platform.loader,
       outbound: platform.outbound(),

package/src/adapter/cloudflare/universal-agent/tools.ts

@@ -1,5 +1,4 @@
 import type {
-  RuntimeCodeExecutionPort,
   RuntimeMemoryPort,
   RuntimeSandboxPort,
   RuntimeSchedulePort,
@@ -9,7 +8,6 @@ import type {
 import type { RuntimeDegradation } from "../../../kernel/degradation";
 import type { RuntimeMemoryProfile } from "../../../kernel/profile";
 import type { WorkspaceRevisionRestorePort } from "../../../workspace-versioning";
-import { createCodeExecutionTool } from "../../../pi/tool/core";
 import { createScheduleTools } from "../../../pi/tool/schedule";
 import { createWorkspaceRevisionTools } from "../../../pi/tool/workspace-revision";
 import {
@@ -18,6 +16,7 @@ import {
 } from "../../../pi/tool/workspace-sandbox";
 import {
   mergeToolRegistries,
+  type RuntimeCodeExecutionFactory,
   type ToolAssemblyResult,
   type ToolRegistry,
 } from "../../../tool-registry";
@@ -36,7 +35,7 @@ export function assembleUniversalAgentTools(options: {
   hostTools?: ToolRegistry;
   workspace?: WorkspacePort;
   workspaceRevisions?: WorkspaceRevisionRestorePort;
-  codeExecution?: RuntimeCodeExecutionPort;
+  codeExecution?: RuntimeCodeExecutionFactory;
   sandbox?: RuntimeSandboxPort;
   schedule?: RuntimeSchedulePort;
   subagents?: RuntimeSubagentPort;
@@ -52,9 +51,6 @@ export function assembleUniversalAgentTools(options: {
     options.workspaceRevisions
       ? createWorkspaceRevisionTools(options.workspaceRevisions)
       : {},
-    options.codeExecution
-      ? createCodeExecutionTool(options.codeExecution)
-      : {},
     options.sandbox ? createSandboxTools(options.sandbox) : {},
     options.schedule ? createScheduleTools(options.schedule) : {},
   );
@@ -63,6 +59,7 @@ export function assembleUniversalAgentTools(options: {
     tools,
     bindings: {
       ...(options.workspace ? { workspace: options.workspace } : {}),
+      ...(options.codeExecution ? { codeExecution: options.codeExecution } : {}),
       ...(options.memory ? { memory: options.memory } : {}),
       ...(options.subagents ? { subagents: options.subagents } : {}),
     },

package/src/index.ts

@@ -86,6 +86,7 @@ export {
   toolRegistryFromPiCandidates,
 } from "./tool-registry";
 export type { ModelOption } from "./lib/model-catalog";
+export type { RuntimeCodeExecutionFactory } from "./tool-registry";
 export {
   assembleSubagentPrompt,
   assembleSystemPrompt,
@@ -134,11 +135,10 @@ export { skillPiToolCandidates } from "./pi/tool";
 export type { PiSkillBinding } from "./pi/tool";
 export {
   browserQuickActionPiToolCandidates,
-  createCodeExecutionTool,
   codeExecutionPiToolCandidate,
 } from "./pi/tool";
 export {
-  createWorkspaceCodeExecutionPort,
+  createWorkspaceCodeExecutionFactory,
 } from "./pi/tool";
 export {
   assemblePiExtensions,

package/src/kernel/submission-lifecycle.ts

@@ -117,7 +117,7 @@ export class SubmissionQueueFullError extends Error {
   readonly code = "queue_full";
 
   constructor() {
-    super(`Pi submission queue is full (${MAX_PENDING_SUBMISSIONS})`);
+    super(`SpringBrand submission queue is full (${MAX_PENDING_SUBMISSIONS})`);
   }
 }
 
@@ -303,6 +303,16 @@ export class SubmissionLifecycle<
     return this.start(submissionId, true);
   }
 
+  /** 等当前切片退出后恢复同一条非终态 Submission，避免 planned wake 被实例内去重吞掉。 */
+  async recoverAfterCurrent(submissionId: string): Promise<TSubmission> {
+    const current = this.executions.get(submissionId);
+    if (current) {
+      const outcome = await current;
+      if (isTerminalSubmissionStatus(outcome.status)) return outcome;
+    }
+    return this.start(submissionId, true);
+  }
+
   recoverHead(): Promise<TSubmission | null> {
     const running = this.options.store.findRunning();
     if (running) return this.start(running.submissionId, true);
@@ -419,7 +429,7 @@ export class SubmissionLifecycle<
         }
         const submission = this.options.store.find(submissionId);
         if (!submission) {
-          throw new Error(`Unknown Pi submission: ${submissionId}`);
+          throw new Error(`Unknown SpringBrand submission: ${submissionId}`);
         }
         shouldPump = isTerminalSubmissionStatus(submission.status);
         return submission;
@@ -450,10 +460,13 @@ export class SubmissionLifecycle<
     // TODO(待确认): 持久层若长期保持非终态且没有执行者，这里没有超时或外部唤醒上限。
     for (;;) {
       const execution = this.executions.get(submissionId);
-      if (execution) return execution;
+      if (execution) {
+        await execution;
+        continue;
+      }
       const submission = this.options.store.find(submissionId);
       if (!submission) {
-        throw new Error(`Unknown Pi submission: ${submissionId}`);
+        throw new Error(`Unknown SpringBrand submission: ${submissionId}`);
       }
       if (isTerminalSubmissionStatus(submission.status)) return submission;
       await new Promise((resolve) => setTimeout(resolve, 50));
@@ -491,7 +504,7 @@ export class SubmissionLifecycle<
   ): Promise<TSubmission> {
     const latest = this.options.store.find(submission.submissionId);
     if (!latest) {
-      throw new Error(`Unknown Pi submission: ${submission.submissionId}`);
+      throw new Error(`Unknown SpringBrand submission: ${submission.submissionId}`);
     }
     if (isTerminalSubmissionStatus(latest.status)) return latest;
     return this.options.commitTerminal(latest, outcome, message);

package/src/layers/context/budget/gate.ts

@@ -1,3 +1,10 @@
+import {
+  type ArtifactRef,
+  serializeOutput,
+  sha256Hex,
+  type SpillWorkspace,
+} from "../../../lib/artifacts";
+
 /**
  * Durable history needs bounded values so one Tool response cannot make a
  * session impossible to restore.
@@ -11,7 +18,15 @@
 /** Maximum string leaf retained in durable tool output. */
 const STORAGE_LEAF_MAX_CHARS = 32 * 1024;
 
+/** Serialized outputs above this threshold get a narrower model view. */
+const MODEL_VIEW_THRESHOLD = 8 * 1024;
+
+/** Maximum string leaf exposed in a structure-preserving model view. */
+const MODEL_LEAF_MAX_CHARS = 500;
+
 const ELISION_RESERVE = 40;
+const PREVIEW_CHARS = 600;
+const DEFAULT_SPILL_DIR = "/scratch/tool-output";
 
 // 作用：把过长文本从中间截短，同时保留开头和结尾。
 // 调用：`truncateStringLeaves` 遇到字符串叶子时调用，传入该叶子的上限。
@@ -86,3 +101,87 @@ export function truncateStringLeaves(value: unknown, maxChars: number): unknown
 export function boundDurableToolOutput(value: unknown): unknown {
   return truncateStringLeaves(value, STORAGE_LEAF_MAX_CHARS);
 }
+
+/** Selects whether a Tool result is externalized or kept structurally durable. */
+export type BudgetPolicy = { kind: "spill" } | { kind: "structure" };
+
+/**
+ * Writes one large payload to Workspace and returns its narrow durable reference.
+ *
+ * Small values and failed/unavailable Workspace writes return `null`; callers
+ * must then retain the existing bounded-structure fallback.
+ */
+export async function spillDurableToolOutput(
+  value: unknown,
+  options: {
+    readonly workspace?: SpillWorkspace;
+  },
+): Promise<ArtifactRef | null> {
+  const { text, ext } = serializeOutput(value);
+  if (text.length <= MODEL_VIEW_THRESHOLD || !options.workspace) return null;
+  try {
+    const hash = await sha256Hex(text);
+    const path = `${DEFAULT_SPILL_DIR}/${hash.slice(0, 24)}.${ext}`;
+    await options.workspace.writeFile(
+      path,
+      text,
+      ext === "json" ? "application/json" : "text/plain",
+    );
+    return {
+      kind: "artifact_ref",
+      path,
+      bytes: new TextEncoder().encode(text).byteLength,
+      hash: hash.slice(0, 16),
+      preview: text.slice(0, PREVIEW_CHARS),
+      note:
+        "Output was large and has been saved to the Workspace file above. " +
+        "Use the read tool with that path to retrieve the full content when needed.",
+    };
+  } catch {
+    return null;
+  }
+}
+
+// Bounds leaves first, then removes oldest array entries until the view fits.
+function structureView(output: unknown): unknown {
+  const capped = truncateStringLeaves(output, MODEL_LEAF_MAX_CHARS);
+  if (serializeOutput(capped).text.length <= MODEL_VIEW_THRESHOLD) return capped;
+  if (typeof capped !== "object" || capped === null) return capped;
+
+  const record = { ...(capped as Record<string, unknown>) };
+  const arrayKey = Object.entries(record)
+    .filter((entry): entry is [string, unknown[]] => Array.isArray(entry[1]))
+    .sort((left, right) => right[1].length - left[1].length)[0]?.[0];
+  if (!arrayKey) return capped;
+
+  const items = [...(record[arrayKey] as unknown[])];
+  let dropped = 0;
+  while (
+    items.length > 1 &&
+    serializeOutput({ ...record, [arrayKey]: items }).text.length >
+      MODEL_VIEW_THRESHOLD
+  ) {
+    items.shift();
+    dropped += 1;
+  }
+  if (dropped === 0) return capped;
+  record[arrayKey] = items;
+  record[`${arrayKey}Omitted`] = {
+    count: dropped,
+    note:
+      `${dropped} earlier entr(ies) omitted to fit the model context budget; ` +
+      "the most recent are kept. The durable record retains the bounded value.",
+  };
+  return record;
+}
+
+/** Creates a non-destructive, smaller Tool-result projection for the model. */
+export function projectToolOutputForModel(output: unknown): unknown {
+  try {
+    return serializeOutput(output).text.length <= MODEL_VIEW_THRESHOLD
+      ? output
+      : structureView(output);
+  } catch {
+    return truncateStringLeaves(output, MODEL_LEAF_MAX_CHARS);
+  }
+}

package/src/lib/prompt.ts

@@ -80,9 +80,10 @@ export const FILES =
 
 // User-interaction actions are called only when their UI semantics are useful.
 export const INTERACTION =
-  "Interaction: When the user must pick among a small set of options, call ask_user (2-6 options) " +
-  "instead of writing 'please choose A/B/C' as text, then end your turn and wait. Don't use it for " +
-  "open-ended questions or when a sensible default lets you proceed. " +
+  "Interaction: When progress requires user decisions, put all 1-4 necessary questions in one ask_user call " +
+  "instead of asking each question separately or writing 'please choose A/B/C' as text. Use 2-6 options for " +
+  "a bounded choice, or no options when a required free-text answer is necessary; continue the same turn when its result arrives. " +
+  "Don't use it when a sensible default lets you proceed. " +
   "After completing a substantive task (report, analysis, multi-step job): write your full answer " +
   "FIRST, then call suggest_followups (2-4 directions) as the very last action and end the turn — " +
   "write no text after it (the tool renders its own closing block). Never for small talk or while a " +

package/src/pi/message/projection.ts

@@ -282,7 +282,7 @@ export class PiChunkEncoder {
         return [];
       default:
         throw new Error(
-          `Unsupported Pi AgentEvent: ${String((event as { type?: unknown }).type)}`,
+          `Unsupported SpringBrand AgentEvent: ${String((event as { type?: unknown }).type)}`,
         );
     }
   }
@@ -449,7 +449,7 @@ export class PiChunkEncoder {
     if (message.stopReason === "error") {
       chunks.push({
         type: "error",
-        errorText: message.errorMessage ?? "Pi turn failed",
+        errorText: message.errorMessage ?? "SpringBrand turn failed",
       });
       return chunks;
     }

package/src/pi/runtime-adapter/assembly.ts

@@ -321,7 +321,7 @@ class PreparedRuntime implements PreparedPiRuntime {
   read(owner: object): PreparedPiRuntimeState {
     if (owner !== this.owner) {
       throw new Error(
-        "Prepared Pi Runtime belongs to another PiRuntimeAdapter",
+        "Prepared SpringBrand Runtime belongs to another runtime adapter",
       );
     }
     return this.state;
@@ -341,7 +341,7 @@ export function readPreparedPiRuntime(
   owner: object,
 ): PreparedPiRuntimeState {
   if (!(prepared instanceof PreparedRuntime)) {
-    throw new Error("Prepared Pi Runtime handle is invalid");
+    throw new Error("Prepared SpringBrand Runtime handle is invalid");
   }
   return prepared.read(owner);
 }

package/src/pi/runtime-adapter/execution.ts

@@ -46,10 +46,12 @@ import {
   withProviderRetry,
 } from "./models";
 import { EXECUTION_LEVELS } from "../../lib/execution-level";
+import { projectToolOutputForModel } from "../../layers/context/budget/gate";
+import type { SpillWorkspace } from "../../lib/artifacts";
 
 // #region Single-run Pi bridge
 
-const MAX_MODEL_TURNS = 30;
+const MAX_MODEL_TURNS_PER_SLICE = 30;
 
 export class RetryableModelError extends Error {}
 
@@ -91,7 +93,7 @@ function classifyPiStopReason(stopReason: string | undefined): {
       return {
         outcome: "failed",
         turnStatus: "error",
-        message: `Pi ended the turn with an unrecognized stop reason: ${
+        message: `SpringBrand ended the turn with an unrecognized stop reason: ${
           stopReason ?? "(none)"
         }`,
       };
@@ -134,6 +136,29 @@ interface PiTurnAdapterOptions {
   // PiCore 通过 AgentOptions.transformContext 调用它，Runtime 用它接入现有上下文处理。
   // 直接复用 Pi 的回调类型可避免这里维护另一套上下文转换约定。
   readonly transformContext: NonNullable<AgentOptions["transformContext"]>;
+  readonly workspace?: SpillWorkspace;
+}
+
+function projectToolResultsForModel(
+  messages: readonly AgentMessage[],
+): AgentMessage[] {
+  let changed = false;
+  const projected = messages.map((message) => {
+    if (message.role !== "toolResult") return message;
+    const payload = {
+      content: message.content,
+      details: message.details,
+    };
+    const next = projectToolOutputForModel(payload) as typeof payload;
+    if (next === payload) return message;
+    changed = true;
+    return {
+      ...message,
+      content: next.content,
+      details: next.details,
+    };
+  });
+  return changed ? projected : [...messages];
 }
 
 class PiTurnAdapter {
@@ -155,6 +180,7 @@ class PiTurnAdapter {
   private compile(candidates: readonly PiToolCandidate[]) {
     return compilePiTools(candidates, {
       governance: this.governance,
+      workspace: this.opts.workspace,
       settle: this.opts.settle,
     });
   }
@@ -201,7 +227,7 @@ class PiTurnAdapter {
       readonly signal?: AbortSignal;
     },
     listener: (event: AgentEvent) => void | Promise<void>,
-  ): Promise<boolean> {
+  ): Promise<PiTurnRunResult> {
     const { systemPrompt, signal } = opts;
     signal?.throwIfAborted();
     const canonicalMessages = await this.opts.canonicalMessages();
@@ -221,11 +247,14 @@ class PiTurnAdapter {
       // 切换 provider 或消息跨 provider 回放时若不规范化，provider 会静默拒绝。
       transformContext: async (messages, signal) => {
         const ctx = await this.opts.transformContext(messages, signal);
-        return transformMessages(ctx as Message[], this.opts.pi.model) as AgentMessage[];
+        return transformMessages(
+          projectToolResultsForModel(ctx) as Message[],
+          this.opts.pi.model,
+        ) as AgentMessage[];
       },
       afterToolCall: this.governance.afterToolCall,
       shouldStopAfterTurn: () => {
-        reachedModelTurnLimit = ++modelTurns >= MAX_MODEL_TURNS;
+        reachedModelTurnLimit = ++modelTurns >= MAX_MODEL_TURNS_PER_SLICE;
         return signal?.aborted === true || reachedModelTurnLimit;
       },
       initialState: {
@@ -256,7 +285,9 @@ class PiTurnAdapter {
         pi.abort();
       }
       await running;
-      return reachedModelTurnLimit;
+      return reachedModelTurnLimit
+        ? { kind: "yielded" }
+        : { kind: "terminal" };
     } finally {
       signal?.removeEventListener("abort", abort);
       unsubscribe();
@@ -447,6 +478,10 @@ export interface PiPreparedTurnRunOptions {
   readonly signal?: AbortSignal;
 }
 
+export type PiTurnRunResult =
+  | { readonly kind: "terminal" }
+  | { readonly kind: "yielded" };
+
 // #endregion
 
 // #region Durable prepared-Turn execution
@@ -505,7 +540,7 @@ export class PreparedPiTurnAdapter {
             : candidate.requiredExecutionLevel;
           if (!EXECUTION_LEVELS.includes(requiredExecutionLevel)) {
             throw new Error(
-              `Pi Tool "${candidate.tool.name}" resolved an invalid execution level`,
+              `SpringBrand Tool "${candidate.tool.name}" resolved an invalid execution level`,
             );
           }
           await state.snapshot.bindings.platform.gateTool?.({
@@ -652,6 +687,7 @@ export class PreparedPiTurnAdapter {
         this.interrupted ? undefined : options.durability.settleTool(call),
       onToolTelemetry: options.onToolTelemetry,
       transformContext: options.transformContext,
+      workspace: state.snapshot.bindings.workspace,
     });
     this.systemPrompt = descriptor.systemPrompt;
     this.options = options;
@@ -751,9 +787,9 @@ export class PreparedPiTurnAdapter {
    */
   async run(
     options: PiPreparedTurnRunOptions,
-  ): Promise<void> {
+  ): Promise<PiTurnRunResult> {
     this.terminalIntent = undefined;
-    const reachedModelTurnLimit = await this.turn.run(
+    const result = await this.turn.run(
       {
         systemPrompt: this.systemPrompt,
         tools: this.candidates,
@@ -761,15 +797,11 @@ export class PreparedPiTurnAdapter {
       },
       (event) => this.handleEvent(event),
     );
-    if (reachedModelTurnLimit && !this.terminalIntent) {
-      this.terminalIntent = {
-        outcome: "failed",
-        message: `Pi stopped after ${MAX_MODEL_TURNS} model turns`,
-      };
-    }
     if (this.terminalIntent) {
       await this.options.onTerminal(this.terminalIntent);
+      return { kind: "terminal" };
     }
+    return result;
   }
 
   // 提交完成的 Pi 消息、推导终态意图，并把事件投影给可恢复流。

package/src/pi/runtime-adapter/index.ts

@@ -259,6 +259,7 @@ export type {
   PiStoredToolSettlement,
   PiToolSettlement,
   PiToolInputRecord,
+  PiTurnRunResult,
   PreparedPiTurnAdapter,
 } from "./execution";
 export type {

package/src/pi/runtime-adapter/models.ts

@@ -498,7 +498,7 @@ function configuredModel(
   );
   if (!catalogModel) {
     throw new Error(
-      `Model is not in Pi's built-in catalog for ${endpoint.protocol}: ${modelId}`,
+      `Model is not in SpringBrand's built-in catalog for ${endpoint.protocol}: ${modelId}`,
     );
   }
   const {

package/src/pi/runtime-adapter/recovery.ts

@@ -201,7 +201,7 @@ function milestoneMutation(
 // 缺少身份时立即失败，避免把无归属的记录混入另一次 Turn 的恢复日志。
 function recoveryIdentity(input: PiRecoveryInput) {
   if (!input.identity) {
-    throw new Error("Pi recovery command is missing its Turn revision");
+    throw new Error("SpringBrand recovery command is missing its Turn revision");
   }
   return { version: 1 as const, ...input.identity };
 }
@@ -255,7 +255,7 @@ function interactionToolResult(
   timestamp: number,
 ): ToolResultMessage {
   if (!interaction) {
-    throw new Error("Pi Tool interaction is missing for its response");
+    throw new Error("SpringBrand Tool interaction is missing for its response");
   }
   return {
     role: "toolResult",
@@ -417,7 +417,7 @@ export function decidePiRecovery(
         (milestone) => milestone.type === "approval",
       );
       if (!approval || approval.type !== "approval") {
-        throw new Error("Pi approval decision milestone is missing");
+        throw new Error("SpringBrand approval decision milestone is missing");
       }
       mutations.push({
         kind: "decide-approval",
@@ -453,7 +453,7 @@ export function decidePiRecovery(
         JSON.stringify(existing.input) !== JSON.stringify(record.input)
       ) {
         throw new Error(
-          `Conflicting Pi Tool input for ${record.toolCallId}`,
+          `Conflicting SpringBrand Tool input for ${record.toolCallId}`,
         );
       }
     } else {
@@ -482,7 +482,7 @@ export function decidePiRecovery(
         existing.inputJson !== approval.inputJson
       ) {
         throw new Error(
-          `Conflicting Pi Tool approval: ${approval.executionId}`,
+          `Conflicting SpringBrand Tool approval: ${approval.executionId}`,
         );
       }
     } else {
@@ -530,7 +530,7 @@ export function decidePiRecovery(
         existing.inputJson !== interaction.inputJson
       ) {
         throw new Error(
-          `Conflicting Pi Tool interaction: ${interaction.interactionId}`,
+          `Conflicting SpringBrand Tool interaction: ${interaction.interactionId}`,
         );
       }
     } else {
@@ -580,7 +580,7 @@ export function decidePiRecovery(
         (milestone) => milestone.type === "interaction",
       );
       if (!record || record.type !== "interaction") {
-        throw new Error("Pi interaction settlement milestone is missing");
+        throw new Error("SpringBrand interaction settlement milestone is missing");
       }
       mutations.push({
         kind: "settle-interaction",
@@ -621,7 +621,7 @@ export function decidePiRecovery(
     if (existing) {
       if (JSON.stringify(existing) !== JSON.stringify(toolResult)) {
         throw new Error(
-          `Conflicting Pi Tool result for ${command.toolCallId}`,
+          `Conflicting SpringBrand Tool result for ${command.toolCallId}`,
         );
       }
     } else {
@@ -676,7 +676,7 @@ export function decidePiRecovery(
       plan.continuationKey !== input.command.continuationKey
     ) {
       throw new Error(
-        `Pi continuation is not ready: ${input.command.continuationKey}`,
+        `SpringBrand continuation is not ready: ${input.command.continuationKey}`,
       );
     }
     const committed = commitPiRecoveryContinuation(
@@ -686,7 +686,7 @@ export function decidePiRecovery(
     );
     if (!committed) {
       throw new Error(
-        `Pi continuation could not be committed: ${plan.continuationKey}`,
+        `SpringBrand continuation could not be committed: ${plan.continuationKey}`,
       );
     }
     const mutation = milestoneMutation(
@@ -809,13 +809,13 @@ export class PiRuntimeRecoveryAdapter
     if (!durable) {
       return {
         kind: "fail",
-        reason: "Recovered Pi submission is missing",
+        reason: "Recovered SpringBrand submission is missing",
       } as const;
     }
     if (durable.terminal) {
       return {
         kind: "ignore",
-        reason: "Pi submission is already terminal",
+        reason: "SpringBrand submission is already terminal",
       } as const;
     }
     const decision = decidePiRecovery({
@@ -827,20 +827,20 @@ export class PiRuntimeRecoveryAdapter
       if (decision.effect.reason === "approval") {
         return {
           kind: "park",
-          reason: "Pi Turn is waiting for Tool approval",
+          reason: "SpringBrand Turn is waiting for Tool approval",
         } as const;
       }
       if (decision.effect.reason === "interaction") {
         return {
           kind: "park",
-          reason: "Pi Turn is waiting for a client Tool interaction response",
+          reason: "SpringBrand Turn is waiting for a client Tool interaction response",
         } as const;
       }
       if (decision.effect.reason === "uncertain-tool") {
         return {
           kind: "park",
           reason:
-            "Pi Turn is parked on an uncertain non-idempotent Tool",
+            "SpringBrand Turn is parked on an uncertain non-idempotent Tool",
           incidentStatus: "failed",
         } as const;
       }
@@ -848,12 +848,12 @@ export class PiRuntimeRecoveryAdapter
         return {
           kind: "fail",
           reason:
-            "Pi recovery is complete but the Submission is not terminal",
+            "SpringBrand recovery is complete but the Submission is not terminal",
         } as const;
       }
       return {
         kind: "park",
-        reason: "Pi recovery is waiting for durable input",
+        reason: "SpringBrand recovery is waiting for durable input",
       } as const;
     }
     return {

package/src/pi/runtime-adapter/transcript.ts

@@ -526,7 +526,7 @@ export class PiRuntimeTranscript {
    */
   importSnapshot(snapshot: PiCanonicalTranscriptSnapshot): void {
     if (this.hasActiveTurn()) {
-      throw new Error("Cannot import messages while a Pi Turn is active");
+      throw new Error("Cannot import messages while a SpringBrand Turn is active");
     }
     this.durability.transaction(() => {
       let currentSubmissionId: string | undefined;
@@ -551,7 +551,7 @@ export class PiRuntimeTranscript {
             : {}),
         });
         if (!appended) {
-          throw new Error(`Pi Session message "${entry.id}" already exists`);
+          throw new Error(`SpringBrand Session message "${entry.id}" already exists`);
         }
       }
     });