@iowarp/clio-coder 0.4.6 → 0.4.8

package/dist/trace-JHLXWUMN.js

@@ -1,572 +0,0 @@
-import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import {
-  truncateToWidth
-} from "./chunk-QRFXEO6Y.js";
-import {
-  DEFAULT_TRACE_RETENTION_POLICY,
-  TRACE_EVENT_POLL_LIMIT,
-  TraceReader,
-  TraceStore,
-  assertTraceSelectOnly,
-  resolveTraceRetentionPolicy,
-  traceDatabasePath
-} from "./chunk-LZBMXNLP.js";
-import {
-  codeStepDir,
-  readCodeStepRecords
-} from "./chunk-P5SC4DLJ.js";
-import {
-  sanitizeCallTargetText
-} from "./chunk-2GPGAE5W.js";
-import "./chunk-O3VV6IVK.js";
-import "./chunk-FQOOGXBH.js";
-import "./chunk-UHW5V7HC.js";
-import "./chunk-KMF54VH3.js";
-import "./chunk-EFSEIZE6.js";
-import "./chunk-E3LEPLQ2.js";
-import "./chunk-TK2BMCBZ.js";
-import "./chunk-ZZFWWYLX.js";
-import {
-  clioStatePath
-} from "./chunk-CTTI7G3T.js";
-import {
-  init_esm_shims
-} from "./chunk-ECBHH7LU.js";
-
-// src/cli/trace.ts
-init_esm_shims();
-import { existsSync as existsSync2 } from "node:fs";
-import { access } from "node:fs/promises";
-import { resolve } from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
-
-// src/cli/trace-inspect.ts
-init_esm_shims();
-import { existsSync } from "node:fs";
-var TRACE_INSPECT_MAX_RUNS = 8;
-var TRACE_INSPECT_MAX_PHASES = 16;
-var TRACE_INSPECT_MAX_EVENT_KINDS = 12;
-var TRACE_INSPECT_MAX_PROCESS_KINDS = 8;
-var IDENTITY_WIDTH = 128;
-var STATUS_WIDTH = 64;
-function bounded(value, width) {
-  const sanitized = sanitizeCallTargetText(value);
-  if (sanitized.length === 0) return "unavailable";
-  return sanitizeCallTargetText(truncateToWidth(sanitized, width, "\u2026", false));
-}
-function nullableBounded(value, width) {
-  return value === null ? null : bounded(value, width);
-}
-function tally(value) {
-  return typeof value === "number" && Number.isFinite(value) && value >= 0 ? Math.trunc(value) : null;
-}
-function cost(value) {
-  return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
-}
-function elapsed(startedAt, endedAt) {
-  if (startedAt === null || endedAt === null) return null;
-  const start = Date.parse(startedAt);
-  const end = Date.parse(endedAt);
-  if (!Number.isFinite(start) || !Number.isFinite(end)) return null;
-  return Math.max(0, end - start);
-}
-function eventSummary(reader, runId) {
-  const span = reader.eventSpan(runId);
-  const all = reader.eventKindCounts(runId);
-  const visible = all.slice(0, TRACE_INSPECT_MAX_EVENT_KINDS);
-  return {
-    total: tally(span.total) ?? 0,
-    firstAt: span.firstAt,
-    lastAt: span.lastAt,
-    kinds: visible.map((entry) => ({ kind: bounded(entry.type, STATUS_WIDTH), count: tally(entry.count) ?? 0 })),
-    kindsTruncated: all.length > visible.length
-  };
-}
-function processSummary(reader, runId) {
-  const all = reader.processKindCounts(runId);
-  const visible = all.slice(0, TRACE_INSPECT_MAX_PROCESS_KINDS);
-  return {
-    total: all.reduce((sum, entry) => sum + (tally(entry.total) ?? 0), 0),
-    running: all.reduce((sum, entry) => sum + (tally(entry.running) ?? 0), 0),
-    kinds: visible.map((entry) => ({
-      kind: bounded(entry.kind, STATUS_WIDTH),
-      total: tally(entry.total) ?? 0,
-      running: tally(entry.running) ?? 0
-    })),
-    kindsTruncated: all.length > visible.length
-  };
-}
-function traceInspectSnapshot(now = Date.now, databasePath = traceDatabasePath(clioStatePath())) {
-  const generatedAt = new Date(now()).toISOString();
-  if (!existsSync(databasePath)) {
-    return { version: 1, generatedAt, available: false, runs: [], truncated: false };
-  }
-  let reader;
-  try {
-    reader = new TraceReader(databasePath);
-  } catch {
-    return { version: 1, generatedAt, available: true, runs: [], truncated: false };
-  }
-  try {
-    const selected = reader.runs(TRACE_INSPECT_MAX_RUNS + 1);
-    const window = selected.slice(0, TRACE_INSPECT_MAX_RUNS);
-    const runs = window.map((row) => {
-      const allPhases = reader.phases(row.run_id);
-      const visible = allPhases.slice(0, TRACE_INSPECT_MAX_PHASES);
-      return {
-        runId: bounded(row.run_id, IDENTITY_WIDTH),
-        agent: bounded(row.agent, IDENTITY_WIDTH),
-        target: bounded(row.target, IDENTITY_WIDTH),
-        model: bounded(row.model, IDENTITY_WIDTH),
-        runtime: bounded(row.runtime, IDENTITY_WIDTH),
-        node: nullableBounded(row.node, IDENTITY_WIDTH),
-        status: bounded(row.status, STATUS_WIDTH),
-        startedAt: row.started_at,
-        elapsedMs: elapsed(row.started_at, row.ended_at),
-        totalTokens: tally(row.total_tokens),
-        totalCostUsd: cost(row.total_cost_usd),
-        phases: visible.map(
-          (phase) => ({
-            name: bounded(phase.name, IDENTITY_WIDTH),
-            kind: bounded(phase.kind, STATUS_WIDTH),
-            owner: bounded(phase.owner, IDENTITY_WIDTH),
-            status: bounded(phase.status, STATUS_WIDTH),
-            attempt: tally(phase.attempt) ?? 0,
-            retries: tally(phase.retries) ?? 0,
-            // The error text can quote a path, a URL, or a model reply, so only
-            // the fact that one was recorded crosses.
-            failed: phase.error !== null && phase.error !== "",
-            elapsedMs: elapsed(phase.started_at, phase.ended_at),
-            totalTokens: tally(phase.total_tokens),
-            totalCostUsd: cost(phase.total_cost_usd)
-          })
-        ),
-        phasesTruncated: allPhases.length > visible.length,
-        events: eventSummary(reader, row.run_id),
-        processes: processSummary(reader, row.run_id)
-      };
-    });
-    return {
-      version: 1,
-      generatedAt,
-      available: true,
-      runs,
-      truncated: selected.length > window.length
-    };
-  } finally {
-    reader.close();
-  }
-}
-function runTraceInspect(fixed) {
-  if (!fixed) {
-    process.stderr.write("clio-coder trace inspect: usage: clio-coder trace inspect --json\n");
-    return 2;
-  }
-  process.stdout.write(`${JSON.stringify(traceInspectSnapshot(), null, 2)}
-`);
-  return 0;
-}
-
-// src/cli/trace.ts
-var HELP = `Usage:
-  clio-coder trace runs [--db PATH] [--limit N] [--json]
-  clio-coder trace inspect --json         a fixed bounded window with no request text
-  clio-coder trace phases <runId> [--db PATH]
-  clio-coder trace tail <runId> [--follow] [--db PATH]
-  clio-coder trace procs <runId> [--db PATH]
-  clio-coder trace code-steps <rootId> [--json]   deterministic code steps of one fleet root
-  clio-coder trace prune [--max-age-days N] [--max-bytes N] [--db PATH] [--json]
-  clio-coder trace sql <SELECT query> [--db PATH]
-  clio-coder trace ui [--db PATH] [--port N]        source checkout only
-
-The viewer ships with the repository, not the npm package, so from an installed
-Clio the subcommands above are the way in. They read the same database, except
-code-steps, which reads the per-root record files under the state directory's
-code-steps/ tree (a code step is a subprocess, not a model run, so it never
-enters the SQLite mirror).
-Pruning keeps ${DEFAULT_TRACE_RETENTION_POLICY.maxAgeDays} days and at most ${DEFAULT_TRACE_RETENTION_POLICY.maxBytes} bytes by default. Set
-CLIO_CODER_TRACE_RETENTION_DAYS or CLIO_CODER_TRACE_MAX_BYTES to change the automatic
-policy; prune flags override those values for one command.
-`;
-var DEFAULT_TRACE_LIMIT = 50;
-function parseTraceArgs(args) {
-  const positional = [];
-  let db = traceDatabasePath(clioStatePath());
-  let dbExplicit = false;
-  let follow = false;
-  let limit = DEFAULT_TRACE_LIMIT;
-  let port = 0;
-  let json = false;
-  let maxAgeDays;
-  let maxBytes;
-  for (let index = 0; index < args.length; index += 1) {
-    const arg = args[index];
-    if (arg === "--follow") follow = true;
-    else if (arg === "--json") json = true;
-    else if (arg === "--db" || arg === "--limit" || arg === "--port" || arg === "--max-age-days" || arg === "--max-bytes") {
-      const value = args[index + 1];
-      if (value === void 0) throw new Error(`${arg} requires a value`);
-      index += 1;
-      if (arg === "--db") {
-        db = resolve(value);
-        dbExplicit = true;
-      } else if (arg === "--limit") limit = parseInteger(value, "--limit", 1, 500);
-      else if (arg === "--port") port = parseInteger(value, "--port", 0, 65535);
-      else if (arg === "--max-age-days") maxAgeDays = parseInteger(value, arg, 1, 36500);
-      else maxBytes = parseInteger(value, arg, 1024 * 1024, Number.MAX_SAFE_INTEGER);
-    } else if (arg?.startsWith("--db=")) {
-      db = resolve(arg.slice(5));
-      dbExplicit = true;
-    } else if (arg?.startsWith("--limit=")) limit = parseInteger(arg.slice(8), "--limit", 1, 500);
-    else if (arg?.startsWith("--port=")) port = parseInteger(arg.slice(7), "--port", 0, 65535);
-    else if (arg?.startsWith("--max-age-days=")) maxAgeDays = parseInteger(arg.slice(15), "--max-age-days", 1, 36500);
-    else if (arg?.startsWith("--max-bytes="))
-      maxBytes = parseInteger(arg.slice(12), "--max-bytes", 1024 * 1024, Number.MAX_SAFE_INTEGER);
-    else if (arg?.startsWith("-")) throw new Error(`unknown trace flag: ${arg}`);
-    else if (arg !== void 0) positional.push(arg);
-  }
-  return { positional, db, dbExplicit, follow, limit, port, json, maxAgeDays, maxBytes };
-}
-var TRACE_COMMANDS = /* @__PURE__ */ new Set(["runs", "inspect", "phases", "tail", "procs", "code-steps", "prune", "sql", "ui"]);
-var TRACE_COMMANDS_NEEDING_RUN_ID = /* @__PURE__ */ new Set(["phases", "tail", "procs"]);
-function invocationError(command, runId) {
-  if (!TRACE_COMMANDS.has(command)) {
-    process.stderr.write(`unknown trace command: ${command}
-${HELP}`);
-    return 2;
-  }
-  if (TRACE_COMMANDS_NEEDING_RUN_ID.has(command) && !runId) return missingRunId(command);
-  if (command === "code-steps" && !runId) {
-    process.stderr.write("trace code-steps requires a fleet root id\n");
-    return 2;
-  }
-  return null;
-}
-async function runTraceCommand(args) {
-  if (args.includes("--help") || args.includes("-h")) {
-    process.stdout.write(HELP);
-    return 0;
-  }
-  let parsed;
-  try {
-    parsed = parseTraceArgs(args);
-  } catch (error) {
-    process.stderr.write(`${error instanceof Error ? error.message : String(error)}
-${HELP}`);
-    return 2;
-  }
-  const [command, runId] = parsed.positional;
-  if (!command || command === "help") {
-    process.stdout.write(HELP);
-    return command === "help" ? 0 : 2;
-  }
-  const sqlQuery = parsed.positional.slice(1).join(" ");
-  const usageError = invocationError(command, runId);
-  if (usageError !== null) return usageError;
-  if (command === "sql" && !sqlQuery) {
-    process.stderr.write("trace sql requires a SELECT query\n");
-    return 2;
-  }
-  if (command === "sql") {
-    try {
-      assertTraceSelectOnly(sqlQuery);
-    } catch (error) {
-      process.stderr.write(`${error instanceof Error ? error.message : String(error)}
-`);
-      return 2;
-    }
-  }
-  if (command === "ui") return runTraceUi(parsed.db, parsed.port);
-  if (command === "code-steps") return runTraceCodeSteps(runId ?? "", parsed.json);
-  if (command === "inspect") {
-    return runTraceInspect(
-      parsed.positional.length === 1 && parsed.json && !parsed.dbExplicit && !parsed.follow && parsed.limit === DEFAULT_TRACE_LIMIT && parsed.port === 0 && parsed.maxAgeDays === void 0 && parsed.maxBytes === void 0
-    );
-  }
-  if (!existsSync2(parsed.db)) return missingDatabase(parsed);
-  if (command === "prune") return runTracePrune(parsed);
-  let reader;
-  try {
-    reader = new TraceReader(parsed.db);
-  } catch (error) {
-    process.stderr.write(`trace database: ${error instanceof Error ? error.message : String(error)}
-`);
-    return 1;
-  }
-  try {
-    switch (command) {
-      case "runs": {
-        const rows = reader.runs(parsed.limit);
-        if (parsed.json) process.stdout.write(`${JSON.stringify(rows, jsonBigInt, 2)}
-`);
-        else printRuns(rows);
-        return 0;
-      }
-      case "phases":
-        printPhases(reader.phases(runId ?? ""));
-        return 0;
-      case "tail":
-        await tail(reader, runId ?? "", parsed.follow);
-        return 0;
-      case "procs":
-        printProcesses(reader.processes(runId ?? ""));
-        return 0;
-      case "sql": {
-        let rows;
-        try {
-          rows = reader.select(sqlQuery);
-        } catch (error) {
-          process.stderr.write(`${error instanceof Error ? error.message : String(error)}
-`);
-          return 2;
-        }
-        process.stdout.write(`${JSON.stringify(rows, jsonBigInt, 2)}
-`);
-        return 0;
-      }
-      default:
-        process.stderr.write(`unknown trace command: ${command}
-${HELP}`);
-        return 2;
-    }
-  } catch (error) {
-    process.stderr.write(`${error instanceof Error ? error.message : String(error)}
-`);
-    return 1;
-  } finally {
-    reader.close();
-  }
-}
-function runTraceCodeSteps(rootId, json) {
-  let records;
-  try {
-    records = readCodeStepRecords(rootId);
-  } catch (error) {
-    process.stderr.write(`code-step records: ${error instanceof Error ? error.message : String(error)}
-`);
-    return 1;
-  }
-  if (json) {
-    process.stdout.write(`${JSON.stringify(records, null, 2)}
-`);
-    return 0;
-  }
-  if (records.length === 0) {
-    process.stdout.write(
-      `no code-step records for fleet root ${rootId} under ${codeStepDir(rootId)}. a record is written when a fleet plan runs a deterministic code step.
-`
-    );
-    return 0;
-  }
-  process.stdout.write("EXIT  DURATION STARTED                  STEP                 COMMAND              ARGV\n");
-  for (const record of records) {
-    const exit = record.timedOut ? "timeout" : record.signal !== null ? `sig:${record.signal}` : String(record.exitCode);
-    process.stdout.write(
-      `${exit.padEnd(5)} ${`${record.durationMs}ms`.padStart(8)} ${record.startedAt.padEnd(24)} ${record.stepId.slice(0, 20).padEnd(20)} ${record.commandId.slice(0, 20).padEnd(20)} ${record.argv.join(" ")}
-`
-    );
-  }
-  return 0;
-}
-function runTracePrune(parsed) {
-  let policy;
-  try {
-    policy = resolveTraceRetentionPolicy({
-      ...parsed.maxAgeDays === void 0 ? {} : { maxAgeDays: parsed.maxAgeDays },
-      ...parsed.maxBytes === void 0 ? {} : { maxBytes: parsed.maxBytes }
-    });
-  } catch (error) {
-    process.stderr.write(`${error instanceof Error ? error.message : String(error)}
-`);
-    return 1;
-  }
-  let store;
-  try {
-    store = new TraceStore(parsed.db, { retention: policy });
-  } catch (error) {
-    process.stderr.write(`trace database: ${error instanceof Error ? error.message : String(error)}
-`);
-    return 1;
-  }
-  try {
-    const result = store.prune(policy);
-    if (parsed.json) {
-      process.stdout.write(`${JSON.stringify({ policy, ...result }, null, 2)}
-`);
-    } else {
-      process.stdout.write(
-        `trace prune: removed ${result.runsRemoved.toLocaleString("en-US")} runs and ${result.rowsRemoved.toLocaleString("en-US")} rows; reclaimed ${result.bytesRemoved.toLocaleString("en-US")} bytes; VACUUM ${result.vacuumed ? "ran" : "not needed"}; protected ${result.protectedRuns.toLocaleString("en-US")} live runs
-`
-      );
-    }
-    return 0;
-  } catch (error) {
-    process.stderr.write(`${error instanceof Error ? error.message : String(error)}
-`);
-    return 1;
-  } finally {
-    store.close();
-  }
-}
-async function tail(reader, runId, follow) {
-  let cursor = 0;
-  let idleTerminalPolls = 0;
-  for (; ; ) {
-    const rows = reader.events(runId, cursor, TRACE_EVENT_POLL_LIMIT);
-    for (const row of rows) {
-      process.stdout.write(`${formatEvent(row)}
-`);
-      cursor = Math.max(cursor, row.rowid);
-    }
-    if (!follow) return;
-    const status = reader.run(runId)?.status;
-    idleTerminalPolls = rows.length === 0 && status !== "queued" && status !== "running" ? idleTerminalPolls + 1 : 0;
-    if (idleTerminalPolls >= 2) return;
-    await new Promise((resolveWait) => setTimeout(resolveWait, 500));
-  }
-}
-function formatEvent(row) {
-  const duration = row.ended_at === null ? "" : ` ${Math.max(0, Date.parse(row.ended_at) - Date.parse(row.started_at))}ms`;
-  return `${row.rowid.toString().padStart(6)} ${row.started_at} ${row.type.padEnd(18)} ${row.name}${duration}`;
-}
-function printRuns(rows) {
-  process.stdout.write("STATUS   SOURCE   STARTED                      TOKENS       COST RUN\n");
-  for (const row of rows) {
-    process.stdout.write(
-      `${row.status.padEnd(8)} ${row.source.padEnd(8)} ${row.started_at.padEnd(28)} ${formatNumber(row.total_tokens).padStart(8)} ${formatCost(row.total_cost_usd).padStart(10)} ${row.run_id}
-`
-    );
-  }
-}
-function printPhases(rows) {
-  process.stdout.write("STATUS   TRY OWNER              TOKENS       COST PHASE\n");
-  for (const row of rows) {
-    process.stdout.write(
-      `${row.status.padEnd(8)} ${String(row.attempt + 1).padStart(3)} ${row.owner.slice(0, 18).padEnd(18)} ${formatNumber(row.total_tokens).padStart(8)} ${formatCost(row.total_cost_usd).padStart(10)} ${row.name}
-`
-    );
-  }
-}
-function printProcesses(rows) {
-  process.stdout.write("STATE  PID      KIND         NAME                 COMMAND\n");
-  for (const row of rows) {
-    process.stdout.write(
-      `${(row.ended_at === null ? "live" : "ended").padEnd(6)} ${String(row.pid).padEnd(8)} ${row.kind.padEnd(12)} ${row.name.slice(0, 20).padEnd(20)} ${row.command}
-`
-    );
-  }
-}
-async function runTraceUi(db, port) {
-  const candidates = [
-    fileURLToPath(new URL("../apps/trace-viewer/server.mjs", import.meta.url)),
-    fileURLToPath(new URL("../../apps/trace-viewer/server.mjs", import.meta.url))
-  ];
-  const entry = await firstExisting(candidates);
-  if (entry === null) {
-    process.stderr.write(
-      `trace viewer is available only from a source checkout; apps/trace-viewer/server.mjs was not found
-  the npm package does not carry the viewer, so an installed clio cannot start it
-  the same run is readable here: clio-coder trace runs --db ${db}
-  from a checkout of the repository: npm run trace:ui
-`
-    );
-    return 1;
-  }
-  const module = await import(pathToFileURL(entry).href);
-  const server = await module.startTraceViewer({ db, port });
-  process.stdout.write(`Trace viewer: ${server.url}
-`);
-  await new Promise((resolveStop) => {
-    const stop = () => {
-      process.off("SIGINT", stop);
-      process.off("SIGTERM", stop);
-      void server.close().finally(resolveStop);
-    };
-    process.on("SIGINT", stop);
-    process.on("SIGTERM", stop);
-  });
-  return 0;
-}
-async function firstExisting(paths) {
-  for (const path of paths) {
-    try {
-      await access(path);
-      return path;
-    } catch {
-    }
-  }
-  return null;
-}
-function parseInteger(value, flag, min, max) {
-  const parsed = Number(value);
-  if (!Number.isInteger(parsed) || parsed < min || parsed > max)
-    throw new Error(`${flag} must be an integer in [${min}, ${max}]`);
-  return parsed;
-}
-function missingDatabase(parsed) {
-  if (parsed.dbExplicit) {
-    process.stderr.write(
-      `trace database not found: ${parsed.db}
-  --db named this path. omit it to read the default at ${traceDatabasePath(clioStatePath())}
-`
-    );
-    return 1;
-  }
-  if (parsed.json && parsed.positional[0] === "runs") {
-    process.stdout.write("[]\n");
-    return 0;
-  }
-  if (parsed.json && parsed.positional[0] === "prune") {
-    let policy;
-    try {
-      policy = resolveTraceRetentionPolicy({
-        ...parsed.maxAgeDays === void 0 ? {} : { maxAgeDays: parsed.maxAgeDays },
-        ...parsed.maxBytes === void 0 ? {} : { maxBytes: parsed.maxBytes }
-      });
-    } catch (error) {
-      process.stderr.write(`${error instanceof Error ? error.message : String(error)}
-`);
-      return 1;
-    }
-    process.stdout.write(
-      `${JSON.stringify(
-        {
-          available: false,
-          policy,
-          runsRemoved: 0,
-          rowsRemoved: 0,
-          bytesRemoved: 0,
-          vacuumed: false,
-          protectedRuns: 0
-        },
-        null,
-        2
-      )}
-`
-    );
-    return 0;
-  }
-  process.stdout.write(
-    `no trace database yet at ${parsed.db}. rows are recorded when a dispatch executes or an interactive turn runs; run \`clio-coder run "<task>"\` or start a session to create one.
-`
-  );
-  return 0;
-}
-function missingRunId(command) {
-  process.stderr.write(`trace ${command} requires a run id
-`);
-  return 2;
-}
-function formatNumber(value) {
-  return value === null ? "\u2014" : value.toLocaleString("en-US");
-}
-function formatCost(value) {
-  return value === null ? "\u2014" : `$${value.toFixed(value < 0.01 ? 4 : 2)}`;
-}
-function jsonBigInt(_key, value) {
-  return typeof value === "bigint" ? value.toString() : value;
-}
-export {
-  runTraceCommand
-};
-//# sourceMappingURL=trace-JHLXWUMN.js.map

package/dist/tui-primitives-RCY2HN7G.js

@@ -1,17 +0,0 @@
-import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import {
-  ProcessTerminal,
-  TuiAltScreen,
-  truncateToWidth,
-  visibleWidth,
-  wrapTextWithAnsi
-} from "./chunk-QRFXEO6Y.js";
-import "./chunk-ECBHH7LU.js";
-export {
-  ProcessTerminal,
-  TuiAltScreen,
-  truncateToWidth,
-  visibleWidth,
-  wrapTextWithAnsi
-};
-//# sourceMappingURL=tui-primitives-RCY2HN7G.js.map