@beeos-ai/device-agent 0.4.0

package/dist/inbound/acp/handlers/device.d.ts

@@ -0,0 +1,43 @@
+/**
+ * ACP `device/*` handlers (6 methods).
+ *
+ * Wire format is preserved byte-for-byte (matches the Python reference and
+ * existing ACP clients):
+ *  - device/info        → DeviceInfo dataclass shape
+ *  - device/screenshot  → { image: <base64>, format: "png"|"jpeg" }
+ *  - device/ui-tree     → { nodes: UiNode[] }
+ *  - device/action      → { status: "ok", action: <verb> }
+ *  - device/install     → { status: "ok" }
+ *  - device/shell       → { output: <stdout> }
+ *
+ * Internally the handlers route through an `IMcpRuntime` provider — either
+ * the sibling `device-mcp-server` (HTTP) or the legacy in-process bridge.
+ * The `parseAcpAction()` translator (in `@beeos-ai/device-common`) maps the
+ * ACP wire vocabulary onto the unified `Action` schema, which the MCP
+ * runtime then dispatches.
+ */
+import type { IMcpRuntime } from "../../../mcp-client/runtime.js";
+export interface AcpDeviceHandlersOptions {
+    /**
+     * Lazy resolver for the MCP runtime — invoked per request so callers can
+     * swap the underlying runtime (autospawn restart, ACP device switch) at
+     * runtime without recreating the handlers.
+     */
+    mcpProvider: () => IMcpRuntime;
+}
+export declare class AcpDeviceHandlers {
+    private readonly mcpProvider;
+    constructor(provider: AcpDeviceHandlersOptions | (() => IMcpRuntime));
+    info(_msg: AcpMessage): Promise<Record<string, unknown>>;
+    screenshot(_msg: AcpMessage): Promise<Record<string, unknown>>;
+    uiTree(_msg: AcpMessage): Promise<Record<string, unknown>>;
+    action(msg: AcpMessage): Promise<Record<string, unknown>>;
+    install(msg: AcpMessage): Promise<Record<string, unknown>>;
+    shell(msg: AcpMessage): Promise<Record<string, unknown>>;
+}
+export interface AcpMessage {
+    jsonrpc?: string;
+    id?: string | number | null;
+    method?: string;
+    params?: Record<string, unknown>;
+}

package/dist/inbound/acp/handlers/device.js

