@salesforce/metadata-core-sdk 1.7.0 → 1.9.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.
Files changed (59) hide show
  1. package/README.md +61 -1
  2. package/dist/index.d.ts +6 -2
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/index.js +8 -1
  5. package/dist/index.js.map +1 -1
  6. package/dist/sdk/hooks/vibe-edit/selection/selectionTelemetry.d.ts +34 -0
  7. package/dist/sdk/hooks/vibe-edit/selection/selectionTelemetry.d.ts.map +1 -0
  8. package/dist/sdk/hooks/vibe-edit/selection/selectionTelemetry.js +64 -0
  9. package/dist/sdk/hooks/vibe-edit/selection/selectionTelemetry.js.map +1 -0
  10. package/dist/sdk/hooks/vibe-edit/ui/MarqueeSelection.css +5 -0
  11. package/dist/sdk/hooks/vibe-edit/ui/MarqueeSelection.d.ts.map +1 -1
  12. package/dist/sdk/hooks/vibe-edit/ui/MarqueeSelection.js +39 -2
  13. package/dist/sdk/hooks/vibe-edit/ui/MarqueeSelection.js.map +1 -1
  14. package/dist/sdk/hooks/vibe-edit/ui/VibeEditPanel.d.ts +5 -0
  15. package/dist/sdk/hooks/vibe-edit/ui/VibeEditPanel.d.ts.map +1 -1
  16. package/dist/sdk/hooks/vibe-edit/ui/VibeEditPanel.js +9 -7
  17. package/dist/sdk/hooks/vibe-edit/ui/VibeEditPanel.js.map +1 -1
  18. package/dist/sdk/hooks/vibe-edit/ui/composer/VibeEditComposer.css +460 -0
  19. package/dist/sdk/hooks/vibe-edit/ui/composer/VibeEditComposer.d.ts +71 -0
  20. package/dist/sdk/hooks/vibe-edit/ui/composer/VibeEditComposer.d.ts.map +1 -0
  21. package/dist/sdk/hooks/vibe-edit/ui/composer/VibeEditComposer.js +461 -0
  22. package/dist/sdk/hooks/vibe-edit/ui/composer/VibeEditComposer.js.map +1 -0
  23. package/dist/sdk/hooks/vibe-edit/ui/composer/composerPlacement.d.ts +19 -0
  24. package/dist/sdk/hooks/vibe-edit/ui/composer/composerPlacement.d.ts.map +1 -0
  25. package/dist/sdk/hooks/vibe-edit/ui/composer/composerPlacement.js +23 -0
  26. package/dist/sdk/hooks/vibe-edit/ui/composer/composerPlacement.js.map +1 -0
  27. package/dist/sdk/hooks/vibe-edit/ui/composer/composerPlacement.test.d.ts +8 -0
  28. package/dist/sdk/hooks/vibe-edit/ui/composer/composerPlacement.test.d.ts.map +1 -0
  29. package/dist/sdk/hooks/vibe-edit/ui/composer/composerPlacement.test.js +33 -0
  30. package/dist/sdk/hooks/vibe-edit/ui/composer/composerPlacement.test.js.map +1 -0
  31. package/dist/sdk/hooks/vibe-edit/ui/composer/iconPaths.d.ts +12 -0
  32. package/dist/sdk/hooks/vibe-edit/ui/composer/iconPaths.d.ts.map +1 -0
  33. package/dist/sdk/hooks/vibe-edit/ui/composer/iconPaths.js +29 -0
  34. package/dist/sdk/hooks/vibe-edit/ui/composer/iconPaths.js.map +1 -0
  35. package/dist/sdk/hooks/vibe-edit/ui/useVibeEdit.d.ts +10 -0
  36. package/dist/sdk/hooks/vibe-edit/ui/useVibeEdit.d.ts.map +1 -1
  37. package/dist/sdk/hooks/vibe-edit/ui/useVibeEdit.js +279 -23
  38. package/dist/sdk/hooks/vibe-edit/ui/useVibeEdit.js.map +1 -1
  39. package/dist/sdk/utils/HostCommunicationUtils.d.ts +41 -1
  40. package/dist/sdk/utils/HostCommunicationUtils.d.ts.map +1 -1
  41. package/dist/sdk/utils/HostCommunicationUtils.js +115 -20
  42. package/dist/sdk/utils/HostCommunicationUtils.js.map +1 -1
  43. package/dist/sdk/utils/telemetry/telemetryBuffer.d.ts +54 -0
  44. package/dist/sdk/utils/telemetry/telemetryBuffer.d.ts.map +1 -0
  45. package/dist/sdk/utils/telemetry/telemetryBuffer.js +163 -0
  46. package/dist/sdk/utils/telemetry/telemetryBuffer.js.map +1 -0
  47. package/dist/sdk/utils/telemetry/telemetryEvents.d.ts +60 -0
  48. package/dist/sdk/utils/telemetry/telemetryEvents.d.ts.map +1 -0
  49. package/dist/sdk/utils/telemetry/telemetryEvents.js +243 -0
  50. package/dist/sdk/utils/telemetry/telemetryEvents.js.map +1 -0
  51. package/dist/sdk/utils/telemetry/telemetryRelay.d.ts +63 -0
  52. package/dist/sdk/utils/telemetry/telemetryRelay.d.ts.map +1 -0
  53. package/dist/sdk/utils/telemetry/telemetryRelay.js +64 -0
  54. package/dist/sdk/utils/telemetry/telemetryRelay.js.map +1 -0
  55. package/dist/sdk/webviewMessageTypes.d.ts +51 -7
  56. package/dist/sdk/webviewMessageTypes.d.ts.map +1 -1
  57. package/dist/sdk/webviewMessageTypes.js +10 -0
  58. package/dist/sdk/webviewMessageTypes.js.map +1 -1
  59. package/package.json +1 -1
