@flowdular/sdk 0.1.0 → 0.2.0

package/packages/coding-agent/src/drivers/claude-code.ts

@@ -1,290 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import type { AiUsage } from '@flowdular/sdk/ai-provider';
-import {
-	CodingAgentError,
-	type CodingAgentAvailability,
-	type CodingAgentDriver,
-	type CodingAgentEvent,
-	type CodingAgentTurnRequest,
-	type FileChangeKind,
-} from '../types.ts';
-import {
-	parseJsonLine,
-	probeCommand,
-	spawnLineStream,
-	workspaceRelative,
-} from '../workspace.ts';
-
-export interface ClaudeCodeDriverOptions {
-	readonly command?: string;
-	/* Built-in tools the session may use. Command execution stays out: gates are
-	   run by the sandbox orchestrator, never by the model. */
-	readonly tools?: readonly string[];
-	readonly defaultModel?: string | null;
-	readonly timeoutMs?: number;
-}
-
-const DEFAULT_TOOLS = ['Read', 'Write', 'Edit', 'Glob', 'Grep'] as const;
-const DEFAULT_TIMEOUT_MS = 10 * 60 * 1000;
-
-interface ContentBlock {
-	readonly type?: string;
-	readonly text?: string;
-	readonly name?: string;
-	readonly input?: Record<string, unknown>;
-	readonly content?: unknown;
-	readonly is_error?: boolean;
-}
-
-function toolDetail(input: Record<string, unknown> | undefined): string {
-	if (!input) return '';
-	for (const key of ['file_path', 'path', 'pattern', 'query', 'command']) {
-		const value = input[key];
-		if (typeof value === 'string') return value.slice(0, 200);
-	}
-	return '';
-}
-
-function usageOf(value: unknown): AiUsage {
-	const usage = (value ?? {}) as Record<string, unknown>;
-	const inputTokens = Number(usage.input_tokens ?? 0);
-	const outputTokens = Number(usage.output_tokens ?? 0);
-	return {
-		inputTokens: Number.isFinite(inputTokens) ? inputTokens : 0,
-		outputTokens: Number.isFinite(outputTokens) ? outputTokens : 0,
-		totalTokens:
-			(Number.isFinite(inputTokens) ? inputTokens : 0) +
-			(Number.isFinite(outputTokens) ? outputTokens : 0),
-	};
-}
-
-/* A resumed session whose file is still held by the previous process, or was
-   never flushed, fails before the init message. The turn then continues on a
-   fresh session with the conversation replayed, as the codex driver does. */
-function isResumeFailure(error: unknown): boolean {
-	return (
-		error instanceof CodingAgentError && error.code === 'DRIVER_START_FAILED'
-	);
-}
-
-function replayedPrompt(request: CodingAgentTurnRequest): string {
-	const history = request.history ?? [];
-	if (history.length === 0) return request.prompt;
-	return [
-		'<conversation-so-far>',
-		...history.map((message) => `${message.role}: ${message.text.trim()}`),
-		'</conversation-so-far>',
-		'',
-		request.prompt,
-	].join('\n');
-}
-
-function changeKind(value: unknown): FileChangeKind | null {
-	if (value === 'create') return 'created';
-	if (value === 'update') return 'modified';
-	if (value === 'delete') return 'deleted';
-	return null;
-}
-
-export function createClaudeCodeDriver(
-	options: ClaudeCodeDriverOptions = {},
-): CodingAgentDriver {
-	const command = options.command ?? 'claude';
-	const tools = (options.tools ?? DEFAULT_TOOLS).join(',');
-
-	return {
-		id: 'claude-code',
-		label: 'Claude Code',
-		kind: 'local-cli',
-		requiresLoopback: true,
-		description:
-			'Local claude binary in print mode with restricted tools and the session workspace as its only writable directory.',
-
-		async probe(): Promise<CodingAgentAvailability> {
-			const result = await probeCommand(command, ['--version']);
-			return {
-				available: result.available,
-				detail: result.available
-					? `Uses the operator login of ${command}.`
-					: result.detail,
-				version: result.version,
-			};
-		},
-
-		async *run(
-			request: CodingAgentTurnRequest,
-		): AsyncIterable<CodingAgentEvent> {
-			const resumeId = request.resumeId ?? null;
-			if (!resumeId) {
-				yield* runSession(request, null);
-				return;
-			}
-			try {
-				yield* runSession(request, resumeId);
-			} catch (error) {
-				if (!isResumeFailure(error)) throw error;
-				yield {
-					type: 'error',
-					code: 'DRIVER_SESSION_LOCKED',
-					message:
-						'The previous claude session could not be resumed, so this turn continues on a new session with the conversation replayed.',
-				};
-				yield* runSession(request, null, true);
-			}
-		},
-	};
-
-	async function* runSession(
-		request: CodingAgentTurnRequest,
-		resumeId: string | null,
-		replayHistory = false,
-	): AsyncIterable<CodingAgentEvent> {
-		const sessionId = resumeId ?? randomUUID();
-		const args = [
-			'--print',
-			'--output-format',
-			'stream-json',
-			'--verbose',
-			'--permission-mode',
-			'acceptEdits',
-			'--restricted',
-			'--strict-mcp-config',
-			'--tools',
-			tools,
-			'--add-dir',
-			request.workspacePath,
-			'--append-system-prompt',
-			request.systemInstruction,
-			...(resumeId ? ['--resume', resumeId] : ['--session-id', sessionId]),
-			...((request.model ?? options.defaultModel)
-				? ['--model', (request.model ?? options.defaultModel)!]
-				: []),
-			replayHistory ? replayedPrompt(request) : request.prompt,
-		];
-
-		const stream = spawnLineStream({
-			command,
-			args,
-			cwd: request.workspacePath,
-			signal: request.signal,
-			timeoutMs: request.timeoutMs ?? options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
-		});
-
-		let started = false;
-		let completed = false;
-		let currentResumeId = resumeId;
-		for await (const line of stream.lines) {
-			const message = parseJsonLine(line);
-			if (!message) continue;
-			const type = message.type;
-
-			if (type === 'system' && message.subtype === 'init') {
-				currentResumeId =
-					typeof message.session_id === 'string'
-						? message.session_id
-						: currentResumeId;
-				started = true;
-				yield {
-					type: 'turn.started',
-					driver: 'claude-code',
-					role: request.role,
-					resumeId: currentResumeId,
-				};
-				continue;
-			}
-
-			if (type === 'assistant') {
-				const content = ((message.message ?? {}) as Record<string, unknown>)
-					.content;
-				for (const block of (content ?? []) as ContentBlock[]) {
-					if (block.type === 'text' && block.text?.trim()) {
-						yield { type: 'assistant.message', text: block.text };
-					}
-					if (block.type === 'thinking' && typeof block.text === 'string') {
-						yield { type: 'reasoning', text: block.text };
-					}
-					if (block.type === 'tool_use' && block.name) {
-						yield {
-							type: 'tool.started',
-							tool: block.name,
-							detail: toolDetail(block.input),
-						};
-					}
-				}
-				continue;
-			}
-
-			if (type === 'user') {
-				const content = ((message.message ?? {}) as Record<string, unknown>)
-					.content;
-				const result = (message.tool_use_result ?? {}) as Record<
-					string,
-					unknown
-				>;
-				for (const block of (content ?? []) as ContentBlock[]) {
-					if (block.type !== 'tool_result') continue;
-					yield {
-						type: 'tool.completed',
-						tool: typeof result.type === 'string' ? result.type : 'tool',
-						detail: typeof result.filePath === 'string' ? result.filePath : '',
-						ok: block.is_error !== true,
-					};
-				}
-				const change = changeKind(result.type);
-				if (change && typeof result.filePath === 'string') {
-					yield {
-						type: 'file.changed',
-						path: workspaceRelative(request.workspacePath, result.filePath),
-						change,
-					};
-				}
-				continue;
-			}
-
-			if (type === 'result') {
-				completed = true;
-				const failed = message.is_error === true;
-				if (failed && typeof message.result === 'string') {
-					yield {
-						type: 'error',
-						code: 'DRIVER_TURN_FAILED',
-						message: message.result.slice(0, 500),
-					};
-				} else if (typeof message.result === 'string' && message.result) {
-					yield { type: 'assistant.message', text: message.result };
-				}
-				yield {
-					type: 'turn.completed',
-					resumeId:
-						typeof message.session_id === 'string'
-							? message.session_id
-							: currentResumeId,
-					usage: usageOf(message.usage),
-					costUsd:
-						typeof message.total_cost_usd === 'number'
-							? message.total_cost_usd
-							: null,
-					finishReason: failed ? 'error' : 'stop',
-				};
-			}
-		}
-
-		const exit = await stream.finished;
-		if (completed) return;
-		if (exit.aborted) {
-			yield {
-				type: 'turn.completed',
-				resumeId: currentResumeId,
-				usage: { inputTokens: 0, outputTokens: 0, totalTokens: 0 },
-				costUsd: null,
-				finishReason: 'aborted',
-			};
-			return;
-		}
-		throw new CodingAgentError(
-			started ? 'DRIVER_STREAM_INCOMPLETE' : 'DRIVER_START_FAILED',
-			exit.stderr.trim().slice(0, 300) ||
-				`The ${command} process exited with code ${exit.code} before completing the turn.`,
-		);
-	}
-}

