@salesforce/vite-plugin-lwc-ui-bundle 1.134.5 → 2.0.0

package/dist/providers/lds/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sources":["../../../src/providers/shared/normalize-mcp-response.ts","../../../src/providers/lds/runtime.ts"],"sourcesContent":["/**\n * Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n */\n\n/**\n * Unwraps the MCP tool transport envelope and returns the tool's payload as-is.\n *\n * Handles the three surface shapes `sdk.callTool()` can resolve with:\n * - MCP Apps surface: `{ structuredContent, content }`\n * - OpenAI surface: `{ result: \"<JSON string>\" }`, where the JSON may itself be\n *   an MCP content array (`[{ type: 'text', text: \"<JSON string>\" }, ...]`)\n * - Fallback: the raw value returned by `callTool`\n *\n * The shape of the unwrapped payload is the tool's responsibility — this helper\n * does not project out `data` / `error` / `errors`. Callers read whichever keys\n * their tool contract defines.\n */\nexport function normalizeMcpResponse(raw: unknown): unknown {\n\tif (raw && typeof raw === \"object\" && \"structuredContent\" in raw) {\n\t\treturn (raw as { structuredContent: unknown }).structuredContent;\n\t}\n\n\tif (raw && typeof raw === \"object\" && typeof (raw as { result?: unknown }).result === \"string\") {\n\t\tconst parsed = JSON.parse((raw as { result: string }).result);\n\t\tif (Array.isArray(parsed)) {\n\t\t\tconst textBlock = parsed.find(\n\t\t\t\t(b: { type?: string; text?: string }) =>\n\t\t\t\t\tb && b.type === \"text\" && typeof b.text === \"string\",\n\t\t\t);\n\t\t\tconst text = textBlock ? textBlock.text : null;\n\t\t\tif (text) {\n\t\t\t\treturn JSON.parse(text);\n\t\t\t}\n\t\t\treturn {};\n\t\t}\n\t\treturn parsed;\n\t}\n\n\treturn raw ?? {};\n}\n","/**\n * Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n */\nimport type { ResultCommand, SubscribableResultCommand } from \"@conduit-client/bindings-utils/v1\";\nimport type { assertIsValid, JSONSchema } from \"@conduit-client/jsonschema-validate\";\nimport {\n\tbuildDefaultImperativeBindingsServiceDescriptor,\n\tbuildLegacyImperativeBindingsServiceDescriptor,\n\tbuildQueryImperativeBindingsServiceDescriptor,\n\tbuildSubscribableImperativeBindingsServiceDescriptor,\n} from \"@conduit-client/service-bindings-imperative/v1\";\nimport { buildLWCWireBindingsServiceDescriptor } from \"@conduit-client/service-bindings-lwc/v1\";\nimport {\n\tbuildSubscribableResult,\n\terr,\n\tok,\n\ttoError,\n\ttype Callback,\n\ttype Result,\n\ttype Unsubscribe,\n} from \"@conduit-client/utils\";\nimport { getChatSDK } from \"@salesforce/sdk-chat\";\nimport type { ReadInvokerShape } from \"./types\";\nimport { normalizeMcpResponse } from \"../shared/normalize-mcp-response\";\n\ninterface WireAdapterConfig {\n\ttoolName: string;\n\tconfigJsonSchema: JSONSchema;\n}\n\ninterface MutationAdapterConfig {\n\ttoolName: string;\n\tconfigJsonSchema: JSONSchema;\n}\n\ninterface ReadAdapterConfig {\n\tinvokerShape: ReadInvokerShape;\n\ttoolName: string;\n\tconfigJsonSchema: JSONSchema;\n}\n\n/**\n * Optional envelope splitter. Converts the normalized MCP payload into a\n * `Result<Data, Error>` — used by the wire adapter so tools that return\n * `{ data, error }` land on OneStore's Err branch when `error` is set.\n * Imperative callers leave this unset and get the raw payload wrapped in\n * `ok(...)`.\n */\ntype UnwrapEnvelope<Data> = (payload: unknown) => Result<Data, Error>;\n\n/**\n * Pulls a human-readable message out of an MCP error response\n * (`{ isError: true, content: [{ type: 'text', text: ... }, ...] }`).\n * Returns an empty string if no text content is present so the caller can\n * supply a fallback.\n */\nfunction extractToolErrorText(raw: unknown): string {\n\tconst content = (raw as { content?: unknown }).content;\n\tif (!Array.isArray(content)) return \"\";\n\treturn content\n\t\t.map((c) => {\n\t\t\tif (c && typeof c === \"object\" && (c as { type?: string }).type === \"text\") {\n\t\t\t\treturn (c as { text?: string }).text ?? \"\";\n\t\t\t}\n\t\t\treturn \"\";\n\t\t})\n\t\t.join(\" \")\n\t\t.trim();\n}\n\n/**\n * `Command` implementation that calls the configured MCP tool. One class,\n * reused across imperative and wire adapters.\n *\n * `execute()` returns a `Result<Data, unknown>`:\n * - `ok(data)` when the tool resolves — `data` is the unwrapped payload from\n *   `normalizeMcpResponse` (or the result of the optional `unwrap` hook).\n * - `err(error)` when the tool rejects, when `sdk.callTool` is unavailable,\n *   or when the `unwrap` hook returns `err(...)`.\n *\n * OneStore's `DefaultImperativeBindingsService` wraps this: on `ok(v)` it\n * deep-freezes and returns `v`; on `err(e)` it re-throws via `toError`. Sync\n * throws from `assertIsValid` in the `getCommand` factory are funneled through\n * `throwUserlandError`. `LWCWireBindingsService` wraps the same command\n * differently — it emits `{ data, error }` to the wire callback and attaches\n * freeze / race-guard / incomplete-config behavior.\n */\nclass McpToolCommand<Data> implements ResultCommand<Data, Error> {\n\tconstructor(\n\t\tprivate readonly adapterName: string,\n\t\tprivate readonly toolName: string,\n\t\tprivate readonly params: unknown,\n\t\tprivate readonly unwrap?: UnwrapEnvelope<Data>,\n\t) {}\n\n\tasync execute(): Promise<Result<Data, Error>> {\n\t\ttry {\n\t\t\tconst app = await getChatSDK();\n\t\t\tif (!app.callTool) {\n\t\t\t\treturn err(\n\t\t\t\t\tnew Error(\n\t\t\t\t\t\t`[${this.adapterName}] sdk.callTool is not available on this surface. ` +\n\t\t\t\t\t\t\t\"Make sure window.openai is configured or the component is running \" +\n\t\t\t\t\t\t\t\"in an MCP Apps / OpenAI chat context.\",\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst raw = await app.callTool({\n\t\t\t\ttoolName: this.toolName,\n\t\t\t\tparams: (this.params as Record<string, unknown>) ?? undefined,\n\t\t\t});\n\t\t\t// The MCP SDK converts handler throws into a resolved tool response\n\t\t\t// with `{ isError: true, content: [...] }` — not a transport\n\t\t\t// rejection. Surface it as an Err here so the default invoker\n\t\t\t// re-throws and the wire/legacy adapters route it through their\n\t\t\t// error channel.\n\t\t\tif (raw && typeof raw === \"object\" && (raw as { isError?: boolean }).isError) {\n\t\t\t\treturn err(new Error(extractToolErrorText(raw) || \"MCP tool error\"));\n\t\t\t}\n\t\t\tconst payload = normalizeMcpResponse(raw);\n\t\t\treturn this.unwrap ? this.unwrap(payload) : ok(payload as Data);\n\t\t} catch (e) {\n\t\t\treturn err(e instanceof Error ? e : new Error(String(e)));\n\t\t}\n\t}\n}\n\n// Off-platform has no store to observe. `subscribe` never fires the callback;\n// the returned unsubscribe is a safe no-op. Module-level so `refresh()`\n// doesn't re-allocate.\nconst noopUnsubscribe: Unsubscribe = () => {\n\t// no store to unsubscribe from off-platform\n};\nconst noopSubscribe = (_cb: Callback<Result<unknown, unknown>>): Unsubscribe => noopUnsubscribe;\n\n/**\n * Adapts `McpToolCommand` into a `SubscribableResultCommand`. Wraps the\n * command's `Result` with `buildSubscribableResult`, supplying:\n *   - `subscribe`: no-op — off-platform has no store, so the callback never\n *     fires. Returned unsubscribe is idempotent.\n *   - `refresh`: builds a fresh `McpToolCommand` and re-executes it so each\n *     refresh issues a new MCP tool call. Returns `Result<void, Error>`\n *     (ok → undefined; err → the error from the fresh execute).\n *\n * This shim is what lets OneStore's Subscribable and Legacy services run\n * verbatim against MCP: their invokers gate on `isSubscribableResult`, which\n * requires the command's `execute()` to resolve a `SubscribableResult` (not\n * a plain `Result`). The deliberate \"subscribe that doesn't subscribe\"\n * preserves the OneStore API surface so ported code keeps its call sites.\n */\nclass McpToolSubscribableCommand<Data> implements SubscribableResultCommand<Data, Error> {\n\tconstructor(\n\t\tprivate readonly adapterName: string,\n\t\tprivate readonly toolName: string,\n\t\tprivate readonly params: unknown,\n\t\tprivate readonly unwrap?: UnwrapEnvelope<Data>,\n\t) {}\n\n\tasync execute() {\n\t\tconst base = new McpToolCommand<Data>(\n\t\t\tthis.adapterName,\n\t\t\tthis.toolName,\n\t\t\tthis.params,\n\t\t\tthis.unwrap,\n\t\t);\n\t\tconst result = await base.execute();\n\t\tconst refresh = async () => {\n\t\t\tconst next = await new McpToolCommand<Data>(\n\t\t\t\tthis.adapterName,\n\t\t\t\tthis.toolName,\n\t\t\t\tthis.params,\n\t\t\t\tthis.unwrap,\n\t\t\t).execute();\n\t\t\treturn next.isOk() ? ok<void, Error>(undefined) : err(next.error);\n\t\t};\n\t\treturn buildSubscribableResult(result, noopSubscribe, refresh);\n\t}\n}\n\nconst defaultImperativeService = buildDefaultImperativeBindingsServiceDescriptor().service;\nconst queryImperativeService = buildQueryImperativeBindingsServiceDescriptor().service;\nconst subscribableImperativeService =\n\tbuildSubscribableImperativeBindingsServiceDescriptor().service;\nconst legacyImperativeService = buildLegacyImperativeBindingsServiceDescriptor().service;\n\n/**\n * Mutation-shape factory. Builds an async `(config) => Promise<Data>` via\n * OneStore's `DefaultImperativeBindingsService`. Throws on validation error\n * (`throwUserlandError`) or tool error (`toError`). This is the only shape a\n * mutation ever takes on platform — mutation adapters do not carry an\n * `invokerShape` at all.\n */\nexport function createMutationAdapter(name: string, cfg: MutationAdapterConfig) {\n\tconst getCommand = (options: { params: unknown[]; assertIsValid: typeof assertIsValid }) => {\n\t\toptions.assertIsValid(options.params[0], cfg.configJsonSchema);\n\t\treturn new McpToolCommand<unknown>(name, cfg.toolName, options.params[0]);\n\t};\n\tconst invoker = defaultImperativeService.bind<unknown[], unknown>(getCommand);\n\treturn (...params: unknown[]) => Promise.resolve(invoker(...params));\n}\n\n/**\n * Read-shape factory. Dispatches on `cfg.invokerShape`:\n *\n * - `legacy` — `{ invoke, subscribe }` callback surface with `{ data, error }`.\n *   `subscribe` fires the callback once from the initial execute's `data`,\n *   returns a no-op unsubscribe, and never fires again off-platform.\n * - `query` — `(config) => Promise<{ data }>`; one-shot read.\n * - `subscribable` — `(config) => Promise<{ data, subscribe }>`. Callback\n *   passed to `subscribe` never fires; unsubscribe is a no-op.\n * - `subscribable-refreshable` — `(config) => Promise<{ data, subscribe, refresh }>`.\n *   `refresh()` re-executes the MCP tool; `subscribe` is still a no-op.\n *\n * All four delegate to an OneStore service (Query / Subscribable / Legacy)\n * over `McpToolSubscribableCommand`, which preserves OneStore's deep-freeze\n * and error-funnel semantics end-to-end.\n */\nexport function createReadAdapter(name: string, cfg: ReadAdapterConfig) {\n\tconst getSubscribableCommand = (options: {\n\t\tparams: unknown[];\n\t\tassertIsValid: typeof assertIsValid;\n\t}) => {\n\t\toptions.assertIsValid(options.params[0], cfg.configJsonSchema);\n\t\treturn new McpToolSubscribableCommand<unknown>(name, cfg.toolName, options.params[0]);\n\t};\n\n\tswitch (cfg.invokerShape) {\n\t\tcase \"query\": {\n\t\t\tconst getCommand = (options: { params: unknown[]; assertIsValid: typeof assertIsValid }) => {\n\t\t\t\toptions.assertIsValid(options.params[0], cfg.configJsonSchema);\n\t\t\t\treturn new McpToolCommand<unknown>(name, cfg.toolName, options.params[0]);\n\t\t\t};\n\t\t\tconst invoker = queryImperativeService.bind<unknown[], unknown>(getCommand);\n\t\t\treturn (...params: unknown[]) => Promise.resolve(invoker(...params));\n\t\t}\n\t\tcase \"subscribable\": {\n\t\t\tconst invoker = subscribableImperativeService.bind<unknown[], unknown>(\n\t\t\t\tgetSubscribableCommand,\n\t\t\t\tfalse,\n\t\t\t);\n\t\t\treturn (...params: unknown[]) => Promise.resolve(invoker(...params));\n\t\t}\n\t\tcase \"subscribable-refreshable\": {\n\t\t\tconst invoker = subscribableImperativeService.bind<unknown[], unknown>(\n\t\t\t\tgetSubscribableCommand,\n\t\t\t\ttrue,\n\t\t\t);\n\t\t\treturn (...params: unknown[]) => Promise.resolve(invoker(...params));\n\t\t}\n\t\tcase \"legacy\": {\n\t\t\t// Legacy service passes `{ config, assertIsValid }`, not `{ params, ... }`.\n\t\t\tconst getLegacyCommand = (options: {\n\t\t\t\tconfig: unknown;\n\t\t\t\tassertIsValid: typeof assertIsValid;\n\t\t\t}) => {\n\t\t\t\toptions.assertIsValid(options.config, cfg.configJsonSchema);\n\t\t\t\treturn new McpToolSubscribableCommand<unknown>(name, cfg.toolName, options.config);\n\t\t\t};\n\t\t\treturn legacyImperativeService.bind<unknown, unknown>(getLegacyCommand);\n\t\t}\n\t\tdefault:\n\t\t\tthrow new Error(\n\t\t\t\t`[${name}] unsupported invokerShape: ${String((cfg as { invokerShape: unknown }).invokerShape)}. ` +\n\t\t\t\t\t`Expected 'legacy' | 'query' | 'subscribable' | 'subscribable-refreshable'.`,\n\t\t\t);\n\t}\n}\n\nconst lwcWireBindingsService = buildLWCWireBindingsServiceDescriptor().service;\n\n/**\n * Splits the MCP tool's `{ data, error }` envelope into a `Result`. Used as\n * the `unwrap` hook on `McpToolCommand` so OneStore's wire invoker sees the\n * error branch directly instead of receiving an envelope wrapped in `ok(...)`.\n *\n * Tools that don't emit the envelope (e.g. imperative) never go through this\n * path — the default imperative invoker doesn't pass `unwrap`.\n */\nfunction unwrapWireEnvelope<Data>(payload: unknown): Result<Data, Error> {\n\tconst envelope = payload as { data?: unknown; error?: unknown } | null | undefined;\n\tif (envelope && envelope.error !== undefined && envelope.error !== null) {\n\t\treturn err(toError(envelope.error));\n\t}\n\treturn ok(envelope?.data as Data);\n}\n\n/**\n * Creates an LWC wire adapter class that calls an MCP tool. Delegates to\n * OneStore's `LWCWireBindingsService`, so the returned class inherits the\n * full `CommandWireAdapterConstructor` contract: initial empty emit, config\n * `sanitize()`, `MissingRequiredPropertyError` → wait-for-next-config gating,\n * deep-freeze on success, race guard on stale resolves, and unsubscriber\n * management on disconnect.\n *\n * The `McpToolCommand` class is reused verbatim — the wire call-site only\n * supplies an `unwrap` hook so the tool's `{ data, error }` envelope lands\n * on OneStore's Err branch rather than being leaked through as an `ok(...)`\n * envelope.\n *\n * @param name - Wire adapter export name, used in MCP error messages.\n * @param cfg  - MCP tool name and JSON Schema for valid wire configs.\n */\nexport function createWireAdapter(name: string, cfg: WireAdapterConfig) {\n\treturn lwcWireBindingsService.bind<unknown>(\n\t\t(config) => new McpToolCommand(name, cfg.toolName, config, unwrapWireEnvelope),\n\t\tcfg.configJsonSchema,\n\t);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime.js","sources":["../../../src/providers/shared/normalize-mcp-response.ts","../../../src/providers/lds/runtime.ts"],"sourcesContent":["/**\n * Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n */\n\n/**\n * Unwraps the MCP tool transport envelope and returns the tool's payload as-is.\n *\n * Handles the three surface shapes `sdk.callTool()` can resolve with:\n * - MCP Apps surface: `{ structuredContent, content }`\n * - OpenAI surface: `{ result: \"<JSON string>\" }`, where the JSON may itself be\n *   an MCP content array (`[{ type: 'text', text: \"<JSON string>\" }, ...]`)\n * - Fallback: the raw value returned by `callTool`\n *\n * The shape of the unwrapped payload is the tool's responsibility — this helper\n * does not project out `data` / `error` / `errors`. Callers read whichever keys\n * their tool contract defines.\n */\nexport function normalizeMcpResponse(raw: unknown): unknown {\n\tif (raw && typeof raw === \"object\" && \"structuredContent\" in raw) {\n\t\treturn (raw as { structuredContent: unknown }).structuredContent;\n\t}\n\n\tif (raw && typeof raw === \"object\" && typeof (raw as { result?: unknown }).result === \"string\") {\n\t\tconst parsed = JSON.parse((raw as { result: string }).result);\n\t\tif (Array.isArray(parsed)) {\n\t\t\tconst textBlock = parsed.find(\n\t\t\t\t(b: { type?: string; text?: string }) =>\n\t\t\t\t\tb && b.type === \"text\" && typeof b.text === \"string\",\n\t\t\t);\n\t\t\tconst text = textBlock ? textBlock.text : null;\n\t\t\tif (text) {\n\t\t\t\treturn JSON.parse(text);\n\t\t\t}\n\t\t\treturn {};\n\t\t}\n\t\treturn parsed;\n\t}\n\n\treturn raw ?? {};\n}\n","/**\n * Copyright (c) 2026, Salesforce, Inc.,\n * All rights reserved.\n * For full license text, see the LICENSE.txt file\n */\nimport type { ResultCommand, SubscribableResultCommand } from \"@conduit-client/bindings-utils/v1\";\nimport type { assertIsValid, JSONSchema } from \"@conduit-client/jsonschema-validate\";\nimport {\n\tbuildDefaultImperativeBindingsServiceDescriptor,\n\tbuildLegacyImperativeBindingsServiceDescriptor,\n\tbuildQueryImperativeBindingsServiceDescriptor,\n\tbuildSubscribableImperativeBindingsServiceDescriptor,\n} from \"@conduit-client/service-bindings-imperative/v1\";\nimport { buildLWCWireBindingsServiceDescriptor } from \"@conduit-client/service-bindings-lwc/v1\";\nimport {\n\tbuildSubscribableResult,\n\terr,\n\tok,\n\ttoError,\n\ttype Callback,\n\ttype Result,\n\ttype Unsubscribe,\n} from \"@conduit-client/utils\";\nimport { getChatSDK } from \"@salesforce/platform-sdk-chat\";\nimport type { ReadInvokerShape } from \"./types\";\nimport { normalizeMcpResponse } from \"../shared/normalize-mcp-response\";\n\n/**\n * Runtime mirror of the public `LdsAdapterConfigBase` — adapters dispatch\n * through `cfg.mcp?.toolName`. Kept nominal-free so the virtual module can\n * cheaply deserialize the JSON-stringified config written by the load hook.\n */\ninterface McpBackedAdapterConfig {\n\tmcp?: { toolName: string };\n}\n\n/**\n * LDS adapter configs whose input is validated against a JSON Schema at\n * invoke time. Wire, mutation, and read factories all consume this shape;\n * graphql factories skip the schema layer entirely.\n */\ninterface SchemaValidatedAdapterConfig extends McpBackedAdapterConfig {\n\tconfigJsonSchema: JSONSchema;\n}\n\ntype WireAdapterConfig = SchemaValidatedAdapterConfig;\n\ntype MutationAdapterConfig = SchemaValidatedAdapterConfig;\n\ninterface ReadAdapterConfig extends SchemaValidatedAdapterConfig {\n\tinvokerShape: ReadInvokerShape;\n}\n\n/**\n * Resolves the MCP tool name for an adapter config, or throws if none of the\n * supported backings are set. Today only `mcp` is wired up; future backings\n * (e.g. `http`) will be resolved in the same choke point.\n */\nfunction resolveMcpToolName(adapterName: string, cfg: McpBackedAdapterConfig): string {\n\tconst toolName = cfg.mcp?.toolName;\n\tif (!toolName) {\n\t\tthrow new Error(`[${adapterName}] no dispatch backing configured — expected \\`mcp.toolName\\`.`);\n\t}\n\treturn toolName;\n}\n\n/**\n * Optional envelope splitter. Converts the normalized MCP payload into a\n * `Result<Data, Error>` — used by the wire adapter so tools that return\n * `{ data, error }` land on OneStore's Err branch when `error` is set.\n * Imperative callers leave this unset and get the raw payload wrapped in\n * `ok(...)`.\n */\ntype UnwrapEnvelope<Data> = (payload: unknown) => Result<Data, Error>;\n\n/**\n * Resolves the MCP chat SDK and returns its `callTool` function, or throws a\n * consistent \"[adapter] sdk.callTool is not available\" error. Shared by the\n * LDS `McpToolCommand` and the graphql `runGraphqlQuery` — the check and\n * message are identical on both paths.\n */\nasync function getCallTool(\n\tadapterName: string,\n): Promise<(args: { toolName: string; params?: Record<string, unknown> }) => Promise<unknown>> {\n\tconst sdk = await getChatSDK();\n\tif (typeof sdk.callTool !== \"function\") {\n\t\tthrow new Error(\n\t\t\t`[${adapterName}] sdk.callTool is not available on this surface. ` +\n\t\t\t\t\"Make sure window.openai is configured or the component is running \" +\n\t\t\t\t\"in an MCP Apps / OpenAI chat context.\",\n\t\t);\n\t}\n\treturn sdk.callTool.bind(sdk);\n}\n\n/**\n * Pulls a human-readable message out of an MCP error response\n * (`{ isError: true, content: [{ type: 'text', text: ... }, ...] }`).\n * Returns an empty string if no text content is present so the caller can\n * supply a fallback.\n */\nfunction extractToolErrorText(raw: unknown): string {\n\tconst content = (raw as { content?: unknown }).content;\n\tif (!Array.isArray(content)) return \"\";\n\treturn content\n\t\t.map((c) => {\n\t\t\tif (c && typeof c === \"object\" && (c as { type?: string }).type === \"text\") {\n\t\t\t\treturn (c as { text?: string }).text ?? \"\";\n\t\t\t}\n\t\t\treturn \"\";\n\t\t})\n\t\t.join(\" \")\n\t\t.trim();\n}\n\n/**\n * `Command` implementation that calls the configured MCP tool. One class,\n * reused across imperative and wire adapters.\n *\n * `execute()` returns a `Result<Data, unknown>`:\n * - `ok(data)` when the tool resolves — `data` is the unwrapped payload from\n *   `normalizeMcpResponse` (or the result of the optional `unwrap` hook).\n * - `err(error)` when the tool rejects, when `sdk.callTool` is unavailable,\n *   or when the `unwrap` hook returns `err(...)`.\n *\n * OneStore's `DefaultImperativeBindingsService` wraps this: on `ok(v)` it\n * deep-freezes and returns `v`; on `err(e)` it re-throws via `toError`. Sync\n * throws from `assertIsValid` in the `getCommand` factory are funneled through\n * `throwUserlandError`. `LWCWireBindingsService` wraps the same command\n * differently — it emits `{ data, error }` to the wire callback and attaches\n * freeze / race-guard / incomplete-config behavior.\n */\nclass McpToolCommand<Data> implements ResultCommand<Data, Error> {\n\tconstructor(\n\t\tprivate readonly adapterName: string,\n\t\tprivate readonly toolName: string,\n\t\tprivate readonly params: unknown,\n\t\tprivate readonly unwrap?: UnwrapEnvelope<Data>,\n\t) {}\n\n\tasync execute(): Promise<Result<Data, Error>> {\n\t\ttry {\n\t\t\tconst callTool = await getCallTool(this.adapterName);\n\t\t\tconst raw = await callTool({\n\t\t\t\ttoolName: this.toolName,\n\t\t\t\tparams: (this.params as Record<string, unknown>) ?? undefined,\n\t\t\t});\n\t\t\t// The MCP SDK converts handler throws into a resolved tool response\n\t\t\t// with `{ isError: true, content: [...] }` — not a transport\n\t\t\t// rejection. Surface it as an Err here so the default invoker\n\t\t\t// re-throws and the wire/legacy adapters route it through their\n\t\t\t// error channel.\n\t\t\tif (raw && typeof raw === \"object\" && (raw as { isError?: boolean }).isError) {\n\t\t\t\treturn err(new Error(extractToolErrorText(raw) || \"MCP tool error\"));\n\t\t\t}\n\t\t\tconst payload = normalizeMcpResponse(raw);\n\t\t\treturn this.unwrap ? this.unwrap(payload) : ok(payload as Data);\n\t\t} catch (e) {\n\t\t\treturn err(e instanceof Error ? e : new Error(String(e)));\n\t\t}\n\t}\n}\n\n// Off-platform has no store to observe. For shapes that have no `refresh`,\n// nothing can ever trigger a post-initial update, so `subscribe` is a\n// deliberate no-op: the callback never fires and the returned unsubscribe is\n// idempotent. Shapes that *do* expose `refresh` wire subscribers into the\n// refresh path instead (see `McpToolSubscribableCommand` and the\n// `query-refreshable` graphql shape).\nconst noopUnsubscribe: Unsubscribe = () => {\n\t// no store to unsubscribe from off-platform\n};\nconst noopSubscribe = (_cb: unknown): Unsubscribe => noopUnsubscribe;\n\n/**\n * Adapts `McpToolCommand` into a `SubscribableResultCommand`. Wraps the\n * command's `Result` with `buildSubscribableResult`, supplying:\n *   - `subscribe`: per-execution subscriber set. Each `execute()` call has\n *     its own set so sibling invocations don't cross-pollinate. Returned\n *     unsubscribe removes the callback and is idempotent.\n *   - `refresh`: builds a fresh `McpToolCommand`, re-executes it, and\n *     broadcasts the fresh `Result` to every registered subscriber before\n *     resolving. Returns `Result<void, Error>` (ok → undefined; err → the\n *     error from the fresh execute).\n *\n * Wiring subscribers into refresh mirrors on-platform behavior, where the\n * reactive store fans `refresh` results out to every listener. Off-platform\n * there is no store, so the subscriber set lives on the command itself. This\n * shim is what lets OneStore's Subscribable and Legacy services run verbatim\n * against MCP: their invokers gate on `isSubscribableResult`, which requires\n * the command's `execute()` to resolve a `SubscribableResult` (not a plain\n * `Result`).\n */\nclass McpToolSubscribableCommand<Data> implements SubscribableResultCommand<Data, Error> {\n\tconstructor(\n\t\tprivate readonly adapterName: string,\n\t\tprivate readonly toolName: string,\n\t\tprivate readonly params: unknown,\n\t\tprivate readonly unwrap?: UnwrapEnvelope<Data>,\n\t) {}\n\n\tasync execute() {\n\t\tconst base = new McpToolCommand<Data>(\n\t\t\tthis.adapterName,\n\t\t\tthis.toolName,\n\t\t\tthis.params,\n\t\t\tthis.unwrap,\n\t\t);\n\t\tconst result = await base.execute();\n\t\tconst subscribers = new Set<Callback<Result<Data, Error>>>();\n\t\tconst subscribe = (cb: Callback<Result<Data, Error>>): Unsubscribe => {\n\t\t\tsubscribers.add(cb);\n\t\t\treturn () => {\n\t\t\t\tsubscribers.delete(cb);\n\t\t\t};\n\t\t};\n\t\tconst refresh = async () => {\n\t\t\tconst next = await new McpToolCommand<Data>(\n\t\t\t\tthis.adapterName,\n\t\t\t\tthis.toolName,\n\t\t\t\tthis.params,\n\t\t\t\tthis.unwrap,\n\t\t\t).execute();\n\t\t\tsubscribers.forEach((cb) => cb(next));\n\t\t\treturn next.isOk() ? ok<void, Error>(undefined) : err(next.error);\n\t\t};\n\t\treturn buildSubscribableResult(result, subscribe, refresh);\n\t}\n}\n\nconst defaultImperativeService = buildDefaultImperativeBindingsServiceDescriptor().service;\nconst queryImperativeService = buildQueryImperativeBindingsServiceDescriptor().service;\nconst subscribableImperativeService =\n\tbuildSubscribableImperativeBindingsServiceDescriptor().service;\nconst legacyImperativeService = buildLegacyImperativeBindingsServiceDescriptor().service;\n\n/**\n * Mutation-shape factory. Builds an async `(config) => Promise<Data>` via\n * OneStore's `DefaultImperativeBindingsService`. Throws on validation error\n * (`throwUserlandError`) or tool error (`toError`). This is the only shape a\n * mutation ever takes on platform — mutation adapters do not carry an\n * `invokerShape` at all.\n */\nexport function createMutationAdapter(name: string, cfg: MutationAdapterConfig) {\n\tconst toolName = resolveMcpToolName(name, cfg);\n\tconst getCommand = (options: { params: unknown[]; assertIsValid: typeof assertIsValid }) => {\n\t\toptions.assertIsValid(options.params[0], cfg.configJsonSchema);\n\t\treturn new McpToolCommand<unknown>(name, toolName, options.params[0]);\n\t};\n\tconst invoker = defaultImperativeService.bind<unknown[], unknown>(getCommand);\n\treturn (...params: unknown[]) => Promise.resolve(invoker(...params));\n}\n\n/**\n * Read-shape factory. Dispatches on `cfg.invokerShape`:\n *\n * - `legacy` — `{ invoke, subscribe }` callback surface with `{ data, error }`.\n *   `subscribe` fires the callback once from the initial execute's `data`,\n *   returns a no-op unsubscribe, and never fires again off-platform.\n * - `query` — `(config) => Promise<{ data }>`; one-shot read.\n * - `subscribable` — `(config) => Promise<{ data, subscribe }>`. Callback\n *   passed to `subscribe` never fires; unsubscribe is a no-op.\n * - `subscribable-refreshable` — `(config) => Promise<{ data, subscribe, refresh }>`.\n *   `refresh()` re-executes the MCP tool; `subscribe` is still a no-op.\n *\n * All four delegate to an OneStore service (Query / Subscribable / Legacy)\n * over `McpToolSubscribableCommand`, which preserves OneStore's deep-freeze\n * and error-funnel semantics end-to-end.\n */\nexport function createReadAdapter(name: string, cfg: ReadAdapterConfig) {\n\tconst toolName = resolveMcpToolName(name, cfg);\n\tconst getSubscribableCommand = (options: {\n\t\tparams: unknown[];\n\t\tassertIsValid: typeof assertIsValid;\n\t}) => {\n\t\toptions.assertIsValid(options.params[0], cfg.configJsonSchema);\n\t\treturn new McpToolSubscribableCommand<unknown>(name, toolName, options.params[0]);\n\t};\n\n\tswitch (cfg.invokerShape) {\n\t\tcase \"query\": {\n\t\t\tconst getCommand = (options: { params: unknown[]; assertIsValid: typeof assertIsValid }) => {\n\t\t\t\toptions.assertIsValid(options.params[0], cfg.configJsonSchema);\n\t\t\t\treturn new McpToolCommand<unknown>(name, toolName, options.params[0]);\n\t\t\t};\n\t\t\tconst invoker = queryImperativeService.bind<unknown[], unknown>(getCommand);\n\t\t\treturn (...params: unknown[]) => Promise.resolve(invoker(...params));\n\t\t}\n\t\tcase \"subscribable\": {\n\t\t\tconst invoker = subscribableImperativeService.bind<unknown[], unknown>(\n\t\t\t\tgetSubscribableCommand,\n\t\t\t\tfalse,\n\t\t\t);\n\t\t\treturn (...params: unknown[]) => Promise.resolve(invoker(...params));\n\t\t}\n\t\tcase \"subscribable-refreshable\": {\n\t\t\tconst invoker = subscribableImperativeService.bind<unknown[], unknown>(\n\t\t\t\tgetSubscribableCommand,\n\t\t\t\ttrue,\n\t\t\t);\n\t\t\treturn (...params: unknown[]) => Promise.resolve(invoker(...params));\n\t\t}\n\t\tcase \"legacy\": {\n\t\t\t// Legacy service passes `{ config, assertIsValid }`, not `{ params, ... }`.\n\t\t\tconst getLegacyCommand = (options: {\n\t\t\t\tconfig: unknown;\n\t\t\t\tassertIsValid: typeof assertIsValid;\n\t\t\t}) => {\n\t\t\t\toptions.assertIsValid(options.config, cfg.configJsonSchema);\n\t\t\t\treturn new McpToolSubscribableCommand<unknown>(name, toolName, options.config);\n\t\t\t};\n\t\t\treturn legacyImperativeService.bind<unknown, unknown>(getLegacyCommand);\n\t\t}\n\t\tdefault:\n\t\t\tthrow new Error(\n\t\t\t\t`[${name}] unsupported invokerShape: ${String((cfg as { invokerShape: unknown }).invokerShape)}. ` +\n\t\t\t\t\t`Expected 'legacy' | 'query' | 'subscribable' | 'subscribable-refreshable'.`,\n\t\t\t);\n\t}\n}\n\nconst lwcWireBindingsService = buildLWCWireBindingsServiceDescriptor().service;\n\n/**\n * Splits the MCP tool's `{ data, error }` envelope into a `Result`. Used as\n * the `unwrap` hook on `McpToolCommand` so OneStore's wire invoker sees the\n * error branch directly instead of receiving an envelope wrapped in `ok(...)`.\n *\n * Tools that don't emit the envelope (e.g. imperative) never go through this\n * path — the default imperative invoker doesn't pass `unwrap`.\n */\nfunction unwrapWireEnvelope<Data>(payload: unknown): Result<Data, Error> {\n\tconst envelope = payload as { data?: unknown; error?: unknown } | null | undefined;\n\tif (envelope && envelope.error !== undefined && envelope.error !== null) {\n\t\treturn err(toError(envelope.error));\n\t}\n\treturn ok(envelope?.data as Data);\n}\n\n/**\n * Creates an LWC wire adapter class that calls an MCP tool. Delegates to\n * OneStore's `LWCWireBindingsService`, so the returned class inherits the\n * full `CommandWireAdapterConstructor` contract: initial empty emit, config\n * `sanitize()`, `MissingRequiredPropertyError` → wait-for-next-config gating,\n * deep-freeze on success, race guard on stale resolves, and unsubscriber\n * management on disconnect.\n *\n * The `McpToolCommand` class is reused verbatim — the wire call-site only\n * supplies an `unwrap` hook so the tool's `{ data, error }` envelope lands\n * on OneStore's Err branch rather than being leaked through as an `ok(...)`\n * envelope.\n *\n * @param name - Wire adapter export name, used in MCP error messages.\n * @param cfg  - MCP tool name and JSON Schema for valid wire configs.\n */\nexport function createWireAdapter(name: string, cfg: WireAdapterConfig) {\n\tconst toolName = resolveMcpToolName(name, cfg);\n\treturn lwcWireBindingsService.bind<unknown>(\n\t\t(config) => new McpToolCommand(name, toolName, config, unwrapWireEnvelope),\n\t\tcfg.configJsonSchema,\n\t);\n}\n\n// ─── GraphQL adapters ─────────────────────────────────────────────────────────\n\n/**\n * GraphQL adapters diverge from the base wire / mutation shapes in two ways:\n *\n *   1. Envelope is `{ data, errors[] }` instead of `{ data, error }`. Errors\n *      are collected; an empty array collapses to `undefined`.\n *   2. The `_fetch` path routes thrown errors **into** the `errors[]`\n *      envelope on the wire callback (never throws to the LWC host). Mutation\n *      likewise resolves with `{ data, errors }` rather than rejecting.\n *\n * Dispatch is MCP-only: `getChatSDK().callTool({ toolName, params })` with\n * `normalizeMcpResponse` unwrapping. No `globalThis.__sfdc_sdk__` shortcut —\n * the on-platform behaviour is already covered by real `lightning/graphql`,\n * and every off-platform caller routes through an MCP tool like every other\n * LDS adapter.\n */\ntype GraphqlAdapterConfig = McpBackedAdapterConfig;\n\ninterface GraphqlConfig {\n\tquery?: string;\n\tvariables?: Record<string, unknown>;\n}\n\ninterface GraphqlResult {\n\tdata?: unknown;\n\terrors?: { message: string }[];\n}\n\ntype GraphqlWireCallback = (result: {\n\tdata: unknown;\n\terrors: { message: string }[] | undefined;\n\trefresh: () => Promise<void>;\n}) => void;\n\n/**\n * Template-literal tag that stitches the string into a plain `query` string.\n * Deliberately minimal — no AST parsing, no fragment substitution, no opaque\n * doc emulation. Matches the shape used by today's off-platform `gql`.\n */\nexport function gql(strings: TemplateStringsArray, ...values: unknown[]): string {\n\tlet result = \"\";\n\tstrings.forEach((string, i) => {\n\t\tresult += string;\n\t\tif (i < values.length) result += String(values[i]);\n\t});\n\treturn result.trim();\n}\n\nasync function runGraphqlQuery(\n\tadapterName: string,\n\ttoolName: string,\n\tconfig: GraphqlConfig,\n): Promise<GraphqlResult> {\n\tconst { query, variables } = config;\n\tif (!query) return { data: undefined, errors: undefined };\n\n\tconst callTool = await getCallTool(adapterName);\n\tconst raw = await callTool({\n\t\ttoolName,\n\t\tparams: { query, variables: variables ?? {} },\n\t});\n\n\treturn (normalizeMcpResponse(raw) as GraphqlResult) ?? {};\n}\n\n/** Wraps a thrown Error into the graphql `{ data, errors[] }` envelope. */\nfunction toGraphqlErrorResult(error: unknown): GraphqlResult {\n\treturn { data: undefined, errors: [{ message: (error as Error).message }] };\n}\n\n/**\n * `runGraphqlQuery` wrapped in try/catch so thrown errors land on `errors[]`\n * instead of rejecting. Used by every graphql shape that routes errors\n * in-band (wire, mutation, imperative-read query/query-refreshable, legacy).\n */\nasync function runGraphqlQuerySafe(\n\tadapterName: string,\n\ttoolName: string,\n\tconfig: GraphqlConfig,\n): Promise<GraphqlResult> {\n\ttry {\n\t\treturn await runGraphqlQuery(adapterName, toolName, config);\n\t} catch (error) {\n\t\treturn toGraphqlErrorResult(error);\n\t}\n}\n\n/**\n * GraphQL wire adapter factory. Emits `{ data, errors, refresh }` to the wire\n * callback. Mirrors the `constructor(callback)` → `connect` / `disconnect` /\n * `update(config)` / `refresh()` contract used by the LWC wire service.\n * Thrown fetch errors are routed into `errors[0].message`.\n *\n * `_fetch` is gated on `_connected` so that the common wire lifecycle\n * (`constructor` → `update(config)` → `connect`) doesn't fire two requests:\n * the initial `update(config)` arrives before `connect()`, stores the config,\n * and waits. `connect()` does the one fetch; later `update(config)` while\n * connected re-fetches. This matches luvio's `LWCLuvioWireAdapter`, which\n * gates on the same flag to prevent duplicate endpoint calls.\n */\nexport function createGraphQLWireAdapter(name: string, cfg: GraphqlAdapterConfig) {\n\tconst toolName = resolveMcpToolName(name, cfg);\n\treturn class {\n\t\t_dataCallback: GraphqlWireCallback;\n\t\t_config: GraphqlConfig | undefined;\n\t\t_connected = false;\n\n\t\tconstructor(dataCallback: GraphqlWireCallback) {\n\t\t\tthis._dataCallback = dataCallback;\n\t\t}\n\n\t\tconnect() {\n\t\t\tthis._connected = true;\n\t\t\tvoid this._fetch();\n\t\t}\n\n\t\tdisconnect() {\n\t\t\tthis._connected = false;\n\t\t}\n\n\t\tupdate(config: GraphqlConfig | undefined) {\n\t\t\tthis._config = config;\n\n\t\t\tif (!this._connected || this._config === undefined) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tvoid this._fetch();\n\t\t}\n\n\t\trefresh() {\n\t\t\treturn this._fetch();\n\t\t}\n\n\t\tasync _fetch() {\n\t\t\tthis._emit(await runGraphqlQuerySafe(name, toolName, this._config ?? {}));\n\t\t}\n\n\t\t_emit({ data, errors }: GraphqlResult) {\n\t\t\tthis._dataCallback({\n\t\t\t\tdata,\n\t\t\t\terrors: errors?.length ? errors : undefined,\n\t\t\t\trefresh: () => this.refresh(),\n\t\t\t});\n\t\t}\n\t};\n}\n\n/**\n * GraphQL mutation factory. Returns `async (config) => Promise<{ data, errors }>`.\n * Empty-query guard short-circuits with\n * `{ data: undefined, errors: [{ message: \"No query provided\" }] }`.\n * All other errors are routed in-band to the `errors[]` envelope — the\n * function never rejects.\n */\nexport function createGraphQLMutationAdapter(name: string, cfg: GraphqlAdapterConfig) {\n\tconst toolName = resolveMcpToolName(name, cfg);\n\treturn async (config: GraphqlConfig): Promise<GraphqlResult> => {\n\t\tif (!config?.query) return { data: undefined, errors: [{ message: \"No query provided\" }] };\n\t\treturn runGraphqlQuerySafe(name, toolName, config);\n\t};\n}\n\ntype GraphqlImperativeReadInvokerShape = \"query\" | \"query-refreshable\" | \"legacy\";\n\ninterface GraphqlImperativeReadAdapterConfig extends GraphqlAdapterConfig {\n\tinvokerShape: GraphqlImperativeReadInvokerShape;\n}\n\ntype GraphqlImperativeResult = GraphqlResult & {\n\tsubscribe?: (cb: (result: GraphqlResult) => void) => Unsubscribe;\n\trefresh?: () => Promise<void>;\n};\n\ntype LegacyGraphqlCallback = (result: GraphqlResult) => void;\n\n/**\n * Imperative GraphQL read factory — single entry point for all imperative\n * graphql read shapes, mirroring the LDS `createReadAdapter` pattern. The\n * `invokerShape` selects the return surface:\n *\n *   - `query` — `async (config) => Promise<{ data, errors, subscribe }>`.\n *     Mirrors on-platform `GraphQLImperativeBindingsService` without\n *     `exposeRefresh`. Errors are routed in-band; the function never throws.\n *   - `query-refreshable` — same as `query` plus `refresh()` that re-runs the\n *     underlying MCP tool. Mirrors the same service with `exposeRefresh: true`.\n *   - `legacy` — `{ invoke(config, context, callback),\n *     subscribe(config, context, callback): Unsubscribe }`. The callback\n *     always receives `{ data, errors }`; neither method throws. `context` is\n *     accepted but ignored.\n *\n * In every shape `subscribe` is a deliberate no-op off-platform (no reactive\n * store); returned unsubscribes are idempotent.\n */\nexport function createGraphQLImperativeReadAdapter(\n\tname: string,\n\tcfg: GraphqlImperativeReadAdapterConfig,\n) {\n\tconst toolName = resolveMcpToolName(name, cfg);\n\tif (cfg.invokerShape === \"legacy\") {\n\t\tasync function run(\n\t\t\tconfig: GraphqlConfig | undefined,\n\t\t\tcallback: LegacyGraphqlCallback,\n\t\t): Promise<void> {\n\t\t\tif (!config?.query) {\n\t\t\t\tcallback({ data: undefined, errors: undefined });\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst result = await runGraphqlQuerySafe(name, toolName, config);\n\t\t\tcallback({\n\t\t\t\tdata: result.data,\n\t\t\t\terrors: result.errors?.length ? result.errors : undefined,\n\t\t\t});\n\t\t}\n\n\t\treturn {\n\t\t\tinvoke(\n\t\t\t\tconfig: GraphqlConfig | undefined,\n\t\t\t\t_context: unknown,\n\t\t\t\tcallback: LegacyGraphqlCallback,\n\t\t\t): void {\n\t\t\t\tvoid run(config, callback);\n\t\t\t},\n\t\t\tsubscribe(\n\t\t\t\tconfig: GraphqlConfig | undefined,\n\t\t\t\t_context: unknown,\n\t\t\t\tcallback: LegacyGraphqlCallback,\n\t\t\t): Unsubscribe {\n\t\t\t\tvoid run(config, callback);\n\t\t\t\treturn noopUnsubscribe;\n\t\t\t},\n\t\t};\n\t}\n\n\tif (cfg.invokerShape === \"query-refreshable\") {\n\t\t// Per-invocation subscriber set: each call to the returned function\n\t\t// gets its own adapter instance with an isolated subscriber list.\n\t\t// `refresh()` re-runs the MCP tool and broadcasts the fresh\n\t\t// `{ data, errors }` to every registered callback, which mirrors the\n\t\t// on-platform contract where `refresh` causes store updates that fan\n\t\t// out through the `subscribe` fan-in. Without this wiring, `refresh`\n\t\t// would re-run the query off-platform but nothing could observe the\n\t\t// new payload (no store, noop subscribe).\n\t\treturn async (config: GraphqlConfig): Promise<GraphqlImperativeResult> => {\n\t\t\tconst result = await runGraphqlQuerySafe(name, toolName, config);\n\t\t\tif (result.errors?.length) {\n\t\t\t\treturn { data: undefined, errors: result.errors };\n\t\t\t}\n\t\t\tconst subscribers = new Set<(result: GraphqlResult) => void>();\n\t\t\treturn {\n\t\t\t\tdata: result.data,\n\t\t\t\terrors: undefined,\n\t\t\t\tsubscribe: (cb) => {\n\t\t\t\t\tsubscribers.add(cb);\n\t\t\t\t\treturn () => {\n\t\t\t\t\t\tsubscribers.delete(cb);\n\t\t\t\t\t};\n\t\t\t\t},\n\t\t\t\trefresh: async () => {\n\t\t\t\t\tconst fresh = await runGraphqlQuerySafe(name, toolName, config);\n\t\t\t\t\tconst payload: GraphqlResult = {\n\t\t\t\t\t\tdata: fresh.data,\n\t\t\t\t\t\terrors: fresh.errors?.length ? fresh.errors : undefined,\n\t\t\t\t\t};\n\t\t\t\t\tsubscribers.forEach((cb) => cb(payload));\n\t\t\t\t},\n\t\t\t};\n\t\t};\n\t}\n\n\t// `query` shape: no refresh → nothing can trigger a post-initial update\n\t// off-platform, so `subscribe` stays a noop. The on-platform contract\n\t// allows subscribe callbacks to fire from unrelated store writes; off-\n\t// platform there is no store, so the callback is correctly unreachable.\n\treturn async (config: GraphqlConfig): Promise<GraphqlImperativeResult> => {\n\t\tconst result = await runGraphqlQuerySafe(name, toolName, config);\n\t\tif (result.errors?.length) {\n\t\t\treturn { data: undefined, errors: result.errors };\n\t\t}\n\t\treturn {\n\t\t\tdata: result.data,\n\t\t\terrors: undefined,\n\t\t\tsubscribe: noopSubscribe,\n\t\t};\n\t};\n}\n"],"names":[],"mappings":"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"}

package/docs/consumer-guide.md

@@ -10,25 +10,16 @@ existing LWC project so you can compile your components into a single self-conta
 
 - **Node.js** >= 20.0.0
 - **LWC components** in a project directory (standard SFDX project or custom layout)
-- **Salesforce CLI** (`sf`) — only needed if connecting to a real org (Tier 2)
 
 ---
 
 ## Overview
 
-The plugin supports two tiers of usage:
-
-| Tier                            | What You Get                               | Org Required?      |
-| ------------------------------- | ------------------------------------------ | ------------------ |
-| **Tier 1: Off-Platform Build**  | Static bundle with mock data, labels, i18n | No                 |
-| **Tier 2: Live Org Connection** | Real GraphQL queries, live Salesforce data | Yes (via `sf` CLI) |
-
-Start with Tier 1. Add Tier 2 later if your components use `lightning/graphql` or
-need live data.
+The plugin compiles your LWC components into a single self-contained `dist/index.html` that runs in a real MCP host (ChatGPT, MCP Apps, local demo MCP) — same bundle, no conditional wrapping. For **local development without a real host**, install a `window.openai.callTool` mock in your entry script; the guarded install is skipped automatically when a real host provides `window.openai`. `lightning/graphql` and `lightning/uiRecordApi` both route through MCP (`callTool("graphqlQuery", ...)` and `callTool("getRecordMcpTool", ...)`) via `builtins.lds()`.
 
 ---
 
-## Tier 1: Off-Platform Build
+## Off-Platform Build
 
 ### Project Structure
 
@@ -231,20 +222,55 @@ Always include `builtins.gate()` and `builtins.accessCheck()` when using
 
 ### Step 4: Create `bootstrap.js`
 
+The compiled bundle targets real MCP hosts (ChatGPT, MCP Apps, local demo MCP) — they provide `window.openai.callTool` before the bundle loads. For **local development without a real host**, install a guarded mock at the top of `bootstrap.js` so `@wire(graphql)`, `@wire(getRecord)`, and `executeMutation` calls return data. The guard (`if (!window.openai?.callTool)`) makes the mock a no-op when a real host is present, so the same compiled bundle works in both environments.
+
 ```js
-import "@salesforce-ux/design-system/assets/styles/salesforce-lightning-design-system.css";
-import "@lwc/synthetic-shadow";
-import { createElement } from "lwc";
+// Mock window.openai.callTool for local dev. Must run before any LWC / sdk-core
+// import, because sdk-core detects the surface at module-load time by reading
+// window.openai. Guard with `if (!window.openai?.callTool)` so a real MCP host
+// skips this block entirely.
+if (!window.openai?.callTool) {
+  window.openai = {
+    ...window.openai,
+    callTool: async (name, args) => {
+      await new Promise((r) => setTimeout(r, 300)); // simulate latency
+
+      if (name === "getRecordMcpTool") {
+        // lightning/uiRecordApi → @wire(getRecord)
+        return {
+          structuredContent: {
+            data: {
+              fields: { Name: { value: "Mock Record" } },
+            },
+          },
+        };
+      }
+      if (name === "graphqlQuery") {
+        // lightning/graphql → @wire(graphql) or executeMutation(...)
+        // Branch on args.query to return different envelopes.
+        return { result: JSON.stringify({ data: {} }) };
+      }
+      return { result: JSON.stringify({ data: {} }) };
+    },
+  };
+}
 
-// Import your root component using its LWC specifier: <namespace>/<componentName>
-import App from "c/myApp";
+// Dynamic imports so the mock above is in place before sdk-core loads.
+await import("@lwc/synthetic-shadow");
+await import("@salesforce-ux/design-system/assets/styles/salesforce-lightning-design-system.css");
+const { createElement } = await import("lwc");
+const { default: App } = await import("c/myApp");
 
-// Mount it — tag name is the kebab-case version of the specifier
 const el = createElement("c-my-app", { is: App });
 document.getElementById("app").appendChild(el);
 ```
 
-Replace `c/myApp` and `c-my-app` with your actual root component name.
+Replace `c/myApp` and `c-my-app` with your actual root component name. If your components use only labels, i18n, and base components (no LDS / graphql), the `callTool` mock block can be omitted — `window.openai` only matters when MCP-backed adapters are in play.
+
+For complete working examples, see:
+
+- [`lwc-simple/src/main.js`](../../../examples/lwc-axl/lwc-simple/src/main.js) — `@wire(getRecord)` + `@wire(graphql)` (read paths)
+- [`lwc-records/src/app/bootstrap.js`](../../../examples/lwc-axl/lwc-records/src/app/bootstrap.js) — `executeMutation` with a `ContactUpdate` branch
 
 ### Step 5: Build and Test
 
@@ -266,102 +292,6 @@ npm run preview
 
 ---
 
-## Tier 2: Live Org Connection (lwcProxy)
-
-If your components use `lightning/graphql` or need live Salesforce data, add
-`lwcProxy()` to connect to a real org during development.
-
-### Prerequisites
-
-- Salesforce CLI installed and an org connected: `sf org display`
-- Additional packages: `@salesforce/sdk-data` and `@salesforce/ui-bundle`
-
-### Step 1: Install Additional Dependencies
-
-```bash
-npm install @salesforce/sdk-data @salesforce/ui-bundle
-```
-
-### Step 2: Update `vite.config.js`
-
-Add `lwcProxy()` before `lwcVitePlugin()` and add `builtins.lightningGraphql()`
-to providers:
-
-```js
-import { defineConfig } from "vite";
-import lwcVitePlugin, { builtins, lwcProxy } from "@salesforce/vite-plugin-lwc-ui-bundle";
-import { viteSingleFile } from "vite-plugin-singlefile";
-
-export default defineConfig({
-  build: {
-    target: "esnext",
-    minify: false,
-  },
-  plugins: [
-    lwcProxy({ debug: true }),
-    // lwcProxy({ orgAlias: "my-org", debug: true }),  // explicit org
-    lwcVitePlugin({
-      modules: {
-        dirs: [{ path: "force-app/main/default/lwc", namespace: "c" }],
-        npm: ["lightning-base-components"],
-      },
-      providers: [
-        builtins.label(),
-        builtins.i18n(),
-        builtins.client(),
-        builtins.gate(),
-        builtins.accessCheck(),
-        builtins.lightningGraphql(),
-      ],
-    }),
-    viteSingleFile(),
-  ],
-});
-```
-
-### Step 3: Update `bootstrap.js`
-
-Initialize the Data SDK before mounting your app. This requires top-level `await`
-(hence `target: "esnext"` in the vite config):
-
-```js
-import "@salesforce-ux/design-system/assets/styles/salesforce-lightning-design-system.css";
-import "@lwc/synthetic-shadow";
-import { createElement } from "lwc";
-
-// Initialize SDK — lwcProxy() handles /services/* in the Vite dev server
-import { createDataSDK } from "@salesforce/sdk-data";
-try {
-  globalThis.__sfdc_sdk__ = await createDataSDK({ uiBundle: { basePath: "/" } });
-} catch (_err) {
-  globalThis.__sfdc_sdk__ = {};
-}
-
-// Import your root component
-import App from "c/myApp";
-
-const el = createElement("c-my-app", { is: App });
-document.getElementById("app").appendChild(el);
-```
-
-### Step 4: Run Dev Server
-
-```bash
-npm run dev
-# Terminal shows: [lwc-proxy] Connected to https://your-org.my.salesforce.com
-# Open http://localhost:5173
-```
-
-Components using `@wire(graphql, ...)` will now execute real GraphQL queries
-against your connected org. The proxy intercepts `/services/*` calls inside
-the Vite dev server — no separate proxy process needed.
-
-> **Note:** `lwcProxy()` works with `npm run dev` only. The production build
-> (`dist/index.html`) does not include the proxy — it's a static file. For
-> production use with live data, you need a separate API proxy or MCP server.
-
----
-
 ## Common Errors
 
 ### `Cannot read properties of undefined (reading 'isOpen')`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/vite-plugin-lwc-ui-bundle",
-  "version": "1.134.5",
+  "version": "2.0.0",
   "description": "Vite plugin for compiling LWC components into static bundles for off-platform and MCP use",
   "license": "SEE LICENSE IN LICENSE.txt",
   "author": "Salesforce",
@@ -34,10 +34,6 @@
       "types": "./dist/providers/lds/index.d.ts",
       "import": "./dist/providers/lds/index.js"
     },
