@google/stitch-sdk 0.0.1

package/dist/src/index.d.ts

@@ -0,0 +1,10 @@
+export { Stitch } from "../generated/src/stitch.js";
+export { Project } from "../generated/src/project.js";
+export { Screen } from "../generated/src/screen.js";
+export { StitchToolClient } from "./client.js";
+export { StitchProxy } from "./proxy/core.js";
+export { stitch } from "./singleton.js";
+export { StitchError, StitchErrorCode } from "./spec/errors.js";
+export type { StitchConfig, StitchConfigInput } from "./spec/client.js";
+export type { ProjectData, GenerateScreenParams, DesignTheme, ScreenInstance, ThumbnailScreenshot, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGhE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACxE,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,25 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// Domain classes (generated)
+export { Stitch } from "../generated/src/stitch.js";
+export { Project } from "../generated/src/project.js";
+export { Screen } from "../generated/src/screen.js";
+// Infrastructure (handwritten)
+export { StitchToolClient } from "./client.js";
+export { StitchProxy } from "./proxy/core.js";
+// Singleton
+export { stitch } from "./singleton.js";
+// Error handling
+export { StitchError, StitchErrorCode } from "./spec/errors.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,kDAAkD;AAClD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,6BAA6B;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD,+BAA+B;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,YAAY;AACZ,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/src/proxy/client.d.ts

@@ -0,0 +1,22 @@
+import { StitchProxyConfig } from '../spec/proxy.js';
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Shared state for proxy handlers.
+ */
+export interface ProxyContext {
+    config: StitchProxyConfig;
+    remoteTools: Tool[];
+}
+/**
+ * Forward a JSON-RPC request to Stitch.
+ */
+export declare function forwardToStitch(config: StitchProxyConfig, method: string, params?: unknown): Promise<unknown>;
+/**
+ * Initialize connection to Stitch and fetch tools.
+ */
+export declare function initializeStitchConnection(ctx: ProxyContext): Promise<void>;
+/**
+ * Refresh the cached tools list from Stitch.
+ */
+export declare function refreshTools(ctx: ProxyContext): Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/src/proxy/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/proxy/client.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,WAAW,EAAE,IAAI,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,OAAO,CAAC,CAsClB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnE"}

package/dist/src/proxy/client.js

@@ -0,0 +1,87 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+/**
+ * Forward a JSON-RPC request to Stitch.
+ */
+export async function forwardToStitch(config, method, params) {
+    const request = {
+        jsonrpc: '2.0',
+        method,
+        params: params ?? {},
+        id: Date.now(),
+    };
+    let response;
+    try {
+        response = await fetch(config.url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Accept: 'application/json',
+                'X-Goog-Api-Key': config.apiKey,
+            },
+            body: JSON.stringify(request),
+        });
+    }
+    catch (err) {
+        throw new Error(`Network failure connecting to Stitch API: ${err.message}`);
+    }
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`Stitch API error (${response.status}): ${errorText}`);
+    }
+    const result = (await response.json());
+    if (result.error) {
+        throw new Error(`Stitch RPC error: ${result.error.message}`);
+    }
+    return result.result;
+}
+/**
+ * Initialize connection to Stitch and fetch tools.
+ */
+export async function initializeStitchConnection(ctx) {
+    // Send initialize request
+    await forwardToStitch(ctx.config, 'initialize', {
+        protocolVersion: ctx.config.protocolVersion || '2024-11-05',
+        capabilities: {},
+        clientInfo: {
+            name: ctx.config.name,
+            version: ctx.config.version,
+        },
+    });
+    // Send initialized notification (fire and forget)
+    fetch(ctx.config.url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+            'X-Goog-Api-Key': ctx.config.apiKey,
+        },
+        body: JSON.stringify({
+            jsonrpc: '2.0',
+            method: 'notifications/initialized',
+        }),
+    }).catch((err) => {
+        console.error('[stitch-proxy] Failed to send initialized notification:', err);
+    });
+    await refreshTools(ctx);
+    console.error(`[stitch-proxy] Connected to Stitch, discovered ${ctx.remoteTools.length} tools`);
+}
+/**
+ * Refresh the cached tools list from Stitch.
+ */
+export async function refreshTools(ctx) {
+    const toolsResult = (await forwardToStitch(ctx.config, 'tools/list', {}));
+    ctx.remoteTools = toolsResult.tools || [];
+}
+//# sourceMappingURL=client.js.map

