@cline/shared 0.0.38-nightly.1778113663

package/dist/tools/create.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import type { AgentTool, AgentToolContext } from "../agent";
+export declare function createTool<TInput, TOutput>(config: {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    execute: (input: TInput, context: AgentToolContext) => Promise<TOutput>;
+    lifecycle?: AgentTool<TInput, TOutput>["lifecycle"];
+    timeoutMs?: number;
+    retryable?: boolean;
+    maxRetries?: number;
+}): AgentTool<TInput, TOutput>;
+export declare function createTool<TSchema extends z.ZodTypeAny, TOutput>(config: {
+    name: string;
+    description: string;
+    inputSchema: TSchema;
+    execute: (input: z.infer<TSchema>, context: AgentToolContext) => Promise<TOutput>;
+    lifecycle?: AgentTool<z.infer<TSchema>, TOutput>["lifecycle"];
+    timeoutMs?: number;
+    retryable?: boolean;
+    maxRetries?: number;
+}): AgentTool<z.infer<TSchema>, TOutput>;

package/dist/types/auth.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Canonical list of OAuth provider IDs managed by the platform.
+ * Derive sets, types, and guards from this single source of truth.
+ */
+export declare const OAUTH_PROVIDER_IDS: readonly ["cline", "oca", "openai-codex"];
+export type OAuthProviderId = (typeof OAUTH_PROVIDER_IDS)[number];
+/**
+ * Check whether a provider ID is a managed OAuth provider.
+ */
+export declare function isOAuthProviderId(providerId: string): providerId is OAuthProviderId;
+/**
+ * Error‑message sub-strings that indicate an auth / credential failure.
+ * Used to decide whether a failed API call should trigger an OAuth refresh.
+ */
+export declare const AUTH_ERROR_PATTERNS: readonly ["401", "403", "unauthorized", "forbidden", "invalid token", "expired token", "authentication"];
+/**
+ * Returns `true` when `error` looks like an authentication failure
+ * *and* the provider is a managed OAuth provider.
+ */
+export declare function isLikelyAuthError(error: unknown, providerId: string): boolean;

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./auth";
+export * from "./vcr";

package/dist/types/vcr.d.ts

@@ -0,0 +1,12 @@
+/** A single recorded HTTP interaction (nock-compatible shape). */
+export interface VcrRecording {
+    scope: string;
+    method: string;
+    path: string;
+    body?: string;
+    status: number;
+    response: unknown;
+    responseIsBinary: boolean;
+    /** Content-Type header from the original response (captured at record time). */
+    contentType?: string;
+}

package/dist/vcr.d.ts

@@ -0,0 +1,39 @@
+/**
+ * VCR (Video Cassette Recorder) for HTTP requests.
+ *
+ * Patches `globalThis.fetch` to record and replay HTTP interactions,
+ * enabling deterministic testing without making real API calls.
+ *
+ * Unlike nock (which patches Node's `http` module), this works by wrapping
+ * `globalThis.fetch` directly — catching all HTTP traffic in this codebase
+ * including calls made through the OpenAI, Anthropic, Gemini, and Vercel AI
+ * SDKs (all of which delegate to the global fetch).
+ *
+ * Environment variables:
+ *   CLINE_VCR           - "record" to record HTTP requests, "playback" to replay them
+ *   CLINE_VCR_CASSETTE  - Path to the cassette file (default: ./vcr-cassette.json)
+ *   CLINE_VCR_FILTER    - Substring to filter recorded/replayed request paths.
+ *                         When set to a non-empty string, only requests whose path
+ *                         contains this substring are recorded/replayed; all other
+ *                         requests pass through to the real network.
+ *                         When empty or unset, ALL requests are intercepted (no filter).
+ *   CLINE_VCR_SSE_DELAY - Milliseconds between SSE chunks during playback (default: 100).
+ *                         Set to 0 for instant delivery.
+ *
+ * Usage:
+ *   # Record only inference requests
+ *   CLINE_VCR=record CLINE_VCR_CASSETTE=./fixtures/my-test.json clite task "hello"
+ *
+ *   # Replay — auth/S3/etc. requests go through normally, only inference is mocked
+ *   CLINE_VCR=playback CLINE_VCR_CASSETTE=./fixtures/my-test.json clite task "hello"
+ *
+ *   # Record everything (no filter)
+ *   CLINE_VCR=record CLINE_VCR_FILTER="" CLINE_VCR_CASSETTE=./fixtures/all.json clite task "hello"
+ */
+/**
+ * Initialize VCR mode based on environment variables.
+ * Must be called early in startup, before HTTP requests are made.
+ *
+ * Does nothing if `CLINE_VCR` is not set.
+ */
+export declare function initVcr(vcrMode: string | undefined): void;

package/package.json

@@ -0,0 +1,65 @@
+{
+	"name": "@cline/shared",
+	"version": "0.0.38-nightly.1778113663",
+	"description": "Shared utilities, types, and schemas for Cline packages",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/cline/sdk",
+		"directory": "packages/shared"
+	},
+	"type": "module",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"browser": "./dist/index.browser.js",
+			"development": "./src/index.ts",
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
+		},
+		"./browser": {
+			"development": "./src/index.browser.ts",
+			"types": "./dist/index.browser.d.ts",
+			"import": "./dist/index.browser.js"
+		},
+		"./types": {
+			"development": "./src/types/index.ts",
+			"types": "./dist/types/index.d.ts",
+			"import": "./dist/types/index.js"
+		},
+		"./storage": {
+			"development": "./src/storage/index.ts",
+			"types": "./dist/storage/index.d.ts",
+			"import": "./dist/storage/index.js"
+		},
+		"./db": {
+			"development": "./src/db/index.ts",
+			"types": "./dist/db/index.d.ts",
+			"import": "./dist/db/index.js"
+		},
+		"./automation": {
+			"development": "./src/automation/index.ts",
+			"types": "./dist/automation/index.d.ts",
+			"import": "./dist/automation/index.js"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "BUILD_MODE=package bun bun.mts",
+		"clean": "rm -rf dist node_modules",
+		"typecheck": "bun tsc --noEmit",
+		"test": "bun run test:unit",
+		"test:unit": "vitest run --config vitest.config.ts"
+	},
+	"engines": {
+		"node": ">=22"
+	},
+	"dependencies": {
+		"jsonrepair": "^3.13.2",
+		"zod": "^4.3.6",
+		"zod-to-json-schema": "^3.25.1"
+	}
+}