@beeos-ai/device-agent 0.4.3 → 0.5.1

package/dist/resources/lifecycle/manager.js.map

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

package/dist/resources/lifecycle/sweeper.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Resource Lifecycle — L2 (background TTL sweep).
+ *
+ * Runs on a fixed interval; deletes any file under the sandbox dirs
+ * matching `beeos_*` whose mtime is older than `sweepAgeHours`.
+ *
+ * Why this layer is independent from L1:
+ *   L1 misses anytime the daemon dies between `agent.run()` returning
+ *   and the L1 timer firing — `kill -9`, OOM, machine reboot, plist
+ *   `bootout`, … L2 is the safety net that walks the same tree on a
+ *   timer and wipes orphans regardless of which task originally pushed
+ *   them. The two layers cooperate because they target the SAME
+ *   sandbox directory and the SAME `beeos_` filename prefix.
+ *
+ * Why we go through `find … -delete` (and not Node's fs.rm):
+ *   The files live on the device at `/sdcard/...`, accessible only
+ *   over `adb shell` / the MCP `executeCommand` channel. We have no
+ *   FUSE mount, no network filesystem; the only thing we can do is
+ *   issue a shell command. `find` is in BusyBox/toybox on every
+ *   Android shipping in the last decade, and `-mmin` + `-delete` are
+ *   universal flags.
+ */
+import type { LifecycleWiring, ResourceLifecycleSweeper } from "./types.js";
+export declare class FsResourceLifecycleSweeper implements ResourceLifecycleSweeper {
+    private readonly wiring;
+    private timer;
+    /** Set during a sweep so we never run two in parallel. */
+    private inFlight;
+    private platform;
+    constructor(wiring: LifecycleWiring);
+    start(): void;
+    stop(): Promise<void>;
+    sweepNow(): Promise<number>;
+    private detectPlatform;
+    private doSweep;
+}

package/dist/resources/lifecycle/sweeper.js

@@ -0,0 +1,179 @@
+/**
+ * Resource Lifecycle — L2 (background TTL sweep).
+ *
+ * Runs on a fixed interval; deletes any file under the sandbox dirs
+ * matching `beeos_*` whose mtime is older than `sweepAgeHours`.
+ *
+ * Why this layer is independent from L1:
+ *   L1 misses anytime the daemon dies between `agent.run()` returning
+ *   and the L1 timer firing — `kill -9`, OOM, machine reboot, plist
+ *   `bootout`, … L2 is the safety net that walks the same tree on a
+ *   timer and wipes orphans regardless of which task originally pushed
+ *   them. The two layers cooperate because they target the SAME
+ *   sandbox directory and the SAME `beeos_` filename prefix.
+ *
+ * Why we go through `find … -delete` (and not Node's fs.rm):
+ *   The files live on the device at `/sdcard/...`, accessible only
+ *   over `adb shell` / the MCP `executeCommand` channel. We have no
+ *   FUSE mount, no network filesystem; the only thing we can do is
+ *   issue a shell command. `find` is in BusyBox/toybox on every
+ *   Android shipping in the last decade, and `-mmin` + `-delete` are
+ *   universal flags.
+ */
+/**
+ * Image / video / audio / Download — the four well-known dirs the
+ * Android adapter routes downloads into. The sandbox subdir gets
+ * appended to each at sweep time so a single sweep covers every
+ * MIME bucket.
+ *
+ * If a future adapter adds a new bucket (`/sdcard/Books`, say),
+ * extend this list — no other change needed for the sweeper.
+ */
+const ANDROID_SANDBOX_ROOTS = [
+    "/sdcard/Pictures",
+    "/sdcard/Movies",
+    "/sdcard/Music",
+    "/sdcard/Download",
+];
+export class FsResourceLifecycleSweeper {
+    wiring;
+    timer = null;
+    /** Set during a sweep so we never run two in parallel. */
+    inFlight = null;
+    platform = null;
+    constructor(wiring) {
+        this.wiring = wiring;
+    }
+    start() {
+        if (this.wiring.config.mode === "off")
+            return;
+        if (this.timer)
+            return;
+        const intervalMs = Math.max(1, this.wiring.config.sweepIntervalMinutes) * 60 * 1000;
+        this.timer = setInterval(() => {
+            // Fire-and-forget — sweep failures are logged inside `sweepNow`.
+            void this.sweepNow().catch((e) => {
+                this.wiring.log.warn({ err: errString(e) }, "lifecycle.sweeper: scheduled sweep threw");
+            });
+        }, intervalMs);
+        if (typeof this.timer.unref === "function") {
+            this.timer.unref();
+        }
+        this.wiring.log.info({
+            mode: this.wiring.config.mode,
+            intervalMinutes: this.wiring.config.sweepIntervalMinutes,
+            ageHours: this.wiring.config.sweepAgeHours,
+            sandboxSubdir: this.wiring.config.sandboxSubdir,
+        }, "lifecycle.sweeper: started");
+    }
+    async stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        // Allow an in-flight sweep to finish so its `executeCommand`
+        // promises resolve before we tell the caller "stopped".
+        if (this.inFlight) {
+            try {
+                await this.inFlight;
+            }
+            catch {
+                /* already logged */
+            }
+        }
+    }
+    async sweepNow() {
+        if (this.inFlight)
+            return this.inFlight;
+        this.inFlight = this.doSweep().finally(() => {
+            this.inFlight = null;
+        });
+        return this.inFlight;
+    }
+    // ── Internals ───────────────────────────────────────────────────────────
+    async detectPlatform() {
+        if (this.platform !== null)
+            return this.platform;
+        try {
+            const info = await this.wiring.device.getInfo();
+            this.platform = (info.os ?? info.type ?? "").toString().toLowerCase();
+        }
+        catch {
+            this.platform = "";
+        }
+        return this.platform;
+    }
+    async doSweep() {
+        if (this.wiring.config.mode === "off")
+            return 0;
+        const platform = await this.detectPlatform();
+        if (platform !== "android")
+            return 0;
+        let mcp;
+        try {
+            mcp = this.wiring.mcpProvider();
+        }
+        catch (e) {
+            this.wiring.log.warn({ err: errString(e) }, "lifecycle.sweeper: mcpProvider() threw");
+            return 0;
+        }
+        if (typeof mcp.executeCommand !== "function")
+            return 0;
+        const subdir = this.wiring.config.sandboxSubdir.replace(/^\/+|\/+$/g, "");
+        const ageMinutes = Math.max(0, this.wiring.config.sweepAgeHours) * 60;
+        let totalDeleted = 0;
+        for (const root of ANDROID_SANDBOX_ROOTS) {
+            const dir = subdir ? `${root}/${subdir}` : root;
+            // The `[ -d "$dir" ]` guard avoids spamming logs with "No such
+            // file or directory" the first time the agent boots on a fresh
+            // device that hasn't downloaded anything yet.
+            // We list files first so we know how many got deleted (find
+            // -delete on busybox doesn't echo names).
+            const listCmd = `[ -d ${shellQuote(dir)} ] || exit 0; ` +
+                `find ${shellQuote(dir)} -maxdepth 1 -type f -name 'beeos_*' -mmin +${ageMinutes} -print 2>/dev/null || true`;
+            let stdout = "";
+            try {
+                const r = await mcp.executeCommand(listCmd);
+                stdout = (r.stdout ?? "").trim();
+            }
+            catch (e) {
+                this.wiring.log.warn({ dir, err: errString(e) }, "lifecycle.sweeper: list step failed");
+                continue;
+            }
+            if (!stdout)
+                continue;
+            const targets = stdout.split(/\r?\n/).filter(Boolean);
+            // Issue one batched `rm -f` per directory so we don't burn a
+            // full shell roundtrip per file on a big backlog.
+            // No MediaScanner broadcast here: these are 24h+ orphans, the
+            // gallery long ago dropped their thumbnails, and a per-file
+            // `am broadcast` on a 100+ backlog would burn several seconds
+            // of shell roundtrips for no observable user benefit. L1 keeps
+            // its broadcast because freshly-deleted files might still be
+            // open in a picker preview.
+            const rmCmd = targets.map((p) => `rm -f ${shellQuote(p)}`).join(" ; ") + " ; :";
+            try {
+                await mcp.executeCommand(rmCmd);
+            }
+            catch (e) {
+                this.wiring.log.warn({ dir, count: targets.length, err: errString(e) }, "lifecycle.sweeper: rm batch failed");
+                continue;
+            }
+            this.wiring.log.info({ dir, count: targets.length, ageHours: this.wiring.config.sweepAgeHours }, "lifecycle.sweeper: swept dir");
+            totalDeleted += targets.length;
+        }
+        if (totalDeleted > 0) {
+            this.wiring.log.info({ totalDeleted, ageHours: this.wiring.config.sweepAgeHours }, "lifecycle.sweeper: pass complete");
+        }
+        return totalDeleted;
+    }
+}
+function shellQuote(s) {
+    return `'${s.replace(/'/g, "'\\''")}'`;
+}
+function errString(e) {
+    if (e instanceof Error)
+        return e.message;
+    return String(e);
+}
+//# sourceMappingURL=sweeper.js.map