-    "./providers/lightning-graphql": {
-      "types": "./dist/providers/lightning-graphql/index.d.ts",
-      "import": "./dist/providers/lightning-graphql/index.js"
-    },
     "./package.json": "./package.json"
   },
   "main": "./dist/index.js",
@@ -49,7 +45,7 @@
     "skills"
   ],
   "scripts": {
-    "build": "vite build && vite build --mode runtime-lds && vite build --mode runtime-lightning-graphql",
+    "build": "vite build && vite build --mode runtime-lds",
     "clean": "rm -rf dist",
     "dev": "vite build --watch",
     "test": "vitest run",
@@ -58,8 +54,8 @@
   },
   "peerDependencies": {
     "@lwc/rollup-plugin": "^9.0.0",
-    "@salesforce/sdk-chat": "^1.123.0",
-    "@salesforce/ui-bundle": "^1.123.0",
+    "@salesforce/platform-sdk-chat": "^2.0.0",
+    "@salesforce/ui-bundle": "^2.0.0",
     "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0",
     "zod": "^3.23.8"
   },
@@ -69,17 +65,17 @@
     }
   },
   "dependencies": {
+    "@conduit-client/jsonschema-validate": "3.19.3",
+    "@conduit-client/service-bindings-imperative": "3.19.3",
+    "@conduit-client/service-bindings-lwc": "3.19.3",
+    "@conduit-client/utils": "3.19.3",
     "es-module-lexer": "^1.7.0",
     "magic-string": "^0.30.17"
   },
   "devDependencies": {
     "@conduit-client/bindings-utils": "3.19.3",
     "@conduit-client/command-base": "3.19.3",
-    "@conduit-client/jsonschema-validate": "3.19.3",
-    "@conduit-client/service-bindings-imperative": "3.19.3",
-    "@conduit-client/service-bindings-lwc": "3.19.3",
-    "@conduit-client/utils": "3.19.3",
-    "@salesforce/sdk-chat": "^1.134.5",
+    "@salesforce/platform-sdk-chat": "^2.0.0",
     "typescript": "^5.9.3",
     "vite": "^7.0.0",
     "vite-plugin-dts": "^4.5.4",

package/skills/setup-lwc-vite-plugin/SKILL.md

@@ -75,8 +75,18 @@ Surface this early:
 > A) Upgrade Node (recommended — `nvm install 20.19` or `22`)
 > B) Pin `vite@^7` and a compatible `@lwc/rollup-plugin` major"
 
