@harness-nexus/cli 0.1.0-alpha.1

package/dist/daemon/chat.js

@@ -0,0 +1,280 @@
+import { randomUUID } from 'node:crypto';
+import { acpPermissionOptionSchema, acpToolCallViewSchema, chatPermissionRespondEventSchema, chatPromptEventSchema, chatSessionCloseEventSchema, chatSessionStartEventSchema, chatTurnCancelEventSchema, } from '@harness-nexus/shared';
+import { AcpAgentConnection } from './acp/agent-connection.js';
+import { resolveAcpCommand } from './acp/adapters.js';
+export function attachChatHandlers(socket, opts = {}) {
+    const env = opts.env ?? process.env;
+    const sessions = new Map();
+    const emitEvent = (sessionId, event) => {
+        socket.emit('chat:event', { sessionId, event });
+    };
+    const teardown = (session, reason) => {
+        if (sessions.get(session.sessionId) !== session)
+            return;
+        sessions.delete(session.sessionId);
+        for (const [, p] of session.permissions)
+            clearTimeout(p.timer);
+        session.permissions.clear();
+        session.conn.kill();
+        socket.emit('chat:session.closed', { sessionId: session.sessionId, reason });
+    };
+    // ---- server → daemon: spawn the channel ----
+    socket.on('chat:session.start', (payload, ack) => {
+        const parsed = chatSessionStartEventSchema.safeParse(payload);
+        if (!parsed.success) {
+            ack?.({ error: 'proto:invalid' });
+            return;
+        }
+        ack?.({ accepted: true });
+        const { sessionId, target, cwd } = parsed.data;
+        void (async () => {
+            const cmd = resolveAcpCommand(target, env);
+            if (cmd === null) {
+                socket.emit('chat:session.ready', {
+                    sessionId,
+                    error: `no ACP adapter for target '${target}'`,
+                });
+                return;
+            }
+            try {
+                const { conn, agentInfo } = await AcpAgentConnection.start(cmd.command, cmd.args, {
+                    cwd,
+                    ...(opts.spawnEnv !== undefined ? { env: opts.spawnEnv } : {}),
+                });
+                const created = (await conn.request('session/new', { cwd }, 20000));
+                const session = {
+                    sessionId,
+                    acpSessionId: created?.sessionId ?? sessionId,
+                    conn,
+                    busy: false,
+                    permissions: new Map(),
+                };
+                sessions.set(sessionId, session);
+                wireSession(session, emitEvent);
+                conn.onExit(() => {
+                    // Crash/quit outside our control — end the channel honestly.
+                    if (sessions.get(sessionId) === session)
+                        teardown(session, 'agent-exited');
+                });
+                socket.emit('chat:session.ready', {
+                    sessionId,
+                    ...(agentInfo.name !== undefined ? { agentName: agentInfo.name } : {}),
+                    ...(agentInfo.version !== undefined ? { agentVersion: agentInfo.version } : {}),
+                });
+            }
+            catch (e) {
+                socket.emit('chat:session.ready', {
+                    sessionId,
+                    error: e instanceof Error ? e.message : String(e),
+                });
+            }
+        })();
+    });
+    // ---- server → daemon: prompt / cancel / permission / close ----
+    socket.on('chat:message.send', (payload, ack) => {
+        const parsed = chatPromptEventSchema.safeParse(payload);
+        if (!parsed.success) {
+            ack?.({ error: 'proto:invalid' });
+            return;
+        }
+        const session = sessions.get(parsed.data.sessionId);
+        if (session === undefined) {
+            ack?.({ error: 'unknown-session' });
+            return;
+        }
+        if (session.busy) {
+            // Lost the race against the server's busy gate — resync it.
+            emitEvent(session.sessionId, { kind: 'session_status', state: 'active' });
+            ack?.({ error: 'session-busy' });
+            return;
+        }
+        ack?.({ accepted: true });
+        void runPrompt(session, parsed.data.prompt, emitEvent, teardown);
+    });
+    socket.on('chat:turn.cancel', (payload, ack) => {
+        const parsed = chatTurnCancelEventSchema.safeParse(payload);
+        if (!parsed.success) {
+            ack?.({ error: 'proto:invalid' });
+            return;
+        }
+        const session = sessions.get(parsed.data.sessionId);
+        if (session === undefined) {
+            ack?.({ error: 'unknown-session' });
+            return;
+        }
+        ack?.({ accepted: true });
+        // The pending session/prompt resolves as 'cancelled' → turn_result fires.
+        void session.conn.request('session/cancel', {}, 5000).catch(() => { });
+    });
+    socket.on('chat:permission.respond', (payload, ack) => {
+        const parsed = chatPermissionRespondEventSchema.safeParse(payload);
+        if (!parsed.success) {
+            ack?.({ error: 'proto:invalid' });
+            return;
+        }
+        const session = sessions.get(parsed.data.sessionId);
+        if (session === undefined) {
+            ack?.({ error: 'unknown-session' });
+            return;
+        }
+        const pending = session.permissions.get(parsed.data.requestId);
+        if (pending === undefined) {
+            ack?.({ error: 'unknown-permission' });
+            return;
+        }
+        ack?.({ accepted: true });
+        clearTimeout(pending.timer);
+        session.permissions.delete(parsed.data.requestId);
+        // optionId is forwarded VERBATIM (a rewritten id counts as a rejection).
+        session.conn.respondPermission(pending.jsonrpcId, parsed.data.optionId !== undefined
+            ? { outcome: 'selected', optionId: parsed.data.optionId }
+            : { outcome: 'cancelled' });
+    });
+    socket.on('chat:session.close', (payload, ack) => {
+        const parsed = chatSessionCloseEventSchema.safeParse(payload);
+        if (!parsed.success) {
+            ack?.({ error: 'proto:invalid' });
+            return;
+        }
+        const session = sessions.get(parsed.data.sessionId);
+        if (session !== undefined) {
+            // Best-effort session/close, then SIGTERM (kill is on a 3s grace).
+            void session.conn.request('session/close', {}, 3000).catch(() => { });
+            teardown(session, parsed.data.reason ?? 'user');
+        }
+        ack?.({ closed: true });
+    });
+    socket.on('disconnect', () => {
+        // No resume in v1 — every channel dies with the daemon's connection.
+        for (const session of [...sessions.values()])
+            teardown(session, 'daemon-disconnected');
+    });
+}
+/** Hook ACP frames for one live session onto the semantic stream. */
+function wireSession(session, emitEvent) {
+    const { conn } = session;
+    conn.setNotificationHandler((method, params) => {
+        const mapped = method === 'session/update' ? mapAcpUpdate(params) : null;
+        if (mapped !== null)
+            emitEvent(session.sessionId, mapped);
+    });
+    conn.setPermissionHandler((jsonrpcId, params) => {
+        const requestId = randomUUID();
+        const timer = setTimeout(() => {
+            // Belt-and-braces: the server runs its own watchdog; this backstop
+            // guarantees the agent never waits forever even if the server is gone.
+            session.permissions.delete(requestId);
+            conn.respondPermission(jsonrpcId, { outcome: 'cancelled' });
+            emitEvent(session.sessionId, {
+                kind: 'permission_resolved',
+                requestId,
+                outcome: 'timeout',
+            });
+        }, 75000);
+        session.permissions.set(requestId, { jsonrpcId, timer });
+        emitEvent(session.sessionId, {
+            kind: 'permission_request',
+            requestId,
+            toolCall: toolCallView(params.toolCall),
+            options: permissionOptions(params.options),
+        });
+    });
+}
+async function runPrompt(session, prompt, emitEvent, teardown) {
+    session.busy = true;
+    emitEvent(session.sessionId, { kind: 'session_status', state: 'active' });
+    try {
+        // No client-side timeout: a turn can legitimately run for minutes; the
+        // recovery story is cancel or channel close, not a timer.
+        const result = (await session.conn.request('session/prompt', { sessionId: session.acpSessionId, prompt }, 30 * 60 * 1000));
+        const stopReason = ['end_turn', 'cancelled', 'max_tokens', 'refusal'].includes(result?.stopReason)
+            ? result.stopReason
+            : 'end_turn';
+        emitEvent(session.sessionId, { kind: 'turn_result', stopReason });
+    }
+    catch (e) {
+        emitEvent(session.sessionId, {
+            kind: 'raw',
+            method: 'hnx/prompt-error',
+            params: { message: e instanceof Error ? e.message : String(e) },
+        });
+        emitEvent(session.sessionId, { kind: 'turn_result', stopReason: 'end_turn' });
+        // The subprocess is unusable — end the channel honestly.
+        teardown(session, 'agent-exited');
+        return;
+    }
+    finally {
+        session.busy = false;
+        emitEvent(session.sessionId, { kind: 'session_status', state: 'idle' });
+    }
+}
+/** Map one ACP `session/update` params object; null = drop (user echo). */
+export function mapAcpUpdate(params) {
+    const update = (params.update ?? {});
+    switch (update.sessionUpdate) {
+        case 'agent_message_chunk':
+            return { kind: 'message_delta', delta: textOf(update.contentBlock) };
+        case 'agent_thought_chunk':
+            return { kind: 'thought_delta', delta: textOf(update.contentBlock) };
+        case 'tool_call':
+        case 'tool_call_update':
+            return { kind: 'tool_call', call: toolCallView(update.toolCallUpdate) };
+        case 'usage_update': {
+            const usage = (update.usage ?? {});
+            return {
+                kind: 'usage',
+                ...(typeof usage.inputTokens === 'number' ? { inputTokens: usage.inputTokens } : {}),
+                ...(typeof usage.outputTokens === 'number' ? { outputTokens: usage.outputTokens } : {}),
+            };
+        }
+        case 'user_message_chunk':
+            // The browser echoes the user's message optimistically; there is no
+            // replay in v1, so a live echo would double-render.
+            return null;
+        default:
+            return { kind: 'raw', method: 'session/update', params: update };
+    }
+}
+/** Extract display text from an ACP ContentBlock chunk. */
+export function textOf(contentBlock) {
+    const block = (contentBlock ?? {});
+    switch (block.type) {
+        case 'text':
+            return typeof block.text === 'string' ? block.text : '';
+        case 'resource_link':
+            return `[@${String(block.name ?? '')}](${String(block.uri ?? '')})`;
+        case 'image':
+            return '[image]';
+        case 'audio':
+            return '[audio]';
+        case 'resource':
+            return '[resource]';
+        default:
+            return '';
+    }
+}
+/**
+ * Defensive view of an ACP ToolCallUpdate: shared-schema-validated, falling
+ * back to the bare id when an adapter sends something malformed (the server
+ * re-validates everything crossing the wire).
+ */
+export function toolCallView(toolCallUpdate) {
+    const parsed = acpToolCallViewSchema.safeParse(toolCallUpdate);
+    if (parsed.success)
+        return parsed.data;
+    const t = (toolCallUpdate ?? {});
+    return { toolCallId: String(t.toolCallId ?? 'unknown') };
+}
+/** Permission options, shared-schema-validated; malformed entries dropped. */
+function permissionOptions(options) {
+    if (!Array.isArray(options))
+        return [];
+    const out = [];
+    for (const o of options) {
+        const parsed = acpPermissionOptionSchema.safeParse(o);
+        if (parsed.success)
+            out.push(parsed.data);
+    }
+    return out;
+}
+//# sourceMappingURL=chat.js.map

