@clinebot/shared 0.0.14 → 0.0.16

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@clinebot/shared",
-	"version": "0.0.14",
+	"version": "0.0.16",
 	"description": "Shared utilities, types, and schemas for Cline packages",
 	"type": "module",
 	"main": "dist/index.js",

package/src/connectors/events.ts

@@ -3,12 +3,14 @@ import { z } from "zod";
 export const ConnectorHookEventNameSchema = z.enum([
 	"connector.started",
 	"connector.stopping",
+	"session.authorize",
 	"message.received",
+	"message.denied",
 	"message.completed",
 	"message.failed",
 	"session.started",
 	"session.reused",
-	"thread.reset",
+	"session.reset",
 	"schedule.delivery.started",
 	"schedule.delivery.sent",
 	"schedule.delivery.failed",
@@ -18,6 +20,40 @@ export type ConnectorHookEventName = z.infer<
 	typeof ConnectorHookEventNameSchema
 >;
 
+export const ConnectorEventActorSchema = z.object({
+	id: z.string().optional(),
+	label: z.string().optional(),
+	role: z.string().optional(),
+	participantKey: z.string().optional(),
+	participantLabel: z.string().optional(),
+	platformUserId: z.string().optional(),
+	metadata: z.record(z.string(), z.unknown()).optional(),
+});
+
+export const ConnectorEventContextSchema = z.object({
+	source: z.string(),
+	sourceEvent: z.string(),
+	threadId: z.string(),
+	channelId: z.string(),
+	isDM: z.boolean(),
+	sessionId: z.string().optional(),
+	workspaceRoot: z.string().optional(),
+	metadata: z.record(z.string(), z.unknown()).optional(),
+});
+
+export const ConnectorAuthorizationRequestSchema = z.object({
+	actor: ConnectorEventActorSchema,
+	context: ConnectorEventContextSchema,
+	payload: z.record(z.string(), z.unknown()).optional(),
+});
+
+export const ConnectorAuthorizationDecisionSchema = z.object({
+	action: z.enum(["allow", "deny"]).default("allow"),
+	message: z.string().optional(),
+	reason: z.string().optional(),
+	metadata: z.record(z.string(), z.unknown()).optional(),
+});
+
 export const ConnectorHookEventSchema = z.object({
 	adapter: z.string(),
 	botUserName: z.string().optional(),
@@ -27,3 +63,11 @@ export const ConnectorHookEventSchema = z.object({
 });
 
 export type ConnectorHookEvent = z.infer<typeof ConnectorHookEventSchema>;
+export type ConnectorEventActor = z.infer<typeof ConnectorEventActorSchema>;
+export type ConnectorEventContext = z.infer<typeof ConnectorEventContextSchema>;
+export type ConnectorAuthorizationRequest = z.infer<
+	typeof ConnectorAuthorizationRequestSchema
+>;
+export type ConnectorAuthorizationDecision = z.infer<
+	typeof ConnectorAuthorizationDecisionSchema
+>;

package/src/db/sqlite-db.ts

@@ -11,6 +11,7 @@ export type SqliteStatement = {
 export type SqliteDb = {
 	prepare: (sql: string) => SqliteStatement;
 	exec: (sql: string) => void;
+	close?: () => void;
 };
 
 export function nowIso(): string {
@@ -38,10 +39,12 @@ export function asBool(value: unknown): boolean {
 function wrapBunDb(db: {
 	query: (sql: string) => SqliteStatement;
 	exec: (sql: string) => void;
+	close?: () => void;
 }): SqliteDb {
 	return {
 		prepare: (sql) => db.query(sql),
 		exec: (sql) => db.exec(sql),
+		close: () => db.close?.(),
 	};
 }
 
@@ -52,6 +55,7 @@ function wrapNodeDb(db: {
 		all: (...params: unknown[]) => Record<string, unknown>[];
 	};
 	exec: (sql: string) => void;
+	close?: () => void;
 }): SqliteDb {
 	return {
 		prepare: (sql) => {
@@ -63,6 +67,7 @@ function wrapNodeDb(db: {
 			};
 		},
 		exec: (sql) => db.exec(sql),
+		close: () => db.close?.(),
 	};
 }
 
@@ -78,6 +83,7 @@ export function loadSqliteDb(filePath: string): SqliteDb {
 			) => {
 				query: (sql: string) => SqliteStatement;
 				exec: (sql: string) => void;
+				close?: () => void;
 			};
 		};
 		return wrapBunDb(new Database(filePath, { create: true }));
@@ -103,6 +109,7 @@ export function loadSqliteDb(filePath: string): SqliteDb {
 					all: (...params: unknown[]) => Record<string, unknown>[];
 				};
 				exec: (sql: string) => void;
+				close?: () => void;
 			};
 		};
 		process.emitWarning = originalEmit;

package/src/index.browser.ts

@@ -7,10 +7,18 @@ export {
 } from "./auth/constants";
 export type * from "./connectors/adapters";
 export type {
+	ConnectorAuthorizationDecision,
+	ConnectorAuthorizationRequest,
+	ConnectorEventActor,
+	ConnectorEventContext,
 	ConnectorHookEvent,
 	ConnectorHookEventName,
 } from "./connectors/events";
 export {
+	ConnectorAuthorizationDecisionSchema,
+	ConnectorAuthorizationRequestSchema,
+	ConnectorEventActorSchema,
+	ConnectorEventContextSchema,
 	ConnectorHookEventNameSchema,
 	ConnectorHookEventSchema,
 } from "./connectors/events";
@@ -38,6 +46,8 @@ export {
 	normalizeUserInput,
 	xmlTagsRemoval,
 } from "./prompt/format";
+export * from "./remote-config/constants";
+export * from "./remote-config/schema";
 export { CLINE_DEFAULT_RPC_ADDRESS, CLINE_DEFAULT_RPC_PORT } from "./rpc";
 export type {
 	RpcAddProviderActionRequest,

package/src/index.ts

@@ -7,10 +7,18 @@ export {
 } from "./auth/constants";
 export type * from "./connectors/adapters";
 export type {
+	ConnectorAuthorizationDecision,
+	ConnectorAuthorizationRequest,
+	ConnectorEventActor,
+	ConnectorEventContext,
 	ConnectorHookEvent,
 	ConnectorHookEventName,
 } from "./connectors/events";
 export {
+	ConnectorAuthorizationDecisionSchema,
+	ConnectorAuthorizationRequestSchema,
+	ConnectorEventActorSchema,
+	ConnectorEventContextSchema,
 	ConnectorHookEventNameSchema,
 	ConnectorHookEventSchema,
 } from "./connectors/events";
@@ -38,6 +46,8 @@ export {
 	normalizeUserInput,
 	xmlTagsRemoval,
 } from "./prompt/format";
+export * from "./remote-config/constants";
+export * from "./remote-config/schema";
 export { CLINE_DEFAULT_RPC_ADDRESS, CLINE_DEFAULT_RPC_PORT } from "./rpc";
 export type {
 	RpcAddProviderActionRequest,

package/src/storage/paths.test.ts

@@ -0,0 +1,99 @@
+import { join } from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import {
+	AGENT_CONFIG_DIRECTORY_NAME,
+	CLINE_MCP_SETTINGS_FILE_NAME,
+	resolveAgentsConfigDirPath,
+	resolveClineDataDir,
+	resolveMcpSettingsPath,
+	resolveProviderSettingsPath,
+	resolveSessionDataDir,
+	resolveTeamDataDir,
+} from "./paths";
+
+type EnvSnapshot = {
+	CLINE_DATA_DIR: string | undefined;
+	CLINE_MCP_SETTINGS_PATH: string | undefined;
+	CLINE_PROVIDER_SETTINGS_PATH: string | undefined;
+	CLINE_SESSION_DATA_DIR: string | undefined;
+	CLINE_TEAM_DATA_DIR: string | undefined;
+};
+
+function captureEnv(): EnvSnapshot {
+	return {
+		CLINE_DATA_DIR: process.env.CLINE_DATA_DIR,
+		CLINE_MCP_SETTINGS_PATH: process.env.CLINE_MCP_SETTINGS_PATH,
+		CLINE_PROVIDER_SETTINGS_PATH: process.env.CLINE_PROVIDER_SETTINGS_PATH,
+		CLINE_SESSION_DATA_DIR: process.env.CLINE_SESSION_DATA_DIR,
+		CLINE_TEAM_DATA_DIR: process.env.CLINE_TEAM_DATA_DIR,
+	};
+}
+
+function restoreEnv(snapshot: EnvSnapshot): void {
+	process.env.CLINE_DATA_DIR = snapshot.CLINE_DATA_DIR;
+	process.env.CLINE_MCP_SETTINGS_PATH = snapshot.CLINE_MCP_SETTINGS_PATH;
+	process.env.CLINE_PROVIDER_SETTINGS_PATH =
+		snapshot.CLINE_PROVIDER_SETTINGS_PATH;
+	process.env.CLINE_SESSION_DATA_DIR = snapshot.CLINE_SESSION_DATA_DIR;
+	process.env.CLINE_TEAM_DATA_DIR = snapshot.CLINE_TEAM_DATA_DIR;
+}
+
+describe("storage path resolution", () => {
+	let snapshot: EnvSnapshot = captureEnv();
+
+	afterEach(() => {
+		restoreEnv(snapshot);
+	});
+
+	it("uses CLINE_DATA_DIR as-is when set", () => {
+		snapshot = captureEnv();
+		process.env.CLINE_DATA_DIR = "/tmp/cline-data";
+
+		expect(resolveClineDataDir()).toBe("/tmp/cline-data");
+	});
+
+	it("falls back to CLINE_DATA_DIR/sessions for session storage", () => {
+		snapshot = captureEnv();
+		delete process.env.CLINE_SESSION_DATA_DIR;
+		process.env.CLINE_DATA_DIR = "/tmp/cline-data";
+
+		expect(resolveSessionDataDir()).toBe(join("/tmp/cline-data", "sessions"));
+	});
+
+	it("falls back to CLINE_DATA_DIR/teams for team storage", () => {
+		snapshot = captureEnv();
+		delete process.env.CLINE_TEAM_DATA_DIR;
+		process.env.CLINE_DATA_DIR = "/tmp/cline-data";
+
+		expect(resolveTeamDataDir()).toBe(join("/tmp/cline-data", "teams"));
+	});
+
+	it("falls back to CLINE_DATA_DIR/settings/providers.json for provider settings", () => {
+		snapshot = captureEnv();
+		delete process.env.CLINE_PROVIDER_SETTINGS_PATH;
+		process.env.CLINE_DATA_DIR = "/tmp/cline-data";
+
+		expect(resolveProviderSettingsPath()).toBe(
+			join("/tmp/cline-data", "settings", "providers.json"),
+		);
+	});
+
+	it("falls back to CLINE_DATA_DIR/settings/cline_mcp_settings.json for MCP settings", () => {
+		snapshot = captureEnv();
+		delete process.env.CLINE_MCP_SETTINGS_PATH;
+		process.env.CLINE_DATA_DIR = "/tmp/cline-data";
+
+		expect(resolveMcpSettingsPath()).toBe(
+			join("/tmp/cline-data", "settings", CLINE_MCP_SETTINGS_FILE_NAME),
+		);
+	});
+
+	it("falls back to CLINE_DATA_DIR/settings/agents for agent configs", () => {
+		snapshot = captureEnv();
+		process.env.CLINE_DATA_DIR = "/tmp/cline-data";
+
+		expect(resolveAgentsConfigDirPath()).toBe(
+			join("/tmp/cline-data", "settings", AGENT_CONFIG_DIRECTORY_NAME),
+		);
+	});
+});