hoomanjs 1.58.0 → 1.59.0

package/dist/daemon/acp-client.js

@@ -0,0 +1,130 @@
+import { spawn } from "node:child_process";
+import { Readable, Writable } from "node:stream";
+import { client as buildClientApp, methods, ndJsonStream, PROTOCOL_VERSION, } from "@agentclientprotocol/sdk";
+import { HOOMAN_X_DAEMON_ENV } from "../acp/meta/daemon.js";
+/**
+ * Owns the single `hooman acp` child process the daemon multiplexes every
+ * ACP session over, and the ACP client-role connection to it. Lazily
+ * (re)spawns on first use and after an unexpected exit, so a crashed child is
+ * recovered on the next call rather than requiring a daemon restart.
+ */
+export class AcpDaemonClient {
+    options;
+    #child = null;
+    #connection = null;
+    #starting = null;
+    #agentInfo;
+    #closed = false;
+    constructor(options) {
+        this.options = options;
+    }
+    get agentCapabilities() {
+        return this.#agentInfo?.agentCapabilities;
+    }
+    /** Ensures the child process + connection are up, spawning/reconnecting lazily if needed. */
+    async ensureStarted() {
+        if (this.#closed) {
+            throw new Error("ACP daemon client is closed.");
+        }
+        if (this.#starting) {
+            return this.#starting;
+        }
+        this.#starting = this.#start().catch((error) => {
+            this.#starting = null;
+            throw error;
+        });
+        return this.#starting;
+    }
+    async #start() {
+        const child = spawn(process.execPath, [this.options.cliPath, "acp"], {
+            cwd: this.options.cwd,
+            env: { ...process.env, [HOOMAN_X_DAEMON_ENV]: "true" },
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        this.#child = child;
+        let stderrBuffer = "";
+        child.stderr.on("data", (chunk) => {
+            stderrBuffer = `${stderrBuffer}${chunk.toString("utf8")}`;
+            const lines = stderrBuffer.split("\n");
+            stderrBuffer = lines.pop() ?? "";
+            for (const line of lines) {
+                if (line.trim()) {
+                    this.options.onChildStderr?.(line);
+                }
+            }
+        });
+        child.on("exit", () => {
+            this.#child = null;
+            this.#connection = null;
+            this.#starting = null;
+            this.#agentInfo = undefined;
+        });
+        const stream = ndJsonStream(Writable.toWeb(child.stdin), Readable.toWeb(child.stdout));
+        const clientApp = buildClientApp({ name: "hoomanjs-daemon" })
+            .onRequest(methods.client.session.requestPermission, (ctx) => this.options.onPermissionRequest(ctx.params.sessionId, ctx.params, ctx.signal))
+            .onNotification(methods.client.session.update, (ctx) => {
+            this.options.onSessionUpdate(ctx.params);
+        });
+        this.#connection = clientApp.connect(stream);
+        const agent = this.#connection.agent;
+        this.#agentInfo = await agent.request(methods.agent.initialize, {
+            protocolVersion: PROTOCOL_VERSION,
+            clientCapabilities: {},
+        });
+        return agent;
+    }
+    async newSession(params) {
+        const agent = await this.ensureStarted();
+        return agent.request(methods.agent.session.new, {
+            cwd: params.cwd,
+            mcpServers: params.mcpServers,
+            ...(params.meta ? { _meta: params.meta } : {}),
+        });
+    }
+    async resumeSession(params) {
+        const agent = await this.ensureStarted();
+        return agent.request(methods.agent.session.resume, {
+            sessionId: params.sessionId,
+            cwd: params.cwd,
+            mcpServers: params.mcpServers,
+            ...(params.meta ? { _meta: params.meta } : {}),
+        });
+    }
+    async prompt(params) {
+        const agent = await this.ensureStarted();
+        return agent.request(methods.agent.session.prompt, {
+            sessionId: params.sessionId,
+            prompt: params.prompt,
+            ...(params.meta ? { _meta: params.meta } : {}),
+        });
+    }
+    async closeSession(sessionId) {
+        const agent = await this.ensureStarted();
+        await agent.request(methods.agent.session.close, { sessionId });
+    }
+    /** Fire-and-forget per the ACP spec; a no-op when the connection is already gone. */
+    cancelSession(sessionId) {
+        if (!this.#connection) {
+            return;
+        }
+        void this.#connection.agent
+            .notify(methods.agent.session.cancel, { sessionId })
+            .catch(() => undefined);
+    }
+    async setConfigOption(params) {
+        const agent = await this.ensureStarted();
+        return agent.request(methods.agent.session.setConfigOption, params);
+    }
+    /** Stops accepting work and terminates the child; safe to call more than once. */
+    async close() {
+        this.#closed = true;
+        this.#connection = null;
+        this.#starting = null;
+        const child = this.#child;
+        this.#child = null;
+        if (child && !child.killed) {
+            child.kill();
+        }
+    }
+}
+//# sourceMappingURL=acp-client.js.map