package/dist/resources/lifecycle/sweeper.js.map

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

package/dist/resources/lifecycle/types.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Resource Lifecycle — type contracts for the three-layer GC.
+ *
+ * The Resource Resolution Layer must land URL-derived bytes on the
+ * device's external storage so platform-native pickers (Photos,
+ * Gallery, WeChat moments composer, …) can index them via MediaStore.
+ * Once a single task has finished — i.e. the picker has copied the
+ * file into the consuming app's sandbox via `ContentProvider.openInputStream`
+ * — the original device-side file is dead weight.
+ *
+ * Without explicit reclamation a long-running daemon would accumulate
+ * gigabytes of orphan resources. We model this as a classic three-layer
+ * garbage collector, mirroring the structure of any robust resource
+ * manager (Linux page cache, browser HTTP cache, JVM GC):
+ *
+ *   L1 — per-task ephemeral cleanup
+ *        Happy-path tracking. Each task has a finite lifetime; when
+ *        `agent.run()` returns / throws / aborts, schedule a delete
+ *        of every fresh resource the task pushed (plus a small grace
+ *        window so async picker uploads finish first).
+ *
+ *   L2 — background TTL sweep
+ *        Crash / kill -9 / unclean shutdown safety net. Runs on a
+ *        timer; deletes any `beeos_*` file under the sandbox root
+ *        whose mtime is older than `sweepAgeHours`.
+ *
+ *   L3 — disk-pressure adaptive sweep
+ *        Per-write check that prevents the agent from filling the
+ *        device's external storage. Triggers a force-sweep when
+ *        free space drops below `diskMinFreeMb`; rejects the resolve
+ *        with `disk_pressure` if free space stays below
+ *        `diskCriticalFreeMb` after sweeping.
+ *
+ * Each layer fail-softs to the next: L1 misses (crash / no finally) →
+ * L2 catches; L2 misses (daemon never idle, sweeper paused) → L3
+ * catches. Stacked, they are asymptotically complete.
+ *
+ * Why this lives next to `resources/` and not in `app/`:
+ *   - the lifecycle is **about** resources (their identity, their
+ *     storage path, their cache invalidation contract).
+ *   - the AgentHost only needs to call `trackFresh(taskId, asset)` and
+ *     `onTaskEnd(taskId)` — it does not need to know about sweeps,
+ *     TTLs, or `df`/`find` shell commands.
+ */
+import type { IDevice } from "../../ports/device.js";
+import type { IMcpRuntime } from "../../mcp-client/runtime.js";
+import type { ResolvedAsset, ResolverLogger } from "../types.js";
+import type { ResourceResolutionCache } from "../cache.js";
+/**
+ * Cleanup policy for fresh per-task resources.
+ *
+ *   - `ephemeral`  — when a task ends, schedule a delayed delete of
+ *                    every fresh resource it pushed. This is the
+ *                    default; `app sandbox` already has its own copy
+ *                    and the original file is no longer addressable.
+ *   - `persistent` — never delete from L1. The user wants resources
+ *                    to remain in the gallery until L2 / L3 reclaims
+ *                    them on age / pressure grounds.
+ *   - `off`        — disable the entire lifecycle subsystem. L2/L3
+ *                    don't run either. Useful for diagnostics or
+ *                    deployments where the agent shares /sdcard with
+ *                    long-lived user data the operator hand-manages.
+ */
+export type LifecycleMode = "ephemeral" | "persistent" | "off";
+/**
+ * Static configuration consumed by the lifecycle subsystem. Loaded
+ * from `[resources.lifecycle]` in the user config; sane defaults
+ * defined alongside the schema in `config/schema.ts`.
+ */
+export interface ResourceLifecycleConfig {
+    /** Cleanup policy. See {@link LifecycleMode}. */
+    readonly mode: LifecycleMode;
+    /**
+     * Subdirectory under each well-known dir (`/sdcard/Pictures/<sub>`,
+     * `/sdcard/Movies/<sub>`, …) the lifecycle is allowed to wipe. The
+     * **same** value MUST be passed to the device adapter (or the
+     * sweeper would scan a different directory than the resolver writes
+     * into). The host fans this single config knob out to both layers
+     * at bootstrap time.
+     */
+    readonly sandboxSubdir: string;
+    /**
+     * Grace window between `task:end` and the actual L1 `rm`. Some
+     * pickers (e.g. WeChat) keep an async upload running for a couple
+     * of seconds after the user taps Send; deleting too eagerly causes
+     * the upload to fail with `FileNotFoundException`. 60s is a safe
+     * default — well above any picker's observed window, well below
+     * the L2 TTL.
+     */
+    readonly perTaskDeleteDelaySec: number;
+    /** Cadence of the L2 background sweeper. */
+    readonly sweepIntervalMinutes: number;
+    /** Files older than this are considered orphans by L2. */
+    readonly sweepAgeHours: number;
+    /**
+     * If `df` reports free MB below this threshold, L3 forces a sweep
+     * before letting the resolver write. Free space is checked AFTER
+     * the sweep too (see `diskCriticalFreeMb`).
+     */
+    readonly diskMinFreeMb: number;
+    /**
+     * If free MB is *still* below this after the L3 force-sweep, the
+     * resolve is rejected with `disk_pressure`. By convention should be
+     * less than `diskMinFreeMb` so the two thresholds form a hysteresis
+     * band; misordering only causes extra rejections, never data loss.
+     */
+    readonly diskCriticalFreeMb: number;
+}
+/**
+ * L1 — per-task lifecycle manager.
+ *
+ * `trackFresh` records a fresh asset that the running task created
+ * (cache hits MUST NOT be tracked: those belong to whichever earlier
+ * task originally fetched them, and the cache layer already handles
+ * staleness via `validateAlive`).
+ *
+ * `onTaskEnd` is called from `AgentHost.runOne`'s `finally` clause.
+ * The manager schedules the actual delete after
+ * `perTaskDeleteDelaySec`, which is also when the cache key is
+ * invalidated and MediaScanner is poked so the gallery view drops
+ * the thumbnail.
+ *
+ * `flushPending` is a shutdown helper that fires every still-armed
+ * timer immediately, so SIGTERM doesn't leak orphan files.
+ */
+export interface ResourceLifecycleManager {
+    /**
+     * Record a fresh asset created by the named task. Cache hits MUST
+     * NOT call this — only assets returned by a real network resolve.
+     */
+    trackFresh(taskId: string, asset: ResolvedAsset): void;
+    /**
+     * Schedule cleanup for every asset registered against `taskId`.
+     * Idempotent — calling twice for the same id is a no-op (e.g. when
+     * `runOne` retries `finally` because of a thrown listener).
+     */
+    onTaskEnd(taskId: string): Promise<void>;
+    /**
+     * Best-effort: fire every pending L1 timer NOW (used by the SIGTERM
+     * shutdown hook). Returns once all `executeCommand` round-trips
+     * settled.
+     */
+    flushPending(): Promise<void>;
+}
+/**
+ * L2 — background TTL sweeper. Owned by bootstrap; started after
+ * the agent is ready, stopped on shutdown.
+ */
+export interface ResourceLifecycleSweeper {
+    /** Begin periodic sweeps. Idempotent; calling start twice is a no-op. */
+    start(): void;
+    /** Cancel the timer; in-flight sweep is allowed to finish. */
+    stop(): Promise<void>;
+    /**
+     * Run a sweep right now (used by L3 force-sweep + tests). Resolves
+     * with the number of files deleted so callers can decide whether
+     * to retry the failed write.
+     */
+    sweepNow(): Promise<number>;
+}
+/**
+ * Wiring blob the bootstrap hands the lifecycle implementations.
+ *
+ * Kept as a discrete struct so tests can construct managers without
+ * spinning up a real device or MCP. `device` is used only for
+ * platform detection (the entire lifecycle is a no-op on non-Android
+ * because MediaStore + /sdcard semantics are Android-specific).
+ */
+export interface LifecycleWiring {
+    /** Active device, used to detect platform. */
+    readonly device: IDevice;
+    /** Live MCP runtime resolver — the same callback the AgentHost uses. */
+    readonly mcpProvider: () => IMcpRuntime;
+    /** Resource cache — invalidated when L1 deletes a tracked asset. */
+    readonly cache?: ResourceResolutionCache;
+    /** Structured logger (typically a child of the bootstrap logger). */
+    readonly log: ResolverLogger;
+    /** Static configuration (from `[resources.lifecycle]`). */
+    readonly config: ResourceLifecycleConfig;
+}