@@ -0,0 +1,153 @@
+/**
+ * ACP `device/*` handlers (6 methods).
+ *
+ * Wire format is preserved byte-for-byte (matches the Python reference and
+ * existing ACP clients):
+ *  - device/info        → DeviceInfo dataclass shape
+ *  - device/screenshot  → { image: <base64>, format: "png"|"jpeg" }
+ *  - device/ui-tree     → { nodes: UiNode[] }
+ *  - device/action      → { status: "ok", action: <verb> }
+ *  - device/install     → { status: "ok" }
+ *  - device/shell       → { output: <stdout> }
+ *
+ * Internally the handlers route through an `IMcpRuntime` provider — either
+ * the sibling `device-mcp-server` (HTTP) or the legacy in-process bridge.
+ * The `parseAcpAction()` translator (in `@beeos-ai/device-common`) maps the
+ * ACP wire vocabulary onto the unified `Action` schema, which the MCP
+ * runtime then dispatches.
+ */
+import * as os from "node:os";
+import * as path from "node:path";
+import { parseAcpAction } from "@beeos-ai/device-common";
+import { searchUiXmlNodes } from "../../../device/ui-xml.js";
+import { AcpError, DeviceError } from "../../../core/errors.js";
+export class AcpDeviceHandlers {
+    mcpProvider;
+    constructor(provider) {
+        this.mcpProvider =
+            typeof provider === "function" ? provider : provider.mcpProvider;
+    }
+    async info(_msg) {
+        const mcp = this.mcpProvider();
+        if (!mcp.info) {
+            throw new DeviceError("device/info is not supported on this MCP runtime", { subtype: "internal_error" });
+        }
+        const info = await mcp.info();
+        return serializeDeviceInfo(info);
+    }
+    async screenshot(_msg) {
+        const mcp = this.mcpProvider();
+        const ss = await mcp.screenshot();
+        return { image: ss.b64, format: ss.format };
+    }
+    async uiTree(_msg) {
+        const mcp = this.mcpProvider();
+        // Always pull the raw uiautomator XML — searchUiXmlNodes turns it into
+        // the legacy `UiNode[]` ACP wire shape that existing clients expect.
+        const dump = await mcp.uiDump({ format: "raw" });
+        if (!dump.supported)
+            return { nodes: [] };
+        const nodes = searchUiXmlNodes(dump.content ?? "", "");
+        return { nodes };
+    }
+    async action(msg) {
+        const params = msg.params ?? {};
+        const action = params.action ?? "";
+        if (!action)
+            throw new DeviceError("'action' is required", { subtype: "invalid_args" });
+        // ACP wire: action args MAY arrive nested under `parameters` (HTTP-style)
+        // or flattened alongside `action` (legacy / convenience). Accept both.
+        const args = params.parameters && typeof params.parameters === "object"
+            ? params.parameters
+            : params;
+        const a = parseAcpAction(action, args);
+        const mcp = this.mcpProvider();
+        const r = await mcp.act(a);
+        if (!r.ok) {
+            throw new DeviceError(r.error?.message ?? `device/action ${action} failed`, {
+                subtype: "device_error",
+                cause: { code: r.error?.code, action: r.action, durationMs: r.durationMs },
+            });
+        }
+        return { status: "ok", action };
+    }
+    async install(msg) {
+        // ACP wire v2 prefers `apkPath` (camelCase); accept `apk_path` for
+        // backward compatibility with the Python implementation.
+        const params = msg.params ?? {};
+        const apkPath = params.apkPath ??
+            params.apk_path ??
+            "";
+        if (!apkPath) {
+            throw new DeviceError("apkPath is required", { subtype: "invalid_args" });
+        }
+        const sanitized = sanitizeApkPath(apkPath);
+        const mcp = this.mcpProvider();
+        if (!mcp.installApk) {
+            throw new DeviceError("device/install is not supported on this MCP runtime", { subtype: "internal_error" });
+        }
+        await mcp.installApk(sanitized);
+        return { status: "ok" };
+    }
+    async shell(msg) {
+        if (process.env.BEEOS_SHELL_ALLOW !== "true") {
+            throw new AcpError("shell command execution is disabled — set BEEOS_SHELL_ALLOW=true to opt in", -32603, { category: "shell-disabled" });
+        }
+        const command = msg.params?.command ?? "";
+        if (!command)
+            throw new DeviceError("command is required", { subtype: "invalid_args" });
+        const mcp = this.mcpProvider();
+        if (!mcp.executeCommand) {
+            throw new DeviceError("device/shell is not supported on this MCP runtime", { subtype: "internal_error" });
+        }
+        const r = await mcp.executeCommand(command);
+        return { output: r.stdout };
+    }
+}
+/**
+ * Validate `apk_path` against an install-root whitelist.
+ *
+ * Rules:
+ *  - Must be absolute.
+ *  - May not contain `..` segments.
+ *  - Must reside under one of the allowed roots:
+ *      • `~/.beeos/uploads/`
+ *      • `BEEOS_INSTALL_ROOT` env (if set)
+ *
+ * Returns a normalized absolute path on success; throws DeviceError on failure.
+ */
+function sanitizeApkPath(input) {
+    if (!path.isAbsolute(input)) {
+        throw new DeviceError(`apk_path must be absolute: ${input}`, { subtype: "invalid_args" });
+    }
+    if (input.split(path.sep).some((seg) => seg === "..")) {
+        throw new DeviceError("apk_path may not contain '..' segments", { subtype: "invalid_args" });
+    }
+    const normalized = path.normalize(input);
+    const roots = [path.join(os.homedir(), ".beeos", "uploads")];
+    if (process.env.BEEOS_INSTALL_ROOT) {
+        roots.push(path.normalize(process.env.BEEOS_INSTALL_ROOT));
+    }
+    const allowed = roots.some((root) => {
+        const rel = path.relative(root, normalized);
+        return rel !== "" && !rel.startsWith("..") && !path.isAbsolute(rel);
+    });
+    if (!allowed) {
+        throw new DeviceError(`apk_path must reside under ${roots.join(" or ")} (got ${normalized})`, { subtype: "invalid_args" });
+    }
+    return normalized;
+}
+function serializeDeviceInfo(info) {
+    return {
+        type: info.type,
+        name: info.name,
+        os: info.os,
+        width: info.width,
+        height: info.height,
+        capabilities: info.capabilities,
+        osVersion: info.osVersion,
+        density: info.density,
+        metadata: info.metadata,
+    };
+}
+//# sourceMappingURL=device.js.map

