@peer-agent/runtime-sdk 0.1.0-rc.10 → 0.1.0-rc.12

package/dist/pipeline-contracts.d.ts

@@ -13,6 +13,8 @@ export interface RuntimePipelineRunInput<TInput = unknown> {
     /** Scheduling allowance; unlike maxToolCalls this can end at a batch boundary. */
     readonly sliceToolCalls?: number;
     readonly yieldAtTurnLimit?: boolean;
+    /** Host scheduling request, checked at durable batch boundaries. */
+    readonly shouldYield?: () => boolean;
     readonly maxToolBatchCalls?: number;
 }
 export interface RuntimePipelineToolCall<TPayload = unknown> {
@@ -54,6 +56,8 @@ export interface RuntimePipelineModelAdapter<TInput = unknown, TState = unknown,
     initialize(input: RuntimePipelineRunInput<TInput>, context: RuntimePipelineTurnContext<TInput>): TState | Promise<TState>;
     runTurn(state: TState, context: RuntimePipelineTurnContext<TInput>): RuntimePipelineTurnResult<TState, TCall, TOutput> | Promise<RuntimePipelineTurnResult<TState, TCall, TOutput>>;
     applyToolResults(state: TState, executions: readonly RuntimePipelineToolExecution<TCall, TToolResult>[], context: RuntimePipelineTurnContext<TInput>): TState | Promise<TState>;
+    /** Critical durable commit after paired tool results; failure ends execution. */
+    checkpoint?(state: TState, executions: readonly RuntimePipelineToolExecution<TCall, TToolResult>[], context: RuntimePipelineTurnContext<TInput>): void | Promise<void>;
     onCompleted?(state: TState, output: TOutput | undefined, context: RuntimePipelineTurnContext<TInput>): void | Promise<void>;
     onStopped?(state: TState, executions: readonly RuntimePipelineToolExecution<TCall, TToolResult>[], context: RuntimePipelineTurnContext<TInput>): void | Promise<void>;
     onCancelled?(state: TState | undefined, context: RuntimePipelineTurnContext<TInput>): void | Promise<void>;

package/dist/pipeline.js

@@ -81,12 +81,17 @@ export function createRuntimePipeline(options) {
                 state = await options.model.initialize(input, turnContext(0));
                 for (let turn = 0; turn < maxTurns; turn += 1) {
                     throwIfAborted(signal);
+                    if (input.shouldYield?.() === true)
+                        return await yieldRun();
                     turns = turn + 1;
                     const currentContext = turnContext(turn);
                     const outcome = await options.model.runTurn(state, currentContext);
                     state = outcome.state;
-                    if (outcome.kind === 'continue')
+                    if (outcome.kind === 'continue') {
+                        if (input.shouldYield?.() === true)
+                            return await yieldRun();
                         continue;
+                    }
                     if (outcome.kind === 'completed') {
                         await options.model.onCompleted?.(state, outcome.output, currentContext);
                         if (input.streamId) {
@@ -114,6 +119,7 @@ export function createRuntimePipeline(options) {
                         if (options.tools.notExecuted) {
                             const denied = await Promise.all(outcome.calls.map(call => options.tools.notExecuted(call, 'max_tool_calls_exceeded')));
                             state = await options.model.applyToolResults(state, denied, currentContext);
+                            await options.model.checkpoint?.(state, denied, currentContext);
                         }
                         return await exhaust('max_tool_calls_exceeded');
                     }
@@ -162,6 +168,7 @@ export function createRuntimePipeline(options) {
                     }
                     state = await options.model.applyToolResults(state, executions, currentContext);
                     throwIfAborted(signal);
+                    await options.model.checkpoint?.(state, executions, currentContext);
                     try {
                         await options.lifecycle?.toolResultsApplied?.(state, executions, currentContext);
                     }
@@ -188,7 +195,7 @@ export function createRuntimePipeline(options) {
                             reason: terminalExecution.terminalReason || 'tool_requested_stop',
                         };
                     }
-                    if (toolCalls >= sliceToolCalls)
+                    if (toolCalls >= sliceToolCalls || input.shouldYield?.() === true)
                         return await yieldRun();
                 }
                 return input.yieldAtTurnLimit ? await yieldRun() : await exhaust('max_turns_exceeded');

package/dist/runtime.js

@@ -130,9 +130,15 @@ export function createRuntimeSdk(options) {
             decision: mostRestrictiveHookDecision(postRecords),
             records: postRecords,
         });
-        const result = options.host.appendHookEvidence
+        let result = options.host.appendHookEvidence
             ? options.host.appendHookEvidence(execution.result, [...preRecords, ...postRecords], preDecision)
             : execution.result;
+        // Host-only sideband must survive a Hook Evidence clone without becoming
+        // enumerable event/storage data. Model-supplied fields cannot create it.
+        const sideband = Object.getOwnPropertyDescriptor(execution.result, 'modelContext');
+        if (result !== execution.result && sideband && sideband.enumerable === false) {
+            result = Object.defineProperty({ ...result }, 'modelContext', sideband);
+        }
         const resolvedExecution = { ...execution, result };
         emit({ type: 'tool.completed', ...eventBase, decision: preDecision, result });
         return resolvedExecution;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peer-agent/runtime-sdk",
-  "version": "0.1.0-rc.10",
+  "version": "0.1.0-rc.12",
   "description": "Public host-neutral orchestration SDK for Peer Agent runtimes.",
   "type": "module",
   "license": "MIT",
@@ -34,8 +34,8 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@peer-agent/protocol": "^0.1.0-rc.10",
-    "@peer-agent/runtime-core": "^0.1.0-rc.10"
+    "@peer-agent/protocol": "^0.1.0-rc.12",
+    "@peer-agent/runtime-core": "^0.1.0-rc.12"
   },
   "devDependencies": {
     "typescript": "^5.9.3"