package/dist/daemon/chat.js.map

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

package/dist/daemon/client.d.ts

@@ -0,0 +1,23 @@
+/** Client-side daemon version, reported in every `machine:hello`. */
+export declare const DAEMON_VERSION = "0.4.0-c5";
+/** Capabilities this daemon build carries (C3: inventory; C4: deploy; C5: chat). */
+export declare const DAEMON_CAPABILITIES: string[];
+export interface DaemonOptions {
+    server: string;
+    /** Machine PAT (scopes ['machine-ctl']). */
+    token: string;
+    machineId: string;
+}
+/**
+ * The on-demand Harness Nexus daemon (Phase 8 C1): connects to the server's
+ * `/ctl` namespace, says `machine:hello` on every (re)connect so presence and
+ * metadata stay fresh, and stays attached until SIGINT/SIGTERM. Socket.IO
+ * handles reconnection with backoff; each reconnect re-runs hello and — since
+ * C3 — re-reports every target's inventory (fresh snapshots whenever the
+ * daemon comes up).
+ *
+ * The machine shows online exactly while this process is running — that is
+ * the honest-presence contract; MCP serving (C2) does NOT depend on it.
+ */
+export declare function runDaemon(options: DaemonOptions): Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/daemon/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/daemon/client.ts"],"names":[],"mappings":"AAWA,qEAAqE;AACrE,eAAO,MAAM,cAAc,aAAa,CAAC;AAEzC,oFAAoF;AACpF,eAAO,MAAM,mBAAmB,UAAkC,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA0G/D"}