+**Stop here.** Report the detected layout and the Node decision, then
+wait for the user to answer. Do **not** bundle Step 2's chat-wrapper
+question into the same turn — a misdetection in Step 1 cascades into
+every later decision, so the user needs a clean moment to confirm or
+correct before anything else lands.
+
 ### Step 2: Ask about chat wrappers
 
+Only start this step **after** Step 1 has been answered and resolved.
+Ask the chat-wrapper question in its own turn — don't stack it on top
+of Step 1's findings report.
+
 If the project will run inside a ChatGPT/MCP host (tool output drives
 the UI), components need a thin chat-aware wrapper + mapper. The wrapper
 reads tool output from the host, the mapper normalizes it into the
@@ -162,10 +172,63 @@ Report what you found — plainly, so the user can correct misdetections:
 > - 3 label imports: `c.appTitle`, `c.greeting`, `c.save`
 > - Uses `lightning-card` → needs lightning-base-components + the
 >   gate/accessCheck/primitiveUtils providers
-> - Uses `lightning/graphql` → needs `builtins.lightningGraphql()` + a
->   graphql mock branch in `bootstrap.js`
-> - Uses `lightning/uiRecordApi` → needs `builtins.lds()` + a
->   `getRecordMcpTool` mock branch"
+> - Uses `lightning/graphql` → needs `builtins.lds()` provider (graphql
+>   specifiers are registered by default) + the `@conduit-client/*` LDS
+>   runtime peers (verified after install in Step 8.1) + a `graphqlQuery`
+>   mock branch in `bootstrap.js`
+> - Uses `lightning/uiRecordApi` → needs `builtins.lds()` provider + the
+>   `@conduit-client/*` LDS runtime peers + a `getRecordMcpTool` mock
+>   branch"
+
+### Step 4.5: Verify existing `vite.config.js` against findings
+
+If `vite.config.js` already exists (Step 1 noted whether it does), open it
+now and cross-check against what Step 4 found. This catches the silent-
+failure case where a project builds successfully but wire adapters and
+scoped imports return `undefined` at runtime because the `providers` array
+is missing or incomplete.
+
+Check in this order:
+
+1. **Does `lwcVitePlugin({...})` include a `providers` array at all?**
+   If not, flag it. Without the array, every `@salesforce/*` import returns
+   `undefined` — labels, gates, access checks, i18n, client — even though
+   the build succeeds. See `references/known-pitfalls.md#11`.
+
+2. **For each finding from Step 4, verify the matching provider is present:**
+   - Step 4 found `@salesforce/label/*` usage → `builtins.label({...})` must be in `providers`
+   - Step 4 found `@wire(graphql)`, `executeMutation`, or any `lightning/graphql` import →
+     `builtins.lds()` must be present (graphql specifiers are in the default registry)
+   - Step 4 found `@wire(getRecord)` from `lightning/uiRecordApi` →
+     `builtins.lds()` must be present (one `builtins.lds()` covers both)
+   - Step 4 found any `@salesforce/i18n/*` → `builtins.i18n()` must be
+     present
+   - Step 4 found any `@salesforce/client/*` → `builtins.client()` must
+     be present
+   - `modules.npm` includes `lightning-base-components` (or
+     `lwc-components-lightning`) → `builtins.gate()`,
+     `builtins.accessCheck()`, `builtins.primitiveUtils()` must all be
+     present. Base components use these modules internally even if user
+     code doesn't.
+
+3. **Report the gaps explicitly** before proceeding to later steps:
+
+   > "Your `vite.config.js` exists but its `providers` array is missing:
+   >
+   > - `builtins.label({...})` — Step 4 found 3 `@salesforce/label/*` imports
+   > - `builtins.lds()` — Step 4 found `@wire(graphql)` / `executeMutation` in `c/recordDetail`
+   > - `builtins.gate()`, `builtins.accessCheck()`, `builtins.primitiveUtils()` — `lightning-base-components` is in `modules.npm` and needs these
+   >
+   > I'll add these in Step 7. The build may currently succeed even with
+   > these missing, but wire adapters and labels will fail silently at
+   > runtime."
+
+4. **If the existing `providers` array is complete**, say so and move on.
+
+Do not skip this verification. A build that compiles fine but has no
+providers registered is the single most common failure mode for projects
+that already have a partial config — the compiler doesn't care, but the
+runtime silently returns `undefined` for everything.
 
 ### Step 5: Decide the runtime mode
 
