@covibes/zeroshot 5.4.0 → 5.4.1

package/src/providers/openai/output-parser.js

@@ -1,143 +0,0 @@
-function safeJsonParse(value, fallback) {
-  try {
-    return JSON.parse(value);
-  } catch {
-    return fallback;
-  }
-}
-
-function parseAssistantMessage(item) {
-  const events = [];
-  const content = Array.isArray(item.content)
-    ? item.content
-    : [{ type: 'text', text: item.content }];
-  const text = content
-    .filter((c) => c.type === 'text')
-    .map((c) => c.text)
-    .join('');
-  const thinking = content
-    .filter((c) => c.type === 'thinking' || c.type === 'reasoning')
-    .map((c) => c.text)
-    .join('');
-  if (text) events.push({ type: 'text', text });
-  if (thinking) events.push({ type: 'thinking', text: thinking });
-  return events;
-}
-
-function parseFunctionCall(item) {
-  const toolId = item.call_id || item.id || item.tool_call_id || item.tool_id;
-  const args =
-    typeof item.arguments === 'string' ? safeJsonParse(item.arguments, {}) : item.arguments || {};
-  return {
-    type: 'tool_call',
-    toolName: item.name,
-    toolId,
-    input: args,
-  };
-}
-
-function parseFunctionCallOutput(item) {
-  const toolId = item.call_id || item.id || item.tool_call_id || item.tool_id;
-  const content = item.output ?? item.result ?? item.content ?? '';
-  return {
-    type: 'tool_result',
-    toolId,
-    content,
-    isError: !!item.error,
-  };
-}
-
-function parseItem(item) {
-  const events = [];
-
-  // Handle assistant messages (Claude-style: type=message, role=assistant)
-  if (item.type === 'message' && item.role === 'assistant') {
-    events.push(...parseAssistantMessage(item));
-  }
-
-  // Handle agent messages (Codex-style: type=agent_message, text=string)
-  if (item.type === 'agent_message' && item.text) {
-    events.push({ type: 'text', text: item.text });
-  }
-
-  if (item.type === 'function_call') {
-    events.push(parseFunctionCall(item));
-  }
-
-  if (item.type === 'function_call_output') {
-    events.push(parseFunctionCallOutput(item));
-  }
-
-  if (events.length === 1) return events[0];
-  if (events.length > 1) return events;
-  return null;
-}
-
-function parseEvent(line, options = {}) {
-  let event;
-  try {
-    event = JSON.parse(line);
-  } catch {
-    return null;
-  }
-
-  switch (event.type) {
-    case 'thread.started':
-    case 'turn.started':
-      return null;
-
-    case 'item.created':
-    case 'item.completed':
-      return parseItem(event.item);
-
-    case 'turn.completed': {
-      const usage = event.usage || event.response?.usage || {};
-      return {
-        type: 'result',
-        success: true,
-        inputTokens: usage.input_tokens || 0,
-        outputTokens: usage.output_tokens || 0,
-      };
-    }
-
-    case 'turn.failed':
-      return {
-        type: 'result',
-        success: false,
-        error: event.error?.message || event.error || 'Turn failed',
-      };
-
-    default:
-      // Only log warnings for actual unknown string types, not malformed events
-      // (undefined/object types are just noise from non-standard CLI output)
-      if (options.onUnknown && typeof event.type === 'string') {
-        options.onUnknown(event.type, event);
-      }
-      return null;
-  }
-}
-
-function parseChunk(chunk, options = {}) {
-  const events = [];
-  const lines = chunk.split('\n');
-
-  for (const line of lines) {
-    if (!line.trim()) continue;
-    const event = parseEvent(line, options);
-    if (!event) continue;
-    if (Array.isArray(event)) {
-      events.push(...event);
-    } else {
-      events.push(event);
-    }
-  }
-
-  return events;
-}
-
-module.exports = {
-  parseEvent,
-  parseChunk,
-  parseItem,
-  safeJsonParse,
-};

package/src/providers/opencode/cli-builder.js

