@qwen-code/arena-agent 0.0.10-dev.15 → 0.0.10-dev.17

package/dist/connector-files.js

@@ -0,0 +1,249 @@
+import { constants } from "node:fs";
+import { mkdir, open, rename, rm } from "node:fs/promises";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import mime from "mime/lite";
+import { connectorRepeatGuidance } from "./connector-errors.js";
+export const connectorFileLimit = 104_857_600;
+export const connectorUploadTools = new Set(["google_drive__upload_file", "dropbox__upload_file", "gmail__create_draft"]);
+export const connectorDownloadTools = new Set(["google_drive__download_file", "google_drive__export_file", "dropbox__get_file_content", "gmail__get_attachment"]);
+export class ConnectorFileError extends Error {
+    cacheFailure;
+    constructor(message, cacheFailure = false) {
+        super(message);
+        this.cacheFailure = cacheFailure;
+    }
+}
+export function oversizedConnectorDownload(size) {
+    return new ConnectorFileError(`Arena did not send this download. File metadata reports ${size} bytes, more than the 100 MiB (104857600 byte) workspace file limit. Tell the user that the file is too large. Share its Drive link if available.`, true);
+}
+export function connectorApiBase(config) {
+    const url = new URL(config.apiBase || "https://ah-api.merge.dev");
+    const loopback = ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname);
+    if ((url.protocol !== "https:" && !(url.protocol === "http:" && loopback)) ||
+        url.username || url.password || url.search || url.hash) {
+        throw new Error("ARENA_MERGE_API_BASE must be an HTTPS origin (HTTP loopback is allowed for testing)");
+    }
+    return url;
+}
+export function connectorResultObjects(result) {
+    return result.content.flatMap(part => {
+        if (part.type !== "text")
+            return [];
+        try {
+            const value = JSON.parse(part.text);
+            return value && typeof value === "object" && !Array.isArray(value) ? [value] : [];
+        }
+        catch {
+            return [];
+        }
+    });
+}
+/** File bytes go through Merge's files API, never through the model context. */
+export class ConnectorFiles {
+    config;
+    options;
+    signal;
+    uploadBlocked;
+    constructor(config, options, signal) {
+        this.config = config;
+        this.options = options;
+        this.signal = signal;
+    }
+    reset() { this.uploadBlocked = undefined; }
+    restoreFailure(message) {
+        if (message.startsWith("Merge is rate-limiting file uploads."))
+            this.uploadBlocked = message;
+    }
+    requestSignal() {
+        const timeout = AbortSignal.timeout(this.config.timeoutMs ?? 60_000);
+        return this.signal ? AbortSignal.any([this.signal, timeout]) : timeout;
+    }
+    fileUrl(raw, action) {
+        const base = connectorApiBase(this.config), url = new URL(raw);
+        const prefix = `${base.pathname.replace(/\/$/, "")}/api/v1/files/`;
+        // The files service returns authenticated same-origin URLs. Never forward
+        // the access key to a connector-supplied host or through a redirect.
+        if (url.origin !== base.origin || !url.pathname.startsWith(prefix) || !url.pathname.endsWith(`/${action}/`)
+            || url.username || url.password || url.search || url.hash)
+            throw new ConnectorFileError("The connector returned an invalid file-transfer URL.");
+        return url;
+    }
+    async uploadFailure(response, rawPath) {
+        if (response.status === 429) {
+            const seconds = Math.max(1, Number(response.headers.get("retry-after")) || 15);
+            this.uploadBlocked = `Merge is rate-limiting file uploads. Arena did not send this file to the app. Do not upload more files in this reply. Tell the user that the upload limit was reached, and that they can try again in at least ${seconds} seconds.`;
+            throw new ConnectorFileError(this.uploadBlocked);
+        }
+        const text = await response.text();
+        if (/security.{0,30}(?:filter|block)|content.{0,30}block|guardrail/i.test(text)) {
+            throw new ConnectorFileError(`A security filter at the connector provider blocked the file at ${JSON.stringify(rawPath)} because of its content. The file was not sent. Do not send this content again, and do not change it to get past the filter. Tell the user that the connector provider blocked it.`, true);
+        }
+        throw new ConnectorFileError(`Arena could not upload the workspace file (HTTP ${response.status}), so it did not send the file to the app. ${connectorRepeatGuidance}`);
+    }
+    async upload(name, args) {
+        const input = args.input;
+        if (!connectorUploadTools.has(name) || !input || typeof input.file_path !== "string")
+            return args;
+        if (this.uploadBlocked)
+            throw new ConnectorFileError(this.uploadBlocked);
+        const rawPath = input.file_path;
+        let handle;
+        let phase = "read";
+        try {
+            if (!this.options.resolvePath)
+                throw new Error("No workspace resolver");
+            const target = await this.options.resolvePath(rawPath);
+            handle = await open(target, constants.O_RDONLY | constants.O_NOFOLLOW);
+            const metadata = await handle.stat();
+            if (!metadata.isFile())
+                throw new Error("Not a regular file");
+            if (!metadata.size)
+                throw new ConnectorFileError(`The file at ${JSON.stringify(rawPath)} is empty. The app rejects an empty file.`);
+            if (metadata.size > connectorFileLimit)
+                throw new ConnectorFileError(`The file at ${JSON.stringify(rawPath)} is larger than the 100 MiB (104857600 byte) workspace file limit. Arena did not send it to the app. Compress or split the file, or tell the user that it is too large.`);
+            const filename = path.basename(target), contentType = input.content_mime_type || mime.getType(filename) || "application/octet-stream";
+            const base = connectorApiBase(this.config);
+            base.pathname = `${base.pathname.replace(/\/$/, "")}/api/v1/files/`;
+            const headers = { Authorization: `Bearer ${this.config.accessKey}`, "Content-Type": "application/json" };
+            phase = "upload";
+            const reservation = await fetch(base, { method: "POST", headers, body: JSON.stringify({ filename, content_type: contentType, size_bytes: metadata.size }),
+                signal: this.requestSignal(), redirect: "error" });
+            if (!reservation.ok)
+                await this.uploadFailure(reservation, rawPath);
+            const slot = await reservation.json();
+            if (!slot.file_reference || !slot.upload?.url || slot.upload.method !== "PUT")
+                throw new ConnectorFileError("The connector provider returned an invalid upload reservation.");
+            if (slot.max_size_bytes !== undefined && metadata.size > slot.max_size_bytes)
+                throw new ConnectorFileError("The workspace file exceeds the connector provider's upload limit.");
+            const stream = handle.createReadStream({ autoClose: false, end: metadata.size - 1 });
+            let uploaded;
+            try {
+                uploaded = await fetch(this.fileUrl(slot.upload.url, "upload"), { method: "PUT", headers: { Authorization: headers.Authorization,
+                        "Content-Type": contentType, "Content-Length": String(metadata.size) }, body: stream,
+                    duplex: "half", signal: this.requestSignal(), redirect: "error" });
+            }
+            finally {
+                stream.destroy();
+            }
+            if (!uploaded.ok)
+                await this.uploadFailure(uploaded, rawPath);
+            const receipt = await uploaded.json();
+            if (receipt.size_bytes !== undefined && receipt.size_bytes !== metadata.size)
+                throw new ConnectorFileError("The connector provider received an incomplete file. Arena did not send it to the app.");
+            const result = structuredClone(args);
+            delete result.input.file_path;
+            result.input.file_reference = slot.file_reference;
+            if (name === "gmail__create_draft")
+                result.input.file_reference_filename = filename;
+            return result;
+        }
+        catch (error) {
+            if (this.signal?.aborted || error instanceof ConnectorFileError)
+                throw error;
+            if (phase === "upload")
+                throw new ConnectorFileError(`The workspace file upload failed before it was sent to the app. ${connectorRepeatGuidance}`);
+            if (error.code === "ENOENT")
+                throw new ConnectorFileError(`No file exists at ${JSON.stringify(rawPath)}. List the workspace to find the right path.`);
+            throw new ConnectorFileError(`Arena could not read the file from the workspace, so it did not send the file to the app. ${connectorRepeatGuidance}`);
+        }
+        finally {
+            await handle?.close();
+        }
+    }
+    async download(name, result, args) {
+        if (!connectorDownloadTools.has(name))
+            return undefined;
+        const objects = connectorResultObjects(result);
+        const payload = objects.map(value => value.data && typeof value.data === "object" ? value.data : value)
+            .find(value => value.download || (typeof value.content === "string" && value.encoding));
+        if (!payload)
+            return undefined;
+        if (!this.options.resolvePath)
+            throw new ConnectorFileError("No workspace is configured for connector file downloads.");
+        const transfer = payload.download;
+        const originalName = transfer?.filename || payload.name || payload.filename || args.input?.filename || (args.input?.path && path.posix.basename(args.input.path));
+        if (typeof originalName !== "string" || !originalName)
+            throw new ConnectorFileError("The connector did not return a file name.");
+        const filename = path.posix.basename(originalName.replaceAll("\\", "/")).replace(/[\x00-\x1f\x7f]/g, "_");
+        if (!filename || filename === "." || filename === "..")
+            throw new ConnectorFileError("The connector returned an invalid file name.");
+        const expectedSize = Number(transfer?.size_bytes ?? payload.size);
+        if (expectedSize > connectorFileLimit)
+            throw oversizedConnectorDownload(expectedSize);
+        const relative = `${name.split("__")[0]}/${filename}`;
+        let temporary;
+        let handle;
+        try {
+            const target = await this.options.resolvePath(relative);
+            await mkdir(path.dirname(target), { recursive: true });
+            // Resolve again after creating the directory; never follow a changed parent.
+            if (await this.options.resolvePath(relative) !== target)
+                throw new Error("Download directory changed");
+            temporary = path.join(path.dirname(target), `.arena-download-${randomUUID()}`);
+            handle = await open(temporary, "wx", 0o600);
+            let size = 0;
+            const append = async (chunk) => {
+                size += chunk.byteLength;
+                if (size > connectorFileLimit)
+                    throw oversizedConnectorDownload(size);
+                await handle.writeFile(chunk);
+            };
+            let contentType = transfer?.content_type || payload.mime_type || payload.content_type || "application/octet-stream";
+            if (transfer) {
+                if (transfer.method !== "GET" || typeof transfer.url !== "string")
+                    throw new ConnectorFileError("The connector returned an invalid download descriptor.");
+                const response = await fetch(this.fileUrl(transfer.url, "download"), { headers: { Authorization: `Bearer ${this.config.accessKey}` },
+                    signal: this.requestSignal(), redirect: "error" });
+                if (!response.ok || !response.body)
+                    throw new ConnectorFileError(`The connector file download failed (HTTP ${response.status}).`);
+                const length = Number(response.headers.get("content-length"));
+                if (length > connectorFileLimit) {
+                    await response.body.cancel();
+                    throw oversizedConnectorDownload(length);
+                }
+                contentType = transfer.content_type || response.headers.get("content-type") || contentType;
+                const reader = response.body.getReader();
+                try {
+                    while (true) {
+                        const next = await reader.read();
+                        if (next.done)
+                            break;
+                        await append(next.value);
+                    }
+                }
+                finally {
+                    await reader.cancel().catch(() => { });
+                    reader.releaseLock();
+                }
+            }
+            else {
+                const encoding = String(payload.encoding).toLowerCase();
+                if (!["utf-8", "utf8", "text", "base64", "base64url"].includes(encoding))
+                    throw new ConnectorFileError("The connector returned an unsupported file encoding.");
+                if (encoding.startsWith("base64") && !/^[a-zA-Z0-9+/_=\-\s]*$/.test(payload.content))
+                    throw new ConnectorFileError("The connector returned invalid base64 file bytes.");
+                await append(Buffer.from(payload.content, encoding === "base64url" ? "base64url" : encoding === "base64" ? "base64" : "utf8"));
+            }
+            if (Number.isFinite(expectedSize) && expectedSize >= 0 && expectedSize !== size)
+                throw new ConnectorFileError("The connector file download is incomplete. Arena did not save a partial file.");
+            await handle.close();
+            handle = undefined;
+            this.signal?.throwIfAborted();
+            await rename(temporary, target);
+            temporary = undefined;
+            return JSON.stringify({ file_path: relative, name: filename, mime_type: contentType, size });
+        }
+        catch (error) {
+            if (this.signal?.aborted || error instanceof ConnectorFileError)
+                throw error;
+            throw new ConnectorFileError(`Arena could not save the connector file in the workspace. ${connectorRepeatGuidance}`);
+        }
+        finally {
+            await handle?.close();
+            if (temporary)
+                await rm(temporary, { force: true }).catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=connector-files.js.map

package/dist/connector-files.js.map

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

package/dist/connector-input.d.ts

@@ -0,0 +1,10 @@
+type Schema = Record<string, any>;
+/** Captured model schemas use anyOf for optional objects. Keep their property order. */
+export declare function connectorSchemaValue(value: unknown, schema: Schema, root?: Schema): unknown;
+/** Documented Notion JSON fields accept an object or a well-formed JSON string. */
+export declare function normalizeConnectorInput(name: string, value: unknown): unknown;
+/** The MCP schema requires explicit nullable fields that Arena omits from its model contract.
+ * Apply these only to the backend request, without changing model-visible history.
+ */
+export declare function connectorBackendInput(value: unknown, schema: Schema, root?: Schema): unknown;
+export {};

package/dist/connector-input.js

@@ -0,0 +1,79 @@
+const isObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+function resolve(schema, root) {
+    const seen = new Set();
+    while (typeof schema.$ref === "string" && schema.$ref.startsWith("#/") && !seen.has(schema.$ref)) {
+        seen.add(schema.$ref);
+        const target = schema.$ref.slice(2).split("/").reduce((node, key) => node?.[key.replaceAll("~1", "/").replaceAll("~0", "~")], root);
+        if (!isObject(target))
+            break;
+        const { $ref, ...rest } = schema;
+        schema = { ...target, ...rest };
+    }
+    return schema;
+}
+function matchesKind(value, schema, root) {
+    schema = resolve(schema, root);
+    if (schema.anyOf || schema.oneOf)
+        return (schema.anyOf || schema.oneOf).some((s) => matchesKind(value, s, root));
+    const type = schema.type;
+    if (Array.isArray(type))
+        return type.some(t => matchesKind(value, { type: t }, root));
+    return !type || (type === "null" ? value === null : type === "object" ? isObject(value)
+        : type === "array" ? Array.isArray(value) : type === "integer" ? Number.isInteger(value) : typeof value === type);
+}
+function branch(value, schema, root) {
+    schema = resolve(schema, root);
+    const alternatives = schema.anyOf || schema.oneOf;
+    const selected = alternatives?.find((s) => matchesKind(value, s, root));
+    return selected ? branch(value, selected, root) : schema;
+}
+/** Captured model schemas use anyOf for optional objects. Keep their property order. */
+export function connectorSchemaValue(value, schema, root = schema) {
+    schema = branch(value, schema, root);
+    if (Array.isArray(value))
+        return value.map(v => connectorSchemaValue(v, schema.items || {}, root));
+    if (!isObject(value) || !schema.properties)
+        return value;
+    const entries = Object.entries(schema.properties).flatMap(([key, child]) => Object.hasOwn(value, key)
+        ? [[key, connectorSchemaValue(value[key], child, root)]] : []);
+    entries.push(...Object.entries(value).filter(([key]) => !Object.hasOwn(schema.properties, key)));
+    return Object.fromEntries(entries);
+}
+/** Documented Notion JSON fields accept an object or a well-formed JSON string. */
+export function normalizeConnectorInput(name, value) {
+    const result = structuredClone(value);
+    if (!isObject(result) || !isObject(result.input) || !name.startsWith("notion__"))
+        return result;
+    const fields = name === "notion__search" ? ["sort", "filter"]
+        : name === "notion__query_database" ? ["filter"]
+            : name === "notion__update_database" ? ["properties"]
+                : name === "notion__create_page" || name === "notion__update_page" ? ["properties", "children"] : [];
+    for (const field of fields)
+        if (typeof result.input[field] === "string")
+            result.input[field] = JSON.parse(result.input[field]);
+    return result;
+}
+/** The MCP schema requires explicit nullable fields that Arena omits from its model contract.
+ * Apply these only to the backend request, without changing model-visible history.
+ */
+export function connectorBackendInput(value, schema, root = schema) {
+    schema = branch(value, schema, root);
+    if ((isObject(value) || Array.isArray(value)) && !matchesKind(value, schema, root) && matchesKind("", schema, root))
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return value.map(v => connectorBackendInput(v, schema.items || {}, root));
+    if (!isObject(value))
+        return value;
+    const result = structuredClone(value);
+    for (const [key, child] of Object.entries(schema.properties || {})) {
+        if (Object.hasOwn(result, key)) {
+            // Some connector revisions encode JSON dictionaries as strings. Adapt at
+            // that boundary only; a native object schema retains native objects.
+            result[key] = connectorBackendInput(result[key], child, root);
+        }
+        else if (schema.required?.includes(key) && matchesKind(null, child, root))
+            result[key] = null;
+    }
+    return result;
+}
+//# sourceMappingURL=connector-input.js.map

package/dist/connector-input.js.map

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

package/dist/connector-mcp.d.ts

@@ -1,6 +1,7 @@
 import { type CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 import { type ValidateFunction } from "ajv";
 import { type ConnectorService } from "./connectors.js";
+import { type ConnectorFileOptions } from "./connector-files.js";
 import type { Message, ToolDefinition } from "./types.js";
 export interface MergeConnectorConfig {
     accessKey?: string;
@@ -16,9 +17,10 @@ interface CatalogEntry {
     description: string;
 }
 export declare function capturedConnectorCatalog(service: ConnectorService): CatalogEntry[];
+export declare function capturedConnectorDefinitions(service: ConnectorService): ToolDefinition[] | undefined;
 export declare const connectorFailureText = "Something went wrong. Please try again.";
 export declare const connectorTruncationMarker = "\n...[middle of result omitted]...\n";
-export declare const connectorTruncationNote = "This result is not complete. It holds the start and the end of a larger result, and the middle is missing. Do not parse it as JSON. The same call with the same arguments returns this same truncated result. Make the query more narrow with a filter, or use a pagination option that this tool provides.";
+export declare const connectorTruncationNote = "This result is not complete. It holds the start and the end of a larger result, and the middle is missing. Do not parse it as JSON. The same call with the same arguments returns this same truncated result. If this tool offers filters or pagination, use those arguments to request a smaller result. If it offers neither, do not invent arguments or infer values from the omitted content. Use another tool that can return the required detail, or tell the user that the detail is unavailable.";
 /** Captured display shape, independent of the backend's negotiated MCP revision. */
 export declare function formatConnectorResult(result: CallToolResult): string;
 export declare class ConnectorTools {
@@ -30,15 +32,26 @@ export declare class ConnectorTools {
     private readonly connections;
     private readonly loading;
     private readonly loaded;
-    constructor(allowed: readonly ConnectorService[], config?: MergeConnectorConfig, disallowed?: readonly string[], signal?: AbortSignal | undefined);
+    private readonly connected;
+    private readonly files;
+    private readonly failures;
+    private readonly completedWrites;
+    private readonly runningWrites;
+    private readonly fileSizes;
+    constructor(allowed: readonly ConnectorService[], config?: MergeConnectorConfig, disallowed?: readonly string[], signal?: AbortSignal | undefined, options?: ConnectorFileOptions & {
+        connected?: readonly string[];
+    });
     definitions(): ToolDefinition[];
     validator(name: string): ValidateFunction | undefined;
+    normalizeArguments(name: string, value: unknown): unknown;
+    historyValue(name: string, value: unknown): unknown;
     has(name: string): boolean;
     recognizes(name: string): boolean;
     discover(service: string): Promise<string>;
     private discoveryResult;
     private load;
     call(name: string, args: Record<string, unknown>): Promise<string>;
+    private rememberFileSizes;
     beginTurn(history?: readonly Message[]): Promise<void>;
     close(): Promise<void>;
 }