@ai-sdk/harness-pi 0.0.0 → 1.0.0-canary.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# @ai-sdk/harness-pi
+
+## 1.0.0-canary.0
+
+### Major Changes
+
+- 3d9a50c: feat(harness): implement harness adapters for Claude Code, Codex, Pi
+
+### Patch Changes
+
+- Updated dependencies [3d9a50c]
+  - @ai-sdk/harness@1.0.0-canary.4

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2023 Vercel, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,52 @@
+# AI SDK - Pi Harness
+
+`HarnessV1` adapter backed by [`@earendil-works/pi-coding-agent`](https://www.npmjs.com/package/@earendil-works/pi-coding-agent). Pi runs in the host Node.js process and uses the sandbox as a remote filesystem + shell — no bridge process is installed inside the sandbox.
+
+## Setup
+
+```bash
+npm i @ai-sdk/harness-pi @ai-sdk/harness @ai-sdk/sandbox-vercel @earendil-works/pi-coding-agent
+```
+
+## Usage
+
+```ts
+import { HarnessAgent } from '@ai-sdk/harness/agent';
+import { createPi } from '@ai-sdk/harness-pi';
+import { createVercelSandbox } from '@ai-sdk/sandbox-vercel';
+import { tool } from 'ai';
+import { z } from 'zod/v4';
+
+const agent = new HarnessAgent({
+  harness: createPi({ thinkingLevel: 'medium' }),
+  id: 'demo',
+  sandbox: createVercelSandbox({ runtime: 'node24' }),
+  skills: [
+    {
+      name: 'careful-refactors',
+      description: 'Make minimal diffs and keep tests green.',
+      content: 'Prefer changes that touch the fewest files possible.',
+    },
+  ],
+  tools: {
+    deploy: tool({
+      description: 'Deploy a service.',
+      inputSchema: z.object({ env: z.enum(['staging', 'production']) }),
+      execute: async ({ env }) => ({ url: `https://${env}.example.com` }),
+    }),
+  },
+});
+
+const session = await agent.createSession();
+try {
+  const result = await agent.generate({
+    session,
+    prompt: 'Read README.md and summarise the goals.',
+  });
+  console.log(result.text);
+} finally {
+  await session.destroy();
+}
+```
+
+The adapter requires a `HarnessV1SandboxProvider`. Pi has no in-sandbox bridge, so the sandbox doesn't need to expose any ports — `@ai-sdk/sandbox-vercel` or `@ai-sdk/sandbox-just-bash` both work.

package/dist/index.d.ts

@@ -0,0 +1,122 @@
+import * as _ai_sdk_harness from '@ai-sdk/harness';
+import { HarnessV1, HarnessV1BuiltinTool } from '@ai-sdk/harness';
+
+/**
+ * Pi auth options. Exactly one of `gateway` or `customEnv` is honoured
+ * (precedence: explicit `customEnv`, then explicit `gateway`, then ambient
+ * gateway from `process.env`). To use multiple providers, use `customEnv`
+ * with the standard `<PREFIX>_API_KEY` / `<PREFIX>_BASE_URL` pattern.
+ */
+type PiAuthOptions = {
+    readonly gateway?: {
+        readonly apiKey?: string;
+        readonly baseUrl?: string;
+    };
+    /**
+     * Resolved environment-variable pairs of the form `<PREFIX>_API_KEY` and
+     * (optionally) `<PREFIX>_BASE_URL`. Special-cased prefixes:
+     *  - `AI_GATEWAY` → registers `vercel-ai-gateway`
+     *  - `OPENAI`     → registers `openai`
+     *  - `ANTHROPIC`  → registers `anthropic` (`ANTHROPIC_AUTH_TOKEN` adds a
+     *                   bearer auth header)
+     * Any other `<PREFIX>_API_KEY` with a matching `<PREFIX>_BASE_URL` is
+     * registered as the lowercased, dash-separated prefix.
+     */
+    readonly customEnv?: Record<string, string>;
+};
+
+type PiThinkingLevel = 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
+
+/**
+ * Configuration knobs for `createPi`. Pi runs as an in-process Node library
+ * (no bridge), so there's no `port` or `startupTimeoutMs` to set.
+ */
+type PiHarnessSettings = {
+    /** Where Pi sources API keys / gateway credentials from. */
+    readonly auth?: PiAuthOptions;
+    /**
+     * 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.
+     */
+    readonly model?: string;
+    /**
+     * Pi's extended-thinking budget level. Maps directly to the SDK's
+     * `thinkingLevel` option on `createAgentSession`.
+     */
+    readonly thinkingLevel?: PiThinkingLevel;
+};
+declare const PI_BUILTIN_TOOLS: {
+    readonly read: HarnessV1BuiltinTool<{
+        file_path: string;
+    }, unknown>;
+    readonly write: HarnessV1BuiltinTool<{
+        file_path: string;
+        content: string;
+    }, unknown>;
+    readonly edit: HarnessV1BuiltinTool<{
+        file_path: string;
+        old_string: string;
+        new_string: string;
+    }, unknown>;
+    readonly bash: HarnessV1BuiltinTool<{
+        command: string;
+        timeout?: number | undefined;
+    }, unknown>;
+    readonly grep: HarnessV1BuiltinTool<{
+        pattern: string;
+        glob?: string | undefined;
+        path?: string | undefined;
+        ignoreCase?: boolean | undefined;
+        literal?: boolean | undefined;
+        context?: number | undefined;
+        limit?: number | undefined;
+    }, unknown>;
+    readonly glob: HarnessV1BuiltinTool<{
+        pattern: string;
+        path?: string | undefined;
+        limit?: number | undefined;
+    }, unknown>;
+    readonly ls: HarnessV1BuiltinTool;
+};
+declare function createPi(settings?: PiHarnessSettings): HarnessV1<typeof PI_BUILTIN_TOOLS>;
+
+/**
+ * Default `pi` harness instance with no overrides — suitable for the common
+ * case where Pi's defaults are fine. Equivalent to `createPi()`.
+ */
+declare const pi: _ai_sdk_harness.HarnessV1<{
+    readonly read: _ai_sdk_harness.HarnessV1BuiltinTool<{
+        file_path: string;
+    }, unknown>;
+    readonly write: _ai_sdk_harness.HarnessV1BuiltinTool<{
+        file_path: string;
+        content: string;
+    }, unknown>;
+    readonly edit: _ai_sdk_harness.HarnessV1BuiltinTool<{
+        file_path: string;
+        old_string: string;
+        new_string: string;
+    }, unknown>;
+    readonly bash: _ai_sdk_harness.HarnessV1BuiltinTool<{
+        command: string;
+        timeout?: number | undefined;
+    }, unknown>;
+    readonly grep: _ai_sdk_harness.HarnessV1BuiltinTool<{
+        pattern: string;
+        glob?: string | undefined;
+        path?: string | undefined;
+        ignoreCase?: boolean | undefined;
+        literal?: boolean | undefined;
+        context?: number | undefined;
+        limit?: number | undefined;
+    }, unknown>;
+    readonly glob: _ai_sdk_harness.HarnessV1BuiltinTool<{
+        pattern: string;
+        path?: string | undefined;
+        limit?: number | undefined;
+    }, unknown>;
+    readonly ls: _ai_sdk_harness.HarnessV1BuiltinTool;
+}>;
+
+export { type PiAuthOptions, type PiHarnessSettings, createPi, pi };