@@ -0,0 +1,243 @@
1
+ /**
2
+ * Copyright (c) 2026, Salesforce, Inc.
3
+ * All rights reserved.
4
+ * Licensed under the BSD 3-Clause license.
5
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
6
+ **/
7
+ /**
8
+ * Schema and strict validator for the iframe -> host TELEMETRY_EVENT message.
9
+ *
10
+ * The payload mirrors `ITelemetry.sendEvent(name, properties, measurements)` so a
11
+ * host can forward a validated event without reshaping it. Every property value
12
+ * comes from a closed list and every measurement is a bounded integer, so a
13
+ * payload can never carry free-form text (prompt text, api names, paths, ids).
14
+ *
15
+ * Node-safe on purpose: no React, no CSS, no `window`. This module is exported
16
+ * from the React-free main barrel and is imported by hosts.
17
+ */
18
+ export const TELEMETRY_SCHEMA_VERSION = 1;
19
+ export const TELEMETRY_EVENT_NAMES = [
20
+ 'vibeEdit.selectMode',
21
+ 'vibeEdit.selection',
22
+ 'vibeEdit.promptAbandoned',
23
+ ];
24
+ export const SELECT_MODE_ACTIONS = ['enter', 'exit'];
25
+ export const SELECTION_ACTIONS = ['add', 'remove'];
26
+ /**
27
+ * `SelectableNode.type` values emitted by the first-party plugins, plus the
28
+ * `'other'` fallback. Anything outside this list is bucketed to `'other'` by
29
+ * `toElementTypeBucket` (iframe side) and by `parseTelemetryEvent` (host side),
30
+ * so a third-party plugin's custom type, or a type added after this host shipped,
31
+ * is counted but never named.
32
+ *
33
+ * Keep in step with the plugins repo: Flow emits its `FlowNodeKind`, Permission
34
+ * set emits its named-access section keys, Agent emits the types below. Every
35
+ * entry adds up to two buckets per flush (add and remove), so the default of
36
+ * `TelemetryRateLimiter` must stay above `2 * SELECTION_ELEMENT_TYPES.length`.
37
+ */
38
+ export const SELECTION_ELEMENT_TYPES = [
39
+ // Agent
40
+ 'agent',
41
+ 'start-agent',
42
+ 'subagent',
43
+ 'topic',
44
+ 'system-instructions',
45
+ 'reasoning',
46
+ 'reasoning-action',
47
+ 'action',
48
+ 'action-target',
49
+ 'action-input',
50
+ 'action-output',
51
+ 'messages',
52
+ 'description',
53
+ 'heading',
54
+ // Flow (rows and stage steps, then FlowNodeKind minus the non-selectable end/group)
55
+ 'step',
56
+ 'detail',
57
+ 'start',
58
+ 'screen',
59
+ 'apexAction',
60
+ 'apexPluginCall',
61
+ 'emailAction',
62
+ 'externalCallout',
63
+ 'routeWork',
64
+ 'addScreenPop',
65
+ 'addSkillRequirement',
66
+ 'checkAvailability',
67
+ 'setScreenProperty',
68
+ 'assignment',
69
+ 'addPromptInstructions',
70
+ 'decision',
71
+ 'loop',
72
+ 'recordCreate',
73
+ 'recordLookup',
74
+ 'recordUpdate',
75
+ 'recordDelete',
76
+ 'recordRollback',
77
+ 'subflow',
78
+ 'wait',
79
+ 'collectionProcessor',
80
+ 'collectionSort',
81
+ 'transform',
82
+ 'customError',
83
+ 'stage',
84
+ 'interactiveStep',
85
+ 'managedContentStep',
86
+ // Permission set
87
+ 'permissionset',
88
+ 'objectPermission',
89
+ 'fieldPermission',
90
+ 'recordTypeVisibility',
91
+ 'tabSetting',
92
+ 'apexClassAccesses',
93
+ 'pageAccesses',
94
+ 'flowAccesses',
95
+ 'agentAccesses',
96
+ 'customPermissions',
97
+ 'customMetadataTypeAccesses',
98
+ 'customSettingAccesses',
99
+ 'externalDataSourceAccesses',
100
+ 'externalCredentialPrincipalAccesses',
101
+ 'servicePresenceStatusAccesses',
102
+ 'emailRoutingAddressAccesses',
103
+ 'genComputingSummaryDefAccesses',
104
+ 'userPermissions',
105
+ 'applicationVisibilities',
106
+ // Schema
107
+ 'object',
108
+ 'field',
109
+ // Flexipage
110
+ 'region',
111
+ 'block',
112
+ 'dataProvider',
113
+ // Fallback
114
+ 'other',
115
+ ];
116
+ export const BOOLEAN_STRINGS = ['true', 'false'];
117
+ /** Upper bound for every count measurement. */
118
+ export const MAX_TELEMETRY_COUNT = 10000;
119
+ /** One table drives both the emitters' type buckets and the host validator. */
120
+ const SCHEMA = {
121
+ 'vibeEdit.selectMode': {
122
+ properties: { action: SELECT_MODE_ACTIONS },
123
+ measurements: {},
124
+ },
125
+ 'vibeEdit.selection': {
126
+ properties: { action: SELECTION_ACTIONS, elementType: SELECTION_ELEMENT_TYPES },
127
+ measurements: { count: { min: 1, max: MAX_TELEMETRY_COUNT } },
128
+ fallbacks: { elementType: 'other' },
129
+ },
130
+ 'vibeEdit.promptAbandoned': {
131
+ properties: { hadText: BOOLEAN_STRINGS },
132
+ measurements: { attachmentCount: { min: 0, max: MAX_TELEMETRY_COUNT } },
133
+ },
134
+ };
135
+ const EVENT_NAME_SET = new Set(TELEMETRY_EVENT_NAMES);
136
+ const ELEMENT_TYPE_SET = new Set(SELECTION_ELEMENT_TYPES);
137
+ const TOP_LEVEL_KEYS = ['schemaVersion', 'name', 'properties', 'measurements'];
138
+ function isPlainObject(value) {
139
+ if (value === null || typeof value !== 'object' || Array.isArray(value)) {
140
+ return false;
141
+ }
142
+ const prototype = Reflect.getPrototypeOf(value);
143
+ return prototype === Object.prototype || prototype === null;
144
+ }
145
+ /**
146
+ * Snapshot of an object's own data properties, or null unless its keys are
147
+ * exactly `allowed`. Accessor properties and symbol keys are rejected, so the
148
+ * validated values cannot change between the check and the use.
149
+ */
150
+ function snapshotExactKeys(value, allowed) {
151
+ const keys = Reflect.ownKeys(value);
152
+ if (keys.length !== allowed.length) {
153
+ return null;
154
+ }
155
+ const snapshot = {};
156
+ for (const key of keys) {
157
+ if (typeof key !== 'string' || !allowed.includes(key)) {
158
+ return null;
159
+ }
160
+ const descriptor = Reflect.getOwnPropertyDescriptor(value, key);
161
+ if (!descriptor || !('value' in descriptor)) {
162
+ return null;
163
+ }
164
+ snapshot[key] = descriptor.value;
165
+ }
166
+ return snapshot;
167
+ }
168
+ /**
169
+ * Strict host-side check of an iframe TELEMETRY_EVENT payload. Returns a fresh,
170
+ * validated copy, or null. Nothing is coerced except a string `elementType`
171
+ * outside the closed list, which becomes `'other'` (the schema's `fallbacks`), so
172
+ * the copy still only holds closed-list values. Any other deviation from the
173
+ * schema (unknown name, extra or missing key, out-of-list value, non-string
174
+ * value, non-integer or out-of-range measurement) is rejected. Never throws, even
175
+ * on hostile input (proxies, throwing getters).
176
+ */
177
+ export function parseTelemetryEvent(value) {
178
+ try {
179
+ if (!isPlainObject(value)) {
180
+ return null;
181
+ }
182
+ const top = snapshotExactKeys(value, TOP_LEVEL_KEYS);
183
+ if (!top || top.schemaVersion !== TELEMETRY_SCHEMA_VERSION) {
184
+ return null;
185
+ }
186
+ const name = top.name;
187
+ if (typeof name !== 'string' || !EVENT_NAME_SET.has(name)) {
188
+ return null;
189
+ }
190
+ const schema = SCHEMA[name];
191
+ if (!isPlainObject(top.properties) || !isPlainObject(top.measurements)) {
192
+ return null;
193
+ }
194
+ const properties = snapshotExactKeys(top.properties, Object.keys(schema.properties));
195
+ const measurements = snapshotExactKeys(top.measurements, Object.keys(schema.measurements));
196
+ if (!properties || !measurements) {
197
+ return null;
198
+ }
199
+ const cleanProperties = {};
200
+ for (const [key, allowedValues] of Object.entries(schema.properties)) {
201
+ const propertyValue = properties[key];
202
+ if (typeof propertyValue !== 'string') {
203
+ return null;
204
+ }
205
+ if (allowedValues.includes(propertyValue)) {
206
+ cleanProperties[key] = propertyValue;
207
+ continue;
208
+ }
209
+ const fallback = schema.fallbacks?.[key];
210
+ if (fallback === undefined) {
211
+ return null;
212
+ }
213
+ cleanProperties[key] = fallback;
214
+ }
215
+ const cleanMeasurements = {};
216
+ for (const [key, range] of Object.entries(schema.measurements)) {
217
+ const measurementValue = measurements[key];
218
+ if (typeof measurementValue !== 'number' ||
219
+ !Number.isInteger(measurementValue) ||
220
+ measurementValue < range.min ||
221
+ measurementValue > range.max) {
222
+ return null;
223
+ }
224
+ cleanMeasurements[key] = measurementValue;
225
+ }
226
+ return {
227
+ schemaVersion: TELEMETRY_SCHEMA_VERSION,
228
+ name: name,
229
+ properties: cleanProperties,
230
+ measurements: cleanMeasurements,
231
+ };
232
+ }
233
+ catch {
234
+ return null;
235
+ }
236
+ }
237
+ /** Emitter side: map any element type to a closed bucket (unknown -> 'other'). */
238
+ export function toElementTypeBucket(type) {
239
+ return typeof type === 'string' && ELEMENT_TYPE_SET.has(type)
240
+ ? type
241
+ : 'other';
242
+ }
243
+ //# sourceMappingURL=telemetryEvents.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"telemetryEvents.js","sourceRoot":"","sources":["../../../../src/sdk/utils/telemetry/telemetryEvents.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,63 @@
1
+ /**
2
+ * Copyright (c) 2026, Salesforce, Inc.
3
+ * All rights reserved.
4
+ * Licensed under the BSD 3-Clause license.
5
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
6
+ **/
7
+ /**
8
+ * Host-side relay for the iframe TELEMETRY_EVENT message.
9
+ *
10
+ * The iframe is host-agnostic: it emits the same events whether it runs in VS
11
+ * Code, Builder Central or any other embedder. Each host turns those events into
12
+ * analytics by passing the received payload to `relayTelemetryEvent` with its own
13
+ * `ITelemetry`-shaped sink, so the rules (rate limit, strict validation, host
14
+ * attribution that the iframe cannot override) live here in tested code instead of
15
+ * being re-implemented per host.
16
+ *
17
+ * Node-safe and free of `window`, so any host runtime can import it.
18
+ */
19
+ import type { ITelemetry } from '../../abstractions/services/ITelemetry.js';
20
+ /** The part of `ITelemetry` the relay needs. */
21
+ export type TelemetrySink = Pick<ITelemetry, 'sendEvent'>;
22
+ export type RelayResult = 'forwarded' | 'invalid' | 'rate_limited';
23
+ /**
24
+ * Sliding-window rate limiter. A host creates one per render target (VS Code) or
25
+ * per iframe (browser hosts) so a misbehaving page cannot flood the sink.
26
+ *
27
+ * The default of 300 per minute leaves room for the worst-case selection flush,
28
+ * which emits one bucket per (add/remove, element type) pair, plus the
29
+ * select-mode and abandon events around it. A single iframe renders one plugin,
30
+ * so a real flush is well below the worst case; the headroom covers a few flushes
31
+ * inside one window (leaving select mode, page hide, the 20 second timer).
32
+ */
33
+ export declare class TelemetryRateLimiter {
34
+ private readonly maxEvents;
35
+ private readonly windowMs;
36
+ private readonly now;
37
+ private readonly timestamps;
38
+ constructor(maxEvents?: number, windowMs?: number, now?: () => number);
39
+ /** Returns false once the budget for the current window is spent. */
40
+ tryAcquire(): boolean;
41
+ }
42
+ export interface RelayTelemetryOptions {
43
+ /** Where validated events go, typically the host's `ITelemetry`. */
44
+ sink: TelemetrySink;
45
+ /**
46
+ * Properties the host derives from its own state (for example `pluginId`).
47
+ * Spread last, so a host value always wins over anything from the iframe.
48
+ */
49
+ hostProperties: Record<string, string>;
50
+ /** Rate limit applied before the payload is parsed. Hosts should pass one. */
51
+ limiter?: TelemetryRateLimiter;
52
+ }
53
+ /**
54
+ * Validates an iframe TELEMETRY_EVENT payload and forwards it to the host's sink.
55
+ *
56
+ * Order: rate limit, then `parseTelemetryEvent`, then
57
+ * `sink.sendEvent(name, { ...properties, ...hostProperties }, measurements)`.
58
+ * Never throws: a sink that throws is swallowed and reported as `'invalid'`. The
59
+ * relay does not log; the caller decides what to log from the result. Never echo
60
+ * anything back to the iframe.
61
+ */
62
+ export declare function relayTelemetryEvent(payload: unknown, options: RelayTelemetryOptions): RelayResult;
63
+ //# sourceMappingURL=telemetryRelay.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"telemetryRelay.d.ts","sourceRoot":"","sources":["../../../../src/sdk/utils/telemetry/telemetryRelay.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2CAA2C,CAAC;AAG5E,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAE1D,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,cAAc,CAAC;AAEnE;;;;;;;;;GASG;AACH,qBAAa,oBAAoB;IAI7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IALtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;gBAGxB,SAAS,GAAE,MAAY,EACvB,QAAQ,GAAE,MAAe,EACzB,GAAG,GAAE,MAAM,MAAiB;IAG/C,qEAAqE;IACrE,UAAU,IAAI,OAAO;CAYtB;AAED,MAAM,WAAW,qBAAqB;IACpC,oEAAoE;IACpE,IAAI,EAAE,aAAa,CAAC;IACpB;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,WAAW,CAkBjG"}
@@ -0,0 +1,64 @@
1
+ /**
2
+ * Copyright (c) 2026, Salesforce, Inc.
3
+ * All rights reserved.
4
+ * Licensed under the BSD 3-Clause license.
5
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
6
+ **/
7
+ import { parseTelemetryEvent } from './telemetryEvents.js';
8
+ /**
9
+ * Sliding-window rate limiter. A host creates one per render target (VS Code) or
10
+ * per iframe (browser hosts) so a misbehaving page cannot flood the sink.
11
+ *
12
+ * The default of 300 per minute leaves room for the worst-case selection flush,
13
+ * which emits one bucket per (add/remove, element type) pair, plus the
14
+ * select-mode and abandon events around it. A single iframe renders one plugin,
15
+ * so a real flush is well below the worst case; the headroom covers a few flushes
16
+ * inside one window (leaving select mode, page hide, the 20 second timer).
17
+ */
18
+ export class TelemetryRateLimiter {
19
+ constructor(maxEvents = 300, windowMs = 60000, now = Date.now) {
20
+ this.maxEvents = maxEvents;
21
+ this.windowMs = windowMs;
22
+ this.now = now;
23
+ this.timestamps = [];
24
+ }
25
+ /** Returns false once the budget for the current window is spent. */
26
+ tryAcquire() {
27
+ const now = this.now();
28
+ const windowStart = now - this.windowMs;
29
+ while (this.timestamps.length > 0 && this.timestamps[0] <= windowStart) {
30
+ this.timestamps.shift();
31
+ }
32
+ if (this.timestamps.length >= this.maxEvents) {
33
+ return false;
34
+ }
35
+ this.timestamps.push(now);
36
+ return true;
37
+ }
38
+ }
39
+ /**
40
+ * Validates an iframe TELEMETRY_EVENT payload and forwards it to the host's sink.
41
+ *
42
+ * Order: rate limit, then `parseTelemetryEvent`, then
43
+ * `sink.sendEvent(name, { ...properties, ...hostProperties }, measurements)`.
44
+ * Never throws: a sink that throws is swallowed and reported as `'invalid'`. The
45
+ * relay does not log; the caller decides what to log from the result. Never echo
46
+ * anything back to the iframe.
47
+ */
48
+ export function relayTelemetryEvent(payload, options) {
49
+ try {
50
+ if (options.limiter && !options.limiter.tryAcquire()) {
51
+ return 'rate_limited';
52
+ }
53
+ const event = parseTelemetryEvent(payload);
54
+ if (!event) {
55
+ return 'invalid';
56
+ }
57
+ options.sink.sendEvent(event.name, { ...event.properties, ...options.hostProperties }, event.measurements);
58
+ return 'forwarded';
59
+ }
60
+ catch {
61
+ return 'invalid';
62
+ }
63
+ }
64
+ //# sourceMappingURL=telemetryRelay.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"telemetryRelay.js","sourceRoot":"","sources":["../../../../src/sdk/utils/telemetry/telemetryRelay.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAgBJ,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAO3D;;;;;;;;;GASG;AACH,MAAM,OAAO,oBAAoB;IAG/B,YACmB,YAAoB,GAAG,EACvB,WAAmB,KAAM,EACzB,MAAoB,IAAI,CAAC,GAAG;QAF5B,cAAS,GAAT,SAAS,CAAc;QACvB,aAAQ,GAAR,QAAQ,CAAiB;QACzB,QAAG,GAAH,GAAG,CAAyB;QAL9B,eAAU,GAAa,EAAE,CAAC;IAMxC,CAAC;IAEJ,qEAAqE;IACrE,UAAU;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;QACxC,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC;YACvE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC7C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAcD;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB,EAAE,OAA8B;IAClF,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;YACrD,OAAO,cAAc,CAAC;QACxB,CAAC;QACD,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,SAAS,CACpB,KAAK,CAAC,IAAI,EACV,EAAE,GAAG,KAAK,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,EAClD,KAAK,CAAC,YAAY,CACnB,CAAC;QACF,OAAO,WAAW,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}
@@ -33,6 +33,16 @@ export declare const WebviewMessageType: {
33
33
  * platform embeds.
34
34
  */
35
35
  readonly SUBMIT_EDIT: "SUBMIT_EDIT";
36
+ /** Host reports the outcome of a correlated VS Code edit submission. */
37
+ readonly SUBMIT_EDIT_RESULT: "SUBMIT_EDIT_RESULT";
38
+ /**
39
+ * Plugin reports an anonymous, aggregate usage event to the host (payload:
40
+ * TelemetryEventPayload, see utils/telemetry). Fire-and-forget: the host never
41
+ * replies. The host MUST validate the payload (relayTelemetryEvent /
42
+ * parseTelemetryEvent) and add its own attribution such as `pluginId`; the
43
+ * plugin never sends one.
44
+ */
45
+ readonly TELEMETRY_EVENT: "TELEMETRY_EVENT";
36
46
  };