package/dist/resources/lifecycle/types.js

@@ -0,0 +1,46 @@
+/**
+ * Resource Lifecycle — type contracts for the three-layer GC.
+ *
+ * The Resource Resolution Layer must land URL-derived bytes on the
+ * device's external storage so platform-native pickers (Photos,
+ * Gallery, WeChat moments composer, …) can index them via MediaStore.
+ * Once a single task has finished — i.e. the picker has copied the
+ * file into the consuming app's sandbox via `ContentProvider.openInputStream`
+ * — the original device-side file is dead weight.
+ *
+ * Without explicit reclamation a long-running daemon would accumulate
+ * gigabytes of orphan resources. We model this as a classic three-layer
+ * garbage collector, mirroring the structure of any robust resource
+ * manager (Linux page cache, browser HTTP cache, JVM GC):
+ *
+ *   L1 — per-task ephemeral cleanup
+ *        Happy-path tracking. Each task has a finite lifetime; when
+ *        `agent.run()` returns / throws / aborts, schedule a delete
+ *        of every fresh resource the task pushed (plus a small grace
+ *        window so async picker uploads finish first).
+ *
+ *   L2 — background TTL sweep
+ *        Crash / kill -9 / unclean shutdown safety net. Runs on a
+ *        timer; deletes any `beeos_*` file under the sandbox root
+ *        whose mtime is older than `sweepAgeHours`.
+ *
+ *   L3 — disk-pressure adaptive sweep
+ *        Per-write check that prevents the agent from filling the
+ *        device's external storage. Triggers a force-sweep when
+ *        free space drops below `diskMinFreeMb`; rejects the resolve
+ *        with `disk_pressure` if free space stays below
+ *        `diskCriticalFreeMb` after sweeping.
+ *
+ * Each layer fail-softs to the next: L1 misses (crash / no finally) →
+ * L2 catches; L2 misses (daemon never idle, sweeper paused) → L3
+ * catches. Stacked, they are asymptotically complete.
+ *
+ * Why this lives next to `resources/` and not in `app/`:
+ *   - the lifecycle is **about** resources (their identity, their
+ *     storage path, their cache invalidation contract).
+ *   - the AgentHost only needs to call `trackFresh(taskId, asset)` and
+ *     `onTaskEnd(taskId)` — it does not need to know about sweeps,
+ *     TTLs, or `df`/`find` shell commands.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/resources/lifecycle/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/resources/lifecycle/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG"}

package/dist/resources/parsers.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Resource Parsers — extract `ResourceRef`s from a free-form task string.
+ *
+ * The Phase 1 implementation ships a single, conservative URL parser.
+ * Adding new parsers (file://, data:, geo:) is a matter of dropping a
+ * new module beside this one and registering it in the host bootstrap.
+ *
+ * Conservative: we deliberately avoid shipping liberal regexes that
+ * match every-string-with-a-dot. False positives here translate into
+ * unwanted network calls during the resolve phase, which (a) burn
+ * SSRF allow-list checks, (b) confuse the augmenter ("Resources
+ * prepared: <some random word>"), and (c) slow down every task.
+ */
+import type { ResourceParser, ResourceRef } from "./types.js";
+export declare class UrlParser implements ResourceParser {
+    readonly name = "url";
+    parse(task: string): ResourceRef[];
+}
+export declare class BeeosFileParser implements ResourceParser {
+    readonly name = "beeos-file";
+    parse(task: string): ResourceRef[];
+}
+/**
+ * Convenience: build the default parser set used by the AgentHost
+ * registry. Exported so tests / alternate hosts can swap individual
+ * parsers without rebuilding the list.
+ */
+export declare function defaultParsers(): ResourceParser[];

