@clinebot/core 0.0.34 → 0.0.36

package/src/auth/utils.test.ts

@@ -1,128 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import {
-	decodeJwtPayload,
-	isCredentialLikelyExpired,
-	parseAuthorizationInput,
-	parseOAuthError,
-	resolveAuthorizationCodeInput,
-	resolveUrl,
-} from "./utils";
-
-function toBase64Url(value: string): string {
-	return Buffer.from(value, "utf8").toString("base64url");
-}
-
-function createJwt(payload: Record<string, unknown>): string {
-	return `${toBase64Url(JSON.stringify({ alg: "none", typ: "JWT" }))}.${toBase64Url(JSON.stringify(payload))}.sig`;
-}
-
-describe("auth/utils", () => {
-	it("parses auth input from full URL with provider", () => {
-		const parsed = parseAuthorizationInput(
-			"http://localhost/callback?code=test-code&state=s1&provider=google",
-			{
-				includeProvider: true,
-			},
-		);
-		expect(parsed).toEqual({
-			code: "test-code",
-			state: "s1",
-			provider: "google",
-		});
-	});
-
-	it("parses auth input from hash format when enabled", () => {
-		const parsed = parseAuthorizationInput("abc123#state1", {
-			allowHashCodeState: true,
-		});
-		expect(parsed).toEqual({ code: "abc123", state: "state1" });
-	});
-
-	it("builds resolved URLs from base + path", () => {
-		expect(resolveUrl("https://example.com/", "/token")).toBe(
-			"https://example.com/token",
-		);
-	});
-
-	it("decodes JWT payload", () => {
-		const token = createJwt({ sub: "account-1", exp: 123 });
-		expect(decodeJwtPayload(token)).toMatchObject({
-			sub: "account-1",
-			exp: 123,
-		});
-		expect(decodeJwtPayload("invalid")).toBeNull();
-	});
-
-	it("parses OAuth error payloads from string and object forms", () => {
-		expect(
-			parseOAuthError(
-				JSON.stringify({
-					error: "invalid_grant",
-					error_description: "expired",
-				}),
-			),
-		).toEqual({
-			code: "invalid_grant",
-			message: "expired",
-		});
-		expect(
-			parseOAuthError(
-				JSON.stringify({ error: { type: "unauthorized", message: "denied" } }),
-			),
-		).toEqual({
-			code: "unauthorized",
-			message: "denied",
-		});
-	});
-
-	it("resolves code from callback result", async () => {
-		const result = await resolveAuthorizationCodeInput({
-			waitForCallback: async () => ({
-				url: new URL("http://localhost"),
-				code: "from-callback",
-				state: "s1",
-			}),
-			cancelWait: () => {},
-		});
-		expect(result).toEqual({
-			code: "from-callback",
-			state: "s1",
-			provider: undefined,
-			error: undefined,
-		});
-	});
-
-	it("resolves code from manual input when callback does not provide one", async () => {
-		const cancelWait = vi.fn();
-		const result = await resolveAuthorizationCodeInput({
-			waitForCallback: async () => null,
-			cancelWait,
-			onManualCodeInput: async () => "code=manual&state=manual-state",
-		});
-		expect(cancelWait).toHaveBeenCalled();
-		expect(result).toEqual({
-			code: "manual",
-			state: "manual-state",
-			provider: undefined,
-		});
-	});
-
-	it("throws when manual input rejects", async () => {
-		await expect(
-			resolveAuthorizationCodeInput({
-				waitForCallback: async () => null,
-				cancelWait: () => {},
-				onManualCodeInput: async () => {
-					throw new Error("cancelled");
-				},
-			}),
-		).rejects.toThrow("cancelled");
-	});
-
-	it("checks token expiry with configurable buffer", () => {
-		const nowSpy = vi.spyOn(Date, "now").mockReturnValue(1_000);
-		expect(isCredentialLikelyExpired({ expires: 1_500 }, 600)).toBe(true);
-		expect(isCredentialLikelyExpired({ expires: 3_000 }, 600)).toBe(false);
-		nowSpy.mockRestore();
-	});
-});

