@clinebot/core 0.0.37 → 0.0.38

package/src/session/session-manifest-store.ts

@@ -1,158 +0,0 @@
-import {
-	appendFileSync,
-	existsSync,
-	mkdirSync,
-	readFileSync,
-	writeFileSync,
-} from "node:fs";
-import { dirname, join } from "node:path";
-import type * as LlmsProviders from "@clinebot/llms";
-import { ensureHookLogDir } from "@clinebot/shared/storage";
-import { nowIso, SessionArtifacts } from "../services/session-artifacts";
-import {
-	buildMessagesFilePayload,
-	resolveMessagesFileContext,
-	writeEmptyMessagesFile,
-} from "../services/session-data";
-import type {
-	SessionMessagesArtifactUploader,
-	SessionPersistenceAdapter,
-	StoredMessageWithMetadata,
-} from "../types/session";
-import {
-	type SessionManifest,
-	SessionManifestSchema,
-} from "./session-manifest";
-
-export class SessionManifestStore {
-	readonly artifacts: SessionArtifacts;
-
-	constructor(
-		private readonly adapter: SessionPersistenceAdapter,
-		private readonly messagesArtifactUploader?: SessionMessagesArtifactUploader,
-	) {
-		this.artifacts = new SessionArtifacts(() => this.ensureSessionsDir());
-	}
-
-	ensureSessionsDir(): string {
-		return this.adapter.ensureSessionsDir();
-	}
-
-	initializeMessagesFile(
-		sessionId: string,
-		path: string,
-		startedAt: string,
-	): void {
-		writeEmptyMessagesFile(
-			path,
-			startedAt,
-			resolveMessagesFileContext(sessionId),
-		);
-	}
-
-	writeSessionManifest(manifestPath: string, manifest: SessionManifest): void {
-		mkdirSync(dirname(manifestPath), { recursive: true });
-		writeFileSync(
-			manifestPath,
-			`${JSON.stringify(SessionManifestSchema.parse(manifest), null, 2)}\n`,
-			"utf8",
-		);
-	}
-
-	readSessionManifest(sessionId: string): SessionManifest | undefined {
-		return this.readManifestFile(sessionId).manifest;
-	}
-
-	readManifestFile(sessionId: string): {
-		path: string;
-		manifest?: SessionManifest;
-	} {
-		const manifestPath = this.artifacts.sessionManifestPath(sessionId, false);
-		if (!existsSync(manifestPath)) {
-			return { path: manifestPath };
-		}
-		try {
-			return {
-				path: manifestPath,
-				manifest: SessionManifestSchema.parse(
-					JSON.parse(readFileSync(manifestPath, "utf8")) as SessionManifest,
-				),
-			};
-		} catch {
-			return { path: manifestPath };
-		}
-	}
-
-	async resolveArtifactPath(
-		sessionId: string,
-		kind: "messagesPath",
-		fallback: (id: string) => string,
-	): Promise<string> {
-		const row = await this.adapter.getSession(sessionId);
-		const value = row?.[kind];
-		return typeof value === "string" && value.trim().length > 0
-			? value
-			: fallback(sessionId);
-	}
-
-	async persistSessionMessages(
-		sessionId: string,
-		messages: LlmsProviders.Message[],
-		systemPrompt?: string,
-	): Promise<void> {
-		const path = await this.resolveArtifactPath(
-			sessionId,
-			"messagesPath",
-			(id) => this.artifacts.sessionMessagesPath(id),
-		);
-		const payload = buildMessagesFilePayload({
-			updatedAt: nowIso(),
-			context: resolveMessagesFileContext(sessionId),
-			messages: messages as StoredMessageWithMetadata[],
-			systemPrompt,
-		});
-		const contents = `${JSON.stringify(payload, null, 2)}\n`;
-		mkdirSync(dirname(path), { recursive: true });
-		writeFileSync(path, contents, "utf8");
-		if (!this.messagesArtifactUploader) {
-			return;
-		}
-		try {
-			const row = await this.adapter.getSession(sessionId);
-			await this.messagesArtifactUploader.uploadMessagesFile({
-				sessionId,
-				path,
-				contents,
-				row,
-			});
-		} catch (error) {
-			console.warn(
-				`Failed to upload persisted session messages for ${sessionId}`,
-				error,
-			);
-		}
-	}
-
-	appendStaleSessionHookLog(
-		detectedAt: string,
-		sessionId: string,
-		pid: number,
-		reason: string,
-		source: string,
-	): void {
-		const envPath = process.env.CLINE_HOOKS_LOG_PATH?.trim() || undefined;
-		const logPath = envPath ?? join(ensureHookLogDir(), "hooks.jsonl");
-		appendFileSync(
-			logPath,
-			`${JSON.stringify({
-				ts: detectedAt,
-				hookName: "session_shutdown",
-				reason,
-				sessionId,
-				pid,
-				source,
-			})}\n`,
-			"utf8",
-		);
-	}
-}