37
47
  export type WebviewMessageTypeValue = (typeof WebviewMessageType)[keyof typeof WebviewMessageType];
38
48
  /**
@@ -108,6 +118,21 @@ export interface SpatialContext {
108
118
  xpath?: string;
109
119
  };
110
120
  }
121
+ /**
122
+ * Where a vibe edit should land in the agent chat: a brand-new conversation, or
123
+ * a continuation of the current one. The webview composer's routing control
124
+ * produces this; the host maps it onto the Agentforce Vibes conversation
125
+ * lifecycle (a `new` target resets the session so a fresh conversation opens;
126
+ * `existing` reuses the remembered conversationId). `id`/`label` are the
127
+ * composer's own display handles — the host branches only on `kind`.
128
+ */
129
+ export type ChatTarget = {
130
+ kind: 'new';
131
+ } | {
132
+ kind: 'existing';
133
+ id: string;
134
+ label: string;
135
+ };
111
136
  /**
112
137
  * Payload for SUBMIT_EDIT: the user's instruction plus one SpatialContext per
113
138
  * selected element. The host assembles this into an agent prompt.
@@ -117,21 +142,38 @@ export interface EditRequest {
117
142
  prompt: string;
118
143
  /** Spatial context for each selected element (one entry per element). */
119
144
  attachments: SpatialContext[];