package/dist/inbound/acp/handlers/device.js.map

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

package/dist/inbound/acp/handlers/initialize.d.ts

@@ -0,0 +1,71 @@
+/**
+ * ACP `initialize` handler.
+ *
+ * Response shape MUST match the beeos-claw / web SDK contract:
+ *
+ *   - `protocolVersion` is sourced from `@beeos-ai/beeos-types/acp`
+ *     (`ACP_PROTOCOL_VERSION`) so a future bump propagates without an
+ *     edit here.
+ *   - `agentCapabilities.promptCapabilities.image` / `embeddedContext`
+ *     are TRUE because the device agent forwards screenshots + base64
+ *     image blocks straight into the inner mobile-use VLM. Audio stays
+ *     false (we have no audio capture path).
+ *   - `terminal` / `skills` / `mcp` / `sessionCapabilities` stay false
+ *     / empty — this agent intentionally does NOT implement those
+ *     business surfaces (skills/, canvas/, cron/, terminal/, mcp/),
+ *     and `Method not found` (-32601) is the documented response for
+ *     such probes.
+ *   - `forwardThinking` / `forwardToolCalls` from the client are
+ *     surfaced on the returned options so callers can wire transport
+ *     filtering (mirrors beeos-claw `transport.ts.forwardControl`).
+ */
+import { ACP_PROTOCOL_VERSION } from "@beeos-ai/beeos-types/acp";
+export interface InitializeRequestParams {
+    /** Server should suppress `agent_thought_chunk` notifications when false. */
+    forwardThinking?: boolean;
+    /** Server should suppress `tool_call` / `tool_call_update` notifications when false. */
+    forwardToolCalls?: boolean;
+    /** Echoed back to allow the client to verify identity binding. */
+    clientName?: string;
+    /** Tolerated forward-compat fields. */
+    [key: string]: unknown;
+}
+export interface InitializeOptions {
+    agentName?: string;
+    agentTitle?: string;
+    version?: string;
+    /**
+     * Optional hook invoked with the resolved forward-control flags so the
+     * caller can apply them to its transport (mirrors beeos-claw's
+     * forwardControl). Pure read-side: the handler still returns the same
+     * response shape regardless of whether the hook is set.
+     */
+    onForwardControl?: (control: {
+        forwardThinking: boolean;
+        forwardToolCalls: boolean;
+    }) => void;
+}
+export interface InitializeResponse {
+    protocolVersion: typeof ACP_PROTOCOL_VERSION;
+    agentCapabilities: {
+        loadSession: boolean;
+        terminal: boolean;
+        skills: boolean;
+        multipleSessions: boolean;
+        mcp: Record<string, never>;
+        sessionCapabilities: Record<string, never>;
+        promptCapabilities: {
+            image: boolean;
+            audio: boolean;
+            embeddedContext: boolean;
+        };
+    };
+    agentInfo: {
+        name: string;
+        title: string;
+        version: string;
+    };
+    _meta: Record<string, never>;
+    authMethods: string[];
+}
+export declare function buildInitializeResponse(opts?: InitializeOptions, params?: InitializeRequestParams): InitializeResponse;

