@unigent/cli 0.1.1

package/dist/tui.js

@@ -0,0 +1,63 @@
+import { jsx as _jsx } from "@opentui/react/jsx-runtime";
+import { isAbsolute, resolve } from "node:path";
+import process from "node:process";
+import { parseArgs } from "node:util";
+import { createCliRenderer } from "@opentui/core";
+import { createRoot } from "@opentui/react";
+import { detectScriptRuntime, runtimeInvocation } from "./script_runtime.js";
+import { App } from "./tui/app.js";
+import { createScriptRunner } from "./tui/runner.js";
+import { createTuiStore } from "./tui/store.js";
+import { paletteFor } from "./tui/theme.js";
+const THEME_QUERY_TIMEOUT_MILLISECONDS = 300;
+const TUI_ARGUMENTS = {
+    allowPositionals: true,
+    options: {
+        node: { type: "string" },
+        register: { type: "string" },
+        developmentLoader: { type: "string" },
+        theme: { type: "string" },
+    },
+};
+async function detectTheme(override, renderer) {
+    if (override === "light" || override === "dark") {
+        return override;
+    }
+    const detected = await Promise.race([
+        renderer.waitForThemeMode(),
+        new Promise((resolveTheme) => setTimeout(() => resolveTheme(undefined), THEME_QUERY_TIMEOUT_MILLISECONDS)),
+    ]);
+    return detected ?? "dark";
+}
+async function main() {
+    const { values, positionals } = parseArgs(TUI_ARGUMENTS);
+    const [source] = positionals;
+    if (source === undefined || values.node === undefined || values.register === undefined) {
+        throw new Error("unigent tui: internal launch arguments are incomplete");
+    }
+    const sourceFile = isAbsolute(source) ? source : resolve(process.cwd(), source);
+    const scriptArguments = positionals.slice(1);
+    const runtime = runtimeInvocation(await detectScriptRuntime(sourceFile), values.node);
+    const store = createTuiStore(sourceFile);
+    const renderer = await createCliRenderer({ useMouse: true, exitOnCtrlC: false, targetFps: 30 });
+    const theme = await detectTheme(values.theme, renderer);
+    renderer.setBackgroundColor(paletteFor(theme).background);
+    const runner = createScriptRunner({
+        runtime,
+        registerEntry: values.register,
+        developmentLoader: values.developmentLoader,
+        sourceFile,
+        scriptArguments,
+    }, store);
+    const quit = () => {
+        runner.dispose();
+        renderer.destroy();
+    };
+    createRoot(renderer).render(_jsx(App, { store: store, initialTheme: theme, onAbort: runner.abort, onRerun: runner.start, onQuit: quit }));
+    runner.start();
+}
+main().catch((error) => {
+    process.stderr.write(`unigent tui: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=tui.js.map

package/dist/tui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.js","sourceRoot":"","sources":["../src/tui.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAkB,MAAM,gBAAgB,CAAC;AAE5D,MAAM,gCAAgC,GAAG,GAAG,CAAC;AAE7C,MAAM,aAAa,GAAG;IACpB,gBAAgB,EAAE,IAAI;IACtB,OAAO,EAAE;QACP,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACrC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC1B;CACO,CAAC;AAEX,KAAK,UAAU,WAAW,CACxB,QAA4B,EAC5B,QAAuD;IAEvD,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QAChD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;QAClC,QAAQ,CAAC,gBAAgB,EAAE;QAC3B,IAAI,OAAO,CAAY,CAAC,YAAY,EAAE,EAAE,CACtC,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,gCAAgC,CAAC,CAC5E;KACF,CAAC,CAAC;IACH,OAAO,QAAQ,IAAI,MAAM,CAAC;AAC5B,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;IACzD,MAAM,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC;IAC7B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACvF,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAChF,MAAM,eAAe,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACtF,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;IAChG,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACxD,QAAQ,CAAC,kBAAkB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,kBAAkB,CAC/B;QACE,OAAO;QACP,aAAa,EAAE,MAAM,CAAC,QAAQ;QAC9B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,UAAU;QACV,eAAe;KAChB,EACD,KAAK,CACN,CAAC;IACF,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,QAAQ,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC,CAAC;IACF,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CACzB,KAAC,GAAG,IACF,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,KAAK,EACnB,OAAO,EAAE,MAAM,CAAC,KAAK,EACrB,OAAO,EAAE,MAAM,CAAC,KAAK,EACrB,MAAM,EAAE,IAAI,GACZ,CACH,CAAC;IACF,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjG,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC","sourcesContent":["import { isAbsolute, resolve } from \"node:path\";\nimport process from \"node:process\";\nimport { parseArgs } from \"node:util\";\nimport { createCliRenderer } from \"@opentui/core\";\nimport { createRoot } from \"@opentui/react\";\nimport { detectScriptRuntime, runtimeInvocation } from \"./script_runtime.js\";\nimport { App } from \"./tui/app.js\";\nimport { createScriptRunner } from \"./tui/runner.js\";\nimport { createTuiStore } from \"./tui/store.js\";\nimport { paletteFor, type ThemeMode } from \"./tui/theme.js\";\n\nconst THEME_QUERY_TIMEOUT_MILLISECONDS = 300;\n\nconst TUI_ARGUMENTS = {\n  allowPositionals: true,\n  options: {\n    node: { type: \"string\" },\n    register: { type: \"string\" },\n    developmentLoader: { type: \"string\" },\n    theme: { type: \"string\" },\n  },\n} as const;\n\nasync function detectTheme(\n  override: string | undefined,\n  renderer: Awaited<ReturnType<typeof createCliRenderer>>,\n): Promise<ThemeMode> {\n  if (override === \"light\" || override === \"dark\") {\n    return override;\n  }\n  const detected = await Promise.race([\n    renderer.waitForThemeMode(),\n    new Promise<undefined>((resolveTheme) =>\n      setTimeout(() => resolveTheme(undefined), THEME_QUERY_TIMEOUT_MILLISECONDS),\n    ),\n  ]);\n  return detected ?? \"dark\";\n}\n\nasync function main(): Promise<void> {\n  const { values, positionals } = parseArgs(TUI_ARGUMENTS);\n  const [source] = positionals;\n  if (source === undefined || values.node === undefined || values.register === undefined) {\n    throw new Error(\"unigent tui: internal launch arguments are incomplete\");\n  }\n  const sourceFile = isAbsolute(source) ? source : resolve(process.cwd(), source);\n  const scriptArguments = positionals.slice(1);\n  const runtime = runtimeInvocation(await detectScriptRuntime(sourceFile), values.node);\n  const store = createTuiStore(sourceFile);\n  const renderer = await createCliRenderer({ useMouse: true, exitOnCtrlC: false, targetFps: 30 });\n  const theme = await detectTheme(values.theme, renderer);\n  renderer.setBackgroundColor(paletteFor(theme).background);\n  const runner = createScriptRunner(\n    {\n      runtime,\n      registerEntry: values.register,\n      developmentLoader: values.developmentLoader,\n      sourceFile,\n      scriptArguments,\n    },\n    store,\n  );\n  const quit = (): void => {\n    runner.dispose();\n    renderer.destroy();\n  };\n  createRoot(renderer).render(\n    <App\n      store={store}\n      initialTheme={theme}\n      onAbort={runner.abort}\n      onRerun={runner.start}\n      onQuit={quit}\n    />,\n  );\n  runner.start();\n}\n\nmain().catch((error: unknown) => {\n  process.stderr.write(`unigent tui: ${error instanceof Error ? error.message : String(error)}\\n`);\n  process.exitCode = 1;\n});\n"]}

package/node_modules/@unigent/core/dist/adapter_process.d.ts

@@ -0,0 +1,25 @@
+/** Settlement metadata for a harness CLI child process. */
+interface AdapterProcessCompletion {
+    readonly exitCode: number | null;
+    readonly signal: NodeJS.Signals | null;
+}
+/** Harness CLI process with replay-safe diagnostics and explicit lifecycle control. */
+interface AdapterProcess {
+    readonly lines: AsyncIterable<string>;
+    readonly stderr: () => string;
+    readonly completion: Promise<AdapterProcessCompletion>;
+    readonly kill: () => void;
+}
+/** Complete launch request for a harness CLI child process. */
+interface AdapterProcessOptions {
+    readonly binary: string;
+    readonly args: readonly string[];
+    readonly signal: AbortSignal;
+    readonly stdin: string;
+    readonly environment: Readonly<Record<string, string>>;
+}
+/** Spawn one harness CLI with bounded stderr and a completion signal that waits for pipe closure. */
+declare function spawnAdapterProcess(options: AdapterProcessOptions): AdapterProcess;
+export type { AdapterProcess, AdapterProcessCompletion, AdapterProcessOptions };
+export { spawnAdapterProcess };
+//# sourceMappingURL=adapter_process.d.ts.map

package/node_modules/@unigent/core/dist/adapter_process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter_process.d.ts","sourceRoot":"","sources":["../src/adapter_process.ts"],"names":[],"mappings":"AAOA,2DAA2D;AAC3D,UAAU,wBAAwB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;CACxC;AAED,uFAAuF;AACvF,UAAU,cAAc;IACtB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,+DAA+D;AAC/D,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD;AAED,qGAAqG;AACrG,iBAAS,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAoC3E;AAED,YAAY,EAAE,cAAc,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/node_modules/@unigent/core/dist/adapter_process.js

@@ -0,0 +1,46 @@
+import { spawn } from "node:child_process";
+import process from "node:process";
+import { createInterface } from "node:readline";
+import { Readable } from "node:stream";
+const MAXIMUM_STDERR_CHARACTERS = 65_536;
+/** Spawn one harness CLI with bounded stderr and a completion signal that waits for pipe closure. */
+function spawnAdapterProcess(options) {
+    let child;
+    let stderr = "";
+    try {
+        child = spawn(options.binary, [...options.args], {
+            stdio: ["pipe", "pipe", "pipe"],
+            signal: options.signal,
+            // biome-ignore lint/style/noProcessEnv: child must inherit the authenticated CLI environment.
+            env: { ...process.env, ...options.environment },
+        });
+        child.stdin.end(options.stdin);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            lines: createInterface({ input: Readable.from([]) }),
+            stderr: () => message,
+            completion: Promise.resolve({ exitCode: null, signal: null }),
+            kill: () => undefined,
+        };
+    }
+    const appendStderr = (text) => {
+        stderr = `${stderr}${text}`.slice(-MAXIMUM_STDERR_CHARACTERS);
+    };
+    child.on("error", (error) => appendStderr(error.message));
+    child.stderr.on("data", (chunk) => appendStderr(chunk.toString()));
+    const completion = new Promise((resolve) => {
+        child.once("close", (exitCode, closeSignal) => resolve({ exitCode, signal: closeSignal }));
+    });
+    return {
+        lines: createInterface({ input: child.stdout }),
+        stderr: () => stderr,
+        completion,
+        kill: () => {
+            child.kill();
+        },
+    };
+}
+export { spawnAdapterProcess };
+//# sourceMappingURL=adapter_process.js.map

package/node_modules/@unigent/core/dist/adapter_process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter_process.js","sourceRoot":"","sources":["../src/adapter_process.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAiB,MAAM,aAAa,CAAC;AAEtD,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAyBzC,qGAAqG;AACrG,SAAS,mBAAmB,CAAC,OAA8B;IACzD,IAAI,KAAwD,CAAC;IAC7D,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,CAAC;QACH,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE;YAC/C,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,8FAA8F;YAC9F,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE;SAChD,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO;YACL,KAAK,EAAE,eAAe,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACpD,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO;YACrB,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YAC7D,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;SACtB,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,GAAG,CAAC,IAAY,EAAQ,EAAE;QAC1C,MAAM,GAAG,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,yBAAyB,CAAC,CAAC;IAChE,CAAC,CAAC;IACF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,IAAI,OAAO,CAA2B,CAAC,OAAO,EAAE,EAAE;QACnE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;IACH,OAAO;QACL,KAAK,EAAE,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;QAC/C,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM;QACpB,UAAU;QACV,IAAI,EAAE,GAAS,EAAE;YACf,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC;AAGD,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/node_modules/@unigent/core/dist/args.d.ts

@@ -0,0 +1,17 @@
+import { type OutputSchema } from "./schema.js";
+type InputPair = readonly [string, string | boolean];
+interface ArgsOptions {
+    /** One-line explanation shown before usage. */
+    readonly description?: string;
+    /** Arguments appended to the detected script name in usage output. */
+    readonly usage?: string;
+}
+/** Parse an explicit argv array as typed named arguments or scalar positional input. */
+declare function parseArgs(arguments_: readonly string[]): Promise<Record<string, unknown>>;
+declare function parseArgs<Output>(arguments_: readonly string[], schema: OutputSchema<Output>): Promise<Output>;
+/** Parse `process.argv`, print standardized help/errors, and exit when no value can be returned. */
+declare function args(options?: ArgsOptions): Promise<Record<string, unknown>>;
+declare function args<Output>(schema: OutputSchema<Output>, options?: ArgsOptions): Promise<Output>;
+export type { ArgsOptions, InputPair };
+export { args, parseArgs };
+//# sourceMappingURL=args.d.ts.map

package/node_modules/@unigent/core/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAe,MAAM,aAAa,CAAC;AAE7D,KAAK,SAAS,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;AACrD,UAAU,WAAW;IACnB,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,sEAAsE;IACtE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAwMD,wFAAwF;AACxF,iBAAe,SAAS,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1F,iBAAe,SAAS,CAAC,MAAM,EAC7B,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,GAC3B,OAAO,CAAC,MAAM,CAAC,CAAC;AAiDnB,oGAAoG;AACpG,iBAAe,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC7E,iBAAe,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAyBlG,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC"}

package/node_modules/@unigent/core/dist/args.js

@@ -0,0 +1,233 @@
+import { basename } from "node:path";
+import process from "node:process";
+import { AgentInputError } from "./errors.js";
+import { parseSchema } from "./schema.js";
+const NEGATION_PREFIX = "no-";
+const UNSAFE_PATH_SEGMENTS = new Set([
+    "__proto__",
+    "constructor",
+    "prototype",
+]);
+function flagPair(name, inline, next) {
+    if (name.length === 0) {
+        throw new AgentInputError("argument names must not be empty");
+    }
+    if (name.startsWith(NEGATION_PREFIX) && inline === undefined) {
+        return { pair: [name.slice(NEGATION_PREFIX.length), false], consumedNext: false };
+    }
+    if (inline !== undefined) {
+        return { pair: [name, inline], consumedNext: false };
+    }
+    if (next === undefined || next.startsWith("--")) {
+        return { pair: [name, true], consumedNext: false };
+    }
+    return { pair: [name, next], consumedNext: true };
+}
+function pairsFromArguments(arguments_) {
+    const pairs = [];
+    let index = 0;
+    while (index < arguments_.length) {
+        const token = arguments_[index] ?? "";
+        if (token === "--") {
+            index += 1;
+            continue;
+        }
+        if (!token.startsWith("--")) {
+            throw new AgentInputError(`unexpected positional argument: ${token}`);
+        }
+        const equals = token.indexOf("=");
+        const name = equals < 0 ? token.slice(2) : token.slice(2, equals);
+        const inline = equals < 0 ? undefined : token.slice(equals + 1);
+        const parsed = flagPair(name, inline, arguments_[index + 1]);
+        pairs.push(parsed.pair);
+        index += parsed.consumedNext ? 2 : 1;
+    }
+    return pairs;
+}
+function coerceScalar(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed === null || typeof parsed === "number" || typeof parsed === "boolean") {
+            return parsed;
+        }
+    }
+    catch {
+        // Non-JSON scalars remain strings.
+    }
+    return raw;
+}
+async function parsePositional(arguments_, schema) {
+    const named = arguments_.find((token) => token.startsWith("--"));
+    if (named !== undefined) {
+        throw new AgentInputError(`cannot mix positional input with named argument: ${named}`);
+    }
+    const raw = arguments_.join(" ");
+    const coerced = coerceScalar(raw);
+    const coercedResult = await schema["~standard"].validate(coerced);
+    if (coercedResult.issues === undefined) {
+        return coercedResult.value;
+    }
+    if (!Object.is(coerced, raw)) {
+        const rawResult = await schema["~standard"].validate(raw);
+        if (rawResult.issues === undefined) {
+            return rawResult.value;
+        }
+    }
+    const parsed = await parseSchema(schema, raw);
+    throw new AgentInputError(parsed.error ?? "positional script input is invalid");
+}
+function pathSegments(path) {
+    const segments = path.split(".");
+    if (segments.some((segment) => segment.length === 0 || UNSAFE_PATH_SEGMENTS.has(segment))) {
+        throw new AgentInputError(`unsafe or empty argument path: ${path}`);
+    }
+    return segments;
+}
+function readContainer(container, key) {
+    return Array.isArray(container) ? container[Number(key)] : container[key];
+}
+function writeContainer(container, key, value) {
+    if (Array.isArray(container)) {
+        container[Number(key)] = value;
+    }
+    else {
+        container[key] = value;
+    }
+}
+function isInputContainer(value) {
+    return typeof value === "object" && value !== null;
+}
+function setPath(root, path, value) {
+    let cursor = root;
+    for (const segment of path.slice(0, -1)) {
+        const existing = readContainer(cursor, segment);
+        if (existing !== undefined && !isInputContainer(existing)) {
+            throw new AgentInputError(`argument path conflicts at ${path.join(".")}`);
+        }
+        const next = existing ?? {};
+        writeContainer(cursor, segment, next);
+        cursor = next;
+    }
+    writeContainer(cursor, path.at(-1) ?? "", value);
+}
+function getPath(root, path) {
+    let cursor = root;
+    for (const segment of path) {
+        if (!isInputContainer(cursor)) {
+            return;
+        }
+        cursor = readContainer(cursor, segment);
+    }
+    return cursor;
+}
+function assemble(pairs, coerce) {
+    const grouped = new Map();
+    for (const [name, value] of pairs) {
+        const values = grouped.get(name);
+        if (values === undefined) {
+            grouped.set(name, [value]);
+        }
+        else {
+            values.push(value);
+        }
+    }
+    const root = {};
+    const convert = (value) => coerce && typeof value === "string" ? coerceScalar(value) : value;
+    for (const [name, values] of grouped) {
+        const value = values.length === 1 ? convert(values[0] ?? "") : values.map(convert);
+        setPath(root, pathSegments(name), value);
+    }
+    return root;
+}
+function issuePath(path) {
+    if (!Array.isArray(path)) {
+        return [];
+    }
+    return path.map((segment) => typeof segment === "object" && segment !== null && "key" in segment
+        ? String(segment.key)
+        : String(segment));
+}
+async function uncoerceRejectedFields(schema, candidate, raw, pairCount) {
+    for (let attempt = 0; attempt <= pairCount; attempt += 1) {
+        const result = await schema["~standard"].validate(candidate);
+        if (result.issues === undefined) {
+            return result.value;
+        }
+        let changed = false;
+        for (const issue of result.issues) {
+            const path = issuePath(issue.path);
+            if (path.length === 0) {
+                continue;
+            }
+            const current = getPath(candidate, path);
+            const original = getPath(raw, path);
+            if (typeof original === "string" && current !== original) {
+                setPath(candidate, path, original);
+                changed = true;
+            }
+        }
+        if (!changed) {
+            break;
+        }
+    }
+    const parsed = await parseSchema(schema, candidate);
+    throw new AgentInputError(parsed.error ?? "script arguments are invalid");
+}
+async function parseArgs(arguments_, schema) {
+    const normalized = arguments_[0] === "--" ? arguments_.slice(1) : arguments_;
+    if (normalized.length === 0 && schema !== undefined) {
+        const emptyNamedResult = await schema["~standard"].validate({});
+        if (emptyNamedResult.issues === undefined) {
+            return emptyNamedResult.value;
+        }
+        if (emptyNamedResult.issues.every((issue) => issuePath(issue.path).length === 0)) {
+            return await parsePositional(normalized, schema);
+        }
+    }
+    const [first] = normalized;
+    if (first !== undefined && !first.startsWith("--")) {
+        if (schema === undefined) {
+            throw new AgentInputError(`unexpected positional argument: ${first}`);
+        }
+        return await parsePositional(normalized, schema);
+    }
+    const pairs = pairsFromArguments(normalized);
+    const candidate = assemble(pairs, true);
+    if (schema === undefined) {
+        return candidate;
+    }
+    return await uncoerceRejectedFields(schema, candidate, assemble(pairs, false), pairs.length);
+}
+function argsHelp(options) {
+    const [, scriptPath] = process.argv;
+    const scriptName = basename(scriptPath ?? "script");
+    const usage = options.usage ?? "[arguments]";
+    const description = options.description === undefined ? "" : `${options.description}\n\n`;
+    return `${description}Usage: ${scriptName} ${usage}\n`;
+}
+function exitWithArgsMessage(message, code, stream) {
+    stream.write(message);
+    process.exit(code);
+}
+function isOutputSchema(value) {
+    return value !== undefined && "~standard" in value;
+}
+async function args(schemaOrOptions, suppliedOptions = {}) {
+    const schema = isOutputSchema(schemaOrOptions) ? schemaOrOptions : undefined;
+    const options = isOutputSchema(schemaOrOptions) ? suppliedOptions : (schemaOrOptions ?? {});
+    const arguments_ = process.argv.slice(2);
+    if (arguments_.includes("--help") || arguments_.includes("-h")) {
+        return exitWithArgsMessage(argsHelp(options), 0, process.stdout);
+    }
+    try {
+        return schema === undefined ? await parseArgs(arguments_) : await parseArgs(arguments_, schema);
+    }
+    catch (error) {
+        if (error instanceof AgentInputError) {
+            return exitWithArgsMessage(`unigent: ${error.message}\n\n${argsHelp(options)}`, 1, process.stderr);
+        }
+        throw error;
+    }
+}
+export { args, parseArgs };
+//# sourceMappingURL=args.js.map

package/node_modules/@unigent/core/dist/args.js.map

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

package/node_modules/@unigent/core/dist/backend.d.ts

@@ -0,0 +1,83 @@
+/** JSON Schema advertised to an agent backend. */
+export type JsonSchema = Readonly<Record<string, unknown>>;
+/** Result returned by a tool to the backend-owned agent loop. */
+export interface BackendToolResult {
+    readonly content: string;
+    readonly isError: boolean;
+    readonly terminate?: boolean;
+}
+/** Backend-neutral tool definition. */
+export interface BackendTool {
+    readonly name: string;
+    readonly description: string;
+    readonly promptSnippet?: string;
+    readonly promptGuidelines?: readonly string[];
+    readonly parameters: JsonSchema;
+    readonly execute: (input: unknown) => Promise<BackendToolResult>;
+}
+/** Raw usage reported by one backend turn. */
+export interface BackendUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly totalTokens: number;
+    readonly cachedInputTokens?: number;
+    readonly reasoningTokens?: number;
+    readonly costUsd?: number;
+}
+/** Normalized incremental events emitted by a backend. */
+export type BackendEvent = {
+    readonly type: "text";
+    readonly text: string;
+} | {
+    readonly type: "reasoning";
+    readonly text: string;
+} | {
+    readonly type: "tool_call";
+    readonly callId: string;
+    readonly name: string;
+    readonly input: unknown;
+} | {
+    readonly type: "tool_result";
+    readonly callId: string;
+    readonly name: string;
+    readonly output: unknown;
+    readonly isError: boolean;
+};
+/** Request for one backend-owned agent turn. */
+export interface BackendTurnRequest {
+    readonly systemPrompt: string;
+    readonly systemPromptMode: "append" | "replace";
+    readonly prompt: string;
+    readonly tools: readonly BackendTool[];
+    readonly thinking?: string;
+    readonly signal: AbortSignal;
+    readonly onEvent: (event: BackendEvent) => void;
+}
+/** Settled backend turn. */
+export interface BackendTurnResult {
+    readonly text: string;
+    readonly usage: BackendUsage;
+}
+/** One stateful backend conversation. */
+export interface BackendSession {
+    readonly runTurn: (request: BackendTurnRequest) => Promise<BackendTurnResult>;
+    readonly fork?: () => BackendSession;
+}
+/** Configuration fixed when a backend conversation opens. */
+export interface BackendSessionOptions {
+    readonly model: string;
+}
+/** Capabilities whose absence must reject dependent Unigent configuration. */
+export interface BackendCapabilities {
+    readonly reportsCost: boolean;
+    readonly supportsSessionFork: boolean;
+}
+/** Universal port implemented by Pi, Claude CLI, and future backends. */
+export interface Backend {
+    readonly name: string;
+    /** Stable adapter configuration identity included in checkpoint fingerprints. */
+    readonly checkpointKey?: string;
+    readonly capabilities: BackendCapabilities;
+    readonly openSession: (options: BackendSessionOptions) => BackendSession | Promise<BackendSession>;
+}
+//# sourceMappingURL=backend.d.ts.map

package/node_modules/@unigent/core/dist/backend.d.ts.map

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

package/node_modules/@unigent/core/dist/backend.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=backend.js.map

package/node_modules/@unigent/core/dist/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":""}

package/node_modules/@unigent/core/dist/checkpoint.d.ts

@@ -0,0 +1,26 @@
+import type { AgentUsage } from "./usage.js";
+/** Serializable output retained for one successful stateless run. */
+type CheckpointValue = {
+    readonly kind: "output";
+    readonly value: unknown;
+} | {
+    readonly kind: "done";
+};
+/** One successful stateless run retained for restart and live deduplication. */
+interface CheckpointRecord {
+    readonly version: 1;
+    readonly value: CheckpointValue;
+    readonly usage: AgentUsage;
+}
+/** Content-addressed checkpoint boundary. */
+interface CheckpointStore {
+    readonly get: (key: string) => CheckpointRecord | undefined | Promise<CheckpointRecord | undefined>;
+    readonly set: (key: string, record: CheckpointRecord) => void | Promise<void>;
+}
+/** Create an ephemeral checkpoint store. */
+declare function createMemoryCheckpointStore(): CheckpointStore;
+/** Create a crash-tolerant JSONL checkpoint store. */
+declare function createFileCheckpointStore(filePath: string): CheckpointStore;
+export type { CheckpointRecord, CheckpointStore, CheckpointValue };
+export { createFileCheckpointStore, createMemoryCheckpointStore };
+//# sourceMappingURL=checkpoint.d.ts.map

package/node_modules/@unigent/core/dist/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../src/checkpoint.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,qEAAqE;AACrE,KAAK,eAAe,GAChB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9B,gFAAgF;AAChF,UAAU,gBAAgB;IACxB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,6CAA6C;AAC7C,UAAU,eAAe;IACvB,QAAQ,CAAC,GAAG,EAAE,CACZ,GAAG,EAAE,MAAM,KACR,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IAC1E,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/E;AAwED,4CAA4C;AAC5C,iBAAS,2BAA2B,IAAI,eAAe,CAQtD;AAED,sDAAsD;AACtD,iBAAS,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CA6BpE;AAED,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,CAAC"}