145
+ /**
146
+ * Optional chat routing for this edit. Omitted by the classic panel (web /
147
+ * Builder Central), so those hosts keep the pre-existing shape byte-for-byte;
148
+ * the VS Code composer sets it to drive new-vs-current conversation routing.
149
+ */
150
+ chatTarget?: ChatTarget;
151
+ /** Stable SelectionGraph ids for host-side reconstruction in trusted hosts. */
152
+ selectionIds?: string[];
120
153
  }
121
154
  /**
122
155
  * Result of a host's attempt to deliver an EditRequest to the embedded agent.
123
156
  *
124
- * `channel` records which delivery mechanism actually fired (see the fallback
125
- * chain in the design doc): the Agentforce Vibes inject command, the standard
126
- * chat command, or the universal clipboard floor.
157
+ * Delivery is a single stream channel — an auto-run Agentforce Vibes submission
158
+ * (`vibes.submit`). There is no fallback: `channel` is `'vibes.submit'` on
159
+ * success, or `'none'` when the edit could not be delivered (Vibes unavailable
160
+ * after retries, or a terminal rejection) — in which case the host surfaces an
161
+ * error to the user.
127
162
  */
128
163
  export interface EditHandoffResult {
129
- /** Whether the request was delivered to (or staged for) the agent. */
164
+ /** Whether the request was delivered to (or durably queued for) the agent. */
130
165
  delivered: boolean;
131
- /** Which delivery channel was used. */
132
- channel: 'vibes.inject' | 'chat.open' | 'clipboard' | 'none';
133
- /** Optional human-readable detail (e.g. why a channel was skipped). */
166
+ /** Which delivery channel was used (`'none'` when delivery failed). */
167
+ channel: 'vibes.submit' | 'none';
168
+ /** Optional human-readable detail (e.g. why delivery failed). */
134
169
  detail?: string;
170
+ /** Conversation created or continued by a typed Vibes acceptance. */
171
+ conversationId?: string;
172
+ }
173
+ /** A correlated VS Code result for one SUBMIT_EDIT request. */
174
+ export interface SubmitEditResult {
175
+ requestId: string;
176
+ result: EditHandoffResult;
135
177
  }