@@ -297,21 +360,30 @@ See "Step 2" in the consumer guide for the template.
 
 **Import providers from the plugin, do not reimplement them.** All
 provider names (`label`, `i18n`, `client`, `gate`, `accessCheck`,
-`primitiveUtils`, `lightningGraphql`, `lds`) must come from the `builtins`
-export of `@salesforce/vite-plugin-lwc-ui-bundle`. Calling them invokes
-the plugin's real runtime — which includes
-`lightning/graphql` wire adapter, `normalizeMcpResponse` envelope
-parsing, LDS wire adapter, and more. Hand-rolling any of them bypasses
-all that and breaks host integration (see
-`references/known-pitfalls.md#3`).
+`primitiveUtils`, `lds`) must come from the `builtins` export of
+`@salesforce/vite-plugin-lwc-ui-bundle`. Calling them invokes the
+plugin's real runtime — which includes the `lightning/graphql` wire
+adapter, `normalizeMcpResponse` envelope parsing, LDS wire/read/mutation
+adapters, and more. Hand-rolling any of them bypasses all that and
+breaks host integration (see `references/known-pitfalls.md#3`).
 
 ```js
 import lwcVitePlugin, { builtins } from "@salesforce/vite-plugin-lwc-ui-bundle";
 
 // inside plugins -> lwcVitePlugin({ providers: [...] })
-builtins.lightningGraphql(),            // default tool name: "graphqlQuery"
-builtins.lightningGraphql({ toolName: "yourCustomTool" }), // override
-builtins.lds(),                         // default registry
+builtins.lds(),                         // default registry:
+                                        //   lightning/uiRecordApi, uiObjectInfoApi,
+                                        //   and lightning/graphql (tool: "graphqlQuery")
+
+// Add to / override the default registry. The argument is deep-merged onto
+// the defaults per specifier, so you only declare what you are changing —
+// unmentioned entries (e.g. `getRecord`, `createRecord`) are preserved.
+builtins.lds({
+  "lightning/graphql": {
+    graphql: { type: "graphql-wire", mcp: { toolName: "myGraphqlTool" } },
+    executeMutation: { type: "graphql-mutation", mcp: { toolName: "myGraphqlTool" } },
+  },
+}),
 ```
 
 Adapt based on earlier findings:
