@namzu/cli 0.0.3 → 0.1.0

package/dist/index.d.ts

@@ -7,4 +7,10 @@ export { createDoctorRegistry, doctor, DoctorRegistry, registerDoctorCheck, runD
 export type { RunDoctorOptions } from './doctor/registry.js';
 export { builtInDoctorChecks, cwdWritableCheck, providersRegisteredCheck, sandboxPlatformCheck, telemetryInstalledCheck, tmpdirWritableCheck, vaultRegisteredCheck, } from './doctor/checks/index.js';
 export { runDoctorCommand } from './commands/doctor.js';
+export { runCli, type RunCliOptions } from './cli.js';
+export type { CommandContext, CommandDef, CommandHandler, CommandHandlerArgs, } from './commands/types.js';
+export { registerAll, registerCommand, type RegisterOptions, } from './commands/registry.js';
+export { createFormatter, type FormatName, type Formatter, type FormatterOptions, isFormatName, } from './output/index.js';
+export { loadConfig, type LoadConfigOptions } from './config/load.js';
+export { DEFAULT_CONFIG, type NamzuCliConfig } from './config/schema.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,oBAAoB,EACpB,MAAM,EACN,cAAc,EACd,mBAAmB,EACnB,SAAS,GACT,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,OAAO,EACN,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACN,oBAAoB,EACpB,MAAM,EACN,cAAc,EACd,mBAAmB,EACnB,SAAS,GACT,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,OAAO,EACN,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAGvD,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAA;AACrD,YAAY,EACX,cAAc,EACd,UAAU,EACV,cAAc,EACd,kBAAkB,GAClB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACN,WAAW,EACX,eAAe,EACf,KAAK,eAAe,GACpB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACN,eAAe,EACf,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,YAAY,GACZ,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -3,7 +3,14 @@
  * invoke runDoctor() in their own process so app-registered checks are
  * visible. The standalone CLI binary lives at ./bin.ts.
  */
+// Doctor library API (pre-M0; preserved for embedded consumers).
 export { createDoctorRegistry, doctor, DoctorRegistry, registerDoctorCheck, runDoctor, } from './doctor/registry.js';
 export { builtInDoctorChecks, cwdWritableCheck, providersRegisteredCheck, sandboxPlatformCheck, telemetryInstalledCheck, tmpdirWritableCheck, vaultRegisteredCheck, } from './doctor/checks/index.js';
 export { runDoctorCommand } from './commands/doctor.js';
+// Shell + extension surface for the CLI.
+export { runCli } from './cli.js';
+export { registerAll, registerCommand, } from './commands/registry.js';
+export { createFormatter, isFormatName, } from './output/index.js';
+export { loadConfig } from './config/load.js';
+export { DEFAULT_CONFIG } from './config/schema.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,oBAAoB,EACpB,MAAM,EACN,cAAc,EACd,mBAAmB,EACnB,SAAS,GACT,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACN,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iEAAiE;AACjE,OAAO,EACN,oBAAoB,EACpB,MAAM,EACN,cAAc,EACd,mBAAmB,EACnB,SAAS,GACT,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACN,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAEvD,yCAAyC;AACzC,OAAO,EAAE,MAAM,EAAsB,MAAM,UAAU,CAAA;AAOrD,OAAO,EACN,WAAW,EACX,eAAe,GAEf,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACN,eAAe,EAIf,YAAY,GACZ,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,UAAU,EAA0B,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,cAAc,EAAuB,MAAM,oBAAoB,CAAA"}

package/dist/integrations/clawtool/agents.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Client for clawtool's `GET /v1/agents` — the authoritative registry of
+ * which AI-coding-agent instances clawtool can dispatch to on this host.
+ *
+ * Namzu does NOT reimplement credential detection, OAuth scanning, or
+ * bridge wiring. Clawtool already owns all of that. The TUI just renders
+ * what this endpoint returns.
+ */
+import { type EnsureDaemonOptions } from './daemon.js';
+export interface Agent {
+    readonly instance: string;
+    readonly family: string;
+    readonly bridge?: string;
+    /** `"callable" | "bridge-missing" | "binary-missing" | "disabled"` per clawtool's supervisor. */
+    readonly status: string;
+    readonly callable: boolean;
+    readonly auth_scope?: string;
+    readonly tags?: readonly string[];
+    readonly failover_to?: readonly string[];
+    readonly sandbox?: string;
+}
+export interface ListAgentsOptions extends EnsureDaemonOptions {
+    /** When true, server-side filter to `status=callable`. */
+    readonly callableOnly?: boolean;
+}
+export interface AgentsResponse {
+    readonly agents: readonly Agent[];
+    readonly count: number;
+}
+export declare function listAgents(opts?: ListAgentsOptions): Promise<readonly Agent[]>;
+//# sourceMappingURL=agents.d.ts.map

package/dist/integrations/clawtool/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/integrations/clawtool/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,mBAAmB,EAAgB,MAAM,aAAa,CAAA;AAEpE,MAAM,WAAW,KAAK;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,iGAAiG;IACjG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC7D,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACtB;AAED,wBAAsB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC,CAoBxF"}

package/dist/integrations/clawtool/agents.js

@@ -0,0 +1,30 @@
+/**
+ * Client for clawtool's `GET /v1/agents` — the authoritative registry of
+ * which AI-coding-agent instances clawtool can dispatch to on this host.
+ *
+ * Namzu does NOT reimplement credential detection, OAuth scanning, or
+ * bridge wiring. Clawtool already owns all of that. The TUI just renders
+ * what this endpoint returns.
+ */
+import { ensureDaemon } from './daemon.js';
+export async function listAgents(opts = {}) {
+    const endpoint = await ensureDaemon(opts);
+    const fetchFn = opts.fetch ?? globalThis.fetch;
+    const url = new URL('/v1/agents', endpoint.baseUrl);
+    if (opts.callableOnly)
+        url.searchParams.set('status', 'callable');
+    const headers = {};
+    if (endpoint.token.length > 0) {
+        headers.Authorization = `Bearer ${endpoint.token}`;
+    }
+    const res = await fetchFn(url.toString(), { method: 'GET', headers });
+    if (!res.ok) {
+        throw new Error(`clawtool GET /v1/agents failed: HTTP ${res.status}`);
+    }
+    const data = (await res.json());
+    if (!data || !Array.isArray(data.agents)) {
+        throw new Error('clawtool /v1/agents returned an unexpected shape');
+    }
+    return data.agents;
+}
+//# sourceMappingURL=agents.js.map

package/dist/integrations/clawtool/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../src/integrations/clawtool/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA4B,YAAY,EAAE,MAAM,aAAa,CAAA;AAyBpE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA0B,EAAE;IAC5D,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAA;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAA;IAC9C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IACnD,IAAI,IAAI,CAAC,YAAY;QAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;IAEjE,MAAM,OAAO,GAA2B,EAAE,CAAA;IAC1C,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,aAAa,GAAG,UAAU,QAAQ,CAAC,KAAK,EAAE,CAAA;IACnD,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IACrE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,wCAAwC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;IACtE,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAA;IAC1D,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAA;AACnB,CAAC"}

package/dist/integrations/clawtool/agents.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agents.test.d.ts.map

package/dist/integrations/clawtool/agents.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.test.d.ts","sourceRoot":"","sources":["../../../src/integrations/clawtool/agents.test.ts"],"names":[],"mappings":""}

package/dist/integrations/clawtool/agents.test.js

@@ -0,0 +1,79 @@
+import { describe, expect, it, vi } from 'vitest';
+import { listAgents } from './agents.js';
+function makeAgentsResponse(agents) {
+    return new Response(JSON.stringify({ agents, count: agents.length }), {
+        status: 200,
+        headers: { 'content-type': 'application/json' },
+    });
+}
+describe('listAgents', () => {
+    it('hits /v1/agents and returns the agents array', async () => {
+        const fetchMock = vi.fn().mockResolvedValue(makeAgentsResponse([
+            { instance: 'claude', family: 'claude', status: 'callable', callable: true },
+            {
+                instance: 'codex',
+                family: 'codex',
+                bridge: 'codex-bridge',
+                status: 'callable',
+                callable: true,
+            },
+        ]));
+        const agents = await listAgents({
+            endpoint: 'http://localhost:9999',
+            token: 'tok',
+            fetch: fetchMock,
+        });
+        expect(agents.length).toBe(2);
+        expect(agents[0]?.instance).toBe('claude');
+        // Without callableOnly the URL has no query string.
+        const url = fetchMock.mock.calls[0]?.[0];
+        expect(url).toBe('http://localhost:9999/v1/agents');
+    });
+    it('passes ?status=callable when callableOnly is set', async () => {
+        const fetchMock = vi.fn().mockResolvedValue(makeAgentsResponse([]));
+        await listAgents({
+            endpoint: 'http://localhost:9999',
+            token: 'tok',
+            fetch: fetchMock,
+            callableOnly: true,
+        });
+        const url = fetchMock.mock.calls[0]?.[0];
+        expect(url).toBe('http://localhost:9999/v1/agents?status=callable');
+    });
+    it('includes the Bearer header when a token is provided', async () => {
+        const fetchMock = vi.fn().mockResolvedValue(makeAgentsResponse([]));
+        await listAgents({
+            endpoint: 'http://localhost:9999',
+            token: 'tok-abc',
+            fetch: fetchMock,
+        });
+        const headers = fetchMock.mock.calls[0]?.[1]?.headers;
+        expect(headers.Authorization).toBe('Bearer tok-abc');
+    });
+    it('omits the Bearer header when the token is empty (no-auth daemon)', async () => {
+        const fetchMock = vi.fn().mockResolvedValue(makeAgentsResponse([]));
+        await listAgents({
+            endpoint: 'http://localhost:9999',
+            token: '',
+            fetch: fetchMock,
+        });
+        const headers = fetchMock.mock.calls[0]?.[1]?.headers;
+        expect(headers.Authorization).toBeUndefined();
+    });
+    it('throws when the response is non-2xx', async () => {
+        const fetchMock = vi.fn().mockResolvedValue(new Response('', { status: 500 }));
+        await expect(listAgents({
+            endpoint: 'http://localhost:9999',
+            token: '',
+            fetch: fetchMock,
+        })).rejects.toThrow(/HTTP 500/);
+    });
+    it('throws when the response body shape is unexpected', async () => {
+        const fetchMock = vi.fn().mockResolvedValue(new Response(JSON.stringify({ not: 'agents' }), {
+            status: 200,
+            headers: { 'content-type': 'application/json' },
+        }));
+        await expect(listAgents({ endpoint: 'http://localhost:9999', token: '', fetch: fetchMock })).rejects.toThrow(/unexpected shape/);
+    });
+});
+//# sourceMappingURL=agents.test.js.map

package/dist/integrations/clawtool/agents.test.js.map

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

package/dist/integrations/clawtool/auth.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Read and trim the bearer token clawtool writes for HTTP auth.
+ *
+ * Token format: 64 hex characters (32 bytes of `crypto/rand`), newline-
+ * terminated, mode 0600 — generated by `internal/server/http.go:362-366`.
+ * `strings.TrimSpace` is applied server-side at parse time, so leading /
+ * trailing whitespace is tolerated. We mirror that here for parity.
+ *
+ * Throws `ClawtoolAuthError` if the file is missing or empty; callers
+ * should surface an actionable message ("daemon not running? run
+ * `clawtool daemon start`"). Override `path` for tests.
+ */
+export declare class ClawtoolAuthError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare function readToken(path?: string): string;
+/**
+ * Non-throwing variant. Returns `null` if the token file is missing or
+ * empty — which is the expected case when the daemon is running in
+ * `--no-auth` mode (single-user loopback). Callers in that path should
+ * proceed with no bearer header; clawtool ignores `Authorization` when
+ * no-auth is on.
+ */
+export declare function tryReadToken(path?: string): string | null;
+//# sourceMappingURL=auth.d.ts.map

package/dist/integrations/clawtool/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/integrations/clawtool/auth.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAG1C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;gBADxB,OAAO,EAAE,MAAM,EACN,KAAK,CAAC,EAAE,OAAO,YAAA;CAKzB;AAED,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAgB/C;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASzD"}

package/dist/integrations/clawtool/auth.js

@@ -0,0 +1,56 @@
+import { readFileSync } from 'node:fs';
+import { listenerTokenPath } from './paths.js';
+/**
+ * Read and trim the bearer token clawtool writes for HTTP auth.
+ *
+ * Token format: 64 hex characters (32 bytes of `crypto/rand`), newline-
+ * terminated, mode 0600 — generated by `internal/server/http.go:362-366`.
+ * `strings.TrimSpace` is applied server-side at parse time, so leading /
+ * trailing whitespace is tolerated. We mirror that here for parity.
+ *
+ * Throws `ClawtoolAuthError` if the file is missing or empty; callers
+ * should surface an actionable message ("daemon not running? run
+ * `clawtool daemon start`"). Override `path` for tests.
+ */
+export class ClawtoolAuthError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'ClawtoolAuthError';
+    }
+}
+export function readToken(path) {
+    const target = path ?? listenerTokenPath();
+    let raw;
+    try {
+        raw = readFileSync(target, 'utf8');
+    }
+    catch (err) {
+        throw new ClawtoolAuthError(`clawtool listener token not found at ${target} — is the daemon running?`, err);
+    }
+    const token = raw.trim();
+    if (token.length === 0) {
+        throw new ClawtoolAuthError(`clawtool listener token at ${target} is empty`);
+    }
+    return token;
+}
+/**
+ * Non-throwing variant. Returns `null` if the token file is missing or
+ * empty — which is the expected case when the daemon is running in
+ * `--no-auth` mode (single-user loopback). Callers in that path should
+ * proceed with no bearer header; clawtool ignores `Authorization` when
+ * no-auth is on.
+ */
+export function tryReadToken(path) {
+    const target = path ?? listenerTokenPath();
+    try {
+        const raw = readFileSync(target, 'utf8');
+        const token = raw.trim();
+        return token.length > 0 ? token : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/integrations/clawtool/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/integrations/clawtool/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAE9C;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAGjC;IAFV,YACC,OAAe,EACN,KAAe;QAExB,KAAK,CAAC,OAAO,CAAC,CAAA;QAFL,UAAK,GAAL,KAAK,CAAU;QAGxB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IAChC,CAAC;CACD;AAED,MAAM,UAAU,SAAS,CAAC,IAAa;IACtC,MAAM,MAAM,GAAG,IAAI,IAAI,iBAAiB,EAAE,CAAA;IAC1C,IAAI,GAAW,CAAA;IACf,IAAI,CAAC;QACJ,GAAG,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,IAAI,iBAAiB,CAC1B,wCAAwC,MAAM,2BAA2B,EACzE,GAAG,CACH,CAAA;IACF,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;IACxB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,iBAAiB,CAAC,8BAA8B,MAAM,WAAW,CAAC,CAAA;IAC7E,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa;IACzC,MAAM,MAAM,GAAG,IAAI,IAAI,iBAAiB,EAAE,CAAA;IAC1C,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACxC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;QACxB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;IACvC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAA;IACZ,CAAC;AACF,CAAC"}

package/dist/integrations/clawtool/auth.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auth.test.d.ts.map

package/dist/integrations/clawtool/auth.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.test.d.ts","sourceRoot":"","sources":["../../../src/integrations/clawtool/auth.test.ts"],"names":[],"mappings":""}

package/dist/integrations/clawtool/auth.test.js

@@ -0,0 +1,40 @@
+import { mkdtempSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { ClawtoolAuthError, readToken, tryReadToken } from './auth.js';
+describe('readToken (strict)', () => {
+    it('returns the trimmed token from a present file', () => {
+        const dir = mkdtempSync(join(tmpdir(), 'namzu-auth-'));
+        const path = join(dir, 'token');
+        writeFileSync(path, '  abc123\n');
+        expect(readToken(path)).toBe('abc123');
+    });
+    it('throws ClawtoolAuthError when the file is missing', () => {
+        expect(() => readToken('/no/such/path/token')).toThrow(ClawtoolAuthError);
+    });
+    it('throws ClawtoolAuthError when the file is empty', () => {
+        const dir = mkdtempSync(join(tmpdir(), 'namzu-auth-'));
+        const path = join(dir, 'empty-token');
+        writeFileSync(path, '   \n  \n');
+        expect(() => readToken(path)).toThrow(ClawtoolAuthError);
+    });
+});
+describe('tryReadToken (lenient)', () => {
+    it('returns the token when present', () => {
+        const dir = mkdtempSync(join(tmpdir(), 'namzu-auth-'));
+        const path = join(dir, 'token');
+        writeFileSync(path, 'deadbeef\n');
+        expect(tryReadToken(path)).toBe('deadbeef');
+    });
+    it('returns null for a missing file (no-auth daemon case)', () => {
+        expect(tryReadToken('/no/such/path/token')).toBeNull();
+    });
+    it('returns null for an empty file', () => {
+        const dir = mkdtempSync(join(tmpdir(), 'namzu-auth-'));
+        const path = join(dir, 'empty-token');
+        writeFileSync(path, '');
+        expect(tryReadToken(path)).toBeNull();
+    });
+});
+//# sourceMappingURL=auth.test.js.map

package/dist/integrations/clawtool/auth.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.test.js","sourceRoot":"","sources":["../../../src/integrations/clawtool/auth.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAEtE,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACxD,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAA;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAC/B,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;QACjC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC1E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QAC1D,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAA;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;QACrC,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;QAChC,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACzC,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAA;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAC/B,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;QACjC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACzC,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAA;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;QACrC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QACvB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;IACtC,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/integrations/clawtool/binary.d.ts

@@ -0,0 +1,25 @@
+export declare class ClawtoolBinaryError extends Error {
+    constructor(message: string);
+}
+export interface FindBinaryOptions {
+    /** Explicit absolute path; if set, skips PATH search and returns this. */
+    readonly override?: string;
+    /** PATH-like string for tests; defaults to `process.env.PATH`. */
+    readonly path?: string;
+    /** Binary name; default `clawtool`. Configurable for win32 `.exe` testing. */
+    readonly name?: string;
+}
+/**
+ * Locate the `clawtool` executable.
+ *
+ * Resolution order:
+ *   1. Explicit `override` (config: `clawtool.binary`).
+ *   2. First `<dir>/clawtool` in `$PATH` that is executable by the
+ *      current user.
+ *
+ * Throws `ClawtoolBinaryError` with an actionable message when neither
+ * yields a hit. We deliberately do not auto-build from source — that would
+ * mask install errors in production deployments (see plan §M1 decision 2).
+ */
+export declare function findBinary(opts?: FindBinaryOptions): string;
+//# sourceMappingURL=binary.d.ts.map

package/dist/integrations/clawtool/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../../src/integrations/clawtool/binary.ts"],"names":[],"mappings":"AAGA,qBAAa,mBAAoB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI3B;AAED,MAAM,WAAW,iBAAiB;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,MAAM,CAe/D"}

package/dist/integrations/clawtool/binary.js

@@ -0,0 +1,50 @@
+import { constants, accessSync } from 'node:fs';
+import { delimiter, join } from 'node:path';
+export class ClawtoolBinaryError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ClawtoolBinaryError';
+    }
+}
+/**
+ * Locate the `clawtool` executable.
+ *
+ * Resolution order:
+ *   1. Explicit `override` (config: `clawtool.binary`).
+ *   2. First `<dir>/clawtool` in `$PATH` that is executable by the
+ *      current user.
+ *
+ * Throws `ClawtoolBinaryError` with an actionable message when neither
+ * yields a hit. We deliberately do not auto-build from source — that would
+ * mask install errors in production deployments (see plan §M1 decision 2).
+ */
+export function findBinary(opts = {}) {
+    const name = opts.name ?? 'clawtool';
+    if (opts.override) {
+        assertExecutable(opts.override, name);
+        return opts.override;
+    }
+    const pathStr = opts.path ?? process.env.PATH ?? '';
+    const dirs = pathStr.split(delimiter).filter((d) => d.length > 0);
+    for (const dir of dirs) {
+        const candidate = join(dir, name);
+        if (isExecutable(candidate))
+            return candidate;
+    }
+    throw new ClawtoolBinaryError('clawtool binary not found in PATH. Install via `go install github.com/cogitave/clawtool/cmd/clawtool@latest` or set `clawtool.binary` in your namzu config.');
+}
+function assertExecutable(path, name) {
+    if (!isExecutable(path)) {
+        throw new ClawtoolBinaryError(`configured \`clawtool.binary\` path is not executable: ${path} (looking for \`${name}\`)`);
+    }
+}
+function isExecutable(path) {
+    try {
+        accessSync(path, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=binary.js.map

package/dist/integrations/clawtool/binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.js","sourceRoot":"","sources":["../../../src/integrations/clawtool/binary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAE3C,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IAClC,CAAC;CACD;AAWD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,OAA0B,EAAE;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,UAAU,CAAA;IACpC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnB,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QACrC,OAAO,IAAI,CAAC,QAAQ,CAAA;IACrB,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAA;IACnD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACjE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACjC,IAAI,YAAY,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAA;IAC9C,CAAC;IACD,MAAM,IAAI,mBAAmB,CAC5B,6JAA6J,CAC7J,CAAA;AACF,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,IAAY;IACnD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,mBAAmB,CAC5B,0DAA0D,IAAI,mBAAmB,IAAI,KAAK,CAC1F,CAAA;IACF,CAAC;AACF,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IACjC,IAAI,CAAC;QACJ,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;QAChC,OAAO,IAAI,CAAA;IACZ,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAA;IACb,CAAC;AACF,CAAC"}

package/dist/integrations/clawtool/binary.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=binary.test.d.ts.map

package/dist/integrations/clawtool/binary.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.test.d.ts","sourceRoot":"","sources":["../../../src/integrations/clawtool/binary.test.ts"],"names":[],"mappings":""}

package/dist/integrations/clawtool/binary.test.js

@@ -0,0 +1,42 @@
+import { chmodSync, mkdtempSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { delimiter, join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { ClawtoolBinaryError, findBinary } from './binary.js';
+function execBin(dir, name) {
+    const path = join(dir, name);
+    writeFileSync(path, '#!/bin/sh\nexit 0\n');
+    chmodSync(path, 0o755);
+    return path;
+}
+describe('findBinary', () => {
+    it('returns the override when it is executable', () => {
+        const dir = mkdtempSync(join(tmpdir(), 'namzu-bin-'));
+        const path = execBin(dir, 'clawtool');
+        expect(findBinary({ override: path })).toBe(path);
+    });
+    it('throws when the override is not executable', () => {
+        const dir = mkdtempSync(join(tmpdir(), 'namzu-bin-'));
+        const path = join(dir, 'clawtool');
+        writeFileSync(path, '#!/bin/sh\nexit 0\n');
+        // no chmod +x
+        expect(() => findBinary({ override: path })).toThrow(ClawtoolBinaryError);
+    });
+    it('finds an executable in the provided PATH', () => {
+        const dir = mkdtempSync(join(tmpdir(), 'namzu-bin-'));
+        const path = execBin(dir, 'clawtool');
+        const otherDir = mkdtempSync(join(tmpdir(), 'namzu-bin-other-'));
+        const result = findBinary({ path: [otherDir, dir].join(delimiter) });
+        expect(result).toBe(path);
+    });
+    it('throws an actionable error when the binary is nowhere on PATH', () => {
+        const otherDir = mkdtempSync(join(tmpdir(), 'namzu-bin-other-'));
+        expect(() => findBinary({ path: otherDir })).toThrowError(/clawtool binary not found/);
+    });
+    it('respects a custom binary name override', () => {
+        const dir = mkdtempSync(join(tmpdir(), 'namzu-bin-'));
+        const path = execBin(dir, 'clawtool-dev');
+        expect(findBinary({ path: dir, name: 'clawtool-dev' })).toBe(path);
+    });
+});
+//# sourceMappingURL=binary.test.js.map

package/dist/integrations/clawtool/binary.test.js.map

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

package/dist/integrations/clawtool/daemon.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `ensureDaemon` — TS port of clawtool's Go `daemon.Ensure(ctx)`.
+ *
+ * Contract:
+ *   1. Read the state file. If healthy (`/v1/health` returns 200), return
+ *      its endpoint + token verbatim.
+ *   2. If missing OR unhealthy, spawn `clawtool daemon start` (detached,
+ *      `cmd.unref()`), wait briefly for the state file + listener, then
+ *      re-probe. Return on success or throw with the underlying reason.
+ *
+ * The spawn path requires `findBinary` to return a real executable. If
+ * `autoStart` is disabled in config and the daemon isn't running, throw
+ * without spawning — surface "daemon not running" to the user instead.
+ */
+import type { DaemonEndpoint } from './types.js';
+export declare class ClawtoolDaemonError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export interface EnsureDaemonOptions {
+    /** Disable auto-spawn (config: `clawtool.autoStart: false`). Default: true. */
+    readonly autoStart?: boolean;
+    /** Override binary path (config: `clawtool.binary`). */
+    readonly binary?: string;
+    /** Override endpoint base URL (config: `clawtool.endpoint`). */
+    readonly endpoint?: string;
+    /** Override token (config: `clawtool.token`). */
+    readonly token?: string;
+    /** Total deadline for the spawn → ready transition, default 10s. */
+    readonly readyTimeoutMs?: number;
+    /** Poll interval while waiting for health, default 200ms. */
+    readonly pollIntervalMs?: number;
+    /** Inject `fetch` for tests. */
+    readonly fetch?: typeof fetch;
+}
+export declare function ensureDaemon(opts?: EnsureDaemonOptions): Promise<DaemonEndpoint>;
+//# sourceMappingURL=daemon.d.ts.map

package/dist/integrations/clawtool/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../../src/integrations/clawtool/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,qBAAa,mBAAoB,SAAQ,KAAK;IAG5C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;gBADxB,OAAO,EAAE,MAAM,EACN,KAAK,CAAC,EAAE,OAAO,YAAA;CAKzB;AAED,MAAM,WAAW,mBAAmB;IACnC,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,oEAAoE;IACpE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,gCAAgC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CAC7B;AAKD,wBAAsB,YAAY,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,cAAc,CAAC,CAoC1F"}