@clinebot/core 0.0.35 → 0.0.36

package/src/session/sqlite-rpc-session-backend.ts

@@ -1,301 +0,0 @@
-import type {
-	RpcSessionBackend,
-	RpcSessionRow,
-	RpcSessionStatus,
-	RpcSessionUpdateInput,
-	RpcSpawnQueueItem,
-} from "@clinebot/rpc";
-import {
-	asBool,
-	asOptionalString,
-	asString,
-	nowIso,
-	toBoolInt,
-} from "@clinebot/shared/db";
-import { SqliteSessionStore } from "../services/storage/sqlite-session-store";
-
-export interface SqliteRpcSessionBackendOptions {
-	sessionsDir?: string;
-}
-
-export class SqliteRpcSessionBackend implements RpcSessionBackend {
-	private readonly store: SqliteSessionStore;
-
-	constructor(options: SqliteRpcSessionBackendOptions = {}) {
-		this.store = new SqliteSessionStore({ sessionsDir: options.sessionsDir });
-	}
-
-	public init(): void {
-		this.store.init();
-	}
-
-	public upsertSession(row: RpcSessionRow): void {
-		this.store.run(
-			`INSERT OR REPLACE INTO sessions (
-				session_id, source, pid, started_at, ended_at, exit_code, status, status_lock, interactive,
-				provider, model, cwd, workspace_root, team_name, enable_tools, enable_spawn, enable_teams,
-				parent_session_id, parent_agent_id, agent_id, conversation_id, is_subagent, prompt,
-				metadata_json, transcript_path, hook_path, messages_path, updated_at
-			) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-			[
-				row.sessionId,
-				row.source,
-				row.pid,
-				row.startedAt,
-				row.endedAt ?? null,
-				row.exitCode ?? null,
-				row.status,
-				row.statusLock,
-				toBoolInt(row.interactive),
-				row.provider,
-				row.model,
-				row.cwd,
-				row.workspaceRoot,
-				row.teamName ?? null,
-				toBoolInt(row.enableTools),
-				toBoolInt(row.enableSpawn),
-				toBoolInt(row.enableTeams),
-				row.parentSessionId ?? null,
-				row.parentAgentId ?? null,
-				row.agentId ?? null,
-				row.conversationId ?? null,
-				toBoolInt(row.isSubagent),
-				row.prompt ?? null,
-				row.metadata ? JSON.stringify(row.metadata) : null,
-				"",
-				"",
-				row.messagesPath ?? null,
-				row.updatedAt || nowIso(),
-			],
-		);
-	}
-
-	public getSession(sessionId: string): RpcSessionRow | undefined {
-		const row = this.store.queryOne<Record<string, unknown>>(
-			`SELECT session_id, source, pid, started_at, ended_at, exit_code, status, status_lock, interactive,
-				provider, model, cwd, workspace_root, team_name, enable_tools, enable_spawn, enable_teams,
-				parent_session_id, parent_agent_id, agent_id, conversation_id, is_subagent, prompt,
-				metadata_json, hook_path, messages_path, updated_at
-			 FROM sessions WHERE session_id = ?`,
-			[sessionId],
-		);
-		if (!row) {
-			return undefined;
-		}
-		return {
-			sessionId: asString(row.session_id),
-			source: asString(row.source),
-			pid: Number(row.pid ?? 0),
-			startedAt: asString(row.started_at),
-			endedAt: (row.ended_at as string | null | undefined) ?? null,
-			exitCode: (row.exit_code as number | null | undefined) ?? null,
-			status: asString(row.status) as RpcSessionStatus,
-			statusLock: Number(row.status_lock ?? 0),
-			interactive: asBool(row.interactive),
-			provider: asString(row.provider),
-			model: asString(row.model),
-			cwd: asString(row.cwd),
-			workspaceRoot: asString(row.workspace_root),
-			teamName: asOptionalString(row.team_name),
-			enableTools: asBool(row.enable_tools),
-			enableSpawn: asBool(row.enable_spawn),
-			enableTeams: asBool(row.enable_teams),
-			parentSessionId: asOptionalString(row.parent_session_id),
-			parentAgentId: asOptionalString(row.parent_agent_id),
-			agentId: asOptionalString(row.agent_id),
-			conversationId: asOptionalString(row.conversation_id),
-			isSubagent: asBool(row.is_subagent),
-			prompt: asOptionalString(row.prompt),
-			metadata: (() => {
-				const raw = asOptionalString(row.metadata_json);
-				if (!raw) {
-					return undefined;
-				}
-				try {
-					const parsed = JSON.parse(raw) as unknown;
-					if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
-						return parsed as Record<string, unknown>;
-					}
-				} catch {
-					// Ignore malformed metadata payloads.
-				}
-				return undefined;
-			})(),
-			messagesPath: asOptionalString(row.messages_path),
-			updatedAt: asString(row.updated_at) || nowIso(),
-		};
-	}
-
-	public listSessions(options: {
-		limit: number;
-		parentSessionId?: string;
-		status?: string;
-	}): RpcSessionRow[] {
-		const where: string[] = [];
-		const params: unknown[] = [];
-		if (options.parentSessionId) {
-			where.push("parent_session_id = ?");
-			params.push(options.parentSessionId);
-		}
-		if (options.status) {
-			where.push("status = ?");
-			params.push(options.status);
-		}
-		const whereClause = where.length > 0 ? `WHERE ${where.join(" AND ")}` : "";
-		const limit = Math.max(1, Math.floor(options.limit));
-		const rows = this.store.queryAll<{ session_id?: string }>(
-			`SELECT session_id FROM sessions ${whereClause} ORDER BY started_at DESC LIMIT ?`,
-			[...params, limit],
-		);
-		const out: RpcSessionRow[] = [];
-		for (const row of rows) {
-			if (!row.session_id) {
-				continue;
-			}
-			const item = this.getSession(row.session_id);
-			if (item) {
-				out.push(item);
-			}
-		}
-		return out;
-	}
-
-	public updateSession(input: RpcSessionUpdateInput): {
-		updated: boolean;
-		statusLock: number;
-	} {
-		const existing = this.getSession(input.sessionId);
-		if (!existing) {
-			return { updated: false, statusLock: 0 };
-		}
-		if (
-			typeof input.expectedStatusLock === "number" &&
-			existing.statusLock !== input.expectedStatusLock
-		) {
-			return { updated: false, statusLock: existing.statusLock };
-		}
-		const nextLock = existing.statusLock + 1;
-		const nextStatus = input.setRunning
-			? "running"
-			: (input.status ?? existing.status);
-		const nextEndedAt =
-			input.setRunning === true
-				? null
-				: input.endedAt !== undefined
-					? input.endedAt
-					: (existing.endedAt ?? null);
-		const nextExitCode =
-			input.setRunning === true
-				? null
-				: input.exitCode !== undefined
-					? input.exitCode
-					: (existing.exitCode ?? null);
-		const nextPrompt =
-			input.prompt !== undefined
-				? (input.prompt ?? undefined)
-				: existing.prompt;
-		const nextMetadata =
-			input.metadata !== undefined
-				? (input.metadata ?? undefined)
-				: existing.metadata;
-
-		this.store.run(
-			`UPDATE sessions
-			 SET status = ?, ended_at = ?, exit_code = ?, prompt = ?, metadata_json = ?,
-				 parent_session_id = ?, parent_agent_id = ?, agent_id = ?, conversation_id = ?,
-				 status_lock = ?, updated_at = ?
-			 WHERE session_id = ?`,
-			[
-				nextStatus,
-				nextEndedAt,
-				nextExitCode,
-				nextPrompt ?? null,
-				nextMetadata ? JSON.stringify(nextMetadata) : null,
-				input.parentSessionId !== undefined
-					? (input.parentSessionId ?? null)
-					: (existing.parentSessionId ?? null),
-				input.parentAgentId !== undefined
-					? (input.parentAgentId ?? null)
-					: (existing.parentAgentId ?? null),
-				input.agentId !== undefined
-					? (input.agentId ?? null)
-					: (existing.agentId ?? null),
-				input.conversationId !== undefined
-					? (input.conversationId ?? null)
-					: (existing.conversationId ?? null),
-				nextLock,
-				nowIso(),
-				input.sessionId,
-			],
-		);
-		return { updated: true, statusLock: nextLock };
-	}
-
-	public deleteSession(sessionId: string): boolean {
-		const changes =
-			this.store.run("DELETE FROM sessions WHERE session_id = ?", [sessionId])
-				.changes ?? 0;
-		return changes > 0;
-	}
-
-	public deleteSessionsByParent(parentSessionId: string): void {
-		this.store.run("DELETE FROM sessions WHERE parent_session_id = ?", [
-			parentSessionId,
-		]);
-	}
-
-	public enqueueSpawnRequest(input: {
-		rootSessionId: string;
-		parentAgentId: string;
-		task?: string;
-		systemPrompt?: string;
-	}): void {
-		this.store.run(
-			`INSERT INTO subagent_spawn_queue (root_session_id, parent_agent_id, task, system_prompt, created_at, consumed_at)
-			 VALUES (?, ?, ?, ?, ?, NULL)`,
-			[
-				input.rootSessionId,
-				input.parentAgentId,
-				input.task ?? null,
-				input.systemPrompt ?? null,
-				nowIso(),
-			],
-		);
-	}
-
-	public claimSpawnRequest(
-		rootSessionId: string,
-		parentAgentId: string,
-	): RpcSpawnQueueItem | undefined {
-		const row = this.store.queryOne<Record<string, unknown>>(
-			`SELECT id, root_session_id, parent_agent_id, task, system_prompt, created_at, consumed_at
-			 FROM subagent_spawn_queue
-			 WHERE root_session_id = ? AND parent_agent_id = ? AND consumed_at IS NULL
-			 ORDER BY id ASC LIMIT 1`,
-			[rootSessionId, parentAgentId],
-		);
-		if (!row || typeof row.id !== "number") {
-			return undefined;
-		}
-		const consumedAt = nowIso();
-		this.store.run(
-			"UPDATE subagent_spawn_queue SET consumed_at = ? WHERE id = ?",
-			[consumedAt, row.id],
-		);
-		return {
-			id: row.id,
-			rootSessionId: asString(row.root_session_id),
-			parentAgentId: asString(row.parent_agent_id),
-			task: asOptionalString(row.task),
-			systemPrompt: asOptionalString(row.system_prompt),
-			createdAt: asString(row.created_at),
-			consumedAt,
-		};
-	}
-}
-
-export function createSqliteRpcSessionBackend(
-	options: SqliteRpcSessionBackendOptions = {},
-): RpcSessionBackend {
-	return new SqliteRpcSessionBackend(options);
-}

package/src/transports/local.e2e.test.ts

@@ -1,380 +0,0 @@
-import {
-	existsSync,
-	mkdirSync,
-	mkdtempSync,
-	readFileSync,
-	rmSync,
-	unlinkSync,
-	writeFileSync,
-} from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import type * as LlmsProviders from "@clinebot/llms";
-import type { AgentResult } from "@clinebot/shared";
-import { setClineDir, setHomeDir } from "@clinebot/shared/storage";
-import { nanoid } from "nanoid";
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-import { splitCoreSessionConfig } from "../runtime/runtime-host";
-import type { SessionManifest } from "../session/session-manifest";
-import type {
-	RootSessionArtifacts,
-	SessionRow,
-} from "../session/session-service";
-import type { SessionSource, SessionStatus } from "../types/common";
-import { LocalRuntimeHost as RuntimeHostUnderTest } from "./local";
-
-function nowIso(): string {
-	return new Date().toISOString();
-}
-
-function createResult(overrides: Partial<AgentResult> = {}): AgentResult {
-	return {
-		text: "ok",
-		iterations: 1,
-		finishReason: "completed",
-		usage: {
-			inputTokens: 1,
-			outputTokens: 2,
-			totalCost: 0,
-		},
-		messages: [],
-		toolCalls: [],
-		durationMs: 1,
-		model: {
-			id: "mock-model",
-			provider: "mock-provider",
-		},
-		startedAt: new Date("2026-01-01T00:00:00.000Z"),
-		endedAt: new Date("2026-01-01T00:00:01.000Z"),
-		...overrides,
-	};
-}
-
-class LocalFileSessionService {
-	private readonly rows = new Map<string, SessionRow>();
-
-	constructor(private readonly sessionsDir: string) {}
-
-	ensureSessionsDir(): string {
-		mkdirSync(this.sessionsDir, { recursive: true });
-		return this.sessionsDir;
-	}
-
-	createRootSessionWithArtifacts(input: {
-		sessionId: string;
-		source: SessionSource;
-		pid: number;
-		interactive: boolean;
-		provider: string;
-		model: string;
-		cwd: string;
-		workspaceRoot: string;
-		teamName?: string;
-		enableTools: boolean;
-		enableSpawn: boolean;
-		enableTeams: boolean;
-		prompt?: string;
-		startedAt?: string;
-	}): RootSessionArtifacts {
-		const startedAt = input.startedAt ?? nowIso();
-		const sessionId = input.sessionId.trim() || `${Date.now()}_${nanoid(5)}`;
-		const sessionPath = join(this.sessionsDir, sessionId);
-		mkdirSync(sessionPath, { recursive: true });
-
-		const manifestPath = join(sessionPath, `${sessionId}.json`);
-		const messagesPath = join(sessionPath, `${sessionId}.messages.json`);
-		const prompt = input.prompt?.trim() || undefined;
-		const manifest: SessionManifest = {
-			version: 1,
-			session_id: sessionId,
-			source: input.source,
-			pid: input.pid,
-			started_at: startedAt,
-			status: "running",
-			interactive: input.interactive,
-			provider: input.provider,
-			model: input.model,
-			cwd: input.cwd,
-			workspace_root: input.workspaceRoot,
-			team_name: input.teamName,
-			enable_tools: input.enableTools,
-			enable_spawn: input.enableSpawn,
-			enable_teams: input.enableTeams,
-			prompt,
-			messages_path: messagesPath,
-		};
-		writeFileSync(
-			manifestPath,
-			`${JSON.stringify(manifest, null, 2)}\n`,
-			"utf8",
-		);
-		writeFileSync(
-			messagesPath,
-			`${JSON.stringify({ version: 1, updated_at: startedAt, messages: [] }, null, 2)}\n`,
-			"utf8",
-		);
-
-		this.rows.set(sessionId, {
-			sessionId,
-			source: input.source,
-			pid: input.pid,
-			startedAt,
-			endedAt: null,
-			exitCode: null,
-			status: "running",
-			statusLock: 0,
-			interactive: input.interactive,
-			provider: input.provider,
-			model: input.model,
-			cwd: input.cwd,
-			workspaceRoot: input.workspaceRoot,
-			teamName: input.teamName ?? null,
-			enableTools: input.enableTools,
-			enableSpawn: input.enableSpawn,
-			enableTeams: input.enableTeams,
-			parentSessionId: null,
-			parentAgentId: null,
-			agentId: null,
-			conversationId: null,
-			isSubagent: false,
-			prompt: prompt ?? null,
-			hookPath: "",
-			messagesPath,
-			updatedAt: startedAt,
-		});
-
-		return {
-			manifestPath,
-			messagesPath,
-			manifest,
-		};
-	}
-
-	persistSessionMessages(
-		sessionId: string,
-		messages: LlmsProviders.Message[],
-		systemPrompt?: string,
-	): void {
-		const row = this.rows.get(sessionId);
-		if (!row?.messagesPath) {
-			throw new Error(`session not found: ${sessionId}`);
-		}
-		const payload: {
-			version: number;
-			updated_at: string;
-			systemPrompt?: string;
-			messages: LlmsProviders.Message[];
-		} = { version: 1, updated_at: nowIso(), messages };
-		if (systemPrompt !== undefined && systemPrompt !== "") {
-			payload.systemPrompt = systemPrompt;
-		}
-		writeFileSync(
-			row.messagesPath,
-			`${JSON.stringify(payload, null, 2)}\n`,
-			"utf8",
-		);
-	}
-
-	updateSessionStatus(
-		sessionId: string,
-		status: SessionStatus,
-		exitCode?: number | null,
-	): { updated: boolean; endedAt?: string } {
-		const row = this.rows.get(sessionId);
-		if (!row) {
-			return { updated: false };
-		}
-		const endedAt = nowIso();
-		row.status = status;
-		row.endedAt = endedAt;
-		row.exitCode = typeof exitCode === "number" ? exitCode : null;
-		row.updatedAt = endedAt;
-		row.statusLock = row.statusLock + 1;
-		return { updated: true, endedAt };
-	}
-
-	writeSessionManifest(manifestPath: string, manifest: SessionManifest): void {
-		writeFileSync(
-			manifestPath,
-			`${JSON.stringify(manifest, null, 2)}\n`,
-			"utf8",
-		);
-	}
-
-	listSessions(limit = 200): SessionRow[] {
-		return Array.from(this.rows.values()).slice(0, limit);
-	}
-
-	deleteSession(sessionId: string): { deleted: boolean } {
-		const row = this.rows.get(sessionId);
-		if (!row) {
-			return { deleted: false };
-		}
-		this.rows.delete(sessionId);
-		unlinkSync(row.messagesPath ?? "");
-		unlinkSync(join(this.sessionsDir, sessionId, `${sessionId}.json`));
-		return { deleted: true };
-	}
-}
-
-describe("LocalRuntimeHost e2e", () => {
-	const envSnapshot = {
-		HOME: process.env.HOME,
-		CLINE_DIR: process.env.CLINE_DIR,
-	};
-	const tempDirs: string[] = [];
-	let isolatedHomeDir = "";
-
-	beforeEach(() => {
-		isolatedHomeDir = mkdtempSync(join(tmpdir(), "core-session-home-"));
-		process.env.HOME = isolatedHomeDir;
-		process.env.CLINE_DIR = join(isolatedHomeDir, ".cline");
-		setHomeDir(isolatedHomeDir);
-		setClineDir(process.env.CLINE_DIR);
-	});
-
-	afterEach(() => {
-		process.env.HOME = envSnapshot.HOME;
-		process.env.CLINE_DIR = envSnapshot.CLINE_DIR;
-		setHomeDir(envSnapshot.HOME ?? "~");
-		setClineDir(envSnapshot.CLINE_DIR ?? join("~", ".cline"));
-		for (const dir of tempDirs.splice(0)) {
-			rmSync(dir, { recursive: true, force: true });
-		}
-		rmSync(isolatedHomeDir, { recursive: true, force: true });
-	});
-
-	it("runs an interactive lifecycle with real artifact files", async () => {
-		const sessionsDir = mkdtempSync(join(tmpdir(), "core-e2e-sessions-"));
-		tempDirs.push(sessionsDir);
-
-		const sessionService = new LocalFileSessionService(sessionsDir);
-		const runtimeShutdown = vi.fn();
-		const runtimeBuilder = {
-			build: vi.fn().mockReturnValue({
-				tools: [],
-				shutdown: runtimeShutdown,
-			}),
-		};
-
-		let messages: LlmsProviders.Message[] = [];
-		let turn = 0;
-		const run = vi.fn(async (prompt: string) => {
-			turn += 1;
-			messages = [
-				...messages,
-				{
-					role: "user",
-					content: [{ type: "text", text: prompt }],
-				},
-				{
-					role: "assistant",
-					content: [{ type: "text", text: `reply:${turn}:${prompt}` }],
-				},
-			] as LlmsProviders.Message[];
-			return createResult({
-				text: `reply:${turn}:${prompt}`,
-				messages: [...messages],
-			});
-		});
-		const continueFn = vi.fn(async (prompt: string) => {
-			turn += 1;
-			messages = [
-				...messages,
-				{
-					role: "user",
-					content: [{ type: "text", text: prompt }],
-				},
-				{
-					role: "assistant",
-					content: [{ type: "text", text: `reply:${turn}:${prompt}` }],
-				},
-			] as LlmsProviders.Message[];
-			return createResult({
-				text: `reply:${turn}:${prompt}`,
-				messages: [...messages],
-			});
-		});
-		const agentShutdown = vi.fn().mockResolvedValue(undefined);
-
-		const manager = new RuntimeHostUnderTest({
-			distinctId: `test-${nanoid(5)}`,
-			sessionService: sessionService as never,
-			runtimeBuilder: runtimeBuilder as never,
-			createAgent: () =>
-				({
-					run,
-					continue: continueFn,
-					abort: vi.fn(),
-					restore: vi.fn((baseline: LlmsProviders.Message[]) => {
-						messages = [...baseline];
-					}),
-					updateConnection: vi.fn(),
-					shutdown: agentShutdown,
-					getMessages: vi.fn(() => [...messages]),
-					messages: [],
-				}) as never,
-		});
-
-		const started = await manager.start({
-			interactive: true,
-			...splitCoreSessionConfig({
-				providerId: "anthropic",
-				modelId: "claude-sonnet-4-6",
-				apiKey: "test-key",
-				cwd: sessionsDir,
-				systemPrompt: "You are a test agent",
-				mode: "act",
-				enableTools: false,
-				enableSpawnAgent: false,
-				enableAgentTeams: false,
-			}),
-		});
-
-		expect(started.sessionId.length).toBeGreaterThan(0);
-		expect(existsSync(started.manifestPath)).toBe(false);
-		expect(existsSync(started.messagesPath)).toBe(false);
-
-		const first = await manager.send({
-			sessionId: started.sessionId,
-			prompt: "first prompt",
-		});
-		const second = await manager.send({
-			sessionId: started.sessionId,
-			prompt: "second prompt",
-		});
-		expect(existsSync(started.manifestPath)).toBe(true);
-		expect(existsSync(started.messagesPath)).toBe(true);
-
-		expect(first?.text).toContain("first prompt");
-		expect(second?.text).toContain("second prompt");
-		expect(run).toHaveBeenCalledTimes(1);
-		expect(continueFn).toHaveBeenCalledTimes(1);
-
-		const persistedMessages = await manager.readMessages(started.sessionId);
-		expect(persistedMessages.length).toBeGreaterThan(0);
-		expect(JSON.stringify(persistedMessages)).toContain("second prompt");
-
-		const listed = await manager.list(20);
-		expect(
-			listed.some((session) => session.sessionId === started.sessionId),
-		).toBe(true);
-
-		await manager.stop(started.sessionId);
-		const stopped = await manager.get(started.sessionId);
-		expect(stopped?.status).toBe("cancelled");
-		expect(stopped?.exitCode).toBe(0);
-		expect(agentShutdown).toHaveBeenCalledTimes(1);
-		expect(runtimeShutdown).toHaveBeenCalledTimes(1);
-		const parsedManifest = JSON.parse(
-			readFileSync(started.manifestPath, "utf8"),
-		) as SessionManifest;
-		expect(parsedManifest.status).toBe("cancelled");
-
-		const deleted = await manager.delete(started.sessionId);
-		expect(deleted).toBe(true);
-		expect(await manager.get(started.sessionId)).toBeUndefined();
-		expect(existsSync(started.manifestPath)).toBe(false);
-		expect(existsSync(started.messagesPath)).toBe(false);
-	});
-});