@vibesdotdev/mcp 0.0.0-stage → 1.0.0-rc.0

package/dist/adapters/zod-mcp.d.ts

@@ -0,0 +1,139 @@
+import * as z from 'zod/v4';
+import { flattenDiscriminatedUnionToObject as flattenDiscriminatedUnionToObjectFromTools, flattenRootUnion as flattenRootUnionFromTools, getDiscriminator as getDiscriminatorFromTools, getDiscriminatorOptions as getDiscriminatorOptionsFromTools, isDiscriminatedUnion as isDiscriminatedUnionFromTools, isPlainUnion as isPlainUnionFromTools } from '@vibesdotdev/tools/schemas/discriminated-union-wire';
+export type JsonSchema = JsonSchemaObject;
+export type SchemaWrapType = 'none' | 'object' | 'array' | 'primitive';
+export interface ZodToMcpOptions {
+    name?: string;
+    compact?: boolean;
+    addAliasHints?: boolean;
+    removeSchemaField?: boolean;
+}
+export interface SchemaConversionResult {
+    schema: JsonSchema;
+    wrapType: SchemaWrapType;
+}
+export interface ActionMeta {
+    tier: 'core' | 'extended';
+    trigger?: string;
+}
+export type ActionMetaMap = Record<string, ActionMeta>;
+export interface OverrideContext {
+    toolId: string;
+    actionId?: string;
+}
+export interface McpToolDefinition {
+    name: string;
+    description?: string;
+    inputSchema: JsonSchema;
+}
+export interface CreateMcpToolConfig {
+    name: string;
+    description?: string;
+    schema: z.ZodTypeAny;
+}
+export interface McpDescriptionSource {
+    id?: string;
+    name?: string;
+    description?: string;
+    mcpDescription?: string;
+}
+export declare const isPlainUnion: typeof isPlainUnionFromTools;
+/**
+ * The object form of a JSON Schema node: schema keywords mapped to the nodes
+ * they constrain. Kept distinct from the wire-record {@link JsonSchema} so the
+ * walkers below read typed children instead of unparsed record values.
+ */
+export type JsonSchemaObject = {
+    [key: string]: JsonSchemaNode;
+};
+/**
+ * One node of a JSON Schema document: a schema object, an array of nodes
+ * (tuple items, union branches, enum entries), or a JSON scalar. Converters
+ * (zod `toJSONSchema`, the SDK's `toJsonSchemaCompat`) emit nothing else.
+ */
+export type JsonSchemaNode = JsonSchemaObject | readonly JsonSchemaNode[] | string | number | boolean | null;
+/**
+ * Every cyclic anchor advertised by this schema, as `path -> …` descriptions.
+ * Empty for an acyclic schema. Shared by tests and `validateMcpSchema`.
+ */
+export declare function findJsonSchemaRefCycles<T>(schema: T): string[];
+/**
+ * Walk a JSON Schema tree and (a) strip `pattern` where `format` carries the
+ * same information, (b) dedupe structurally identical anyOf/oneOf branches,
+ * collapsing all-identical unions into their single member, (c) bound
+ * recursive `$ref`s so the advertised schema is acyclic — model APIs reject
+ * recursive schemas wholesale (`400 Recursive JSON schemas are not currently
+ * supported`, observed on the `agent` tool's `JsonValueSchema` metadata), so one
+ * recursive field in one tool can take down every session that loads the
+ * catalog. Pure transformation; no Zod runtime dependency. Server-side input
+ * validation never uses this projection — it parses the registered Zod object.
+ */
+export declare function tightenJsonSchema(node: JsonSchemaNode): JsonSchemaNode;
+export declare function zodToMcpSchema(schema: z.ZodTypeAny, options?: ZodToMcpOptions): SchemaConversionResult;
+/**
+ * Wrap a transport's `send` so any outgoing tools/list response (or
+ * tools/listChanged update) has its tool schemas tightened before
+ * serialization. The MCP SDK does its own Zod→JSON Schema conversion
+ * inside its tools/list handler (via `toJsonSchemaCompat`), so the
+ * `tightenJsonSchema` step in `zodToMcpSchema` is bypassed for those
+ * responses. Wrapping the transport is the lowest-friction interception
+ * point that doesn't require monkey-patching the SDK's private state.
+ */
+export declare function wrapTransportWithSchemaTightening<TArgs extends unknown[]>(transport: {
+    send: (...args: TArgs) => Promise<void> | void;
+}, options?: {
+    /**
+     * Drop `outputSchema` from the `tools/list` projection entirely.
+     *
+     * **Does NOT weaken result validation.** The SDK validates against the
+     * REGISTERED Zod object — `validateToolOutput` reads `tool.outputSchema`,
+     * a different read from the wire projection that builds
+     * `toolDefinition.outputSchema`. Two independent paths over one registered
+     * object, so removing the wire copy here keeps the guarantee and drops the
+     * bytes. Measured on the real `cursor` wire 2026-07-25: 72,084 B / 35.2%
+     * of a 204,965 B catalog, carried by 57 of 75 tools — enough on its own to
+     * put that client back under WIRE_CATALOG_BUDGET_BYTES.
+     *
+     * What the client gives up, from the SDK source (`client/index.js:486-560`)
+     * rather than assumption: a client that receives `outputSchema` caches a
+     * per-tool validator, throws when a result carries no `structuredContent`,
+     * and validates that content. Without it, it does neither — so this trades
+     * DEFENSE IN DEPTH, not correctness, since server-side `validateToolOutput`
+     * still enforces the same contract against the registered object.
+     *
+     * Off unless a preset asks: the SDK answer covers official `callTool`, and
+     * a bespoke client may still read the field for typing or rendering.
+     */
+    omitOutputSchema?: boolean;
+}): void;
+/**
+ * Structural sanity check for an outgoing MCP `inputSchema`.
+ *
+ * It USED to require `type` unconditionally, which is a false positive on every
+ * root-union tool we ship. Verified 2026-07-25: `awareness` — the heaviest tool on
+ * the wire — has a root `oneOf` and no `type`, so this reported
+ * "Schema missing 'type'" for a schema that is valid and serving correctly today.
+ * A validator that flags correct schemas is worse than none: the first person to
+ * wire it up would have chased a phantom.
+ *
+ * Nothing on the serve path calls this yet (it is public API from
+ * `@vibesdotdev/mcp`, its one home). Left exported and
+ * correct rather than deleted — constitution §NO DELETE WITHOUT CONSUMER PROOF, and
+ * a correct unused check can be wired later; an incorrect one cannot.
+ */
+export declare function validateMcpSchema(schema: JsonSchemaNode): string[];
+export declare function validateMcpDescription(description: string): string[];
+export declare function generateMcpDescription(description: string): string;
+export declare function resolveMcpDescription(source: McpDescriptionSource): string;
+export declare const flattenRootUnion: typeof flattenRootUnionFromTools;
+export declare const isDiscriminatedUnion: typeof isDiscriminatedUnionFromTools;
+export declare const getDiscriminator: typeof getDiscriminatorFromTools;
+export declare const getDiscriminatorOptions: typeof getDiscriminatorOptionsFromTools;
+export declare function wrapDiscriminatedUnion(schema: z.ZodTypeAny, defaultAction: string | undefined, toolId: string): z.ZodTypeAny;
+/**
+ * Flatten a z.discriminatedUnion into a z.object that the MCP SDK can handle.
+ * Implementation lives in @vibesdotdev/tools (shared with invoke validation).
+ */
+export declare const flattenDiscriminatedUnionToObject: typeof flattenDiscriminatedUnionToObjectFromTools;
+export declare function createMcpTool(config: CreateMcpToolConfig): McpToolDefinition;
+//# sourceMappingURL=zod-mcp.d.ts.map

package/dist/adapters/zod-mcp.d.ts.map

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