package/src/extensions/config/agent-config-loader.test.ts

@@ -1,236 +0,0 @@
-import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import type { Tool, ToolContext } from "@clinebot/shared";
-import { afterEach, describe, expect, it } from "vitest";
-import {
-	AGENT_CONFIG_DIRECTORY_NAME,
-	createAgentConfigDefinition,
-	parseAgentConfigFromYaml,
-	parsePartialAgentConfigFromYaml,
-	readAgentConfigsFromDisk,
-	resolveAgentConfigSearchPaths,
-	resolveAgentsConfigDirPath,
-	resolveAgentTools,
-	resolveDocumentsAgentConfigDirectoryPath,
-	toPartialAgentConfig,
-} from "./agent-config-loader";
-
-function createMockTool(name: string): Tool {
-	return {
-		name,
-		description: `${name} tool`,
-		inputSchema: {
-			type: "object",
-			properties: {},
-		},
-		execute: async (_input: unknown, _context: ToolContext) => null,
-	};
-}
-
-describe("agent config YAML loader", () => {
-	const envSnapshot = {
-		CLINE_DATA_DIR: process.env.CLINE_DATA_DIR,
-	};
-	afterEach(() => {
-		process.env.CLINE_DATA_DIR = envSnapshot.CLINE_DATA_DIR;
-	});
-
-	it("resolves default agents settings directory from CLINE_DATA_DIR", () => {
-		process.env.CLINE_DATA_DIR = "/tmp/cline-data";
-		expect(resolveAgentsConfigDirPath()).toBe(
-			join("/tmp/cline-data", "settings", AGENT_CONFIG_DIRECTORY_NAME),
-		);
-	});
-
-	it("includes documents and settings search paths", () => {
-		process.env.CLINE_DATA_DIR = "/tmp/cline-data";
-		expect(resolveAgentConfigSearchPaths()).toEqual([
-			resolveDocumentsAgentConfigDirectoryPath(),
-			join("/tmp/cline-data", "settings", AGENT_CONFIG_DIRECTORY_NAME),
-		]);
-	});
-
-	it("builds a reusable unified watcher definition with expected defaults", () => {
-		process.env.CLINE_DATA_DIR = "/tmp/cline-data";
-		const definition = createAgentConfigDefinition();
-		expect(definition.type).toBe("agent");
-		expect(definition.directories).toEqual([
-			resolveDocumentsAgentConfigDirectoryPath(),
-			join("/tmp/cline-data", "settings", AGENT_CONFIG_DIRECTORY_NAME),
-		]);
-		expect(definition.includeFile?.("agent.yaml", "/tmp/agent.yaml")).toBe(
-			true,
-		);
-		expect(definition.includeFile?.("agent.md", "/tmp/agent.md")).toBe(false);
-	});
-
-	it("parses yaml frontmatter and prompt body", () => {
-		const content = `---
-name: Researcher
-description: Focus on repository analysis
-modelId: claude-sonnet-4-6
-tools:
-  - read_files
-  - search_codebase
-skills:
-  - context-gathering
----
-You are a focused codebase researcher.`;
-
-		const parsed = parseAgentConfigFromYaml(content);
-
-		expect(parsed).toEqual({
-			name: "Researcher",
-			description: "Focus on repository analysis",
-			modelId: "claude-sonnet-4-6",
-			tools: ["read_files", "search_codebase"],
-			skills: ["context-gathering"],
-			systemPrompt: "You are a focused codebase researcher.",
-		});
-	});
-
-	it("supports comma-separated tool and skill values", () => {
-		const parsed = parseAgentConfigFromYaml(`---
-name: Reviewer
-description: Reviews diffs
-tools: read_files,search_codebase,read_files
-skills: quality, quality,architecture
----
-Review every patch for regressions.`);
-
-		expect(parsed.tools).toEqual(["read_files", "search_codebase"]);
-		expect(parsed.skills).toEqual(["quality", "architecture"]);
-	});
-
-	it("throws when frontmatter is missing", () => {
-		expect(() => parseAgentConfigFromYaml("No frontmatter")).toThrow(
-			"Missing YAML frontmatter block in agent config file.",
-		);
-	});
-
-	it("throws for unknown tools", () => {
-		expect(() =>
-			parseAgentConfigFromYaml(`---
-name: UnknownTool
-description: test
-tools: invalid_tool
----
-prompt`),
-		).toThrow("Unknown tool 'invalid_tool'.");
-	});
-
-	it("resolves configured tool names from available tools", () => {
-		const readFiles = createMockTool("read_files");
-		const searchCodebase = createMockTool("search_codebase");
-
-		expect(
-			resolveAgentTools(
-				["read_files", "search_codebase"],
-				[searchCodebase, readFiles],
-			),
-		).toEqual([readFiles, searchCodebase]);
-	});
-
-	it("converts parsed config to partial AgentConfig", () => {
-		const readFiles = createMockTool("read_files");
-		const config = parseAgentConfigFromYaml(`---
-name: Reader
-description: Reads files
-modelId: claude-sonnet-4-6
-tools: read_files
-skills: commit, review
----
-Be precise.`);
-
-		const partial = toPartialAgentConfig(config, {
-			availableTools: [readFiles],
-		});
-
-		expect(partial.modelId).toBe("claude-sonnet-4-6");
-		expect(partial.systemPrompt).toBe("Be precise.");
-		expect(partial.tools).toEqual([readFiles]);
-		expect(partial.skills).toEqual(["commit", "review"]);
-	});
-
-	it("throws when tool overrides are configured without available tools", () => {
-		expect(() =>
-			parsePartialAgentConfigFromYaml(`---
-name: Reader
-description: Reads files
-tools: read_files
----
-Be precise.`),
-		).toThrow(
-			"Configured tools cannot be converted into AgentConfig.tools without availableTools.",
-		);
-	});
-
-	it("reads agent configs from ~/.cline/data/settings/agents-compatible directory", async () => {
-		const tempRoot = await mkdtemp(join(tmpdir(), "core-agent-config-loader-"));
-		const agentsDir = join(tempRoot, "settings", AGENT_CONFIG_DIRECTORY_NAME);
-		await mkdir(agentsDir, { recursive: true });
-		try {
-			await writeFile(
-				join(agentsDir, "reviewer.yaml"),
-				`---
-name: Reviewer
-description: Reviews patches
-tools: read_files
----
-Review code for regressions.`,
-			);
-			await writeFile(
-				join(agentsDir, "invalid.yaml"),
-				`---
-name:
----
-`,
-			);
-
-			const loaded = await readAgentConfigsFromDisk(agentsDir);
-			expect([...loaded.keys()]).toEqual(["reviewer"]);
-			expect(loaded.get("reviewer")?.systemPrompt).toBe(
-				"Review code for regressions.",
-			);
-		} finally {
-			await rm(tempRoot, { recursive: true, force: true });
-		}
-	});
-
-	it("reads from both documents and settings directories", async () => {
-		const tempRoot = await mkdtemp(join(tmpdir(), "core-agent-config-loader-"));
-		const documentsDir = join(tempRoot, "Documents", "Cline", "Agents");
-		const settingsDir = join(tempRoot, "settings", AGENT_CONFIG_DIRECTORY_NAME);
-		await mkdir(documentsDir, { recursive: true });
-		await mkdir(settingsDir, { recursive: true });
-		try {
-			await writeFile(
-				join(documentsDir, "legacy.yaml"),
-				`---
-name: LegacyAgent
-description: legacy
----
-legacy prompt`,
-			);
-			await writeFile(
-				join(settingsDir, "new.yaml"),
-				`---
-name: NewAgent
-description: new
----
-new prompt`,
-			);
-
-			const loaded = await readAgentConfigsFromDisk([
-				documentsDir,
-				settingsDir,
-			]);
-			expect([...loaded.keys()].sort()).toEqual(["legacyagent", "newagent"]);
-			expect(loaded.get("legacyagent")?.systemPrompt).toBe("legacy prompt");
-			expect(loaded.get("newagent")?.systemPrompt).toBe("new prompt");
-		} finally {
-			await rm(tempRoot, { recursive: true, force: true });
-		}
-	});
-});

