@office-agents/sdk 0.0.1

package/dist/tools/bash.js

@@ -0,0 +1,69 @@
+import { Type } from "@sinclair/typebox";
+import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, truncateTail, } from "../truncate";
+import { getBash } from "../vfs";
+import { defineTool, toolError, toolSuccess } from "./types";
+export const bashTool = defineTool({
+    name: "bash",
+    label: "Bash",
+    description: "Execute bash commands in a sandboxed virtual environment. " +
+        `Output is truncated to last ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). ` +
+        "The filesystem is in-memory with user uploads in /home/user/uploads/. " +
+        "Useful for: file operations (ls, cat, grep, find), text processing (awk, sed, jq, sort, uniq), " +
+        "data analysis (wc, cut, paste), and general scripting. " +
+        "Network access is disabled. No external runtimes (node, python, etc.) are available.",
+    parameters: Type.Object({
+        command: Type.String({
+            description: "Bash command(s) to execute. Can be a single command or a script with multiple lines. " +
+                "Supports pipes (|), redirections (>, >>), command chaining (&&, ||, ;), " +
+                "variables, loops, conditionals, and functions.",
+        }),
+        explanation: Type.Optional(Type.String({
+            description: "Brief explanation (max 50 chars)",
+            maxLength: 50,
+        })),
+    }),
+    execute: async (_toolCallId, params) => {
+        try {
+            const bash = getBash();
+            const result = await bash.exec(params.command);
+            let output = "";
+            if (result.stdout) {
+                output += result.stdout;
+            }
+            if (result.stderr) {
+                if (output && !output.endsWith("\n"))
+                    output += "\n";
+                output += `stderr: ${result.stderr}`;
+            }
+            if (result.exitCode !== 0) {
+                if (output && !output.endsWith("\n"))
+                    output += "\n";
+                output += `[exit code: ${result.exitCode}]`;
+            }
+            if (!output) {
+                output = "[no output]";
+            }
+            output = output.trim();
+            const truncation = truncateTail(output);
+            let outputText = truncation.content;
+            if (truncation.truncated) {
+                const startLine = truncation.totalLines - truncation.outputLines + 1;
+                const endLine = truncation.totalLines;
+                if (truncation.truncatedBy === "lines") {
+                    outputText += `\n\n[Showing last ${truncation.outputLines} of ${truncation.totalLines} lines. Output truncated.]`;
+                }
+                else {
+                    outputText += `\n\n[Showing lines ${startLine}-${endLine} of ${truncation.totalLines} (${formatSize(DEFAULT_MAX_BYTES)} limit). Output truncated.]`;
+                }
+            }
+            return toolSuccess({ output: outputText, exitCode: result.exitCode });
+        }
+        catch (error) {
+            const message = error instanceof Error
+                ? error.message
+                : "Unknown error executing bash command";
+            return toolError(message);
+        }
+    },
+});
+//# sourceMappingURL=bash.js.map

package/dist/tools/bash.js.map

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

package/dist/tools/read-file.d.ts

@@ -0,0 +1,2 @@
+export declare const readTool: import("@mariozechner/pi-agent-core").AgentTool<import("@sinclair/typebox").TSchema, any>;
+//# sourceMappingURL=read-file.d.ts.map

package/dist/tools/read-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,QAAQ,2FAoInB,CAAC"}

package/dist/tools/read-file.js

