@clinebot/core 0.0.0

package/src/server/index.ts

@@ -0,0 +1,282 @@
+/**
+ * @clinebot/core/server
+ *
+ * Node/runtime services for host applications (CLI, desktop runtime, servers).
+ */
+
+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,
+} from "../account";
+export type {
+	AgentConfigWatcher,
+	AgentConfigWatcherEvent,
+	AgentYamlConfig,
+	BuildAgentConfigOverridesOptions,
+	CreateAgentConfigWatcherOptions,
+	CreateInstructionWatcherOptions,
+	CreateRulesConfigDefinitionOptions,
+	CreateSkillsConfigDefinitionOptions,
+	CreateUserInstructionConfigWatcherOptions,
+	CreateWorkflowsConfigDefinitionOptions,
+	HookConfigFileEntry,
+	LoadAgentPluginFromPathOptions,
+	ParseMarkdownFrontmatterResult,
+	ParseYamlFrontmatterResult,
+	ResolveAgentPluginPathsOptions,
+	RuleConfig,
+	SkillConfig,
+	UnifiedConfigDefinition,
+	UnifiedConfigFileCandidate,
+	UnifiedConfigFileContext,
+	UnifiedConfigRecord,
+	UnifiedConfigWatcherEvent,
+	UnifiedConfigWatcherOptions,
+	UserInstructionConfig,
+	UserInstructionConfigType,
+	UserInstructionConfigWatcher,
+	UserInstructionConfigWatcherEvent,
+	WorkflowConfig,
+} from "../agents";
+export {
+	createAgentConfigDefinition,
+	createAgentConfigWatcher,
+	createRulesConfigDefinition,
+	createSkillsConfigDefinition,
+	createUserInstructionConfigWatcher,
+	createWorkflowsConfigDefinition,
+	discoverPluginModulePaths,
+	HOOK_CONFIG_FILE_EVENT_MAP,
+	HOOKS_CONFIG_DIRECTORY_NAME,
+	HookConfigFileName,
+	listHookConfigFiles,
+	loadAgentPluginFromPath,
+	loadAgentPluginsFromPaths,
+	parseAgentConfigFromYaml,
+	parsePartialAgentConfigFromYaml,
+	parseRuleConfigFromMarkdown,
+	parseSkillConfigFromMarkdown,
+	parseWorkflowConfigFromMarkdown,
+	RULES_CONFIG_DIRECTORY_NAME,
+	resolveAgentPluginPaths,
+	resolveAgentTools,
+	resolveAndLoadAgentPlugins,
+	resolveDocumentsHooksDirectoryPath,
+	resolveDocumentsRulesDirectoryPath,
+	resolveDocumentsWorkflowsDirectoryPath,
+	resolveHooksConfigSearchPaths,
+	resolvePluginConfigSearchPaths,
+	resolveRulesConfigSearchPaths,
+	resolveSkillsConfigSearchPaths,
+	resolveWorkflowsConfigSearchPaths,
+	SKILLS_CONFIG_DIRECTORY_NAME,
+	toHookConfigFileName,
+	toPartialAgentConfig,
+	UnifiedConfigFileWatcher,
+	WORKFLOWS_CONFIG_DIRECTORY_NAME,
+} from "../agents";
+export {
+	createOAuthClientCallbacks,
+	type OAuthClientCallbacksOptions,
+} from "../auth/client";
+export {
+	createClineOAuthProvider,
+	getValidClineCredentials,
+	loginClineOAuth,
+	refreshClineToken,
+} from "../auth/cline";
+export {
+	getValidOpenAICodexCredentials,
+	isOpenAICodexTokenExpired,
+	loginOpenAICodex,
+	normalizeOpenAICodexCredentials,
+	openaiCodexOAuthProvider,
+	refreshOpenAICodexToken,
+} from "../auth/codex";
+export {
+	createOcaOAuthProvider,
+	createOcaRequestHeaders,
+	DEFAULT_EXTERNAL_IDCS_CLIENT_ID,
+	DEFAULT_EXTERNAL_IDCS_SCOPES,
+	DEFAULT_EXTERNAL_IDCS_URL,
+	DEFAULT_EXTERNAL_OCA_BASE_URL,
+	DEFAULT_INTERNAL_IDCS_CLIENT_ID,
+	DEFAULT_INTERNAL_IDCS_SCOPES,
+	DEFAULT_INTERNAL_IDCS_URL,
+	DEFAULT_INTERNAL_OCA_BASE_URL,
+	generateOcaOpcRequestId,
+	getValidOcaCredentials,
+	loginOcaOAuth,
+	OCI_HEADER_OPC_REQUEST_ID,
+	refreshOcaToken,
+} from "../auth/oca";
+export { startLocalOAuthServer } from "../auth/server";
+export type {
+	OAuthCredentials,
+	OAuthLoginCallbacks,
+	OAuthPrompt,
+	OAuthProviderInterface,
+	OcaClientMetadata,
+	OcaMode,
+	OcaOAuthConfig,
+	OcaOAuthEnvironmentConfig,
+	OcaOAuthProviderOptions,
+	OcaTokenResolution,
+} from "../auth/types";
+export {
+	ALL_DEFAULT_TOOL_NAMES,
+	type AskQuestionExecutor,
+	type CreateBuiltinToolsOptions,
+	type CreateDefaultToolsOptions,
+	createBuiltinTools,
+	createDefaultExecutors,
+	createDefaultTools,
+	createDefaultToolsWithPreset,
+	createToolPoliciesWithPreset,
+	type DefaultExecutorsOptions,
+	type DefaultToolName,
+	DefaultToolNames,
+	type DefaultToolsConfig,
+	type ToolExecutors,
+	type ToolPolicyPresetName,
+	type ToolPresetName,
+	ToolPresets,
+} from "../default-tools";
+export type {
+	FastFileIndexOptions,
+	MentionEnricherOptions,
+	MentionEnrichmentResult,
+} from "../input";
+export {
+	enrichPromptWithMentions,
+	getFileIndex,
+	prewarmFileIndex,
+} from "../input";
+
+export type {
+	LoadMcpSettingsOptions,
+	McpConnectionStatus,
+	McpManager,
+	McpManagerOptions,
+	McpServerClient,
+	McpServerClientFactory,
+	McpServerRegistration,
+	McpServerSnapshot,
+	McpServerTransportConfig,
+	McpSettingsFile,
+	McpSseTransportConfig,
+	McpStdioTransportConfig,
+	McpStreamableHttpTransportConfig,
+	RegisterMcpServersFromSettingsOptions,
+} from "../mcp";
+export {
+	hasMcpSettingsFile,
+	InMemoryMcpManager,
+	loadMcpSettingsFile,
+	registerMcpServersFromSettingsFile,
+	resolveDefaultMcpSettingsPath,
+	resolveMcpServerRegistrations,
+} from "../mcp";
+export {
+	formatRulesForSystemPrompt,
+	isRuleEnabled,
+	listEnabledRulesFromWatcher,
+	loadRulesForSystemPromptFromWatcher,
+} from "../runtime/rules";
+export {
+	createTeamName,
+	DefaultRuntimeBuilder,
+} from "../runtime/runtime-builder";
+export {
+	type SandboxCallOptions,
+	SubprocessSandbox,
+	type SubprocessSandboxOptions,
+} from "../runtime/sandbox/subprocess-sandbox";
+export type {
+	BuiltRuntime,
+	RuntimeBuilder,
+	RuntimeBuilderInput,
+	SessionRuntime,
+} from "../runtime/session-runtime";
+export {
+	type DesktopToolApprovalOptions,
+	requestDesktopToolApproval,
+} from "../runtime/tool-approval";
+export type { AvailableWorkflow } from "../runtime/workflows";
+export {
+	listAvailableWorkflowsFromWatcher,
+	resolveWorkflowSlashCommandFromWatcher,
+} from "../runtime/workflows";
+export { DefaultSessionManager } from "../session/default-session-manager";
+export { RpcCoreSessionService } from "../session/rpc-session-service";
+export {
+	deriveSubsessionStatus,
+	makeSubSessionId,
+	makeTeamTaskSubSessionId,
+	sanitizeSessionToken,
+} from "../session/session-graph";
+export type {
+	CreateSessionHostOptions,
+	SessionHost,
+} from "../session/session-host";
+export { createSessionHost } from "../session/session-host";
+export type {
+	SendSessionInput,
+	SessionManager,
+	StartSessionInput,
+	StartSessionResult,
+} from "../session/session-manager";
+export type { SessionManifest } from "../session/session-manifest";
+export type {
+	CreateRootSessionWithArtifactsInput,
+	RootSessionArtifacts,
+} from "../session/session-service";
+export { CoreSessionService } from "../session/session-service";
+export {
+	createSqliteRpcSessionBackend,
+	SqliteRpcSessionBackend,
+	type SqliteRpcSessionBackendOptions,
+} from "../session/sqlite-rpc-session-backend";
+export type {
+	WorkspaceManager,
+	WorkspaceManagerEvent,
+} from "../session/workspace-manager";
+export { InMemoryWorkspaceManager } from "../session/workspace-manager";
+export type { WorkspaceManifest } from "../session/workspace-manifest";
+export {
+	buildWorkspaceMetadata,
+	emptyWorkspaceManifest,
+	generateWorkspaceInfo,
+	normalizeWorkspacePath,
+	upsertWorkspaceInfo,
+	WorkspaceInfoSchema,
+	WorkspaceManifestSchema,
+} from "../session/workspace-manifest";
+export {
+	type MigrateLegacyProviderSettingsOptions,
+	type MigrateLegacyProviderSettingsResult,
+	migrateLegacyProviderSettings,
+} from "../storage/provider-settings-legacy-migration";
+export { ProviderSettingsManager } from "../storage/provider-settings-manager";
+export { SqliteSessionStore } from "../storage/sqlite-session-store";
+export type { SessionStatus } from "../types/common";
+export { SESSION_STATUSES, SessionSource } from "../types/common";
+export type {
+	CoreAgentMode,
+	CoreModelConfig,
+	CoreRuntimeFeatures,
+	CoreSessionConfig,
+} from "../types/config";
+export type { WorkspaceInfo } from "../types/workspace";

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