@@ -319,21 +391,21 @@ Adapt based on earlier findings:
 - Set `dirs` for the detected project structure (SFDX vs namespaced).
 - Populate `builtins.label({...})` with values from Step 6.
 - Include `builtins.primitiveUtils()` if using `lightning-base-components`.
-- Include `builtins.lightningGraphql()` only if GraphQL was detected.
-- Include `builtins.lds()` if any component uses `lightning/uiRecordApi`.
+- Include `builtins.lds()` if any component uses `lightning/uiRecordApi`,
+  `lightning/uiObjectInfoApi`, or `lightning/graphql`.
 - Include `viteSingleFile()` — without it, `vite build` emits multi-file
   output and the MCP host can't inline the bundle. See
-  `known-pitfalls.md#7` for the full config block.
+  `known-pitfalls.md#6` for the full config block.
 - Remove `npm: ["lightning-base-components"]` if no base components used.
 
 **Tool names** (canonical list — referenced elsewhere):
 
 - `builtins.lds()` default for `lightning/uiRecordApi.getRecord`:
   `getRecordMcpTool`. Override via
-  `builtins.lds({ "lightning/uiRecordApi": { getRecord: { toolName: "..." } } })`.
-- `builtins.lightningGraphql()` default: `graphqlQuery` (**not**
-  `"graphql"` or `"lightningGraphql"`). Override via
-  `builtins.lightningGraphql({ toolName: "..." })`.
+  `builtins.lds({ "lightning/uiRecordApi": { getRecord: { type: "wire", mcp: { toolName: "..." } } } })`.
+- `builtins.lds()` default for `lightning/graphql` (both `graphql` wire
+  and `executeMutation`): `graphqlQuery`. Override by registering the
+  specifier explicitly — see example above.
 
 Whatever tool names you settle on here **must match** the branches in
 `bootstrap.js` mocks (Step 8).
