@smartmemory/compose 0.1.0 → 0.1.2-beta

package/dist/assets/stateDiagram-v2-QKLJ7IA2-o6PnCs4e.js

@@ -1 +0,0 @@
-import{s as t,b as r,a,S as s}from"./chunk-OYMX7WX6-uGBaPaTX.js";import{_ as i}from"./index-DReRlzZI.js";import"./chunk-55IACEB6-CE1EXenG.js";import"./chunk-EDXVE4YY-DA7Ana6H.js";var l={parser:a,get db(){return new s(2)},renderer:r,styles:t,init:i(e=>{e.state||(e.state={}),e.state.arrowMarkerAbsolute=e.arrowMarkerAbsolute},"init")};export{l as diagram};

package/server/connectors/agent-connector.js

@@ -1,78 +0,0 @@
-/**
- * AgentConnector — base class for all agent connectors.
- *
- * @implements {ConnectorDiscovery} — see connector-discovery.js
- * @implements {ConnectorRuntime}  — see connector-runtime.js
- *
- * Subclasses implement run(), interrupt(), and isRunning.
- * Duck typing — no enforcement at runtime beyond the throw in run().
- *
- * Message envelope (yielded by run()):
- *   { type: 'system',    subtype: 'init' | 'complete', agent: string, model?: string }
- *   { type: 'assistant', content: string }
- *   { type: 'tool_use',          tool: string, input: object }
- *   { type: 'tool_use_summary',  summary: string, output?: string }
- *   { type: 'error',             message: string }
- *
- * Schema mode: if opts.schema is provided, the connector injects it into the
- * prompt as instructions and yields text output. JSON.parse() happens at the
- * MCP layer (agent-mcp.js), never inside connectors.
- */
-
-export class AgentConnector {
-  // ── Discovery ──────────────────────────────────────────────────────────────
-
-  /** @returns {string[]} */
-  listModels() { return []; }
-
-  /** @param {string} _modelId @returns {boolean} */
-  supportsModel(_modelId) { return false; }
-
-  /** @param {string} _sessionId @returns {Promise<object[]>} */
-  async loadHistory(_sessionId) { return []; }
-
-  // ── Runtime ────────────────────────────────────────────────────────────────
-
-  /**
-   * Run a prompt against the agent.
-   *
-   * @param {string} prompt
-   * @param {object} [opts]
-   * @param {object}   [opts.schema]     — JSON Schema → structured output mode
-   * @param {string}   [opts.modelID]    — override model for this run
-   * @param {string}   [opts.providerID] — provider ID (OpenCode subclasses only)
-   * @param {string}   [opts.cwd]        — working directory
-   * @param {string[]} [opts.tools]      — restrict available tools
-   * @returns {AsyncGenerator}
-   */
-  // eslint-disable-next-line require-yield
-  async *run(_prompt, _opts = {}) {
-    throw new Error(`${this.constructor.name}.run() not implemented`);
-  }
-
-  /** Stop the active run cleanly. No-op if not running. */
-  interrupt() {}
-
-  /** Whether a run is currently active. */
-  get isRunning() { return false; }
-}
-
-/**
- * Inject a JSON schema into a prompt so the agent knows to return structured JSON.
- * Used by both ClaudeSDKConnector and OpencodeConnector — parsing happens at call site.
- *
- * @param {string} prompt
- * @param {object} schema  JSON Schema object
- * @returns {string}
- */
-export function injectSchema(prompt, schema) {
-  return (
-    `${prompt}\n\n` +
-    `IMPORTANT: After completing the task, include a JSON code block at the very end ` +
-    `of your response matching this schema:\n` +
-    '```json\n' +
-    `${JSON.stringify(schema, null, 2)}\n` +
-    '```\n' +
-    `The JSON block must be the last thing in your response.`
-  );
-}

package/server/connectors/claude-sdk-connector.js

