@intentic/agent-cli 1.304.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Artur Kurowski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,37 @@
+# @intentic/agent-cli
+
+The promise an agent-facing CLI makes — capsule first, content to a budget, errors you cannot mistake for silence — held in one place for the three tools that make it.
+
+`iq` (code), `fileq` (workspace files) and `webq` (the web) are three answers to one question: *the thing I need
+is in a format I cannot read, give me the part that fits.* They were written months apart, each one's entry file
+copied from the last, and the copies had already drifted in the way copies do — three spellings of "read my own
+version", two hand-rolled parsers beside the one their shared dependency ships, one inline token estimate beside
+the shared one it was supposed to use.
+
+What lives here is only the part all three must answer the same way:
+
+- **The process contract** ([src/run.ts](src/run.ts)). EPIPE is a clean stop, not a crash — an agent pipes into
+  `head`. Errors go to **stdout**, because `<tool> … 2>/dev/null` is a reflex and a failure routed to stderr
+  reads as an empty answer. The app loads through a thunk so a broken module graph dies as a sentence naming the
+  install, not as a stack the same reflex swallows. Exit codes are 0 content / 1 none / 2 anything else.
+- **The output shape** ([src/output.ts](src/output.ts)). One capsule line, one `note:` per caveat, then content
+  cut on a line boundary with a trailer naming the budget it hit and the file holding the rest. A body that
+  stops mid-thought with no trailer is the failure mode this exists to prevent.
+- **The rest of the floor**: one XDG home per tool ([src/env.ts](src/env.ts)), one version resolver that finds
+  the manifest by walking to it ([src/version.ts](src/version.ts)), one non-negative parser for counts and
+  budgets ([src/flags.ts](src/flags.ts)), one in-process test seam ([src/testing.ts](src/testing.ts)).
+
+What does **not** live here is everything that makes the three tools different: iq's grep-dialect absorption and
+fusion budgets, fileq's sidecars and derivers, webq's cache, pruning and crawls. The shell takes a `name` and a
+`noun` and nothing else about what the tool does.
+
+## Key files
+
+- [src/run.ts](src/run.ts) — the process contract; the one file a `cli.ts` is allowed to import statically, and
+  `run.test.ts` fails if it ever grows a runtime import of its own.
+- [src/output.ts](src/output.ts) — the capsule line and the budget cut, including the trailer that keeps a
+  clipped answer from reading as a whole one.
+- [src/env.ts](src/env.ts) — `<NAME>_HOME` → `XDG_CACHE_HOME` → `~/.cache/<name>`, and the shared `out` leaf.
+- [src/flags.ts](src/flags.ts) — the count parser, and why stricli's own is not it.
+- [src/testing.ts](src/testing.ts) — runs an app through the same `run` seam `cli.ts` uses, capturing stdout: no
+  build artifact, no child process.

package/dist/env.d.ts

@@ -0,0 +1,3 @@
+export declare const toolHome: (name: string) => string;
+export declare const toolOutDir: (name: string) => string;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,QAAQ,SAAU,MAAM,KAAG,MAOvC,CAAC;AAGF,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,MAAqC,CAAC"}

package/dist/env.js

@@ -0,0 +1,12 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const toolHome = (name) => {
+    const explicit = process.env[`${name.toUpperCase()}_HOME`];
+    if (explicit !== undefined && explicit !== "") {
+        return explicit;
+    }
+    const xdg = process.env["XDG_CACHE_HOME"];
+    return join(xdg !== undefined && xdg !== "" ? xdg : join(homedir(), ".cache"), name);
+};
+export const toolOutDir = (name) => join(toolHome(name), "out");
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE;IAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC3D,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;QAC5C,OAAO,QAAQ,CAAC;IACpB,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;AACzF,CAAC,CAAC;AAGF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC"}

package/dist/flags.d.ts

@@ -0,0 +1,2 @@
+export declare const countParser: (raw: string) => number;
+//# sourceMappingURL=flags.d.ts.map

package/dist/flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../src/flags.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,WAAW,QAAS,MAAM,KAAG,MAMzC,CAAC"}

package/dist/flags.js

@@ -0,0 +1,8 @@
+export const countParser = (raw) => {
+    const value = Number(raw);
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error(`expected a non-negative number, got "${raw}"`);
+    }
+    return value;
+};
+//# sourceMappingURL=flags.js.map

package/dist/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../src/flags.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAU,EAAE;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,wCAAwC,GAAG,GAAG,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC"}

package/dist/output.d.ts

@@ -0,0 +1,3 @@
+export declare const capsule: (name: string, fields: readonly string[], notes?: readonly string[]) => string;
+export declare const clip: (markdown: string, budgetTokens: number, path: string, noun: string) => string;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,OAAO,SAAU,MAAM,UAAU,SAAS,MAAM,EAAE,UAAS,SAAS,MAAM,EAAE,KAAQ,MACT,CAAC;AAMzF,eAAO,MAAM,IAAI,aAAc,MAAM,gBAAgB,MAAM,QAAQ,MAAM,QAAQ,MAAM,KAAG,MASzF,CAAC"}

