mandala-computer-mcp 0.3.0 → 0.5.0

package/dist/tools/artifacts.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+import { artifactContent, artifactMetadata, artifactOptions } from '../artifacts.js';
+import { refused, said } from '../format.js';
+import * as P from '../paths.js';
+import { PRESENTATION_DEFAULT, PRESENTATION_MAX, requireValue, retainedCall, scopeId, } from '../results.js';
+import { captureAnnotations, computerSchema, deleteAnnotations, readAnnotations, } from './results.js';
+const identity = {
+    computer_id: computerSchema,
+    artifact_id: z
+        .string()
+        .length(36)
+        .regex(/^art_[a-f0-9]{32}$/),
+};
+export const registerArtifacts = (server, session) => {
+    server.registerTool('publish_artifact', {
+        title: 'Publish a nominated immutable file version',
+        description: 'Explicitly capture a caller-nominated absolute Linux, Windows drive or UNC file path with expected_size and lowercase expected_sha256 already supplied. One guest file read, no preflight stat/list/hash/exec. Optional execution_id is verified caller-selected association, not proof of authorship. Default 8 MiB/max 64 MiB capture cap; default 86400s/max 604800s retention. New version per call; a lost response leaves publication unconfirmed.',
+        inputSchema: {
+            computer_id: computerSchema,
+            path: z.string().min(1),
+            expected_size: z
+                .number()
+                .int()
+                .min(0)
+                .max(64 * 1024 * 1024),
+            expected_sha256: z
+                .string()
+                .length(64)
+                .regex(/^[a-f0-9]{64}$/),
+            execution_id: z
+                .string()
+                .length(37)
+                .regex(/^exec_[a-f0-9]{32}$/)
+                .optional(),
+            max_bytes: z
+                .number()
+                .int()
+                .min(1)
+                .max(64 * 1024 * 1024)
+                .optional(),
+            retention_seconds: z.number().int().min(1).max(604800).optional(),
+        },
+        annotations: captureAnnotations,
+    }, ({ computer_id, ...args }, extra) => retainedCall(extra.signal, true, async (signal) => {
+        const id = session.resolve(computer_id);
+        requireValue(scopeId(id));
+        const body = artifactOptions(Object.fromEntries(Object.entries(args).filter(([, v]) => v !== undefined)));
+        const data = await session.api
+            .with(signal)
+            .boundedJson('POST', P.artifacts(id), 4096, 201, { body });
+        return said('Immutable nominated file version; association records caller selection.', artifactMetadata(data, id, undefined, body));
+    }));
+    server.registerTool('get_artifact', {
+        title: 'Read immutable artifact metadata',
+        description: 'Passive finite metadata for one retained artifact. No guest file or execution lookup, resume, capture or fallback.',
+        inputSchema: identity,
+        annotations: readAnnotations,
+    }, ({ computer_id, artifact_id }, extra) => retainedCall(extra.signal, false, async (signal) => {
+        const id = session.resolve(computer_id);
+        requireValue(scopeId(id));
+        return said('Immutable artifact metadata.', artifactMetadata(await session.api
+            .with(signal)
+            .boundedJson('GET', P.artifact(id, artifact_id), 4096, 200), id, artifact_id));
+    }));
+    server.registerTool('read_artifact', {
+        title: 'Read a complete verified small artifact',
+        description: 'Read metadata, then only if the complete artifact fits max_bytes (default 4096/max 16384), read the whole immutable object and verify size/SHA-256. Over cap returns metadata only, with zero content GETs. One 90s operation budget; no Range, prefix, assembly, file destination, guest fallback or image/HTML rendering. Lossless UTF-8/BOM or exact base64.',
+        inputSchema: {
+            ...identity,
+            max_bytes: z.number().int().min(1).max(PRESENTATION_MAX).default(PRESENTATION_DEFAULT),
+        },
+        annotations: readAnnotations,
+    }, ({ computer_id, artifact_id, max_bytes }, extra) => retainedCall(extra.signal, false, async (signal) => {
+        const id = session.resolve(computer_id);
+        requireValue(scopeId(id));
+        const api = session.api.with(signal);
+        const metadata = artifactMetadata(await api.boundedJson('GET', P.artifact(id, artifact_id), 4096, 200), id, artifact_id);
+        if (metadata.size > max_bytes)
+            return refused('Artifact exceeds the complete-content presentation cap. No content was downloaded or hash verified; use an SDK whole download with an adequate cap.', metadata);
+        if (signal.aborted)
+            throw signal.reason;
+        const response = await api.boundedBytes('GET', P.artifactDownload(id, artifact_id), metadata.size, 200);
+        return said('Complete retained artifact verified against its immutable size and SHA-256.', artifactContent(response, metadata));
+    }));
+    server.registerTool('delete_artifact', {
+        title: 'Delete an immutable artifact version',
+        description: 'Delete exactly this retained artifact, without metadata preflight or guest file deletion. Same deletion effect on repeat; repeated 404 remains unavailable. No retry.',
+        inputSchema: identity,
+        annotations: deleteAnnotations,
+    }, ({ computer_id, artifact_id }, extra) => retainedCall(extra.signal, true, async (signal) => {
+        const id = session.resolve(computer_id);
+        requireValue(scopeId(id));
+        await session.api.with(signal).boundedBytes('DELETE', P.artifact(id, artifact_id), 0, 204);
+        return said('Retained artifact deleted.', { artifact_id, deleted: true });
+    }));
+};
+//# sourceMappingURL=artifacts.js.map