package/src/session/session-manifest.ts

@@ -1,29 +0,0 @@
-import { z } from "zod";
-import { SESSION_STATUSES } from "../types/common";
-
-const SessionStatusSchema = z.enum(SESSION_STATUSES);
-
-export const SessionManifestSchema = z.object({
-	version: z.literal(1),
-	session_id: z.string().min(1),
-	source: z.string().min(1),
-	pid: z.number().int(),
-	started_at: z.string().min(1),
-	ended_at: z.string().min(1).optional(),
-	exit_code: z.number().int().nullable().optional(),
-	status: SessionStatusSchema,
-	interactive: z.boolean(),
-	provider: z.string().min(1),
-	model: z.string().min(1),
-	cwd: z.string().min(1),
-	workspace_root: z.string().min(1),
-	team_name: z.string().min(1).optional(),
-	enable_tools: z.boolean(),
-	enable_spawn: z.boolean(),
-	enable_teams: z.boolean(),
-	prompt: z.string().optional(),
-	metadata: z.record(z.string(), z.unknown()).optional(),
-	messages_path: z.string().min(1).optional(),
-});
-
-export type SessionManifest = z.infer<typeof SessionManifestSchema>;

package/src/session/session-row.ts

@@ -1,199 +0,0 @@
-import type { TeamTeammateSpec } from "@clinebot/shared";
-import type { AgentTeamsRuntime } from "../extensions/tools/team";
-import type { SessionSource, SessionStatus } from "../types/common";
-import type { SessionManifest } from "./session-manifest";
-
-export interface SessionRow {
-	sessionId: string;
-	source: string;
-	pid: number;
-	startedAt: string;
-	endedAt?: string | null;
-	exitCode?: number | null;
-	status: SessionStatus;
-	statusLock: number;
-	interactive: boolean;
-	provider: string;
-	model: string;
-	cwd: string;
-	workspaceRoot: string;
-	teamName?: string | null;
-	enableTools: boolean;
-	enableSpawn: boolean;
-	enableTeams: boolean;
-	parentSessionId?: string | null;
-	parentAgentId?: string | null;
-	agentId?: string | null;
-	conversationId?: string | null;
-	isSubagent: boolean;
-	prompt?: string | null;
-	metadata?: Record<string, unknown> | null;
-	hookPath?: string;
-	messagesPath?: string | null;
-	updatedAt: string;
-}
-
-export interface CreateRootSessionInput {
-	sessionId: string;
-	source: SessionSource;
-	pid: number;
-	startedAt: string;
-	interactive: boolean;
-	provider: string;
-	model: string;
-	cwd: string;
-	workspaceRoot: string;
-	teamName?: string;
-	enableTools: boolean;
-	enableSpawn: boolean;
-	enableTeams: boolean;
-	prompt?: string;
-	metadata?: Record<string, unknown>;
-	messagesPath: string;
-}
-
-export interface CreateRootSessionWithArtifactsInput {
-	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;
-	metadata?: Record<string, unknown>;
-	startedAt?: string;
-}
-
-export interface RootSessionArtifacts {
-	manifestPath: string;
-	messagesPath: string;
-	manifest: SessionManifest;
-}
-
-export interface UpsertSubagentInput {
-	agentId: string;
-	parentAgentId: string;
-	conversationId: string;
-	prompt?: string;
-	rootSessionId?: string;
-}
-
-/** SELECT clause that aliases snake_case columns to camelCase SessionRow keys. */
-export const SESSION_SELECT_COLUMNS = `
-	session_id    AS sessionId,
-	source,
-	pid,
-	started_at    AS startedAt,
-	ended_at      AS endedAt,
-	exit_code     AS exitCode,
-	status,
-	status_lock   AS statusLock,
-	interactive,
-	provider,
-	model,
-	cwd,
-	workspace_root AS workspaceRoot,
-	team_name      AS teamName,
-	enable_tools   AS enableTools,
-	enable_spawn   AS enableSpawn,
-	enable_teams   AS enableTeams,
-	parent_session_id AS parentSessionId,
-	parent_agent_id   AS parentAgentId,
-	agent_id       AS agentId,
-	conversation_id AS conversationId,
-	is_subagent    AS isSubagent,
-	prompt,
-	metadata_json  AS metadata,
-	hook_path       AS hookPath,
-	messages_path   AS messagesPath,
-	updated_at      AS updatedAt`;
-
-export function patchSqliteRow(raw: Record<string, unknown>): SessionRow {
-	raw.interactive = raw.interactive === 1;
-	raw.enableTools = raw.enableTools === 1;
-	raw.enableSpawn = raw.enableSpawn === 1;
-	raw.enableTeams = raw.enableTeams === 1;
-	raw.isSubagent = raw.isSubagent === 1;
-	const meta = raw.metadata;
-	if (typeof meta === "string" && meta.trim()) {
-		try {
-			const parsed = JSON.parse(meta) as unknown;
-			raw.metadata =
-				parsed && typeof parsed === "object" && !Array.isArray(parsed)
-					? parsed
-					: null;
-		} catch {
-			raw.metadata = null;
-		}
-	} else {
-		raw.metadata = null;
-	}
-	return raw as unknown as SessionRow;
-}
-
-export function stringifyMetadata(
-	metadata: Record<string, unknown> | null | undefined,
-): string | null {
-	if (!metadata || Object.keys(metadata).length === 0) return null;
-	return JSON.stringify(metadata);
-}
-
-export type TeamRuntimeState = ReturnType<AgentTeamsRuntime["exportState"]>;
-
-export interface PersistedTeamEnvelope {
-	version: 1;
-	updatedAt: string;
-	teamState: TeamRuntimeState;
-	teammates: TeamTeammateSpec[];
-}
-
-export function reviveTeamStateDates(
-	state: TeamRuntimeState,
-): TeamRuntimeState {
-	return {
-		...state,
-		tasks: state.tasks.map((task) => ({
-			...task,
-			createdAt: new Date(task.createdAt),
-			updatedAt: new Date(task.updatedAt),
-		})),
-		mailbox: state.mailbox.map((message) => ({
-			...message,
-			sentAt: new Date(message.sentAt),
-			readAt: message.readAt ? new Date(message.readAt) : undefined,
-		})),
-		missionLog: state.missionLog.map((entry) => ({
-			...entry,
-			ts: new Date(entry.ts),
-		})),
-		runs: (state.runs ?? []).map((run) => ({
-			...run,
-			startedAt: new Date(run.startedAt),
-			endedAt: run.endedAt ? new Date(run.endedAt) : undefined,
-			nextAttemptAt: run.nextAttemptAt
-				? new Date(run.nextAttemptAt)
-				: undefined,
-			heartbeatAt: run.heartbeatAt ? new Date(run.heartbeatAt) : undefined,
-		})),
-		outcomes: (state.outcomes ?? []).map((outcome) => ({
-			...outcome,
-			createdAt: new Date(outcome.createdAt),
-			finalizedAt: outcome.finalizedAt
-				? new Date(outcome.finalizedAt)
-				: undefined,
-		})),
-		outcomeFragments: (state.outcomeFragments ?? []).map((fragment) => ({
-			...fragment,
-			createdAt: new Date(fragment.createdAt),
-			reviewedAt: fragment.reviewedAt
-				? new Date(fragment.reviewedAt)
-				: undefined,
-		})),
-	};
-}