package/dist/resources/parsers.js

@@ -0,0 +1,88 @@
+/**
+ * Resource Parsers — extract `ResourceRef`s from a free-form task string.
+ *
+ * The Phase 1 implementation ships a single, conservative URL parser.
+ * Adding new parsers (file://, data:, geo:) is a matter of dropping a
+ * new module beside this one and registering it in the host bootstrap.
+ *
+ * Conservative: we deliberately avoid shipping liberal regexes that
+ * match every-string-with-a-dot. False positives here translate into
+ * unwanted network calls during the resolve phase, which (a) burn
+ * SSRF allow-list checks, (b) confuse the augmenter ("Resources
+ * prepared: <some random word>"), and (c) slow down every task.
+ */
+/**
+ * Match plain http/https URLs anywhere in a task string.
+ *
+ * Kept intentionally close to the RFC 3986 reserved-characters set so
+ * we don't accidentally absorb trailing punctuation. The negative
+ * look-behind for `[a-zA-Z]` after the scheme prevents matching
+ * `mailto:foo@http://x` style edge cases.
+ */
+const URL_RE = /\bhttps?:\/\/[^\s<>"'\u3000\u00A0`]+/giu;
+/**
+ * Trailing punctuation that we strip — these are commonly part of the
+ * surrounding sentence rather than the URL itself ("see https://x.y/z.").
+ */
+const TRAILING_PUNCT_RE = /[)\].,;:!?'"`]+$/u;
+export class UrlParser {
+    name = "url";
+    parse(task) {
+        if (!task)
+            return [];
+        const seen = new Set();
+        const out = [];
+        const matches = task.matchAll(URL_RE);
+        for (const m of matches) {
+            const raw = m[0];
+            const cleaned = raw.replace(TRAILING_PUNCT_RE, "");
+            if (!cleaned)
+                continue;
+            if (seen.has(cleaned))
+                continue;
+            seen.add(cleaned);
+            out.push({ kind: "url", url: cleaned });
+        }
+        return out;
+    }
+}
+/**
+ * Match `beeos-file://<fileId>` URIs. The web UI emits these for every
+ * file the user uploads through the chat input; the
+ * `normalizePrompt` step appends each `resource_link.uri` to the prompt
+ * verbatim, so the URI shows up here as plain text.
+ *
+ * `fileId` is constrained to a conservative URL-safe character class to
+ * keep false positives (e.g. matching unrelated `beeos-file://` substrings
+ * embedded in user prose) from flooding the resolve queue. The web UI
+ * generates fileIds that are alphanumeric + dash/underscore (UUID-shaped
+ * or random ids), all of which match `[A-Za-z0-9_-]+`.
+ */
+const BEEOS_FILE_RE = /\bbeeos-file:\/\/([A-Za-z0-9_-]+)\b/giu;
+export class BeeosFileParser {
+    name = "beeos-file";
+    parse(task) {
+        if (!task)
+            return [];
+        const seen = new Set();
+        const out = [];
+        const matches = task.matchAll(BEEOS_FILE_RE);
+        for (const m of matches) {
+            const fileId = m[1];
+            if (!fileId || seen.has(fileId))
+                continue;
+            seen.add(fileId);
+            out.push({ kind: "beeos-file", fileId });
+        }
+        return out;
+    }
+}
+/**
+ * Convenience: build the default parser set used by the AgentHost
+ * registry. Exported so tests / alternate hosts can swap individual
+ * parsers without rebuilding the list.
+ */
+export function defaultParsers() {
+    return [new UrlParser(), new BeeosFileParser()];
+}
+//# sourceMappingURL=parsers.js.map