@@ -1,198 +0,0 @@
-/**
- * ClaudeSDKConnector — wraps @anthropic-ai/claude-agent-sdk query().
- *
- * All Anthropic model execution goes through this connector.
- * Yields the same typed message envelope as the other connectors.
- */
-
-import { query } from '@anthropic-ai/claude-agent-sdk';
-import { AgentConnector, injectSchema } from './agent-connector.js';
-
-const DEFAULT_MODEL = process.env.CLAUDE_MODEL || 'claude-sonnet-4-6';
-
-export class ClaudeSDKConnector extends AgentConnector {
-  // ── Discovery ──────────────────────────────────────────────────────────────
-  // No overrides — inherits stubs from AgentConnector. See agent-connector.js.
-
-  #model;
-  #cwd;
-  #query = null;
-
-  #allowedTools;
-  #disallowedTools;
-  #thinking;
-  #effort;
-
-  /**
-   * @param {object} [opts]
-   * @param {string}   [opts.model]            — default model (env CLAUDE_MODEL or claude-sonnet-4-6)
-   * @param {string}   [opts.cwd]              — default working directory
-   * @param {string[]} [opts.allowedTools]     — restrict to these tools (overrides preset)
-   * @param {string[]} [opts.disallowedTools]  — deny these tools (used alongside allowedTools or preset)
-   * @param {object|null} [opts.thinking]      — Claude thinking config, e.g. { type: 'adaptive' } or { type: 'disabled' }
-   * @param {string|null} [opts.effort]        — effort level: 'low' | 'medium' | 'high' | 'xhigh' | 'max'
-   */
-  constructor({ model = DEFAULT_MODEL, cwd = process.cwd(), allowedTools, disallowedTools, thinking, effort } = {}) {
-    super();
-    this.#model = model;
-    this.#cwd = cwd;
-    this.#allowedTools = allowedTools ?? null;
-    this.#disallowedTools = disallowedTools ?? null;
-    this.#thinking = thinking ?? null;
-    this.#effort = effort ?? null;
-  }
-
-  // ── Runtime ────────────────────────────────────────────────────────────────
-
-  async *run(prompt, { schema, modelID, cwd, thinking, effort } = {}) {
-    if (this.#query) {
-      throw new Error('ClaudeSDKConnector: run() already active. Call interrupt() first.');
-    }
-
-    const actualPrompt = schema ? injectSchema(prompt, schema) : prompt;
-
-    // Strip CLAUDECODE env var to allow spawning inside a Claude Code session
-    const cleanEnv = { ...process.env };
-    delete cleanEnv.CLAUDECODE;
-
-    // Build tools config: prefer explicit allow/deny lists if provided,
-    // otherwise fall back to the default claude_code preset (backward compat).
-    let toolsConfig;
-    if (this.#allowedTools !== null) {
-      toolsConfig = { type: 'allowed', allowedTools: this.#allowedTools };
-      if (this.#disallowedTools !== null) {
-        toolsConfig.disallowedTools = this.#disallowedTools;
-      }
-    } else if (this.#disallowedTools !== null) {
-      toolsConfig = { type: 'preset', preset: 'claude_code', disallowedTools: this.#disallowedTools };
-    } else {
-      toolsConfig = { type: 'preset', preset: 'claude_code' };
-    }
-
-    // Resolve thinking/effort: per-run override beats constructor default.
-    const resolvedThinking = thinking !== undefined ? thinking : this.#thinking;
-    const resolvedEffort   = effort   !== undefined ? effort   : this.#effort;
-
-    const sdkOptions = {
-      cwd: cwd ?? this.#cwd,
-      model: modelID ?? this.#model,
-      permissionMode: 'acceptEdits',
-      tools: toolsConfig,
-      env: cleanEnv,
-    };
-    if (resolvedThinking !== null && resolvedThinking !== undefined) {
-      sdkOptions.thinking = resolvedThinking;
-    }
-    if (resolvedEffort !== null && resolvedEffort !== undefined) {
-      sdkOptions.effort = resolvedEffort;
-    }
-
-    const q = query({
-      prompt: actualPrompt,
-      options: sdkOptions,
-    });
-    this.#query = q;
-
-    yield { type: 'system', subtype: 'init', agent: 'claude', model: modelID ?? this.#model };
-
-    const activeModel = modelID ?? this.#model;
-    try {
-      for await (const msg of q) {
-        if (process.env.COMPOSE_DEBUG) {
-          process.stderr.write(`  [sdk] ${msg?.type ?? typeof msg}\n`);
-        }
-        for (const event of _normalizeAll(msg)) {
-          // Inject model into usage events extracted from result messages
-          if (event.type === 'usage' && event._from_result) {
-            const { _from_result: _, ...usageEvent } = event;
-            yield { ...usageEvent, model: activeModel };
-          } else {
-            yield event;
-          }
-        }
-      }
-      yield { type: 'system', subtype: 'complete', agent: 'claude' };
-    } catch (err) {
-      if (err?.name !== 'AbortError') {
-        yield { type: 'error', message: err.message || String(err) };
-      }
-    } finally {
-      this.#query = null;
-    }
-  }
-
-  interrupt() {
-    if (this.#query) {
-      try { this.#query.interrupt(); } catch { /* already done */ }
-      this.#query = null;
-    }
-  }
-
-  get isRunning() {
-    return this.#query !== null;
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Normalize Claude SDK message → shared envelope
-// ---------------------------------------------------------------------------
-
-/**
- * Normalize an SDK message into one or more envelope events.
- * Returns an array because a single assistant message can contain
- * multiple content blocks (text + tool_use).
- */
-function _normalizeAll(msg) {
-  if (!msg || typeof msg !== 'object') {
-    return [{ type: 'assistant', content: String(msg) }];
-  }
-  if (msg.type === 'system' || msg.type === 'error') return [msg];
-
-  // SDK assistant message — extract content blocks from msg.message
-  if (msg.type === 'assistant' && msg.message?.content) {
-    const events = [];
-    for (const block of msg.message.content) {
-      if (block.type === 'text' && block.text) {
-        events.push({ type: 'assistant', content: block.text });
-      } else if (block.type === 'tool_use') {
-        events.push({ type: 'tool_use', tool: block.name, input: block.input ?? {} });
-      }
-    }
-    return events.length > 0 ? events : [msg];
-  }
-
-  // SDK result message — contains the final aggregated text and usage metadata
-  if (msg.type === 'result' && msg.result) {
-    const events = [{ type: 'result', content: msg.result }];
-    // Extract usage from msg.usage or msg.message.usage
-    const usage = msg.usage ?? msg.message?.usage;
-    if (usage) {
-      events.push({
-        type: 'usage',
-        input_tokens: usage.input_tokens ?? 0,
-        output_tokens: usage.output_tokens ?? 0,
-        cache_creation_input_tokens: usage.cache_creation_input_tokens ?? 0,
-        cache_read_input_tokens: usage.cache_read_input_tokens ?? 0,
-        // model is injected by the run() loop via _modelForUsage tag on the event
-        _from_result: true,
-      });
-    }
-    return events;
-  }
-
-  if (msg.type === 'tool_use') {
-    return [{ type: 'tool_use', tool: msg.name ?? msg.tool, input: msg.input ?? {} }];
-  }
-  if (msg.type === 'tool_use_summary') {
-    const output = (msg.result ?? msg.output ?? '');
-    return [{ type: 'tool_use_summary', summary: msg.summary, output: output ? output.slice(0, 2048) : undefined }];
-  }
-  if (msg.type === 'tool_progress') {
-    return [{ type: 'tool_progress', tool: msg.tool_name, elapsed: msg.elapsed_time_seconds }];
-  }
-  // Delta or text content
-  if (msg.delta?.text) return [{ type: 'assistant', content: msg.delta.text }];
-  if (msg.content && typeof msg.content === 'string') return [{ type: 'assistant', content: msg.content }];
-  // Pass through unknown message types as-is
-  return [msg];
-}

package/server/connectors/codex-connector.js

@@ -1,240 +0,0 @@
-/**
- * CodexConnector — spawns the official `codex exec --json` CLI for each prompt.
- *
- * Replaces the previous opencode-backed implementation. Uses the OpenAI Codex
- * CLI (`codex`, installed via `npm i -g @openai/codex` or `brew install codex`)
- * which streams structured JSONL events to stdout.
- *
- * Auth: run `codex login` once (ChatGPT OAuth), or set OPENAI_API_KEY.
- *
- * Model IDs use the form `<model>` or `<model>/<effort>` where effort is one
- * of `minimal|low|medium|high|xhigh`. The effort suffix is split off and
- * passed as `-c model_reasoning_effort=<effort>`.
- */
-
-import { spawn } from 'node:child_process';
-import { createInterface } from 'node:readline';
-import { AgentConnector, injectSchema } from './agent-connector.js';
-
-// ---------------------------------------------------------------------------
-// Supported Codex model IDs (model + optional /effort suffix)
-// ---------------------------------------------------------------------------
-
-export const CODEX_MODEL_IDS = new Set([
-  'gpt-5.4',
-  'gpt-5.4/low',
-  'gpt-5.4/medium',
-  'gpt-5.4/high',
-  'gpt-5.4/xhigh',
-  'gpt-5.2-codex',
-  'gpt-5.2-codex/low',
-  'gpt-5.2-codex/medium',
-  'gpt-5.2-codex/high',
-  'gpt-5.2-codex/xhigh',
-  'gpt-5.1-codex-max',
-  'gpt-5.1-codex-max/low',
-  'gpt-5.1-codex-max/medium',
-  'gpt-5.1-codex-max/high',
-  'gpt-5.1-codex-max/xhigh',
-  'gpt-5.1-codex',
-  'gpt-5.1-codex/low',
-  'gpt-5.1-codex/medium',
-  'gpt-5.1-codex/high',
-  'gpt-5.1-codex-mini',
-  'gpt-5.1-codex-mini/medium',
-  'gpt-5.1-codex-mini/high',
-]);
-
-const DEFAULT_MODEL_ID = process.env.CODEX_MODEL || 'gpt-5.4';
-const AGENT_NAME = 'codex';
-
-// ---------------------------------------------------------------------------
-// CodexConnector
-// ---------------------------------------------------------------------------
-
-export class CodexConnector extends AgentConnector {
-  _defaultModelID;
-  _cwd;
-  #proc = null;
-
-  /**
-   * @param {object} [opts]
-   * @param {string} [opts.modelID] — Codex model ID; must be in CODEX_MODEL_IDS
-   * @param {string} [opts.cwd]     — default working directory
-   * @throws {Error} if modelID is not a recognized Codex model
-   */
-  constructor({ modelID = DEFAULT_MODEL_ID, cwd = process.cwd() } = {}) {
-    super();
-    _assertCodexModel(modelID);
-    this._defaultModelID = modelID;
-    this._cwd = cwd;
-  }
-
-  // ── Runtime ────────────────────────────────────────────────────────────────
-
-  async *run(prompt, { schema, modelID, cwd } = {}) {
-    if (this.#proc) {
-      throw new Error(`${AGENT_NAME}: run() already active. Call interrupt() first.`);
-    }
-
-    const resolvedModelID = modelID ?? this._defaultModelID;
-    _assertCodexModel(resolvedModelID);
-    const resolvedCwd = cwd ?? this._cwd;
-    const actualPrompt = schema ? injectSchema(prompt, schema) : prompt;
-
-    const [baseModel, effort] = resolvedModelID.split('/');
-
-    yield {
-      type: 'system', subtype: 'init',
-      agent: AGENT_NAME, model: resolvedModelID,
-    };
-
-    const args = [
-      'exec',
-      '--json',
-      '--skip-git-repo-check',
-      '--sandbox', 'read-only',
-      '-m', baseModel,
-      '-C', resolvedCwd,
-    ];
-    if (effort) {
-      args.push('-c', `model_reasoning_effort="${effort}"`);
-    }
-    args.push('-'); // read prompt from stdin
-
-    const proc = spawn('codex', args, {
-      cwd: resolvedCwd,
-      stdio: ['pipe', 'pipe', 'pipe'],
-      env: process.env,
-    });
-    this.#proc = proc;
-
-    // Write prompt via stdin to avoid argv length and quoting issues
-    proc.stdin.end(actualPrompt);
-
-    const rl = createInterface({ input: proc.stdout, crlfDelay: Infinity });
-    const textParts = [];
-    const stderrChunks = [];
-
-    // Stream stderr — surface auth/rate-limit errors immediately
-    proc.stderr.on('data', chunk => {
-      stderrChunks.push(chunk);
-      const text = chunk.toString();
-      const lower = text.toLowerCase();
-      if (lower.includes('rate limit') || lower.includes('rate_limit') ||
-          lower.includes('quota') || lower.includes('insufficient_quota') ||
-          lower.includes('unauthorized') || lower.includes('401') ||
-          lower.includes('403') || lower.includes('authentication') ||
-          lower.includes('not logged in') || lower.includes('login required') ||
-          lower.includes('billing') || lower.includes('exceeded')) {
-        process.stderr.write(`\n⚠ ${AGENT_NAME}: ${text.trim()}\n`);
-        process.stderr.write(`  → Check login: codex login status\n`);
-        process.stderr.write(`  → Re-auth:    codex login\n\n`);
-      }
-    });
-
-    // Stall detection — warn if no stdout events for 120s
-    let lastEventAt = Date.now();
-    const stallTimer = setInterval(() => {
-      const silent = Math.round((Date.now() - lastEventAt) / 1000);
-      if (silent >= 120) {
-        process.stderr.write(`\n⚠ ${AGENT_NAME}: no response for ${silent}s — may be stalled or rate-limited\n`);
-        process.stderr.write(`  → Press s to skip, or Ctrl+C to abort\n\n`);
-      }
-    }, 30_000);
-
-    try {
-      for await (const line of rl) {
-        if (!line.trim()) continue;
-        lastEventAt = Date.now();
-
-        let event;
-        try { event = JSON.parse(line); } catch { continue; }
-
-        // codex exec --json event shapes:
-        //   { type: 'thread.started', thread_id }
-        //   { type: 'turn.started' }
-        //   { type: 'item.started'   | 'item.updated' | 'item.completed', item: {...} }
-        //   { type: 'turn.completed', usage: { input_tokens, cached_input_tokens, output_tokens } }
-        //   { type: 'error', message }
-        const t = event.type;
-
-        if (t === 'item.completed' && event.item) {
-          const item = event.item;
-          if (item.type === 'agent_message' && item.text) {
-            textParts.push(item.text);
-            yield { type: 'assistant', content: item.text };
-          } else if (item.type === 'command_execution') {
-            const cmd = item.command ?? item.input?.command ?? '';
-            yield { type: 'tool_use', tool: 'bash', input: { command: cmd } };
-            const out = item.aggregated_output ?? item.output ?? '';
-            if (out) {
-              const short = out.length > 80 ? out.slice(0, 77) + '...' : out;
-              yield { type: 'tool_use_summary', summary: short, output: String(out).slice(0, 2048) };
-            }
-          } else if (item.type === 'file_change') {
-            yield { type: 'tool_use', tool: 'edit', input: { path: item.path ?? '' } };
-          } else if (item.type === 'reasoning' && item.text) {
-            // Surface reasoning as assistant content for visibility
-            yield { type: 'assistant', content: item.text };
-          }
-        } else if (t === 'turn.completed' && event.usage) {
-          const u = event.usage;
-          yield {
-            type: 'usage',
-            input_tokens: u.input_tokens ?? 0,
-            output_tokens: u.output_tokens ?? 0,
-            cache_creation_input_tokens: 0,
-            cache_read_input_tokens: u.cached_input_tokens ?? 0,
-            cost_usd: 0,
-            model: resolvedModelID,
-          };
-        } else if (t === 'error') {
-          yield { type: 'error', message: event.message || 'codex error' };
-        }
-      }
-
-      const exitCode = await new Promise(resolve => proc.on('close', resolve));
-
-      if (exitCode !== 0 && textParts.length === 0) {
-        const stderr = Buffer.concat(stderrChunks).toString();
-        yield { type: 'error', message: stderr || `codex exited with code ${exitCode}` };
-      } else {
-        const fullText = textParts.join('');
-        if (fullText) yield { type: 'result', content: fullText };
-        yield { type: 'system', subtype: 'complete', agent: AGENT_NAME };
-      }
-    } catch (err) {
-      if (err?.name !== 'AbortError') {
-        yield { type: 'error', message: err.message || String(err) };
-      }
-    } finally {
-      clearInterval(stallTimer);
-      this.#proc = null;
-    }
-  }
-
-  interrupt() {
-    if (this.#proc) {
-      try { this.#proc.kill('SIGTERM'); } catch { /* ignore */ }
-      this.#proc = null;
-    }
-  }
-
-  get isRunning() {
-    return this.#proc !== null;
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Guard
-// ---------------------------------------------------------------------------
-
-function _assertCodexModel(modelID) {
-  if (!CODEX_MODEL_IDS.has(modelID)) {
-    throw new Error(
-      `CodexConnector: '${modelID}' is not a supported Codex model.\n` +
-      `Supported models: ${[...CODEX_MODEL_IDS].join(', ')}`
-    );
-  }
-}

package/server/connectors/connector-discovery.js

@@ -1,18 +0,0 @@
-// compose/server/connectors/connector-discovery.js
-/**
- * @interface ConnectorDiscovery
- *
- * Stateless vendor capability contract.
- * Implementations must not hold execution state.
- *
- * All three concrete connectors (ClaudeSDKConnector, CodexConnector, OpencodeConnector)
- * satisfy this interface. Shape verified by test/connector-shape.test.js.
- */
-export const ConnectorDiscoveryInterface = {
-  /** @returns {string[]} model IDs available for this vendor */
-  listModels() {},
-  /** @param {string} modelId @returns {boolean} */
-  supportsModel(_modelId) {},
-  /** @param {string} sessionId @returns {Promise<object[]>} message history */
-  async loadHistory(_sessionId) { return []; },
-};

package/server/connectors/connector-runtime.js

@@ -1,13 +0,0 @@
-// compose/server/connectors/connector-runtime.js
-/**
- * @interface ConnectorRuntime
- *
- * Stateful execution contract.
- * See agent-connector.js for the message envelope spec.
- */
-export const ConnectorRuntimeInterface = {
-  /** @yields typed message envelopes */
-  async *run(_prompt, _opts) {},
-  interrupt() {},
-  get isRunning() { return false; },
-};