@@ -377,12 +449,79 @@ Only add these if the component tree inspection reveals a need:
   system. Useful when an npm package has its own label definitions that
   shouldn't be intercepted.
 - **`ignorePatterns`**: Specifier prefixes that providers should never
-  intercept. Defaults include `@salesforce/sdk-*` and `@salesforce/core`.
+  intercept. Defaults include `@salesforce/sdk-*`, `@salesforce/platform-sdk-*`, and `@salesforce/core`.
 
 ### Step 8: Install and build
 
 ```bash
 npm install
+```
+
+#### Step 8.1: Verify LDS runtime peers (only if LDS is in use)
+
+Run this check **only** if Step 4 found actual usage of any of:
+
+- `lightning/graphql` with real `@wire(graphql)`, `executeMutation`, or
+  graphql-imperative calls
+- `lightning/uiRecordApi` with real `@wire` usage of `getRecord` /
+  `createRecord` / `updateRecord`
+- `lightning/uiObjectInfoApi` with real usage
+
+If none of the above are in the component tree, skip this sub-step
+entirely — the LDS runtime is never loaded and the peers don't matter.
+
+**Why this check exists:** the plugin's `dist/providers/lds/runtime.js`
+statically imports three `@conduit-client/*` packages at build time.
+Depending on the plugin version, these may ship as the plugin's own
+`dependencies`/`optionalDependencies`, or may be left undeclared (as of
+`@salesforce/vite-plugin-lwc-ui-bundle@1.135.0`). The skill does not
+need to know which — it just verifies they are resolvable in the
+consumer's `node_modules` after install, regardless of how they got
+there.
+
+**Check:**
+
+```bash
+node -e "
+  const peers = [
+    '@conduit-client/service-bindings-imperative',
+    '@conduit-client/service-bindings-lwc',
+    '@conduit-client/utils'
+  ];
+  const missing = peers.filter(p => {
+    try { require.resolve(p); return false; }
+    catch { return true; }
+  });
+  if (missing.length) {
+    console.error('Missing LDS runtime peers:', missing.join(', '));
+    process.exit(1);
+  } else {
+    console.log('LDS runtime peers OK');
+  }
+"
+```
+
+**If any are missing**, install the set as consumer `dependencies` (not
+`@salesforce/ui-bundle` — that package does not pull these three
+transitively and installing it does not resolve the error):
+
+```bash
+npm install --save \
+  @conduit-client/service-bindings-imperative@^3 \
+  @conduit-client/service-bindings-lwc@^3 \
+  @conduit-client/utils@^3
+```
+
+Re-run the check. See `references/known-pitfalls.md#13` for the full
+background.
+
+**If all three are already present** (e.g., a future plugin version
+ships them as its own deps, or a sibling package already pulled them
+in), do nothing — no lockfile churn, no duplicate entries.
+
+#### Step 8.2: Build
+
+```bash
 npm run build
 ```
 
