@salesforce/platform-sdk 12.18.0 → 13.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -0
- package/dist/analytics/index.js +1 -1
- package/dist/{analytics-DtUm3Bhb.js → analytics-BqVdGxvp.js} +1 -1
- package/dist/app/index.js +1 -1
- package/dist/{capabilities-B3Raifjg.js → capabilities-Gf8lYbjH.js} +1 -2
- package/dist/chat/index.d.ts.map +1 -1
- package/dist/chat/index.js +26 -27
- package/dist/chat/mcpapps.d.ts.map +1 -1
- package/dist/core/capabilities.d.ts +2 -2
- package/dist/core/capabilities.d.ts.map +1 -1
- package/dist/core/chat.d.ts +7 -1
- package/dist/core/chat.d.ts.map +1 -1
- package/dist/core/data.d.ts +4 -4
- package/dist/core/index.js +2 -2
- package/dist/core/mcpapps-session.d.ts +8 -9
- package/dist/core/mcpapps-session.d.ts.map +1 -1
- package/dist/core/surface.d.ts +8 -11
- package/dist/core/surface.d.ts.map +1 -1
- package/dist/data/index.d.ts +1 -22
- package/dist/data/index.d.ts.map +1 -1
- package/dist/data/index.js +368 -269
- package/dist/data/mcpapps/index.d.ts +2 -2
- package/dist/data/mcpapps/index.d.ts.map +1 -1
- package/dist/data/telemetry.d.ts +39 -0
- package/dist/data/telemetry.d.ts.map +1 -0
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -3
- package/dist/internal-telemetry/define.d.ts +55 -0
- package/dist/internal-telemetry/define.d.ts.map +1 -0
- package/dist/internal-telemetry/index.d.ts +24 -0
- package/dist/internal-telemetry/index.d.ts.map +1 -0
- package/dist/lightning/index.d.ts.map +1 -1
- package/dist/lightning/index.js +4 -5
- package/dist/{surface-Cg3eyRpj.js → surface-DyglgPiz.js} +43 -48
- package/dist/ui-embedding/session.js +1 -1
- package/dist/view/index.d.ts.map +1 -1
- package/dist/view/index.js +1 -2
- package/docs/data/02-caching-and-freshness.md +3 -3
- package/docs/data/03-reactive-handle-lifecycle.md +2 -2
- package/docs/data/04-surfaces-and-guards.md +20 -8
- package/package.json +12 -11
package/README.md
CHANGED
|
@@ -47,6 +47,24 @@ const result = await sdk.graphql?.query<GetAccountsQuery>({
|
|
|
47
47
|
|
|
48
48
|
The chat, view, lightning, telemetry, and analytics surfaces follow the same pattern — see [Migrating from individual SDK packages](#migrating-from-individual-sdk-packages) for the full set of factories.
|
|
49
49
|
|
|
50
|
+
## MCP Apps host identity
|
|
51
|
+
|
|
52
|
+
Every MCP Apps host uses `Surface.MCPApps`. The Chat SDK exposes the host's raw identity and
|
|
53
|
+
platform when the host supplies them in `ui/initialize`:
|
|
54
|
+
|
|
55
|
+
```ts
|
|
56
|
+
import { createChatSDK } from "@salesforce/platform-sdk";
|
|
57
|
+
|
|
58
|
+
const chat = await createChatSDK();
|
|
59
|
+
const context = chat.getHostContext?.();
|
|
60
|
+
const hostName = context?.hostInfo?.name;
|
|
61
|
+
const hostVersion = context?.hostInfo?.version;
|
|
62
|
+
const platform = context?.platform;
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
See [MCP Apps host migration](./docs/data/04-surfaces-and-guards.md#mcp-apps-host-migration) for
|
|
66
|
+
the surface and Data SDK option changes.
|
|
67
|
+
|
|
50
68
|
## Data SDK extensions
|
|
51
69
|
|
|
52
70
|
Attach reusable APIs under `sdk.ext` with `createDataSDK({ extensions: [...] })`.
|
package/dist/analytics/index.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { registerInstrumentedApp as P } from "o11y/client";
|
|
2
|
-
import { g as S, S as v } from "./surface-
|
|
2
|
+
import { g as S, S as v } from "./surface-DyglgPiz.js";
|
|
3
3
|
import { w as T } from "./sdk-promise-D0sy7OW1.js";
|
|
4
4
|
import { getChatSDK as A } from "./chat/index.js";
|
|
5
5
|
import { r as x } from "./TelemetryUploader-mZWIhtRG.js";
|
package/dist/app/index.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { S as e } from "./surface-
|
|
1
|
+
import { S as e } from "./surface-DyglgPiz.js";
|
|
2
2
|
const s = {
|
|
3
3
|
callTool: !0,
|
|
4
4
|
sendMessageToHost: !0,
|
|
@@ -69,7 +69,6 @@ const s = {
|
|
|
69
69
|
};
|
|
70
70
|
function r(t) {
|
|
71
71
|
switch (t) {
|
|
72
|
-
case e.Claude:
|
|
73
72
|
case e.MCPApps:
|
|
74
73
|
return { ...s };
|
|
75
74
|
case e.OpenAI:
|
package/dist/chat/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chat/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKnD;;;;;;GAMG;AAEH,MAAM,WAAW,cAAe,SAAQ,UAAU;CAAG;AAErD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chat/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKnD;;;;;;GAMG;AAEH,MAAM,WAAW,cAAe,SAAQ,UAAU;CAAG;AAErD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAgCxE;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvE,YAAY,EACX,WAAW,EACX,WAAW,EACX,OAAO,EACP,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,cAAc,EACd,UAAU,EACV,QAAQ,EACR,SAAS,GACT,MAAM,SAAS,CAAC"}
|
package/dist/chat/index.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import { g as c, S as
|
|
1
|
+
import { g as c, S as n, a as d } from "../surface-DyglgPiz.js";
|
|
2
2
|
import { w as p } from "../sdk-promise-D0sy7OW1.js";
|
|
3
3
|
import { requireSharedSession as h } from "../ui-embedding/session.js";
|
|
4
|
-
class
|
|
4
|
+
class r {
|
|
5
5
|
// @ts-expect-error TS6138: `session` is unread until the first method body lands
|
|
6
6
|
constructor(t) {
|
|
7
7
|
this.session = t;
|
|
@@ -9,7 +9,7 @@ class a {
|
|
|
9
9
|
session;
|
|
10
10
|
static async create() {
|
|
11
11
|
const t = await h("EmbeddingChatSDK");
|
|
12
|
-
return new
|
|
12
|
+
return new r(t);
|
|
13
13
|
}
|
|
14
14
|
}
|
|
15
15
|
class f {
|
|
@@ -87,7 +87,7 @@ class f {
|
|
|
87
87
|
*/
|
|
88
88
|
handleToolCancelled(t) {
|
|
89
89
|
const o = t.reason ?? "";
|
|
90
|
-
this.canceledCallbacks.forEach((
|
|
90
|
+
this.canceledCallbacks.forEach((i) => i(o));
|
|
91
91
|
}
|
|
92
92
|
/**
|
|
93
93
|
* Request display mode change from host
|
|
@@ -166,10 +166,10 @@ class f {
|
|
|
166
166
|
* Always returns an object (empty `{}` when no context has been received).
|
|
167
167
|
*/
|
|
168
168
|
getHostContext() {
|
|
169
|
-
const t = this.session.getHostContext(), e = {};
|
|
170
|
-
if (t.theme !== void 0 && (e.theme = t.theme), t.displayMode !== void 0 && (e.displayMode = t.displayMode), t.containerDimensions !== void 0) {
|
|
171
|
-
const
|
|
172
|
-
|
|
169
|
+
const t = this.session.getHostContext(), e = {}, o = this.session.getHostInfo();
|
|
170
|
+
if (o !== void 0 && (e.hostInfo = { ...o }), t.platform !== void 0 && (e.platform = t.platform), t.theme !== void 0 && (e.theme = t.theme), t.displayMode !== void 0 && (e.displayMode = t.displayMode), t.containerDimensions !== void 0) {
|
|
171
|
+
const i = t.containerDimensions.maxHeight ?? t.containerDimensions.height;
|
|
172
|
+
i !== void 0 && (e.maxHeight = i);
|
|
173
173
|
}
|
|
174
174
|
return t.safeAreaInsets !== void 0 && (e.safeArea = t.safeAreaInsets), t.userAgent !== void 0 && (e.userAgent = t.userAgent), t.locale !== void 0 && (e.locale = t.locale), t.deviceCapabilities !== void 0 && (e.deviceCapabilities = t.deviceCapabilities), t.styles !== void 0 && (e.styles = t.styles), e;
|
|
175
175
|
}
|
|
@@ -187,7 +187,7 @@ class f {
|
|
|
187
187
|
this.subscriptions.forEach((t) => t());
|
|
188
188
|
}
|
|
189
189
|
}
|
|
190
|
-
const
|
|
190
|
+
const u = "openai:set_globals";
|
|
191
191
|
class g {
|
|
192
192
|
sendMessageToHost(t) {
|
|
193
193
|
return window.openai.sendFollowUpMessage({ prompt: t.content });
|
|
@@ -223,35 +223,34 @@ class g {
|
|
|
223
223
|
}
|
|
224
224
|
subscribe(t) {
|
|
225
225
|
const e = () => t();
|
|
226
|
-
return window.addEventListener(
|
|
227
|
-
window.removeEventListener(
|
|
226
|
+
return window.addEventListener(u, e), () => {
|
|
227
|
+
window.removeEventListener(u, e);
|
|
228
228
|
};
|
|
229
229
|
}
|
|
230
230
|
}
|
|
231
|
-
let
|
|
232
|
-
function y(
|
|
233
|
-
return
|
|
231
|
+
let a = null, l = null;
|
|
232
|
+
function y(s) {
|
|
233
|
+
return a || (a = b(s).then((t) => (l = t, t))), a;
|
|
234
234
|
}
|
|
235
235
|
function C() {
|
|
236
|
-
return
|
|
236
|
+
return l;
|
|
237
237
|
}
|
|
238
|
-
function
|
|
239
|
-
|
|
238
|
+
function I() {
|
|
239
|
+
a = null, l = null;
|
|
240
240
|
}
|
|
241
|
-
function b(
|
|
241
|
+
function b(s) {
|
|
242
242
|
return p(
|
|
243
243
|
(async () => {
|
|
244
244
|
try {
|
|
245
|
-
switch (await c(
|
|
246
|
-
case
|
|
245
|
+
switch (await c(s?.surface)) {
|
|
246
|
+
case n.OpenAI:
|
|
247
247
|
return new g();
|
|
248
|
-
case
|
|
249
|
-
case
|
|
248
|
+
case n.WebApp:
|
|
249
|
+
case n.Mosaic:
|
|
250
250
|
return {};
|
|
251
|
-
case
|
|
252
|
-
return await
|
|
253
|
-
case
|
|
254
|
-
case s.MCPApps: {
|
|
251
|
+
case n.MicroFrontend:
|
|
252
|
+
return await r.create();
|
|
253
|
+
case n.MCPApps: {
|
|
255
254
|
const e = await d.getInstance();
|
|
256
255
|
return new f(e);
|
|
257
256
|
}
|
|
@@ -270,5 +269,5 @@ export {
|
|
|
270
269
|
b as createChatSDK,
|
|
271
270
|
y as getChatSDK,
|
|
272
271
|
C as getChatSDKSync,
|
|
273
|
-
|
|
272
|
+
I as resetChatSDK
|
|
274
273
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mcpapps.d.ts","sourceRoot":"","sources":["../../src/chat/mcpapps.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACX,OAAO,EACP,WAAW,EACX,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,QAAQ,EACR,SAAS,EACT,WAAW,EACX,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,qBAAa,cAAe,YAAW,OAAO;IAqBjC,OAAO,CAAC,OAAO;IApB3B,OAAO,CAAC,OAAO,CAcR;IACP,OAAO,CAAC,iBAAiB,CAAuC;IAChE,OAAO,CAAC,aAAa,CAAyB;IAE9C,OAAO,CAAC,oBAAoB,CAAK;gBAEb,OAAO,EAAE,cAAc;IAmC3C;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAYvB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,sBAAsB;IAS9B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;;OAIG;IACG,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC;IAOjE,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtD,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ3C,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC;IAOrD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,eAAe,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAOzC,sBAAsB,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAOhD,gBAAgB,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAW1C,kBAAkB,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI;IAWjC,cAAc,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI;IAM7B,mDAAmD;IACnD,uBAAuB,IAAI,MAAM;IAIjC,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI;IAuBlE;;;;;OAKG;IACH,cAAc,IAAI,WAAW;
|
|
1
|
+
{"version":3,"file":"mcpapps.d.ts","sourceRoot":"","sources":["../../src/chat/mcpapps.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACX,OAAO,EACP,WAAW,EACX,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,QAAQ,EACR,SAAS,EACT,WAAW,EACX,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,qBAAa,cAAe,YAAW,OAAO;IAqBjC,OAAO,CAAC,OAAO;IApB3B,OAAO,CAAC,OAAO,CAcR;IACP,OAAO,CAAC,iBAAiB,CAAuC;IAChE,OAAO,CAAC,aAAa,CAAyB;IAE9C,OAAO,CAAC,oBAAoB,CAAK;gBAEb,OAAO,EAAE,cAAc;IAmC3C;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAYvB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,sBAAsB;IAS9B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;;OAIG;IACG,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC;IAOjE,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtD,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ3C,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC;IAOrD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,eAAe,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAOzC,sBAAsB,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAOhD,gBAAgB,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAW1C,kBAAkB,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI;IAWjC,cAAc,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI;IAM7B,mDAAmD;IACnD,uBAAuB,IAAI,MAAM;IAIjC,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI;IAuBlE;;;;;OAKG;IACH,cAAc,IAAI,WAAW;IA2C7B,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAS9D,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAQ3C,OAAO,CAAC,iBAAiB;CAGzB"}
|
|
@@ -45,8 +45,8 @@ export interface SurfaceCapabilities {
|
|
|
45
45
|
subscribe: boolean;
|
|
46
46
|
/**
|
|
47
47
|
* True when the surface implements `getToolResultGeneration`. Only
|
|
48
|
-
*
|
|
49
|
-
*
|
|
48
|
+
* MCP Apps hosts that stream distinct tool results into one instance
|
|
49
|
+
* implement it.
|
|
50
50
|
*
|
|
51
51
|
* @remarks
|
|
52
52
|
* This field is optional so that adding it does not break existing
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/core/capabilities.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAEnC,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB;;;;;;;;;OASG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB;;;;;;;;;OASG;IACH,0BAA0B,EAAE,OAAO,CAAC;IACpC,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAG/B,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAElB,MAAM,EAAE,OAAO,CAAC;CAChB;AA6ED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,
|
|
1
|
+
{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/core/capabilities.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAEnC,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB;;;;;;;;;OASG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB;;;;;;;;;OASG;IACH,0BAA0B,EAAE,OAAO,CAAC;IACpC,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAG/B,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAElB,MAAM,EAAE,OAAO,CAAC;CAChB;AA6ED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,CAY5E"}
|
package/dist/core/chat.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { McpAppsHostInfo } from './mcpapps-session';
|
|
1
2
|
import { ThemeMode } from './view';
|
|
2
3
|
/**
|
|
3
4
|
* The message payload for a chat stream.
|
|
@@ -140,6 +141,10 @@ export interface HostStyles {
|
|
|
140
141
|
* configuration.
|
|
141
142
|
*/
|
|
142
143
|
export interface HostContext {
|
|
144
|
+
/** The host identity from the MCP Apps handshake. */
|
|
145
|
+
hostInfo?: McpAppsHostInfo;
|
|
146
|
+
/** The host platform. */
|
|
147
|
+
platform?: "web" | "desktop" | "mobile";
|
|
143
148
|
/** The current theme mode. */
|
|
144
149
|
theme?: ThemeMode;
|
|
145
150
|
/** The current display mode of the widget. */
|
|
@@ -286,7 +291,8 @@ export interface ChatSDK {
|
|
|
286
291
|
*
|
|
287
292
|
* @remarks
|
|
288
293
|
* Returns environment information from the host surface, including the
|
|
289
|
-
* display mode, theme, locale, dimensions, and
|
|
294
|
+
* host identity, platform, display mode, theme, locale, dimensions, and
|
|
295
|
+
* device capabilities.
|
|
290
296
|
* Returns an empty object when the host has not provided context
|
|
291
297
|
* information.
|
|
292
298
|
*
|
package/dist/core/chat.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/core/chat.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/core/chat.ts"],"names":[],"mappings":"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"}
|
package/dist/core/data.d.ts
CHANGED
|
@@ -120,7 +120,7 @@ export type QuerySubscriber<T> = (snapshot: QuerySnapshot<T>) => void;
|
|
|
120
120
|
* later snapshots. `refresh` re-issues the underlying request, bypasses
|
|
121
121
|
* the cache where one exists, and propagates the result to subscribers.
|
|
122
122
|
*
|
|
123
|
-
* On uncached surfaces (Mosaic, OpenAI,
|
|
123
|
+
* On uncached surfaces (Mosaic, OpenAI, MCPApps), `subscribe` emits only in
|
|
124
124
|
* response to `refresh()`, because there is no cache to push background
|
|
125
125
|
* updates.
|
|
126
126
|
*
|
|
@@ -134,7 +134,7 @@ export interface QueryResult<T> extends QuerySnapshot<T> {
|
|
|
134
134
|
*
|
|
135
135
|
* @remarks
|
|
136
136
|
* This method never rejects. A failed re-fetch does not throw on the
|
|
137
|
-
* awaited `refresh()` call. On uncached surfaces (Mosaic, OpenAI,
|
|
137
|
+
* awaited `refresh()` call. On uncached surfaces (Mosaic, OpenAI, MCPApps), the
|
|
138
138
|
* method delivers the failure to `subscribe()` callbacks as a
|
|
139
139
|
* {@link QuerySnapshot} with a populated `errors` array. On cached
|
|
140
140
|
* surfaces (WebApp), a failed re-fetch is not observable on the
|
|
@@ -274,7 +274,7 @@ export interface DataSDKGraphQL {
|
|
|
274
274
|
* `refresh` re-issues the request, bypasses the cache where one
|
|
275
275
|
* exists, and propagates the result to subscribers.
|
|
276
276
|
*
|
|
277
|
-
* On uncached surfaces (Mosaic, OpenAI,
|
|
277
|
+
* On uncached surfaces (Mosaic, OpenAI, MCPApps), `subscribe` is real, but it
|
|
278
278
|
* emits only in response to `refresh()`. There is no cache to push
|
|
279
279
|
* background updates, so `refresh()` is the sole source of new
|
|
280
280
|
* snapshots, and each call costs one network request.
|
|
@@ -364,7 +364,7 @@ export interface DataSDK {
|
|
|
364
364
|
*
|
|
365
365
|
* @remarks
|
|
366
366
|
* This field is present on URL-backed adapters whose request paths
|
|
367
|
-
* derive from a concrete version, including
|
|
367
|
+
* derive from a concrete version, including MCPApps dispatch paths.
|
|
368
368
|
* OpenAI and degraded surfaces may omit it.
|
|
369
369
|
*/
|
|
370
370
|
readonly apiVersion?: string;
|
package/dist/core/index.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { M as r, a as s, S as i, g as p, i as f, b as o, r as t } from "../surface-
|
|
2
|
-
import { g as c } from "../capabilities-
|
|
1
|
+
import { M as r, a as s, S as i, g as p, i as f, b as o, r as t } from "../surface-DyglgPiz.js";
|
|
2
|
+
import { g as c } from "../capabilities-Gf8lYbjH.js";
|
|
3
3
|
import { w as g } from "../sdk-promise-D0sy7OW1.js";
|
|
4
4
|
export {
|
|
5
5
|
r as McpAppsNotAvailableError,
|
|
@@ -9,6 +9,8 @@ import { ThemeMode } from './view';
|
|
|
9
9
|
* classes map these fields to their own protocol-agnostic types.
|
|
10
10
|
*/
|
|
11
11
|
export interface McpAppsHostContext {
|
|
12
|
+
/** The host platform. */
|
|
13
|
+
platform?: "web" | "desktop" | "mobile";
|
|
12
14
|
/** The theme mode that the host provides. */
|
|
13
15
|
theme?: ThemeMode;
|
|
14
16
|
/** The display mode of the widget. */
|
|
@@ -84,17 +86,14 @@ export interface McpAppsSessionOptions {
|
|
|
84
86
|
handshakeTimeoutMs?: number;
|
|
85
87
|
}
|
|
86
88
|
/**
|
|
87
|
-
* The error that the SDK throws when
|
|
88
|
-
*
|
|
89
|
-
* succeeded.
|
|
89
|
+
* The error that the SDK throws when a forced MCP Apps surface requires a
|
|
90
|
+
* SEP-1865 `ui/initialize` handshake that has not succeeded.
|
|
90
91
|
*
|
|
91
92
|
* @remarks
|
|
92
|
-
*
|
|
93
|
-
*
|
|
94
|
-
*
|
|
95
|
-
*
|
|
96
|
-
* never yields MCPApps or Claude without a live handshake, so the
|
|
97
|
-
* no-override path cannot raise this error. This mirrors
|
|
93
|
+
* An `options.surface` override bypasses detection, so the handshake may
|
|
94
|
+
* run for the first time during verification. Detection only yields an MCP
|
|
95
|
+
* Apps surface after a live handshake, so the no-override path cannot raise
|
|
96
|
+
* this error. This mirrors
|
|
98
97
|
* {@link SfEmbeddingNotAvailableError} for the MicroFrontend surface.
|
|
99
98
|
*/
|
|
100
99
|
export declare class McpAppsNotAvailableError extends Error {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mcpapps-session.d.ts","sourceRoot":"","sources":["../../src/core/mcpapps-session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAA8B,MAAM,qBAAqB,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IAClC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,sCAAsC;IACtC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,gCAAgC;IAChC,mBAAmB,CAAC,EAAE;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,2CAA2C;IAC3C,cAAc,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9E,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,kBAAkB,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC1D,2FAA2F;IAC3F,QAAQ,CAAC,EAAE;QACV,mDAAmD;QACnD,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACrB,gCAAgC;QAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC9B,CAAC;IACF,sHAAsH;IACtH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5C,sFAAsF;IACtF,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvD,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,qHAAqH;IACrH,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtD,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C,sEAAsE;IACtE,MAAM,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC/B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACrC;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED
|
|
1
|
+
{"version":3,"file":"mcpapps-session.d.ts","sourceRoot":"","sources":["../../src/core/mcpapps-session.ts"],"names":[],"mappings":"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"}
|
package/dist/core/surface.d.ts
CHANGED
|
@@ -7,8 +7,7 @@ export declare enum Surface {
|
|
|
7
7
|
MicroFrontend = "Micro-Frontend",
|
|
8
8
|
OpenAI = "OpenAI",
|
|
9
9
|
MCPApps = "MCP-Apps",
|
|
10
|
-
Mosaic = "Mosaic"
|
|
11
|
-
Claude = "Claude"
|
|
10
|
+
Mosaic = "Mosaic"
|
|
12
11
|
}
|
|
13
12
|
/**
|
|
14
13
|
* The options for the one-time {@link initialize} lifecycle call.
|
|
@@ -100,14 +99,12 @@ export declare function isSfEmbeddingIframe(): boolean;
|
|
|
100
99
|
* `initialize({ mcpApps })` would not throw. See the W-23083001 review
|
|
101
100
|
* feedback.
|
|
102
101
|
*
|
|
103
|
-
* Only the `override` path adds a verification check
|
|
104
|
-
*
|
|
105
|
-
*
|
|
106
|
-
* {@link
|
|
107
|
-
*
|
|
108
|
-
*
|
|
109
|
-
* check, because {@link detectSurface} only yields MCPApps or Claude
|
|
110
|
-
* after a successful handshake. The {@link McpAppsSession.getInstance}
|
|
102
|
+
* Only the `override` path adds a verification check for MCP Apps surfaces.
|
|
103
|
+
* An override bypasses detection's result, so a caller that forces one
|
|
104
|
+
* may not have a vetted handshake. When the handshake has not succeeded,
|
|
105
|
+
* this function throws {@link McpAppsNotAvailableError}. The detection
|
|
106
|
+
* path needs no extra check, because {@link detectSurface} only yields an
|
|
107
|
+
* MCP Apps surface after a successful handshake. The {@link McpAppsSession.getInstance}
|
|
111
108
|
* call is memoized and shared with detection, so in a real MCP Apps iframe this
|
|
112
109
|
* reuses the session that detection already built, with no second
|
|
113
110
|
* handshake. This centralizes the liveness check that the SDK factories
|
|
@@ -118,7 +115,7 @@ export declare function isSfEmbeddingIframe(): boolean;
|
|
|
118
115
|
* @param override - The explicit surface that overrides the detected
|
|
119
116
|
* result. Detection itself still runs once, to claim the lifecycle.
|
|
120
117
|
* @returns The verified surface.
|
|
121
|
-
* @throws {McpAppsNotAvailableError} When
|
|
118
|
+
* @throws {McpAppsNotAvailableError} When an MCP Apps surface is required
|
|
122
119
|
* but the handshake has not succeeded.
|
|
123
120
|
*/
|
|
124
121
|
export declare function getVerifiedSurface(override?: Surface): Promise<Surface>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../src/core/surface.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;GAEG;AACH,oBAAY,OAAO;IAClB,MAAM,WAAW;IACjB,aAAa,mBAAmB;IAChC,MAAM,WAAW;IACjB,OAAO,aAAa;IACpB,MAAM,WAAW;
|
|
1
|
+
{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../src/core/surface.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;GAEG;AACH,oBAAY,OAAO;IAClB,MAAM,WAAW;IACjB,aAAa,mBAAmB;IAChC,MAAM,WAAW;IACjB,OAAO,aAAa;IACpB,MAAM,WAAW;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IACjC;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAsID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CA0B9E;AAoBD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAU7C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAoC7E"}
|
package/dist/data/index.d.ts
CHANGED
|
@@ -36,22 +36,6 @@ export interface WebAppDataSDKOptions {
|
|
|
36
36
|
apiVersion?: string;
|
|
37
37
|
}
|
|
38
38
|
export type { MosaicDataSDKOptions };
|
|
39
|
-
/**
|
|
40
|
-
* Options for the Claude surface.
|
|
41
|
-
*
|
|
42
|
-
* @remarks
|
|
43
|
-
* Pass these as `DataSDKOptions.claude`. Session configuration belongs to `initialize`, not this
|
|
44
|
-
* option bag.
|
|
45
|
-
*
|
|
46
|
-
* @see docs/data/04-surfaces-and-guards.md
|
|
47
|
-
*/
|
|
48
|
-
export interface ClaudeDataSDKOptions {
|
|
49
|
-
/**
|
|
50
|
-
* The Salesforce API version used for dispatch.
|
|
51
|
-
* @example "66.0"
|
|
52
|
-
*/
|
|
53
|
-
apiVersion?: string;
|
|
54
|
-
}
|
|
55
39
|
/**
|
|
56
40
|
* Options for the MCP Apps surface.
|
|
57
41
|
*
|
|
@@ -126,7 +110,7 @@ export type DataSDKWithExtensions<Extensions extends ExtensionsFor<DataSDK>> = E
|
|
|
126
110
|
* Options for creating a DataSDK instance.
|
|
127
111
|
*
|
|
128
112
|
* @remarks
|
|
129
|
-
* These options cover surface selection, the per-surface option bags (`webapp`, `mosaic`, `
|
|
113
|
+
* These options cover surface selection, the per-surface option bags (`webapp`, `mosaic`, `mcpApps`), and
|
|
130
114
|
* any `extensions`.
|
|
131
115
|
*
|
|
132
116
|
* @see docs/data/04-surfaces-and-guards.md
|
|
@@ -142,11 +126,6 @@ export interface DataSDKOptions extends SDKOptions {
|
|
|
142
126
|
* @example { instanceUrl: "https://my.salesforce.com", accessToken: "00D..." }
|
|
143
127
|
*/
|
|
144
128
|
mosaic?: MosaicDataSDKOptions;
|
|
145
|
-
/**
|
|
146
|
-
* Claude-surface options.
|
|
147
|
-
* @example { apiVersion: "66.0" }
|
|
148
|
-
*/
|
|
149
|
-
claude?: ClaudeDataSDKOptions;
|
|
150
129
|
/**
|
|
151
130
|
* MCP Apps-surface options.
|
|
152
131
|
* @example { apiVersion: "66.0" }
|
package/dist/data/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACX,OAAO,EACP,WAAW,EACX,SAAS,EACT,aAAa,EACb,WAAW,EACX,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"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"}
|