@@ -1,42 +0,0 @@
-function buildCommand(context, options = {}) {
-  const { modelSpec, outputFormat, jsonSchema, cwd, cliFeatures = {} } = options;
-
-  let finalContext = context;
-  if (jsonSchema) {
-    const schemaStr =
-      typeof jsonSchema === 'string' ? jsonSchema : JSON.stringify(jsonSchema, null, 2);
-    finalContext =
-      context +
-      `\n\n## OUTPUT FORMAT (CRITICAL - REQUIRED)\n\nYou MUST respond with a JSON object that exactly matches this schema. NO markdown, NO explanation, NO code blocks. ONLY the raw JSON object.\n\nSchema:\n\`\`\`json\n${schemaStr}\n\`\`\`\n\nYour response must be ONLY valid JSON. Start with { and end with }. Nothing else.`;
-  }
-
-  const args = ['run'];
-
-  if ((outputFormat === 'stream-json' || outputFormat === 'json') && cliFeatures.supportsJson) {
-    args.push('--format', 'json');
-  }
-
-  if (modelSpec?.model) {
-    args.push('--model', modelSpec.model);
-  }
-
-  if (modelSpec?.reasoningEffort && cliFeatures.supportsVariant) {
-    args.push('--variant', modelSpec.reasoningEffort);
-  }
-
-  if (cwd && cliFeatures.supportsCwd) {
-    args.push('--cwd', cwd);
-  }
-
-  args.push(finalContext);
-
-  return {
-    binary: 'opencode',
-    args,
-    env: {},
-  };
-}
-
-module.exports = {
-  buildCommand,
-};

package/src/providers/opencode/index.js

@@ -1,103 +0,0 @@
-const BaseProvider = require('../base-provider');
-const { commandExists, getCommandPath, getHelpOutput } = require('../../../lib/provider-detection');
-const { buildCommand } = require('./cli-builder');
-const { parseEvent } = require('./output-parser');
-const {
-  MODEL_CATALOG,
-  LEVEL_MAPPING,
-  DEFAULT_LEVEL,
-  DEFAULT_MAX_LEVEL,
-  DEFAULT_MIN_LEVEL,
-} = require('./models');
-
-const warned = new Set();
-
-class OpencodeProvider extends BaseProvider {
-  constructor() {
-    super({ name: 'opencode', displayName: 'Opencode', cliCommand: 'opencode' });
-    this._cliFeatures = null;
-  }
-
-  isAvailable() {
-    return commandExists(this.cliCommand);
-  }
-
-  getCliPath() {
-    return getCommandPath(this.cliCommand) || this.cliCommand;
-  }
-
-  getInstallInstructions() {
-    return 'See https://opencode.ai for installation instructions.';
-  }
-
-  getAuthInstructions() {
-    return 'opencode auth login';
-  }
-
-  getCliFeatures() {
-    if (this._cliFeatures) return this._cliFeatures;
-    const help = getHelpOutput(this.cliCommand, ['run']);
-    const unknown = !help;
-
-    const features = {
-      supportsJson: unknown ? true : /--format\b/.test(help),
-      supportsModel: unknown ? true : /--model\b/.test(help),
-      supportsVariant: unknown ? true : /--variant\b/.test(help),
-      supportsCwd: unknown ? false : /--cwd\b/.test(help),
-      supportsAutoApprove: false,
-      unknown,
-    };
-
-    this._cliFeatures = features;
-    return features;
-  }
-
-  getCredentialPaths() {
-    return ['~/.local/share/opencode'];
-  }
-
-  buildCommand(context, options) {
-    const cliFeatures = options.cliFeatures || {};
-
-    if (options.modelSpec?.reasoningEffort && cliFeatures.supportsVariant === false) {
-      this._warnOnce(
-        'opencode-variant',
-        'Opencode CLI does not support --variant; skipping reasoningEffort.'
-      );
-    }
-
-    return buildCommand(context, { ...options, cliFeatures });
-  }
-
-  parseEvent(line) {
-    return parseEvent(line);
-  }
-
-  getModelCatalog() {
-    return MODEL_CATALOG;
-  }
-
-  getLevelMapping() {
-    return LEVEL_MAPPING;
-  }
-
-  getDefaultLevel() {
-    return DEFAULT_LEVEL;
-  }
-
-  getDefaultMaxLevel() {
-    return DEFAULT_MAX_LEVEL;
-  }
-
-  getDefaultMinLevel() {
-    return DEFAULT_MIN_LEVEL;
-  }
-
-  _warnOnce(key, message) {
-    if (warned.has(key)) return;
-    warned.add(key);
-    console.warn(`⚠️ ${message}`);
-  }
-}
-
-module.exports = OpencodeProvider;