package/dist/inbound/acp/handlers/initialize.js

@@ -0,0 +1,53 @@
+/**
+ * ACP `initialize` handler.
+ *
+ * Response shape MUST match the beeos-claw / web SDK contract:
+ *
+ *   - `protocolVersion` is sourced from `@beeos-ai/beeos-types/acp`
+ *     (`ACP_PROTOCOL_VERSION`) so a future bump propagates without an
+ *     edit here.
+ *   - `agentCapabilities.promptCapabilities.image` / `embeddedContext`
+ *     are TRUE because the device agent forwards screenshots + base64
+ *     image blocks straight into the inner mobile-use VLM. Audio stays
+ *     false (we have no audio capture path).
+ *   - `terminal` / `skills` / `mcp` / `sessionCapabilities` stay false
+ *     / empty — this agent intentionally does NOT implement those
+ *     business surfaces (skills/, canvas/, cron/, terminal/, mcp/),
+ *     and `Method not found` (-32601) is the documented response for
+ *     such probes.
+ *   - `forwardThinking` / `forwardToolCalls` from the client are
+ *     surfaced on the returned options so callers can wire transport
+ *     filtering (mirrors beeos-claw `transport.ts.forwardControl`).
+ */
+import { ACP_PROTOCOL_VERSION } from "@beeos-ai/beeos-types/acp";
+export function buildInitializeResponse(opts = {}, params = {}) {
+    // Default to true so legacy clients (which don't send the flags at all)
+    // keep receiving the full stream — same default beeos-claw applies.
+    const forwardThinking = params.forwardThinking ?? true;
+    const forwardToolCalls = params.forwardToolCalls ?? true;
+    opts.onForwardControl?.({ forwardThinking, forwardToolCalls });
+    return {
+        protocolVersion: ACP_PROTOCOL_VERSION,
+        agentCapabilities: {
+            loadSession: true,
+            terminal: false,
+            skills: false,
+            multipleSessions: true,
+            mcp: {},
+            sessionCapabilities: {},
+            promptCapabilities: {
+                image: true,
+                audio: false,
+                embeddedContext: true,
+            },
+        },
+        agentInfo: {
+            name: opts.agentName ?? "device-agent",
+            title: opts.agentTitle ?? "BeeOS Device Agent",
+            version: opts.version ?? "0.1.0",
+        },
+        _meta: {},
+        authMethods: [],
+    };
+}
+//# sourceMappingURL=initialize.js.map

package/dist/inbound/acp/handlers/initialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize.js","sourceRoot":"","sources":["../../../../src/inbound/acp/handlers/initialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAkDjE,MAAM,UAAU,uBAAuB,CACrC,OAA0B,EAAE,EAC5B,SAAkC,EAAE;IAEpC,wEAAwE;IACxE,oEAAoE;IACpE,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,IAAI,CAAC;IACvD,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI,IAAI,CAAC;IACzD,IAAI,CAAC,gBAAgB,EAAE,CAAC,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAE/D,OAAO;QACL,eAAe,EAAE,oBAAoB;QACrC,iBAAiB,EAAE;YACjB,WAAW,EAAE,IAAI;YACjB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,KAAK;YACb,gBAAgB,EAAE,IAAI;YACtB,GAAG,EAAE,EAAE;YACP,mBAAmB,EAAE,EAAE;YACvB,kBAAkB,EAAE;gBAClB,KAAK,EAAE,IAAI;gBACX,KAAK,EAAE,KAAK;gBACZ,eAAe,EAAE,IAAI;aACtB;SACF;QACD,SAAS,EAAE;YACT,IAAI,EAAE,IAAI,CAAC,SAAS,IAAI,cAAc;YACtC,KAAK,EAAE,IAAI,CAAC,UAAU,IAAI,oBAAoB;YAC9C,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO;SACjC;QACD,KAAK,EAAE,EAAE;QACT,WAAW,EAAE,EAAE;KAChB,CAAC;AACJ,CAAC"}

