hoomanjs 1.18.0 → 1.18.1

package/dist/core/utils/attachments.js

@@ -0,0 +1,125 @@
+import { basename } from "node:path";
+import { readFile, stat } from "node:fs/promises";
+import { DocumentBlock, ImageBlock, TextBlock, VideoBlock, } from "@strands-agents/sdk";
+import { detectDocumentFormat, detectImageFormat, detectVideoFormat, } from "./file-formats.js";
+const DEFAULT_MAX_ATTACHMENT_BYTES = 1024 * 1024;
+export function normalizeAttachmentPaths(input) {
+    if (!Array.isArray(input)) {
+        return [];
+    }
+    const normalized = input
+        .map((value) => (typeof value === "string" ? value.trim() : ""))
+        .filter(Boolean);
+    return [...new Set(normalized)];
+}
+export function attachmentDiagnosticBlock(path, reason, extra, kind = "attachment") {
+    return new TextBlock(JSON.stringify({
+        path,
+        kind,
+        skipped: true,
+        reason,
+        ...(extra ?? {}),
+    }));
+}
+export async function readAttachmentAsBlocksOrBase64(filePath, options) {
+    const maxBytes = options?.maxBytes ?? DEFAULT_MAX_ATTACHMENT_BYTES;
+    const includeMetadata = options?.includeMetadata ?? true;
+    const unsupportedFormat = options?.unsupportedFormat ?? "base64";
+    const onError = options?.onError ?? "throw";
+    const diagnosticKind = options?.diagnosticKind ?? "attachment";
+    const trimmedPath = filePath.trim();
+    const asDiagnostic = (reason, extra) => [
+        attachmentDiagnosticBlock(trimmedPath, reason, extra, diagnosticKind),
+    ];
+    if (!trimmedPath) {
+        if (onError === "diagnostic") {
+            return asDiagnostic("Attachment path is empty.");
+        }
+        throw new Error("Attachment path is empty.");
+    }
+    try {
+        const info = await stat(trimmedPath);
+        if (!info.isFile()) {
+            if (onError === "diagnostic") {
+                return asDiagnostic("Attachment path is not a file.");
+            }
+            throw new Error(`Path is not a file: ${trimmedPath}`);
+        }
+        if (info.size > maxBytes) {
+            if (onError === "diagnostic") {
+                return asDiagnostic("Attachment exceeds size limit.", {
+                    size_bytes: info.size,
+                    max_size_bytes: maxBytes,
+                });
+            }
+            throw new Error(`File too large to read safely (${info.size} bytes). Use a different path or process the file with another tool.`);
+        }
+        const buffer = await readFile(trimmedPath);
+        const bytes = new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+        const metadata = (kind, format) => new TextBlock(JSON.stringify({
+            path: trimmedPath,
+            kind,
+            format,
+            size_bytes: info.size,
+        }));
+        const imageFormat = detectImageFormat(trimmedPath);
+        if (imageFormat) {
+            return [
+                ...(includeMetadata ? [metadata("image", imageFormat)] : []),
+                new ImageBlock({ format: imageFormat, source: { bytes } }),
+            ];
+        }
+        const videoFormat = detectVideoFormat(trimmedPath);
+        if (videoFormat) {
+            return [
+                ...(includeMetadata ? [metadata("video", videoFormat)] : []),
+                new VideoBlock({ format: videoFormat, source: { bytes } }),
+            ];
+        }
+        const documentFormat = detectDocumentFormat(trimmedPath);
+        if (documentFormat) {
+            return [
+                ...(includeMetadata ? [metadata("document", documentFormat)] : []),
+                new DocumentBlock({
+                    name: basename(trimmedPath),
+                    format: documentFormat,
+                    source: { bytes },
+                }),
+            ];
+        }
+        if (unsupportedFormat === "diagnostic") {
+            return asDiagnostic("Unsupported attachment format.", {
+                size_bytes: info.size,
+            });
+        }
+        return {
+            path: trimmedPath,
+            encoding: "base64",
+            content: buffer.toString("base64"),
+            sizeBytes: buffer.length,
+        };
+    }
+    catch (error) {
+        if (onError === "diagnostic") {
+            return asDiagnostic("Failed to load attachment.", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        throw error;
+    }
+}
+export async function attachmentPathsToPromptBlocks(paths, options) {
+    const blocks = [];
+    for (const path of paths) {
+        const result = await readAttachmentAsBlocksOrBase64(path, {
+            ...options,
+            unsupportedFormat: "diagnostic",
+            onError: "diagnostic",
+        });
+        if (Array.isArray(result)) {
+            blocks.push(...result);
+        }
+    }
+    return blocks;
+}
+//# sourceMappingURL=attachments.js.map

package/dist/core/utils/attachments.js.map

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

package/dist/core/utils/cwd-context.d.ts

@@ -0,0 +1,2 @@
+export declare function runWithCwd<T>(cwd: string, fn: () => Promise<T>): Promise<T>;
+export declare function getCwd(): string;

package/dist/core/utils/cwd-context.js

@@ -0,0 +1,9 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const storage = new AsyncLocalStorage();
+export function runWithCwd(cwd, fn) {
+    return storage.run(cwd, fn);
+}
+export function getCwd() {
+    return storage.getStore() ?? process.cwd();
+}
+//# sourceMappingURL=cwd-context.js.map

package/dist/core/utils/cwd-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cwd-context.js","sourceRoot":"","sources":["../../../src/core/utils/cwd-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAU,CAAC;AAEhD,MAAM,UAAU,UAAU,CAAI,GAAW,EAAE,EAAoB;IAC7D,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,MAAM;IACpB,OAAO,OAAO,CAAC,QAAQ,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AAC7C,CAAC"}

package/dist/core/utils/file-formats.d.ts

@@ -0,0 +1,4 @@
+import type { DocumentFormat, ImageFormat, VideoFormat } from "@strands-agents/sdk";
+export declare function detectImageFormat(filePath: string): ImageFormat | undefined;
+export declare function detectVideoFormat(filePath: string): VideoFormat | undefined;
+export declare function detectDocumentFormat(filePath: string): DocumentFormat | undefined;

package/dist/core/utils/file-formats.js

@@ -0,0 +1,48 @@
+import path from "node:path";
+// Extension → SDK media format. Values must match the unions the Strands SDK
+// exposes so ImageBlock / VideoBlock / DocumentBlock construct cleanly. Each
+// provider adapter (OpenAI, Anthropic, Bedrock, Google, Ollama) converts these
+// into its native shape or gracefully drops unsupported ones with a warning —
+// the paired TextBlock metadata still reaches the model either way.
+const IMAGE_EXT_FORMATS = {
+    ".png": "png",
+    ".jpg": "jpeg",
+    ".jpeg": "jpeg",
+    ".gif": "gif",
+    ".webp": "webp",
+};
+const VIDEO_EXT_FORMATS = {
+    ".mp4": "mp4",
+    ".mov": "mov",
+    ".mkv": "mkv",
+    ".webm": "webm",
+    ".flv": "flv",
+    ".mpeg": "mpeg",
+    ".mpg": "mpg",
+    ".wmv": "wmv",
+    ".3gp": "3gp",
+};
+const DOCUMENT_EXT_FORMATS = {
+    ".pdf": "pdf",
+    ".csv": "csv",
+    ".doc": "doc",
+    ".docx": "docx",
+    ".xls": "xls",
+    ".xlsx": "xlsx",
+    ".html": "html",
+    ".htm": "html",
+    ".txt": "txt",
+    ".md": "md",
+    ".json": "json",
+    ".xml": "xml",
+};
+export function detectImageFormat(filePath) {
+    return IMAGE_EXT_FORMATS[path.extname(filePath).toLowerCase()];
+}
+export function detectVideoFormat(filePath) {
+    return VIDEO_EXT_FORMATS[path.extname(filePath).toLowerCase()];
+}
+export function detectDocumentFormat(filePath) {
+    return DOCUMENT_EXT_FORMATS[path.extname(filePath).toLowerCase()];
+}
+//# sourceMappingURL=file-formats.js.map

package/dist/core/utils/file-formats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-formats.js","sourceRoot":"","sources":["../../../src/core/utils/file-formats.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,8EAA8E;AAC9E,oEAAoE;AACpE,MAAM,iBAAiB,GAAgC;IACrD,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,MAAM;CAChB,CAAC;AAEF,MAAM,iBAAiB,GAAgC;IACrD,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;CACd,CAAC;AAEF,MAAM,oBAAoB,GAAmC;IAC3D,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,KAAK;CACd,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,QAAgB;IAEhB,OAAO,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACpE,CAAC"}

package/dist/core/utils/paths.d.ts

@@ -0,0 +1,7 @@
+export declare const basePath: () => string;
+export declare const configJsonPath: () => string;
+export declare const instructionsMdPath: () => string;
+export declare const mcpJsonPath: () => string;
+export declare const sessionsPath: () => string;
+export declare const attachmentsPath: () => string;
+export declare const skillsPath: () => string;

package/dist/core/utils/paths.js

@@ -0,0 +1,25 @@
+import { homedir } from "os";
+import { join } from "path";
+const APP_FOLDER = ".hooman";
+export const basePath = () => {
+    return join(homedir(), APP_FOLDER);
+};
+export const configJsonPath = () => {
+    return join(basePath(), "config.json");
+};
+export const instructionsMdPath = () => {
+    return join(basePath(), "instructions.md");
+};
+export const mcpJsonPath = () => {
+    return join(basePath(), "mcp.json");
+};
+export const sessionsPath = () => {
+    return join(basePath(), "sessions");
+};
+export const attachmentsPath = () => {
+    return join(basePath(), "attachments");
+};
+export const skillsPath = () => {
+    return join(basePath(), "skills");
+};
+//# sourceMappingURL=paths.js.map

package/dist/core/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/core/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,UAAU,GAAG,SAAS,CAAC;AAE7B,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE;IAC3B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,aAAa,CAAC,CAAC;AACzC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE;IACrC,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,iBAAiB,CAAC,CAAC;AAC7C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,EAAE;IAC9B,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,UAAU,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE;IAC/B,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,UAAU,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE;IAClC,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,aAAa,CAAC,CAAC;AACzC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,EAAE;IAC7B,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC,CAAC"}

package/dist/daemon/approvals.d.ts

@@ -0,0 +1,5 @@
+import type { Agent, BeforeToolCallEvent } from "@strands-agents/sdk";
+import type { Manager as McpManager } from "../core/mcp/index.js";
+export declare function createDaemonApprovalHandler(manager: McpManager, agent: Agent, options?: {
+    yolo?: boolean;
+}): (event: BeforeToolCallEvent) => Promise<void>;

package/dist/daemon/approvals.js

@@ -0,0 +1,95 @@
+import { INTERNAL_ALWAYS_ALLOWED, allowToolForSession, isToolSessionAllowed, } from "../core/state/tool-approvals.js";
+const TOOL_DESCRIPTION_PREVIEW_LIMIT = 50;
+const TOOL_ARGS_PREVIEW_LIMIT = 50;
+function randomRequestId() {
+    return crypto.randomUUID();
+}
+function truncateWithEllipsis(text, max) {
+    return text.length > max ? `${text.slice(0, max)}…` : text;
+}
+function truncateWithHiddenCharCount(text, max) {
+    if (text.length <= max) {
+        return text;
+    }
+    const hidden = text.length - max;
+    return `${text.slice(0, max)}…(${hidden} chars)`;
+}
+function inputPreview(input) {
+    try {
+        const text = JSON.stringify(input) ?? "null";
+        return truncateWithHiddenCharCount(text, TOOL_ARGS_PREVIEW_LIMIT);
+    }
+    catch {
+        return truncateWithHiddenCharCount(String(input), TOOL_ARGS_PREVIEW_LIMIT);
+    }
+}
+function readOrigin(agent) {
+    const raw = agent.appState.get("origin");
+    if (!raw || typeof raw !== "object") {
+        return null;
+    }
+    const entry = raw;
+    const text = (value) => {
+        if (typeof value !== "string") {
+            return undefined;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    };
+    return {
+        server: text(entry.server),
+        source: text(entry.source),
+        user: text(entry.user),
+        session: text(entry.session),
+        thread: text(entry.thread),
+    };
+}
+export function createDaemonApprovalHandler(manager, agent, options) {
+    return async (event) => {
+        const name = event.toolUse.name;
+        if (options?.yolo) {
+            return;
+        }
+        if (INTERNAL_ALWAYS_ALLOWED.has(name) ||
+            isToolSessionAllowed(event.agent, name)) {
+            return;
+        }
+        const origin = readOrigin(agent);
+        if (!origin?.server) {
+            event.cancel = `Tool "${name}" was denied: missing daemon origin context.`;
+            return;
+        }
+        const supported = await manager.supportsChannelPermission(origin.server);
+        if (!supported) {
+            event.cancel = `Tool "${name}" was denied: MCP server "${origin.server}" does not support hooman/channel/permission.`;
+            return;
+        }
+        let behavior;
+        try {
+            behavior = await manager.requestChannelPermission(origin.server, {
+                requestId: randomRequestId(),
+                tool: name,
+                description: truncateWithEllipsis(event.tool?.description?.trim() ??
+                    `Run tool "${name}" in daemon mode.`, TOOL_DESCRIPTION_PREVIEW_LIMIT),
+                preview: inputPreview(event.toolUse.input),
+                source: origin.source,
+                user: origin.user,
+                session: origin.session,
+                thread: origin.thread,
+            });
+        }
+        catch (error) {
+            event.cancel = `Tool "${name}" was denied: failed to request permission (${error instanceof Error ? error.message : String(error)}).`;
+            return;
+        }
+        if (behavior === "allow_once") {
+            return;
+        }
+        if (behavior === "allow_always") {
+            allowToolForSession(event.agent, name);
+            return;
+        }
+        event.cancel = `Tool "${name}" was rejected by remote approval.`;
+    };
+}
+//# sourceMappingURL=approvals.js.map

package/dist/daemon/approvals.js.map

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

package/dist/daemon/index.d.ts

@@ -0,0 +1,11 @@
+import { type Agent } from "@strands-agents/sdk";
+import type { Manager as McpManager } from "../core/mcp/index.js";
+type RunDaemonOptions = {
+    agent: Agent;
+    manager: McpManager;
+    session?: string;
+    channels: boolean;
+    debug?: boolean;
+};
+export declare function main(options: RunDaemonOptions): Promise<void>;
+export {};

package/dist/daemon/index.js

@@ -0,0 +1,106 @@
+import { stderr } from "node:process";
+import { Message, TextBlock, } from "@strands-agents/sdk";
+import { HOOMAN_CHANNEL } from "../core/mcp/index.js";
+import { attachmentPathsToPromptBlocks } from "../core/utils/attachments.js";
+import { createQueue } from "./queue.js";
+const MAX_ATTACHMENT_BYTES = 1024 * 1024;
+function debug(text) {
+    stderr.write(`[daemon] ${text}\n`);
+}
+function resolveSessionId(message, fallback) {
+    const raw = message.meta.session?.trim() || fallback;
+    if (!raw)
+        return undefined;
+    // Namespace per `server:channel` so the same chat id coming from two
+    // different MCP servers (or two channels on the same server) never collide.
+    return `${message.meta.subscription.server}:${message.meta.subscription.channel}:${raw}`;
+}
+function resolveUserId(message, session) {
+    const raw = message.meta.user?.trim();
+    if (!raw)
+        return session;
+    // Same user id across different servers is not the same human, so scope
+    // user ids by server. Channel is intentionally omitted so long-term memory
+    // can stay consistent for a user across rooms within one server.
+    return `${message.meta.subscription.server}:${raw}`;
+}
+function formatSubscriptions(subscriptions) {
+    if (subscriptions.length === 0) {
+        return "none";
+    }
+    const servers = [
+        ...new Set(subscriptions.map((subscription) => subscription.server)),
+    ].sort((left, right) => left.localeCompare(right));
+    return `${servers.length} MCP server(s): ${servers.join(", ")}`;
+}
+async function toInvokeInput(message) {
+    if (message.attachments.length === 0) {
+        return message.prompt;
+    }
+    const blocks = [new TextBlock(message.prompt)];
+    const attachmentBlocks = await attachmentPathsToPromptBlocks(message.attachments, {
+        maxBytes: MAX_ATTACHMENT_BYTES,
+    });
+    blocks.push(...attachmentBlocks);
+    return [new Message({ role: "user", content: blocks })];
+}
+export async function main(options) {
+    if (!options.channels) {
+        throw new Error("No daemon inputs enabled. Pass --channels.");
+    }
+    const channels = [HOOMAN_CHANNEL];
+    debug(`starting daemon for channel(s): ${channels.join(", ")}`);
+    let unsubscribe = () => { };
+    const [queue, stop] = await createQueue(async (message) => {
+        const tag = `${message.meta.subscription.server}:${message.meta.subscription.channel}`;
+        const session = resolveSessionId(message, options.session);
+        const user = resolveUserId(message, session);
+        debug(`dequeued → ${tag} session=${session} user=${user}`);
+        if (options.debug) {
+            debug(`raw → ${JSON.stringify(message.meta)}`);
+        }
+        options.agent.appState.set("userId", user);
+        options.agent.appState.set("sessionId", session);
+        const origin = {
+            server: message.meta.subscription.server,
+            channel: message.meta.subscription.channel,
+            ...(message.meta.source ? { source: message.meta.source } : {}),
+            ...(message.meta.user ? { user: message.meta.user } : {}),
+            ...(message.meta.session ? { session: message.meta.session } : {}),
+            ...(message.meta.thread ? { thread: message.meta.thread } : {}),
+        };
+        options.agent.appState.set("origin", {
+            ...origin,
+        });
+        try {
+            debug(`invoking agent → ${tag} session=${session} user=${user}`);
+            const invokeInput = await toInvokeInput(message);
+            if (typeof invokeInput === "string") {
+                await options.agent.invoke(invokeInput);
+            }
+            else {
+                for await (const event of options.agent.stream(invokeInput)) {
+                    void event;
+                }
+            }
+            debug(`completed → ${tag} session=${session} user=${user}`);
+        }
+        catch (error) {
+            const text = error instanceof Error ? error.message : String(error);
+            debug(`turn failed → ${tag} session=${session} user=${user}: ${text}`);
+        }
+    }, () => unsubscribe());
+    const handle = await options.manager.subscribeToChannels(channels, (message) => {
+        debug(`received notification → ${message.meta.subscription.server}:${message.meta.subscription.channel}`);
+        void queue.push(message);
+    });
+    unsubscribe = handle.unsubscribe;
+    debug(`subscribed → ${formatSubscriptions(handle.subscriptions)}`);
+    try {
+        await stop();
+    }
+    finally {
+        debug("stopping daemon");
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/daemon/index.js.map

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

package/dist/daemon/queue.d.ts

@@ -0,0 +1,5 @@
+import fastq from "fastq";
+import type { ChannelMessage } from "../core/mcp/index.js";
+type MessageQueue = fastq.queueAsPromised<ChannelMessage, void>;
+export declare function createQueue(handler: (message: ChannelMessage) => Promise<void>, cleanup: () => void): Promise<[MessageQueue, () => Promise<void>]>;
+export {};

package/dist/daemon/queue.js

@@ -0,0 +1,38 @@
+import fastq from "fastq";
+export async function createQueue(handler, cleanup) {
+    let stopping = false;
+    let resolver = null;
+    const queue = fastq.promise(async (message) => {
+        await handler(message);
+    }, 1);
+    const stopper = new Promise((resolve) => {
+        resolver = resolve;
+    });
+    const shutdown = () => {
+        if (stopping) {
+            return;
+        }
+        stopping = true;
+        queue.kill();
+        resolver?.();
+    };
+    const onSigInt = () => shutdown();
+    const onSigTerm = () => shutdown();
+    process.on("SIGINT", onSigInt);
+    process.on("SIGTERM", onSigTerm);
+    return [
+        queue,
+        async () => {
+            try {
+                await stopper;
+            }
+            finally {
+                cleanup();
+                await queue.drained().catch(() => { });
+                process.off("SIGINT", onSigInt);
+                process.off("SIGTERM", onSigTerm);
+            }
+        },
+    ];
+}
+//# sourceMappingURL=queue.js.map

package/dist/daemon/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/daemon/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAmD,EACnD,OAAmB;IAEnB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,QAAQ,GAAwB,IAAI,CAAC;IACzC,MAAM,KAAK,GAAiB,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAuB,EAAE,EAAE;QAC1E,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC,EAAE,CAAC,CAAC,CAAC;IAEN,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC5C,QAAQ,GAAG,OAAO,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC;QAChB,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,QAAQ,EAAE,EAAE,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAClC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAEnC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAEjC,OAAO;QACL,KAAK;QACL,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC;YAChB,CAAC;oBAAS,CAAC;gBACT,OAAO,EAAE,CAAC;gBACV,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/exec/approvals.d.ts

@@ -0,0 +1,6 @@
+import { BeforeToolCallEvent } from "@strands-agents/sdk";
+type BeforeToolCallEventHandler = (event: BeforeToolCallEvent) => Promise<void>;
+export declare function createToolApprovalHandler(options?: {
+    yolo?: boolean;
+}): BeforeToolCallEventHandler;
+export {};

package/dist/exec/approvals.js

@@ -0,0 +1,74 @@
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+import { INTERNAL_ALWAYS_ALLOWED, allowToolForSession, isToolSessionAllowed, } from "../core/state/tool-approvals.js";
+const INPUT_PREVIEW_LIMIT = 1_024;
+function inputPreview(input) {
+    try {
+        const text = JSON.stringify(input, null, 2) ?? "null";
+        return text.length > INPUT_PREVIEW_LIMIT
+            ? `${text.slice(0, INPUT_PREVIEW_LIMIT)}\n... (truncated)`
+            : text;
+    }
+    catch {
+        return String(input);
+    }
+}
+function canPromptForApproval() {
+    return Boolean(stdin.isTTY && stdout.isTTY);
+}
+async function promptForApproval(event) {
+    const rl = createInterface({ input: stdin, output: stdout });
+    const description = event.tool?.description?.trim();
+    const preview = inputPreview(event.toolUse.input);
+    try {
+        stdout.write(`\nTool approval required\n`);
+        stdout.write(`Tool: ${event.toolUse.name}\n`);
+        if (description) {
+            stdout.write(`Description: ${description}\n`);
+        }
+        stdout.write(`Input:\n${preview}\n`);
+        stdout.write(`Options: [a]llow once, [r]eject, [A]lways allow\n`);
+        while (true) {
+            const answer = (await rl.question("> ")).trim();
+            if (answer === "a" || answer === "allow" || answer === "") {
+                return "allow";
+            }
+            if (answer === "r" || answer === "reject") {
+                return "reject";
+            }
+            if (answer === "A" || answer === "always") {
+                return "always";
+            }
+            stdout.write("Enter a, r, or A.\n");
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+export function createToolApprovalHandler(options) {
+    return async function onBeforeToolCallEvent(event) {
+        const name = event.toolUse.name;
+        if (options?.yolo) {
+            return;
+        }
+        if (INTERNAL_ALWAYS_ALLOWED.has(name) ||
+            isToolSessionAllowed(event.agent, name)) {
+            return;
+        }
+        if (!canPromptForApproval()) {
+            event.cancel = `Tool "${name}" requires approval, but no interactive terminal is available.`;
+            return;
+        }
+        const decision = await promptForApproval(event);
+        if (decision === "allow") {
+            return;
+        }
+        if (decision === "always") {
+            allowToolForSession(event.agent, name);
+            return;
+        }
+        event.cancel = `Tool "${name}" was rejected by the user.`;
+    };
+}
+//# sourceMappingURL=approvals.js.map

package/dist/exec/approvals.js.map

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