@tday-com/mcp 0.0.0-stage → 0.2.0

package/dist/server.d.ts

@@ -0,0 +1 @@
+export declare function runServer(): Promise<void>;

package/dist/server.js

@@ -0,0 +1,37 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig } from "./config.js";
+import { listedTools, formatToolResultText, responseFormatFromArgs, toStructuredContent, } from "./tools.js";
+export async function runServer() {
+    const config = await loadConfig();
+    const server = new McpServer({ name: "tday-mcp-server", version: "0.0.1" });
+    const registerTool = server.registerTool.bind(server);
+    for (const tool of await listedTools(config)) {
+        registerTool(tool.name, {
+            title: tool.title,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+            outputSchema: tool.outputSchema,
+            annotations: {
+                readOnlyHint: tool.annotations.readOnlyHint,
+                destructiveHint: tool.annotations.destructiveHint,
+                idempotentHint: tool.annotations.idempotentHint,
+                openWorldHint: tool.annotations.openWorldHint,
+            },
+        }, async (args) => {
+            const rawArgs = args ?? {};
+            const result = await tool.handler(rawArgs, config);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatToolResultText(tool.name, result, responseFormatFromArgs(rawArgs)),
+                    },
+                ],
+                structuredContent: toStructuredContent(result),
+            };
+        });
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}

package/dist/tool-schemas.d.ts

