@ai-sdk/harness-pi 1.0.94 → 1.0.96

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/harness-pi",
-  "version": "1.0.94",
+  "version": "1.0.96",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -26,10 +26,10 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/harness": "1.0.92",
-    "@ai-sdk/provider-utils": "5.0.32",
+    "@ai-sdk/harness": "1.0.94",
+    "@ai-sdk/provider-utils": "5.0.34",
     "@earendil-works/pi-ai": "0.74.2",
-    "@earendil-works/pi-coding-agent": "^0.80.10",
+    "@earendil-works/pi-coding-agent": "^0.84.3",
     "pi-mcp-adapter": "2.12.1",
     "typebox": "^1.1.38"
   },
@@ -37,7 +37,7 @@
     "zod": "^3.25.76 || ^4.1.8"
   },
   "devDependencies": {
-    "@ai-sdk/sandbox-just-bash": "1.0.92",
+    "@ai-sdk/sandbox-just-bash": "1.0.94",
     "@types/node": "22.19.19",
     "@vercel/ai-tsconfig": "0.0.0",
     "tsup": "^8.5.1",

package/src/pi-harness.ts

@@ -27,6 +27,8 @@ export type PiHarnessSettings = {
    * Pi model id (or name). Leaving this unset falls back to the AI Gateway
    * default when `AI_GATEWAY_API_KEY` / `VERCEL_OIDC_TOKEN` is set, and to
    * Pi's own resolution otherwise.
+   *
+   * @deprecated Use `model` on `HarnessAgent` instead.
    */
   readonly model?: string;
   /**
@@ -149,10 +151,9 @@ export function createPi(
         sessionId: startOpts.sessionId,
         sandboxSession: startOpts.sandboxSession,
         sessionWorkDir: startOpts.sessionWorkDir,
-        skills: startOpts.skills ?? [],
         settings: {
           ...(settings.auth ? { auth: settings.auth } : {}),
-          ...(settings.model ? { model: settings.model } : {}),
+          ...(settings.model == null ? {} : { model: settings.model }),
           ...(settings.thinkingLevel
             ? { thinkingLevel: settings.thinkingLevel }
             : {}),

package/src/pi-session.ts

@@ -212,7 +212,8 @@ export type PiThinkingLevel =
   | 'low'
   | 'medium'
   | 'high'
-  | 'xhigh';
+  | 'xhigh'
+  | 'max';
 
 export interface PiSessionSettings {
   readonly auth?: PiAuthenticationMode;
@@ -226,7 +227,6 @@ export interface CreatePiSessionInput {
   readonly sessionId: string;
   readonly sandboxSession: HarnessV1NetworkSandboxSession | SandboxSession;
   readonly sessionWorkDir: string;
-  readonly skills: ReadonlyArray<HarnessV1Skill>;
   readonly settings: PiSessionSettings;
   readonly clientApp: string;
   readonly isResume: boolean;
@@ -331,24 +331,13 @@ export async function createPiSession(
     sessionId: input.sessionId,
   });
   const permissionMode = input.permissionMode ?? 'allow-all';
-  let sandboxSkillRootDir: string | undefined;
+  const sandboxSkillRootDir = path.posix.join(
+    sandboxHomeDir,
+    '.agents',
+    'skills',
+  );
   let harnessSkills: Skill[] = [];
 
-  // Materialise harness-provided skills into sandbox HOME, not the workspace.
-  if (input.skills.length > 0) {
-    sandboxSkillRootDir = path.posix.join(sandboxHomeDir, '.agents', 'skills');
-    harnessSkills = createHarnessPiSkills({
-      skills: input.skills,
-      sandboxSkillRootDir,
-    });
-    await writePiSkills({
-      sandbox: toolSafeSandboxSession,
-      sandboxHomeDir,
-      skills: input.skills,
-      ...(input.abortSignal ? { abortSignal: input.abortSignal } : {}),
-    });
-  }
-
   // On resume: pull the Pi session file out of the sandbox into the fresh
   // host mirror so SessionManager.open can read it.
   let resumeSessionFilePath: string | undefined;
@@ -384,9 +373,7 @@ export async function createPiSession(
   const paths = createPiPathMapper({
     hostWorkDir,
     sandboxWorkDir: sessionWorkDir,
-    readableRoots: sandboxSkillRootDir
-      ? [{ sandboxDir: sandboxSkillRootDir }]
-      : [],
+    readableRoots: [{ sandboxDir: sandboxSkillRootDir }],
   });
 
   // Pi auth + model registry are global to this Pi session. These live on the
@@ -428,9 +415,7 @@ export async function createPiSession(
     modelRegistry,
     env: resolverEnv,
   });
-  // Resolve once: deterministic given the configured model. This is the Pi
-  // `Model` object handed to `createAgentSession`.
-  const resolvedModel = resolveModel(input.settings.model);
+  let activeResolvedModel = resolveModel(input.settings.model);
   const mcpServers = resolvePiMcpServers({
     mcpServers: input.settings.mcpServers,
   });
@@ -797,6 +782,8 @@ export async function createPiSession(
           // rebuilding the Pi session from it.
           const control = await runTurn({
             text: '',
+            ...(continueOpts.model ? { model: continueOpts.model } : {}),
+            skills: continueOpts.skills,
             tools: continueOpts.tools ?? [],
             instructions: continueOpts.instructions,
             emit: continueOpts.emit,
@@ -1027,7 +1014,7 @@ export async function createPiSession(
       ...(input.settings.thinkingLevel
         ? { thinkingLevel: input.settings.thinkingLevel }
         : {}),
-      ...(resolvedModel ? { model: resolvedModel } : {}),
+      ...(activeResolvedModel ? { model: activeResolvedModel } : {}),
     });
     piSession = session;
     if (hasMcpServers) {
@@ -1073,6 +1060,8 @@ export async function createPiSession(
    */
   async function runTurn(turnOpts: {
     text: string;
+    model?: string;
+    skills: ReadonlyArray<HarnessV1Skill>;
     tools: ReadonlyArray<HarnessV1ToolSpec>;
     instructions?: string;
     emit: (part: HarnessV1StreamPart) => void;
@@ -1082,6 +1071,20 @@ export async function createPiSession(
       throw new Error('Pi session has been stopped.');
     }
 
+    const skillWriteResult = await writePiSkills({
+      sandbox: toolSafeSandboxSession,
+      sandboxHomeDir,
+      skills: turnOpts.skills,
+      abortSignal: turnOpts.abortSignal,
+    });
+    harnessSkills = createHarnessPiSkills({
+      skills: turnOpts.skills,
+      sandboxSkillRootDir,
+    });
+    if (piSession != null && skillWriteResult.changed) {
+      await reloadResourcesOnly();
+    }
+
     const userTools = turnOpts.tools;
     currentEmit = turnOpts.emit;
     const turnAbortController = new AbortController();
@@ -1108,6 +1111,10 @@ export async function createPiSession(
         const didAppendDeliveredHostToolResults =
           appendDeliveredHostToolResults();
 
+        const nextModel =
+          turnOpts.model == null ? undefined : resolveModel(turnOpts.model);
+        if (nextModel != null) activeResolvedModel = nextModel;
+
         const signature = JSON.stringify(userTools.map(t => t.name).sort());
         const needsRebuild =
           piSession == null || signature !== lastToolsSignature;
@@ -1119,6 +1126,14 @@ export async function createPiSession(
           );
           turnAbortController.signal.throwIfAborted();
           lastToolsSignature = signature;
+        } else if (
+          nextModel != null &&
+          piSession != null &&
+          (piSession.model?.provider !== nextModel.provider ||
+            piSession.model.id !== nextModel.id)
+        ) {
+          await piSession.setModel(nextModel);
+          turnAbortController.signal.throwIfAborted();
         }
 
         if (!resourcesReloaded) {
@@ -1140,7 +1155,10 @@ export async function createPiSession(
           nativeToCommon: NATIVE_TO_COMMON,
         });
 
-        currentEmit?.({ type: 'stream-start' });
+        currentEmit?.({
+          type: 'stream-start',
+          ...(piSession?.model?.id ? { modelId: piSession.model.id } : {}),
+        });
 
         /*
          * A live continuation reports the completed tool execution before the
@@ -1315,10 +1333,6 @@ export async function createPiSession(
   const sessionImpl: HarnessV1Session = {
     sessionId: input.sessionId,
     isResume: input.isResume,
-    // The model Pi actually resolves to (the configured id, or its default when
-    // unset) — `gen_ai.request.model`.
-    ...(resolvedModel?.id ? { modelId: resolvedModel.id } : {}),
-
     // Pi has no bridge to attach to and no on-disk event log to replay; its
     // only resume path is restoring the session file on a fresh/snapshotted
     // sandbox, i.e. `rerun`.
@@ -1334,6 +1348,8 @@ export async function createPiSession(
       }
       return runTurn({
         text: extractUserText(promptOpts.prompt),
+        ...(promptOpts.model ? { model: promptOpts.model } : {}),
+        skills: promptOpts.skills,
         tools: promptOpts.tools ?? [],
         instructions: promptOpts.instructions,
         emit: promptOpts.emit,
@@ -1390,6 +1406,8 @@ export async function createPiSession(
        */
       return runTurn({
         text: '',
+        ...(continueOpts.model ? { model: continueOpts.model } : {}),
+        skills: continueOpts.skills,
         tools: continueOpts.tools ?? [],
         instructions: continueOpts.instructions,
         emit: continueOpts.emit,

package/src/pi-skills.ts

@@ -1,6 +1,6 @@
 import path from 'node:path';
 import type { HarnessV1Skill } from '@ai-sdk/harness';
-import { writeSkills } from '@ai-sdk/harness/utils';
+import { writeSkills, type WriteSkillsResult } from '@ai-sdk/harness/utils';
 import type { Experimental_SandboxSession } from '@ai-sdk/provider-utils';
 
 /**
@@ -12,8 +12,8 @@ export async function writePiSkills(args: {
   readonly sandboxHomeDir: string;
   readonly skills: ReadonlyArray<HarnessV1Skill>;
   readonly abortSignal?: AbortSignal;
-}): Promise<void> {
-  await writeSkills({
+}): Promise<WriteSkillsResult> {
+  return writeSkills({
     sandbox: args.sandbox,
     rootDir: path.posix.join(args.sandboxHomeDir, '.agents', 'skills'),
     skills: args.skills,