@garygentry/system1-core 0.1.0

package/dist/tools/ask.js

@@ -0,0 +1,59 @@
+import { DecisionsError } from "../errors.js";
+import { prepare } from "../prepare.js";
+import { matches } from "../project/project.js";
+import { checkInput, deciderFor, resolveRequest } from "./context.js";
+import { summariseSkipped } from "./many.js";
+/** One state, one question set, one call. The shape hooks and scripts want. */
+export async function runAsk(ctx, rawInput) {
+    const input = checkInput("ask", rawInput);
+    const req = resolveRequest(ctx, input);
+    const prepared = await prepare({
+        sources: req.sources,
+        split: req.split,
+        questions: req.questions,
+        profile: req.profile,
+        cwd: ctx.config.repoRoot,
+        exclude: ctx.config.egress.exclude,
+        ...(input.allowOutside ? { allowOutside: true } : {}),
+    });
+    const [item, ...rest] = prepared.items;
+    if (!item || rest.length > 0) {
+        const withheld = prepared.skipped.length
+            ? ` (${prepared.skipped.length} withheld: ${prepared.skipped.map((s) => `${s.path} ${s.reason}`).join(", ")})`
+            : "";
+        throw new DecisionsError("invalid-request", item
+            ? `ask needs exactly one state, but the source gave ${prepared.items.length}. Use \`decide many\` to fan out.`
+            : `The source gave nothing to ask about${withheld}.`, { items: prepared.items.length });
+    }
+    const result = await deciderFor(ctx, req.profile, input.mode ?? "auto").decide({
+        state: item.state,
+        questions: req.questions,
+        namespace: req.namespace,
+    });
+    let verdict;
+    if (req.keep.length > 0) {
+        const referenced = new Set(req.keep.map((f) => f.question));
+        verdict = result.undecided.some((q) => referenced.has(q))
+            ? "undecided"
+            : req.keep.every((f) => matches(result.answers, f))
+                ? "kept"
+                : "dropped";
+    }
+    return {
+        ...(req.spec ? { spec: req.spec.name } : {}),
+        id: item.id,
+        ...(item.path ? { path: item.path } : {}),
+        ...(item.lines ? { lines: item.lines } : {}),
+        source: result.source,
+        model: result.model,
+        servedBy: result.servedBy,
+        answers: result.answers,
+        undecided: result.undecided,
+        ...(verdict ? { verdict } : {}),
+        usage: result.usage,
+        latencyMs: result.latencyMs,
+        skipped: summariseSkipped(prepared.skipped),
+        redactions: { total: prepared.redactions.total, items: prepared.redactions.items },
+    };
+}
+//# sourceMappingURL=ask.js.map

package/dist/tools/ask.js.map

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

package/dist/tools/context.d.ts

@@ -0,0 +1,52 @@
+import { type ResolvedConfig } from "../config/load.js";
+import { type DecideMode, type Decider } from "../decide.js";
+import { type ModelProfile } from "../model/profiles.js";
+import type { QuestionSet } from "../model/types.js";
+import { parseFilter, parseSort } from "../project/project.js";
+import { SpendLedger } from "../run/spend.js";
+import type { SourceSpec } from "../sources/types.js";
+import { type Spec, type SpecDirs } from "../spec/spec.js";
+import { type SplitSpec } from "../split/split.js";
+import { type ToolName } from "./schemas.js";
+/** Everything a tool needs, resolved once per invocation. */
+export interface ToolContext {
+    cwd: string;
+    config: ResolvedConfig;
+    specDirs: SpecDirs;
+    fetch?: typeof fetch;
+}
+export interface ContextOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    home?: string;
+    /** Specs shipped with the plugin/CLI. */
+    bundledSpecs?: string;
+    fetch?: typeof fetch;
+}
+export declare function createContext(options?: ContextOptions): ToolContext;
+/** Validate tool input against its schema, reporting every problem. */
+export declare function checkInput<T>(tool: ToolName, input: unknown): T;
+export interface Resolved {
+    spec?: Spec;
+    namespace: string;
+    questions: QuestionSet;
+    sources: SourceSpec[];
+    split: SplitSpec;
+    keep: ReturnType<typeof parseFilter>[];
+    sort?: ReturnType<typeof parseSort>;
+    profile: ModelProfile;
+}
+/** Merge a spec's defaults with explicit input. Explicit input wins; inline questions and a spec conflict. */
+export declare function resolveRequest(ctx: ToolContext, input: {
+    spec?: string;
+    questions?: Record<string, unknown>;
+    sources?: SourceSpec[];
+    split?: string;
+    keep?: string[];
+    sort?: string;
+    model?: string;
+}): Resolved;
+/** A decider wired to this context's config: transport only with a key, consent from the repo. */
+export declare function deciderFor(ctx: ToolContext, profile: ModelProfile, mode?: DecideMode): Decider;
+export declare function ledgerFor(ctx: ToolContext): SpendLedger;
+//# sourceMappingURL=context.d.ts.map