136
178
  /** Set of all valid message types for whitelist validation */
137
179
  export declare const VALID_MESSAGE_TYPES: Set<string>;
@@ -152,5 +194,7 @@ export interface WebviewMessage {
152
194
  * expected value.
153
195
  */
154
196
  renderId?: string;
197
+ /** Correlates a request/response pair when the host supports acknowledgements. */
198
+ requestId?: string;
155
199
  }
156
200
  //# sourceMappingURL=webviewMessageTypes.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"webviewMessageTypes.d.ts","sourceRoot":"","sources":["../../src/sdk/webviewMessageTypes.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E,eAAO,MAAM,kBAAkB;IAC7B,sEAAsE;;IAEtE,sCAAsC;;IAEtC,4CAA4C;;IAE5C,oCAAoC;;IAEpC,0BAA0B;;IAG1B,4CAA4C;;IAG5C,qEAAqE;;IAGrE,8EAA8E;;IAG9E;;;;;OAKG;;CAEK,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAEnG;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,kBAAkB;IAClB,IAAI,EAAE,CAAC,CAAC;IACR,gFAAgF;IAChF,OAAO,EAAE,iBAAiB,CAAC;IAC3B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,2GAA2G;IAC3G,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,cAAc,CAAC,EAAE;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,OAAO,EAAE,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;IAC7D,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,aAAqD,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}