package/dist/daemon/acp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-client.js","sourceRoot":"","sources":["../../src/daemon/acp-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAuC,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,MAAM,IAAI,cAAc,EACxB,OAAO,EACP,YAAY,EACZ,gBAAgB,GAcjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAuB5D;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAOU;IANpC,MAAM,GAA0C,IAAI,CAAC;IACrD,WAAW,GAA4B,IAAI,CAAC;IAC5C,SAAS,GAAkC,IAAI,CAAC;IAChD,UAAU,CAAiC;IAC3C,OAAO,GAAG,KAAK,CAAC;IAEhB,YAAoC,OAA+B;QAA/B,YAAO,GAAP,OAAO,CAAwB;IAAG,CAAC;IAEvE,IAAW,iBAAiB;QAE1B,OAAO,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC;IAC5C,CAAC;IAED,6FAA6F;IACtF,KAAK,CAAC,aAAa;QACxB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,SAAS,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAC7C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE;YACnE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;YACrB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE;YACtD,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,YAAY,GAAG,EAAE,CAAC;QACtB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,YAAY,GAAG,GAAG,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,YAAY,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;oBAChB,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,YAAY,CACzB,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAA0C,EACpE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAA0C,CACtE,CAAC;QAEF,MAAM,SAAS,GAAG,cAAc,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;aAC1D,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,GAAG,EAAE,EAAE,CAC3D,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAC9B,GAAG,CAAC,MAAM,CAAC,SAAS,EACpB,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,MAAM,CACX,CACF;aACA,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YACrD,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEL,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE;YAC9D,eAAe,EAAE,gBAAgB;YACjC,kBAAkB,EAAE,EAAE;SACvB,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,MAIvB;QACC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;YAC9C,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,aAAa,CAAC,MAK1B;QACC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE;YACjD,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,MAInB;QACC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE;YACjD,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,SAAiB;QACzC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QACzC,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,qFAAqF;IAC9E,aAAa,CAAC,SAAiB;QACpC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QACD,KAAK,IAAI,CAAC,WAAW,CAAC,KAAK;aACxB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC;aACnD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;IAEM,KAAK,CAAC,eAAe,CAC1B,MAAqC;QAErC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;IAED,kFAAkF;IAC3E,KAAK,CAAC,KAAK;QAChB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/daemon/approvals.d.ts

@@ -1,3 +1,10 @@
-import { HoomanToolApprovalIntervention } from "../core/approvals/intervention.js";
+import type { RequestPermissionRequest, RequestPermissionResponse } from "@agentclientprotocol/sdk";
 import type { Manager as McpManager } from "../core/mcp/index.js";