package/dist/tools/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,cAAc,EAGpB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAiB,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAG3E,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,sBAAsB,CAAA;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAY,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAY,MAAM,iBAAiB,CAAA;AAC9E,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE9D,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAA;AAE1D,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,cAAc,CAAA;IACtB,QAAQ,EAAE,QAAQ,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,WAAW,CAWvE;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAa/D;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,WAAW,CAAA;IACtB,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,KAAK,EAAE,SAAS,CAAA;IAChB,IAAI,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,EAAE,CAAA;IACtC,IAAI,CAAC,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,CAAA;IACnC,OAAO,EAAE,YAAY,CAAA;CACtB;AAED,8GAA8G;AAC9G,wBAAgB,cAAc,CAC5B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IACL,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GACA,QAAQ,CAoCV;AAsCD,kGAAkG;AAClG,wBAAgB,UAAU,CACxB,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,YAAY,EACrB,IAAI,GAAE,UAAmB,GACxB,OAAO,CAsBT;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CAEvD"}

package/dist/tools/context.js

@@ -0,0 +1,130 @@
+import { isAbsolute, join, relative } from "node:path";
+import { Value } from "typebox/value";
+import { allProfiles, loadConfig, stateDir, userConfigDir, } from "../config/load.js";
+import { createDecider } from "../decide.js";
+import { DecisionsError } from "../errors.js";
+import { FixtureStore } from "../fixtures/store.js";
+import { resolveProfile } from "../model/profiles.js";
+import { parseFilter, parseSort } from "../project/project.js";
+import { SpendLedger } from "../run/spend.js";
+import { loadSpec, specDirs } from "../spec/spec.js";
+import { parseSplit } from "../split/split.js";
+import { createOpenRouterTransport } from "../transport/openrouter.js";
+import { TOOL_SCHEMAS } from "./schemas.js";
+export function createContext(options = {}) {
+    const env = options.env ?? process.env;
+    const cwd = options.cwd ?? process.cwd();
+    const config = loadConfig({ cwd, env, ...(options.home ? { home: options.home } : {}) });
+    const bundled = env.SYSTEM1_SPECS_PATH?.trim() || options.bundledSpecs;
+    return {
+        cwd,
+        config,
+        specDirs: specDirs(config.repoRoot, userConfigDir(env, options.home), bundled),
+        ...(options.fetch ? { fetch: options.fetch } : {}),
+    };
+}
+/** Validate tool input against its schema, reporting every problem. */
+export function checkInput(tool, input) {
+    const schema = TOOL_SCHEMAS[tool];
+    const problems = [...Value.Errors(schema, input)].map((e) => `${e.instancePath || "/"} ${e.message}`);
+    if (problems.length > 0) {
+        throw new DecisionsError("invalid-request", `Invalid ${tool} input:\n  ${problems.join("\n  ")}`, { problems });
+    }
+    return input;
+}
+/** Merge a spec's defaults with explicit input. Explicit input wins; inline questions and a spec conflict. */
+export function resolveRequest(ctx, input) {
+    if (input.spec && input.questions) {
+        throw new DecisionsError("invalid-request", "Give either a spec or inline questions, not both");
+    }
+    const spec = input.spec ? loadSpec(input.spec, ctx.specDirs, ctx.cwd) : undefined;
+    const questions = (spec?.questions ?? input.questions);
+    if (!questions) {
+        throw new DecisionsError("invalid-request", "No questions: pass --spec <name>, --question, or --input with questions");
+    }
+    // Paths typed on the command line mean what the shell means by them; a
+    // spec's own defaults stay anchored to the repo, wherever it is run from.
+    const sources = input.sources?.length
+        ? input.sources.map((source) => rebase(source, ctx.cwd, ctx.config.repoRoot))
+        : specSources(spec);
+    if (sources.length === 0) {
+        throw new DecisionsError("invalid-request", "No source: pass --glob, --file, --jsonl, --diff, --text or --stdin (or use a spec with a source)");
+    }
+    const keepText = input.keep ?? spec?.keep ?? [];
+    const sortText = input.sort ?? spec?.sort;
+    const profile = resolveProfile(input.model ?? ctx.config.model, allProfiles(ctx.config));
+    return {
+        ...(spec ? { spec } : {}),
+        namespace: spec?.name ?? "adhoc",
+        questions,
+        sources,
+        split: parseSplit(input.split ?? spec?.source?.split ?? "file"),
+        keep: keepText.map((k) => parseFilter(k, questions)),
+        ...(sortText ? { sort: parseSort(sortText, questions) } : {}),
+        profile,
+    };
+}
+/**
+ * Re-anchor a source given on the command line from the invocation directory
+ * to the repo root, which is what the reader resolves against. Without this,
+ * `decide many --file a.ts` in `src/` reads `<repo>/a.ts`.
+ */
+function rebase(source, cwd, repoRoot) {
+    const prefix = relative(repoRoot, cwd);
+    if (prefix === "" || prefix.startsWith("..") || isAbsolute(prefix))
+        return source;
+    const move = (path) => (isAbsolute(path) ? path : join(prefix, path));
+    switch (source.kind) {
+        case "file":
+            return { ...source, path: move(source.path) };
+        case "jsonl":
+            return { ...source, path: move(source.path) };
+        case "glob":
+            return { ...source, patterns: source.patterns.map(move) };
+        case "diff":
+            return source.paths ? { ...source, paths: source.paths.map(move) } : source;
+        default:
+            return source;
+    }
+}
+function specSources(spec) {
+    const s = spec?.source;
+    if (!s)
+        return [];
+    return [
+        ...(s.glob ? [{ kind: "glob", patterns: s.glob }] : []),
+        ...(s.file ? [{ kind: "file", path: s.file }] : []),
+        ...(s.jsonl ? [{ kind: "jsonl", path: s.jsonl }] : []),
+        ...(s.diff !== undefined
+            ? [{ kind: "diff", ...(s.diff ? { range: s.diff } : {}) }]
+            : []),
+    ];
+}
+/** A decider wired to this context's config: transport only with a key, consent from the repo. */
+export function deciderFor(ctx, profile, mode = "auto") {
+    const { config } = ctx;
+    const dir = stateDir(config.repoRoot);
+    return createDecider({
+        profile,
+        egressConsent: config.egress.consent.granted,
+        repoRoot: config.repoRoot,
+        ...(config.apiKey
+            ? {
+                transport: createOpenRouterTransport({
+                    endpoint: config.endpoint,
+                    apiKey: config.apiKey,
+                    timeoutMs: config.timeoutMs,
+                    ...(ctx.fetch ? { fetch: ctx.fetch } : {}),
+                }),
+            }
+            : {}),
+        fixtures: new FixtureStore(join(dir, "fixtures")),
+        ledger: new SpendLedger(join(dir, "usage.jsonl")),
+        mode: config.replay ? "replay" : mode,
+        ...(config.session ? { session: config.session } : {}),
+    });
+}
+export function ledgerFor(ctx) {
+    return new SpendLedger(join(stateDir(ctx.config.repoRoot), "usage.jsonl"));
+}
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

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