package/dist/src/proxy/client.js.map

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

package/dist/src/proxy/core.d.ts

@@ -0,0 +1,16 @@
+import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { StitchProxyConfig, StitchProxySpec } from '../spec/proxy.js';
+/**
+ * A proxy server that forwards MCP requests to Stitch.
+ * Bypasses SDK transport layer to handle specific auth and JSON-RPC forwarding.
+ */
+export declare class StitchProxy implements StitchProxySpec {
+    private config;
+    private server;
+    private ctx;
+    constructor(inputConfig?: Partial<StitchProxyConfig>);
+    private setupHandlers;
+    start(transport: Transport): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=core.d.ts.map

package/dist/src/proxy/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/proxy/core.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAA2B,iBAAiB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAK/F;;;GAGG;AACH,qBAAa,WAAY,YAAW,eAAe;IACjD,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,GAAG,CAAe;gBAEd,WAAW,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAoCpD,OAAO,CAAC,aAAa;IAKf,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/src/proxy/core.js

@@ -0,0 +1,68 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StitchProxyConfigSchema } from '../spec/proxy.js';
+import { initializeStitchConnection } from './client.js';
+import { registerListToolsHandler } from './handlers/listTools.js';
+import { registerCallToolHandler } from './handlers/callTool.js';
+/**
+ * A proxy server that forwards MCP requests to Stitch.
+ * Bypasses SDK transport layer to handle specific auth and JSON-RPC forwarding.
+ */
+export class StitchProxy {
+    config;
+    server;
+    ctx;
+    constructor(inputConfig) {
+        const rawConfig = {
+            apiKey: inputConfig?.apiKey || process.env.STITCH_API_KEY,
+            url: inputConfig?.url || process.env.STITCH_MCP_URL,
+            name: inputConfig?.name,
+            version: inputConfig?.version,
+        };
+        // Validate config
+        this.config = StitchProxyConfigSchema.parse(rawConfig);
+        if (!this.config.apiKey) {
+            throw new Error('StitchProxy requires an API key (STITCH_API_KEY)');
+        }
+        this.server = new McpServer({
+            name: this.config.name,
+            version: this.config.version,
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        // Shared context for handlers
+        this.ctx = {
+            config: this.config,
+            remoteTools: [],
+        };
+        this.setupHandlers();
+    }
+    setupHandlers() {
+        registerListToolsHandler(this.server.server, this.ctx);
+        registerCallToolHandler(this.server.server, this.ctx);
+    }
+    async start(transport) {
+        console.error(`[stitch-proxy] Connecting to ${this.config.url}...`);
+        await initializeStitchConnection(this.ctx);
+        await this.server.connect(transport);
+        console.error('[stitch-proxy] Proxy server running');
+    }
+    async close() {
+        await this.server.close();
+    }
+}
+//# sourceMappingURL=core.js.map

package/dist/src/proxy/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/proxy/core.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,kDAAkD;AAClD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,uBAAuB,EAAsC,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAgB,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;GAGG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,CAAoB;IAC1B,MAAM,CAAY;IAClB,GAAG,CAAe;IAE1B,YAAY,WAAwC;QAClD,MAAM,SAAS,GAAG;YAChB,MAAM,EAAE,WAAW,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;YACzD,GAAG,EAAE,WAAW,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;YACnD,IAAI,EAAE,WAAW,EAAE,IAAI;YACvB,OAAO,EAAE,WAAW,EAAE,OAAO;SAC9B,CAAC;QAEF,kBAAkB;QAClB,IAAI,CAAC,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAEvD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CACzB;YACE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACtB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;SAC7B,EACD;YACE,YAAY,EAAE;gBACZ,KAAK,EAAE,EAAE;aACV;SACF,CACF,CAAC;QAEF,8BAA8B;QAC9B,IAAI,CAAC,GAAG,GAAG;YACT,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,EAAY;SAC1B,CAAC;QAEF,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAEO,aAAa;QACnB,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACvD,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAoB;QAC9B,OAAO,CAAC,KAAK,CAAC,gCAAgC,IAAI,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC;QACpE,MAAM,0BAA0B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACrC,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/src/proxy/handlers/callTool.d.ts

@@ -0,0 +1,7 @@
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { ProxyContext } from '../client.js';
+/**
+ * Register the tools/call handler.
+ */
+export declare function registerCallToolHandler(server: Server, ctx: ProxyContext): void;
+//# sourceMappingURL=callTool.d.ts.map

package/dist/src/proxy/handlers/callTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callTool.d.ts","sourceRoot":"","sources":["../../../../src/proxy/handlers/callTool.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,YAAY,GAChB,IAAI,CAoBN"}

package/dist/src/proxy/handlers/callTool.js

@@ -0,0 +1,40 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { forwardToStitch } from '../client.js';
+/**
+ * Register the tools/call handler.
+ */
+export function registerCallToolHandler(server, ctx) {
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        console.error(`[stitch-proxy] Calling tool: ${name}`);
+        try {
+            const result = await forwardToStitch(ctx.config, 'tools/call', {
+                name,
+                arguments: args,
+            });
+            return result;
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            console.error(`[stitch-proxy] Tool call failed: ${errorMessage}`);
+            return {
+                content: [{ type: 'text', text: `Error calling ${name}: ${errorMessage}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=callTool.js.map

package/dist/src/proxy/handlers/callTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callTool.js","sourceRoot":"","sources":["../../../../src/proxy/handlers/callTool.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,kDAAkD;AAClD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAG3E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAc,EACd,GAAiB;IAEjB,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;QAEtD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE;gBAC7D,IAAI;gBACJ,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;YACH,OAAO,MAA4D,CAAC;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtE,OAAO,CAAC,KAAK,CAAC,oCAAoC,YAAY,EAAE,CAAC,CAAC;YAClE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,IAAI,KAAK,YAAY,EAAE,EAAE,CAAC;gBAC3E,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/proxy/handlers/listTools.d.ts

@@ -0,0 +1,7 @@
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { ProxyContext } from '../client.js';
+/**
+ * Register the tools/list handler.
+ */
+export declare function registerListToolsHandler(server: Server, ctx: ProxyContext): void;
+//# sourceMappingURL=listTools.d.ts.map

package/dist/src/proxy/handlers/listTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listTools.d.ts","sourceRoot":"","sources":["../../../../src/proxy/handlers/listTools.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,YAAY,GAChB,IAAI,CAcN"}

package/dist/src/proxy/handlers/listTools.js

@@ -0,0 +1,36 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { refreshTools } from '../client.js';
+/**
+ * Register the tools/list handler.
+ */
+export function registerListToolsHandler(server, ctx) {
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        try {
+            await refreshTools(ctx);
+        }
+        catch (err) {
+            console.error('[stitch-proxy] Failed to refresh tools:', err);
+            if (ctx.remoteTools.length === 0) {
+                throw err;
+            }
+            else {
+                console.warn('[stitch-proxy] Warning: Using stale tools due to refresh failure');
+            }
+        }
+        return { tools: ctx.remoteTools };
+    });
+}
+//# sourceMappingURL=listTools.js.map

package/dist/src/proxy/handlers/listTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listTools.js","sourceRoot":"","sources":["../../../../src/proxy/handlers/listTools.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,kDAAkD;AAClD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAG5E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAc,EACd,GAAiB;IAEjB,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC1D,IAAI,CAAC;YACH,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,yCAAyC,EAAE,GAAG,CAAC,CAAC;YAC9D,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjC,MAAM,GAAG,CAAC;YACZ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/proxy/index.d.ts

@@ -0,0 +1,4 @@
+export { StitchProxy } from './core.js';
+export { forwardToStitch, initializeStitchConnection, refreshTools } from './client.js';
+export type { ProxyContext } from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/proxy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/proxy/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxF,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/proxy/index.js

@@ -0,0 +1,17 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// Proxy barrel exports
+export { StitchProxy } from './core.js';
+export { forwardToStitch, initializeStitchConnection, refreshTools } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/src/proxy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/proxy/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,kDAAkD;AAClD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,uBAAuB;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/singleton.d.ts

@@ -0,0 +1,25 @@
+import { Stitch } from "../generated/src/stitch.js";
+import { StitchToolClient } from "./client.js";
+/** Get or create the shared StitchToolClient instance. */
+export declare function getOrCreateClient(config?: {
+    apiKey?: string;
+}): StitchToolClient;
+/**
+ * Default Stitch instance using environment variables.
+ * Lazily initialized on first access.
+ *
+ * Exposes both domain methods (from Stitch class) and tool methods
+ * (listTools, callTool, close from StitchToolClient).
+ *
+ * @example
+ * import { stitch } from '@google/stitch-sdk';
+ *
+ * // Domain API
+ * const projects = await stitch.projects();
+ *
+ * // Tool API
+ * const tools = await stitch.listTools();
+ * await stitch.callTool("create_project", { title: "My App" });
+ */
+export declare const stitch: Stitch & Pick<StitchToolClient, "listTools" | "callTool" | "close">;
+//# sourceMappingURL=singleton.d.ts.map

package/dist/src/singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../src/singleton.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAM/C,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,CAQhF;AAeD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,MAAM,qEAqBjB,CAAC"}

package/dist/src/singleton.js

@@ -0,0 +1,76 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { Stitch } from "../generated/src/stitch.js";
+import { StitchToolClient } from "./client.js";
+import { DEFAULT_STITCH_API_URL } from "./constants.js";
+/** Lazily-initialized default client */
+let _client = null;
+/** Get or create the shared StitchToolClient instance. */
+export function getOrCreateClient(config) {
+    if (!_client) {
+        _client = new StitchToolClient({
+            apiKey: config?.apiKey || process.env.STITCH_API_KEY,
+            baseUrl: process.env.STITCH_HOST || DEFAULT_STITCH_API_URL,
+        });
+    }
+    return _client;
+}
+/** Lazily-initialized default Stitch instance */
+let _stitch = null;
+function getStitchInstance() {
+    if (!_stitch) {
+        _stitch = new Stitch(getOrCreateClient());
+    }
+    return _stitch;
+}
+/** Methods that delegate to StitchToolClient instead of Stitch domain class. */
+const CLIENT_METHODS = new Set(['listTools', 'callTool', 'close']);
+/**
+ * Default Stitch instance using environment variables.
+ * Lazily initialized on first access.
+ *
+ * Exposes both domain methods (from Stitch class) and tool methods
+ * (listTools, callTool, close from StitchToolClient).
+ *
+ * @example
+ * import { stitch } from '@google/stitch-sdk';
+ *
+ * // Domain API
+ * const projects = await stitch.projects();
+ *
+ * // Tool API
+ * const tools = await stitch.listTools();
+ * await stitch.callTool("create_project", { title: "My App" });
+ */
+export const stitch = new Proxy({}, {
+    get(_target, prop) {
+        // Client methods → delegate to StitchToolClient
+        if (typeof prop === 'string' && CLIENT_METHODS.has(prop)) {
+            const client = getOrCreateClient();
+            const value = client[prop];
+            if (typeof value === 'function') {
+                return value.bind(client);
+            }
+            return value;
+        }
+        // Domain methods → delegate to Stitch instance
+        const instance = getStitchInstance();
+        const value = instance[prop];
+        if (typeof value === 'function') {
+            return value.bind(instance);
+        }
+        return value;
+    },
+});
+//# sourceMappingURL=singleton.js.map

package/dist/src/singleton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.js","sourceRoot":"","sources":["../../src/singleton.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,kDAAkD;AAClD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,wCAAwC;AACxC,IAAI,OAAO,GAA4B,IAAI,CAAC;AAE5C,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAAC,MAA4B;IAC5D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,gBAAgB,CAAC;YAC7B,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;YACpD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,sBAAsB;SAC3D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iDAAiD;AACjD,IAAI,OAAO,GAAkB,IAAI,CAAC;AAElC,SAAS,iBAAiB;IACxB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AAEnE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,KAAK,CAE7B,EAAS,EAAE;IACX,GAAG,CAAC,OAAO,EAAE,IAAqB;QAChC,gDAAgD;QAChD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,MAAM,CAAC,IAA8B,CAAC,CAAC;YACrD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,+CAA+C;QAC/C,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAoB,CAAC,CAAC;QAC7C,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC,CAAC"}

package/dist/src/spec/client.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+export declare const StitchConfigSchema: z.ZodObject<{
+    apiKey: z.ZodOptional<z.ZodString>;
+    accessToken: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+    baseUrl: z.ZodDefault<z.ZodString>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type StitchConfig = z.infer<typeof StitchConfigSchema>;
+/** Input type for StitchConfig - fields with defaults are optional */
+export type StitchConfigInput = z.input<typeof StitchConfigSchema>;
+export declare const ToolResultSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ToolResult = z.infer<typeof ToolResultSchema>;
+export declare const ToolsSchema: z.ZodObject<{
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        inputSchema: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Tools = z.infer<typeof ToolsSchema>;
+export interface StitchToolClientSpec {
+    name: 'stitch-tool-client';
+    description: 'Authenticated tool pipe for Stitch MCP Server';
+    /**
+     * Validate configuration and establish connection.
+     * MUST handle auth header injection based on config.
+     * - API Key: Inject `X-Goog-Api-Key` header.
+     * - OAuth: Inject `Authorization: Bearer` and `X-Goog-User-Project` headers.
+     */
+    connect: () => Promise<void>;
+    /**
+     * Call a tool on the MCP server.
+     * @param name - Tool name
+     * @param args - Tool arguments
+     * @returns Parsed tool result
+     */
+    callTool: <T>(name: string, args: Record<string, unknown>) => Promise<T>;
+    /**
+     * Get available tools from the server.
+     */
+    listTools: () => Promise<Tools>;
+    /**
+     * Close the connection.
+     */
+    close: () => Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/src/spec/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/spec/client.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,kBAAkB;;;;;;iBAqB7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,sEAAsE;AACtE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAKnE,eAAO,MAAM,gBAAgB;;;;iBAI3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,WAAW;;;;;;iBAMtB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAKhD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,WAAW,EAAE,+CAA+C,CAAC;IAE7D;;;;;OAKG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAEzE;;OAEG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;IAEhC;;OAEG;IACH,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B"}

package/dist/src/spec/client.js

@@ -0,0 +1,52 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { z } from 'zod';
+import { DEFAULT_STITCH_API_URL } from '../constants.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// 1. INPUT SCHEMA - What the client receives for configuration
+// ─────────────────────────────────────────────────────────────────────────────
+export const StitchConfigSchema = z.object({
+    /** API key for simple API access. Falls back to STITCH_API_KEY. */
+    apiKey: z.string().optional(),
+    /** OAuth access token for user-authenticated requests. Falls back to STITCH_ACCESS_TOKEN. */
+    accessToken: z.string().optional(),
+    /** Google Cloud project ID. Required for OAuth, optional for API Key. Falls back to GOOGLE_CLOUD_PROJECT. */
+    projectId: z.string().optional(),
+    /** Base URL for the Stitch MCP server. */
+    baseUrl: z.string().default(DEFAULT_STITCH_API_URL),
+    /** Request timeout in milliseconds. Default: 300000 (5 min). */
+    timeout: z.number().default(300_000),
+}).refine(data => {
+    const hasApiKey = !!data.apiKey;
+    const hasOAuth = !!data.accessToken && !!data.projectId;
+    return hasApiKey || hasOAuth;
+}, {
+    message: "Authentication failed. Provide either 'apiKey' OR ('accessToken' + 'projectId')."
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// 2. OUTPUT SCHEMAS - What the client produces
+// ─────────────────────────────────────────────────────────────────────────────
+export const ToolResultSchema = z.object({
+    success: z.boolean(),
+    data: z.unknown().optional(),
+    error: z.string().optional(),
+});
+export const ToolsSchema = z.object({
+    tools: z.array(z.object({
+        name: z.string(),
+        description: z.string().optional(),
+        inputSchema: z.unknown().optional(),
+    })),
+});
+//# sourceMappingURL=client.js.map

package/dist/src/spec/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/spec/client.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,kDAAkD;AAClD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,gFAAgF;AAChF,+DAA+D;AAC/D,gFAAgF;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,mEAAmE;IACnE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE7B,6FAA6F;IAC7F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAElC,6GAA6G;IAC7G,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEhC,0CAA0C;IAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC;IAEnD,gEAAgE;IAChE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;CACrC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;IACf,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IAChC,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IACxD,OAAO,SAAS,IAAI,QAAQ,CAAC;AAC/B,CAAC,EAAE;IACD,OAAO,EAAE,kFAAkF;CAC5F,CAAC,CAAC;AAMH,gFAAgF;AAChF,+CAA+C;AAC/C,gFAAgF;AAChF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAClC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KACpC,CAAC,CAAC;CACJ,CAAC,CAAC"}