package/dist/output.js

@@ -0,0 +1,12 @@
+import { estimateTokens } from "@intentic/base/format";
+export const capsule = (name, fields, notes = []) => `${name}: ${fields.join(" · ")}\n${notes.map((note) => `note: ${note}\n`).join("")}`;
+export const clip = (markdown, budgetTokens, path, noun) => {
+    const total = estimateTokens(markdown);
+    if (total <= budgetTokens) {
+        return markdown;
+    }
+    const cut = markdown.slice(0, budgetTokens * 4);
+    const atLine = cut.slice(0, cut.lastIndexOf("\n") + 1);
+    return `${atLine}\n[cut at ${budgetTokens} of ${total} tokens: Read ${path} for the whole ${noun}]\n`;
+};
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,MAAyB,EAAE,KAAK,GAAsB,EAAE,EAAU,EAAE,CACtG,GAAG,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AAMzF,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,QAAgB,EAAE,YAAoB,EAAE,IAAY,EAAE,IAAY,EAAU,EAAE;IAC/F,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,KAAK,IAAI,YAAY,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,OAAO,GAAG,MAAM,aAAa,YAAY,OAAO,KAAK,iBAAiB,IAAI,kBAAkB,IAAI,KAAK,CAAC;AAC1G,CAAC,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,16 @@
+import type { Application, CommandContext } from "@stricli/core";
+export interface LoadedCli {
+    readonly app: Application<CommandContext>;
+    readonly prepareArgv?: (raw: readonly string[]) => {
+        readonly argv: string[];
+        readonly lines: readonly string[];
+    };
+}
+export interface AgentCliOptions {
+    readonly name: string;
+    readonly noun: string;
+    readonly load: () => Promise<LoadedCli>;
+    readonly rewriteStderr?: (text: string) => string | undefined;
+}
+export declare const runAgentCli: (options: AgentCliOptions) => Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAkB,MAAM,eAAe,CAAC;AAEjF,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IAK1C,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,KAAK;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;CACrH;AAED,MAAM,WAAW,eAAe;IAE5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAKtB,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;IAExC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACjE;AA+CD,eAAO,MAAM,WAAW,YAAmB,eAAe,KAAG,OAAO,CAAC,IAAI,CAqBxE,CAAC"}

package/dist/run.js

@@ -0,0 +1,50 @@
+const exitOnBrokenPipe = () => {
+    process.stdout.on("error", (error) => {
+        if (error.code === "EPIPE") {
+            process.exit(typeof process.exitCode === "number" ? process.exitCode : 0);
+        }
+        throw error;
+    });
+};
+const errorsToStdout = (rewrite) => {
+    const emit = process.stdout.write.bind(process.stdout);
+    process.stderr.write = ((chunk, ...rest) => {
+        if (rewrite === undefined) {
+            return emit(chunk, ...rest);
+        }
+        const text = typeof chunk === "string" ? chunk : Buffer.from(chunk).toString();
+        return emit(rewrite(text) ?? chunk, ...rest);
+    });
+};
+const startFault = (name, noun, error) => {
+    const detail = error instanceof Error ? error.message.split("\n")[0] : String(error);
+    return (`${name}: cannot start, ${detail}\n` +
+        `${name}: this is a broken install, NOT an empty ${noun}. Do not read it as zero hits or fall back to ` +
+        `another tool silently. Reinstall ${name} (or rebuild its workspace deps) and report it.\n`);
+};
+const clampExitCode = () => {
+    if (process.exitCode !== undefined && process.exitCode !== 0 && process.exitCode !== 1) {
+        process.exitCode = 2;
+    }
+};
+export const runAgentCli = async (options) => {
+    exitOnBrokenPipe();
+    errorsToStdout(options.rewriteStderr);
+    const raw = process.argv.slice(2);
+    let cli;
+    try {
+        const [core, loaded] = await Promise.all([import("@stricli/core"), options.load()]);
+        cli = { run: core.run, loaded };
+    }
+    catch (error) {
+        process.stdout.write(startFault(options.name, options.noun, error));
+        process.exit(2);
+    }
+    const prepared = cli.loaded.prepareArgv?.(raw) ?? { argv: raw, lines: [] };
+    for (const line of prepared.lines) {
+        process.stdout.write(`${options.name}: ${line}\n`);
+    }
+    await cli.run(cli.loaded.app, prepared.argv, { process: process });
+    clampExitCode();
+};
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

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

package/dist/testing.d.ts

@@ -0,0 +1,8 @@
+import { type Application, type CommandContext } from "@stricli/core";
+export interface CliOutcome {
+    readonly out: string;
+    readonly err: string;
+    readonly exitCode: number;
+}
+export declare const captureCli: (app: Application<CommandContext>, args: readonly string[]) => Promise<CliOutcome>;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAA4B,MAAM,eAAe,CAAC;AAEhG,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B;AASD,eAAO,MAAM,UAAU,QAAe,WAAW,CAAC,cAAc,CAAC,QAAQ,SAAS,MAAM,EAAE,KAAG,OAAO,CAAC,UAAU,CAuB9G,CAAC"}