package/dist/tools/doctor.d.ts

@@ -0,0 +1,37 @@
+import { type Harness } from "../config/session.js";
+import { type ContextOptions } from "./context.js";
+export type CheckStatus = "ok" | "warn" | "fail";
+export interface DoctorCheck {
+    name: "cli" | "config" | "path" | "path-version" | "key" | "consent" | "network";
+    status: CheckStatus;
+    detail: string;
+    /** What the user (not the agent) can do about a warn or fail. */
+    fix?: string;
+}
+export interface DoctorResult {
+    /** False when any check failed; warnings alone keep it true. */
+    healthy: boolean;
+    /** Whether a live decision would be sent: key, consent, network, and replay not forced. */
+    live: boolean;
+    harness: Harness | null;
+    session: string | null;
+    version: string;
+    node: string;
+    checks: DoctorCheck[];
+}
+export interface DoctorOptions extends ContextOptions {
+    env: NodeJS.ProcessEnv;
+    /** The script that is running, for the report. */
+    cliPath?: string;
+    /**
+     * Reads the version of the `decide` found on PATH (the CLI runs it with
+     * `version`). Injected so the engine itself never spawns anything but git
+     * (0014). Without it the `path-version` check is skipped.
+     */
+    probeVersion?: (path: string) => Promise<string | undefined>;
+}
+export declare const CODEX_RULE = "prefix_rule(pattern = [\"decide\"], decision = \"allow\")";
+export declare function runDoctor(options: DoctorOptions): Promise<DoctorResult>;
+/** The first executable file `name` on `path`, like `command -v`. */
+export declare function which(name: string, path: string): string | undefined;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/tools/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/tools/doctor.ts"],"names":[],"mappings":"AAUA,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAGlE,OAAO,EAAE,KAAK,cAAc,EAAmC,MAAM,cAAc,CAAA;AAEnF,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;AAEhD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,cAAc,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAA;IAChF,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAA;IAChB,2FAA2F;IAC3F,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,WAAW,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;IACtB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CAC7D;AAED,eAAO,MAAM,UAAU,8DAA0D,CAAA;AAEjF,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAwG7E;AAwFD,qEAAqE;AACrE,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUpE"}