package/packages/coding-agent/src/drivers/codex.ts

@@ -1,281 +0,0 @@
-import type { AiUsage } from '@flowdular/sdk/ai-provider';
-import {
-	CodingAgentError,
-	type CodingAgentAvailability,
-	type CodingAgentDriver,
-	type CodingAgentEvent,
-	type CodingAgentTurnRequest,
-	type FileChangeKind,
-} from '../types.ts';
-import {
-	parseJsonLine,
-	probeCommand,
-	spawnLineStream,
-	workspaceRelative,
-} from '../workspace.ts';
-
-export interface CodexDriverOptions {
-	readonly command?: string;
-	readonly defaultModel?: string | null;
-	readonly timeoutMs?: number;
-}
-
-const DEFAULT_TIMEOUT_MS = 10 * 60 * 1000;
-
-interface CodexItem {
-	readonly id?: string;
-	readonly type?: string;
-	readonly text?: string;
-	readonly command?: string;
-	readonly status?: string;
-	readonly exit_code?: number | null;
-	readonly changes?: readonly { path?: string; kind?: string }[];
-}
-
-function usageOf(value: unknown): AiUsage {
-	const usage = (value ?? {}) as Record<string, unknown>;
-	const inputTokens = Number(usage.input_tokens ?? 0);
-	const outputTokens = Number(usage.output_tokens ?? 0);
-	return {
-		inputTokens: Number.isFinite(inputTokens) ? inputTokens : 0,
-		outputTokens: Number.isFinite(outputTokens) ? outputTokens : 0,
-		totalTokens:
-			(Number.isFinite(inputTokens) ? inputTokens : 0) +
-			(Number.isFinite(outputTokens) ? outputTokens : 0),
-	};
-}
-
-function changeKind(value: string | undefined): FileChangeKind {
-	if (value === 'add') return 'created';
-	if (value === 'delete') return 'deleted';
-	return 'modified';
-}
-
-/* Codex has no system prompt flag, so the role contract is prepended as a
-   delimited preamble the model reads before the request. A turn that could not
-   resume its thread also replays the conversation, because a fresh thread
-   starts with no memory of it. */
-function composePrompt(
-	request: CodingAgentTurnRequest,
-	replayHistory: boolean,
-): string {
-	const history = replayHistory ? (request.history ?? []) : [];
-	return [
-		'<role-contract>',
-		request.systemInstruction.trim(),
-		'</role-contract>',
-		...(history.length > 0
-			? [
-					'',
-					'<conversation-so-far>',
-					...history.map(
-						(message) => `${message.role}: ${message.text.trim()}`,
-					),
-					'</conversation-so-far>',
-				]
-			: []),
-		'',
-		'<request>',
-		request.prompt.trim(),
-		'</request>',
-	].join('\n');
-}
-
-/* Codex keeps one writer per thread. A previous turn that has not released it
-   yet, or was killed before it could, makes every resume of that thread fail. */
-function isThreadLocked(error: unknown): boolean {
-	return (
-		error instanceof CodingAgentError &&
-		/thread-store conflict|active writer/i.test(error.message)
-	);
-}
-
-export function createCodexDriver(
-	options: CodexDriverOptions = {},
-): CodingAgentDriver {
-	const command = options.command ?? 'codex';
-
-	return {
-		id: 'codex',
-		label: 'Codex CLI',
-		kind: 'local-cli',
-		requiresLoopback: true,
-		description:
-			'Local codex binary in exec mode with a workspace-write sandbox rooted at the session workspace.',
-
-		async probe(): Promise<CodingAgentAvailability> {
-			const result = await probeCommand(command, ['--version']);
-			return {
-				available: result.available,
-				detail: result.available
-					? `Uses the operator login of ${command}.`
-					: result.detail,
-				version: result.version,
-			};
-		},
-
-		async *run(
-			request: CodingAgentTurnRequest,
-		): AsyncIterable<CodingAgentEvent> {
-			const resumeId = request.resumeId ?? null;
-			if (!resumeId) {
-				yield* runThread(request, null);
-				return;
-			}
-			try {
-				yield* runThread(request, resumeId);
-			} catch (error) {
-				if (!isThreadLocked(error)) throw error;
-				yield {
-					type: 'error',
-					code: 'DRIVER_THREAD_LOCKED',
-					message:
-						'The previous codex thread was still open, so this turn continues on a new thread with the conversation replayed.',
-				};
-				yield* runThread(request, null);
-			}
-		},
-	};
-
-	async function* runThread(
-		request: CodingAgentTurnRequest,
-		resumeId: string | null,
-	): AsyncIterable<CodingAgentEvent> {
-		const model = request.model ?? options.defaultModel ?? null;
-		/* The resume subcommand takes a narrower option set than a fresh exec: it
-		   has no --cd or --sandbox, so the working directory comes from the child
-		   process and the sandbox policy from a config override. */
-		const args = resumeId
-			? [
-					'exec',
-					'resume',
-					resumeId,
-					'--json',
-					'--skip-git-repo-check',
-					'-c',
-					'sandbox_mode="workspace-write"',
-					...(model ? ['--model', model] : []),
-					composePrompt(request, resumeId === null),
-				]
-			: [
-					'exec',
-					'--json',
-					'--cd',
-					request.workspacePath,
-					'--sandbox',
-					'workspace-write',
-					'--skip-git-repo-check',
-					...(model ? ['--model', model] : []),
-					composePrompt(request, resumeId === null),
-				];
-
-		const stream = spawnLineStream({
-			command,
-			args,
-			cwd: request.workspacePath,
-			signal: request.signal,
-			timeoutMs: request.timeoutMs ?? options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
-		});
-
-		let currentResumeId = resumeId;
-		let started = false;
-		let completed = false;
-		for await (const line of stream.lines) {
-			const message = parseJsonLine(line);
-			if (!message) continue;
-			const type = message.type;
-
-			if (type === 'thread.started') {
-				currentResumeId =
-					typeof message.thread_id === 'string'
-						? message.thread_id
-						: currentResumeId;
-				continue;
-			}
-
-			if (type === 'turn.started') {
-				started = true;
-				yield {
-					type: 'turn.started',
-					driver: 'codex',
-					role: request.role,
-					resumeId: currentResumeId,
-				};
-				continue;
-			}
-
-			if (type === 'item.started' || type === 'item.completed') {
-				const item = (message.item ?? {}) as CodexItem;
-				const done = type === 'item.completed';
-				if (item.type === 'agent_message' && done && item.text?.trim()) {
-					yield { type: 'assistant.message', text: item.text };
-				}
-				if (item.type === 'reasoning' && done && item.text?.trim()) {
-					yield { type: 'reasoning', text: item.text };
-				}
-				if (item.type === 'command_execution') {
-					yield done
-						? {
-								type: 'tool.completed',
-								tool: 'command',
-								detail: (item.command ?? '').slice(0, 200),
-								ok: (item.exit_code ?? 0) === 0,
-							}
-						: {
-								type: 'tool.started',
-								tool: 'command',
-								detail: (item.command ?? '').slice(0, 200),
-							};
-				}
-				if (item.type === 'file_change' && done) {
-					for (const change of item.changes ?? []) {
-						if (!change.path) continue;
-						yield {
-							type: 'file.changed',
-							path: workspaceRelative(request.workspacePath, change.path),
-							change: changeKind(change.kind),
-						};
-					}
-				}
-				continue;
-			}
-
-			if (type === 'turn.completed' || type === 'turn.failed') {
-				completed = true;
-				if (type === 'turn.failed') {
-					const error = (message.error ?? {}) as { message?: string };
-					yield {
-						type: 'error',
-						code: 'DRIVER_TURN_FAILED',
-						message: (error.message ?? 'The codex turn failed.').slice(0, 500),
-					};
-				}
-				yield {
-					type: 'turn.completed',
-					resumeId: currentResumeId,
-					usage: usageOf(message.usage),
-					costUsd: null,
-					finishReason: type === 'turn.failed' ? 'error' : 'stop',
-				};
-			}
-		}
-
-		const exit = await stream.finished;
-		if (completed) return;
-		if (exit.aborted) {
-			yield {
-				type: 'turn.completed',
-				resumeId: currentResumeId,
-				usage: { inputTokens: 0, outputTokens: 0, totalTokens: 0 },
-				costUsd: null,
-				finishReason: 'aborted',
-			};
-			return;
-		}
-		throw new CodingAgentError(
-			started ? 'DRIVER_STREAM_INCOMPLETE' : 'DRIVER_START_FAILED',
-			exit.stderr.trim().slice(0, 300) ||
-				`The ${command} process exited with code ${exit.code} before completing the turn.`,
-		);
-	}
-}