package/dist/tools/artifacts.js.map

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

package/dist/tools/chat.d.ts

@@ -0,0 +1,6 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { Registrar } from './types.js';
+/** Do not let a provider echo session secrets into output, even in a known text field. */
+export declare function safeResult(result: CallToolResult, modelKey: string): CallToolResult;
+export declare const registerChat: Registrar;
+//# sourceMappingURL=chat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/tools/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AASzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAkH5C,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAenF;AAED,eAAO,MAAM,YAAY,EAAE,SAiF1B,CAAC"}

package/dist/tools/chat.js

@@ -0,0 +1,192 @@
+import { z } from 'zod';
+import { MODEL_KEY_HEADER } from '../api.js';
+import { APIError, platformSaid } from '../errors.js';
+import { apiErrorMessage, errorMetadata, failed, refused, said } from '../format.js';
+import * as P from '../paths.js';
+import { heartbeat } from '../poll.js';
+import { count, label } from './directory.js';
+import { computerSchema } from './results.js';
+const content = z.union([
+    z.string(),
+    z.array(z.object({ type: z.literal('text'), text: z.string() }).strict()),
+]);
+const message = z.object({ role: z.enum(['system', 'user', 'assistant']), content }).strict();
+const usage = z.object({ prompt_tokens: count, completion_tokens: count, total_tokens: count });
+const choice = z.object({
+    index: count,
+    message: z.object({ role: z.literal('assistant'), content: z.string() }),
+    finish_reason: label,
+});
+const agent = z.object({ computer_id: label, steps: count, stop: label });
+const completion = z.object({
+    id: label,
+    object: z.literal('chat.completion'),
+    created: count,
+    model: label,
+    choices: z.array(choice).length(1),
+    usage,
+    agent,
+});
+const isRecord = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
+/** Retain valid fields even when other terminal metadata is missing or malformed. */
+function partial(value) {
+    if (!isRecord(value))
+        return {};
+    const result = {};
+    for (const [key, schema] of Object.entries(completion.shape)) {
+        const parsed = schema.safeParse(value[key]);
+        if (parsed.success)
+            result[key] = parsed.data;
+    }
+    for (const [name, schema] of Object.entries({ agent, usage })) {
+        const source = value[name];
+        if (!isRecord(source))
+            continue;
+        const fields = {};
+        for (const [key, field] of Object.entries(schema.shape)) {
+            const parsed = field.safeParse(source[key]);
+            if (parsed.success)
+                fields[key] = parsed.data;
+        }
+        if (Object.keys(fields).length)
+            result[name] = fields;
+    }
+    // A valid assistant answer is still useful when finish_reason is absent.
+    if (Array.isArray(value.choices)) {
+        result.choices = value.choices
+            .slice(0, 8)
+            .filter(isRecord)
+            .map((item) => {
+            const fields = {};
+            for (const [key, schema] of Object.entries(choice.shape)) {
+                const parsed = schema.safeParse(item[key]);
+                if (parsed.success)
+                    fields[key] = parsed.data;
+            }
+            return fields;
+        });
+    }
+    return result;
+}
+const steps = z.array(z.object({
+    n: count,
+    tool: z.string().optional(),
+    action: z.string().optional(),
+    detail: z.string().optional(),
+    error: z.string().optional(),
+}));
+const failedAgent = z.object({
+    computer_id: label,
+    usage: z.object({
+        input_tokens: count,
+        output_tokens: count,
+        cache_read_tokens: count,
+        cache_write_tokens: count,
+    }),
+    steps,
+});
+function chatFailure(error) {
+    if (!(error instanceof APIError))
+        return failed(error);
+    const nested = isRecord(error.body) && isRecord(error.body.error) ? error.body.error : undefined;
+    const source = nested ?? (isRecord(error.body) ? error.body : {});
+    const projected = {};
+    for (const [key, schema] of Object.entries({ usage, steps })) {
+        const parsed = schema.safeParse(source[key]);
+        if (parsed.success)
+            projected[key] = parsed.data;
+    }
+    projected.reason = error.reason;
+    const native = failedAgent.safeParse(nested?.agent);
+    const boundedNative = native.success && JSON.stringify(native.data).length <= 4000;
+    const incompleteNative = nested?.agent !== undefined && !boundedNative;
+    const detail = isRecord(error.body)
+        ? (platformSaid(error.body) ?? 'Chat request failed without a usable error message')
+        : apiErrorMessage(error);
+    const result = failed(new APIError(detail, error.status, { ...projected, error: detail }, error.retryAfterMs, error), nested === undefined);
+    const diagnostics = errorMetadata(error);
+    result.content.push(...said(`${incompleteNative ? 'Native agent failure metadata was malformed or oversized and omitted. ' : ''}${diagnostics.omitted ? 'Oversized diagnostic metadata was omitted. ' : ''}Chat refusal metadata; recorded work may already be billed. Inspect what took effect before another run.`, {
+        ...diagnostics.fields,
+        ...(boundedNative ? { agent: native.data } : {}),
+        ...(incompleteNative ? { incomplete: true } : {}),
+    }).content);
+    return result;
+}
+/** Do not let a provider echo session secrets into output, even in a known text field. */
+export function safeResult(result, modelKey) {
+    return {
+        ...result,
+        content: result.content.map((item) => item.type === 'text'
+            ? {
+                ...item,
+                text: item.text
+                    .split(modelKey)
+                    .join('[redacted]')
+                    .replace(/\b(?:com_|sk-)[A-Za-z0-9_-]+/g, '[redacted]'),
+            }
+            : item),
+    };
+}
+export const registerChat = (server, session) => {
+    if (!session.modelKey)
+        return;
+    const modelKey = session.modelKey;
+    server.registerTool('run_agent_chat', {
+        title: 'Drive the computer with BYOK textual chat',
+        description: "Run the same Anthropic computer agent using OpenAI-shaped textual messages and JSON-only results (stream:false). The last user message is the task; system messages provide standing instructions. Previous user/assistant conversation is not replayed. This is BYOK computer control, not hosted inference or a chat UI. The computer must already be running. Bills the caller's Anthropic key. A supplied model must be an Anthropic model name. Progress counts waiting heartbeats, not completed actions. For long runs the client needs progressToken plus resetTimeoutOnProgress; otherwise choose a smaller max_steps, which is not a time or spend cap. Never automatically replay a failed run.",
+        inputSchema: {
+            computer_id: computerSchema,
+            messages: z
+                .array(message)
+                .min(1)
+                .refine((messages) => {
+                const last = messages.filter((m) => m.role === 'user').at(-1);
+                return (last !== undefined &&
+                    (typeof last.content === 'string'
+                        ? last.content
+                        : last.content.map((p) => p.text).join('')).trim().length > 0);
+            }, 'The last user message must contain text.'),
+            model: z
+                .string()
+                .refine((v) => v.trim().length > 0, 'model must not be blank')
+                .optional(),
+            max_steps: z.number().int().min(1).max(100).default(20),
+        },
+        annotations: { openWorldHint: true },
+    }, async ({ computer_id, messages, model, max_steps }, extra) => {
+        let beat;
+        try {
+            const id = session.resolve(computer_id);
+            extra.signal.throwIfAborted();
+            const body = P.chatBody({ computer_id: id, messages, model, max_steps });
+            beat = heartbeat(extra, server.server);
+            await beat('Waiting for the chat agent result; progress counts heartbeats, not completed actions.');
+            const value = await session.api.json('POST', P.CHAT_COMPLETIONS, {
+                body,
+                headers: { [MODEL_KEY_HEADER]: modelKey },
+                signal: extra.signal,
+            });
+            extra.signal.throwIfAborted();
+            const parsed = completion.safeParse(value);
+            if (!parsed.success)
+                return safeResult(refused('Malformed or missing chat terminal metadata; task completion is unconfirmed. Valid partial result:', partial(value)), modelKey);
+            const data = parsed.data;
+            const finished = data.agent.stop === 'end_turn' &&
+                data.choices[0].finish_reason === 'stop' &&
+                data.choices[0].index === 0 &&
+                data.agent.computer_id === id &&
+                data.agent.steps <= max_steps &&
+                data.usage.total_tokens === data.usage.prompt_tokens + data.usage.completion_tokens;
+            return safeResult(finished
+                ? said('The chat agent finished.', data)
+                : refused('The chat agent did not establish successful task completion. Inspect stop, finish reason and partial work before deciding what remains; do not replay automatically.', data), modelKey);
+        }
+        catch (error) {
+            return safeResult(chatFailure(error), modelKey);
+        }
+        finally {
+            await beat?.stop();
+        }
+    });
+};
+//# sourceMappingURL=chat.js.map

package/dist/tools/chat.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"computers.d.ts","sourceRoot":"","sources":["../../src/tools/computers.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAiQ5C,eAAO,MAAM,iBAAiB,EAAE,SAo2C/B,CAAC"}
+{"version":3,"file":"computers.d.ts","sourceRoot":"","sources":["../../src/tools/computers.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAiS5C,eAAO,MAAM,iBAAiB,EAAE,SAq4C/B,CAAC"}