package/dist/tools/doctor.js

@@ -0,0 +1,203 @@
+/**
+ * `doctor`: is `decide` usable from this shell, and if not, the exact fix for
+ * the harness running it. Read-only: it never writes a rule, a config file or
+ * an install. Those need the user's consent and belong to `setup`.
+ *
+ * Unlike the other tools it builds its own context: a broken config is one of
+ * the things it diagnoses, so it must not fail before it can report it.
+ */
+import { accessSync, constants, statSync } from "node:fs";
+import { delimiter, join } from "node:path";
+import { detectHarness } from "../config/session.js";
+import { ping } from "../ping.js";
+import { CLI_PACKAGE, VERSION } from "../version.js";
+import { createContext } from "./context.js";
+export const CODEX_RULE = 'prefix_rule(pattern = ["decide"], decision = "allow")';
+export async function runDoctor(options) {
+    const { env } = options;
+    const harness = detectHarness(env) ?? null;
+    const checks = [
+        {
+            name: "cli",
+            status: "ok",
+            detail: `decide ${VERSION} on node ${process.version}${options.cliPath ? ` (${options.cliPath})` : ""}`,
+        },
+        pathCheck(harness, env),
+    ];
+    const onPath = which("decide", env.PATH ?? "");
+    if (onPath && options.probeVersion) {
+        checks.push(await versionCheck(onPath, options.probeVersion, env));
+    }
+    const report = (ctx, live) => ({
+        healthy: !checks.some((c) => c.status === "fail"),
+        live,
+        harness,
+        session: ctx?.config.session ?? null,
+        version: VERSION,
+        node: process.version,
+        checks,
+    });
+    let ctx;
+    try {
+        ctx = createContext(options);
+    }
+    catch (error) {
+        checks.push({
+            name: "config",
+            status: "fail",
+            detail: error instanceof Error ? error.message : String(error),
+            fix: "correct the config file or environment variable named above",
+        });
+        return report(undefined, false);
+    }
+    const { config } = ctx;
+    checks.push(config.apiKey
+        ? { name: "key", status: "ok", detail: `OPENROUTER_API_KEY present (${config.apiKeySource})` }
+        : {
+            name: "key",
+            status: "warn",
+            detail: "no API key: only replay works",
+            fix: "set OPENROUTER_API_KEY, or write `openrouter_api_key: <key>` to ~/.config/system1/credentials (chmod 600)",
+        });
+    checks.push(config.egress.consent.granted
+        ? { name: "consent", status: "ok", detail: `egress consent granted for ${config.repoRoot}` }
+        : {
+            name: "consent",
+            status: "warn",
+            detail: `no egress consent for ${config.repoRoot}: live calls are refused`,
+            fix: "the user runs `decide config egress allow` in this repo, if they agree",
+        });
+    let reach;
+    try {
+        reach = await ping({
+            endpoint: config.endpoint,
+            model: config.model,
+            apiKey: config.apiKey,
+            replay: config.replay,
+        }, ctx.fetch ? { fetch: ctx.fetch } : {});
+    }
+    catch (error) {
+        // An endpoint that is not a URL at all.
+        checks.push({
+            name: "config",
+            status: "fail",
+            detail: `endpoint ${config.endpoint}: ${error instanceof Error ? error.message : String(error)}`,
+            fix: "correct SYSTEM1_ENDPOINT or `endpoint` in the config file",
+        });
+        return report(ctx, false);
+    }
+    if (reach.ok) {
+        checks.push({
+            name: "network",
+            status: "ok",
+            detail: `${config.model} reachable in ${reach.latencyMs} ms`,
+        });
+    }
+    else {
+        const sandboxed = env.CODEX_SANDBOX_NETWORK_DISABLED === "1";
+        checks.push({
+            name: "network",
+            // Replay needs no network, so an unreachable endpoint only warns there.
+            status: config.replay ? "warn" : "fail",
+            detail: `${reach.probe}: ${reach.error ?? "unreachable"}${sandboxed ? " (Codex sandbox has network disabled)" : ""}`,
+            fix: networkFix(reach.httpStatus, harness, sandboxed, env),
+        });
+    }
+    const live = !config.replay &&
+        config.apiKey !== undefined &&
+        config.egress.consent.granted &&
+        reach.ok === true;
+    return report(ctx, live);
+}
+function pathCheck(harness, env) {
+    const onPath = which("decide", env.PATH ?? "");
+    if (onPath)
+        return { name: "path", status: "ok", detail: `decide on PATH: ${onPath}` };
+    if (harness === "claude") {
+        return {
+            name: "path",
+            status: "warn",
+            detail: "decide is not on PATH, so the decisions plugin's bin/ is not loaded",
+            fix: "install the decisions plugin from its marketplace, or start Claude Code with `--plugin-dir <checkout>/plugins/system1`",
+        };
+    }
+    return {
+        name: "path",
+        status: "warn",
+        detail: "decide is not on PATH. Codex and Pi do not add plugin bin/ to PATH",
+        fix: `npm i -g ${CLI_PACKAGE}@${VERSION}`,
+    };
+}
+async function versionCheck(path, probe, env) {
+    let raw;
+    try {
+        raw = await probe(path);
+    }
+    catch { }
+    const found = raw?.trim() || undefined;
+    // Measured with Codex 0.152: inside its Linux sandbox, a child process that
+    // node spawns exits 0 with empty stdout (even `node -e "console.log(1)"`), so
+    // nothing can be learned there. Say so rather than warn about a false problem.
+    if (raw !== undefined && found === undefined && env.CODEX_SANDBOX_NETWORK_DISABLED === "1") {
+        return {
+            name: "path-version",
+            status: "ok",
+            detail: "not checked: the Codex sandbox hides a child process's output",
+        };
+    }
+    if (found === undefined) {
+        return {
+            name: "path-version",
+            status: "warn",
+            detail: `could not read the version of ${path}`,
+            fix: `run \`${path} version\` to see why; reinstall it if it fails`,
+        };
+    }
+    if (found === VERSION) {
+        return {
+            name: "path-version",
+            status: "ok",
+            detail: `decide on PATH is ${found}, same as this one`,
+        };
+    }
+    return {
+        name: "path-version",
+        status: "warn",
+        detail: `decide on PATH is ${found}, but this one is ${VERSION}: agents will run the one on PATH`,
+        fix: `npm i -g ${CLI_PACKAGE}@${VERSION}, or remove the other decide (${path})`,
+    };
+}
+function networkFix(httpStatus, harness, sandboxed, env) {
+    // An HTTP answer means the network works; the problem is what was asked for.
+    if (httpStatus === 404)
+        return "the endpoint does not know this model: check SYSTEM1_MODEL / `model` and SYSTEM1_ENDPOINT / `endpoint`";
+    if (httpStatus !== undefined && httpStatus >= 500)
+        return `the provider answered HTTP ${httpStatus}: retry later`;
+    if (httpStatus !== undefined)
+        return `the endpoint answered HTTP ${httpStatus}: check SYSTEM1_ENDPOINT / \`endpoint\``;
+    // Only a sandboxed Codex shell gets the rule: outside the sandbox (or with
+    // the rule applied) a failure is an ordinary network problem. The flag also
+    // beats the nesting heuristic (Codex inside Pi looks like Pi).
+    if (sandboxed) {
+        return `add \`${CODEX_RULE}\` to ${env.CODEX_HOME?.trim() || "~/.codex"}/rules/system1.rules, then restart Codex (it covers commands that start with decide; a pipe into decide stays offline)`;
+    }
+    if (harness === "claude")
+        return "allow outbound access to openrouter.ai in Claude Code's sandbox settings";
+    return "check that this machine can reach openrouter.ai (proxy, firewall, DNS)";
+}
+/** The first executable file `name` on `path`, like `command -v`. */
+export function which(name, path) {
+    for (const dir of path.split(delimiter)) {
+        if (!dir)
+            continue;
+        const candidate = join(dir, name);
+        try {
+            accessSync(candidate, constants.X_OK);
+            if (statSync(candidate).isFile())
+                return candidate;
+        }
+        catch { }
+    }
+    return undefined;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/tools/doctor.js.map

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

package/dist/tools/many.d.ts

@@ -0,0 +1,74 @@
+import { type ErrorCode } from "../errors.js";
+import type { Answers, Usage } from "../model/types.js";
+import { type Projection } from "../run/budget.js";
+import { type AnswerSource } from "../run/spend.js";
+import type { LineRange, Skipped } from "../sources/types.js";
+import { type ToolContext } from "./context.js";
+export interface ResultRow {
+    id: string;
+    path?: string;
+    lines?: LineRange;
+    /**
+     * The start of the (scrubbed) text, for items whose id doesn't lead back to
+     * it: piped items, and single lines such as grep hits split by row.
+     */
+    excerpt?: string;
+    /**
+     * Answers of this row that came back too flat to act on. Present on kept
+     * rows too: a question the projection didn't act on can still be undecided,
+     * and hiding that would overstate the result.
+     */
+    undecided?: string[];
+    answers: Answers;
+}
+export interface SkippedSummary {
+    total: number;
+    byReason: Partial<Record<Skipped["reason"], number>>;
+    /** The first few, so the agent can see what kind of thing was withheld. */
+    sample: Skipped[];
+}
+export interface ManyResult {
+    dryRun: boolean;
+    spec?: string;
+    model: string;
+    /** How answers were produced: every item in one run shares the decider's mode. */
+    source?: AnswerSource;
+    counts: {
+        items: number;
+        kept: number;
+        /** Kept before `limit`. */
+        keptTotal: number;
+        undecided: number;
+        dropped: number;
+        failed: number;
+        skipped: number;
+    };
+    kept: ResultRow[];
+    /** Too flat to judge: read these yourself, or ask a human. */
+    undecided: Array<ResultRow & {
+        questions: string[];
+    }>;
+    failed: Array<{
+        id: string;
+        code: ErrorCode | "error";
+        message: string;
+    }>;
+    skipped: SkippedSummary;
+    redactions: {
+        total: number;
+        items: number;
+    };
+    /** Measured. Zero on a dry run or a replay. */
+    usage: Usage;
+    projection: Projection;
+    wallClockMs: number;
+    /** Present on a dry run: the first item ids that would be sent. */
+    sampleIds?: string[];
+}
+/**
+ * Fan-out: one question set over N items, each its own call, under the
+ * concurrency cap. Only what survives `keep` comes back in full.
+ */
+export declare function runMany(ctx: ToolContext, rawInput: unknown): Promise<ManyResult>;
+export declare function summariseSkipped(skipped: readonly Skipped[]): SkippedSummary;
+//# sourceMappingURL=many.d.ts.map

package/dist/tools/many.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"many.d.ts","sourceRoot":"","sources":["../../src/tools/many.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAGvD,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE/D,OAAO,EAAE,KAAK,YAAY,EAAY,MAAM,iBAAiB,CAAA;AAC7D,OAAO,KAAK,EAAQ,SAAS,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAA0C,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAGvF,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,OAAO,EAAE,OAAO,CAAA;CACjB;AAID,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;IACpD,2EAA2E;IAC3E,MAAM,EAAE,OAAO,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,kFAAkF;IAClF,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,2BAA2B;QAC3B,SAAS,EAAE,MAAM,CAAA;QACjB,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,IAAI,EAAE,SAAS,EAAE,CAAA;IACjB,8DAA8D;IAC9D,SAAS,EAAE,KAAK,CAAC,SAAS,GAAG;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IACrD,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACzE,OAAO,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C,+CAA+C;IAC/C,KAAK,EAAE,KAAK,CAAA;IACZ,UAAU,EAAE,UAAU,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAID;;;GAGG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAuGtF;AAyCD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,cAAc,CAQ5E"}