@clinebot/core 0.0.37 → 0.0.38

package/src/runtime/history.ts

@@ -1,374 +0,0 @@
-import { readdir, readFile } from "node:fs/promises";
-import { join } from "node:path";
-import type * as LlmsProviders from "@clinebot/llms";
-import { formatDisplayUserInput, normalizeUserInput } from "@clinebot/shared";
-import { resolveSessionDataDir } from "@clinebot/shared/storage";
-import type { SessionManifest } from "../session/session-manifest";
-import { SessionManifestSchema } from "../session/session-manifest";
-import type {
-	SessionHistoryMetadata,
-	SessionHistoryRecord,
-	SessionRecord,
-} from "../types/sessions";
-import type { RuntimeHost } from "./runtime-host";
-
-export interface SessionHistoryListOptions {
-	limit?: number;
-	includeManifestFallback?: boolean;
-	hydrate?: boolean;
-}
-
-type StoredSessionMessage = LlmsProviders.Message & {
-	metrics?: {
-		cost?: number;
-	};
-	modelInfo?: {
-		id?: string;
-		provider?: string;
-	};
-};
-
-type TextBlock = {
-	type?: string;
-	text?: string;
-};
-
-function asTrimmedString(value: unknown): string | undefined {
-	if (typeof value !== "string") {
-		return undefined;
-	}
-	const trimmed = value.trim();
-	return trimmed.length > 0 ? trimmed : undefined;
-}
-
-function asKnownString(value: unknown): string | undefined {
-	const trimmed = asTrimmedString(value);
-	if (!trimmed) {
-		return undefined;
-	}
-	return trimmed.toLowerCase() === "unknown" ? undefined : trimmed;
-}
-
-function asFiniteNumber(value: unknown): number | undefined {
-	return typeof value === "number" && Number.isFinite(value)
-		? value
-		: undefined;
-}
-
-function asHistoryMetadata(value: unknown): SessionHistoryMetadata | undefined {
-	if (!value || typeof value !== "object" || Array.isArray(value)) {
-		return undefined;
-	}
-	return { ...(value as Record<string, unknown>) };
-}
-
-function normalizeHistoryLimit(limit: number | undefined): number {
-	const value = limit ?? 200;
-	return Number.isFinite(value) ? Math.max(0, Math.floor(value)) : 200;
-}
-
-function extractSessionRecencyToken(sessionId: string): number {
-	const matches = sessionId.match(/\d{13,}/g);
-	if (!matches || matches.length === 0) {
-		return 0;
-	}
-	let best = 0;
-	for (const match of matches) {
-		const value = Number.parseInt(match, 10);
-		if (Number.isFinite(value) && value > best) {
-			best = value;
-		}
-	}
-	return best;
-}
-
-function manifestToSessionRecord(manifest: SessionManifest): SessionRecord {
-	return {
-		sessionId: manifest.session_id,
-		source: manifest.source,
-		pid: manifest.pid,
-		startedAt: manifest.started_at,
-		endedAt: manifest.ended_at ?? null,
-		exitCode: manifest.exit_code ?? null,
-		status: manifest.status,
-		interactive: manifest.interactive,
-		provider: manifest.provider,
-		model: manifest.model,
-		cwd: manifest.cwd,
-		workspaceRoot: manifest.workspace_root,
-		teamName: manifest.team_name,
-		enableTools: manifest.enable_tools,
-		enableSpawn: manifest.enable_spawn,
-		enableTeams: manifest.enable_teams,
-		isSubagent: false,
-		prompt: manifest.prompt,
-		metadata: manifest.metadata,
-		messagesPath: manifest.messages_path,
-		updatedAt: manifest.ended_at ?? manifest.started_at,
-	};
-}
-
-async function listManifestHistoryRows(
-	limit: number,
-): Promise<SessionRecord[]> {
-	const requestedLimit = normalizeHistoryLimit(limit);
-	const sessionsDir = resolveSessionDataDir();
-	const entries = await readdir(sessionsDir, { withFileTypes: true }).catch(
-		() => [],
-	);
-	const candidateEntries = entries
-		.filter((entry) => entry.isDirectory())
-		.map((entry) => ({
-			entry,
-			recency: extractSessionRecencyToken(entry.name.trim()),
-		}))
-		.sort(
-			(left, right) =>
-				right.recency - left.recency ||
-				right.entry.name.localeCompare(left.entry.name),
-		)
-		.slice(0, requestedLimit);
-	const rows = await Promise.all(
-		candidateEntries.map(async ({ entry }) => {
-			const sessionId = entry.name.trim();
-			if (!sessionId) {
-				return undefined;
-			}
-			const manifestPath = join(sessionsDir, sessionId, `${sessionId}.json`);
-			const raw = await readFile(manifestPath, "utf8").catch(() => undefined);
-			if (!raw) {
-				return undefined;
-			}
-			let parsedJson: unknown;
-			try {
-				parsedJson = JSON.parse(raw) as unknown;
-			} catch {
-				return undefined;
-			}
-			const parsedManifest = SessionManifestSchema.safeParse(parsedJson);
-			if (!parsedManifest.success) {
-				return undefined;
-			}
-			return manifestToSessionRecord(parsedManifest.data);
-		}),
-	);
-
-	return rows
-		.filter((row): row is SessionRecord => Boolean(row))
-		.sort((left, right) => right.startedAt.localeCompare(left.startedAt))
-		.slice(0, requestedLimit);
-}
-
-function extractTextFromContent(
-	content: LlmsProviders.Message["content"],
-): string {
-	if (typeof content === "string") {
-		return content.trim();
-	}
-	const segments: string[] = [];
-	for (const block of content) {
-		if (!block || typeof block !== "object") {
-			continue;
-		}
-		const maybeText = block as TextBlock;
-		if (maybeText.type !== "text") {
-			continue;
-		}
-		const text = maybeText.text?.trim();
-		if (text) {
-			segments.push(text);
-		}
-	}
-	return segments.join("\n").trim();
-}
-
-function toSingleLine(text: string): string {
-	return text.replace(/\s+/g, " ").trim();
-}
-
-function truncateText(text: string, limit: number): string {
-	if (text.length <= limit) {
-		return text;
-	}
-	return `${text.slice(0, Math.max(0, limit - 3)).trimEnd()}...`;
-}
-
-function inferTitleFromMessages(
-	messages: LlmsProviders.Message[],
-): string | undefined {
-	for (const role of ["user", "assistant"] as const) {
-		for (const raw of messages) {
-			if (raw.role !== role) {
-				continue;
-			}
-			const text = toSingleLine(extractTextFromContent(raw.content));
-			if (!text) {
-				continue;
-			}
-			const formatted =
-				role === "user" ? toSingleLine(formatDisplayUserInput(text)) : text;
-			const normalized = normalizeUserInput(
-				formatted.split("\n")[0] ?? formatted,
-			);
-			return truncateText(normalized, 50);
-		}
-	}
-	return undefined;
-}
-
-function summarizeCostFromMessages(messages: LlmsProviders.Message[]): number {
-	let total = 0;
-	for (const message of messages as StoredSessionMessage[]) {
-		total += asFiniteNumber(message.metrics?.cost) ?? 0;
-	}
-	return total;
-}
-
-function inferProviderAndModelFromMessages(messages: LlmsProviders.Message[]): {
-	provider?: string;
-	model?: string;
-} {
-	let provider: string | undefined;
-	let model: string | undefined;
-	for (let i = messages.length - 1; i >= 0; i -= 1) {
-		const message = messages[i] as StoredSessionMessage;
-		if (!provider) {
-			provider = asKnownString(message.modelInfo?.provider);
-		}
-		if (!model) {
-			model = asKnownString(message.modelInfo?.id);
-		}
-		if (provider && model) {
-			break;
-		}
-	}
-	return { provider, model };
-}
-
-function getMetadataProvider(
-	metadata?: SessionHistoryMetadata,
-): string | undefined {
-	return (
-		asKnownString(metadata?.provider) ??
-		asKnownString(
-			metadata?.provider &&
-				typeof metadata.provider === "object" &&
-				!Array.isArray(metadata.provider)
-				? (metadata.provider as Record<string, unknown>).id
-				: undefined,
-		)
-	);
-}
-
-function getMetadataModel(
-	metadata?: SessionHistoryMetadata,
-): string | undefined {
-	return (
-		asKnownString(metadata?.model) ??
-		asKnownString(
-			metadata?.model &&
-				typeof metadata.model === "object" &&
-				!Array.isArray(metadata.model)
-				? (metadata.model as Record<string, unknown>).id
-				: undefined,
-		)
-	);
-}
-
-function normalizeHistoryRow(
-	row: SessionRecord,
-	overrides?: {
-		title?: string;
-		provider?: string;
-		model?: string;
-		totalCost?: number;
-	},
-): SessionHistoryRecord {
-	const metadata = asHistoryMetadata(row.metadata);
-	const title =
-		asTrimmedString(overrides?.title) ?? asTrimmedString(metadata?.title);
-	const totalCost =
-		asFiniteNumber(overrides?.totalCost) ?? asFiniteNumber(metadata?.totalCost);
-	const nextMetadata =
-		metadata || title !== undefined || totalCost !== undefined
-			? {
-					...(metadata ?? {}),
-					...(title !== undefined ? { title } : {}),
-					...(totalCost !== undefined ? { totalCost } : {}),
-				}
-			: undefined;
-	return {
-		...row,
-		provider:
-			asKnownString(overrides?.provider) ??
-			asKnownString(row.provider) ??
-			getMetadataProvider(metadata) ??
-			"",
-		model:
-			asKnownString(overrides?.model) ??
-			asKnownString(row.model) ??
-			getMetadataModel(metadata) ??
-			"",
-		metadata: nextMetadata,
-	};
-}
-
-export async function hydrateSessionHistory(
-	host: Pick<RuntimeHost, "readMessages">,
-	rows: SessionRecord[],
-): Promise<SessionHistoryRecord[]> {
-	return await Promise.all(
-		rows.map(async (row) => {
-			const initial = normalizeHistoryRow(row);
-			const hasTitle = Boolean(asTrimmedString(initial.metadata?.title));
-			const hasProvider = Boolean(asKnownString(initial.provider));
-			const hasModel = Boolean(asKnownString(initial.model));
-			const knownCost = asFiniteNumber(initial.metadata?.totalCost);
-			const hasCost = knownCost !== undefined && knownCost > 0;
-			if (hasTitle && hasProvider && hasModel && hasCost) {
-				return initial;
-			}
-			const messages = await host.readMessages(row.sessionId);
-			if (messages.length === 0) {
-				return initial;
-			}
-			const inferredProviderModel = inferProviderAndModelFromMessages(messages);
-			const inferredCost = summarizeCostFromMessages(messages);
-			return normalizeHistoryRow(row, {
-				title: hasTitle ? undefined : inferTitleFromMessages(messages),
-				provider: hasProvider ? undefined : inferredProviderModel.provider,
-				model: hasModel ? undefined : inferredProviderModel.model,
-				totalCost: hasCost || inferredCost <= 0 ? undefined : inferredCost,
-			});
-		}),
-	);
-}
-
-export async function listSessionHistory(
-	host: Pick<RuntimeHost, "list" | "readMessages">,
-	options: SessionHistoryListOptions = {},
-): Promise<SessionHistoryRecord[]> {
-	const limit = normalizeHistoryLimit(options.limit);
-	const backendRows = (await host.list(limit)).slice(0, limit);
-	const manifestRows =
-		options.includeManifestFallback === true && backendRows.length < limit
-			? await listManifestHistoryRows(Math.min(Math.max(limit * 2, 100), 500))
-			: [];
-	const merged = new Map<string, SessionRecord>();
-	for (const row of [...backendRows, ...manifestRows]) {
-		if (merged.has(row.sessionId)) {
-			continue;
-		}
-		merged.set(row.sessionId, row);
-	}
-	const rows =
-		manifestRows.length === 0
-			? backendRows
-			: Array.from(merged.values())
-					.sort((left, right) => right.startedAt.localeCompare(left.startedAt))
-					.slice(0, limit);
-	if (options.hydrate === false) {
-		return rows.map((row) => normalizeHistoryRow(row));
-	}
-	return await hydrateSessionHistory(host, rows);
-}