package/src/extensions/config/hooks-config-loader.test.ts

@@ -1,20 +0,0 @@
-import { afterEach, describe, expect, it } from "vitest";
-import {
-	HookConfigFileName,
-	toHookConfigFileName,
-} from "./hooks-config-loader";
-
-describe("hooks config loader", () => {
-	afterEach(() => {
-		delete process.env.CLINE_DATA_DIR;
-	});
-
-	it("recognizes PowerShell hook files", () => {
-		expect(toHookConfigFileName("PreToolUse.ps1")).toBe(
-			HookConfigFileName.PreToolUse,
-		);
-		expect(toHookConfigFileName("TaskError.ps1")).toBe(
-			HookConfigFileName.TaskError,
-		);
-	});
-});

package/src/extensions/config/runtime-commands.test.ts

@@ -1,115 +0,0 @@
-import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { afterEach, describe, expect, it } from "vitest";
-import {
-	listAvailableRuntimeCommandsFromWatcher,
-	resolveRuntimeSlashCommandFromWatcher,
-} from "./runtime-commands";
-import { createUserInstructionConfigWatcher } from "./user-instruction-config-loader";
-
-describe("runtime command registry", () => {
-	const tempRoots: string[] = [];
-
-	afterEach(async () => {
-		await Promise.all(
-			tempRoots.map((dir) => rm(dir, { recursive: true, force: true })),
-		);
-		tempRoots.length = 0;
-	});
-
-	it("lists workflow and skill commands together", async () => {
-		const tempRoot = await mkdtemp(join(tmpdir(), "core-runtime-commands-"));
-		tempRoots.push(tempRoot);
-		const skillDir = join(tempRoot, "skills", "debug");
-		const workflowsDir = join(tempRoot, "workflows");
-		await mkdir(skillDir, { recursive: true });
-		await mkdir(workflowsDir, { recursive: true });
-		await writeFile(join(skillDir, "SKILL.md"), "Use the debugging skill.");
-		await writeFile(
-			join(workflowsDir, "release.md"),
-			`---
-name: release
----
-Run the release workflow.`,
-		);
-
-		const watcher = createUserInstructionConfigWatcher({
-			skills: { directories: [join(tempRoot, "skills")] },
-			rules: { directories: [] },
-			workflows: { directories: [workflowsDir] },
-		});
-
-		try {
-			await watcher.start();
-			expect(listAvailableRuntimeCommandsFromWatcher(watcher)).toEqual([
-				{
-					id: "debug",
-					name: "debug",
-					instructions: "Use the debugging skill.",
-					kind: "skill",
-				},
-				{
-					id: "release",
-					name: "release",
-					instructions: "Run the release workflow.",
-					kind: "workflow",
-				},
-			]);
-		} finally {
-			watcher.stop();
-		}
-	});
-
-	it("expands slash commands with workflow precedence and ignores disabled entries", async () => {
-		const tempRoot = await mkdtemp(join(tmpdir(), "core-runtime-commands-"));
-		tempRoots.push(tempRoot);
-		const skillDir = join(tempRoot, "skills", "ship");
-		const workflowsDir = join(tempRoot, "workflows");
-		await mkdir(skillDir, { recursive: true });
-		await mkdir(workflowsDir, { recursive: true });
-		await writeFile(join(skillDir, "SKILL.md"), "Use the ship skill.");
-		await writeFile(
-			join(workflowsDir, "ship.md"),
-			`---
-name: ship
----
-Run the ship workflow.`,
-		);
-		await writeFile(
-			join(workflowsDir, "disabled.md"),
-			`---
-name: disabled
-disabled: true
----
-Do not run this workflow.`,
-		);
-
-		const watcher = createUserInstructionConfigWatcher({
-			skills: { directories: [join(tempRoot, "skills")] },
-			rules: { directories: [] },
-			workflows: { directories: [workflowsDir] },
-		});
-
-		try {
-			await watcher.start();
-			expect(resolveRuntimeSlashCommandFromWatcher("/ship", watcher)).toBe(
-				"Run the ship workflow.",
-			);
-			expect(resolveRuntimeSlashCommandFromWatcher("/ship now", watcher)).toBe(
-				"Run the ship workflow. now",
-			);
-			expect(resolveRuntimeSlashCommandFromWatcher("/disabled", watcher)).toBe(
-				"/disabled",
-			);
-			expect(resolveRuntimeSlashCommandFromWatcher("/missing", watcher)).toBe(
-				"/missing",
-			);
-			expect(
-				resolveRuntimeSlashCommandFromWatcher("please run /ship", watcher),
-			).toBe("please run /ship");
-		} finally {
-			watcher.stop();
-		}
-	});
-});