package/src/providers/opencode/models.js

@@ -1,55 +0,0 @@
-const MODEL_CATALOG = {
-  'opencode/big-pickle': { rank: 1 },
-  'opencode/glm-4.7-free': { rank: 1 },
-  'opencode/gpt-5-nano': { rank: 1 },
-  'opencode/grok-code': { rank: 1 },
-  'opencode/minimax-m2.1-free': { rank: 1 },
-  'google/gemini-1.5-flash': { rank: 1 },
-  'google/gemini-1.5-flash-8b': { rank: 1 },
-  'google/gemini-1.5-pro': { rank: 1 },
-  'google/gemini-2.0-flash': { rank: 1 },
-  'google/gemini-2.0-flash-lite': { rank: 1 },
-  'google/gemini-2.5-flash': { rank: 1 },
-  'google/gemini-2.5-flash-image': { rank: 1 },
-  'google/gemini-2.5-flash-image-preview': { rank: 1 },
-  'google/gemini-2.5-flash-lite': { rank: 1 },
-  'google/gemini-2.5-flash-lite-preview-06-17': { rank: 1 },
-  'google/gemini-2.5-flash-lite-preview-09-2025': { rank: 1 },
-  'google/gemini-2.5-flash-preview-04-17': { rank: 1 },
-  'google/gemini-2.5-flash-preview-05-20': { rank: 1 },
-  'google/gemini-2.5-flash-preview-09-2025': { rank: 1 },
-  'google/gemini-2.5-flash-preview-tts': { rank: 1 },
-  'google/gemini-2.5-pro': { rank: 1 },
-  'google/gemini-2.5-pro-preview-05-06': { rank: 1 },
-  'google/gemini-2.5-pro-preview-06-05': { rank: 1 },
-  'google/gemini-2.5-pro-preview-tts': { rank: 1 },
-  'google/gemini-3-flash-preview': { rank: 1 },
-  'google/gemini-3-pro-preview': { rank: 1 },
-  'google/gemini-embedding-001': { rank: 1 },
-  'google/gemini-flash-latest': { rank: 1 },
-  'google/gemini-flash-lite-latest': { rank: 1 },
-  'google/gemini-live-2.5-flash': { rank: 1 },
-  'google/gemini-live-2.5-flash-preview-native-audio': { rank: 1 },
-  'openai/gpt-5.1-codex-max': { rank: 1 },
-  'openai/gpt-5.1-codex-mini': { rank: 1 },
-  'openai/gpt-5.2': { rank: 1 },
-  'openai/gpt-5.2-codex': { rank: 1 },
-};
-
-const LEVEL_MAPPING = {
-  level1: { rank: 1, model: null, reasoningEffort: 'low' },
-  level2: { rank: 2, model: null, reasoningEffort: 'medium' },
-  level3: { rank: 3, model: null, reasoningEffort: 'high' },
-};
-
-const DEFAULT_LEVEL = 'level2';
-const DEFAULT_MAX_LEVEL = 'level3';
-const DEFAULT_MIN_LEVEL = 'level1';
-
-module.exports = {
-  MODEL_CATALOG,
-  LEVEL_MAPPING,
-  DEFAULT_LEVEL,
-  DEFAULT_MAX_LEVEL,
-  DEFAULT_MIN_LEVEL,
-};

package/src/providers/opencode/output-parser.js