1
+ {"version":3,"file":"webviewMessageTypes.d.ts","sourceRoot":"","sources":["../../src/sdk/webviewMessageTypes.ts"],"names":[],"mappings":"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"}
@@ -28,6 +28,16 @@ export const WebviewMessageType = {
28
28
  * platform embeds.
29
29
  */
30
30
  SUBMIT_EDIT: 'SUBMIT_EDIT',
31
+ /** Host reports the outcome of a correlated VS Code edit submission. */
32
+ SUBMIT_EDIT_RESULT: 'SUBMIT_EDIT_RESULT',
33
+ /**
34
+ * Plugin reports an anonymous, aggregate usage event to the host (payload:
35
+ * TelemetryEventPayload, see utils/telemetry). Fire-and-forget: the host never
36
+ * replies. The host MUST validate the payload (relayTelemetryEvent /
37
+ * parseTelemetryEvent) and add its own attribution such as `pluginId`; the
38
+ * plugin never sends one.
39
+ */
40
+ TELEMETRY_EVENT: 'TELEMETRY_EVENT',
31
41
  };
32
42
  /** Set of all valid message types for whitelist validation */
33
43
  export const VALID_MESSAGE_TYPES = new Set(Object.values(WebviewMessageType));
@@ -1 +1 @@
1
- {"version":3,"file":"webviewMessageTypes.js","sourceRoot":"","sources":["../../src/sdk/webviewMessageTypes.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAQJ,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,sEAAsE;IACtE,YAAY,EAAE,cAAc;IAC5B,sCAAsC;IACtC,mBAAmB,EAAE,qBAAqB;IAC1C,4CAA4C;IAC5C,gBAAgB,EAAE,kBAAkB;IACpC,oCAAoC;IACpC,gBAAgB,EAAE,kBAAkB;IACpC,0BAA0B;IAC1B,aAAa,EAAE,cAAc;IAE7B,4CAA4C;IAC5C,mBAAmB,EAAE,qBAAqB;IAE1C,qEAAqE;IACrE,oBAAoB,EAAE,sBAAsB;IAE5C,8EAA8E;IAC9E,kBAAkB,EAAE,oBAAoB;IAExC;;;;;OAKG;IACH,WAAW,EAAE,aAAa;CAClB,CAAC;AAsGX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC"}
1
+ {"version":3,"file":"webviewMessageTypes.js","sourceRoot":"","sources":["../../src/sdk/webviewMessageTypes.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAQJ,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,sEAAsE;IACtE,YAAY,EAAE,cAAc;IAC5B,sCAAsC;IACtC,mBAAmB,EAAE,qBAAqB;IAC1C,4CAA4C;IAC5C,gBAAgB,EAAE,kBAAkB;IACpC,oCAAoC;IACpC,gBAAgB,EAAE,kBAAkB;IACpC,0BAA0B;IAC1B,aAAa,EAAE,cAAc;IAE7B,4CAA4C;IAC5C,mBAAmB,EAAE,qBAAqB;IAE1C,qEAAqE;IACrE,oBAAoB,EAAE,sBAAsB;IAE5C,8EAA8E;IAC9E,kBAAkB,EAAE,oBAAoB;IAExC;;;;;OAKG;IACH,WAAW,EAAE,aAAa;IAC1B,wEAAwE;IACxE,kBAAkB,EAAE,oBAAoB;IAExC;;;;;;OAMG;IACH,eAAe,EAAE,iBAAiB;CAC1B,CAAC;AAkIX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@salesforce/metadata-core-sdk",
3
- "version": "1.7.0",
3
+ "version": "1.9.0",
4
4
  "description": "Core SDK with shared contracts and platform abstractions for visualization plugins",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",