@neuraltrust/trustgate 0.1.0

package/dist/errors.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Every failure the SDK raises, as a type you can catch.
+ *
+ * The gateway answers a tool call with a JSON-RPC error and the connections
+ * API with `{error, message}`. Both are relayed here as classes rather than
+ * status codes, because the useful question is never "what number came back"
+ * but "is this mine to fix, my user's, or my admin's".
+ */
+export declare class TrustGateError extends Error {
+    readonly status?: number;
+    readonly code?: string;
+    constructor(message: string, options?: {
+        status?: number;
+        code?: string;
+        cause?: unknown;
+    });
+}
+/** The API key is wrong, or it does not belong to this consumer. */
+export declare class AuthenticationError extends TrustGateError {
+}
+/** The request was malformed — a bad end-user id, an unknown provider. */
+export declare class InvalidRequestError extends TrustGateError {
+}
+/**
+ * The consumer's toolkit does not carry every tool the agent declared.
+ *
+ * An admin owns that toolkit, so this is not something the caller can fix in
+ * code: it is raised at startup, by name, so the agent never reaches a user
+ * only to find the tool it was written around is not there.
+ */
+export declare class MissingToolsError extends TrustGateError {
+    readonly missing: string[];
+    readonly available: string[];
+    constructor(missing: string[], available: string[]);
+}
+/**
+ * Servers the application cannot call yet, and who has to fix that.
+ *
+ * Raised at startup only, for the application handle: nobody is present to
+ * follow a connect link once a batch is running, so the run either knows
+ * beforehand or fails halfway through. The remedy is never the caller's — an
+ * account a whole team rides on is an administrator's to connect, and a
+ * per-caller account wants the person this call is for, which is what
+ * `forEndUser` is.
+ */
+export declare class UpstreamNotConnectedError extends TrustGateError {
+    readonly upstreams: BlockedUpstream[];
+    constructor(upstreams: BlockedUpstream[]);
+    /** The server names, for a caller that wants to log or list them. */
+    get servers(): string[];
+}
+/** One server from {@link UpstreamNotConnectedError}. */
+export type BlockedUpstream = {
+    server: string;
+    blocked?: 'administrator' | 'end_user';
+};
+/**
+ * An end user has not connected the account this call needs.
+ *
+ * The link comes with the error because the gateway mints it there: it is the
+ * page to put in front of that user, and it expires.
+ */
+export declare class ConsentRequiredError extends TrustGateError {
+    readonly provider: string;
+    readonly connectUrl: string;
+    readonly cause_: string;
+    constructor(provider: string, connectUrl: string, cause_: string, message?: string);
+}
+/** A policy on the gateway refused the call. Not retryable. */
+export declare class PolicyBlockedError extends TrustGateError {
+}
+/** The tool is not on this consumer's surface — usually because it just left it. */
+export declare class ToolNotFoundError extends TrustGateError {
+    readonly tool: string;
+    constructor(tool: string, message?: string);
+}
+/** The connect-attempt limiter refused this call. */
+export declare class RateLimitedError extends TrustGateError {
+    readonly retryAfterMs?: number | undefined;
+    constructor(message: string, retryAfterMs?: number | undefined);
+}
+/** The gateway could not serve the request and says so. Retryable. */
+export declare class ServiceUnavailableError extends TrustGateError {
+}
+/** The gateway failed on its own account. */
+export declare class TrustGateServerError extends TrustGateError {
+}
+/** The SDK was pointed at a plane this API key does not reach. */
+export declare class PlaneUnavailableError extends TrustGateError {
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;gBAEV,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAM9F;AAED,oEAAoE;AACpE,qBAAa,mBAAoB,SAAQ,cAAc;CAAG;AAE1D,0EAA0E;AAC1E,qBAAa,mBAAoB,SAAQ,cAAc;CAAG;AAE1D;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE;gBAA/C,OAAO,EAAE,MAAM,EAAE,EAAW,SAAS,EAAE,MAAM,EAAE;CAOpE;AAED;;;;;;;;;GASG;AACH,qBAAa,yBAA0B,SAAQ,cAAc;IAChD,QAAQ,CAAC,SAAS,EAAE,eAAe,EAAE;gBAA5B,SAAS,EAAE,eAAe,EAAE;IAIjD,qEAAqE;IACrE,IAAI,OAAO,IAAI,MAAM,EAAE,CAEtB;CACD;AAED,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,eAAe,GAAG,UAAU,CAAA;CACtC,CAAA;AA4CD;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,cAAc;IAEtD,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAFd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,MAAM;CAIjB;AAED,+DAA+D;AAC/D,qBAAa,kBAAmB,SAAQ,cAAc;CAAG;AAEzD,oFAAoF;AACpF,qBAAa,iBAAkB,SAAQ,cAAc;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAGnD;AAED,qDAAqD;AACrD,qBAAa,gBAAiB,SAAQ,cAAc;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;gBAA/C,OAAO,EAAE,MAAM,EAAW,YAAY,CAAC,EAAE,MAAM,YAAA;CAG3D;AAED,sEAAsE;AACtE,qBAAa,uBAAwB,SAAQ,cAAc;CAAG;AAE9D,6CAA6C;AAC7C,qBAAa,oBAAqB,SAAQ,cAAc;CAAG;AAE3D,kEAAkE;AAClE,qBAAa,qBAAsB,SAAQ,cAAc;CAAG"}

package/dist/errors.js

@@ -0,0 +1,144 @@
+/**
+ * Every failure the SDK raises, as a type you can catch.
+ *
+ * The gateway answers a tool call with a JSON-RPC error and the connections
+ * API with `{error, message}`. Both are relayed here as classes rather than
+ * status codes, because the useful question is never "what number came back"
+ * but "is this mine to fix, my user's, or my admin's".
+ */
+export class TrustGateError extends Error {
+    status;
+    code;
+    constructor(message, options = {}) {
+        super(message, { cause: options.cause });
+        this.name = new.target.name;
+        this.status = options.status;
+        this.code = options.code;
+    }
+}
+/** The API key is wrong, or it does not belong to this consumer. */
+export class AuthenticationError extends TrustGateError {
+}
+/** The request was malformed — a bad end-user id, an unknown provider. */
+export class InvalidRequestError extends TrustGateError {
+}
+/**
+ * The consumer's toolkit does not carry every tool the agent declared.
+ *
+ * An admin owns that toolkit, so this is not something the caller can fix in
+ * code: it is raised at startup, by name, so the agent never reaches a user
+ * only to find the tool it was written around is not there.
+ */
+export class MissingToolsError extends TrustGateError {
+    missing;
+    available;
+    constructor(missing, available) {
+        super(`the consumer's toolkit is missing ${missing.map((t) => `"${t}"`).join(', ')}. ` +
+            `It offers: ${available.length ? available.join(', ') : '(nothing)'}. ` +
+            'Ask the admin who owns this application to add them.');
+        this.missing = missing;
+        this.available = available;
+    }
+}
+/**
+ * Servers the application cannot call yet, and who has to fix that.
+ *
+ * Raised at startup only, for the application handle: nobody is present to
+ * follow a connect link once a batch is running, so the run either knows
+ * beforehand or fails halfway through. The remedy is never the caller's — an
+ * account a whole team rides on is an administrator's to connect, and a
+ * per-caller account wants the person this call is for, which is what
+ * `forEndUser` is.
+ */
+export class UpstreamNotConnectedError extends TrustGateError {
+    upstreams;
+    constructor(upstreams) {
+        super(describeBlocked(upstreams));
+        this.upstreams = upstreams;
+    }
+    /** The server names, for a caller that wants to log or list them. */
+    get servers() {
+        return this.upstreams.map((upstream) => upstream.server);
+    }
+}
+/**
+ * Says who fixes each server, with the line of code when it is the caller.
+ *
+ * Read on a terminal at startup, so it is written to be acted on there: the
+ * per-user case is the one a developer hits first, and the fix is one call
+ * they have not seen yet, so the call is in the message.
+ */
+function describeBlocked(upstreams) {
+    const byAdmin = upstreams.filter((upstream) => upstream.blocked === 'administrator');
+    const byUser = upstreams.filter((upstream) => upstream.blocked === 'end_user');
+    const parts = [];
+    if (byUser.length > 0) {
+        parts.push(`${names(byUser)} ${verb(byUser, 'keeps', 'keep')} one account per user, and ` +
+            'connect() runs as the application, which has none there.\n' +
+            '\n' +
+            'Run as the person the work is for:\n' +
+            '\n' +
+            "    const agent = await tg.forEndUser('user_123')\n" +
+            '\n' +
+            `or have an administrator set ${names(byUser)} to a shared account in the ` +
+            "console (Registry, on the server's instance), and connect() works as it is.");
+    }
+    if (byAdmin.length > 0) {
+        parts.push(`${names(byAdmin)} ${verb(byAdmin, 'uses', 'use')} one shared account for every ` +
+            'caller, and nobody has connected it yet. An administrator connects it in the ' +
+            "console: Registry, on the server's instance, Connect.");
+    }
+    return parts.length > 0 ? parts.join('\n\n') : `${names(upstreams)} ${verb(upstreams, 'is', 'are')} not connected.`;
+}
+function names(upstreams) {
+    return upstreams.map((upstream) => `"${upstream.server}"`).join(', ');
+}
+function verb(upstreams, one, many) {
+    return upstreams.length === 1 ? one : many;
+}
+/**
+ * An end user has not connected the account this call needs.
+ *
+ * The link comes with the error because the gateway mints it there: it is the
+ * page to put in front of that user, and it expires.
+ */
+export class ConsentRequiredError extends TrustGateError {
+    provider;
+    connectUrl;
+    cause_;
+    constructor(provider, connectUrl, cause_, message) {
+        super(message ?? `user consent required for ${provider}: open ${connectUrl}`, { code: 'consent_required' });
+        this.provider = provider;
+        this.connectUrl = connectUrl;
+        this.cause_ = cause_;
+    }
+}
+/** A policy on the gateway refused the call. Not retryable. */
+export class PolicyBlockedError extends TrustGateError {
+}
+/** The tool is not on this consumer's surface — usually because it just left it. */
+export class ToolNotFoundError extends TrustGateError {
+    tool;
+    constructor(tool, message) {
+        super(message ?? `the gateway does not serve a tool named "${tool}"`);
+        this.tool = tool;
+    }
+}
+/** The connect-attempt limiter refused this call. */
+export class RateLimitedError extends TrustGateError {
+    retryAfterMs;
+    constructor(message, retryAfterMs) {
+        super(message, { status: 429, code: 'rate_limited' });
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+/** The gateway could not serve the request and says so. Retryable. */
+export class ServiceUnavailableError extends TrustGateError {
+}
+/** The gateway failed on its own account. */
+export class TrustGateServerError extends TrustGateError {
+}
+/** The SDK was pointed at a plane this API key does not reach. */
+export class PlaneUnavailableError extends TrustGateError {
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/formats.d.ts

@@ -0,0 +1,44 @@
+import { ToolFormat, type GatewayTool, type JSONSchema, type ToolCall } from "./types.js";
+export type ConversionWarning = {
+    tool: string;
+    reason: string;
+};
+export type Conversion = {
+    tools: unknown[];
+    warnings: ConversionWarning[];
+    /** The schema each tool had before translation, for the return trip. */
+    originals: Map<string, JSONSchema>;
+};
+export type ToolResult = {
+    call: ToolCall;
+    result: Record<string, unknown>;
+};
+/**
+ * Each provider's function-calling dialect, in one place.
+ *
+ * A format knows three things: how to describe a tool, how to recognise the
+ * model asking for one, and how to hand the answer back. They are grouped per
+ * provider rather than per agent framework on purpose — a framework brings its
+ * own MCP client and never sees any of this.
+ */
+export type FormatAdapter = {
+    convert(tools: GatewayTool[], options: {
+        strict: boolean;
+    }): Conversion;
+    extractCalls(output: unknown): ToolCall[];
+    toOutputs(results: ToolResult[]): unknown[];
+};
+export declare function adapterFor(format: ToolFormat): FormatAdapter;
+/** Undoes whatever the outbound conversion added to the arguments. */
+export declare function restoreArguments(args: Record<string, unknown>, original: JSONSchema | undefined): Record<string, unknown>;
+/**
+ * What the model gets back from a tool.
+ *
+ * A structured result is the one worth giving it, since that is what the tool
+ * promised in its output schema; the text blocks are the fallback, and the
+ * whole result is the last resort. A tool that failed still answers here
+ * rather than throwing: MCP puts tool errors in the result precisely so the
+ * model can read them and correct itself.
+ */
+export declare function resultToText(result: Record<string, unknown>): string;
+//# sourceMappingURL=formats.d.ts.map

package/dist/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../src/formats.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,wEAAwE;IACxE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,UAAU,CAAC;IACxE,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,EAAE,CAAC;IAC1C,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,CAAC;CAC7C,CAAC;AAEF,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAI5D;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,UAAU,GAAG,SAAS,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB;AA2RD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAYpE"}

package/dist/formats.js

@@ -0,0 +1,299 @@
+import { inlineRefs, stripInjectedNulls, toStrict } from "./schema.js";
+import { ToolFormat, } from "./types.js";
+export function adapterFor(format) {
+    const adapter = ADAPTERS[format];
+    if (!adapter)
+        throw new Error(`unknown tool format "${format}"`);
+    return adapter;
+}
+/** Undoes whatever the outbound conversion added to the arguments. */
+export function restoreArguments(args, original) {
+    return stripInjectedNulls(args, original);
+}
+function convertWith(tools, options, shape) {
+    const warnings = [];
+    const originals = new Map();
+    const converted = tools.map((tool) => {
+        originals.set(tool.name, tool.inputSchema);
+        if (!options.strict)
+            return shape(tool, inlineRefs(tool.inputSchema), false);
+        const result = toStrict(tool.inputSchema);
+        if (!result.strict)
+            warnings.push({ tool: tool.name, reason: result.reason ?? "unknown" });
+        return shape(tool, result.schema, result.strict);
+    });
+    return { tools: converted, warnings, originals };
+}
+const openAIResponses = {
+    convert: (tools, options) => convertWith(tools, options, (tool, schema, strict) => ({
+        type: "function",
+        name: tool.name,
+        description: tool.description ?? "",
+        parameters: schema,
+        strict,
+    })),
+    extractCalls(output) {
+        // Accepts the whole response or just its output array, because both are
+        // what people have in hand at the call site.
+        const items = Array.isArray(output)
+            ? output
+            : (output?.output ?? []);
+        return items.flatMap((item) => {
+            const call = item;
+            if (call.type !== "function_call")
+                return [];
+            return [
+                {
+                    id: String(call.call_id ?? call.id ?? ""),
+                    name: String(call.name ?? ""),
+                    arguments: parseArguments(call.arguments),
+                },
+            ];
+        });
+    },
+    toOutputs: (results) => results.map(({ call, result }) => ({
+        type: "function_call_output",
+        call_id: call.id,
+        output: resultToText(result),
+    })),
+};
+const openAIChat = {
+    convert: (tools, options) => convertWith(tools, options, (tool, schema, strict) => ({
+        type: "function",
+        function: {
+            name: tool.name,
+            description: tool.description ?? "",
+            parameters: schema,
+            strict,
+        },
+    })),
+    extractCalls(output) {
+        const calls = Array.isArray(output)
+            ? output
+            : (output
+                ?.choices?.[0]?.message?.tool_calls ?? []);
+        return calls.flatMap((item) => {
+            const call = item;
+            if (!call.function)
+                return [];
+            return [
+                {
+                    id: String(call.id ?? ""),
+                    name: String(call.function.name ?? ""),
+                    arguments: parseArguments(call.function.arguments),
+                },
+            ];
+        });
+    },
+    toOutputs: (results) => results.map(({ call, result }) => ({
+        role: "tool",
+        tool_call_id: call.id,
+        content: resultToText(result),
+    })),
+};
+const anthropicMessages = {
+    convert: (tools, options) => 
+    // Anthropic takes plain JSON Schema, so strict has nothing to add here:
+    // asking for it would close objects for no gain.
+    convertWith(tools, { strict: false }, (tool, schema) => ({
+        name: tool.name,
+        description: tool.description ?? "",
+        input_schema: schema,
+    })),
+    extractCalls(output) {
+        const content = Array.isArray(output)
+            ? output
+            : (output?.content ?? []);
+        return content.flatMap((item) => {
+            const block = item;
+            if (block.type !== "tool_use")
+                return [];
+            return [
+                {
+                    id: String(block.id ?? ""),
+                    name: String(block.name ?? ""),
+                    arguments: block.input ?? {},
+                },
+            ];
+        });
+    },
+    // No results means the model called nothing, and that is what an empty array
+    // says. A message wrapped around no blocks says the opposite — and Anthropic
+    // refuses a user message with no content, so the turn a caller reads as "keep
+    // going" is the one that cannot be sent.
+    toOutputs: (results) => results.length === 0
+        ? []
+        : [
+            {
+                role: "user",
+                content: results.map(({ call, result }) => ({
+                    type: "tool_result",
+                    tool_use_id: call.id,
+                    content: resultToText(result),
+                    ...(result.isError === true ? { is_error: true } : {}),
+                })),
+            },
+        ],
+};
+const gemini = {
+    convert(tools, _options) {
+        const warnings = [];
+        const originals = new Map();
+        const declarations = tools.map((tool) => {
+            originals.set(tool.name, tool.inputSchema);
+            const { schema, dropped } = geminiSchema(inlineRefs(tool.inputSchema));
+            if (dropped.length > 0) {
+                warnings.push({
+                    tool: tool.name,
+                    reason: `dropped keywords Gemini does not accept: ${[...new Set(dropped)].join(", ")}`,
+                });
+            }
+            return {
+                name: tool.name,
+                description: tool.description ?? "",
+                parameters: schema,
+            };
+        });
+        return {
+            tools: [{ functionDeclarations: declarations }],
+            warnings,
+            originals,
+        };
+    },
+    extractCalls(output) {
+        const parts = Array.isArray(output)
+            ? output
+            : (output
+                ?.candidates?.[0]?.content?.parts ?? []);
+        return parts.flatMap((item, index) => {
+            const part = item;
+            if (!part.functionCall)
+                return [];
+            const name = String(part.functionCall.name ?? "");
+            return [
+                {
+                    // Gemini does not give a call an id, so one is made from its
+                    // position — enough to pair a result with its call.
+                    id: `${name}:${index}`,
+                    name,
+                    arguments: part.functionCall.args ?? {},
+                },
+            ];
+        });
+    },
+    // Empty means the model called nothing; see anthropicMessages.
+    toOutputs: (results) => results.length === 0
+        ? []
+        : [
+            {
+                role: "user",
+                parts: results.map(({ call, result }) => ({
+                    functionResponse: {
+                        name: call.name,
+                        response: resultToResponse(result),
+                    },
+                })),
+            },
+        ],
+};
+const ADAPTERS = {
+    [ToolFormat.OpenAIResponses]: openAIResponses,
+    [ToolFormat.OpenAIChat]: openAIChat,
+    [ToolFormat.AnthropicMessages]: anthropicMessages,
+    [ToolFormat.Gemini]: gemini,
+};
+/** Keywords Gemini's function declarations accept; everything else is dropped. */
+const GEMINI_KEYWORDS = new Set([
+    "type",
+    "format",
+    "description",
+    "nullable",
+    "enum",
+    "properties",
+    "required",
+    "items",
+    "anyOf",
+    "minimum",
+    "maximum",
+]);
+function geminiSchema(schema) {
+    const dropped = [];
+    // Inside `properties` the keys are the caller's own property names, not
+    // schema keywords, so they are carried across untouched — filtering them
+    // would delete the arguments rather than the syntax.
+    const walkProperties = (node) => {
+        if (typeof node !== "object" || node === null)
+            return node;
+        const out = {};
+        for (const [name, value] of Object.entries(node)) {
+            out[name] = walk(value);
+        }
+        return out;
+    };
+    const walk = (node) => {
+        if (Array.isArray(node))
+            return node.map(walk);
+        if (typeof node !== "object" || node === null)
+            return node;
+        const out = {};
+        for (const [key, value] of Object.entries(node)) {
+            if (!GEMINI_KEYWORDS.has(key)) {
+                dropped.push(key);
+                continue;
+            }
+            if (key === "properties") {
+                out[key] = walkProperties(value);
+                continue;
+            }
+            out[key] = key === "required" || key === "enum" ? value : walk(value);
+        }
+        return out;
+    };
+    return { schema: walk(schema), dropped };
+}
+function parseArguments(raw) {
+    if (typeof raw === "object" && raw !== null)
+        return raw;
+    if (typeof raw !== "string" || raw.trim() === "")
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        return typeof parsed === "object" && parsed !== null
+            ? parsed
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * What the model gets back from a tool.
+ *
+ * A structured result is the one worth giving it, since that is what the tool
+ * promised in its output schema; the text blocks are the fallback, and the
+ * whole result is the last resort. A tool that failed still answers here
+ * rather than throwing: MCP puts tool errors in the result precisely so the
+ * model can read them and correct itself.
+ */
+export function resultToText(result) {
+    if (result.structuredContent !== undefined)
+        return JSON.stringify(result.structuredContent);
+    const content = result.content;
+    if (Array.isArray(content)) {
+        const text = content
+            .filter((block) => block.type === "text")
+            .map((block) => String(block.text ?? ""))
+            .join("\n");
+        if (text)
+            return text;
+    }
+    return JSON.stringify(result);
+}
+function resultToResponse(result) {
+    if (result.structuredContent !== undefined &&
+        typeof result.structuredContent === "object") {
+        return result.structuredContent;
+    }
+    return { result: resultToText(result) };
+}
+//# sourceMappingURL=formats.js.map

package/dist/formats.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,23 @@
+import { type ResolvedConfig } from './config.js';
+export type ErrorBody = {
+    error?: string;
+    message?: string;
+};
+/**
+ * A JSON request against the gateway's REST surface (the connections API).
+ *
+ * The gateway answers `{error, message}` on failure; this turns each `error`
+ * code into the type that says whose problem it is. `expect` names statuses
+ * the caller handles itself — the actor probe uses it to read a 409 as an
+ * answer rather than a failure.
+ */
+export declare function requestJSON<T>(config: ResolvedConfig, method: string, path: string, options?: {
+    body?: unknown;
+    headers?: Record<string, string>;
+    expect?: number[];
+    signal?: AbortSignal;
+}): Promise<{
+    status: number;
+    body: T;
+}>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAUjE,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5D;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAClC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACzG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CA8BtC"}