@clinebot/shared 0.0.8

package/dist/storage/paths.d.ts

@@ -0,0 +1,28 @@
+export declare const AGENT_CONFIG_DIRECTORY_NAME = "agents";
+export declare const HOOKS_CONFIG_DIRECTORY_NAME = "hooks";
+export declare const SKILLS_CONFIG_DIRECTORY_NAME = "skills";
+export declare const RULES_CONFIG_DIRECTORY_NAME = "rules";
+export declare const WORKFLOWS_CONFIG_DIRECTORY_NAME = "workflows";
+export declare const PLUGINS_DIRECTORY_NAME = "plugins";
+export declare const CLINE_MCP_SETTINGS_FILE_NAME = "cline_mcp_settings.json";
+export declare function setHomeDir(dir: string): void;
+export declare function setHomeDirIfUnset(dir: string): void;
+export declare function resolveDocumentsClineDirectoryPath(): string;
+export declare function resolveDocumentsAgentConfigDirectoryPath(): string;
+export declare function resolveDocumentsHooksDirectoryPath(): string;
+export declare function resolveDocumentsRulesDirectoryPath(): string;
+export declare function resolveDocumentsWorkflowsDirectoryPath(): string;
+export declare function resolveClineDataDir(): string;
+export declare function resolveSessionDataDir(): string;
+export declare function resolveTeamDataDir(): string;
+export declare function resolveProviderSettingsPath(): string;
+export declare function resolveMcpSettingsPath(): string;
+export declare function resolveAgentsConfigDirPath(): string;
+export declare function resolveAgentConfigSearchPaths(): string[];
+export declare function resolveHooksConfigSearchPaths(workspacePath?: string): string[];
+export declare function resolveSkillsConfigSearchPaths(workspacePath?: string): string[];
+export declare function resolveRulesConfigSearchPaths(workspacePath?: string): string[];
+export declare function resolveWorkflowsConfigSearchPaths(workspacePath?: string): string[];
+export declare function resolvePluginConfigSearchPaths(workspacePath?: string): string[];
+export declare function ensureParentDir(filePath: string): void;
+export declare function ensureHookLogDir(filePath?: string): string;

package/dist/vcr.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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"
+ */
+/** 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;
+}
+/**
+ * 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,39 @@
+{
+	"name": "@clinebot/shared",
+	"version": "0.0.8",
+	"description": "[INTERNAL] Shared utilities, types, and schemas for Cline packages",
+	"type": "module",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"development": "./src/index.ts",
+			"types": "./dist/index.d.ts",
+			"import": "./dist/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"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "BUILD_MODE=package bun bun.mts",
+		"clean": "rm -rf dist node_modules",
+		"typecheck": "bun tsc --noEmit"
+	},
+	"dependencies": {
+		"better-sqlite3": "^11.10.0",
+		"jsonrepair": "^3.13.2",
+		"zod": "^4.3.6",
+		"zod-to-json-schema": "^3.25.1"
+	}
+}