package/packages/coding-agent/src/index.ts

@@ -1,56 +0,0 @@
-export {
-	CodingAgentError,
-	type CodingAgentAvailability,
-	type CodingAgentDriver,
-	type CodingAgentDriverInfo,
-	type CodingAgentDriverKind,
-	type CodingAgentEvent,
-	type CodingAgentMessage,
-	type CodingAgentTurnRequest,
-	type FileChangeKind,
-	type SandboxRuntimeMode,
-} from './types.ts';
-export {
-	createCodingAgentRegistry,
-	type CodingAgentRegistry,
-	type CodingAgentRegistryOptions,
-	type DriverStatus,
-} from './registry.ts';
-export { createClaudeCodeDriver } from './drivers/claude-code.ts';
-export type { ClaudeCodeDriverOptions } from './drivers/claude-code.ts';
-export { createCodexDriver } from './drivers/codex.ts';
-export type { CodexDriverOptions } from './drivers/codex.ts';
-export { createByokDriver } from './drivers/byok.ts';
-export type { ByokDriverOptions } from './drivers/byok.ts';
-export {
-	SANDBOX_AGENT_CONTRACT,
-	composeSessionFacts,
-	type InstructionContext,
-} from './roles/contract.ts';
-export { parseHandoff, type HandoffDeclaration } from './roles/handoff.ts';
-export { selectTaskSkill, type TaskSkillContext } from './roles/skills.ts';
-export { DEFAULT_AGENT_ROLES } from './roles/defaults.ts';
-export type { AgentRoleDefinition } from './roles/defaults.ts';
-export {
-	SANDBOX_ROLE_DIRECTORY,
-	composeInstruction,
-	findRole,
-	loadAgentRoles,
-	materializeAgentRoles,
-	parseRoleDocument,
-	renderRoleDocument,
-} from './roles/registry.ts';
-export {
-	loadRoleDocuments,
-	normalizeRoleDocument,
-	renderDefaultsModule,
-} from './roles/sync.ts';
-export {
-	parseJsonLine,
-	probeCommand,
-	resolveInsideWorkspace,
-	resolveReadableInsideWorkspace,
-	resolveWritableInsideWorkspace,
-	spawnLineStream,
-	workspaceRelative,
-} from './workspace.ts';