package/dist/inbound/acp/handlers/models.d.ts

@@ -0,0 +1,16 @@
+/**
+ * ACP `models/list` handler.
+ */
+export interface ModelEntry {
+    id: string;
+    name: string;
+    provider: string;
+}
+export type ModelListProvider = () => ModelEntry[] | Promise<ModelEntry[]>;
+export declare class AcpModelHandlers {
+    private readonly getModels?;
+    constructor(getModels?: ModelListProvider | undefined);
+    list(): Promise<{
+        models: ModelEntry[];
+    }>;
+}

package/dist/inbound/acp/handlers/models.js

@@ -0,0 +1,23 @@
+/**
+ * ACP `models/list` handler.
+ */
+const DEFAULT_MODELS = [
+    { id: "openrouter/bytedance/ui-tars-1.5-7b", name: "UI-TARS 1.5 7B", provider: "openrouter" },
+    { id: "openrouter/qwen/qwen2.5-vl-72b-instruct", name: "Qwen 2.5 VL 72B", provider: "openrouter" },
+    { id: "openrouter/anthropic/claude-sonnet-4.6", name: "Claude Sonnet 4.6", provider: "openrouter" },
+    { id: "openrouter/anthropic/claude-haiku-4.5", name: "Claude Haiku 4.5", provider: "openrouter" },
+    { id: "openrouter/openai/gpt-5.4", name: "GPT-5.4", provider: "openrouter" },
+    { id: "openrouter/openai/gpt-5.4-mini", name: "GPT-5.4 Mini", provider: "openrouter" },
+    { id: "openrouter/google/gemini-3-flash-preview", name: "Gemini 3 Flash", provider: "openrouter" },
+];
+export class AcpModelHandlers {
+    getModels;
+    constructor(getModels) {
+        this.getModels = getModels;
+    }
+    async list() {
+        const models = this.getModels ? await this.getModels() : DEFAULT_MODELS;
+        return { models };
+    }
+}
+//# sourceMappingURL=models.js.map

package/dist/inbound/acp/handlers/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../../src/inbound/acp/handlers/models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,cAAc,GAAiB;IACnC,EAAE,EAAE,EAAE,qCAAqC,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE;IAC7F,EAAE,EAAE,EAAE,yCAAyC,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,YAAY,EAAE;IAClG,EAAE,EAAE,EAAE,wCAAwC,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,YAAY,EAAE;IACnG,EAAE,EAAE,EAAE,uCAAuC,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,YAAY,EAAE;IACjG,EAAE,EAAE,EAAE,2BAA2B,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE;IAC5E,EAAE,EAAE,EAAE,gCAAgC,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE;IACtF,EAAE,EAAE,EAAE,0CAA0C,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE;CACnG,CAAC;AAIF,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,SAA6B;QAA7B,cAAS,GAAT,SAAS,CAAoB;IAAG,CAAC;IAE9D,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;QACxE,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/inbound/acp/handlers/session.d.ts