@@ -0,0 +1,116 @@
+import { Type } from "@sinclair/typebox";
+import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, truncateHead, } from "../truncate";
+import { fileExists, getFileType, listUploads, readFileBuffer, toBase64, } from "../vfs";
+import { defineTool, toolError, toolText } from "./types";
+export const readTool = defineTool({
+    name: "read",
+    label: "Read",
+    description: "Read a file from the virtual filesystem. " +
+        "Files are uploaded by the user to /home/user/uploads/. " +
+        "For images (png, jpg, gif, webp), returns the image for you to analyze visually. " +
+        `For text files, output is truncated to ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). ` +
+        "Use offset/limit for large files. When you need the full file, continue with offset until complete. " +
+        "Use 'bash ls /home/user/uploads' to see available files.",
+    parameters: Type.Object({
+        path: Type.String({
+            description: "Path to the file. Can be absolute (starting with /) or relative to /home/user/uploads/. Example: 'image.png' or '/home/user/uploads/data.csv'",
+        }),
+        offset: Type.Optional(Type.Number({
+            description: "Line number to start reading from (1-indexed)",
+        })),
+        limit: Type.Optional(Type.Number({
+            description: "Maximum number of lines to read",
+        })),
+        explanation: Type.Optional(Type.String({
+            description: "Brief explanation (max 50 chars)",
+            maxLength: 50,
+        })),
+    }),
+    execute: async (_toolCallId, params) => {
+        try {
+            const path = params.path;
+            const fullPath = path.startsWith("/")
+                ? path
+                : `/home/user/uploads/${path}`;
+            // Check if file exists
+            if (!(await fileExists(fullPath))) {
+                // List available files to help the user
+                const uploads = await listUploads();
+                const hint = uploads.length > 0
+                    ? `Available files: ${uploads.join(", ")}`
+                    : "No files uploaded yet.";
+                return toolError(`File not found: ${fullPath}. ${hint}`);
+            }
+            const filename = fullPath.split("/").pop() || "";
+            const { isImage, mimeType } = getFileType(filename);
+            if (isImage) {
+                // Return image as base64 for vision models
+                const data = await readFileBuffer(fullPath);
+                const base64 = toBase64(data);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Read image file: ${filename} [${mimeType}]`,
+                        },
+                        { type: "image", data: base64, mimeType },
+                    ],
+                    details: undefined,
+                };
+            }
+            // For text files, apply truncation
+            const data = await readFileBuffer(fullPath);
+            const decoder = new TextDecoder();
+            const text = decoder.decode(data);
+            const allLines = text.split("\n");
+            const totalFileLines = allLines.length;
+            // Apply offset (1-indexed to 0-indexed)
+            const startLine = params.offset ? Math.max(0, params.offset - 1) : 0;
+            const startLineDisplay = startLine + 1;
+            if (startLine >= allLines.length) {
+                return toolError(`Offset ${params.offset} is beyond end of file (${allLines.length} lines total)`);
+            }
+            // Apply limit param if specified
+            let selectedContent;
+            let userLimitedLines;
+            if (params.limit !== undefined) {
+                const endLine = Math.min(startLine + params.limit, allLines.length);
+                selectedContent = allLines.slice(startLine, endLine).join("\n");
+                userLimitedLines = endLine - startLine;
+            }
+            else {
+                selectedContent = allLines.slice(startLine).join("\n");
+            }
+            // Apply truncation
+            const truncation = truncateHead(selectedContent);
+            let outputText;
+            if (truncation.truncated) {
+                const endLineDisplay = startLineDisplay + truncation.outputLines - 1;
+                const nextOffset = endLineDisplay + 1;
+                outputText = truncation.content;
+                if (truncation.truncatedBy === "lines") {
+                    outputText += `\n\n[Showing lines ${startLineDisplay}-${endLineDisplay} of ${totalFileLines}. Use offset=${nextOffset} to continue.]`;
+                }
+                else {
+                    outputText += `\n\n[Showing lines ${startLineDisplay}-${endLineDisplay} of ${totalFileLines} (${formatSize(DEFAULT_MAX_BYTES)} limit). Use offset=${nextOffset} to continue.]`;
+                }
+            }
+            else if (userLimitedLines !== undefined &&
+                startLine + userLimitedLines < allLines.length) {
+                const remaining = allLines.length - (startLine + userLimitedLines);
+                const nextOffset = startLine + userLimitedLines + 1;
+                outputText = truncation.content;
+                outputText += `\n\n[${remaining} more lines in file. Use offset=${nextOffset} to continue.]`;
+            }
+            else {
+                outputText = truncation.content;
+            }
+            return toolText(outputText);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unknown error reading file";
+            return toolError(message);
+        }
+    },
+});
+//# sourceMappingURL=read-file.js.map

package/dist/tools/read-file.js.map

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

package/dist/tools/types.d.ts

@@ -0,0 +1,16 @@
+import type { AgentTool, AgentToolResult } from "@mariozechner/pi-agent-core";
+import type { Static, TObject } from "@sinclair/typebox";
+export type ToolResult = AgentToolResult<undefined>;
+interface ToolConfig<T extends TObject> {
+    name: string;
+    label: string;
+    description: string;
+    parameters: T;
+    execute: (toolCallId: string, params: Static<T>, signal?: AbortSignal) => Promise<ToolResult>;
+}
+export declare function defineTool<T extends TObject>(config: ToolConfig<T>): AgentTool;
+export declare function toolSuccess(data: unknown): ToolResult;
+export declare function toolError(message: string): ToolResult;
+export declare function toolText(text: string): ToolResult;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;AAEpD,UAAU,UAAU,CAAC,CAAC,SAAS,OAAO;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,CAAC;IACd,OAAO,EAAE,CACP,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EACjB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,CAAC;CAC1B;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,OAAO,EAC1C,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GACpB,SAAS,CAEX;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAOrD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAUrD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAKjD"}

package/dist/tools/types.js

@@ -0,0 +1,28 @@
+export function defineTool(config) {
+    return config;
+}
+export function toolSuccess(data) {
+    const result = typeof data === "object" && data !== null ? { ...data } : { result: data };
+    return {
+        content: [{ type: "text", text: JSON.stringify(result) }],
+        details: undefined,
+    };
+}
+export function toolError(message) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({ success: false, error: message }),
+            },
+        ],
+        details: undefined,
+    };
+}
+export function toolText(text) {
+    return {
+        content: [{ type: "text", text }],
+        details: undefined,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,UAAU,CACxB,MAAqB;IAErB,OAAO,MAA8B,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,MAAM,MAAM,GACV,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC7E,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,OAAO,EAAE,SAAS;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;aACzD;SACF;QACD,OAAO,EAAE,SAAS;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,OAAO,EAAE,SAAS;KACnB,CAAC;AACJ,CAAC"}

package/dist/truncate.d.ts

@@ -0,0 +1,19 @@
+export declare const DEFAULT_MAX_LINES = 2000;
+export declare const DEFAULT_MAX_BYTES: number;
+export interface TruncationResult {
+    content: string;
+    truncated: boolean;
+    truncatedBy: "lines" | "bytes" | null;
+    totalLines: number;
+    totalBytes: number;
+    outputLines: number;
+    outputBytes: number;
+}
+export interface TruncationOptions {
+    maxLines?: number;
+    maxBytes?: number;
+}
+export declare function formatSize(bytes: number): string;
+export declare function truncateHead(content: string, options?: TruncationOptions): TruncationResult;
+export declare function truncateTail(content: string, options?: TruncationOptions): TruncationResult;
+//# sourceMappingURL=truncate.d.ts.map

package/dist/truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../src/truncate.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,iBAAiB,QAAY,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AAMD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAgDlB;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAgDlB"}

package/dist/truncate.js

@@ -0,0 +1,101 @@
+export const DEFAULT_MAX_LINES = 2000;
+export const DEFAULT_MAX_BYTES = 50 * 1024; // 50KB
+export function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+function byteLength(str) {
+    return new TextEncoder().encode(str).byteLength;
+}
+export function truncateHead(content, options = {}) {
+    const maxLines = options.maxLines ?? DEFAULT_MAX_LINES;
+    const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+    const totalBytes = byteLength(content);
+    const lines = content.split("\n");
+    const totalLines = lines.length;
+    if (totalLines <= maxLines && totalBytes <= maxBytes) {
+        return {
+            content,
+            truncated: false,
+            truncatedBy: null,
+            totalLines,
+            totalBytes,
+            outputLines: totalLines,
+            outputBytes: totalBytes,
+        };
+    }
+    const outputLines = [];
+    let outputBytesCount = 0;
+    let truncatedBy = "lines";
+    for (let i = 0; i < lines.length && i < maxLines; i++) {
+        const line = lines[i];
+        const lb = byteLength(line) + (i > 0 ? 1 : 0);
+        if (outputBytesCount + lb > maxBytes) {
+            truncatedBy = "bytes";
+            break;
+        }
+        outputLines.push(line);
+        outputBytesCount += lb;
+    }
+    if (outputLines.length >= maxLines && outputBytesCount <= maxBytes) {
+        truncatedBy = "lines";
+    }
+    const outputContent = outputLines.join("\n");
+    return {
+        content: outputContent,
+        truncated: true,
+        truncatedBy,
+        totalLines,
+        totalBytes,
+        outputLines: outputLines.length,
+        outputBytes: byteLength(outputContent),
+    };
+}
+export function truncateTail(content, options = {}) {
+    const maxLines = options.maxLines ?? DEFAULT_MAX_LINES;
+    const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+    const totalBytes = byteLength(content);
+    const lines = content.split("\n");
+    const totalLines = lines.length;
+    if (totalLines <= maxLines && totalBytes <= maxBytes) {
+        return {
+            content,
+            truncated: false,
+            truncatedBy: null,
+            totalLines,
+            totalBytes,
+            outputLines: totalLines,
+            outputBytes: totalBytes,
+        };
+    }
+    const outputLines = [];
+    let outputBytesCount = 0;
+    let truncatedBy = "lines";
+    for (let i = lines.length - 1; i >= 0 && outputLines.length < maxLines; i--) {
+        const line = lines[i];
+        const lb = byteLength(line) + (outputLines.length > 0 ? 1 : 0);
+        if (outputBytesCount + lb > maxBytes) {
+            truncatedBy = "bytes";
+            break;
+        }
+        outputLines.unshift(line);
+        outputBytesCount += lb;
+    }
+    if (outputLines.length >= maxLines && outputBytesCount <= maxBytes) {
+        truncatedBy = "lines";
+    }
+    const outputContent = outputLines.join("\n");
+    return {
+        content: outputContent,
+        truncated: true,
+        truncatedBy,
+        totalLines,
+        totalBytes,
+        outputLines: outputLines.length,
+        outputBytes: byteLength(outputContent),
+    };
+}
+//# sourceMappingURL=truncate.js.map

package/dist/truncate.js.map

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

package/dist/vfs/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Virtual Filesystem (VFS) for the agent
+ *
+ * Provides an in-memory filesystem using just-bash that allows:
+ * - Users to upload files (images, CSVs, etc.)
+ * - Agent to read files via read_file tool
+ * - Agent to execute bash commands via bash tool
+ */
+import { Bash, type CustomCommand, InMemoryFs } from "just-bash/browser";
+export declare function setSkillFiles(files: Record<string, Uint8Array | string>): void;
+export declare function setStaticFiles(files: Record<string, string>): void;
+export declare function setCustomCommands(factory: () => CustomCommand[]): void;
+export declare function getVfs(): InMemoryFs;
+export declare function getBash(): Bash;
+export declare function resetVfs(): void;
+export declare function snapshotVfs(): Promise<{
+    path: string;
+    data: Uint8Array;
+}[]>;
+export declare function restoreVfs(files: {
+    path: string;
+    data: Uint8Array;
+}[]): Promise<void>;
+export declare function writeFile(path: string, content: string | Uint8Array): Promise<void>;
+export declare function readFile(path: string): Promise<string>;
+export declare function readFileBuffer(path: string): Promise<Uint8Array>;
+export declare function fileExists(path: string): Promise<boolean>;
+export declare function deleteFile(path: string): Promise<void>;
+export declare function listUploads(): Promise<string[]>;
+export declare function getFileType(filename: string): {
+    isImage: boolean;
+    mimeType: string;
+};
+export declare function toBase64(data: Uint8Array): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/vfs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vfs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,KAAK,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAUzE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,GACzC,IAAI,CAEN;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAElE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,aAAa,EAAE,GAAG,IAAI,CAEtE;AAED,wBAAgB,MAAM,IAAI,UAAU,CASnC;AAED,wBAAgB,OAAO,IAAI,IAAI,CAS9B;AAED,wBAAgB,QAAQ,IAAI,IAAI,CAG/B;AAED,wBAAsB,WAAW,IAAI,OAAO,CAC1C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,EAAE,CACrC,CAmBA;AAED,wBAAsB,UAAU,CAC9B,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,EAAE,GAC1C,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,UAAU,GAC3B,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI5D;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAItE;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI/D;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI5D;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAQrD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAkCA;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAMjD"}

package/dist/vfs/index.js

@@ -0,0 +1,168 @@
+/**
+ * Virtual Filesystem (VFS) for the agent
+ *
+ * Provides an in-memory filesystem using just-bash that allows:
+ * - Users to upload files (images, CSVs, etc.)
+ * - Agent to read files via read_file tool
+ * - Agent to execute bash commands via bash tool
+ */
+import { Bash, InMemoryFs } from "just-bash/browser";
+let fs = null;
+let bash = null;
+let skillFilesCache = {};
+let staticFiles = {};
+let customCommandsFactory = null;
+export function setSkillFiles(files) {
+    skillFilesCache = files;
+}
+export function setStaticFiles(files) {
+    staticFiles = files;
+}
+export function setCustomCommands(factory) {
+    customCommandsFactory = factory;
+}
+export function getVfs() {
+    if (!fs) {
+        fs = new InMemoryFs({
+            "/home/user/uploads/.keep": "",
+            ...staticFiles,
+            ...skillFilesCache,
+        });
+    }
+    return fs;
+}
+export function getBash() {
+    if (!bash) {
+        bash = new Bash({
+            fs: getVfs(),
+            cwd: "/home/user",
+            customCommands: customCommandsFactory?.() ?? [],
+        });
+    }
+    return bash;
+}
+export function resetVfs() {
+    fs = null;
+    bash = null;
+}
+export async function snapshotVfs() {
+    const vfs = getVfs();
+    const allPaths = vfs.getAllPaths();
+    const files = [];
+    for (const p of allPaths) {
+        if (p.startsWith("/home/skills/"))
+            continue;
+        try {
+            const stat = await vfs.stat(p);
+            if (stat.isFile) {
+                const data = await vfs.readFileBuffer(p);
+                files.push({ path: p, data });
+            }
+        }
+        catch {
+            // skip unreadable entries
+        }
+    }
+    return files;
+}
+export async function restoreVfs(files) {
+    resetVfs();
+    if (files.length === 0) {
+        getVfs();
+        return;
+    }
+    const initialFiles = {
+        "/home/user/uploads/.keep": "",
+        ...staticFiles,
+        ...skillFilesCache,
+    };
+    for (const f of files) {
+        initialFiles[f.path] = f.data;
+    }
+    fs = new InMemoryFs(initialFiles);
+    bash = null;
+}
+export async function writeFile(path, content) {
+    const vfs = getVfs();
+    const fullPath = path.startsWith("/") ? path : `/home/user/uploads/${path}`;
+    const dir = fullPath.substring(0, fullPath.lastIndexOf("/"));
+    if (dir && dir !== "/") {
+        try {
+            await vfs.mkdir(dir, { recursive: true });
+        }
+        catch {
+            // Directory might already exist
+        }
+    }
+    await vfs.writeFile(fullPath, content);
+}
+export async function readFile(path) {
+    const vfs = getVfs();
+    const fullPath = path.startsWith("/") ? path : `/home/user/uploads/${path}`;
+    return vfs.readFile(fullPath);
+}
+export async function readFileBuffer(path) {
+    const vfs = getVfs();
+    const fullPath = path.startsWith("/") ? path : `/home/user/uploads/${path}`;
+    return vfs.readFileBuffer(fullPath);
+}
+export async function fileExists(path) {
+    const vfs = getVfs();
+    const fullPath = path.startsWith("/") ? path : `/home/user/uploads/${path}`;
+    return vfs.exists(fullPath);
+}
+export async function deleteFile(path) {
+    const vfs = getVfs();
+    const fullPath = path.startsWith("/") ? path : `/home/user/uploads/${path}`;
+    await vfs.rm(fullPath);
+}
+export async function listUploads() {
+    const vfs = getVfs();
+    try {
+        const entries = await vfs.readdir("/home/user/uploads");
+        return entries.filter((e) => e !== ".keep");
+    }
+    catch {
+        return [];
+    }
+}
+export function getFileType(filename) {
+    const ext = filename.toLowerCase().split(".").pop() || "";
+    const imageExts = {
+        png: "image/png",
+        jpg: "image/jpeg",
+        jpeg: "image/jpeg",
+        gif: "image/gif",
+        webp: "image/webp",
+        svg: "image/svg+xml",
+        bmp: "image/bmp",
+        ico: "image/x-icon",
+    };
+    if (ext in imageExts) {
+        return { isImage: true, mimeType: imageExts[ext] };
+    }
+    const mimeTypes = {
+        txt: "text/plain",
+        csv: "text/csv",
+        json: "application/json",
+        xml: "application/xml",
+        html: "text/html",
+        css: "text/css",
+        js: "application/javascript",
+        ts: "application/typescript",
+        md: "text/markdown",
+        pdf: "application/pdf",
+    };
+    return {
+        isImage: false,
+        mimeType: mimeTypes[ext] || "application/octet-stream",
+    };
+}
+export function toBase64(data) {
+    let binary = "";
+    for (let i = 0; i < data.length; i++) {
+        binary += String.fromCharCode(data[i]);
+    }
+    return btoa(binary);
+}
+//# sourceMappingURL=index.js.map

package/dist/vfs/index.js.map

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

package/dist/web/config.d.ts

@@ -0,0 +1,12 @@
+export interface WebConfig {
+    searchProvider: string;
+    fetchProvider: string;
+    apiKeys: {
+        exa?: string;
+        brave?: string;
+        serper?: string;
+    };
+}
+export declare function loadWebConfig(): WebConfig;
+export declare function saveWebConfig(config: Partial<WebConfig>): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/web/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/web/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE;QACP,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAcD,wBAAgB,aAAa,IAAI,SAAS,CAiBzC;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,QAWvD"}