@@ -1,122 +0,0 @@
-function parseToolPart(part) {
-  const state = part.state || {};
-
-  if (state.status === 'pending' || state.status === 'running') {
-    return {
-      type: 'tool_call',
-      toolName: part.tool,
-      toolId: part.callID,
-      input: state.input || {},
-    };
-  }
-
-  if (state.status === 'completed') {
-    return {
-      type: 'tool_result',
-      toolId: part.callID,
-      content: state.output || '',
-      isError: false,
-    };
-  }
-
-  if (state.status === 'error') {
-    return {
-      type: 'tool_result',
-      toolId: part.callID,
-      content: state.error || '',
-      isError: true,
-    };
-  }
-
-  return null;
-}
-
-function parseStepFinish(part) {
-  const tokens = part.tokens || {};
-  return {
-    type: 'result',
-    success: true,
-    inputTokens: tokens.input || 0,
-    outputTokens: tokens.output || 0,
-  };
-}
-
-function parsePart(part) {
-  if (!part || typeof part !== 'object') return null;
-
-  if (part.type === 'text' && part.text) {
-    return { type: 'text', text: part.text };
-  }
-
-  if (part.type === 'reasoning' && part.text) {
-    return { type: 'thinking', text: part.text };
-  }
-
-  if (part.type === 'tool') {
-    return parseToolPart(part);
-  }
-
-  if (part.type === 'step-finish') {
-    return parseStepFinish(part);
-  }
-
-  return null;
-}
-
-function parseErrorEvent(event) {
-  const error = event.error || {};
-  return {
-    type: 'result',
-    success: false,
-    error: error.data?.message || error.message || error.name || 'Unknown error',
-  };
-}
-
-function parseEvent(line) {
-  let event;
-  try {
-    event = JSON.parse(line);
-  } catch {
-    return null;
-  }
-
-  if (!event || typeof event !== 'object') return null;
-
-  if (event.type === 'error') {
-    return parseErrorEvent(event);
-  }
-
-  if (event.type === 'text' || event.type === 'step_start' || event.type === 'step_finish') {
-    return parsePart(event.part || event);
-  }
-
-  if (event.type === 'message.part.updated') {
-    return parsePart(event.properties?.part);
-  }
-
-  return null;
-}
-
-function parseChunk(chunk) {
-  const events = [];
-  const lines = chunk.split('\n');
-
-  for (const line of lines) {
-    if (!line.trim()) continue;
-    const event = parseEvent(line);
-    if (!event) continue;
-    if (Array.isArray(event)) {
-      events.push(...event);
-    } else {
-      events.push(event);
-    }
-  }
-
-  return events;
-}
-
-module.exports = {
-  parseEvent,
-  parseChunk,
-  parsePart,
-};

package/src/schemas/sub-cluster.js

