@opencoven/coven-code 0.0.1 → 0.0.3

package/src/sdk.mjs

@@ -1,16 +1,20 @@
 import { spawn } from 'node:child_process';
 import { randomUUID } from 'node:crypto';
-import { existsSync } from 'node:fs';
-import { appendFile, mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
-import os from 'node:os';
 import { createInterface } from 'node:readline';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
 import { normalizeThreadVisibility, readThread, writeThread } from './threads/store.mjs';
-import { parseJsonc } from './settings/load.mjs';
-
-const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-const covenCodeBin = path.join(repoRoot, 'bin', 'coven-code.mjs');
+import {
+  closeStdin,
+  executeArgs,
+  isAsyncIterable,
+  waitForExit,
+  writeStreamInput,
+} from './sdk-execute.mjs';
+import {
+  prepareRunSettings,
+  resolveCovenCodeCommand,
+  withEnv,
+  writeDebugLog,
+} from './sdk-settings.mjs';
 
 export const threads = {
   async new(options = {}) {
@@ -128,87 +132,11 @@ export function createPermission(tool, action, options = {}) {
   };
 }
 
-function executeArgs(prompt, options, isStreamInput) {
-  const args = ['--execute'];
-  if (!isStreamInput) args.push(String(prompt));
-  args.push(options.thinking ? '--stream-json-thinking' : '--stream-json');
-  if (isStreamInput) args.push('--stream-json-input');
-  if (options.dangerouslyAllowAll) args.push('--dangerously-allow-all');
-  if (options.archive) args.push('--archive');
-  if (options.mode) args.push('--mode', options.mode);
-  if (options.reasoningEffort) args.push('--reasoning-effort', options.reasoningEffort);
-  const visibility = normalizeSdkThreadVisibility(options.visibility) ?? (options.continue ? undefined : 'workspace');
-  if (visibility) args.push('--visibility', visibility);
-  if (options.settingsFile) args.push('--settings-file', options.settingsFile);
-  if (options.continue) args.push('--continue', ...(typeof options.continue === 'string' ? [options.continue] : []));
-  if (options.toolbox) args.push('--toolbox', options.toolbox);
-  if (options.skills) args.push('--skills', options.skills);
-  if (options.mcpConfig) args.push('--mcp-config', typeof options.mcpConfig === 'string' ? options.mcpConfig : JSON.stringify(options.mcpConfig));
-  for (const label of options.labels ?? []) args.push('--label', label);
-  return args;
-}
-
 function normalizeSdkThreadVisibility(visibility) {
   if (visibility === 'team') return 'workspace';
   return normalizeThreadVisibility(visibility);
 }
 
-async function writeStreamInput(child, prompt, signal) {
-  const iterator = prompt[Symbol.asyncIterator]();
-  try {
-    while (true) {
-      const { value: message, done } = await nextWithAbort(iterator, signal);
-      if (done) break;
-      if (child.stdin.destroyed) break;
-      child.stdin.write(`${JSON.stringify(message)}\n`);
-    }
-    child.stdin.end();
-  } catch (error) {
-    if (!isAbortError(error)) throw error;
-    child.stdin.destroy();
-    try {
-      iterator.return?.().catch?.(() => {});
-    } catch {
-      // Best-effort generator cleanup; abort should not wait on a slow prompt source.
-    }
-  }
-}
-
-function nextWithAbort(iterator, signal) {
-  if (!signal) return iterator.next();
-  if (signal.aborted) return Promise.reject(abortReason(signal));
-  return new Promise((resolve, reject) => {
-    const onAbort = () => reject(abortReason(signal));
-    signal.addEventListener('abort', onAbort, { once: true });
-    iterator.next().then(resolve, reject).finally(() => {
-      signal.removeEventListener('abort', onAbort);
-    });
-  });
-}
-
-function abortReason(signal) {
-  return signal.reason instanceof Error ? signal.reason : new Error('aborted');
-}
-
-function isAbortError(error) {
-  return error?.name === 'AbortError' || error?.code === 'ABORT_ERR' || /abort/i.test(error?.message ?? '');
-}
-
-async function closeStdin(child) {
-  child.stdin.end();
-}
-
-function waitForExit(child) {
-  return new Promise((resolve, reject) => {
-    child.on('error', reject);
-    child.on('close', (code) => resolve(code ?? 0));
-  });
-}
-
-function isAsyncIterable(value) {
-  return value && typeof value[Symbol.asyncIterator] === 'function';
-}
-
 function requireSdkThread(threadId) {
   const thread = readThread(threadId);
   if (!thread) throw new Error(`Unknown thread: ${threadId}`);
@@ -233,82 +161,3 @@ function threadMarkdown(thread) {
 function titleCaseRole(role = '') {
   return role ? `${role.slice(0, 1).toUpperCase()}${role.slice(1)}` : 'Message';
 }
-
-async function withEnv(env = {}, fn) {
-  const previous = new Map();
-  for (const [key, value] of Object.entries(env ?? {})) {
-    previous.set(key, Object.hasOwn(process.env, key) ? process.env[key] : undefined);
-    process.env[key] = value;
-  }
-  try {
-    return await fn();
-  } finally {
-    for (const [key, value] of previous) {
-      if (value === undefined) delete process.env[key];
-      else process.env[key] = value;
-    }
-  }
-}
-
-async function prepareRunSettings(options = {}) {
-  if (!shouldWriteRunSettings(options)) return { settingsFile: options.settingsFile, cleanup: async () => {} };
-  const dir = await mkdtemp(path.join(os.tmpdir(), 'coven-code-sdk-settings-'));
-  const settingsFile = path.join(dir, 'settings.json');
-  const baseSettings = options.settingsFile ? await readJsonSettings(sdkOptionsPath(options.settingsFile, options.cwd)) : {};
-  const settings = { ...baseSettings };
-  if (Array.isArray(options.permissions)) settings['covenCode.permissions'] = options.permissions;
-  if (Array.isArray(options.enabledTools)) settings['covenCode.tools.enable'] = options.enabledTools;
-  if (typeof options.systemPrompt === 'string') settings['covenCode.systemPrompt'] = options.systemPrompt;
-  if (typeof options.skills === 'string') settings['covenCode.skills.path'] = options.skills;
-  await writeFile(settingsFile, `${JSON.stringify(settings, null, 2)}\n`, 'utf8');
-  return {
-    settingsFile,
-    cleanup: async () => {
-      await rm(dir, { recursive: true, force: true });
-    },
-  };
-}
-
-function shouldWriteRunSettings(options = {}) {
-  return Array.isArray(options.permissions)
-    || Array.isArray(options.enabledTools)
-    || typeof options.systemPrompt === 'string'
-    || typeof options.skills === 'string';
-}
-
-async function readJsonSettings(filePath) {
-  try {
-    return parseJsonc(await readFile(filePath, 'utf8'));
-  } catch {
-    return {};
-  }
-}
-
-async function writeDebugLog(options = {}, covenCodeCommand = resolveCovenCodeCommand(), args = []) {
-  if (options.logLevel !== 'debug') return;
-  const line = `level=debug cwd=${options.cwd ?? process.cwd()} argv=${[covenCodeCommand.command, ...covenCodeCommand.args, ...args].map(JSON.stringify).join(' ')}\n`;
-  process.stderr.write(line);
-  if (!options.logFile) return;
-  const logFile = sdkOptionsPath(options.logFile, options.cwd);
-  await mkdir(path.dirname(logFile), { recursive: true });
-  await appendFile(logFile, line, 'utf8');
-}
-
-function sdkOptionsPath(filePath, cwd = process.cwd()) {
-  if (!filePath || path.isAbsolute(filePath)) return filePath;
-  return path.resolve(cwd, filePath);
-}
-
-function resolveCovenCodeCommand() {
-  const cliPath = process.env.COVEN_CODE_CLI_PATH;
-  if (cliPath && existsSync(cliPath)) {
-    return isNodeScriptPath(cliPath)
-      ? { command: process.execPath, args: [cliPath] }
-      : { command: cliPath, args: [] };
-  }
-  return { command: process.execPath, args: [covenCodeBin] };
-}
-
-function isNodeScriptPath(filePath) {
-  return filePath.endsWith('.js') || filePath.endsWith('.mjs') || filePath.endsWith('.cjs');
-}

package/src/tools/builtin/oracle.mjs

@@ -1,4 +1,4 @@
-import { localAgentResponse } from '../../agent/local.mjs';
+import { fixtureAgentResponse } from '../../agent/fixture.mjs';
 import { resolvePermissionDecision } from '../../commands/permissions.mjs';
 import { runPluginEventHandlers } from '../../plugins/discover.mjs';
 import { isToolDisabled } from '../toolbox.mjs';
@@ -36,7 +36,7 @@ export async function executePromptOracleToolRequest(request, parsed = {}, plugi
       permissionDenials: [{ tool: TOOL_NAME, action: decision.action, reason: 'permission' }],
     };
   }
-  const output = `Oracle: ${localAgentResponse(request.flags.prompt, '')}`;
+  const output = `Oracle: ${fixtureAgentResponse(request.flags.prompt, '')}`;
   const resultDecision = await runPluginEventHandlers(
     plugins.handlers['tool.result'],
     pluginToolResultEvent(TOOL_NAME, request.flags, 'done', output, threadId, toolUseID),

package/src/tools/builtin/runtime-content.mjs

@@ -0,0 +1,31 @@
+export function isPluginContentBlock(block) {
+  if (!block || typeof block !== 'object') return false;
+  if (block.type === 'text') return typeof block.text === 'string';
+  if (block.type === 'image') return typeof block.mimeType === 'string' && typeof block.data === 'string';
+  return false;
+}
+
+export function pluginContentBlockText(block) {
+  if (block.type === 'text') return block.text;
+  return '';
+}
+
+export function normalizePluginToolOutput(output) {
+  if (Array.isArray(output) && output.every(isPluginContentBlock)) {
+    const text = output.map(pluginContentBlockText).filter(Boolean).join('\n').trimEnd();
+    return { raw: output, text };
+  }
+  const text = String(output ?? '').trimEnd();
+  return { raw: text, text };
+}
+
+export function normalizePluginToolExecuteOutput(output) {
+  if (output === undefined || typeof output === 'string') return normalizePluginToolOutput(output);
+  if (Array.isArray(output)) {
+    if (!output.every(isPluginContentBlock)) {
+      throw new Error('plugin tool result content blocks must be text or image blocks');
+    }
+    return normalizePluginToolOutput(output);
+  }
+  throw new Error('plugin tool result must be a string, content blocks, or undefined');
+}

package/src/tools/builtin/runtime-decisions.mjs

@@ -0,0 +1,115 @@
+export function validateToolCallDecision(callDecision) {
+  if (!callDecision || typeof callDecision !== 'object') {
+    throw new Error('plugin tool.call result must be an object');
+  }
+  if (
+    callDecision.action !== 'allow' &&
+    callDecision.action !== 'reject-and-continue' &&
+    callDecision.action !== 'modify' &&
+    callDecision.action !== 'synthesize' &&
+    callDecision.action !== 'error'
+  ) {
+    throw new Error('plugin tool.call action must be allow, reject-and-continue, modify, synthesize, or error');
+  }
+  const allowedKeys = {
+    allow: ['action'],
+    'reject-and-continue': ['action', 'message'],
+    modify: ['action', 'input'],
+    synthesize: ['action', 'result'],
+    error: ['action', 'message'],
+  }[callDecision.action];
+  if (Object.keys(callDecision).some((key) => !allowedKeys.includes(key))) {
+    throw new Error('plugin tool.call fields must match the documented union');
+  }
+}
+
+export function applyToolCallDecision(toolName, request, callDecision = { action: 'allow' }) {
+  validateToolCallDecision(callDecision);
+  if (callDecision.action === 'allow') return { request };
+  if (callDecision.action === 'reject-and-continue') {
+    if (typeof callDecision.message !== 'string') {
+      throw new Error('plugin tool.call reject-and-continue message must be a string');
+    }
+    return {
+      output: {
+        output: callDecision.message,
+        exitCode: 0,
+      },
+    };
+  }
+  if (callDecision.action === 'synthesize') {
+    const result = callDecision.result && isPlainObject(callDecision.result)
+      ? callDecision.result
+      : callDecision;
+    if (typeof result.output !== 'string') {
+      throw new Error('plugin tool.call synthesize result.output must be a string');
+    }
+    if (result.exitCode !== undefined && !Number.isInteger(result.exitCode)) {
+      throw new Error('plugin tool.call synthesize result.exitCode must be an integer');
+    }
+    return {
+      output: {
+        output: result.output.trimEnd(),
+        exitCode: result.exitCode ?? 0,
+      },
+    };
+  }
+  if (callDecision.action === 'error') {
+    if (typeof callDecision.message !== 'string') {
+      throw new Error('plugin tool.call error message must be a string');
+    }
+    return {
+      output: {
+        output: callDecision.message,
+        exitCode: 1,
+      },
+    };
+  }
+  if (callDecision.action === 'modify') {
+    if (!isPlainObject(callDecision.input)) {
+      throw new Error('plugin tool.call modify input must be an object');
+    }
+    return { request: { ...request, flags: callDecision.input } };
+  }
+  return { request };
+}
+
+export function validateToolResultDecision(resultDecision = {}) {
+  if (!resultDecision || typeof resultDecision !== 'object' || !Object.hasOwn(resultDecision, 'status')) return;
+  if (resultDecision.status !== 'done' && resultDecision.status !== 'error' && resultDecision.status !== 'cancelled') {
+    throw new Error('plugin tool.result status must be done, error, or cancelled');
+  }
+  const allowedKeys = resultDecision.status === 'done' ? ['output', 'status'] : ['error', 'output', 'status'];
+  if (Object.keys(resultDecision).some((key) => !allowedKeys.includes(key))) {
+    throw new Error('plugin tool.result fields must match the documented union');
+  }
+  if (
+    (resultDecision.status === 'error' || resultDecision.status === 'cancelled') &&
+    resultDecision.error !== undefined &&
+    typeof resultDecision.error !== 'string'
+  ) {
+    throw new Error('plugin tool.result error must be a string');
+  }
+}
+
+export function pluginToolResultDecisionOutput(resultDecision = {}, fallback) {
+  validateToolResultDecision(resultDecision);
+  if (resultDecision.status === 'error') {
+    return resultDecision.error ?? resultDecision.output ?? fallback;
+  }
+  if (resultDecision.status === 'cancelled') {
+    return resultDecision.error ?? resultDecision.output ?? 'Tool cancelled';
+  }
+  return resultDecision.output !== undefined ? resultDecision.output : fallback;
+}
+
+export function pluginToolResultDecisionExitCode(resultDecision = {}, fallback = 0) {
+  validateToolResultDecision(resultDecision);
+  if (resultDecision.status === 'error' || resultDecision.status === 'cancelled') return 1;
+  if (resultDecision.status === 'done') return 0;
+  return fallback;
+}
+
+function isPlainObject(value) {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}

package/src/tools/builtin/runtime.mjs

@@ -1,5 +1,23 @@
 import { randomUUID } from 'node:crypto';
 import path from 'node:path';
+import {
+  pluginToolResultDecisionExitCode,
+  pluginToolResultDecisionOutput,
+} from './runtime-decisions.mjs';
+
+export {
+  applyToolCallDecision,
+  pluginToolResultDecisionExitCode,
+  pluginToolResultDecisionOutput,
+  validateToolCallDecision,
+  validateToolResultDecision,
+} from './runtime-decisions.mjs';
+export {
+  isPluginContentBlock,
+  normalizePluginToolExecuteOutput,
+  normalizePluginToolOutput,
+  pluginContentBlockText,
+} from './runtime-content.mjs';
 
 export function createToolUseID() {
   return `toolu_${randomUUID()}`;
@@ -40,158 +58,10 @@ export function pluginToolUseBlock(tool, input, toolUseID) {
   };
 }
 
-export function pluginToolResultDecisionOutput(resultDecision = {}, fallback) {
-  validateToolResultDecision(resultDecision);
-  if (resultDecision.status === 'error') {
-    return resultDecision.error ?? resultDecision.output ?? fallback;
-  }
-  if (resultDecision.status === 'cancelled') {
-    return resultDecision.error ?? resultDecision.output ?? 'Tool cancelled';
-  }
-  return resultDecision.output !== undefined ? resultDecision.output : fallback;
-}
-
-export function pluginToolResultDecisionExitCode(resultDecision = {}, fallback = 0) {
-  validateToolResultDecision(resultDecision);
-  if (resultDecision.status === 'error' || resultDecision.status === 'cancelled') return 1;
-  if (resultDecision.status === 'done') return 0;
-  return fallback;
-}
-
-export function validateToolResultDecision(resultDecision = {}) {
-  if (!resultDecision || typeof resultDecision !== 'object' || !Object.hasOwn(resultDecision, 'status')) return;
-  if (resultDecision.status !== 'done' && resultDecision.status !== 'error' && resultDecision.status !== 'cancelled') {
-    throw new Error('plugin tool.result status must be done, error, or cancelled');
-  }
-  const allowedKeys = resultDecision.status === 'done' ? ['output', 'status'] : ['error', 'output', 'status'];
-  if (Object.keys(resultDecision).some((key) => !allowedKeys.includes(key))) {
-    throw new Error('plugin tool.result fields must match the documented union');
-  }
-  if (
-    (resultDecision.status === 'error' || resultDecision.status === 'cancelled') &&
-    resultDecision.error !== undefined &&
-    typeof resultDecision.error !== 'string'
-  ) {
-    throw new Error('plugin tool.result error must be a string');
-  }
-}
-
 export function toolResultContent(toolRun = {}) {
   return Object.hasOwn(toolRun, 'toolResultOutput') ? toolRun.toolResultOutput : toolRun.output;
 }
 
-export function normalizePluginToolOutput(output) {
-  if (Array.isArray(output) && output.every(isPluginContentBlock)) {
-    const text = output.map(pluginContentBlockText).filter(Boolean).join('\n').trimEnd();
-    return { raw: output, text };
-  }
-  const text = String(output ?? '').trimEnd();
-  return { raw: text, text };
-}
-
-export function normalizePluginToolExecuteOutput(output) {
-  if (output === undefined || typeof output === 'string') return normalizePluginToolOutput(output);
-  if (Array.isArray(output)) {
-    if (!output.every(isPluginContentBlock)) {
-      throw new Error('plugin tool result content blocks must be text or image blocks');
-    }
-    return normalizePluginToolOutput(output);
-  }
-  throw new Error('plugin tool result must be a string, content blocks, or undefined');
-}
-
-export function isPluginContentBlock(block) {
-  if (!block || typeof block !== 'object') return false;
-  if (block.type === 'text') return typeof block.text === 'string';
-  if (block.type === 'image') return typeof block.mimeType === 'string' && typeof block.data === 'string';
-  return false;
-}
-
-export function pluginContentBlockText(block) {
-  if (block.type === 'text') return block.text;
-  return '';
-}
-
-export function applyToolCallDecision(toolName, request, callDecision = { action: 'allow' }) {
-  validateToolCallDecision(callDecision);
-  if (callDecision.action === 'allow') return { request };
-  if (callDecision.action === 'reject-and-continue') {
-    if (typeof callDecision.message !== 'string') {
-      throw new Error('plugin tool.call reject-and-continue message must be a string');
-    }
-    return {
-      output: {
-        output: callDecision.message,
-        exitCode: 0,
-      },
-    };
-  }
-  if (callDecision.action === 'synthesize') {
-    const result = callDecision.result && isPlainObject(callDecision.result)
-      ? callDecision.result
-      : callDecision;
-    if (typeof result.output !== 'string') {
-      throw new Error('plugin tool.call synthesize result.output must be a string');
-    }
-    if (result.exitCode !== undefined && !Number.isInteger(result.exitCode)) {
-      throw new Error('plugin tool.call synthesize result.exitCode must be an integer');
-    }
-    return {
-      output: {
-        output: result.output.trimEnd(),
-        exitCode: result.exitCode ?? 0,
-      },
-    };
-  }
-  if (callDecision.action === 'error') {
-    if (typeof callDecision.message !== 'string') {
-      throw new Error('plugin tool.call error message must be a string');
-    }
-    return {
-      output: {
-        output: callDecision.message,
-        exitCode: 1,
-      },
-    };
-  }
-  if (callDecision.action === 'modify') {
-    if (!isPlainObject(callDecision.input)) {
-      throw new Error('plugin tool.call modify input must be an object');
-    }
-    return { request: { ...request, flags: callDecision.input } };
-  }
-  return { request };
-}
-
-export function validateToolCallDecision(callDecision) {
-  if (!callDecision || typeof callDecision !== 'object') {
-    throw new Error('plugin tool.call result must be an object');
-  }
-  if (
-    callDecision.action !== 'allow' &&
-    callDecision.action !== 'reject-and-continue' &&
-    callDecision.action !== 'modify' &&
-    callDecision.action !== 'synthesize' &&
-    callDecision.action !== 'error'
-  ) {
-    throw new Error('plugin tool.call action must be allow, reject-and-continue, modify, synthesize, or error');
-  }
-  const allowedKeys = {
-    allow: ['action'],
-    'reject-and-continue': ['action', 'message'],
-    modify: ['action', 'input'],
-    synthesize: ['action', 'result'],
-    error: ['action', 'message'],
-  }[callDecision.action];
-  if (Object.keys(callDecision).some((key) => !allowedKeys.includes(key))) {
-    throw new Error('plugin tool.call fields must match the documented union');
-  }
-}
-
-export function isPlainObject(value) {
-  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
-}
-
 export function toolCallDecisionToolRun(toolName, input, toolUseID, callResult) {
   return {
     ...callResult.output,

package/src/tools/builtin/task.mjs

@@ -1,4 +1,4 @@
-import { localAgentResponse } from '../../agent/local.mjs';
+import { fixtureAgentResponse } from '../../agent/fixture.mjs';
 import { resolvePermissionDecision } from '../../commands/permissions.mjs';
 import { runPluginEventHandlers } from '../../plugins/discover.mjs';
 import { isToolDisabled } from '../toolbox.mjs';
@@ -36,7 +36,7 @@ export async function executePromptTaskToolRequest(request, parsed = {}, plugins
       permissionDenials: [{ tool: TOOL_NAME, action: decision.action, reason: 'permission' }],
     };
   }
-  const output = localAgentResponse(request.flags.prompt, '');
+  const output = fixtureAgentResponse(request.flags.prompt, '');
   const resultDecision = await runPluginEventHandlers(
     plugins.handlers['tool.result'],
     pluginToolResultEvent(TOOL_NAME, request.flags, 'done', output, threadId, toolUseID),