@springbrand/agent-runtime 0.3.0-alpha.5 → 0.3.0-alpha.6

package/package.json

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

package/src/config/harness-runtime.ts

@@ -1,5 +1,6 @@
 import {
   createModels,
+  lazyStream,
   type MutableModels,
 } from "@earendil-works/pi-ai";
 import {
@@ -23,6 +24,7 @@ import {
   type PreparePiRuntimeOptions,
   type PreparedPiRuntime,
 } from "./pinning";
+import { refreshModelGuidance } from "./model-guidance";
 
 /**
  * Runtime 通过这个配置入口准备、固定并读取 Harness 的模型、提示和工具输入。
@@ -109,11 +111,17 @@ export class HarnessRuntimeConfig {
               : target.getModel(provider, modelId);
         }
         if (property === "streamSimple") {
-          return withProviderBoundary(
+          const stream = withProviderBoundary(
             target.streamSimple.bind(target),
             request.modelSessionId,
             request.onGeneration,
           );
+          return ((model, context, options) => lazyStream(model, async () => {
+            options?.signal?.throwIfAborted();
+            const refreshed = await refreshModelGuidance(state.candidates, context);
+            options?.signal?.throwIfAborted();
+            return stream(model, refreshed, options);
+          })) satisfies typeof stream;
         }
         if (property === "completeSimple") {
           return target.completeSimple.bind(models);

package/src/config/model-guidance.ts

@@ -0,0 +1,21 @@
+import type { Context } from "@earendil-works/pi-ai";
+import type { PiToolCandidate } from "../tools/compiler";
+
+/** Only descriptions and guidance may vary inside a pinned Submission. */
+export async function refreshModelGuidance(
+  candidates: readonly PiToolCandidate[],
+  context: Context,
+): Promise<Context> {
+  const guidance = new Map(await Promise.all(candidates
+    .filter(candidate => candidate.modelGuidance && context.tools?.some(tool => tool.name === candidate.tool.name))
+    .map(async candidate => [candidate.tool.name, await candidate.modelGuidance!()] as const)));
+  if (!guidance.size) return context;
+  return {
+    ...context,
+    systemPrompt: [context.systemPrompt, ...new Set([...guidance.values()].map(item => item.systemPrompt).filter(Boolean))].filter(Boolean).join("\n\n"),
+    tools: context.tools?.map(tool => {
+      const prompt = guidance.get(tool.name);
+      return prompt ? { ...tool, description: prompt.description } : tool;
+    }),
+  };
+}

package/src/harness/session-harness.ts

@@ -175,12 +175,13 @@ export class SessionHarness<TContext extends object | undefined> {
   }
 
   private async operationEntries(context: Context): Promise<Entry[]> {
+    // Stop boundaries follow traversal order; walk back from the current tip.
     const entries = await this.lane.findEntries({
       ...(this.operationStartTip === null ? {} : { stopAtId: this.operationStartTip }),
       type: "message",
-      order: "oldestFirst",
+      order: "newestFirst",
     }, context);
-    return entries.filter(({ id }) => id !== this.operationStartTip);
+    return entries.filter(({ id }) => id !== this.operationStartTip).reverse();
   }
 
   private async restoreToolGovernance(context: Context): Promise<void> {

package/src/tools/compiler.ts

@@ -62,6 +62,8 @@ export interface PiToolConfirmationSpec {
 }
 
 export interface PiToolCandidate {
+  /** Presentation only, resolved at the model boundary; never changes approved execution inputs. */
+  readonly modelGuidance?: () => Promise<{ description: string; systemPrompt?: string }>;
   readonly confirmation?: PiToolConfirmationSpec;
   readonly owner: string;
   readonly tool: AgentTool<any, any>;