@@ -393,15 +532,17 @@ open dist/index.html
 ```
 
 A correctly built `dist/index.html` is typically 100 KB+. A 1-2 KB file
-is the un-inlined stub (see `known-pitfalls.md#7`).
+is the un-inlined stub (see `known-pitfalls.md#6`).
 
 If the build fails, diagnose via `references/known-pitfalls.md`. The most
 frequent issues have symptoms that map directly to specific entries:
 
 - "Cannot find native binding" inside rolldown → pitfall #1 (Node)
 - "No matching version found for \<pkg\>" → pitfall #2 (stale dep pins)
-- Missing `isOpen` / missing `lightning/button` → pitfalls #9 / #7
-- `force/someModule` not resolved → pitfall #10
+- Missing `isOpen` / missing `lightning/button` → pitfalls #8 / #6
+- `force/someModule` not resolved → pitfall #9
+- `Rollup failed to resolve import "@conduit-client/..."` → pitfall #13
+  (LDS runtime peers missing; Step 8.1 was skipped or failed silently)
 - Component renders but unstyled → missing SLDS CSS import in
   `bootstrap.js`
 
@@ -424,8 +565,8 @@ Open `http://localhost:5173` and confirm:
 
 If something renders wrong, check `references/known-pitfalls.md`. The
 most common dev-time issues are graphql wire adapters returning empty
-data (pitfalls #3, #4, #5) and mapper returning `null` on Avro-wrapped
-payloads (#6).
+data (pitfalls #3, #4) and mapper returning `null` on Avro-wrapped
+payloads (#5).
 
 The same compiled `dist/index.html` runs in ChatGPT — the guard in
 `bootstrap.js` ensures local mocks are skipped when the host provides