package/dist/testing.js

@@ -0,0 +1,28 @@
+import { run } from "@stricli/core";
+const text = (chunk) => (typeof chunk === "string" ? chunk : Buffer.from(chunk).toString());
+export const captureCli = async (app, args) => {
+    let out = "";
+    let err = "";
+    const streams = { stdout: process.stdout.write, stderr: process.stderr.write };
+    process.stdout.write = ((chunk) => {
+        out += text(chunk);
+        return true;
+    });
+    process.stderr.write = ((chunk) => {
+        err += text(chunk);
+        return true;
+    });
+    const previous = process.exitCode;
+    process.exitCode = undefined;
+    try {
+        await run(app, args, { process: process });
+        const code = typeof process.exitCode === "number" ? process.exitCode : 0;
+        return { out, err, exitCode: code !== 0 && code !== 1 ? 2 : code };
+    }
+    finally {
+        process.stdout.write = streams.stdout;
+        process.stderr.write = streams.stderr;
+        process.exitCode = previous;
+    }
+};
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AACA,OAAO,EAAyC,GAAG,EAAuB,MAAM,eAAe,CAAC;AAShG,MAAM,IAAI,GAAG,CAAC,KAA0B,EAAU,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;AAOzH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,GAAgC,EAAE,IAAuB,EAAuB,EAAE;IAC/G,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC/E,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,KAA0B,EAAW,EAAE;QAC5D,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC,CAAgC,CAAC;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,KAA0B,EAAW,EAAE;QAC5D,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC,CAAgC,CAAC;IAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC7B,IAAI,CAAC;QACD,MAAM,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,OAAyB,EAAE,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvE,CAAC;YAAS,CAAC;QACP,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;QACtC,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAChC,CAAC;AACL,CAAC,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const packageVersion: (from: string) => string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,cAAc,SAAU,MAAM,KAAG,MAAuG,CAAC"}

package/dist/version.js

@@ -0,0 +1,5 @@
+import { createRequire } from "node:module";
+import { join } from "node:path";
+import { packageRoot } from "@intentic/constants/node";
+export const packageVersion = (from) => createRequire(from)(join(packageRoot(from), "package.json")).version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAMvD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAU,EAAE,CAAE,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,CAAyB,CAAC,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,107 @@
+{
+  "name": "@intentic/agent-cli",
+  "version": "1.304.0",
+  "description": "The process contract, budgeted output and test seam every agent-facing CLI in this repo keeps",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intentic/intentic.git",
+    "directory": "_tools/agent-cli"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": {
+    "./run": {
+      "types": "./dist/run.d.ts",
+      "import": {
+        "@intentic/src": "./src/run.ts",
+        "default": "./dist/run.js"
+      },
+      "require": {
+        "@intentic/src": "./src/run.ts",
+        "default": "./dist/run.js"
+      }
+    },
+    "./output": {
+      "types": "./dist/output.d.ts",
+      "import": {
+        "@intentic/src": "./src/output.ts",
+        "default": "./dist/output.js"
+      },
+      "require": {
+        "@intentic/src": "./src/output.ts",
+        "default": "./dist/output.js"
+      }
+    },
+    "./env": {
+      "types": "./dist/env.d.ts",
+      "import": {
+        "@intentic/src": "./src/env.ts",
+        "default": "./dist/env.js"
+      },
+      "require": {
+        "@intentic/src": "./src/env.ts",
+        "default": "./dist/env.js"
+      }
+    },
+    "./flags": {
+      "types": "./dist/flags.d.ts",
+      "import": {
+        "@intentic/src": "./src/flags.ts",
+        "default": "./dist/flags.js"
+      },
+      "require": {
+        "@intentic/src": "./src/flags.ts",
+        "default": "./dist/flags.js"
+      }
+    },
+    "./version": {
+      "types": "./dist/version.d.ts",
+      "import": {
+        "@intentic/src": "./src/version.ts",
+        "default": "./dist/version.js"
+      },
+      "require": {
+        "@intentic/src": "./src/version.ts",
+        "default": "./dist/version.js"
+      }
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": {
+        "@intentic/src": "./src/testing.ts",
+        "default": "./dist/testing.js"
+      },
+      "require": {
+        "@intentic/src": "./src/testing.ts",
+        "default": "./dist/testing.js"
+      }
+    }
+  },
+  "dependencies": {
+    "@intentic/base": "1.304.0",
+    "@intentic/constants": "1.304.0",
+    "@stricli/core": "1.3.0",
+    "tslib": "2.8.1"
+  },
+  "devDependencies": {
+    "@intentic/testing": "0.0.0",
+    "@intentic/tsconfig": "0.0.0",
+    "@types/node": "24.13.2",
+    "@typescript/native-preview": "7.0.0-dev.20260707.2",
+    "vitest": "4.1.10"
+  },
+  "scripts": {
+    "build": "tsgo",
+    "typecheck": "tsgo --noEmit -p tsconfig.test.json",
+    "watch": "tsgo --build --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}