@the-open-engine/zeroshot 5.4.0

package/lib/agent-cli-provider/single-agent-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-agent-runtime.js","sourceRoot":"","sources":["../../src/agent-cli-provider/single-agent-runtime.ts"],"names":[],"mappings":"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"}

package/lib/agent-cli-provider/types.d.ts

@@ -0,0 +1,194 @@
+export type ProviderId = 'claude' | 'codex' | 'gemini' | 'opencode';
+export type ProviderAlias = 'anthropic' | 'openai' | 'google';
+export type KnownProviderName = ProviderId | ProviderAlias;
+export type ModelLevel = 'level1' | 'level2' | 'level3';
+export type ReasoningEffort = 'low' | 'medium' | 'high' | 'xhigh';
+export type OutputFormat = 'text' | 'json' | 'stream-json';
+export interface AgentCliProviderHelperMetadata {
+    readonly packageName: '@the-open-engine/zeroshot';
+    readonly buildOutputDir: 'lib/agent-cli-provider';
+    readonly contractVersion: 1;
+    readonly adapterVersion: string;
+}
+export interface ModelCatalogEntry {
+    readonly rank: number;
+}
+export interface LevelModelSpec {
+    readonly rank: number;
+    readonly model: string | null;
+    readonly reasoningEffort?: ReasoningEffort;
+}
+export interface ModelSpec {
+    readonly level?: ModelLevel;
+    readonly model?: string | null;
+    readonly reasoningEffort?: ReasoningEffort;
+}
+export interface ResolvedModelSpec {
+    readonly level: ModelLevel;
+    readonly model: string | null;
+    readonly reasoningEffort: ReasoningEffort | undefined;
+}
+export type LevelOverrides = Readonly<Partial<Record<ModelLevel, ModelSpec>>>;
+export interface BaseCliFeatures {
+    readonly provider?: ProviderId;
+    readonly unknown?: boolean;
+}
+export interface ClaudeCliFeatures extends BaseCliFeatures {
+    readonly provider: 'claude';
+    readonly supportsOutputFormat: boolean;
+    readonly supportsStreamJson: boolean;
+    readonly supportsJsonSchema: boolean;
+    readonly supportsAutoApprove: boolean;
+    readonly supportsIncludePartials: boolean;
+    readonly supportsVerbose: boolean;
+    readonly supportsModel: boolean;
+}
+export interface CodexCliFeatures extends BaseCliFeatures {
+    readonly provider: 'codex';
+    readonly supportsJson: boolean;
+    readonly supportsOutputSchema: boolean;
+    readonly supportsAutoApprove: boolean;
+    readonly supportsCwd: boolean;
+    readonly supportsConfigOverride: boolean;
+    readonly supportsModel: boolean;
+    readonly supportsSkipGitRepoCheck: boolean;
+}
+export interface GeminiCliFeatures extends BaseCliFeatures {
+    readonly provider: 'gemini';
+    readonly supportsStreamJson: boolean;
+    readonly supportsAutoApprove: boolean;
+    readonly supportsCwd: boolean;
+    readonly supportsModel: boolean;
+}
+export interface OpencodeCliFeatures extends BaseCliFeatures {
+    readonly provider: 'opencode';
+    readonly supportsJson: boolean;
+    readonly supportsModel: boolean;
+    readonly supportsVariant: boolean;
+    readonly supportsCwd: boolean;
+    readonly supportsAutoApprove: false;
+}
+export type ProviderCliFeatures = ClaudeCliFeatures | CodexCliFeatures | GeminiCliFeatures | OpencodeCliFeatures;
+export interface CliFeatureOverrides {
+    readonly supportsOutputFormat?: boolean;
+    readonly supportsStreamJson?: boolean;
+    readonly supportsJsonSchema?: boolean;
+    readonly supportsAutoApprove?: boolean;
+    readonly supportsIncludePartials?: boolean;
+    readonly supportsVerbose?: boolean;
+    readonly supportsModel?: boolean;
+    readonly supportsJson?: boolean;
+    readonly supportsOutputSchema?: boolean;
+    readonly supportsCwd?: boolean;
+    readonly supportsConfigOverride?: boolean;
+    readonly supportsSkipGitRepoCheck?: boolean;
+    readonly supportsVariant?: boolean;
+    readonly unknown?: boolean;
+}
+export interface CleanupMetadata {
+    readonly kind: 'temp-file';
+    readonly provider: ProviderId;
+    readonly path: string;
+    readonly reason: 'output-schema';
+}
+export interface WarningMetadata {
+    readonly provider: ProviderId;
+    readonly code: string;
+    readonly message: string;
+}
+export interface RedactionMetadata {
+    readonly kind: 'env' | 'secret-key' | 'secret-value';
+    readonly key: string;
+    readonly source?: string;
+}
+export interface CommandSpec {
+    readonly binary: string;
+    readonly args: readonly string[];
+    readonly env: Readonly<Record<string, string>>;
+    readonly cwd?: string;
+    readonly cleanup?: readonly string[];
+    readonly cleanupMetadata: readonly CleanupMetadata[];
+    readonly warnings: readonly WarningMetadata[];
+    readonly redactions: readonly RedactionMetadata[];
+}
+export interface BuildProviderCommandOptions {
+    readonly modelSpec?: ModelSpec;
+    readonly outputFormat?: OutputFormat;
+    readonly jsonSchema?: unknown;
+    readonly cwd?: string;
+    readonly autoApprove?: boolean;
+    readonly resumeSessionId?: string;
+    readonly continueSession?: boolean;
+    readonly cliFeatures?: CliFeatureOverrides;
+    readonly authEnv?: Readonly<Record<string, string>>;
+    readonly strictSchema?: boolean;
+}
+export interface TextEvent {
+    readonly type: 'text';
+    readonly text: string;
+}
+export interface ThinkingEvent {
+    readonly type: 'thinking';
+    readonly text: string;
+}
+export interface ToolCallEvent {
+    readonly type: 'tool_call';
+    readonly toolName: string | null | undefined;
+    readonly toolId: string | null | undefined;
+    readonly input: unknown;
+}
+export interface ToolResultEvent {
+    readonly type: 'tool_result';
+    readonly toolId: string | null | undefined;
+    readonly content: unknown;
+    readonly isError: unknown;
+}
+export interface ResultEvent {
+    readonly type: 'result';
+    readonly success: boolean;
+    readonly result?: unknown;
+    readonly error?: unknown;
+    readonly cost?: unknown;
+    readonly duration?: unknown;
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+    readonly cacheReadInputTokens?: number;
+    readonly cacheCreationInputTokens?: number;
+    readonly modelUsage?: unknown;
+}
+export type OutputEvent = TextEvent | ThinkingEvent | ToolCallEvent | ToolResultEvent | ResultEvent;
+export type ProviderParseResult = OutputEvent | readonly OutputEvent[] | null;
+export interface ProviderParserState {
+    provider: ProviderId;
+    lastToolId: string | null | undefined;
+}
+export type ErrorClassificationKind = 'status-retryable' | 'status-permanent' | 'code-retryable' | 'permanent-pattern' | 'retryable-pattern' | 'unknown-retryable';
+export interface ErrorClassification {
+    readonly retryable: boolean;
+    readonly kind: ErrorClassificationKind;
+    readonly matchedPattern?: string;
+}
+export interface ProviderAdapter {
+    readonly id: ProviderId;
+    readonly displayName: string;
+    readonly binary: string;
+    readonly adapterVersion: string;
+    readonly credentialEnvKeys: readonly string[];
+    readonly modelCatalog: Readonly<Record<string, ModelCatalogEntry>>;
+    readonly levelMapping: Readonly<Record<ModelLevel, LevelModelSpec>>;
+    readonly defaultLevel: ModelLevel;
+    readonly defaultMaxLevel: ModelLevel;
+    readonly defaultMinLevel: ModelLevel;
+    detectCliFeatures(helpText?: string | null): ProviderCliFeatures;
+    buildCommand(context: string, options?: BuildProviderCommandOptions): CommandSpec;
+    parseEvent(line: string, state: ProviderParserState): ProviderParseResult;
+    createParserState(): ProviderParserState;
+    resolveModelSpec(level: ModelLevel, overrides?: LevelOverrides): ResolvedModelSpec;
+    validateModelId(modelId: string | null | undefined): string | null | undefined;
+    classifyError(error: unknown): ErrorClassification;
+}
+export declare class InvalidProviderModelError extends Error {
+    readonly permanent = true;
+    constructor(message: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/agent-cli-provider/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent-cli-provider/types.ts"],"names":[],"mappings":"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"}

package/lib/agent-cli-provider/types.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidProviderModelError = void 0;
+class InvalidProviderModelError extends Error {
+    permanent = true;
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidProviderModelError';
+    }
+}
+exports.InvalidProviderModelError = InvalidProviderModelError;
+//# sourceMappingURL=types.js.map

package/lib/agent-cli-provider/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent-cli-provider/types.ts"],"names":[],"mappings":";;;AAqOA,MAAa,yBAA0B,SAAQ,KAAK;IACzC,SAAS,GAAG,IAAI,CAAC;IAE1B,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAPD,8DAOC"}

package/lib/completion.js

@@ -0,0 +1,174 @@
+const omelette = require('omelette');
+const fs = require('fs');
+const path = require('path');
+
+function setupCompletion() {
+  const complete = omelette('zeroshot');
+
+  complete.on('start', ({ reply }) => {
+    reply(['--issue', '--text', '--config']);
+  });
+
+  complete.on('list', ({ reply }) => {
+    reply([]);
+  });
+
+  complete.on('status', ({ reply }) => {
+    // Complete with cluster IDs
+    try {
+      const clustersDir = path.join(process.env.HOME, '.zeroshot', 'clusters');
+      if (fs.existsSync(clustersDir)) {
+        const clusterIds = fs
+          .readdirSync(clustersDir)
+          .filter((f) => f.endsWith('.json'))
+          .map((f) => f.replace('.json', ''));
+        reply(clusterIds);
+      } else {
+        reply([]);
+      }
+    } catch {
+      reply([]);
+    }
+  });
+
+  complete.on('logs', ({ reply }) => {
+    // Complete with cluster IDs or flags
+    try {
+      const clustersDir = path.join(process.env.HOME, '.zeroshot', 'clusters');
+      const completions = ['--follow', '-f', '--limit', '-n'];
+
+      if (fs.existsSync(clustersDir)) {
+        const clusterIds = fs
+          .readdirSync(clustersDir)
+          .filter((f) => f.endsWith('.json'))
+          .map((f) => f.replace('.json', ''));
+        reply([...clusterIds, ...completions]);
+      } else {
+        reply(completions);
+      }
+    } catch {
+      reply(['--follow', '-f', '--limit', '-n']);
+    }
+  });
+
+  complete.on('stop', ({ reply }) => {
+    // Complete with active cluster IDs
+    try {
+      const clustersDir = path.join(process.env.HOME, '.zeroshot', 'clusters');
+      if (fs.existsSync(clustersDir)) {
+        const clusterIds = fs
+          .readdirSync(clustersDir)
+          .filter((f) => f.endsWith('.json'))
+          .map((f) => f.replace('.json', ''));
+        reply(clusterIds);
+      } else {
+        reply([]);
+      }
+    } catch {
+      reply([]);
+    }
+  });
+
+  complete.on('kill', ({ reply }) => {
+    // Complete with active cluster IDs
+    try {
+      const clustersDir = path.join(process.env.HOME, '.zeroshot', 'clusters');
+      if (fs.existsSync(clustersDir)) {
+        const clusterIds = fs
+          .readdirSync(clustersDir)
+          .filter((f) => f.endsWith('.json'))
+          .map((f) => f.replace('.json', ''));
+        reply(clusterIds);
+      } else {
+        reply([]);
+      }
+    } catch {
+      reply([]);
+    }
+  });
+
+  complete.on('export', ({ reply }) => {
+    // Complete with cluster IDs
+    try {
+      const clustersDir = path.join(process.env.HOME, '.zeroshot', 'clusters');
+      if (fs.existsSync(clustersDir)) {
+        const clusterIds = fs
+          .readdirSync(clustersDir)
+          .filter((f) => f.endsWith('.json'))
+          .map((f) => f.replace('.json', ''));
+        reply(clusterIds);
+      } else {
+        reply([]);
+      }
+    } catch {
+      reply([]);
+    }
+  });
+
+  complete.on('finish', ({ reply }) => {
+    // Complete with cluster IDs and flags
+    try {
+      const clustersDir = path.join(process.env.HOME, '.zeroshot', 'clusters');
+      const completions = ['--merge', '--pr', '--push'];
+
+      if (fs.existsSync(clustersDir)) {
+        const clusterIds = fs
+          .readdirSync(clustersDir)
+          .filter((f) => f.endsWith('.json'))
+          .map((f) => f.replace('.json', ''));
+        reply([...clusterIds, ...completions]);
+      } else {
+        reply(completions);
+      }
+    } catch {
+      reply(['--merge', '--pr', '--push']);
+    }
+  });
+
+  complete.on('resume', ({ reply }) => {
+    // Complete with cluster IDs
+    try {
+      const clustersDir = path.join(process.env.HOME, '.zeroshot', 'clusters');
+      if (fs.existsSync(clustersDir)) {
+        const clusterIds = fs
+          .readdirSync(clustersDir)
+          .filter((f) => f.endsWith('.json'))
+          .map((f) => f.replace('.json', ''));
+        reply(clusterIds);
+      } else {
+        reply([]);
+      }
+    } catch {
+      reply([]);
+    }
+  });
+
+  complete.on('ui', ({ reply }) => {
+    reply(['--port']);
+  });
+
+  complete.on('watch', ({ reply }) => {
+    reply(['--filter', '--refresh-rate', 'running', 'stopped', 'all']);
+  });
+
+  // Default completion - show commands
+  complete.on('', ({ reply }) => {
+    reply([
+      'start',
+      'list',
+      'status',
+      'logs',
+      'stop',
+      'kill',
+      'finish',
+      'resume',
+      'export',
+      'ui',
+      'watch',
+    ]);
+  });
+
+  complete.init();
+}
+
+module.exports = { setupCompletion };

package/lib/detached-startup.js

@@ -0,0 +1,220 @@
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const lockfile = require('proper-lockfile');
+
+const DEFAULT_WAIT_TIMEOUT_SECONDS = 180;
+const DEFAULT_WAIT_POLL_MS = 1000;
+const CLUSTERS_LOCK_STALE_MS = 5000;
+
+function getStorageDir(storageDir) {
+  return storageDir || path.join(os.homedir(), '.zeroshot');
+}
+
+function getClustersFilePath(storageDir) {
+  return path.join(getStorageDir(storageDir), 'clusters.json');
+}
+
+function resolveWaitTimeoutMs(waitTimeoutSeconds) {
+  const parsed = Number(waitTimeoutSeconds);
+  if (!Number.isFinite(parsed) || parsed <= 0) {
+    return DEFAULT_WAIT_TIMEOUT_SECONDS * 1000;
+  }
+  return Math.floor(parsed * 1000);
+}
+
+function isProcessAlive(pid) {
+  if (!pid || !Number.isInteger(pid) || pid <= 0) {
+    return false;
+  }
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    return error && error.code === 'EPERM';
+  }
+}
+
+function isClusterRegistered(clusterId, storageDir) {
+  const clustersFile = getClustersFilePath(storageDir);
+  if (!fs.existsSync(clustersFile)) {
+    return false;
+  }
+
+  let parsed;
+  try {
+    const raw = fs.readFileSync(clustersFile, 'utf8');
+    parsed = JSON.parse(raw);
+  } catch {
+    return false;
+  }
+
+  return parsed !== null && typeof parsed === 'object' && Boolean(parsed[clusterId]);
+}
+
+function ensureStorageDir(storageDir) {
+  const resolvedStorageDir = getStorageDir(storageDir);
+  fs.mkdirSync(resolvedStorageDir, { recursive: true });
+  return resolvedStorageDir;
+}
+
+function ensureClustersFile(storageDir) {
+  const resolvedStorageDir = ensureStorageDir(storageDir);
+  const clustersFile = getClustersFilePath(resolvedStorageDir);
+  try {
+    fs.writeFileSync(clustersFile, '{}', { flag: 'wx', mode: 0o600 });
+  } catch (error) {
+    if (!error || error.code !== 'EEXIST') {
+      throw error;
+    }
+  }
+  return clustersFile;
+}
+
+function readClustersFile(clustersFile) {
+  try {
+    return JSON.parse(fs.readFileSync(clustersFile, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+async function updateClustersFile(storageDir, updater) {
+  const clustersFile = ensureClustersFile(storageDir);
+  const lockfilePath = path.join(path.dirname(clustersFile), 'clusters.json.lock');
+  let release;
+
+  try {
+    release = await lockfile.lock(clustersFile, {
+      lockfilePath,
+      stale: CLUSTERS_LOCK_STALE_MS,
+      retries: {
+        retries: 20,
+        minTimeout: 100,
+        maxTimeout: 250,
+        randomize: true,
+      },
+    });
+
+    const clusters = readClustersFile(clustersFile);
+    const updated = updater(clusters) || clusters;
+    fs.writeFileSync(clustersFile, JSON.stringify(updated, null, 2));
+    return updated;
+  } finally {
+    if (release) {
+      await release();
+    }
+  }
+}
+
+async function registerDetachedSetupCluster({
+  clusterId,
+  pid,
+  storageDir,
+  logPath,
+  worktree,
+  runOptions = {},
+  cwd,
+}) {
+  await updateClustersFile(storageDir, (clusters) => {
+    clusters[clusterId] = {
+      id: clusterId,
+      state: 'setup',
+      createdAt: Date.now(),
+      pid: Number.isInteger(pid) ? pid : null,
+      setupLogPath: logPath || null,
+      setupStartedAt: Date.now(),
+      setupStage: 'starting',
+      autoPr: Boolean(runOptions.pr || runOptions.ship),
+      prOptions: runOptions.prBase
+        ? {
+            prBase: runOptions.prBase,
+            mergeQueue: runOptions.mergeQueue || false,
+            closeIssue: runOptions.closeIssue || null,
+            cwd: cwd || null,
+          }
+        : null,
+      worktree: worktree || null,
+      config: null,
+      issue: null,
+      isolation: null,
+      agentStates: [],
+      failureInfo: null,
+      provisional: true,
+    };
+    return clusters;
+  });
+}
+
+async function markDetachedSetupFailed({ clusterId, storageDir, error, logPath }) {
+  await updateClustersFile(storageDir, (clusters) => {
+    const existing = clusters[clusterId] || { id: clusterId, createdAt: Date.now() };
+    clusters[clusterId] = {
+      ...existing,
+      state: 'failed',
+      pid: null,
+      setupLogPath: existing.setupLogPath || logPath || null,
+      setupFinishedAt: Date.now(),
+      failureInfo: {
+        type: 'setup',
+        error: error instanceof Error ? error.message : String(error),
+        timestamp: Date.now(),
+      },
+      provisional: true,
+    };
+    return clusters;
+  });
+}
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function formatLogHint(logPath) {
+  return logPath ? ` Check log: ${logPath}` : '';
+}
+
+async function waitForClusterRegistration({
+  clusterId,
+  timeoutMs,
+  pollMs = DEFAULT_WAIT_POLL_MS,
+  storageDir,
+  daemonPid,
+  logPath,
+}) {
+  const effectiveTimeoutMs =
+    Number.isFinite(timeoutMs) && timeoutMs > 0 ? timeoutMs : DEFAULT_WAIT_TIMEOUT_SECONDS * 1000;
+  const startedAt = Date.now();
+  const deadline = startedAt + effectiveTimeoutMs;
+  const logHint = formatLogHint(logPath);
+
+  while (Date.now() < deadline) {
+    if (isClusterRegistered(clusterId, storageDir)) {
+      return { ready: true, elapsedMs: Date.now() - startedAt };
+    }
+
+    if (daemonPid && !isProcessAlive(daemonPid)) {
+      throw new Error(
+        `Detached daemon exited before cluster "${clusterId}" registered in storage.${logHint}`
+      );
+    }
+
+    await sleep(pollMs);
+  }
+
+  const timeoutSeconds = Math.ceil(effectiveTimeoutMs / 1000);
+  throw new Error(
+    `Timed out after ${timeoutSeconds}s waiting for cluster "${clusterId}" to appear in status/list.${logHint}`
+  );
+}
+
+module.exports = {
+  DEFAULT_WAIT_TIMEOUT_SECONDS,
+  getClustersFilePath,
+  isClusterRegistered,
+  isProcessAlive,
+  markDetachedSetupFailed,
+  registerDetachedSetupCluster,
+  resolveWaitTimeoutMs,
+  waitForClusterRegistration,
+};