package/src/runtime/host.ts

@@ -1,222 +0,0 @@
-import type { ClineCoreOptions } from "../ClineCore";
-import {
-	ensureCompatibleLocalHubUrl,
-	resolveCompatibleLocalHubUrl,
-} from "../hub/client";
-import { prewarmDetachedHubServer } from "../hub/daemon";
-import { SqliteSessionStore } from "../services/storage/sqlite-session-store";
-import { resolveCoreDistinctId } from "../services/telemetry/distinct-id";
-import { FileSessionService } from "../session/file-session-service";
-import { CoreSessionService } from "../session/session-service";
-import { HubRuntimeHost } from "../transports/hub";
-import { LocalRuntimeHost } from "../transports/local";
-import { RemoteRuntimeHost } from "../transports/remote";
-import type { RuntimeHost, RuntimeHostMode } from "./runtime-host";
-
-function resolveConfiguredBackendMode(
-	options: ClineCoreOptions,
-): RuntimeHostMode {
-	if (options.backendMode) {
-		return options.backendMode;
-	}
-	if (process.env.CLINE_VCR?.trim()) {
-		return "local";
-	}
-	const raw = process.env.CLINE_SESSION_BACKEND_MODE?.trim().toLowerCase();
-	if (raw === "local" || raw === "hub" || raw === "remote") {
-		return raw;
-	}
-	return "auto";
-}
-
-export type SessionBackend = CoreSessionService | FileSessionService;
-
-let cachedBackend: SessionBackend | undefined;
-let backendInitPromise: Promise<SessionBackend> | undefined;
-
-function prewarmLocalHubIfNeeded(
-	configuredMode: RuntimeHostMode,
-	options: ClineCoreOptions,
-): void {
-	if (configuredMode !== "auto" && configuredMode !== "hub") {
-		return;
-	}
-	if (options.hub?.endpoint?.trim()) {
-		return;
-	}
-	prewarmDetachedHubServer(
-		options.hub?.workspaceRoot?.trim() ||
-			options.hub?.cwd?.trim() ||
-			process.cwd(),
-	);
-}
-
-async function reconcileDeadSessionsIfSupported(
-	backend: SessionBackend,
-): Promise<void> {
-	const service = backend as SessionBackend & {
-		reconcileDeadSessions?: (limit?: number) => Promise<number>;
-	};
-	await service.reconcileDeadSessions?.().catch(() => {});
-}
-
-function createLocalBackend(options: ClineCoreOptions): SessionBackend {
-	try {
-		const store = new SqliteSessionStore();
-		store.init();
-		return new CoreSessionService(store, {
-			messagesArtifactUploader: options.messagesArtifactUploader,
-		});
-	} catch {
-		// Fallback to file-based session service if SQLite is unavailable.
-		options.telemetry?.capture({
-			event: "session_backend_fallback",
-			properties: {
-				requestedBackend: "sqlite",
-				fallbackBackend: "file",
-			},
-		});
-		return new FileSessionService(undefined, {
-			messagesArtifactUploader: options.messagesArtifactUploader,
-		});
-	}
-}
-
-function createLocalRuntimeHost(
-	options: ClineCoreOptions,
-	distinctId: string,
-	backend?: SessionBackend,
-): LocalRuntimeHost {
-	return new LocalRuntimeHost({
-		sessionService:
-			backend ?? options.sessionService ?? createLocalBackend(options),
-		defaultToolExecutors: options.defaultToolExecutors,
-		telemetry: options.telemetry,
-		toolPolicies: options.toolPolicies,
-		requestToolApproval: options.requestToolApproval,
-		distinctId,
-		fetch: options.fetch,
-	});
-}
-
-export async function resolveSessionBackend(
-	options: ClineCoreOptions,
-): Promise<SessionBackend> {
-	if (cachedBackend) {
-		return cachedBackend;
-	}
-	if (backendInitPromise) {
-		return await backendInitPromise;
-	}
-
-	backendInitPromise = (async () => {
-		cachedBackend = createLocalBackend(options);
-		await reconcileDeadSessionsIfSupported(cachedBackend);
-		return cachedBackend;
-	})().finally(() => {
-		backendInitPromise = undefined;
-	});
-
-	return await backendInitPromise;
-}
-
-export async function createRuntimeHost(
-	options: ClineCoreOptions,
-): Promise<RuntimeHost> {
-	const distinctId = resolveCoreDistinctId(options.distinctId);
-	options.telemetry?.setDistinctId(distinctId);
-	const configuredMode = resolveConfiguredBackendMode(options);
-	prewarmLocalHubIfNeeded(configuredMode, options);
-	if (configuredMode === "remote") {
-		const remoteEndpoint = options.remote?.endpoint?.trim();
-		if (!remoteEndpoint) {
-			throw new Error(
-				"Remote runtime mode requires `remote.endpoint` to be configured.",
-			);
-		}
-		options.logger?.log("Using remote runtime host", {
-			endpoint: remoteEndpoint,
-		});
-		return new RemoteRuntimeHost({
-			endpoint: remoteEndpoint,
-			authToken: options.remote?.authToken,
-			clientType: options.remote?.clientType,
-			displayName: options.remote?.displayName,
-			workspaceRoot: options.remote?.workspaceRoot,
-			cwd: options.remote?.cwd,
-			requestToolApproval: options.requestToolApproval,
-		});
-	}
-	if (configuredMode === "hub") {
-		const explicitEndpoint = options.hub?.endpoint?.trim();
-		const hubUrl =
-			explicitEndpoint ||
-			(await ensureCompatibleLocalHubUrl({
-				strategy: options.hub?.strategy ?? "require-hub",
-				workspaceRoot: options.hub?.workspaceRoot,
-				cwd: options.hub?.cwd,
-			}));
-		if (!hubUrl) {
-			throw new Error("No compatible hub runtime is available.");
-		}
-		options.logger?.log("Using hub runtime host", {
-			url: hubUrl,
-			explicitEndpoint: explicitEndpoint || undefined,
-		});
-		return new HubRuntimeHost(
-			{
-				url: hubUrl,
-				authToken: options.hub?.authToken,
-				clientType: options.hub?.clientType,
-				displayName: options.hub?.displayName,
-				requestToolApproval: options.requestToolApproval,
-			},
-			{
-				workspaceRoot: options.hub?.workspaceRoot,
-				cwd: options.hub?.cwd,
-			},
-		);
-	}
-	if (configuredMode === "auto") {
-		const hubUrl = await resolveCompatibleLocalHubUrl({
-			endpoint: options.hub?.endpoint,
-			strategy: options.hub?.strategy ?? "prefer-hub",
-			workspaceRoot: options.hub?.workspaceRoot,
-			cwd: options.hub?.cwd,
-		});
-		if (hubUrl) {
-			options.logger?.log("Using discovered local hub runtime host", {
-				url: hubUrl,
-			});
-			const host = new HubRuntimeHost(
-				{
-					url: hubUrl,
-					authToken: options.hub?.authToken,
-					clientType: options.hub?.clientType,
-					displayName: options.hub?.displayName,
-					requestToolApproval: options.requestToolApproval,
-				},
-				{
-					workspaceRoot: options.hub?.workspaceRoot,
-					cwd: options.hub?.cwd,
-				},
-			);
-			try {
-				await host.connect();
-				return host;
-			} catch (error) {
-				options.logger?.log("Falling back to local runtime host", {
-					reason: "hub_connect_failed",
-					severity: "warn",
-					error,
-				});
-			}
-		}
-		options.logger?.log("Falling back to local runtime host", {
-			reason: "compatible_hub_unavailable",
-			severity: "warn",
-		});
-		return createLocalRuntimeHost(options, distinctId);
-	}
-	return createLocalRuntimeHost(options, distinctId);
-}

package/src/runtime/index.ts

@@ -1,23 +0,0 @@
-export {
-	formatRulesForSystemPrompt,
-	isRuleEnabled,
-	listEnabledRulesFromWatcher,
-	loadRulesForSystemPromptFromWatcher,
-	mergeRulesForSystemPrompt,
-} from "./rules";
-export { createTeamName, DefaultRuntimeBuilder } from "./runtime-builder";
-export type {
-	BuiltRuntime,
-	RuntimeBuilder,
-	RuntimeBuilderInput,
-	SessionRuntime,
-} from "./session-runtime";
-export {
-	type SandboxCallOptions,
-	SubprocessSandbox,
-	type SubprocessSandboxOptions,
-} from "./subprocess-sandbox";
-export {
-	type DesktopToolApprovalOptions,
-	requestDesktopToolApproval,
-} from "./tool-approval";