@clinebot/core 0.0.14 → 0.0.16

package/dist/session/default-session-manager.d.ts

@@ -6,11 +6,12 @@ import { ProviderSettingsManager } from "../storage/provider-settings-manager";
 import { type ToolExecutors } from "../tools";
 import type { CoreSessionEvent } from "../types/events";
 import type { SessionRecord } from "../types/sessions";
+import type { FileSessionService } from "./file-session-service";
 import type { RpcCoreSessionService } from "./rpc-session-service";
 import { RuntimeOAuthTokenManager } from "./runtime-oauth-token-manager";
 import type { SendSessionInput, SessionAccumulatedUsage, SessionManager, StartSessionInput, StartSessionResult } from "./session-manager";
 import type { CoreSessionService } from "./session-service";
-type SessionBackend = CoreSessionService | RpcCoreSessionService;
+type SessionBackend = CoreSessionService | RpcCoreSessionService | FileSessionService;
 export interface DefaultSessionManagerOptions {
     distinctId: string;
     sessionService: SessionBackend;

package/dist/session/file-session-service.d.ts

@@ -0,0 +1,5 @@
+import { UnifiedSessionPersistenceService } from "./unified-session-persistence-service";
+export declare class FileSessionService extends UnifiedSessionPersistenceService {
+    constructor(sessionsDir?: string);
+    ensureSessionsDir(): string;
+}

package/dist/session/session-host.d.ts

@@ -1,10 +1,11 @@
 import type { AgentConfig, ToolApprovalRequest, ToolApprovalResult } from "@clinebot/agents";
 import type { ITelemetryService } from "@clinebot/shared";
 import type { ToolExecutors } from "../tools";
+import { FileSessionService } from "./file-session-service";
 import { RpcCoreSessionService } from "./rpc-session-service";
 import type { SessionManager } from "./session-manager";
 import { CoreSessionService } from "./session-service";
-export type SessionBackend = RpcCoreSessionService | CoreSessionService;
+export type SessionBackend = RpcCoreSessionService | CoreSessionService | FileSessionService;
 export interface CreateSessionHostOptions {
     distinctId?: string;
     sessionService?: SessionBackend;

package/dist/storage/file-team-store.d.ts

@@ -0,0 +1,27 @@
+import type { TeamEvent, TeamRuntimeState, TeamTeammateSpec } from "@clinebot/agents";
+import type { TeamStore } from "../types/storage";
+export interface FileTeamStoreOptions {
+    teamDir?: string;
+}
+export interface TeamRuntimeLoadResult {
+    state?: TeamRuntimeState;
+    teammates: TeamTeammateSpec[];
+    interruptedRunIds: string[];
+}
+export declare class FileTeamStore implements TeamStore {
+    private readonly teamDirPath;
+    constructor(options?: FileTeamStoreOptions);
+    init(): void;
+    listTeamNames(): string[];
+    readState(teamName: string): TeamRuntimeState | undefined;
+    readHistory(teamName: string, limit?: number): unknown[];
+    loadRuntime(teamName: string): TeamRuntimeLoadResult;
+    handleTeamEvent(teamName: string, event: TeamEvent): void;
+    persistRuntime(teamName: string, state: TeamRuntimeState, teammates: TeamTeammateSpec[]): void;
+    markInProgressRunsInterrupted(teamName: string, reason: string): string[];
+    private ensureTeamDir;
+    private ensureTeamSubdir;
+    private statePath;
+    private historyPath;
+    private readEnvelope;
+}

package/dist/storage/sqlite-session-store.d.ts

@@ -13,6 +13,7 @@ export declare class SqliteSessionStore implements SessionStore {
     ensureSessionsDir(): string;
     sessionDbPath(): string;
     getRawDb(): SqliteDb;
+    close(): void;
     run(sql: string, params?: unknown[]): {
         changes?: number;
     };

package/dist/storage/team-store.d.ts

@@ -1,2 +1,15 @@
 export type { TeamStore } from "../types/storage";
+export { FileTeamStore, type FileTeamStoreOptions, } from "./file-team-store";
 export { SqliteTeamStore, type SqliteTeamStoreOptions, } from "./sqlite-team-store";
+import { FileTeamStore } from "./file-team-store";
+import { type SqliteTeamStoreOptions } from "./sqlite-team-store";
+export declare function createLocalTeamStore(options?: SqliteTeamStoreOptions): {
+    init(): void;
+    listTeamNames(): string[];
+    readState(teamName: string): ReturnType<FileTeamStore["readState"]>;
+    readHistory(teamName: string, limit?: number): unknown[];
+    loadRuntime(teamName: string): ReturnType<FileTeamStore["loadRuntime"]>;
+    handleTeamEvent: FileTeamStore["handleTeamEvent"];
+    persistRuntime: FileTeamStore["persistRuntime"];
+    markInProgressRunsInterrupted: FileTeamStore["markInProgressRunsInterrupted"];
+};

package/package.json

@@ -1,11 +1,11 @@
 {
 	"name": "@clinebot/core",
-	"version": "0.0.14",
+	"version": "0.0.16",
 	"main": "./dist/index.node.js",
 	"dependencies": {
-		"@clinebot/agents": "0.0.14",
-		"@clinebot/llms": "0.0.14",
-		"@clinebot/shared": "0.0.14",
+		"@clinebot/agents": "0.0.16",
+		"@clinebot/llms": "0.0.16",
+		"@clinebot/shared": "0.0.16",
 		"@opentelemetry/api": "^1.9.0",
 		"@opentelemetry/api-logs": "^0.56.0",
 		"@opentelemetry/exporter-logs-otlp-http": "^0.56.0",

package/src/account/cline-account-service.ts

@@ -6,6 +6,7 @@ import type {
 	ClineAccountPaymentTransaction,
 	ClineAccountUsageTransaction,
 	ClineAccountUser,
+	UserRemoteConfigResponse,
 } from "./types";
 
 const DEFAULT_TIMEOUT_MS = 30_000;
@@ -63,6 +64,12 @@ export class ClineAccountService {
 		return this.request<ClineAccountUser>("/api/v1/users/me");
 	}
 
+	public async fetchRemoteConfig(): Promise<UserRemoteConfigResponse> {
+		return this.request<UserRemoteConfigResponse>(
+			"/api/v1/users/me/remote-config",
+		);
+	}
+
 	public async fetchBalance(userId?: string): Promise<ClineAccountBalance> {
 		const resolvedUserId = await this.resolveUserId(userId);
 		return this.request<ClineAccountBalance>(

package/src/account/index.ts

@@ -17,4 +17,5 @@ export type {
 	ClineAccountPaymentTransaction,
 	ClineAccountUsageTransaction,
 	ClineAccountUser,
+	UserRemoteConfigResponse,
 } from "./types";

package/src/account/types.ts

@@ -16,6 +16,12 @@ export interface ClineAccountUser {
 	organizations: ClineAccountOrganization[];
 }
 
+export interface UserRemoteConfigResponse {
+	organizationId: string;
+	value: string;
+	enabled: boolean;
+}
+
 export interface ClineAccountBalance {
 	balance: number;
 	userId: string;

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

@@ -39,7 +39,7 @@ describe("agent config YAML loader", () => {
 	it("resolves default agents settings directory from CLINE_DATA_DIR", () => {
 		process.env.CLINE_DATA_DIR = "/tmp/cline-data";
 		expect(resolveAgentsConfigDirPath()).toBe(
-			`/tmp/cline-data/settings/${AGENT_CONFIG_DIRECTORY_NAME}`,
+			join("/tmp/cline-data", "settings", AGENT_CONFIG_DIRECTORY_NAME),
 		);
 	});
 
@@ -47,7 +47,7 @@ describe("agent config YAML loader", () => {
 		process.env.CLINE_DATA_DIR = "/tmp/cline-data";
 		expect(resolveAgentConfigSearchPaths()).toEqual([
 			resolveDocumentsAgentConfigDirectoryPath(),
-			`/tmp/cline-data/settings/${AGENT_CONFIG_DIRECTORY_NAME}`,
+			join("/tmp/cline-data", "settings", AGENT_CONFIG_DIRECTORY_NAME),
 		]);
 	});
 
@@ -57,7 +57,7 @@ describe("agent config YAML loader", () => {
 		expect(definition.type).toBe("agent");
 		expect(definition.directories).toEqual([
 			resolveDocumentsAgentConfigDirectoryPath(),
-			`/tmp/cline-data/settings/${AGENT_CONFIG_DIRECTORY_NAME}`,
+			join("/tmp/cline-data", "settings", AGENT_CONFIG_DIRECTORY_NAME),
 		]);
 		expect(definition.includeFile?.("agent.yaml", "/tmp/agent.yaml")).toBe(
 			true,

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

@@ -0,0 +1,20 @@
+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/agents/hooks-config-loader.ts

@@ -59,6 +59,7 @@ const SUPPORTED_HOOK_FILE_EXTENSIONS = new Set([
 	".mts",
 	".cts",
 	".py",
+	".ps1",
 ]);
 
 export function toHookConfigFileName(

package/src/agents/user-instruction-config-loader.test.ts

@@ -46,17 +46,17 @@ describe("user instruction config loader", () => {
 		const workspacePath = "/repo/demo";
 		expect(resolveSkillsConfigSearchPaths(workspacePath)).toEqual(
 			expect.arrayContaining([
-				"/repo/demo/.clinerules/skills",
-				"/repo/demo/.cline/skills",
-				"/repo/demo/.claude/skills",
-				"/repo/demo/.agents/skills",
+				join(workspacePath, ".clinerules", "skills"),
+				join(workspacePath, ".cline", "skills"),
+				join(workspacePath, ".claude", "skills"),
+				join(workspacePath, ".agents", "skills"),
 			]),
 		);
 		expect(resolveRulesConfigSearchPaths(workspacePath)).toEqual(
-			expect.arrayContaining(["/repo/demo/.clinerules"]),
+			expect.arrayContaining([join(workspacePath, ".clinerules")]),
 		);
 		expect(resolveWorkflowsConfigSearchPaths(workspacePath)).toEqual(
-			expect.arrayContaining(["/repo/demo/.clinerules/workflows"]),
+			expect.arrayContaining([join(workspacePath, ".clinerules", "workflows")]),
 		);
 	});
 

package/src/index.node.ts

@@ -103,6 +103,23 @@ export {
 export async function loadOpenTelemetryAdapter() {
 	return import("./telemetry/opentelemetry.js");
 }
+export {
+	type ClineAccountBalance,
+	type ClineAccountOperations,
+	type ClineAccountOrganization,
+	type ClineAccountOrganizationBalance,
+	type ClineAccountOrganizationUsageTransaction,
+	type ClineAccountPaymentTransaction,
+	ClineAccountService,
+	type ClineAccountServiceOptions,
+	type ClineAccountUsageTransaction,
+	type ClineAccountUser,
+	executeRpcClineAccountAction,
+	isRpcClineAccountActionRequest,
+	RpcClineAccountService,
+	type RpcProviderActionExecutor,
+	type UserRemoteConfigResponse,
+} from "./account";
 export { startLocalOAuthServer } from "./auth/server";
 export type {
 	OAuthCredentials,
@@ -127,6 +144,28 @@ export {
 	getFileIndex,
 	prewarmFileIndex,
 } from "./input";
+export {
+	hasMcpSettingsFile,
+	InMemoryMcpManager,
+	type LoadMcpSettingsOptions,
+	loadMcpSettingsFile,
+	type McpConnectionStatus,
+	type McpManager,
+	type McpManagerOptions,
+	type McpServerClient,
+	type McpServerClientFactory,
+	type McpServerRegistration,
+	type McpServerSnapshot,
+	type McpServerTransportConfig,
+	type McpSettingsFile,
+	type McpSseTransportConfig,
+	type McpStdioTransportConfig,
+	type McpStreamableHttpTransportConfig,
+	type RegisterMcpServersFromSettingsOptions,
+	registerMcpServersFromSettingsFile,
+	resolveDefaultMcpSettingsPath,
+	resolveMcpServerRegistrations,
+} from "./mcp";
 export {
 	addLocalProvider,
 	ensureCustomProvidersLoaded,

package/src/runtime/hook-file-hooks.test.ts

@@ -172,6 +172,40 @@ describe("createHookConfigFileHooks", () => {
 		}
 	});
 
+	it.skipIf(process.platform !== "win32")(
+		"executes PowerShell hook files on Windows",
+		async () => {
+			const { workspace } = await createWorkspaceWithHook(
+				"PreToolUse.ps1",
+				'Write-Output \'HOOK_CONTROL\t{"cancel": false, "context": "powershell-ok"}\'\n',
+			);
+			try {
+				const hooks = createHookConfigFileHooks({
+					cwd: workspace,
+					workspacePath: workspace,
+				});
+				expect(hooks?.onToolCallStart).toBeTypeOf("function");
+				const control = await hooks?.onToolCallStart?.({
+					agentId: "agent_1",
+					conversationId: "conv_1",
+					parentAgentId: null,
+					iteration: 1,
+					call: {
+						id: "call_1",
+						name: "read_file",
+						input: { path: "README.md" },
+					},
+				});
+				expect(control).toMatchObject({
+					cancel: false,
+					context: "powershell-ok",
+				});
+			} finally {
+				await rm(workspace, { recursive: true, force: true });
+			}
+		},
+	);
+
 	it("maps TaskError hook files to agent_error stop events", async () => {
 		const outputPath = join(tmpdir(), `hooks-task-error-${Date.now()}.json`);
 		const { workspace } = await createWorkspaceWithHook(

package/src/runtime/hook-file-hooks.ts

@@ -345,10 +345,33 @@ function parseShebangCommand(path: string): string[] | undefined {
 	}
 }
 
+function normalizeHookInterpreter(tokens: string[]): string[] | undefined {
+	if (tokens.length === 0) {
+		return undefined;
+	}
+	const [rawCommand, ...rest] = tokens;
+	const normalizedCommand = rawCommand.replace(/\\/g, "/").toLowerCase();
+	const commandName = normalizedCommand.split("/").at(-1) ?? normalizedCommand;
+
+	if (commandName === "env") {
+		return normalizeHookInterpreter(rest);
+	}
+
+	if (commandName === "bash" || commandName === "sh" || commandName === "zsh") {
+		return [commandName, ...rest];
+	}
+
+	if (commandName === "python3" || commandName === "python") {
+		return [process.platform === "win32" ? "python" : commandName, ...rest];
+	}
+
+	return tokens;
+}
+
 function inferHookCommand(path: string): string[] {
 	const shebang = parseShebangCommand(path);
 	if (shebang && shebang.length > 0) {
-		return [...shebang, path];
+		return [...(normalizeHookInterpreter(shebang) ?? shebang), path];
 	}
 	const lowered = path.toLowerCase();
 	if (
@@ -356,7 +379,7 @@ function inferHookCommand(path: string): string[] {
 		lowered.endsWith(".bash") ||
 		lowered.endsWith(".zsh")
 	) {
-		return ["/bin/bash", path];
+		return ["bash", path];
 	}
 	if (
 		lowered.endsWith(".js") ||
@@ -373,10 +396,17 @@ function inferHookCommand(path: string): string[] {
 		return ["bun", "run", path];
 	}
 	if (lowered.endsWith(".py")) {
-		return ["python3", path];
+		return [process.platform === "win32" ? "python" : "python3", path];
+	}
+	if (lowered.endsWith(".ps1")) {
+		return [
+			process.platform === "win32" ? "powershell" : "pwsh",
+			"-File",
+			path,
+		];
 	}
 	// Default to bash for legacy hook files with no extension/shebang.
-	return ["/bin/bash", path];
+	return ["bash", path];
 }
 
 function createHookCommandMap(workspacePath: string): HookCommandMap {

package/src/runtime/runtime-builder.team-persistence.test.ts

@@ -49,13 +49,12 @@ vi.mock("../default-tools", () => ({
 	},
 }));
 
-let teamStoreInstance: MockSqliteTeamStore | undefined;
-class MockSqliteTeamStore {
+let teamStoreInstance: MockTeamStore | undefined;
+class MockTeamStore {
 	constructor() {
 		teamStoreInstance = this;
 	}
 
-	init = vi.fn();
 	loadRuntime = vi.fn(() => ({
 		state: {
 			teamId: "team_1",
@@ -82,8 +81,8 @@ class MockSqliteTeamStore {
 	persistRuntime = vi.fn();
 }
 
-vi.mock("../storage/sqlite-team-store", () => ({
-	SqliteTeamStore: MockSqliteTeamStore,
+vi.mock("../storage/team-store", () => ({
+	createLocalTeamStore: () => new MockTeamStore(),
 }));
 
 describe("DefaultRuntimeBuilder team persistence boundary", () => {

package/src/runtime/runtime-builder.ts

@@ -14,7 +14,7 @@ import {
 	type SkillConfig,
 	type UserInstructionConfigWatcher,
 } from "../agents";
-import { SqliteTeamStore } from "../storage/sqlite-team-store";
+import { createLocalTeamStore } from "../storage/team-store";
 import {
 	createBuiltinTools,
 	DEFAULT_MODEL_TOOL_ROUTING_RULES,
@@ -418,9 +418,8 @@ export class DefaultRuntimeBuilder implements RuntimeBuilder {
 
 		let teamRuntime: AgentTeamsRuntime | undefined;
 		const teamStore = normalized.enableAgentTeams
-			? new SqliteTeamStore()
+			? createLocalTeamStore()
 			: undefined;
-		teamStore?.init();
 		const restoredTeam = teamStore?.loadRuntime(effectiveTeamName);
 		const restoredTeamState = restoredTeam?.state;
 		const restoredTeammateSpecs = restoredTeam?.teammates ?? [];

package/src/session/default-session-manager.ts

@@ -36,6 +36,7 @@ import { SessionSource, type SessionStatus } from "../types/common";
 import type { CoreSessionConfig } from "../types/config";
 import type { CoreSessionEvent } from "../types/events";
 import type { SessionRecord } from "../types/sessions";
+import type { FileSessionService } from "./file-session-service";
 import type { RpcCoreSessionService } from "./rpc-session-service";
 import {
 	OAuthReauthRequiredError,
@@ -92,7 +93,10 @@ import {
 	createInitialAccumulatedUsage,
 } from "./utils/usage";
 
-type SessionBackend = CoreSessionService | RpcCoreSessionService;
+type SessionBackend =
+	| CoreSessionService
+	| RpcCoreSessionService
+	| FileSessionService;
 
 const MAX_SCAN_LIMIT = 5000;
 const MAX_USER_FILE_BYTES = 20 * 1_000 * 1_024;