@@ -0,0 +1,354 @@
+import {
+	existsSync,
+	mkdirSync,
+	mkdtempSync,
+	readFileSync,
+	rmSync,
+	unlinkSync,
+	writeFileSync,
+} from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import type { AgentResult } from "@clinebot/agents";
+import type { providers as LlmsProviders } from "@clinebot/llms";
+import { nanoid } from "nanoid";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import type { SessionSource, SessionStatus } from "../types/common";
+import { DefaultSessionManager } from "./default-session-manager";
+import type { SessionManifest } from "./session-manifest";
+import type { RootSessionArtifacts, SessionRowShape } from "./session-service";
+
+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, SessionRowShape>();
+
+	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 transcriptPath = join(sessionPath, `${sessionId}.log`);
+		const hookPath = join(sessionPath, `${sessionId}.hooks.jsonl`);
+		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(transcriptPath, "", "utf8");
+		writeFileSync(hookPath, "", "utf8");
+		writeFileSync(
+			messagesPath,
+			`${JSON.stringify({ version: 1, updated_at: startedAt, messages: [] }, null, 2)}\n`,
+			"utf8",
+		);
+
+		this.rows.set(sessionId, {
+			session_id: sessionId,
+			source: input.source,
+			pid: input.pid,
+			started_at: startedAt,
+			ended_at: null,
+			exit_code: null,
+			status: "running",
+			status_lock: 0,
+			interactive: input.interactive ? 1 : 0,
+			provider: input.provider,
+			model: input.model,
+			cwd: input.cwd,
+			workspace_root: input.workspaceRoot,
+			team_name: input.teamName ?? null,
+			enable_tools: input.enableTools ? 1 : 0,
+			enable_spawn: input.enableSpawn ? 1 : 0,
+			enable_teams: input.enableTeams ? 1 : 0,
+			parent_session_id: null,
+			parent_agent_id: null,
+			agent_id: null,
+			conversation_id: null,
+			is_subagent: 0,
+			prompt: prompt ?? null,
+			transcript_path: transcriptPath,
+			hook_path: hookPath,
+			messages_path: messagesPath,
+			updated_at: startedAt,
+		});
+
+		return {
+			manifestPath,
+			transcriptPath,
+			hookPath,
+			messagesPath,
+			manifest,
+		};
+	}
+
+	persistSessionMessages(
+		sessionId: string,
+		messages: LlmsProviders.Message[],
+	): void {
+		const row = this.rows.get(sessionId);
+		if (!row?.messages_path) {
+			throw new Error(`session not found: ${sessionId}`);
+		}
+		writeFileSync(
+			row.messages_path,
+			`${JSON.stringify({ version: 1, updated_at: nowIso(), messages }, 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.ended_at = endedAt;
+		row.exit_code = typeof exitCode === "number" ? exitCode : null;
+		row.updated_at = endedAt;
+		row.status_lock = (row.status_lock ?? 0) + 1;
+		return { updated: true, endedAt };
+	}
+
+	writeSessionManifest(manifestPath: string, manifest: SessionManifest): void {
+		writeFileSync(
+			manifestPath,
+			`${JSON.stringify(manifest, null, 2)}\n`,
+			"utf8",
+		);
+	}
+
+	listSessions(limit = 200): SessionRowShape[] {
+		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.transcript_path);
+		unlinkSync(row.hook_path);
+		unlinkSync(row.messages_path ?? "");
+		unlinkSync(join(this.sessionsDir, sessionId, `${sessionId}.json`));
+		return { deleted: true };
+	}
+}
+
+describe("DefaultSessionManager e2e", () => {
+	const tempDirs: string[] = [];
+
+	afterEach(() => {
+		for (const dir of tempDirs.splice(0)) {
+			rmSync(dir, { 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 DefaultSessionManager({
+			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,
+			config: {
+				providerId: "anthropic",
+				modelId: "claude-sonnet-4-6",
+				apiKey: "test-key",
+				cwd: sessionsDir,
+				systemPrompt: "You are a test agent",
+				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(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);
+	});
+});