@@ -1,185 +0,0 @@
-/**
- * Sub-Cluster Schema
- *
- * Defines the structure for nested clusters where an agent can be replaced
- * with an entire cluster configuration, enabling recursive composition.
- *
- * Example:
- * {
- *   "id": "implementation-cluster",
- *   "type": "subcluster",
- *   "config": {
- *     "agents": [
- *       { "id": "worker", "role": "implementation", ... },
- *       { "id": "validator", "role": "validator", ... }
- *     ]
- *   },
- *   "triggers": [{ "topic": "PLAN_READY" }],
- *   "hooks": {
- *     "onComplete": {
- *       "action": "publish_message",
- *       "config": { "topic": "IMPLEMENTATION_COMPLETE" }
- *     }
- *   }
- * }
- */
-
-/**
- * Validate sub-cluster agent configuration
- * @param {Object} agentConfig - Agent config with type: 'subcluster'
- * @param {Number} depth - Current nesting depth (for recursion limit)
- * @returns {{ valid: boolean, errors: string[], warnings: string[] }}
- */
-const MAX_SUBCLUSTER_DEPTH = 5;
-
-function validateSubCluster(agentConfig, depth = 0) {
-  const errors = [];
-  const warnings = [];
-
-  // Max nesting depth to prevent infinite recursion
-  if (depth > MAX_SUBCLUSTER_DEPTH) {
-    errors.push(
-      `Sub-cluster '${agentConfig.id}' exceeds max nesting depth (${MAX_SUBCLUSTER_DEPTH})`
-    );
-    return buildValidationResult(errors, warnings);
-  }
-
-  // Validate required fields
-  if (agentConfig.type !== 'subcluster') {
-    errors.push(`Agent '${agentConfig.id}' must have type: 'subcluster'`);
-  }
-
-  if (!validateSubClusterConfig(agentConfig, depth, errors, warnings)) {
-    return buildValidationResult(errors, warnings);
-  }
-
-  // Validate triggers (sub-cluster must have triggers to activate)
-  validateSubClusterTriggers(agentConfig, errors);
-
-  // Validate hooks structure
-  validateSubClusterHooks(agentConfig, errors);
-
-  // Check for context bridging configuration
-  validateContextStrategy(agentConfig, errors);
-
-  return buildValidationResult(errors, warnings);
-}
-
-function buildValidationResult(errors, warnings) {
-  return {
-    valid: errors.length === 0,
-    errors,
-    warnings,
-  };
-}
-
-function validateSubClusterConfig(agentConfig, depth, errors, warnings) {
-  if (!agentConfig.config) {
-    errors.push(`Sub-cluster '${agentConfig.id}' missing config field`);
-    return false;
-  }
-
-  if (!agentConfig.config.agents || !Array.isArray(agentConfig.config.agents)) {
-    errors.push(`Sub-cluster '${agentConfig.id}' config.agents must be an array`);
-    return false;
-  }
-
-  if (agentConfig.config.agents.length === 0) {
-    errors.push(`Sub-cluster '${agentConfig.id}' config.agents cannot be empty`);
-    return false;
-  }
-
-  // Recursively validate nested cluster config
-  const configValidator = require('../config-validator');
-  const childValidation = configValidator.validateConfig(agentConfig.config, depth + 1);
-
-  if (!childValidation.valid) {
-    errors.push(...childValidation.errors.map((e) => `Sub-cluster '${agentConfig.id}': ${e}`));
-  }
-
-  warnings.push(...childValidation.warnings.map((w) => `Sub-cluster '${agentConfig.id}': ${w}`));
-  return true;
-}
-
-function validateSubClusterTriggers(agentConfig, errors) {
-  if (!agentConfig.triggers || agentConfig.triggers.length === 0) {
-    errors.push(`Sub-cluster '${agentConfig.id}' must have triggers to activate`);
-  }
-}
-
-function validateSubClusterHooks(agentConfig, errors) {
-  if (!agentConfig.hooks?.onComplete) {
-    return;
-  }
-
-  const hook = agentConfig.hooks.onComplete;
-  if (!hook.action) {
-    errors.push(`Sub-cluster '${agentConfig.id}' onComplete hook missing action`);
-  }
-  if (hook.action === 'publish_message' && !hook.config?.topic) {
-    errors.push(`Sub-cluster '${agentConfig.id}' onComplete hook missing config.topic`);
-  }
-}
-
-function validateContextStrategy(agentConfig, errors) {
-  const parentTopics = agentConfig.contextStrategy?.parentTopics;
-  if (!parentTopics) {
-    return;
-  }
-
-  if (!Array.isArray(parentTopics)) {
-    errors.push(`Sub-cluster '${agentConfig.id}' contextStrategy.parentTopics must be an array`);
-    return;
-  }
-
-  // Validate each parent topic is a string
-  for (const topic of parentTopics) {
-    if (typeof topic !== 'string') {
-      errors.push(
-        `Sub-cluster '${agentConfig.id}' parentTopics must contain strings, got ${typeof topic}`
-      );
-    }
-  }
-}
-
-/**
- * Get default sub-cluster template
- * @returns {Object} Default sub-cluster configuration
- */
-function getDefaultSubCluster() {
-  return {
-    id: 'example-subcluster',
-    type: 'subcluster',
-    role: 'orchestrator',
-    config: {
-      agents: [
-        {
-          id: 'worker',
-          role: 'implementation',
-          triggers: [{ topic: 'PARENT_TRIGGER' }],
-          hooks: {
-            onComplete: {
-              action: 'publish_message',
-              config: { topic: 'WORK_COMPLETE' },
-            },
-          },
-        },
-      ],
-    },
-    triggers: [{ topic: 'START_WORK' }],
-    hooks: {
-      onComplete: {
-        action: 'publish_message',
-        config: { topic: 'SUBCLUSTER_COMPLETE' },
-      },
-    },
-    contextStrategy: {
-      parentTopics: ['ISSUE_OPENED', 'PLAN_READY'],
-    },
-  };
-}
-
-module.exports = {
-  validateSubCluster,
-  getDefaultSubCluster,
-};