@@ -0,0 +1,51 @@
+/**
+ * ACP `session/*` handlers (10 methods).
+ *
+ * Thin pass-through to `SessionManager`. Field names use camelCase to match
+ * the web SDK (`acp-client.ts`).
+ */
+import type { SessionManager } from "../../../app/session-manager.js";
+import type { AcpMessage } from "./device.js";
+export declare class AcpSessionHandlers {
+    private readonly sessions;
+    constructor(sessions: SessionManager);
+    new(_msg: AcpMessage): Promise<{
+        sessionId: string;
+    }>;
+    load(msg: AcpMessage): Promise<{
+        sessionId: string;
+        history: import("../../../app/message-store.js").MessageHistoryEntry[];
+    }>;
+    list(_msg: AcpMessage): Promise<{
+        sessions: {
+            sessionId: string;
+            title: string;
+            updatedAt: number;
+        }[];
+    }>;
+    prompt(msg: AcpMessage): Promise<{
+        stopReason: string;
+    }>;
+    rename(msg: AcpMessage): Promise<{
+        sessionId: string;
+        title: string;
+    }>;
+    delete(msg: AcpMessage): Promise<{
+        deleted: boolean;
+    }>;
+    clear(msg: AcpMessage): Promise<{
+        cleared: boolean;
+    }>;
+    cancel(_msg: AcpMessage): Promise<{
+        cancelled: boolean;
+    }>;
+    setMode(msg: AcpMessage): Promise<{
+        sessionId: string;
+        mode: string;
+    }>;
+    setModel(msg: AcpMessage): Promise<{
+        sessionId: string;
+        provider: string;
+        model: string;
+    }>;
+}

package/dist/inbound/acp/handlers/session.js