package/dist/daemon/client.js

@@ -0,0 +1,117 @@
+import { arch, hostname, platform } from 'node:os';
+import { io } from 'socket.io-client';
+import { inventoryCollectRequestSchema, inventoryScanRequestSchema, } from '@harness-nexus/shared';
+import { collectItems, scanAllTargets, scanTarget } from '../inventory/scan.js';
+import { attachJobHandlers } from './jobs.js';
+import { attachChatHandlers } from './chat.js';
+/** Client-side daemon version, reported in every `machine:hello`. */
+export const DAEMON_VERSION = '0.4.0-c5';
+/** Capabilities this daemon build carries (C3: inventory; C4: deploy; C5: chat). */
+export const DAEMON_CAPABILITIES = ['inventory', 'deploy', 'chat'];
+/**
+ * The on-demand Harness Nexus daemon (Phase 8 C1): connects to the server's
+ * `/ctl` namespace, says `machine:hello` on every (re)connect so presence and
+ * metadata stay fresh, and stays attached until SIGINT/SIGTERM. Socket.IO
+ * handles reconnection with backoff; each reconnect re-runs hello and — since
+ * C3 — re-reports every target's inventory (fresh snapshots whenever the
+ * daemon comes up).
+ *
+ * The machine shows online exactly while this process is running — that is
+ * the honest-presence contract; MCP serving (C2) does NOT depend on it.
+ */
+export function runDaemon(options) {
+    const socket = io(`${options.server}/ctl`, {
+        auth: { token: options.token, machineId: options.machineId },
+        transports: ['websocket'],
+    });
+    attachJobHandlers(socket, { server: options.server, token: options.token });
+    attachChatHandlers(socket);
+    const reportAll = (requestId) => {
+        void (async () => {
+            for (const snapshot of scanAllTargets()) {
+                socket.emit('inventory:report', { ...(requestId ? { requestId } : {}), snapshot });
+            }
+        })();
+    };
+    socket.on('connect', () => {
+        socket.emit('machine:hello', {
+            daemonVersion: DAEMON_VERSION,
+            os: platform(),
+            arch: arch(),
+            hostname: hostname(),
+            capabilities: DAEMON_CAPABILITIES,
+        }, (res) => {
+            const ack = res;
+            if (ack && 'error' in ack) {
+                // eslint-disable-next-line no-console
+                console.error(`hnx daemon: hello rejected: ${ack.error}`);
+                return;
+            }
+            // eslint-disable-next-line no-console
+            console.log(`hnx daemon: online (proto ${ack.proto}, machine ${ack.machineId})`);
+            reportAll();
+        });
+    });
+    socket.on('inventory:scan', (payload, ack) => {
+        const parsed = inventoryScanRequestSchema.safeParse(payload);
+        if (!parsed.success) {
+            ack?.({ error: 'proto:invalid' });
+            return;
+        }
+        ack?.({ accepted: true });
+        const { requestId, targets } = parsed.data;
+        void (async () => {
+            for (const target of targets) {
+                try {
+                    const snapshot = scanTarget(target);
+                    socket.emit('inventory:report', { requestId, snapshot });
+                }
+                catch {
+                    // No scanner for this target on this build — still report the empty
+                    // shape so the server's waiter never hangs on it.
+                    const home = `~/.${target}`;
+                    socket.emit('inventory:report', {
+                        requestId,
+                        snapshot: {
+                            target,
+                            scannedAt: new Date().toISOString(),
+                            agents: [{ name: home, directory: home, profileApplied: false, items: [] }],
+                        },
+                    });
+                }
+            }
+        })();
+    });
+    socket.on('inventory:collect', (payload, ack) => {
+        const parsed = inventoryCollectRequestSchema.safeParse(payload);
+        if (!parsed.success) {
+            ack?.({ error: 'proto:invalid' });
+            return;
+        }
+        ack?.({ accepted: true });
+        const { requestId, target, items } = parsed.data;
+        void (async () => {
+            // Bodies are read fresh (paths re-derived) and secrets redacted
+            // daemon-side before anything crosses the wire.
+            const payloadItems = await collectItems(target, items);
+            socket.emit('inventory:payload', { requestId, items: payloadItems });
+        })();
+    });
+    socket.on('connect_error', (err) => {
+        // eslint-disable-next-line no-console
+        console.error(`hnx daemon: connection error: ${err.message}`);
+    });
+    socket.on('disconnect', (reason) => {
+        // eslint-disable-next-line no-console
+        console.error(`hnx daemon: disconnected (${reason})`);
+    });
+    return new Promise((resolve) => {
+        const stop = () => {
+            socket.close();
+            resolve();
+        };
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/daemon/client.js.map

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

package/dist/daemon/jobs.d.ts

@@ -0,0 +1,19 @@
+import type { Socket } from 'socket.io-client';
+/**
+ * Daemon-side job executor (Phase 8 C4). docs/design/phase-8-c4.md.
+ *
+ * A deploy job is the 3.3 pipeline with a different trigger: fetch the
+ * resolved bundle with the machine PAT (`GET /api/client/deploy-bundle` —
+ * machine PAT exception #2), plan, apply + ledger, reporting `job:progress`
+ * per phase and one terminal `job:result`. Plans are idempotent overwrites,
+ * so a redelivered job (server recovered it after a disconnect) simply
+ * re-runs. `scan`/`import` job types are reserved by the protocol — C3's
+ * interactive flows handle them; arriving here they settle as unsupported.
+ */
+export interface JobExecutorOptions {
+    server: string;
+    /** The daemon's machine PAT. */
+    token: string;
+}
+export declare function attachJobHandlers(socket: Socket, opts: JobExecutorOptions): void;
+//# sourceMappingURL=jobs.d.ts.map

package/dist/daemon/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/daemon/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAW/C;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAqBhF"}

package/dist/daemon/jobs.js

@@ -0,0 +1,65 @@
+import { jobDispatchEventSchema, deployResultDataSchema, } from '@harness-nexus/shared';
+import { HarnessNexusClient } from '@harness-nexus/sdk';
+import { planInstall } from '../install/planner.js';
+import { applyInstall } from '../install/installer.js';
+export function attachJobHandlers(socket, opts) {
+    socket.on('job:dispatch', (payload, ack) => {
+        const parsed = jobDispatchEventSchema.safeParse(payload);
+        if (!parsed.success) {
+            ack?.({ error: 'proto:invalid' });
+            return;
+        }
+        // Ack = ACCEPTED, not completed — the server's dispatched state means
+        // "with the daemon", the terminal result arrives separately.
+        ack?.({ accepted: true });
+        const job = parsed.data.job;
+        if (job.type !== 'deploy') {
+            socket.emit('job:result', {
+                jobId: job.id,
+                ok: false,
+                error: `job type '${job.type}' is not supported by this daemon`,
+            });
+            return;
+        }
+        void runDeploy(socket, opts, job);
+    });
+}
+async function runDeploy(socket, opts, job) {
+    const payload = job.payload;
+    const progress = (phase, message) => {
+        socket.emit('job:progress', { jobId: job.id, phase, ...(message ? { message } : {}) });
+    };
+    const result = (ok, extra) => {
+        socket.emit('job:result', { jobId: job.id, ok, ...extra });
+    };
+    try {
+        const client = new HarnessNexusClient({ baseUrl: opts.server, token: opts.token });
+        progress('resolve', `fetching profile ${payload.profileId}`);
+        const bundle = (await client.getDeployBundle(payload.profileId));
+        // Adapters read the server base from HN_SERVER when emitting the
+        // `hnx mcp serve` shim entry (same as `hnx install`).
+        process.env.HN_SERVER = opts.server;
+        progress('plan', 'planning install');
+        const plan = planInstall(bundle, {
+            ...(payload.directory ? { input: { outDir: payload.directory } } : {}),
+        });
+        progress('apply', `writing ${plan.operations.length} operation(s)`);
+        applyInstall(plan, {
+            profileId: bundle.profile.id,
+            profileName: bundle.profile.name,
+            profileVersion: bundle.profile.version,
+        });
+        const data = deployResultDataSchema.parse({
+            name: bundle.profile.name,
+            directory: plan.targetRoot,
+            target: plan.adapter.target,
+            profileId: bundle.profile.id,
+            ...(bundle.profile.version ? { profileVersion: bundle.profile.version } : {}),
+        });
+        result(true, { data });
+    }
+    catch (e) {
+        result(false, { error: e instanceof Error ? e.message : String(e) });
+    }
+}
+//# sourceMappingURL=jobs.js.map

package/dist/daemon/jobs.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Install-pipeline errors. Carry a stable `code` so the CLI can map them to
+ * the right exit status / message. See `docs/design/phase-3-install.md` Part 6.
+ */
+export type InstallErrorCode = 'TARGET_UNSUPPORTED' | 'TARGET_MISMATCH' | 'RESOLVE_FAILED' | 'VALIDATION_FAILED' | 'APPLY_FAILED';
+export declare class InstallError extends Error {
+    readonly code: InstallErrorCode;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, code: InstallErrorCode, cause?: unknown | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB,oBAAoB,GACpB,iBAAiB,GACjB,gBAAgB,GAChB,mBAAmB,GACnB,cAAc,CAAC;AAEnB,qBAAa,YAAa,SAAQ,KAAK;IAGnC,QAAQ,CAAC,IAAI,EAAE,gBAAgB;aACb,KAAK,CAAC,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACN,IAAI,EAAE,gBAAgB,EACb,KAAK,CAAC,EAAE,OAAO,YAAA;CAKpC"}

package/dist/errors.js

@@ -0,0 +1,11 @@
+export class InstallError extends Error {
+    code;
+    cause;
+    constructor(message, code, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'InstallError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAG1B;IACS;IAHpB,YACE,OAAe,EACN,IAAsB,EACb,KAAe;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,SAAI,GAAJ,IAAI,CAAkB;QACb,UAAK,GAAL,KAAK,CAAU;QAGjC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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