@ai-sdk/harness-cline 0.0.0 → 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# @ai-sdk/harness-cline
+
+## 1.0.1
+
+### Patch Changes
+
+- 62a9c2a: feat(harness): add support for structured output to `HarnessAgent` via `output` property
+- Updated dependencies [62a9c2a]
+- Updated dependencies [d25cae2]
+  - @ai-sdk/harness@1.0.73
+
+## 1.0.0
+
+### Major Changes
+
+- 80b40aa: feat(harness-cline): implement Cline harness adapter
+
+### Patch Changes
+
+- Updated dependencies [69bb613]
+- Updated dependencies [52bc889]
+- Updated dependencies [4cd4989]
+  - @ai-sdk/harness@1.0.72

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

@@ -1,5 +1,58 @@
-# @ai-sdk/harness-cline
+# AI SDK - Cline Harness
 
-AI SDK harness adapter for Cline.
+`HarnessV1` adapter backed by [`@cline/agents`](https://www.npmjs.com/package/@cline/agents). Cline runs in the host Node.js process and uses the sandbox as a remote filesystem and shell, so no bridge process is installed inside the sandbox.
 
-The implementation is maintained in the `vercel/ai` repository.
+## Setup
+
+```bash
+npm i @ai-sdk/harness-cline @ai-sdk/harness @ai-sdk/sandbox-vercel
+```
+
+## Usage
+
+```ts
+import { HarnessAgent } from '@ai-sdk/harness/agent';
+import { createCline } from '@ai-sdk/harness-cline';
+import { createVercelSandbox } from '@ai-sdk/sandbox-vercel';
+import { tool } from 'ai';
+import { z } from 'zod/v4';
+
+const agent = new HarnessAgent({
+  harness: createCline({ reasoningEffort: '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`. Cline has no in-sandbox bridge, so the sandbox does not need to expose any ports. Its built-in tools operate on the session sandbox remotely from the host process.
+
+## Authentication
+
+The default `auto` authentication mode uses `AI_GATEWAY_API_KEY` or `VERCEL_OIDC_TOKEN` when available and otherwise falls back to `CLINE_API_KEY`. Use `createCline({ auth: 'ai-gateway' })` or `createCline({ auth: 'direct' })` to select a mode explicitly. `AI_GATEWAY_BASE_URL` and `CLINE_API_BASE_URL` configure their respective endpoints.
+
+See the [Cline harness documentation](https://ai-sdk.dev/providers/ai-sdk-harnesses/cline) for model configuration, reasoning, tools, skills, MCP, and session lifecycle details.

package/dist/index.d.ts

@@ -0,0 +1,127 @@
+import * as _ai_sdk_harness from '@ai-sdk/harness';
+import { HarnessV1, HarnessV1BuiltinTool } from '@ai-sdk/harness';
+
+type ClineAuthenticationMode = 'auto' | 'direct' | 'ai-gateway';
+type ClineAuthOptions = ClineAuthenticationMode;
+
+type ClineReasoningEffort = 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+
+/**
+ * Configuration knobs for `createCline`. The Cline runtime
+ * (`@cline/agents`, part of the Cline SDK) runs as an in-process Node
+ * library — no bridge, so there is no `port` or `startupTimeoutMs` to set.
+ */
+type ClineHarnessSettings = {
+    /** Where Cline sources direct or AI Gateway credentials from. */
+    readonly auth?: ClineAuthOptions;
+    /**
+     * MCP server definitions keyed by server name. Each definition uses the
+     * underlying runtime's native MCP server configuration format.
+     */
+    readonly mcpServers?: Record<string, unknown>;
+    /**
+     * Cline LLM provider id (e.g. `'anthropic'`, `'openai'`, `'gemini'`).
+     * When omitted, direct authentication uses the Cline backend.
+     */
+    readonly providerId?: string;
+    /**
+     * Model id for the configured provider. When omitted, Cline selects the
+     * provider's default model.
+     */
+    readonly modelId?: string;
+    /**
+     * Provider API key. When omitted, the Cline gateway falls back to the
+     * provider's environment variable (e.g. `ANTHROPIC_API_KEY`).
+     */
+    readonly apiKey?: string;
+    /** Custom provider endpoint. */
+    readonly baseUrl?: string;
+    /** Extra headers sent to the provider. */
+    readonly headers?: Record<string, string>;
+    /**
+     * Reasoning effort for reasoning-capable models. Use `'none'` to disable
+     * reasoning. When omitted, the Cline SDK selects the reasoning behavior.
+     */
+    readonly reasoningEffort?: ClineReasoningEffort;
+    /**
+     * Safety cap on agent-loop iterations per turn. Unbounded when omitted.
+     */
+    readonly maxIterations?: number;
+};
+declare const CLINE_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;
+        path?: string | undefined;
+        glob?: 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 createCline(settings?: ClineHarnessSettings): HarnessV1<typeof CLINE_BUILTIN_TOOLS>;
+
+declare const VERSION: string;
+
+/**
+ * Default `cline` harness instance with no overrides — suitable for the
+ * common case where the Cline SDK's defaults are fine. Equivalent to
+ * `createCline()`.
+ */
+declare const cline: _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;
+        path?: string | undefined;
+        glob?: 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 ClineAuthOptions, type ClineAuthenticationMode, type ClineHarnessSettings, VERSION, cline, createCline };