@@ -0,0 +1,61 @@
+/**
+ * ACP `session/*` handlers (10 methods).
+ *
+ * Thin pass-through to `SessionManager`. Field names use camelCase to match
+ * the web SDK (`acp-client.ts`).
+ */
+export class AcpSessionHandlers {
+    sessions;
+    constructor(sessions) {
+        this.sessions = sessions;
+    }
+    async new(_msg) {
+        return this.sessions.newSession();
+    }
+    async load(msg) {
+        const params = msg.params ?? {};
+        const id = params.sessionId || params.session_id || "";
+        return this.sessions.loadSession(id);
+    }
+    async list(_msg) {
+        return this.sessions.listSessions();
+    }
+    async prompt(msg) {
+        const params = msg.params ?? {};
+        const sessionId = params.sessionId || params.session_id || undefined;
+        const prompt = params.prompt;
+        return this.sessions.prompt(prompt, sessionId);
+    }
+    async rename(msg) {
+        const params = msg.params ?? {};
+        const id = params.sessionId ?? "";
+        const title = params.title ?? "";
+        return this.sessions.renameSession(id, title);
+    }
+    async delete(msg) {
+        const id = msg.params?.sessionId ?? "";
+        return this.sessions.deleteSession(id);
+    }
+    async clear(msg) {
+        const id = msg.params?.sessionId ?? "";
+        return this.sessions.clearSession(id);
+    }
+    async cancel(_msg) {
+        const cancelled = await this.sessions.cancel();
+        return { cancelled };
+    }
+    async setMode(msg) {
+        const params = msg.params ?? {};
+        const id = params.sessionId ?? "";
+        const mode = params.mode ?? "agent";
+        return this.sessions.setMode(id, mode);
+    }
+    async setModel(msg) {
+        const params = msg.params ?? {};
+        const id = params.sessionId ?? "";
+        const model = params.model ?? "";
+        const provider = params.provider ?? "";
+        return this.sessions.setModel(id, model, provider);
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/inbound/acp/handlers/session.js.map

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

package/dist/inbound/acp/handlers/skills.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ACP `skills/list` handler. The Python agent currently exposes an empty list.
+ */
+export declare class AcpSkillsHandlers {
+    list(): Promise<{
+        skills: never[];
+    }>;
+}

package/dist/inbound/acp/handlers/skills.js

@@ -0,0 +1,9 @@
+/**
+ * ACP `skills/list` handler. The Python agent currently exposes an empty list.
+ */
+export class AcpSkillsHandlers {
+    async list() {
+        return { skills: [] };
+    }
+}
+//# sourceMappingURL=skills.js.map

package/dist/inbound/acp/handlers/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../../src/inbound/acp/handlers/skills.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,iBAAiB;IAC5B,KAAK,CAAC,IAAI;QACR,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/inbound/acp/notifier.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Adapter — push `session/update` notifications onto the Bridge transport.
+ *
+ * Used by SessionManager to stream agent_message_chunk / tool_call /
+ * tool_call_update / agent_status events back to the connected client.
+ *
+ * Wire-shape contract (mirrors beeos-claw `acp-gateway/transport.ts`
+ * `sendNotification`):
+ *
+ *   {
+ *     jsonrpc: "2.0",
+ *     method: "session/update",
+ *     params: { sessionId, update },
+ *     _debug_index: <process-monotonic uint>,
+ *     _ts: <Date.now() in ms>,
+ *   }
+ *
+ * `_debug_index` lets the client deterministically order chunks even when
+ * transport reorders, and `_ts` carries server-wall-clock ms for timeline
+ * debugging. Clients ignore unknown envelope keys — both fields are
+ * additive, never load-bearing.
+ */
+import type { IBridgeTransport } from "../../ports/transport.js";
+import type { SessionUpdateNotifier } from "../../app/session-manager.js";
+export declare class TransportSessionNotifier implements SessionUpdateNotifier {
+    private readonly transport;
+    /**
+     * Process-monotonic counter shared across every notification on a
+     * given transport instance. Wraps cleanly via JS number safety bounds
+     * (>1e15 events before precision loss).
+     */
+    private debugIndex;
+    constructor(transport: IBridgeTransport);
+    send(sessionId: string, update: Record<string, unknown>): void;
+}

package/dist/inbound/acp/notifier.js

@@ -0,0 +1,45 @@
+/**
+ * Adapter — push `session/update` notifications onto the Bridge transport.
+ *
+ * Used by SessionManager to stream agent_message_chunk / tool_call /
+ * tool_call_update / agent_status events back to the connected client.
+ *
+ * Wire-shape contract (mirrors beeos-claw `acp-gateway/transport.ts`
+ * `sendNotification`):
+ *
+ *   {
+ *     jsonrpc: "2.0",
+ *     method: "session/update",
+ *     params: { sessionId, update },
+ *     _debug_index: <process-monotonic uint>,
+ *     _ts: <Date.now() in ms>,
+ *   }
+ *
+ * `_debug_index` lets the client deterministically order chunks even when
+ * transport reorders, and `_ts` carries server-wall-clock ms for timeline
+ * debugging. Clients ignore unknown envelope keys — both fields are
+ * additive, never load-bearing.
+ */
+export class TransportSessionNotifier {
+    transport;
+    /**
+     * Process-monotonic counter shared across every notification on a
+     * given transport instance. Wraps cleanly via JS number safety bounds
+     * (>1e15 events before precision loss).
+     */
+    debugIndex = 0;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    send(sessionId, update) {
+        const msg = JSON.stringify({
+            jsonrpc: "2.0",
+            method: "session/update",
+            params: { sessionId, update },
+            _debug_index: this.debugIndex++,
+            _ts: Date.now(),
+        });
+        void this.transport.send(msg).catch(() => undefined);
+    }
+}
+//# sourceMappingURL=notifier.js.map

package/dist/inbound/acp/notifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.js","sourceRoot":"","sources":["../../../src/inbound/acp/notifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,MAAM,OAAO,wBAAwB;IAQN;IAP7B;;;;OAIG;IACK,UAAU,GAAG,CAAC,CAAC;IAEvB,YAA6B,SAA2B;QAA3B,cAAS,GAAT,SAAS,CAAkB;IAAG,CAAC;IAE5D,IAAI,CAAC,SAAiB,EAAE,MAA+B;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;YACzB,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,gBAAgB;YACxB,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;YAC7B,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE;YAC/B,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;SAChB,CAAC,CAAC;QACH,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACF"}