package/src/extensions/config/unified-config-file-watcher.test.ts

@@ -1,196 +0,0 @@
-import { mkdir, mkdtemp, rm, unlink, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { basename, join } from "node:path";
-import { afterEach, describe, expect, it } from "vitest";
-import {
-	type AgentYamlConfig,
-	parseAgentConfigFromYaml,
-} from "./agent-config-loader";
-import {
-	UnifiedConfigFileWatcher,
-	type UnifiedConfigWatcherEvent,
-} from "./unified-config-file-watcher";
-
-const WAIT_TIMEOUT_MS = 8_000;
-const WAIT_INTERVAL_MS = 25;
-
-async function waitForEvent<TType extends string, TItem>(
-	events: Array<UnifiedConfigWatcherEvent<TType, TItem>>,
-	predicate: (event: UnifiedConfigWatcherEvent<TType, TItem>) => boolean,
-	timeoutMs = WAIT_TIMEOUT_MS,
-): Promise<UnifiedConfigWatcherEvent<TType, TItem>> {
-	const startedAt = Date.now();
-	while (Date.now() - startedAt < timeoutMs) {
-		const match = events.find(predicate);
-		if (match) {
-			return match;
-		}
-		await new Promise((resolve) => setTimeout(resolve, WAIT_INTERVAL_MS));
-	}
-	throw new Error("Timed out waiting for watcher event.");
-}
-
-describe("UnifiedConfigFileWatcher", () => {
-	const tempRoots: string[] = [];
-
-	afterEach(async () => {
-		await Promise.all(
-			tempRoots.map((dir) => rm(dir, { recursive: true, force: true })),
-		);
-		tempRoots.length = 0;
-	});
-
-	it("emits upsert and remove events with config type for agent configs", async () => {
-		const tempRoot = await mkdtemp(
-			join(tmpdir(), "core-unified-config-watcher-"),
-		);
-		tempRoots.push(tempRoot);
-		const agentsDir = join(tempRoot, "agents");
-		await mkdir(agentsDir, { recursive: true });
-		const agentFilePath = join(agentsDir, "reviewer.yaml");
-		await writeFile(
-			agentFilePath,
-			`---
-name: Reviewer
-description: Reviews patches
-tools: read_files
----
-Review code carefully.`,
-		);
-
-		const watcher = new UnifiedConfigFileWatcher([
-			{
-				type: "agent" as const,
-				directories: [agentsDir],
-				includeFile: (fileName) => /\.(yaml|yml)$/i.test(fileName),
-				parseFile: (context) => parseAgentConfigFromYaml(context.content),
-				resolveId: (config) => config.name.toLowerCase(),
-			},
-		]);
-
-		const events: Array<
-			UnifiedConfigWatcherEvent<
-				"agent",
-				ReturnType<typeof parseAgentConfigFromYaml>
-			>
-		> = [];
-		const unsubscribe = watcher.subscribe((event) => events.push(event));
-
-		try {
-			await watcher.start();
-			await waitForEvent(
-				events,
-				(event) => event.kind === "upsert" && event.record.id === "reviewer",
-			);
-
-			events.length = 0;
-			await writeFile(
-				agentFilePath,
-				`---
-name: Reviewer
-description: Reviews patches
----
-Review code with strictness.`,
-			);
-			await watcher.refreshType("agent");
-			await waitForEvent(
-				events,
-				(event) => event.kind === "upsert" && event.record.type === "agent",
-			);
-
-			events.length = 0;
-			await unlink(agentFilePath);
-			await watcher.refreshType("agent");
-			await waitForEvent(
-				events,
-				(event) => event.kind === "remove" && event.type === "agent",
-			);
-		} finally {
-			unsubscribe();
-			watcher.stop();
-		}
-	}, 15_000);
-
-	it("supports one watcher instance for multiple config types", async () => {
-		const tempRoot = await mkdtemp(
-			join(tmpdir(), "core-unified-config-watcher-"),
-		);
-		tempRoots.push(tempRoot);
-		const agentsDir = join(tempRoot, "agents");
-		const skillsDir = join(tempRoot, "skills");
-		await mkdir(agentsDir, { recursive: true });
-		await mkdir(skillsDir, { recursive: true });
-
-		await writeFile(
-			join(agentsDir, "researcher.yaml"),
-			`---
-name: Researcher
-description: Finds context
----
-Investigate related code paths.`,
-		);
-		await writeFile(
-			join(skillsDir, "SKILL.md"),
-			`---
-name: incident-response
-description: Handle incidents
----
-Escalation playbook`,
-		);
-
-		const watcher = new UnifiedConfigFileWatcher<
-			"agent" | "skill",
-			AgentYamlConfig | { path: string }
-		>([
-			{
-				type: "agent" as const,
-				directories: [agentsDir],
-				includeFile: (fileName) => /\.(yaml|yml)$/i.test(fileName),
-				parseFile: (context) =>
-					parseAgentConfigFromYaml(context.content) as
-						| AgentYamlConfig
-						| { path: string },
-				resolveId: (config) =>
-					"name" in config ? config.name.toLowerCase() : "invalid-agent-config",
-			},
-			{
-				type: "skill" as const,
-				directories: [skillsDir],
-				includeFile: (fileName) => fileName === "SKILL.md",
-				parseFile: (context) => ({ path: context.filePath }),
-				resolveId: (_parsed, context) => basename(context.directoryPath),
-			},
-		]);
-
-		const events: Array<
-			UnifiedConfigWatcherEvent<
-				"agent" | "skill",
-				AgentYamlConfig | { path: string }
-			>
-		> = [];
-		const unsubscribe = watcher.subscribe((event) => events.push(event));
-
-		try {
-			await watcher.start();
-			await waitForEvent(
-				events,
-				(event) =>
-					event.kind === "upsert" &&
-					(event.record.type === "agent" || event.record.type === "skill"),
-			);
-			expect(
-				events.some(
-					(event) => event.kind === "upsert" && event.record.type === "agent",
-				),
-			).toBe(true);
-			expect(
-				events.some(
-					(event) => event.kind === "upsert" && event.record.type === "skill",
-				),
-			).toBe(true);
-		} finally {
-			unsubscribe();
-			watcher.stop();
-		}
-	});
-});