@beeos-ai/device-agent 0.4.0

package/dist/inbound/cli/skills-command.js

@@ -0,0 +1,333 @@
+/**
+ * inbound/cli/skills-command — `device-agent skills <subcmd>`.
+ *
+ * Phase 3.4 of the [device-agent reflector upgrade plan](../../../../../../.cursor/plans/device-agent-reflector-skills_d5599350.plan.md),
+ * upgraded to the FileSystem-backed cache layout described in
+ * [skill-cache-fs-backend](../../../../../../.cursor/plans/skill-cache-fs-backend_0191f2c7.plan.md).
+ *
+ * Subcommands:
+ *   list                     List all cached skills (default sorting: newest first).
+ *   inspect <id>             Print full row for a single skill, including action sequence.
+ *   forget <id> | --all      Delete a skill, or wipe the entire cache.
+ *   import <file.json>       Bulk-load skills exported by another store.
+ *   export [<file.json>]     Dump every skill row as JSON (defaults to stdout).
+ *
+ * The store is opened against the directory `~/.beeos/device-agent/skills/`
+ * unless `SKILL_CACHE_PATH` (or `--root <dir>`) overrides it. All output
+ * is text-friendly by default; pass `--json` for machine consumption.
+ *
+ * `--db <path>` is accepted as a deprecated alias for `--root` so old
+ * scripts keep working through one minor release.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { homedir } from "node:os";
+import { defaultSkillCachePath, FileSystemSkillCacheStore, summariseSkill, } from "../../agent-runtime/skills/index.js";
+function parseFlags(argv, stderr) {
+    const flags = {};
+    const positional = [];
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--root") {
+            const v = argv[++i];
+            if (!v)
+                throw new Error("--root requires a directory path");
+            flags.root = v;
+        }
+        else if (a === "--db") {
+            const v = argv[++i];
+            if (!v)
+                throw new Error("--db requires a path");
+            stderr.write("device-agent skills: --db is deprecated; use --root <dir>\n");
+            flags.root = v;
+        }
+        else if (a === "--json") {
+            flags.json = true;
+        }
+        else if (a === "--all") {
+            flags.all = true;
+        }
+        else if (a === "-h" || a === "--help") {
+            flags.help = true;
+        }
+        else if (a.startsWith("--")) {
+            stderr.write(`device-agent skills: ignoring unknown flag ${a}\n`);
+        }
+        else {
+            positional.push(a);
+        }
+    }
+    return { positional, flags };
+}
+function defaultOpenStore(flags) {
+    const root = flags.root ?? process.env.SKILL_CACHE_PATH ?? defaultSkillCachePath();
+    warnOnLegacySqliteCache(root);
+    return new FileSystemSkillCacheStore({ root });
+}
+/**
+ * If a leftover `~/.beeos/device-agent/skills.sqlite` from the
+ * pre-FS-backend Phase 3 build sits next to the new directory, log a
+ * one-line warning so users know it can be removed. The file is *not*
+ * imported — it only ever held bench data, not curated skills.
+ */
+function warnOnLegacySqliteCache(root) {
+    try {
+        const legacy = path.join(homedir(), ".beeos", "device-agent", "skills.sqlite");
+        if (legacy === root)
+            return;
+        if (!fs.existsSync(legacy))
+            return;
+        process.stderr.write(`device-agent skills: ignoring legacy ${legacy} (orphan from the SQLite-era cache; safe to delete)\n`);
+    }
+    catch {
+        // best-effort warning
+    }
+}
+function printUsage(stdout) {
+    stdout.write(`device-agent skills — manage the skill cache (Phase 3)
+
+Usage:
+  device-agent skills <command> [options]
+
+Commands:
+  list                       List every cached skill (newest first)
+  inspect <id>               Show full action sequence + counters for one skill
+  forget <id>                Delete a single skill row
+  forget --all               Wipe every skill row (irreversible)
+  import <file.json>         Append skills from a previous \`export\` dump
+  export [<file.json>]       Dump every skill as JSON (stdout by default)
+
+Options:
+  --root <dir>               Override the cache directory (default ~/.beeos/device-agent/skills/)
+  --db <path>                Deprecated alias for --root
+  --json                     Emit machine-readable JSON (where applicable)
+  -h, --help                 Show this help
+
+Examples:
+  device-agent skills list
+  device-agent skills inspect 3f2a1b1d --json
+  device-agent skills export skills-backup.json
+  device-agent skills import skills-backup.json
+  device-agent skills forget --all
+`);
+}
+export async function skillsCommand(argv, io = {}) {
+    const stdout = io.stdout ?? process.stdout;
+    const stderr = io.stderr ?? process.stderr;
+    const openStore = io.openStore ?? defaultOpenStore;
+    const fsAdapter = io.fs ?? fs;
+    const { positional, flags } = parseFlags(argv, stderr);
+    if (flags.help || positional.length === 0) {
+        printUsage(stdout);
+        return 0;
+    }
+    const sub = positional[0];
+    const args = positional.slice(1);
+    const ctx = { stdout, stderr, openStore, fs: fsAdapter };
+    try {
+        switch (sub) {
+            case "list":
+                return await runList(flags, ctx);
+            case "inspect":
+                return await runInspect(args, flags, ctx);
+            case "forget":
+                return await runForget(args, flags, ctx);
+            case "export":
+                return await runExport(args, flags, ctx);
+            case "import":
+                return await runImport(args, flags, ctx);
+            default:
+                stderr.write(`Unknown subcommand: ${sub}\n`);
+                printUsage(stdout);
+                return 2;
+        }
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        stderr.write(`device-agent skills ${sub}: ${msg}\n`);
+        return 1;
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* subcommands                                                                */
+/* -------------------------------------------------------------------------- */
+async function runList(flags, ctx) {
+    const store = ctx.openStore(flags);
+    try {
+        const rows = store.listAll();
+        if (flags.json) {
+            ctx.stdout.write(`${JSON.stringify(rows.map(toSerialisable), null, 2)}\n`);
+            return 0;
+        }
+        if (rows.length === 0) {
+            ctx.stdout.write("(no cached skills)\n");
+            return 0;
+        }
+        ctx.stdout.write(`${rows.length} skill(s):\n`);
+        for (const r of rows)
+            ctx.stdout.write(`  ${summariseSkill(r)}\n`);
+        return 0;
+    }
+    finally {
+        store.close();
+    }
+}
+async function runInspect(args, flags, ctx) {
+    const id = args[0];
+    if (!id) {
+        ctx.stderr.write("usage: device-agent skills inspect <id>\n");
+        return 2;
+    }
+    const store = ctx.openStore(flags);
+    try {
+        const skill = findSkillByPrefix(store, id);
+        if (!skill) {
+            ctx.stderr.write(`No skill matching id prefix "${id}"\n`);
+            return 1;
+        }
+        if (flags.json) {
+            ctx.stdout.write(`${JSON.stringify(toSerialisable(skill), null, 2)}\n`);
+            return 0;
+        }
+        ctx.stdout.write(`id:           ${skill.id}\n`);
+        ctx.stdout.write(`appPackage:   ${skill.appPackage}\n`);
+        ctx.stdout.write(`taskSummary:  ${skill.taskSummary}\n`);
+        ctx.stdout.write(`successCount: ${skill.successCount}\n`);
+        ctx.stdout.write(`failCount:    ${skill.failCount}\n`);
+        ctx.stdout.write(`lastUsedAt:   ${new Date(skill.lastUsedAt).toISOString()}\n`);
+        ctx.stdout.write(`createdAt:    ${new Date(skill.createdAt).toISOString()}\n`);
+        ctx.stdout.write(`embedding:    ${skill.taskEmbedding ? `${skill.taskEmbedding.length}-dim` : "none"}\n`);
+        ctx.stdout.write(`actions (${skill.actionSequence.length}):\n`);
+        for (const [i, a] of skill.actionSequence.entries()) {
+            ctx.stdout.write(`  ${i + 1}. ${a.type}  ${JSON.stringify({ payload: a.payload, target: a.target })}\n`);
+        }
+        return 0;
+    }
+    finally {
+        store.close();
+    }
+}
+async function runForget(args, flags, ctx) {
+    if (!flags.all && !args[0]) {
+        ctx.stderr.write("usage: device-agent skills forget <id> | --all\n");
+        return 2;
+    }
+    const store = ctx.openStore(flags);
+    try {
+        if (flags.all) {
+            const before = store.listAll().length;
+            store.clear();
+            ctx.stdout.write(`Forgot ${before} skill(s).\n`);
+            return 0;
+        }
+        const id = args[0];
+        const skill = findSkillByPrefix(store, id);
+        if (!skill) {
+            ctx.stderr.write(`No skill matching id prefix "${id}"\n`);
+            return 1;
+        }
+        const ok = store.delete(skill.id);
+        if (!ok) {
+            ctx.stderr.write(`Failed to delete skill ${skill.id}\n`);
+            return 1;
+        }
+        ctx.stdout.write(`Forgot ${skill.id}\n`);
+        return 0;
+    }
+    finally {
+        store.close();
+    }
+}
+async function runExport(args, flags, ctx) {
+    const out = args[0];
+    const store = ctx.openStore(flags);
+    try {
+        const rows = store.listAll();
+        const payload = JSON.stringify(rows.map(toSerialisable), null, 2);
+        if (!out) {
+            ctx.stdout.write(`${payload}\n`);
+            return 0;
+        }
+        ctx.fs.writeFileSync(out, payload);
+        ctx.stdout.write(`Exported ${rows.length} skill(s) to ${out}\n`);
+        return 0;
+    }
+    finally {
+        store.close();
+    }
+}
+async function runImport(args, flags, ctx) {
+    const path = args[0];
+    if (!path) {
+        ctx.stderr.write("usage: device-agent skills import <file.json>\n");
+        return 2;
+    }
+    const raw = ctx.fs.readFileSync(path, "utf8");
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) {
+        ctx.stderr.write("import: file is not a JSON array of skills\n");
+        return 1;
+    }
+    const store = ctx.openStore(flags);
+    try {
+        let inserted = 0;
+        for (const row of parsed) {
+            if (!isSerialisedSkill(row))
+                continue;
+            const embedding = row.taskEmbedding
+                ? new Float32Array(row.taskEmbedding)
+                : undefined;
+            const persisted = store.insert({
+                appPackage: row.appPackage,
+                taskSummary: row.taskSummary,
+                actionSequence: row.actionSequence,
+                taskEmbedding: embedding,
+            });
+            // Replay the success/fail counters so an import doesn't reset
+            // history. `insert` already starts at successCount=1, so the
+            // import only needs to back-fill the remainder.
+            for (let i = 1; i < row.successCount; i++)
+                store.recordSuccess(persisted.id);
+            for (let i = 0; i < row.failCount; i++)
+                store.recordFailure(persisted.id);
+            inserted += 1;
+        }
+        ctx.stdout.write(`Imported ${inserted} skill(s) from ${path}\n`);
+        return 0;
+    }
+    finally {
+        store.close();
+    }
+}
+function toSerialisable(skill) {
+    const out = {
+        id: skill.id,
+        appPackage: skill.appPackage,
+        taskSummary: skill.taskSummary,
+        actionSequence: skill.actionSequence,
+        successCount: skill.successCount,
+        failCount: skill.failCount,
+        lastUsedAt: skill.lastUsedAt,
+        createdAt: skill.createdAt,
+    };
+    if (skill.taskEmbedding)
+        out.taskEmbedding = Array.from(skill.taskEmbedding);
+    return out;
+}
+function isSerialisedSkill(row) {
+    if (typeof row !== "object" || row === null)
+        return false;
+    const r = row;
+    return (typeof r.appPackage === "string" &&
+        typeof r.taskSummary === "string" &&
+        Array.isArray(r.actionSequence) &&
+        typeof r.successCount === "number" &&
+        typeof r.failCount === "number");
+}
+function findSkillByPrefix(store, prefix) {
+    const direct = store.get(prefix);
+    if (direct)
+        return direct;
+    return store.listAll().find((s) => s.id.startsWith(prefix));
+}
+//# sourceMappingURL=skills-command.js.map

package/dist/inbound/cli/skills-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-command.js","sourceRoot":"","sources":["../../../src/inbound/cli/skills-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,cAAc,GAGf,MAAM,qCAAqC,CAAC;AAoB7C,SAAS,UAAU,CACjB,IAAc,EACd,MAAsC;IAEtC,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAC5D,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACjB,CAAC;aAAM,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YAChD,MAAM,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;YAC5E,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACjB,CAAC;aAAM,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;YACzB,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC;QACnB,CAAC;aAAM,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,KAAK,CAAC,8CAA8C,CAAC,IAAI,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAwB;IAChD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,qBAAqB,EAAE,CAAC;IACnF,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,IAAI,yBAAyB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,SAAS,uBAAuB,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC;QAC/E,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO;QAC5B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO;QACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wCAAwC,MAAM,uDAAuD,CACtG,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,MAAsC;IACxD,MAAM,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;CAyBd,CAAC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAc,EACd,KAAsB,EAAE;IAExB,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC3C,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC3C,MAAM,SAAS,GAAG,EAAE,CAAC,SAAS,IAAI,gBAAgB,CAAC;IACnD,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;IAE9B,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvD,IAAI,KAAK,CAAC,IAAI,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,UAAU,CAAC,MAAM,CAAC,CAAC;QACnB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;IACzD,IAAI,CAAC;QACH,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,MAAM;gBACT,OAAO,MAAM,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACnC,KAAK,SAAS;gBACZ,OAAO,MAAM,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YAC5C,KAAK,QAAQ;gBACX,OAAO,MAAM,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YAC3C,KAAK,QAAQ;gBACX,OAAO,MAAM,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YAC3C,KAAK,QAAQ;gBACX,OAAO,MAAM,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YAC3C;gBACE,MAAM,CAAC,KAAK,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;gBAC7C,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,uBAAuB,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC;QACrD,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAYD,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,KAAK,UAAU,OAAO,CAAC,KAAkB,EAAE,GAAW;IACpD,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3E,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACzC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,cAAc,CAAC,CAAC;QAC/C,KAAK,MAAM,CAAC,IAAI,IAAI;YAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACnE,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAc,EAAE,KAAkB,EAAE,GAAW;IACvE,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;YAC1D,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YACxE,OAAO,CAAC,CAAC;QACX,CAAC;QACD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QAChD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;QACxD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;QACzD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;QAC1D,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;QACvD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAChF,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC/E,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;QAC1G,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,cAAc,CAAC,MAAM,MAAM,CAAC,CAAC;QAChE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;YACpD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QAC3G,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAc,EAAE,KAAkB,EAAE,GAAW;IACtE,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACrE,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YACd,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC;YACtC,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,MAAM,cAAc,CAAC,CAAC;YACjD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;YAC1D,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;YACzD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QACzC,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAc,EAAE,KAAkB,EAAE,GAAW;IACtE,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;YACjC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,GAAG,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACnC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,CAAC;QACjE,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAc,EAAE,KAAkB,EAAE,GAAW;IACtE,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACpE,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;QACjE,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC;QACH,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC;gBAAE,SAAS;YACtC,MAAM,SAAS,GAAG,GAAG,CAAC,aAAa;gBACjC,CAAC,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC;gBACrC,CAAC,CAAC,SAAS,CAAC;YACd,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC7B,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,cAAc,EAAE,GAAG,CAAC,cAAc;gBAClC,aAAa,EAAE,SAAS;aACzB,CAAC,CAAC;YACH,8DAA8D;YAC9D,6DAA6D;YAC7D,gDAAgD;YAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,EAAE;gBAAE,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC7E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC,EAAE;gBAAE,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC1E,QAAQ,IAAI,CAAC,CAAC;QAChB,CAAC;QACD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,QAAQ,kBAAkB,IAAI,IAAI,CAAC,CAAC;QACjE,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAkBD,SAAS,cAAc,CAAC,KAAY;IAClC,MAAM,GAAG,GAAsB;QAC7B,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;IACF,IAAI,KAAK,CAAC,aAAa;QAAE,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC7E,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAY;IACrC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,OAAO,CACL,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ;QAChC,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;QACjC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC;QAC/B,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ;QAClC,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,CAChC,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAsB,EAAE,MAAc;IAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/inbound/http/server.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @deprecated Moved to `src/plugins/http-debug/server.ts`. This file
+ * remains as a re-export shim so existing imports (tests, downstream
+ * code) keep working. New code should import from
+ * `@beeos-ai/device-agent/plugins/http-debug/server.js`.
+ */
+export { HttpServer, HttpTaskStore, buildErrorHandler, type HttpServerOptions, type HttpTaskRecord, type HttpTaskStatus, type HttpTaskStep, } from "../../plugins/http-debug/server.js";

package/dist/inbound/http/server.js

@@ -0,0 +1,8 @@
+/**
+ * @deprecated Moved to `src/plugins/http-debug/server.ts`. This file
+ * remains as a re-export shim so existing imports (tests, downstream
+ * code) keep working. New code should import from
+ * `@beeos-ai/device-agent/plugins/http-debug/server.js`.
+ */
+export { HttpServer, HttpTaskStore, buildErrorHandler, } from "../../plugins/http-debug/server.js";
+//# sourceMappingURL=server.js.map

package/dist/inbound/http/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/inbound/http/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,UAAU,EACV,aAAa,EACb,iBAAiB,GAKlB,MAAM,oCAAoC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Public API surface for `@beeos-ai/device-agent`.
+ *
+ * Most users want the CLI binary (`device-agent`); this barrel is for
+ * downstream Node.js consumers that want to embed the device-agent
+ * components programmatically (e.g. tests, beeos-cli `attach`).
+ *
+ * Stability: only the symbols re-exported here are part of the public
+ * contract. Internal modules (`src/agent.ts`, anything under
+ * `inbound/`/`adapters/`) are exposed as deep imports for advanced use
+ * cases but may break between minor versions.
+ */
+export { main } from "./inbound/cli/main.js";
+export { bootstrap, BootstrapError } from "./bootstrap.js";
+export type { BootstrapOptions, BootstrappedAgent } from "./bootstrap.js";
+export { loadConfig } from "./config/loader.js";
+export type { CliFlags } from "./config/loader.js";
+export type { Config as DeviceAgentConfig } from "./config/schema.js";
+export { fetchBridgeConfig, AgentGatewayError, buildAuthHeaders } from "./adapters/agent-gateway-client.js";
+export type { BridgeConfig, AgentGatewayIdentity } from "./adapters/agent-gateway-client.js";
+export { FileIdentity } from "./adapters/identity-file.js";
+export { AndroidAdbAdapter } from "./adapters/device-android-adb.js";
+export { DesktopAdapter } from "./adapters/device-desktop.js";
+export { InnerLoopVlm } from "./adapters/vlm-inner-loop.js";
+export { InnerLoopAgent } from "./adapters/agentcore-inner-loop.js";
+export { PiOrchestratorAgent } from "./adapters/agentcore-pi.js";
+export type { PiOrchestratorAgentOptions, PiOuterConfig } from "./adapters/agentcore-pi.js";
+export { BridgeWsTransport } from "./adapters/transport-bridge-ws.js";
+export { HTTPGrounder } from "./grounding/grounder.js";
+export type { IGrounder, GrounderConfig } from "./grounding/grounder.js";
+export { getPiExtensionContext, peekPiExtensionContext, setPiExtensionContext, } from "./pi-context.js";
+export type { PiExtensionContext } from "./pi-context.js";
+export { DeviceManager } from "./app/device-manager.js";
+export { AgentHostImpl } from "./app/agent-host.js";
+export { SessionManager } from "./app/session-manager.js";
+export { MessageStore } from "./app/message-store.js";
+export { AcpPlugin } from "./plugins/acp/index.js";
+export { HttpDebugPlugin } from "./plugins/http-debug/index.js";
+export { AgentSyncPlugin } from "./plugins/agent-sync/index.js";
+export { HttpServer } from "./inbound/http/server.js";
+export { AcpRouter, bindRouterToTransport } from "./inbound/acp/router.js";
+export type { IAgentCore, AgentCoreRunOptions, AgentCoreRunResult, ToolCallEvent, VlmStep } from "./ports/agent-core.js";
+export type { AgentHost, AgentEvent, SubmittedTask } from "./ports/agent-host.js";
+export type { AgentPlugin, PluginContext } from "./ports/plugin.js";
+export { DeviceError, VlmError, AcpError } from "./core/errors.js";
+export { McpClient, resolveDefaultMcpUrl } from "./mcp-client/index.js";
+export type { McpClientOptions, CallToolResult } from "./mcp-client/index.js";
+export { AgentLoop, AgentRunner, HierarchicalReflector, LLMPlanner, NoOpPlanner, PlanExecutor, actionsEqual, availableAdapters, clearAdapters, makePrediction, MockAdapter, OpenAIAdapter, parsedToAction, registerAdapter as registerModelAdapter, resolveAdapter as resolveModelAdapter, resolveAdapterSync as resolveModelAdapterSync, UITarsAdapter, } from "./agent-runtime/index.js";
+export type { AdapterDescriptor as ModelAdapterDescriptor, AgentErrorCode, AgentErrorEvent, AgentLoopTerminator, AgentRunHooks as AgentLoopRunHooks, AgentRunOptions as AgentLoopRunOptions, AgentRunResult as AgentLoopRunResult, AgentRunnerOptions, AgentRunnerResult, AgentStepEvent, AgentToolEvent, IModelAdapter, IPlanner, LLMPlannerOptions, MockAdapterOptions, ModelUsage, OpenAIAdapterOptions, Plan, PlanContext, PlanExecutorOptions, PlanExecutorResult, PlanStep, PredictHooks, PredictOptions, Prediction, StepHistory, } from "./agent-runtime/index.js";
+export { StickyPortAllocator, defaultFleetStatePath, } from "./fleet/adapters/state/port-allocator.js";
+export type { PortAllocatorOptions } from "./fleet/adapters/state/port-allocator.js";
+export { BeeosCliStore, defaultDevicesPath, } from "./fleet/adapters/state/beeos-cli-store.js";
+export type { BeeosCliStoreOptions } from "./fleet/adapters/state/beeos-cli-store.js";
+export { LocalAdbSource, diffSnapshots, parseSnapshotBody, parseTrackDevicesLine, tryParseFrames, } from "./fleet/adapters/sources/local-adb.js";
+export type { LocalAdbSourceOptions, AdbLogger, } from "./fleet/adapters/sources/local-adb.js";
+export { RemoteAdbSource, resolveEndpoint, } from "./fleet/adapters/sources/remote-adb.js";
+export type { RemoteAdbSourceOptions, RemoteAdbEndpoint, ResolvedEndpoint, } from "./fleet/adapters/sources/remote-adb.js";
+export { NodeProcessManager } from "./fleet/adapters/process/node-process-manager.js";
+export type { HttpProbeFn, ManagedChild, NodeProcessManagerOptions, ProcessManagerLogger, SpawnFn, } from "./fleet/adapters/process/node-process-manager.js";
+export { FleetSupervisor } from "./fleet/supervisor.js";
+export type { FleetSupervisorOptions, SupervisorLogger } from "./fleet/supervisor.js";
+export { StatusServer } from "./fleet/http/status-server.js";
+export type { StatusServerOptions } from "./fleet/http/status-server.js";
+export { FleetStatusClient, FleetClientError } from "./fleet/http/status-client.js";
+export type { DeviceSnapshot, DeviceBinding, DeviceRecord, FleetState } from "./fleet/domain/device.js";
+export declare const VERSION = "0.4.0";

package/dist/index.js

@@ -0,0 +1,48 @@
+/**
+ * Public API surface for `@beeos-ai/device-agent`.
+ *
+ * Most users want the CLI binary (`device-agent`); this barrel is for
+ * downstream Node.js consumers that want to embed the device-agent
+ * components programmatically (e.g. tests, beeos-cli `attach`).
+ *
+ * Stability: only the symbols re-exported here are part of the public
+ * contract. Internal modules (`src/agent.ts`, anything under
+ * `inbound/`/`adapters/`) are exposed as deep imports for advanced use
+ * cases but may break between minor versions.
+ */
+export { main } from "./inbound/cli/main.js";
+export { bootstrap, BootstrapError } from "./bootstrap.js";
+export { loadConfig } from "./config/loader.js";
+export { fetchBridgeConfig, AgentGatewayError, buildAuthHeaders } from "./adapters/agent-gateway-client.js";
+export { FileIdentity } from "./adapters/identity-file.js";
+export { AndroidAdbAdapter } from "./adapters/device-android-adb.js";
+export { DesktopAdapter } from "./adapters/device-desktop.js";
+export { InnerLoopVlm } from "./adapters/vlm-inner-loop.js";
+export { InnerLoopAgent } from "./adapters/agentcore-inner-loop.js";
+export { PiOrchestratorAgent } from "./adapters/agentcore-pi.js";
+export { BridgeWsTransport } from "./adapters/transport-bridge-ws.js";
+export { HTTPGrounder } from "./grounding/grounder.js";
+export { getPiExtensionContext, peekPiExtensionContext, setPiExtensionContext, } from "./pi-context.js";
+export { DeviceManager } from "./app/device-manager.js";
+export { AgentHostImpl } from "./app/agent-host.js";
+export { SessionManager } from "./app/session-manager.js";
+export { MessageStore } from "./app/message-store.js";
+export { AcpPlugin } from "./plugins/acp/index.js";
+export { HttpDebugPlugin } from "./plugins/http-debug/index.js";
+export { AgentSyncPlugin } from "./plugins/agent-sync/index.js";
+export { HttpServer } from "./inbound/http/server.js";
+export { AcpRouter, bindRouterToTransport } from "./inbound/acp/router.js";
+export { DeviceError, VlmError, AcpError } from "./core/errors.js";
+export { McpClient, resolveDefaultMcpUrl } from "./mcp-client/index.js";
+export { AgentLoop, AgentRunner, HierarchicalReflector, LLMPlanner, NoOpPlanner, PlanExecutor, actionsEqual, availableAdapters, clearAdapters, makePrediction, MockAdapter, OpenAIAdapter, parsedToAction, registerAdapter as registerModelAdapter, resolveAdapter as resolveModelAdapter, resolveAdapterSync as resolveModelAdapterSync, UITarsAdapter, } from "./agent-runtime/index.js";
+// ── Fleet (M1–M4) ──────────────────────────────────────────────────────────
+export { StickyPortAllocator, defaultFleetStatePath, } from "./fleet/adapters/state/port-allocator.js";
+export { BeeosCliStore, defaultDevicesPath, } from "./fleet/adapters/state/beeos-cli-store.js";
+export { LocalAdbSource, diffSnapshots, parseSnapshotBody, parseTrackDevicesLine, tryParseFrames, } from "./fleet/adapters/sources/local-adb.js";
+export { RemoteAdbSource, resolveEndpoint, } from "./fleet/adapters/sources/remote-adb.js";
+export { NodeProcessManager } from "./fleet/adapters/process/node-process-manager.js";
+export { FleetSupervisor } from "./fleet/supervisor.js";
+export { StatusServer } from "./fleet/http/status-server.js";
+export { FleetStatusClient, FleetClientError } from "./fleet/http/status-client.js";
+export const VERSION = "0.4.0";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAG3D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIhD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAG5G,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAM3E,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEnE,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGxE,OAAO,EACL,SAAS,EACT,WAAW,EACX,qBAAqB,EACrB,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EACd,eAAe,IAAI,oBAAoB,EACvC,cAAc,IAAI,mBAAmB,EACrC,kBAAkB,IAAI,uBAAuB,EAC7C,aAAa,GACd,MAAM,0BAA0B,CAAC;AA8BlC,8EAA8E;AAE9E,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,0CAA0C,CAAC;AAGlD,OAAO,EACL,aAAa,EACb,kBAAkB,GACnB,MAAM,2CAA2C,CAAC;AAGnD,OAAO,EACL,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,GACf,MAAM,uCAAuC,CAAC;AAM/C,OAAO,EACL,eAAe,EACf,eAAe,GAChB,MAAM,wCAAwC,CAAC;AAOhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kDAAkD,CAAC;AAStF,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAIpF,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/logger/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Structured logger (pino). Singleton — every module imports the same instance.
+ *
+ * Design notes:
+ *  - JSON output for prod (stdout) — easy to grep / ship to Loki etc.
+ *  - Pretty-printed for TTY (when DEVAGENT_PRETTY_LOG=1 or stdout.isTTY).
+ *  - Level overridable via DEVAGENT_LOG_LEVEL env var.
+ *  - Sensitive fields are redacted via pino's built-in `redact` (paths below).
+ *  - Correlation IDs (taskId / sessionId / requestId) are propagated through
+ *    `AsyncLocalStorage` and auto-merged into every log line via the
+ *    `mixin` hook. Inbound layers populate the store with `runWithCorrelation`.
+ */
+import { type Logger } from "pino";
+export interface CorrelationStore {
+    taskId?: string;
+    sessionId?: string;
+    requestId?: string;
+}
+export declare function getLogger(): Logger;
+/** Replace the global logger (tests). */
+export declare function setLogger(l: Logger): void;
+/**
+ * Run `fn` with the supplied correlation context attached to every log line
+ * and to nested `runWithCorrelation` calls. Existing context entries are
+ * preserved unless explicitly overridden in `update`.
+ */
+export declare function runWithCorrelation<T>(update: CorrelationStore, fn: () => T): T;
+/**
+ * Enter a correlation context for the current async resource WITHOUT a callback.
+ * Required for callback-based middleware (Fastify hooks) where wrapping the
+ * downstream handler in `run()` is not possible. Subsequent async work in the
+ * same resource chain inherits the store.
+ */
+export declare function enterCorrelation(update: CorrelationStore): void;
+/** Read the current correlation context (empty object outside any `run` scope). */
+export declare function getCorrelation(): CorrelationStore;
+export type { Logger };

package/dist/logger/index.js

@@ -0,0 +1,84 @@
+/**
+ * Structured logger (pino). Singleton — every module imports the same instance.
+ *
+ * Design notes:
+ *  - JSON output for prod (stdout) — easy to grep / ship to Loki etc.
+ *  - Pretty-printed for TTY (when DEVAGENT_PRETTY_LOG=1 or stdout.isTTY).
+ *  - Level overridable via DEVAGENT_LOG_LEVEL env var.
+ *  - Sensitive fields are redacted via pino's built-in `redact` (paths below).
+ *  - Correlation IDs (taskId / sessionId / requestId) are propagated through
+ *    `AsyncLocalStorage` and auto-merged into every log line via the
+ *    `mixin` hook. Inbound layers populate the store with `runWithCorrelation`.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+import pino from "pino";
+const correlationStorage = new AsyncLocalStorage();
+let instance = null;
+const REDACT_PATHS = [
+    "vlmApiKey",
+    "apiKey",
+    "authorization",
+    "Authorization",
+    "*.vlmApiKey",
+    "*.apiKey",
+    "*.authorization",
+    "*.signature",
+    "*.publicKey",
+    "*.X-Signature",
+    "*.X-Public-Key",
+    "headers.authorization",
+    "headers.Authorization",
+    "headers.X-Signature",
+    "headers.X-Public-Key",
+];
+export function getLogger() {
+    if (instance)
+        return instance;
+    const level = (process.env.DEVAGENT_LOG_LEVEL ?? "info").toLowerCase();
+    const pretty = process.env.DEVAGENT_PRETTY_LOG === "1" ||
+        (process.env.DEVAGENT_PRETTY_LOG !== "0" && process.stdout.isTTY);
+    instance = pino({
+        level,
+        base: { service: "device-agent" },
+        timestamp: pino.stdTimeFunctions.isoTime,
+        redact: { paths: REDACT_PATHS, censor: "[REDACTED]" },
+        mixin() {
+            const store = correlationStorage.getStore();
+            return store ? { ...store } : {};
+        },
+    }, pretty
+        ? pino.transport({
+            target: "pino-pretty",
+            options: { colorize: true, translateTime: "SYS:HH:MM:ss.l" },
+        })
+        : undefined);
+    return instance;
+}
+/** Replace the global logger (tests). */
+export function setLogger(l) {
+    instance = l;
+}
+/**
+ * Run `fn` with the supplied correlation context attached to every log line
+ * and to nested `runWithCorrelation` calls. Existing context entries are
+ * preserved unless explicitly overridden in `update`.
+ */
+export function runWithCorrelation(update, fn) {
+    const current = correlationStorage.getStore() ?? {};
+    return correlationStorage.run({ ...current, ...update }, fn);
+}
+/**
+ * Enter a correlation context for the current async resource WITHOUT a callback.
+ * Required for callback-based middleware (Fastify hooks) where wrapping the
+ * downstream handler in `run()` is not possible. Subsequent async work in the
+ * same resource chain inherits the store.
+ */
+export function enterCorrelation(update) {
+    const current = correlationStorage.getStore() ?? {};
+    correlationStorage.enterWith({ ...current, ...update });
+}
+/** Read the current correlation context (empty object outside any `run` scope). */
+export function getCorrelation() {
+    return correlationStorage.getStore() ?? {};
+}
+//# sourceMappingURL=index.js.map

package/dist/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,IAAqB,MAAM,MAAM,CAAC;AAQzC,MAAM,kBAAkB,GAAG,IAAI,iBAAiB,EAAoB,CAAC;AAErE,IAAI,QAAQ,GAAkB,IAAI,CAAC;AAEnC,MAAM,YAAY,GAAG;IACnB,WAAW;IACX,QAAQ;IACR,eAAe;IACf,eAAe;IACf,aAAa;IACb,UAAU;IACV,iBAAiB;IACjB,aAAa;IACb,aAAa;IACb,eAAe;IACf,gBAAgB;IAChB,uBAAuB;IACvB,uBAAuB;IACvB,qBAAqB;IACrB,sBAAsB;CACvB,CAAC;AAEF,MAAM,UAAU,SAAS;IACvB,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IACvE,MAAM,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,GAAG;QACvC,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEpE,QAAQ,GAAG,IAAI,CACb;QACE,KAAK;QACL,IAAI,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE;QACjC,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO;QACxC,MAAM,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE;QACrD,KAAK;YACH,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,EAAE,CAAC;YAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,CAAC;KACF,EACD,MAAM;QACJ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,gBAAgB,EAAE;SAC7D,CAAC;QACJ,CAAC,CAAC,SAAS,CACd,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,QAAQ,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAI,MAAwB,EAAE,EAAW;IACzE,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IACpD,OAAO,kBAAkB,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IACpD,kBAAkB,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,cAAc;IAC5B,OAAO,kBAAkB,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC7C,CAAC"}