@@ -0,0 +1,460 @@
+import { z } from "zod";
+import type { TdayConfig } from "./config.js";
+export type ResponseFormat = "json" | "markdown";
+export type ToolAnnotations = {
+    title?: string;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+};
+export interface Tool {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.AnyZodObject;
+    outputSchema: z.AnyZodObject;
+    annotations: ToolAnnotations;
+    handler: (args: Record<string, unknown>, config: TdayConfig) => Promise<unknown>;
+}
+export declare const SAFE_ID: RegExp;
+export declare const safeIdSchema: z.ZodString;
+export declare function argsObject<T extends z.ZodRawShape>(shape: T): z.ZodObject<T & {
+    response_format: z.ZodDefault<z.ZodEnum<["json", "markdown"]>>;
+}, "strict", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<T & {
+    response_format: z.ZodDefault<z.ZodEnum<["json", "markdown"]>>;
+}>, any> extends infer T_1 ? { [k in keyof T_1]: T_1[k]; } : never, z.baseObjectInputType<T & {
+    response_format: z.ZodDefault<z.ZodEnum<["json", "markdown"]>>;
+}> extends infer T_2 ? { [k_1 in keyof T_2]: T_2[k_1]; } : never>;
+export declare const emptyArgsSchema: z.ZodObject<{
+    response_format: z.ZodDefault<z.ZodEnum<["json", "markdown"]>>;
+}, "strict", z.ZodTypeAny, {
+    response_format: "json" | "markdown";
+}, {
+    response_format?: "json" | "markdown" | undefined;
+}>;
+export declare const listArgsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+} & {
+    response_format: z.ZodDefault<z.ZodEnum<["json", "markdown"]>>;
+}, "strict", z.ZodTypeAny, {
+    response_format: "json" | "markdown";
+    limit: number;
+    offset: number;
+}, {
+    response_format?: "json" | "markdown" | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export declare function safePath(template: string, params: Record<string, unknown>): string;
+export declare function stripPresentationArgs(args: Record<string, unknown>): Record<string, unknown>;
+export declare function responseFormatFromArgs(args: Record<string, unknown>): ResponseFormat;
+export declare const outputSchemas: {
+    whoami: z.ZodObject<{
+        account: z.ZodOptional<z.ZodUnknown>;
+        staffExempt: z.ZodOptional<z.ZodBoolean>;
+        organizations: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        defaultOrganizationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        features: z.ZodOptional<z.ZodUnknown>;
+        links: z.ZodOptional<z.ZodUnknown>;
+        notes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        account: z.ZodOptional<z.ZodUnknown>;
+        staffExempt: z.ZodOptional<z.ZodBoolean>;
+        organizations: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        defaultOrganizationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        features: z.ZodOptional<z.ZodUnknown>;
+        links: z.ZodOptional<z.ZodUnknown>;
+        notes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        account: z.ZodOptional<z.ZodUnknown>;
+        staffExempt: z.ZodOptional<z.ZodBoolean>;
+        organizations: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        defaultOrganizationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        features: z.ZodOptional<z.ZodUnknown>;
+        links: z.ZodOptional<z.ZodUnknown>;
+        notes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">>;
+    creditPrices: z.ZodObject<{
+        priceVersion: z.ZodOptional<z.ZodNumber>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        launchVideos: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        launchVideoRevisions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        monthlyCredits: z.ZodOptional<z.ZodUnknown>;
+        notes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        priceVersion: z.ZodOptional<z.ZodNumber>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        launchVideos: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        launchVideoRevisions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        monthlyCredits: z.ZodOptional<z.ZodUnknown>;
+        notes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        priceVersion: z.ZodOptional<z.ZodNumber>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        launchVideos: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        launchVideoRevisions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        monthlyCredits: z.ZodOptional<z.ZodUnknown>;
+        notes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">>;
+    usage: z.ZodObject<{
+        organization: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        balance: z.ZodOptional<z.ZodUnknown>;
+        usage: z.ZodOptional<z.ZodUnknown>;
+        links: z.ZodOptional<z.ZodUnknown>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        organization: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        balance: z.ZodOptional<z.ZodUnknown>;
+        usage: z.ZodOptional<z.ZodUnknown>;
+        links: z.ZodOptional<z.ZodUnknown>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        organization: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        balance: z.ZodOptional<z.ZodUnknown>;
+        usage: z.ZodOptional<z.ZodUnknown>;
+        links: z.ZodOptional<z.ZodUnknown>;
+    }, z.ZodTypeAny, "passthrough">>;
+    listBrands: z.ZodObject<{
+        brands: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        pagination: z.ZodOptional<z.ZodObject<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        brands: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        pagination: z.ZodOptional<z.ZodObject<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        brands: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        pagination: z.ZodOptional<z.ZodObject<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough">>;
+    getBrand: z.ZodObject<{
+        brand: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        role: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        brand: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        role: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        brand: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        role: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+    listDesigns: z.ZodObject<{
+        designs: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        archivedCount: z.ZodOptional<z.ZodNumber>;
+        pagination: z.ZodOptional<z.ZodObject<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        designs: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        archivedCount: z.ZodOptional<z.ZodNumber>;
+        pagination: z.ZodOptional<z.ZodObject<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        designs: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        archivedCount: z.ZodOptional<z.ZodNumber>;
+        pagination: z.ZodOptional<z.ZodObject<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            total_count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            count: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            has_more: z.ZodOptional<z.ZodBoolean>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            nextOffset: z.ZodOptional<z.ZodNumber>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough">>;
+    getDesign: z.ZodObject<{
+        design: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        design: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        design: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.ZodTypeAny, "passthrough">>;
+    createBrand: z.ZodObject<{
+        brand: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        reviewStatus: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        brand: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        reviewStatus: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        brand: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        reviewStatus: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+    generate: z.ZodObject<{
+        designId: z.ZodString;
+        generationId: z.ZodString;
+        status: z.ZodString;
+        editorUrl: z.ZodString;
+        statusUrl: z.ZodString;
+        format: z.ZodOptional<z.ZodString>;
+        formatNote: z.ZodOptional<z.ZodString>;
+        credits: z.ZodOptional<z.ZodUnknown>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        designId: z.ZodString;
+        generationId: z.ZodString;
+        status: z.ZodString;
+        editorUrl: z.ZodString;
+        statusUrl: z.ZodString;
+        format: z.ZodOptional<z.ZodString>;
+        formatNote: z.ZodOptional<z.ZodString>;
+        credits: z.ZodOptional<z.ZodUnknown>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        designId: z.ZodString;
+        generationId: z.ZodString;
+        status: z.ZodString;
+        editorUrl: z.ZodString;
+        statusUrl: z.ZodString;
+        format: z.ZodOptional<z.ZodString>;
+        formatNote: z.ZodOptional<z.ZodString>;
+        credits: z.ZodOptional<z.ZodUnknown>;
+    }, z.ZodTypeAny, "passthrough">>;
+    poll: z.ZodObject<{
+        designId: z.ZodString;
+        generationId: z.ZodString;
+        status: z.ZodString;
+        editorUrl: z.ZodString;
+        imageUrl: z.ZodOptional<z.ZodString>;
+        completedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        platformBadge: z.ZodOptional<z.ZodBoolean>;
+        badgeNote: z.ZodOptional<z.ZodString>;
+        failureMessage: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        designId: z.ZodString;
+        generationId: z.ZodString;
+        status: z.ZodString;
+        editorUrl: z.ZodString;
+        imageUrl: z.ZodOptional<z.ZodString>;
+        completedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        platformBadge: z.ZodOptional<z.ZodBoolean>;
+        badgeNote: z.ZodOptional<z.ZodString>;
+        failureMessage: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        designId: z.ZodString;
+        generationId: z.ZodString;
+        status: z.ZodString;
+        editorUrl: z.ZodString;
+        imageUrl: z.ZodOptional<z.ZodString>;
+        completedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        platformBadge: z.ZodOptional<z.ZodBoolean>;
+        badgeNote: z.ZodOptional<z.ZodString>;
+        failureMessage: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+    download: z.ZodObject<{
+        saved: z.ZodBoolean;
+        path: z.ZodString;
+        size: z.ZodNumber;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        saved: z.ZodBoolean;
+        path: z.ZodString;
+        size: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        saved: z.ZodBoolean;
+        path: z.ZodString;
+        size: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">>;
+    searchKnowledgeEntries: z.ZodObject<{
+        entries: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        count: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        entries: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        count: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        entries: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        count: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>;
+    createKnowledgeEntry: z.ZodObject<{
+        slug: z.ZodString;
+        created: z.ZodBoolean;
+        node: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        slug: z.ZodString;
+        created: z.ZodBoolean;
+        node: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        slug: z.ZodString;
+        created: z.ZodBoolean;
+        node: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>;
+};
+export declare const readOnly: {
+    readOnlyHint: boolean;
+    destructiveHint: boolean;
+    idempotentHint: boolean;
+    openWorldHint: boolean;
+};
+export declare const writeRemote: {
+    readOnlyHint: boolean;
+    destructiveHint: boolean;
+    idempotentHint: boolean;
+    openWorldHint: boolean;
+};
+export declare const writeLocal: {
+    readOnlyHint: boolean;
+    destructiveHint: boolean;
+    idempotentHint: boolean;
+    openWorldHint: boolean;
+};

package/dist/tool-schemas.js

@@ -0,0 +1,189 @@
+import { z } from "zod";
+export const SAFE_ID = /^[a-zA-Z0-9_-]+$/;
+const responseFormatSchema = z
+    .enum(["json", "markdown"])
+    .default("json")
+    .describe("Text response format. Defaults to json for backward compatibility; structuredContent is always returned when the MCP client supports it.");
+export const safeIdSchema = z
+    .string()
+    .trim()
+    .min(1)
+    .regex(SAFE_ID, "must contain only letters, numbers, underscores, and hyphens");
+export function argsObject(shape) {
+    return z
+        .object({
+        ...shape,
+        response_format: responseFormatSchema,
+    })
+        .strict();
+}
+export const emptyArgsSchema = argsObject({});
+export const listArgsSchema = argsObject({
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe("Maximum items to return. Defaults to 50."),
+    offset: z
+        .number()
+        .int()
+        .min(0)
+        .default(0)
+        .describe("Number of items to skip for pagination. Defaults to 0."),
+});
+export function safePath(template, params) {
+    return template.replace(/:(\w+)/g, (_, key) => {
+        const val = String(params[key] ?? "");
+        if (!SAFE_ID.test(val)) {
+            throw new Error(`Invalid ${key}: must contain only letters, numbers, underscores, and hyphens (got "${val}")`);
+        }
+        return encodeURIComponent(val);
+    });
+}
+export function stripPresentationArgs(args) {
+    const { response_format: _responseFormat, ...rest } = args;
+    return rest;
+}
+export function responseFormatFromArgs(args) {
+    return args.response_format === "markdown" ? "markdown" : "json";
+}
+const anyRecord = z.record(z.unknown());
+const paginationSchema = z
+    .object({
+    total_count: z.number().optional(),
+    total: z.number().optional(),
+    count: z.number(),
+    offset: z.number(),
+    limit: z.number(),
+    has_more: z.boolean().optional(),
+    hasMore: z.boolean().optional(),
+    next_offset: z.number().optional(),
+    nextOffset: z.number().optional(),
+})
+    .passthrough();
+export const outputSchemas = {
+    whoami: z
+        .object({
+        account: z.unknown().optional(),
+        staffExempt: z.boolean().optional(),
+        organizations: z.array(anyRecord).optional(),
+        defaultOrganizationId: z.string().nullable().optional(),
+        features: z.unknown().optional(),
+        links: z.unknown().optional(),
+        notes: z.array(z.string()).optional(),
+    })
+        .passthrough(),
+    creditPrices: z
+        .object({
+        priceVersion: z.number().optional(),
+        actions: z.array(anyRecord).optional(),
+        launchVideos: z.array(anyRecord).optional(),
+        launchVideoRevisions: z.array(anyRecord).optional(),
+        monthlyCredits: z.unknown().optional(),
+        notes: z.array(z.string()).optional(),
+    })
+        .passthrough(),
+    usage: z
+        .object({
+        organization: anyRecord.optional(),
+        balance: z.unknown().optional(),
+        usage: z.unknown().optional(),
+        links: z.unknown().optional(),
+    })
+        .passthrough(),
+    listBrands: z
+        .object({
+        brands: z.array(anyRecord),
+        pagination: paginationSchema.optional(),
+    })
+        .passthrough(),
+    getBrand: z
+        .object({
+        brand: anyRecord.optional(),
+        role: z.string().optional(),
+    })
+        .passthrough(),
+    listDesigns: z
+        .object({
+        designs: z.array(anyRecord),
+        archivedCount: z.number().optional(),
+        pagination: paginationSchema.optional(),
+    })
+        .passthrough(),
+    getDesign: z
+        .object({
+        design: anyRecord.optional(),
+    })
+        .passthrough(),
+    createBrand: z
+        .object({
+        brand: anyRecord.optional(),
+        reviewStatus: z.string().optional(),
+    })
+        .passthrough(),
+    generate: z
+        .object({
+        designId: z.string(),
+        generationId: z.string(),
+        status: z.string(),
+        editorUrl: z.string(),
+        statusUrl: z.string(),
+        format: z.string().optional(),
+        formatNote: z.string().optional(),
+        credits: z.unknown().optional(),
+    })
+        .passthrough(),
+    poll: z
+        .object({
+        designId: z.string(),
+        generationId: z.string(),
+        status: z.string(),
+        editorUrl: z.string(),
+        imageUrl: z.string().optional(),
+        completedAt: z.string().nullable().optional(),
+        platformBadge: z.boolean().optional(),
+        badgeNote: z.string().optional(),
+        failureMessage: z.string().optional(),
+    })
+        .passthrough(),
+    download: z
+        .object({
+        saved: z.boolean(),
+        path: z.string(),
+        size: z.number(),
+    })
+        .passthrough(),
+    searchKnowledgeEntries: z
+        .object({
+        entries: z.array(anyRecord),
+        count: z.number().optional(),
+    })
+        .passthrough(),
+    createKnowledgeEntry: z
+        .object({
+        slug: z.string(),
+        created: z.boolean(),
+        node: z.string(),
+    })
+        .passthrough(),
+};
+export const readOnly = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+export const writeRemote = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: false,
+    openWorldHint: true,
+};
+export const writeLocal = {
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: true,
+};