package/src/session/session-service.ts

@@ -1,324 +0,0 @@
-import { existsSync, mkdirSync } from "node:fs";
-import { resolveSessionDataDir } from "@clinebot/shared/storage";
-import { nowIso } from "../services/session-artifacts";
-import type { SqliteSessionStore } from "../services/storage/sqlite-session-store";
-import type { SessionMessagesArtifactUploader } from "../types/session";
-import type {
-	PersistedSessionUpdateInput,
-	SessionPersistenceAdapter,
-} from "./persistence-service";
-import { UnifiedSessionPersistenceService } from "./persistence-service";
-import {
-	type CreateRootSessionInput,
-	patchSqliteRow,
-	SESSION_SELECT_COLUMNS,
-	type SessionRow,
-	stringifyMetadata,
-} from "./session-row";
-
-class LocalSessionPersistenceAdapter implements SessionPersistenceAdapter {
-	constructor(
-		private readonly store: SqliteSessionStore,
-		private readonly sessionsDirPath: string = resolveSessionDataDir(),
-	) {}
-
-	ensureSessionsDir(): string {
-		if (!existsSync(this.sessionsDirPath)) {
-			mkdirSync(this.sessionsDirPath, { recursive: true });
-		}
-		return this.sessionsDirPath;
-	}
-
-	async upsertSession(row: SessionRow): Promise<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,
-				row.interactive ? 1 : 0,
-				row.provider,
-				row.model,
-				row.cwd,
-				row.workspaceRoot,
-				row.teamName ?? null,
-				row.enableTools ? 1 : 0,
-				row.enableSpawn ? 1 : 0,
-				row.enableTeams ? 1 : 0,
-				row.parentSessionId ?? null,
-				row.parentAgentId ?? null,
-				row.agentId ?? null,
-				row.conversationId ?? null,
-				row.isSubagent ? 1 : 0,
-				row.prompt ?? null,
-				stringifyMetadata(row.metadata),
-				"",
-				row.hookPath ?? "",
-				row.messagesPath ?? null,
-				row.updatedAt,
-			],
-		);
-	}
-
-	async getSession(sessionId: string): Promise<SessionRow | undefined> {
-		const row = this.store.queryOne<Record<string, unknown>>(
-			`SELECT ${SESSION_SELECT_COLUMNS} FROM sessions WHERE session_id = ?`,
-			[sessionId],
-		);
-		return row ? patchSqliteRow(row) : undefined;
-	}
-
-	async listSessions(options: {
-		limit: number;
-		parentSessionId?: string;
-		status?: string;
-	}): Promise<SessionRow[]> {
-		const whereClauses: string[] = [];
-		const params: unknown[] = [];
-		if (options.parentSessionId) {
-			whereClauses.push("parent_session_id = ?");
-			params.push(options.parentSessionId);
-		}
-		if (options.status) {
-			whereClauses.push("status = ?");
-			params.push(options.status);
-		}
-		const where =
-			whereClauses.length > 0 ? `WHERE ${whereClauses.join(" AND ")}` : "";
-		return this.store
-			.queryAll<Record<string, unknown>>(
-				`SELECT ${SESSION_SELECT_COLUMNS}
-				 FROM sessions
-				 ${where}
-				 ORDER BY started_at DESC
-				 LIMIT ?`,
-				[...params, options.limit],
-			)
-			.map(patchSqliteRow);
-	}
-
-	async updateSession(
-		input: PersistedSessionUpdateInput,
-	): Promise<{ updated: boolean; statusLock: number }> {
-		if (input.setRunning) {
-			if (input.expectedStatusLock === undefined) {
-				return { updated: false, statusLock: 0 };
-			}
-			const changed = this.store.run(
-				`UPDATE sessions
-				 SET status = 'running', ended_at = NULL, exit_code = NULL, updated_at = ?, status_lock = ?,
-					 parent_session_id = ?, parent_agent_id = ?, agent_id = ?, conversation_id = ?, is_subagent = 1,
-					 prompt = COALESCE(prompt, ?)
-				 WHERE session_id = ? AND status_lock = ?`,
-				[
-					nowIso(),
-					input.expectedStatusLock + 1,
-					input.parentSessionId ?? null,
-					input.parentAgentId ?? null,
-					input.agentId ?? null,
-					input.conversationId ?? null,
-					input.prompt ?? null,
-					input.sessionId,
-					input.expectedStatusLock,
-				],
-			);
-			return {
-				updated: (changed.changes ?? 0) > 0,
-				statusLock: input.expectedStatusLock + 1,
-			};
-		}
-
-		const fields: string[] = [];
-		const params: unknown[] = [];
-		if (input.status !== undefined) {
-			fields.push("status = ?");
-			params.push(input.status);
-		}
-		if (input.endedAt !== undefined) {
-			fields.push("ended_at = ?");
-			params.push(input.endedAt);
-		}
-		if (input.exitCode !== undefined) {
-			fields.push("exit_code = ?");
-			params.push(input.exitCode);
-		}
-		if (input.prompt !== undefined) {
-			fields.push("prompt = ?");
-			params.push(input.prompt ?? null);
-		}
-		if (input.metadata !== undefined) {
-			fields.push("metadata_json = ?");
-			params.push(stringifyMetadata(input.metadata));
-		}
-		if (input.parentSessionId !== undefined) {
-			fields.push("parent_session_id = ?");
-			params.push(input.parentSessionId ?? null);
-		}
-		if (input.parentAgentId !== undefined) {
-			fields.push("parent_agent_id = ?");
-			params.push(input.parentAgentId ?? null);
-		}
-		if (input.agentId !== undefined) {
-			fields.push("agent_id = ?");
-			params.push(input.agentId ?? null);
-		}
-		if (input.conversationId !== undefined) {
-			fields.push("conversation_id = ?");
-			params.push(input.conversationId ?? null);
-		}
-		if (fields.length === 0) {
-			const row = await this.getSession(input.sessionId);
-			return { updated: !!row, statusLock: row?.statusLock ?? 0 };
-		}
-
-		let statusLock = 0;
-		if (input.expectedStatusLock !== undefined) {
-			statusLock = input.expectedStatusLock + 1;
-			fields.push("status_lock = ?");
-			params.push(statusLock);
-		}
-		fields.push("updated_at = ?");
-		params.push(nowIso());
-
-		let sql = `UPDATE sessions SET ${fields.join(", ")} WHERE session_id = ?`;
-		params.push(input.sessionId);
-		if (input.expectedStatusLock !== undefined) {
-			sql += " AND status_lock = ?";
-			params.push(input.expectedStatusLock);
-		}
-		const changed = this.store.run(sql, params);
-		if ((changed.changes ?? 0) === 0) {
-			return { updated: false, statusLock: 0 };
-		}
-		if (input.expectedStatusLock === undefined) {
-			const row = await this.getSession(input.sessionId);
-			statusLock = row?.statusLock ?? 0;
-		}
-		return { updated: true, statusLock };
-	}
-
-	async deleteSession(sessionId: string, cascade: boolean): Promise<boolean> {
-		const changed =
-			this.store.run(`DELETE FROM sessions WHERE session_id = ?`, [sessionId])
-				.changes ?? 0;
-		if (cascade) {
-			this.store.run(`DELETE FROM sessions WHERE parent_session_id = ?`, [
-				sessionId,
-			]);
-		}
-		return changed > 0;
-	}
-
-	async enqueueSpawnRequest(input: {
-		rootSessionId: string;
-		parentAgentId: string;
-		task?: string;
-		systemPrompt?: string;
-	}): Promise<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(),
-			],
-		);
-	}
-
-	async claimSpawnRequest(
-		rootSessionId: string,
-		parentAgentId: string,
-	): Promise<string | undefined> {
-		const row = this.store.queryOne<{ id?: number; task?: string | null }>(
-			`SELECT id, task 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;
-		}
-		this.store.run(
-			`UPDATE subagent_spawn_queue SET consumed_at = ? WHERE id = ?`,
-			[nowIso(), row.id],
-		);
-		return row.task ?? undefined;
-	}
-}
-
-export class CoreSessionService extends UnifiedSessionPersistenceService {
-	constructor(
-		private readonly store: SqliteSessionStore,
-		options: {
-			sessionArtifactsDir?: string;
-			messagesArtifactUploader?: SessionMessagesArtifactUploader;
-		} = {},
-	) {
-		super(
-			new LocalSessionPersistenceAdapter(store, options.sessionArtifactsDir),
-			options,
-		);
-	}
-
-	createRootSession(input: CreateRootSessionInput): 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 (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-			[
-				input.sessionId,
-				input.source,
-				input.pid,
-				input.startedAt,
-				null,
-				null,
-				"running",
-				0,
-				input.interactive ? 1 : 0,
-				input.provider,
-				input.model,
-				input.cwd,
-				input.workspaceRoot,
-				input.teamName ?? null,
-				input.enableTools ? 1 : 0,
-				input.enableSpawn ? 1 : 0,
-				input.enableTeams ? 1 : 0,
-				null,
-				null,
-				null,
-				null,
-				0,
-				input.prompt ?? null,
-				input.metadata ? JSON.stringify(input.metadata) : null,
-				"",
-				"",
-				input.messagesPath,
-				nowIso(),
-			],
-		);
-	}
-}
-
-export type {
-	CreateRootSessionInput,
-	CreateRootSessionWithArtifactsInput,
-	RootSessionArtifacts,
-	SessionRow,
-	UpsertSubagentInput,
-} from "./session-row";