@agtd/agent 0.1.0 → 0.1.2

package/dist/__tests__/transcriptAdapters.test.js

@@ -0,0 +1,133 @@
+import { describe, it, expect, beforeAll, afterAll } from "vitest";
+import { writeFileSync, mkdirSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { claudeCodeAdapter } from "../transcriptAdapters/claude-code.js";
+import { codexAdapter } from "../transcriptAdapters/codex.js";
+const FAKE_SESSION = {
+    id: "sess_test",
+    deviceId: "dev1",
+    projectId: null,
+    agentType: "claude-code",
+    agentCommand: "",
+    cwd: "/projects/myapp",
+    branch: "main",
+    status: "idle",
+    task: "",
+    model: null,
+    contextPercent: null,
+    mcpServers: null,
+    prUrl: null,
+    tmuxSession: "aidash-sess_test",
+    tmuxWindow: "claude",
+    lastHeartbeatAt: new Date().toISOString(),
+    codexThreadId: null,
+};
+const USER_LINE = JSON.stringify({
+    type: "user",
+    uuid: "uuid-1",
+    timestamp: "2026-01-01T00:00:00Z",
+    message: { content: [{ type: "text", text: "Hello Claude" }] },
+});
+const ASSISTANT_LINE = JSON.stringify({
+    type: "assistant",
+    uuid: "uuid-2",
+    timestamp: "2026-01-01T00:00:01Z",
+    message: {
+        content: [{ type: "text", text: "Hi there!" }],
+        model: "claude-opus-4-6",
+        usage: { input_tokens: 10, output_tokens: 5 },
+    },
+});
+describe("claudeCodeAdapter", () => {
+    const tmpDir = join(tmpdir(), "agtd-test-" + Date.now());
+    // The adapter constructs: join(homeDir, ".claude", "projects", cwd.replace(/\//g, "-"))
+    // For cwd="/projects/myapp" the dir name is "-projects-myapp"
+    const projectDir = join(tmpDir, ".claude", "projects", "-projects-myapp");
+    const jsonlPath = join(projectDir, "session.jsonl");
+    beforeAll(() => {
+        mkdirSync(projectDir, { recursive: true });
+        writeFileSync(jsonlPath, [USER_LINE, ASSISTANT_LINE].join("\n") + "\n");
+    });
+    afterAll(() => {
+        rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it("findFile returns path when project dir contains a jsonl file", () => {
+        // Pass tmpDir as homeDir so the adapter looks in tmpDir/.claude/projects/...
+        const path = claudeCodeAdapter.findFile(FAKE_SESSION, tmpDir);
+        expect(path).toBe(jsonlPath);
+    });
+    it("parse returns messages with correct roles", () => {
+        const result = claudeCodeAdapter.parse(jsonlPath, 0, 50);
+        expect(result.messages).toHaveLength(2);
+        expect(result.messages[0].role).toBe("user");
+        const c0 = result.messages[0].content[0];
+        expect(c0.type).toBe("text");
+        expect(c0.text).toBe("Hello Claude");
+        expect(result.messages[1].role).toBe("assistant");
+        expect(result.messages[1].model).toBe("claude-opus-4-6");
+    });
+    it("parse respects cursor and limit", () => {
+        const result = claudeCodeAdapter.parse(jsonlPath, 1, 1);
+        expect(result.messages).toHaveLength(1);
+        expect(result.messages[0].role).toBe("assistant");
+        expect(result.hasMore).toBe(false);
+        expect(result.total).toBe(2);
+    });
+    it("parse returns empty result for missing file", () => {
+        const result = claudeCodeAdapter.parse("/nonexistent/path.jsonl", 0, 50);
+        expect(result.messages).toHaveLength(0);
+        expect(result.total).toBe(0);
+        expect(result.hasMore).toBe(false);
+    });
+});
+const CODEX_USER_LINE = JSON.stringify({
+    type: "response_item",
+    timestamp: "2026-01-01T00:00:00Z",
+    payload: {
+        type: "message",
+        role: "user",
+        content: [{ type: "text", text: "fix the bug" }],
+    },
+});
+const CODEX_ASSISTANT_LINE = JSON.stringify({
+    type: "response_item",
+    timestamp: "2026-01-01T00:00:01Z",
+    payload: {
+        type: "message",
+        role: "assistant",
+        content: [{ type: "text", text: "Done!" }],
+    },
+});
+describe("codexAdapter", () => {
+    const codexTmpDir = join(tmpdir(), "agtd-codex-test-" + Date.now());
+    // Codex sessions are stored under sessions/YEAR/MONTH/DAY/file.jsonl
+    const sessionDir = join(codexTmpDir, ".codex", "sessions", "2026", "01", "01");
+    const jsonlPath = join(sessionDir, "session.jsonl");
+    beforeAll(() => {
+        mkdirSync(sessionDir, { recursive: true });
+        writeFileSync(jsonlPath, [CODEX_USER_LINE, CODEX_ASSISTANT_LINE].join("\n") + "\n");
+    });
+    afterAll(() => {
+        rmSync(codexTmpDir, { recursive: true, force: true });
+    });
+    it("findFile returns latest jsonl in sessions dir when SQLite absent", () => {
+        const CODEX_SESSION = {
+            id: "codex-123",
+            cwd: "/projects/x",
+            agentType: "codex",
+        };
+        const path = codexAdapter.findFile(CODEX_SESSION, codexTmpDir);
+        expect(path).toBe(jsonlPath);
+    });
+    it("parse returns user and assistant messages", () => {
+        const result = codexAdapter.parse(jsonlPath, 0, 50);
+        expect(result.messages).toHaveLength(2);
+        expect(result.messages[0].role).toBe("user");
+        const c0 = result.messages[0].content[0];
+        expect(c0.type).toBe("text");
+        expect(c0.text).toBe("fix the bug");
+        expect(result.messages[1].role).toBe("assistant");
+    });
+});
+//# sourceMappingURL=transcriptAdapters.test.js.map

package/dist/__tests__/transcriptAdapters.test.js.map

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

package/dist/adapters/claude-code.d.ts

@@ -0,0 +1,3 @@
+import type { AgentAdapter } from "./index.js";
+export declare const claudeCodeAdapter: AgentAdapter;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/adapters/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../src/adapters/claude-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C,eAAO,MAAM,iBAAiB,EAAE,YA6C/B,CAAC"}

package/dist/adapters/claude-code.js

@@ -0,0 +1,48 @@
+function escapeForShell(str) {
+    return str.replace(/'/g, "'\\''");
+}
+export const claudeCodeAdapter = {
+    type: "claude-code",
+    buildSpawnCommand(_task, cwd) {
+        const escapedCwd = escapeForShell(cwd);
+        // Start in interactive mode (no -p flag which exits after one response)
+        return `cd '${escapedCwd}' && claude`;
+    },
+    hookInstallInstructions() {
+        return [
+            "To install the Claude Code hook for the agent dashboard:",
+            "",
+            "1. Edit (or create) ~/.claude/hooks.json",
+            "2. Add the following hook configuration:",
+            "",
+            "   {",
+            '     "hooks": {',
+            '       "PreToolUse": [',
+            "         {",
+            '           "type": "command",',
+            '           "command": "/path/to/packages/agent/src/hooks/claude-hook.sh PreToolUse"',
+            "         }",
+            "       ],",
+            '       "PostToolUse": [',
+            "         {",
+            '           "type": "command",',
+            '           "command": "/path/to/packages/agent/src/hooks/claude-hook.sh PostToolUse"',
+            "         }",
+            "       ],",
+            '       "Stop": [',
+            "         {",
+            '           "type": "command",',
+            '           "command": "/path/to/packages/agent/src/hooks/claude-hook.sh Stop"',
+            "         }",
+            "       ]",
+            "     }",
+            "   }",
+            "",
+            "3. Set the following environment variables:",
+            "   - AGENT_DASHBOARD_BACKEND (e.g., http://localhost:3001)",
+            "   - AGENT_DASHBOARD_DEVICE_ID",
+            "   - AGENT_DASHBOARD_API_KEY",
+        ].join("\n");
+    },
+};
+//# sourceMappingURL=claude-code.js.map

package/dist/adapters/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/adapters/claude-code.ts"],"names":[],"mappings":"AAEA,SAAS,cAAc,CAAC,GAAW;IACjC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAiB;IAC7C,IAAI,EAAE,aAAa;IAEnB,iBAAiB,CAAC,KAAa,EAAE,GAAW;QAC1C,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACvC,wEAAwE;QACxE,OAAO,OAAO,UAAU,aAAa,CAAC;IACxC,CAAC;IAED,uBAAuB;QACrB,OAAO;YACL,0DAA0D;YAC1D,EAAE;YACF,0CAA0C;YAC1C,0CAA0C;YAC1C,EAAE;YACF,MAAM;YACN,iBAAiB;YACjB,wBAAwB;YACxB,YAAY;YACZ,+BAA+B;YAC/B,qFAAqF;YACrF,YAAY;YACZ,WAAW;YACX,yBAAyB;YACzB,YAAY;YACZ,+BAA+B;YAC/B,sFAAsF;YACtF,YAAY;YACZ,WAAW;YACX,kBAAkB;YAClB,YAAY;YACZ,+BAA+B;YAC/B,+EAA+E;YAC/E,YAAY;YACZ,UAAU;YACV,QAAQ;YACR,MAAM;YACN,EAAE;YACF,6CAA6C;YAC7C,4DAA4D;YAC5D,gCAAgC;YAChC,8BAA8B;SAC/B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;CACF,CAAC"}

package/dist/adapters/codex.d.ts

@@ -0,0 +1,3 @@
+import type { AgentAdapter } from "./index.js";
+export declare const codexAdapter: AgentAdapter;
+//# sourceMappingURL=codex.d.ts.map

package/dist/adapters/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C,eAAO,MAAM,YAAY,EAAE,YA8B1B,CAAC"}

package/dist/adapters/codex.js

@@ -0,0 +1,33 @@
+function escapeForShell(str) {
+    return str.replace(/'/g, "'\\''");
+}
+export const codexAdapter = {
+    type: "codex",
+    buildSpawnCommand(task, cwd) {
+        const escapedTask = escapeForShell(task);
+        const escapedCwd = escapeForShell(cwd);
+        return `cd '${escapedCwd}' && codex '${escapedTask}'`;
+    },
+    hookInstallInstructions() {
+        return [
+            "To install the Codex hook for the agent dashboard:",
+            "",
+            "1. Use the codex-hook.sh wrapper script instead of calling codex directly:",
+            "",
+            "   ./packages/agent/src/hooks/codex-hook.sh 'your task here'",
+            "",
+            "   The wrapper script will:",
+            "   - Send a working heartbeat before running codex",
+            "   - Start a background keepalive loop (every 10s)",
+            "   - Run codex with the provided task",
+            "   - Send an idle heartbeat on exit",
+            "",
+            "2. Set the following environment variables:",
+            "   - AGENT_DASHBOARD_BACKEND (e.g., http://localhost:3001)",
+            "   - AGENT_DASHBOARD_DEVICE_ID",
+            "   - AGENT_DASHBOARD_API_KEY",
+            "   - AGENT_DASHBOARD_SESSION_ID (unique session identifier)",
+        ].join("\n");
+    },
+};
+//# sourceMappingURL=codex.js.map

package/dist/adapters/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAEA,SAAS,cAAc,CAAC,GAAW;IACjC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC,IAAI,EAAE,OAAO;IAEb,iBAAiB,CAAC,IAAY,EAAE,GAAW;QACzC,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,OAAO,UAAU,eAAe,WAAW,GAAG,CAAC;IACxD,CAAC;IAED,uBAAuB;QACrB,OAAO;YACL,oDAAoD;YACpD,EAAE;YACF,4EAA4E;YAC5E,EAAE;YACF,8DAA8D;YAC9D,EAAE;YACF,6BAA6B;YAC7B,oDAAoD;YACpD,oDAAoD;YACpD,uCAAuC;YACvC,qCAAqC;YACrC,EAAE;YACF,6CAA6C;YAC7C,4DAA4D;YAC5D,gCAAgC;YAChC,8BAA8B;YAC9B,6DAA6D;SAC9D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;CACF,CAAC"}

package/dist/adapters/generic.d.ts

@@ -0,0 +1,3 @@
+import type { AgentAdapter } from "./index.js";
+export declare const genericAdapter: AgentAdapter;
+//# sourceMappingURL=generic.d.ts.map

package/dist/adapters/generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../src/adapters/generic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C,eAAO,MAAM,cAAc,EAAE,YAmC5B,CAAC"}

package/dist/adapters/generic.js

@@ -0,0 +1,38 @@
+function escapeForShell(str) {
+    return str.replace(/'/g, "'\\''");
+}
+export const genericAdapter = {
+    type: "generic",
+    buildSpawnCommand(task, cwd) {
+        const escapedTask = escapeForShell(task);
+        const escapedCwd = escapeForShell(cwd);
+        return `cd '${escapedCwd}' && echo 'Task: ${escapedTask}'`;
+    },
+    hookInstallInstructions() {
+        return [
+            "To send heartbeats from a generic agent to the dashboard:",
+            "",
+            "1. Use the generic-hook.sh script to send manual heartbeat updates:",
+            "",
+            "   ./packages/agent/src/hooks/generic-hook.sh <session_id> <status> [task]",
+            "",
+            "   Examples:",
+            '   ./packages/agent/src/hooks/generic-hook.sh my-session working "Implementing feature X"',
+            "   ./packages/agent/src/hooks/generic-hook.sh my-session idle",
+            "   ./packages/agent/src/hooks/generic-hook.sh my-session awaiting_permission",
+            "",
+            "2. Or send heartbeats directly via curl:",
+            "",
+            "   curl -X POST $AGENT_DASHBOARD_BACKEND/api/agent/heartbeat \\",
+            '     -H "Content-Type: application/json" \\',
+            '     -H "x-api-key: $AGENT_DASHBOARD_API_KEY" \\',
+            "     -d '{\"deviceId\": \"...\", \"sessionId\": \"...\", \"status\": \"working\"}'",
+            "",
+            "3. Set the following environment variables:",
+            "   - AGENT_DASHBOARD_BACKEND (e.g., http://localhost:3001)",
+            "   - AGENT_DASHBOARD_DEVICE_ID",
+            "   - AGENT_DASHBOARD_API_KEY",
+        ].join("\n");
+    },
+};
+//# sourceMappingURL=generic.js.map

package/dist/adapters/generic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.js","sourceRoot":"","sources":["../../src/adapters/generic.ts"],"names":[],"mappings":"AAEA,SAAS,cAAc,CAAC,GAAW;IACjC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C,IAAI,EAAE,SAAS;IAEf,iBAAiB,CAAC,IAAY,EAAE,GAAW;QACzC,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,OAAO,UAAU,oBAAoB,WAAW,GAAG,CAAC;IAC7D,CAAC;IAED,uBAAuB;QACrB,OAAO;YACL,2DAA2D;YAC3D,EAAE;YACF,qEAAqE;YACrE,EAAE;YACF,4EAA4E;YAC5E,EAAE;YACF,cAAc;YACd,2FAA2F;YAC3F,+DAA+D;YAC/D,8EAA8E;YAC9E,EAAE;YACF,0CAA0C;YAC1C,EAAE;YACF,iEAAiE;YACjE,6CAA6C;YAC7C,kDAAkD;YAClD,oFAAoF;YACpF,EAAE;YACF,6CAA6C;YAC7C,4DAA4D;YAC5D,gCAAgC;YAChC,8BAA8B;SAC/B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;CACF,CAAC"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,7 @@
+export interface AgentAdapter {
+    type: string;
+    buildSpawnCommand(task: string, cwd: string): string;
+    hookInstallInstructions(): string;
+}
+export declare function getAdapter(agentType: string): AgentAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrD,uBAAuB,IAAI,MAAM,CAAC;CACnC;AAYD,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAE1D"}

package/dist/adapters/index.js

@@ -0,0 +1,12 @@
+import { claudeCodeAdapter } from "./claude-code.js";
+import { codexAdapter } from "./codex.js";
+import { genericAdapter } from "./generic.js";
+const adapters = {
+    "claude-code": claudeCodeAdapter,
+    "codex": codexAdapter,
+    "generic": genericAdapter,
+};
+export function getAdapter(agentType) {
+    return adapters[agentType] || genericAdapter;
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,QAAQ,GAAiC;IAC7C,aAAa,EAAE,iBAAiB;IAChC,OAAO,EAAE,YAAY;IACrB,SAAS,EAAE,cAAc;CAC1B,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC1C,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,cAAc,CAAC;AAC/C,CAAC"}

package/dist/agent.d.ts

@@ -0,0 +1,3 @@
+import type { AgentConfig } from "./config.js";
+export declare function startAgent(config: AgentConfig): Promise<void>;
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA2B/C,wBAAsB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBnE"}

package/dist/agent.js

@@ -1,6 +1,49 @@
-import {
-  startAgent
-} from "./chunk-24ORBJSI.js";
-export {
-  startAgent
-};
+import { loadConfig } from "./config.js";
+import { registerDevice } from "./register.js";
+import { syncProjects } from "./syncProjects.js";
+import { connectToBackend } from "./wsClient.js";
+import { startSessionScanner } from "./sessionScanner.js";
+import { KEEPALIVE_INTERVAL_MS } from "@agtd/shared";
+async function waitForBackend(config, maxRetries = 30) {
+    for (let i = 0; i < maxRetries; i++) {
+        try {
+            await registerDevice(config);
+            return;
+        }
+        catch {
+            const delaySec = Math.min(2 ** Math.min(i, 4), 16);
+            console.log(`Backend not ready, retrying in ${delaySec}s... (${i + 1}/${maxRetries})`);
+            await new Promise((r) => setTimeout(r, delaySec * 1000));
+        }
+    }
+    throw new Error("Backend not reachable after retries");
+}
+export async function startAgent(config) {
+    console.log(`Starting agent for device: ${config.deviceId}`);
+    console.log(`Backend: ${config.backendUrl}`);
+    await waitForBackend(config);
+    await syncProjects(config);
+    connectToBackend(config);
+    startSessionScanner(config);
+    setInterval(async () => {
+        try {
+            await registerDevice(config);
+        }
+        catch (e) {
+            console.error("Keepalive failed:", e);
+        }
+    }, KEEPALIVE_INTERVAL_MS);
+    console.log("Agent running. Press Ctrl+C to stop.");
+}
+// Direct execution (monorepo dev mode)
+const isDirectRun = process.argv[1] &&
+    import.meta.url.endsWith(process.argv[1].replace(/\\/g, "/"));
+if (isDirectRun) {
+    const configPath = process.argv[2];
+    const config = loadConfig(configPath);
+    startAgent(config).catch((e) => {
+        console.error("Agent failed:", e);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,KAAK,UAAU,cAAc,CAC3B,MAAmB,EACnB,UAAU,GAAG,EAAE;IAEf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnD,OAAO,CAAC,GAAG,CACT,kCAAkC,QAAQ,SAAS,CAAC,GAAG,CAAC,IAAI,UAAU,GAAG,CAC1E,CAAC;YACF,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAmB;IAClD,OAAO,CAAC,GAAG,CAAC,8BAA8B,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAE7C,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEzB,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE5B,WAAW,CAAC,KAAK,IAAI,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,EAAE,qBAAqB,CAAC,CAAC;IAE1B,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;AACtD,CAAC;AAED,uCAAuC;AACvC,MAAM,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACf,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AAEhE,IAAI,WAAW,EAAE,CAAC;IAChB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACtC,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7B,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,11 @@
+interface ParsedArgs {
+    init: boolean;
+    backend?: string;
+    apiKey?: string;
+    deviceName?: string;
+    configPath?: string;
+    help: boolean;
+}
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAaA,UAAU,UAAU;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAmCpD"}