-export declare function createDaemonApprovalIntervention(manager: McpManager): HoomanToolApprovalIntervention;
+import type { DaemonSessionRegistry } from "./session-registry.js";
+/**
+ * Builds the daemon ACP client's `session/request_permission` handler,
+ * dispatching to the tool-approval or `ask_user` relay and always resolving
+ * to the originating upstream server the current turn's origin snapshot
+ * points at.
+ */
+export declare function createDaemonPermissionHandler(manager: McpManager, registry: DaemonSessionRegistry): (sessionId: string, request: RequestPermissionRequest, signal: AbortSignal) => Promise<RequestPermissionResponse>;

package/dist/daemon/approvals.js

@@ -1,8 +1,153 @@
-import { createChannelPermissionAsk } from "../core/approvals/channel-ask.js";
-import { HoomanToolApprovalIntervention } from "../core/approvals/intervention.js";
-export function createDaemonApprovalIntervention(manager) {
-    return new HoomanToolApprovalIntervention({
-        ask: createChannelPermissionAsk(manager),
-    });
+import { ACP_ASK_USER_META_KEY } from "../acp/questions.js";
+const TOOL_DESCRIPTION_PREVIEW_LIMIT = 64;
+const TOOL_ARGS_PREVIEW_LIMIT = 200;
+const CANCELLED = {
+    outcome: { outcome: "cancelled" },
+};
+function selected(optionId) {
+    return { outcome: { outcome: "selected", optionId } };
+}
+function pickOptionByKind(options, kind) {
+    return options.find((option) => option.kind === kind)?.optionId;
+}
+function truncate(text, max) {
+    return text.length > max ? `${text.slice(0, max)}…` : text;
+}
+function inputPreview(input) {
+    try {
+        return truncate(JSON.stringify(input) ?? "null", TOOL_ARGS_PREVIEW_LIMIT);
+    }
+    catch {
+        return truncate(String(input), TOOL_ARGS_PREVIEW_LIMIT);
+    }
+}
+/**
+ * Exact tool name and raw description the ACP server attaches to
+ * `session/request_permission` via `_meta` (see `src/acp/approvals.ts`), so
+ * the channel gets a minimal "tool name + description + input" message
+ * instead of the display `title` (which already folds them together for
+ * ACP UI clients). Falls back to `toolCall.title`/`toolCallId` only for
+ * non-conforming callers.
+ */
+function extractToolMeta(request) {
+    const meta = request._meta;
+    const metaName = meta?.["hoomanjs/tool_name"];
+    const metaDescription = meta?.["hoomanjs/tool_description"];
+    const name = typeof metaName === "string" && metaName.trim()
+        ? metaName.trim()
+        : request.toolCall.title?.trim() || request.toolCall.toolCallId;
+    const description = typeof metaDescription === "string" ? metaDescription.trim() : "";
+    return {
+        name,
+        description: truncate(description, TOOL_DESCRIPTION_PREVIEW_LIMIT),
+    };
+}
+/**
+ * Relays a tool-approval `session/request_permission` to the exact upstream
+ * MCP server that originated the current turn's channel notification, over
+ * `hooman/channel/permission`. Unsupported/missing capability or origin
+ * safely denies via a `cancelled` outcome — never broadcasts to other
+ * upstream servers.
+ */
+async function relayToolApproval(manager, registry, sessionId, request, _signal) {
+    const origin = registry.originForAcpSession(sessionId);
+    if (!origin?.server) {
+        return CANCELLED;
+    }
+    const supported = await manager.supportsChannelPermission(origin.server);
+    if (!supported) {
+        return CANCELLED;
+    }
+    try {
+        const { name, description } = extractToolMeta(request);
+        const behavior = await manager.requestChannelPermission(origin.server, {
+            requestId: crypto.randomUUID(),
+            tool: name,
+            description,
+            preview: inputPreview(request.toolCall.rawInput),
+            source: origin.source,
+            user: origin.user,
+            session: origin.session,
+            thread: origin.thread,
+        });
+        if (behavior === "allow_once") {
+            const optionId = pickOptionByKind(request.options, "allow_once");
+            return optionId ? selected(optionId) : CANCELLED;
+        }
+        if (behavior === "allow_always") {
+            const optionId = pickOptionByKind(request.options, "allow_always") ??
+                pickOptionByKind(request.options, "allow_once");
+            return optionId ? selected(optionId) : CANCELLED;
+        }
+        return CANCELLED;
+    }
+    catch {
+        return CANCELLED;
+    }
+}
+/**
+ * Relays an `ask_user` question (the same `session/request_permission`
+ * method, tagged with `_meta[ACP_ASK_USER_META_KEY]`) over
+ * `hooman/channel/ask`. Maps the channel's answer back to the offered
+ * `answer_N` option by matching its resolved label; free text that doesn't
+ * match an offered option is treated as a dismissal, matching how the ACP
+ * server-side `ask_user` backend itself only understands option IDs or
+ * dismissal.
+ */
+async function relayAskUser(manager, registry, sessionId, request, signal) {
+    const origin = registry.originForAcpSession(sessionId);
+    if (!origin?.server) {
+        return CANCELLED;
+    }
+    const supported = await manager.supportsChannelAsk(origin.server);
+    if (!supported) {
+        return CANCELLED;
+    }
+    const rawInput = request.toolCall.rawInput;
+    const question = typeof rawInput?.question === "string"
+        ? rawInput.question
+        : request.toolCall.title?.trim() || "Question";
+    const options = Array.isArray(rawInput?.options)
+        ? rawInput.options.filter((value) => typeof value === "string")
+        : [];
+    try {
+        const outcome = await manager.requestChannelAsk(origin.server, {
+            requestId: crypto.randomUUID(),
+            question,
+            options,
+            source: origin.source,
+            user: origin.user,
+            session: origin.session,
+            thread: origin.thread,
+        }, { signal });
+        if (outcome.kind === "dismissed") {
+            return CANCELLED;
+        }
+        const index = options.indexOf(outcome.answer);
+        if (index < 0) {
+            return CANCELLED;
+        }
+        const optionId = `answer_${index}`;
+        return request.options.some((option) => option.optionId === optionId)
+            ? selected(optionId)
+            : CANCELLED;
+    }
+    catch {
+        return CANCELLED;
+    }
+}
+/**
+ * Builds the daemon ACP client's `session/request_permission` handler,
+ * dispatching to the tool-approval or `ask_user` relay and always resolving
+ * to the originating upstream server the current turn's origin snapshot
+ * points at.
+ */
+export function createDaemonPermissionHandler(manager, registry) {
+    return (sessionId, request, signal) => {
+        const isAskUser = request._meta?.[ACP_ASK_USER_META_KEY] === true;
+        return isAskUser
+            ? relayAskUser(manager, registry, sessionId, request, signal)
+            : relayToolApproval(manager, registry, sessionId, request, signal);
+    };
 }
 //# sourceMappingURL=approvals.js.map

package/dist/daemon/approvals.js.map

@@ -1 +1 @@
-{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../../src/daemon/approvals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAGnF,MAAM,UAAU,gCAAgC,CAAC,OAAmB;IAClE,OAAO,IAAI,8BAA8B,CAAC;QACxC,GAAG,EAAE,0BAA0B,CAAC,OAAO,CAAC;KACzC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../../src/daemon/approvals.ts"],"names":[],"mappings":"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"}

package/dist/daemon/attachments.d.ts

@@ -0,0 +1,9 @@
+import type { ContentBlock } from "@agentclientprotocol/sdk";
+/**
+ * Converts local channel attachment paths into ACP `session/prompt` content
+ * blocks: recognized image/audio files under the 1 MiB limit are embedded as
+ * base64 `image`/`audio` blocks, everything else (including oversized or
+ * unreadable files) is listed as a text block naming the local absolute
+ * path, since the ACP agent runs on the same machine and can read it itself.
+ */
+export declare function attachmentPathsToAcpBlocks(paths: readonly string[]): Promise<ContentBlock[]>;

package/dist/daemon/attachments.js

@@ -0,0 +1,63 @@
+import { readFile, stat } from "node:fs/promises";
+import { extname } from "node:path";
+const MAX_ATTACHMENT_BYTES = 1024 * 1024;
+const IMAGE_MIME_BY_EXT = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+};
+const AUDIO_MIME_BY_EXT = {
+    ".mp3": "audio/mpeg",
+    ".wav": "audio/wav",
+    ".ogg": "audio/ogg",
+    ".m4a": "audio/mp4",
+    ".flac": "audio/flac",
+};
+/**
+ * Converts local channel attachment paths into ACP `session/prompt` content
+ * blocks: recognized image/audio files under the 1 MiB limit are embedded as
+ * base64 `image`/`audio` blocks, everything else (including oversized or
+ * unreadable files) is listed as a text block naming the local absolute
+ * path, since the ACP agent runs on the same machine and can read it itself.
+ */
+export async function attachmentPathsToAcpBlocks(paths) {
+    const blocks = [];
+    const textPaths = [];
+    for (const rawPath of paths) {
+        const path = rawPath.trim();
+        if (!path) {
+            continue;
+        }
+        const ext = extname(path).toLowerCase();
+        const imageMime = IMAGE_MIME_BY_EXT[ext];
+        const audioMime = AUDIO_MIME_BY_EXT[ext];
+        if (!imageMime && !audioMime) {
+            textPaths.push(path);
+            continue;
+        }
+        try {
+            const info = await stat(path);
+            if (!info.isFile() || info.size > MAX_ATTACHMENT_BYTES) {
+                textPaths.push(path);
+                continue;
+            }
+            const data = (await readFile(path)).toString("base64");
+            blocks.push(imageMime
+                ? { type: "image", data, mimeType: imageMime }
+                : { type: "audio", data, mimeType: audioMime });
+        }
+        catch {
+            textPaths.push(path);
+        }
+    }
+    if (textPaths.length > 0) {
+        blocks.push({
+            type: "text",
+            text: `Files uploaded:\n${textPaths.join("\n")}`,
+        });
+    }
+    return blocks;
+}
+//# sourceMappingURL=attachments.js.map

package/dist/daemon/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../src/daemon/attachments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAAC;AAEzC,MAAM,iBAAiB,GAA2B;IAChD,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF,MAAM,iBAAiB,GAA2B;IAChD,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,KAAwB;IAExB,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;YAC7B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,oBAAoB,EAAE,CAAC;gBACvD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrB,SAAS;YACX,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACvD,MAAM,CAAC,IAAI,CACT,SAAS;gBACP,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE;gBAC9C,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAU,EAAE,CAClD,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,oBAAoB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACjD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/daemon/index.d.ts

@@ -1,12 +1,22 @@
-import { type Agent } from "@strands-agents/sdk";
 import type { Manager as McpManager } from "../core/mcp/index.js";
-import { resolveLlmMetadata } from "../core/utils/metadata.js";
-type RunDaemonOptions = {
-    agent: Agent;
+import type { AcpDaemonClient } from "./acp-client.js";
+import type { DaemonMcpProxyServer } from "./mcproxy/index.js";
+import type { DaemonSessionRegistry } from "./session-registry.js";
+export type DaemonCliOverrides = {
+    mode?: string;
+    model?: string;
+    effort?: string;
+    yolo?: boolean;
+};
+export type RunDaemonOptions = {
     manager: McpManager;
-    metadata?: Awaited<ReturnType<typeof resolveLlmMetadata>>;
+    acpClient: AcpDaemonClient;
+    registry: DaemonSessionRegistry;
+    mcpServer: DaemonMcpProxyServer;
+    cwd: string;
+    /** Fallback external-session component when a notification carries no `hooman/session`. */
     session?: string;
+    cliOverrides: DaemonCliOverrides;
     debug?: boolean;
 };
 export declare function main(options: RunDaemonOptions): Promise<void>;
-export {};