package/dist/resources/parsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.js","sourceRoot":"","sources":["../../src/resources/parsers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,yCAAyC,CAAC;AAEzD;;;GAGG;AACH,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAE9C,MAAM,OAAO,SAAS;IACX,IAAI,GAAG,KAAK,CAAC;IAEtB,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,GAAG,GAAkB,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACjB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;YACnD,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,SAAS;YAChC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAClB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,aAAa,GAAG,wCAAwC,CAAC;AAE/D,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,YAAY,CAAC;IAE7B,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,GAAG,GAAkB,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,SAAS;YAC1C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACjB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,IAAI,SAAS,EAAE,EAAE,IAAI,eAAe,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/resources/registry.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Resource Resolver Registry — owns the parser/resolver dispatch and
+ * the `resolveAll(task)` orchestration entry point.
+ *
+ * Lifecycle:
+ *  1. Bootstrap constructs one registry per AgentHost.
+ *  2. AgentHost.submitTask calls `parseAll(prompt)` to extract refs.
+ *  3. For each ref, registry picks the first matching `ResourceResolver`
+ *     and delegates resolution. Parallel where possible.
+ *  4. Failures are isolated: one bad URL must not poison the rest of
+ *     the task. The host falls back to the original prompt only when
+ *     every resolution failed (or zero refs were found).
+ *
+ * The registry stays explicit about its dependencies (`ResolverContext`)
+ * so unit tests can wire it up without bootstrap.
+ */
+import type { ResolvedAsset, ResolverContext, ResourceParser, ResourceRef, ResourceResolver } from "./types.js";
+export interface ResolveAllResult {
+    /** Successfully resolved assets. */
+    assets: ResolvedAsset[];
+    /** Per-ref errors (parallel array; one entry per failed ref). */
+    errors: {
+        ref: ResourceRef;
+        error: Error;
+    }[];
+    /** Refs the registry chose to skip (e.g. no resolver matched). */
+    skipped: ResourceRef[];
+}
+export interface ResolverRegistryOptions {
+    parsers: ResourceParser[];
+    resolvers: ResourceResolver[];
+}
+export declare class ResourceResolverRegistry {
+    private readonly parsers;
+    private readonly resolvers;
+    constructor(opts: ResolverRegistryOptions);
+    /** Run every registered parser; deduplicate by JSON-canonical key. */
+    parseAll(task: string): ResourceRef[];
+    /**
+     * Resolve every ref present in the task. Returns successfully
+     * resolved assets; failures are surfaced via the `errors` array but
+     * never thrown — the AgentHost is responsible for falling back to
+     * the original prompt when no asset survived.
+     */
+    resolveAll(task: string, ctx: ResolverContext): Promise<ResolveAllResult>;
+    private pick;
+}