@xpert-ai/xpert-sdk 0.4.2 → 0.4.4

package/dist/tests/workbench-open.test.js

@@ -0,0 +1,104 @@
+import { describe, expect, it } from 'vitest';
+import { parseWorkbenchViewOpenEvent, WORKBENCH_VIEW_OPEN_EVENT } from "../index.js";
+function event(overrides = {}) {
+    return {
+        type: WORKBENCH_VIEW_OPEN_EVENT,
+        viewKey: 'pipeline-board',
+        projectId: 'project-1',
+        ...overrides,
+    };
+}
+describe('workbench view open events', () => {
+    it('parses a minimal live request scoped to a project', () => {
+        expect(parseWorkbenchViewOpenEvent(event())).toEqual({
+            type: WORKBENCH_VIEW_OPEN_EVENT,
+            viewKey: 'pipeline-board',
+            projectId: 'project-1',
+        });
+    });
+    it('keeps the conversation scope, selection and scalar parameters', () => {
+        expect(parseWorkbenchViewOpenEvent(event({
+            conversationId: 'conversation-1',
+            selectionId: 'selection-1',
+            parameters: {
+                stage: 'bid',
+                pinned: true,
+                ratio: 0.35,
+                missing: null,
+                bidders: ['acme', 'globex'],
+                empty: [],
+            },
+        }))).toEqual({
+            type: WORKBENCH_VIEW_OPEN_EVENT,
+            viewKey: 'pipeline-board',
+            projectId: 'project-1',
+            conversationId: 'conversation-1',
+            selectionId: 'selection-1',
+            parameters: {
+                stage: 'bid',
+                pinned: true,
+                ratio: 0.35,
+                missing: null,
+                bidders: ['acme', 'globex'],
+                empty: [],
+            },
+        });
+    });
+    it('drops unknown fields so arbitrary log payloads cannot smuggle state', () => {
+        expect(parseWorkbenchViewOpenEvent(event({ extra: 'ignored', nested: { deep: true } }))).toEqual({
+            type: WORKBENCH_VIEW_OPEN_EVENT,
+            viewKey: 'pipeline-board',
+            projectId: 'project-1',
+        });
+    });
+    it('rejects non-object payloads, other event types and missing scope', () => {
+        for (const value of [
+            null,
+            undefined,
+            'workbench.view.open',
+            42,
+            [event()],
+            event({ type: 'assistant.citation.open' }),
+            { viewKey: 'pipeline-board', projectId: 'project-1' },
+            event({ viewKey: '' }),
+            event({ viewKey: '   ' }),
+            event({ projectId: '' }),
+            event({ projectId: '   ' }),
+        ]) {
+            expect(parseWorkbenchViewOpenEvent(value)).toBeNull();
+        }
+    });
+    it('rejects mistyped optional identifiers and parameter containers', () => {
+        for (const value of [
+            event({ conversationId: 7 }),
+            event({ selectionId: {} }),
+            event({ parameters: null }),
+            event({ parameters: ['bid'] }),
+            event({ parameters: 'bid' }),
+        ]) {
+            expect(parseWorkbenchViewOpenEvent(value)).toBeNull();
+        }
+    });
+    it('rejects parameter values that are not scalars or arrays of scalars', () => {
+        expect(parseWorkbenchViewOpenEvent(event({ parameters: { filter: { stage: 'bid' } } }))).toBeNull();
+        expect(parseWorkbenchViewOpenEvent(event({ parameters: { bidders: ['acme', 3, true] } }))).toEqual({
+            type: WORKBENCH_VIEW_OPEN_EVENT,
+            viewKey: 'pipeline-board',
+            projectId: 'project-1',
+            parameters: { bidders: ['acme', 3, true] },
+        });
+        expect(parseWorkbenchViewOpenEvent(event({ parameters: { bidders: ['acme', {}] } }))).toBeNull();
+        expect(parseWorkbenchViewOpenEvent(event({ parameters: { ratio: Number.NaN } }))).toBeNull();
+        expect(parseWorkbenchViewOpenEvent(event({ parameters: { ratio: Number.POSITIVE_INFINITY } }))).toBeNull();
+    });
+    it('accepts empty optional identifiers as-is (current behavior)', () => {
+        expect(parseWorkbenchViewOpenEvent(event({ conversationId: '', selectionId: '' }))).toEqual({
+            type: WORKBENCH_VIEW_OPEN_EVENT,
+            viewKey: 'pipeline-board',
+            projectId: 'project-1',
+            conversationId: '',
+            selectionId: '',
+        });
+    });
+});
+//# sourceMappingURL=workbench-open.test.js.map

package/dist/tests/workbench-open.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbench-open.test.js","sourceRoot":"","sources":["../../src/tests/workbench-open.test.ts"],"names":[],"mappings":"OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ;OACtC,EAAE,2BAA2B,EAAE,yBAAyB,EAAE;AAEjE,SAAS,KAAK,CAAC,YAAqC,EAAE;IACpD,OAAO;QACL,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,gBAAgB;QACzB,SAAS,EAAE,WAAW;QACtB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,2BAA2B,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACnD,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,gBAAgB;YACzB,SAAS,EAAE,WAAW;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,CACJ,2BAA2B,CACzB,KAAK,CAAC;YACJ,cAAc,EAAE,gBAAgB;YAChC,WAAW,EAAE,aAAa;YAC1B,UAAU,EAAE;gBACV,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,IAAI;gBACX,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;gBAC3B,KAAK,EAAE,EAAE;aACV;SACF,CAAC,CACH,CACF,CAAC,OAAO,CAAC;YACR,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,gBAAgB;YACzB,SAAS,EAAE,WAAW;YACtB,cAAc,EAAE,gBAAgB;YAChC,WAAW,EAAE,aAAa;YAC1B,UAAU,EAAE;gBACV,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,IAAI;gBACX,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;gBAC3B,KAAK,EAAE,EAAE;aACV;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,CACJ,2BAA2B,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CACjF,CAAC,OAAO,CAAC;YACR,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,gBAAgB;YACzB,SAAS,EAAE,WAAW;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,KAAK,MAAM,KAAK,IAAI;YAClB,IAAI;YACJ,SAAS;YACT,qBAAqB;YACrB,EAAE;YACF,CAAC,KAAK,EAAE,CAAC;YACT,KAAK,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC;YAC1C,EAAE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,WAAW,EAAE;YACrD,KAAK,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YACtB,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YACzB,KAAK,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;YACxB,KAAK,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;SAC5B,EAAE,CAAC;YACF,MAAM,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QACxD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,KAAK,MAAM,KAAK,IAAI;YAClB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;YAC1B,KAAK,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;YAC3B,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;SAC7B,EAAE,CAAC;YACF,MAAM,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QACxD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,CACJ,2BAA2B,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CACjF,CAAC,QAAQ,EAAE,CAAC;QACb,MAAM,CACJ,2BAA2B,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CACnF,CAAC,OAAO,CAAC;YACR,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,gBAAgB;YACzB,SAAS,EAAE,WAAW;YACtB,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE;SAC3C,CAAC,CAAC;QACH,MAAM,CACJ,2BAA2B,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAC9E,CAAC,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,2BAA2B,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC7F,MAAM,CACJ,2BAA2B,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,CACxF,CAAC,QAAQ,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,CAAC,2BAA2B,CAAC,KAAK,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC1F,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,gBAAgB;YACzB,SAAS,EAAE,WAAW;YACtB,cAAc,EAAE,EAAE;YAClB,WAAW,EAAE,EAAE;SAChB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/workbench-open.test.mjs

@@ -0,0 +1,104 @@
+import { describe, expect, it } from 'vitest';
+import { parseWorkbenchViewOpenEvent, WORKBENCH_VIEW_OPEN_EVENT } from "../index.mjs";
+function event(overrides = {}) {
+    return {
+        type: WORKBENCH_VIEW_OPEN_EVENT,
+        viewKey: 'pipeline-board',
+        projectId: 'project-1',
+        ...overrides,
+    };
+}
+describe('workbench view open events', () => {
+    it('parses a minimal live request scoped to a project', () => {
+        expect(parseWorkbenchViewOpenEvent(event())).toEqual({
+            type: WORKBENCH_VIEW_OPEN_EVENT,
+            viewKey: 'pipeline-board',
+            projectId: 'project-1',
+        });
+    });
+    it('keeps the conversation scope, selection and scalar parameters', () => {
+        expect(parseWorkbenchViewOpenEvent(event({
+            conversationId: 'conversation-1',
+            selectionId: 'selection-1',
+            parameters: {
+                stage: 'bid',
+                pinned: true,
+                ratio: 0.35,
+                missing: null,
+                bidders: ['acme', 'globex'],
+                empty: [],
+            },
+        }))).toEqual({
+            type: WORKBENCH_VIEW_OPEN_EVENT,
+            viewKey: 'pipeline-board',
+            projectId: 'project-1',
+            conversationId: 'conversation-1',
+            selectionId: 'selection-1',
+            parameters: {
+                stage: 'bid',
+                pinned: true,
+                ratio: 0.35,
+                missing: null,
+                bidders: ['acme', 'globex'],
+                empty: [],
+            },
+        });
+    });
+    it('drops unknown fields so arbitrary log payloads cannot smuggle state', () => {
+        expect(parseWorkbenchViewOpenEvent(event({ extra: 'ignored', nested: { deep: true } }))).toEqual({
+            type: WORKBENCH_VIEW_OPEN_EVENT,
+            viewKey: 'pipeline-board',
+            projectId: 'project-1',
+        });
+    });
+    it('rejects non-object payloads, other event types and missing scope', () => {
+        for (const value of [
+            null,
+            undefined,
+            'workbench.view.open',
+            42,
+            [event()],
+            event({ type: 'assistant.citation.open' }),
+            { viewKey: 'pipeline-board', projectId: 'project-1' },
+            event({ viewKey: '' }),
+            event({ viewKey: '   ' }),
+            event({ projectId: '' }),
+            event({ projectId: '   ' }),
+        ]) {
+            expect(parseWorkbenchViewOpenEvent(value)).toBeNull();
+        }
+    });
+    it('rejects mistyped optional identifiers and parameter containers', () => {
+        for (const value of [
+            event({ conversationId: 7 }),
+            event({ selectionId: {} }),
+            event({ parameters: null }),
+            event({ parameters: ['bid'] }),
+            event({ parameters: 'bid' }),
+        ]) {
+            expect(parseWorkbenchViewOpenEvent(value)).toBeNull();
+        }
+    });
+    it('rejects parameter values that are not scalars or arrays of scalars', () => {
+        expect(parseWorkbenchViewOpenEvent(event({ parameters: { filter: { stage: 'bid' } } }))).toBeNull();
+        expect(parseWorkbenchViewOpenEvent(event({ parameters: { bidders: ['acme', 3, true] } }))).toEqual({
+            type: WORKBENCH_VIEW_OPEN_EVENT,
+            viewKey: 'pipeline-board',
+            projectId: 'project-1',
+            parameters: { bidders: ['acme', 3, true] },
+        });
+        expect(parseWorkbenchViewOpenEvent(event({ parameters: { bidders: ['acme', {}] } }))).toBeNull();
+        expect(parseWorkbenchViewOpenEvent(event({ parameters: { ratio: Number.NaN } }))).toBeNull();
+        expect(parseWorkbenchViewOpenEvent(event({ parameters: { ratio: Number.POSITIVE_INFINITY } }))).toBeNull();
+    });
+    it('accepts empty optional identifiers as-is (current behavior)', () => {
+        expect(parseWorkbenchViewOpenEvent(event({ conversationId: '', selectionId: '' }))).toEqual({
+            type: WORKBENCH_VIEW_OPEN_EVENT,
+            viewKey: 'pipeline-board',
+            projectId: 'project-1',
+            conversationId: '',
+            selectionId: '',
+        });
+    });
+});
+//# sourceMappingURL=workbench-open.test.mjs.map

package/dist/tests/workbench-open.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbench-open.test.mjs","sourceRoot":"","sources":["../../src/tests/workbench-open.test.ts"],"names":[],"mappings":"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"}

package/dist/view-extension.d.ts

@@ -123,8 +123,18 @@ export interface XpertViewActivation {
     requiredFeatures?: string[];
 }
 export interface XpertWorkbenchViewOptions {
+    /**
+     * @deprecated Use the manifest's `visible` field for visibility and `openMode`
+     * for initial tab behavior. Retained for compatibility; false hides the view.
+     */
     fixed?: boolean;
+    /**
+     * Initial tab behavior; defaults to auto. On-demand views open through a
+     * menu, navigation or live Agent request. This does not grant view access.
+     */
+    openMode?: 'auto' | 'on-demand';
     menu?: {
+        /** Controls the manual entry only; does not disable the view or navigation. */
         enabled?: boolean;
         label?: string | XpertI18nObject;
         order?: number;
@@ -472,3 +482,8 @@ export interface XpertViewRequestOptions {
     signal?: AbortSignal;
     runtimeScope?: XpertViewRuntimeScopeInput;
 }
+export interface WorkbenchExtensionViewOpenRequest {
+    viewKey: string;
+    selectionId?: string;
+    parameters?: Record<string, XpertViewScalar | XpertViewScalar[]>;
+}

package/dist/view-extension.js.map

@@ -1 +1 @@
-{"version":3,"file":"view-extension.js","sourceRoot":"","sources":["../src/view-extension.ts"],"names":[],"mappings":"AA4CA,MAAM,CAAC,MAAM,4BAA4B,GAAG,yBAAyB,CAAC;AACtE,MAAM,CAAC,MAAM,iCAAiC,GAAG,8BAA8B,CAAC;AA6WhF,MAAM,CAAC,MAAM,mCAAmC,GAC9C,6BAA6B,CAAC;AAChC,MAAM,CAAC,MAAM,6BAA6B,GAAG,uBAAuB,CAAC;AACrE,MAAM,CAAC,MAAM,2BAA2B,GAAG,qBAAqB,CAAC;AACjE,MAAM,CAAC,MAAM,iCAAiC,GAAG,2BAA2B,CAAC;AAC7E,MAAM,CAAC,MAAM,wCAAwC,GACnD,yBAAyB,CAAC;AAC5B,MAAM,CAAC,MAAM,uCAAuC,GAAG,wBAAwB,CAAC;AAChF,MAAM,CAAC,MAAM,yDAAyD,GACpE,qBAAqB,CAAC;AAiExB,MAAM,CAAC,MAAM,6BAA6B,GAAG,yBAAyB,CAAC;AACvE,MAAM,CAAC,MAAM,kCAAkC,GAAG,6BAA6B,CAAC"}
+{"version":3,"file":"view-extension.js","sourceRoot":"","sources":["../src/view-extension.ts"],"names":[],"mappings":"AA4CA,MAAM,CAAC,MAAM,4BAA4B,GAAG,yBAAyB,CAAC;AACtE,MAAM,CAAC,MAAM,iCAAiC,GAAG,8BAA8B,CAAC;AAuXhF,MAAM,CAAC,MAAM,mCAAmC,GAC9C,6BAA6B,CAAC;AAChC,MAAM,CAAC,MAAM,6BAA6B,GAAG,uBAAuB,CAAC;AACrE,MAAM,CAAC,MAAM,2BAA2B,GAAG,qBAAqB,CAAC;AACjE,MAAM,CAAC,MAAM,iCAAiC,GAAG,2BAA2B,CAAC;AAC7E,MAAM,CAAC,MAAM,wCAAwC,GACnD,yBAAyB,CAAC;AAC5B,MAAM,CAAC,MAAM,uCAAuC,GAAG,wBAAwB,CAAC;AAChF,MAAM,CAAC,MAAM,yDAAyD,GACpE,qBAAqB,CAAC;AAiExB,MAAM,CAAC,MAAM,6BAA6B,GAAG,yBAAyB,CAAC;AACvE,MAAM,CAAC,MAAM,kCAAkC,GAAG,6BAA6B,CAAC"}

package/dist/view-extension.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"view-extension.mjs","sourceRoot":"","sources":["../src/view-extension.ts"],"names":[],"mappings":"AA4CA,MAAM,CAAC,MAAM,4BAA4B,GAAG,yBAAyB,CAAC;AACtE,MAAM,CAAC,MAAM,iCAAiC,GAAG,8BAA8B,CAAC;AA6WhF,MAAM,CAAC,MAAM,mCAAmC,GAC9C,6BAA6B,CAAC;AAChC,MAAM,CAAC,MAAM,6BAA6B,GAAG,uBAAuB,CAAC;AACrE,MAAM,CAAC,MAAM,2BAA2B,GAAG,qBAAqB,CAAC;AACjE,MAAM,CAAC,MAAM,iCAAiC,GAAG,2BAA2B,CAAC;AAC7E,MAAM,CAAC,MAAM,wCAAwC,GACnD,yBAAyB,CAAC;AAC5B,MAAM,CAAC,MAAM,uCAAuC,GAAG,wBAAwB,CAAC;AAChF,MAAM,CAAC,MAAM,yDAAyD,GACpE,qBAAqB,CAAC;AAiExB,MAAM,CAAC,MAAM,6BAA6B,GAAG,yBAAyB,CAAC;AACvE,MAAM,CAAC,MAAM,kCAAkC,GAAG,6BAA6B,CAAC"}
+{"version":3,"file":"view-extension.mjs","sourceRoot":"","sources":["../src/view-extension.ts"],"names":[],"mappings":"AA4CA,MAAM,CAAC,MAAM,4BAA4B,GAAG,yBAAyB,CAAC;AACtE,MAAM,CAAC,MAAM,iCAAiC,GAAG,8BAA8B,CAAC;AAuXhF,MAAM,CAAC,MAAM,mCAAmC,GAC9C,6BAA6B,CAAC;AAChC,MAAM,CAAC,MAAM,6BAA6B,GAAG,uBAAuB,CAAC;AACrE,MAAM,CAAC,MAAM,2BAA2B,GAAG,qBAAqB,CAAC;AACjE,MAAM,CAAC,MAAM,iCAAiC,GAAG,2BAA2B,CAAC;AAC7E,MAAM,CAAC,MAAM,wCAAwC,GACnD,yBAAyB,CAAC;AAC5B,MAAM,CAAC,MAAM,uCAAuC,GAAG,wBAAwB,CAAC;AAChF,MAAM,CAAC,MAAM,yDAAyD,GACpE,qBAAqB,CAAC;AAiExB,MAAM,CAAC,MAAM,6BAA6B,GAAG,yBAAyB,CAAC;AACvE,MAAM,CAAC,MAAM,kCAAkC,GAAG,6BAA6B,CAAC"}

package/dist/workbench-open.d.ts

@@ -0,0 +1,10 @@
+import type { WorkbenchExtensionViewOpenRequest } from './view-extension.js';
+/** Live-only UI request. Project scope is mandatory; history playback must not reopen Views. */
+export declare const WORKBENCH_VIEW_OPEN_EVENT = "workbench.view.open";
+export interface WorkbenchViewOpenEvent extends WorkbenchExtensionViewOpenRequest {
+    type: typeof WORKBENCH_VIEW_OPEN_EVENT;
+    projectId: string;
+    conversationId?: string;
+}
+/** Parse the public lg.chat.event boundary, keeping arbitrary logs out of navigation. */
+export declare function parseWorkbenchViewOpenEvent(value: unknown): WorkbenchViewOpenEvent | null;

package/dist/workbench-open.js

@@ -0,0 +1,51 @@
+/** Live-only UI request. Project scope is mandatory; history playback must not reopen Views. */
+export const WORKBENCH_VIEW_OPEN_EVENT = 'workbench.view.open';
+/** Parse the public lg.chat.event boundary, keeping arbitrary logs out of navigation. */
+export function parseWorkbenchViewOpenEvent(value) {
+    if (!value ||
+        typeof value !== 'object' ||
+        Array.isArray(value) ||
+        !('type' in value) ||
+        value.type !== WORKBENCH_VIEW_OPEN_EVENT ||
+        !('viewKey' in value) ||
+        typeof value.viewKey !== 'string' ||
+        !value.viewKey.trim() ||
+        !('projectId' in value) ||
+        typeof value.projectId !== 'string' ||
+        !value.projectId.trim())
+        return null;
+    if ('conversationId' in value && typeof value.conversationId !== 'string')
+        return null;
+    if ('selectionId' in value && typeof value.selectionId !== 'string')
+        return null;
+    const parameters = {};
+    if ('parameters' in value) {
+        if (!value.parameters ||
+            typeof value.parameters !== 'object' ||
+            Array.isArray(value.parameters))
+            return null;
+        for (const [key, item] of Object.entries(value.parameters)) {
+            if (isViewScalar(item))
+                parameters[key] = item;
+            else if (Array.isArray(item) && item.every(isViewScalar))
+                parameters[key] = item;
+            else
+                return null;
+        }
+    }
+    return {
+        type: WORKBENCH_VIEW_OPEN_EVENT,
+        viewKey: value.viewKey,
+        projectId: value.projectId,
+        ...('conversationId' in value ? { conversationId: value.conversationId } : {}),
+        ...('selectionId' in value ? { selectionId: value.selectionId } : {}),
+        ...('parameters' in value ? { parameters } : {}),
+    };
+}
+function isViewScalar(value) {
+    return (value === null ||
+        typeof value === 'string' ||
+        typeof value === 'boolean' ||
+        (typeof value === 'number' && Number.isFinite(value)));
+}
+//# sourceMappingURL=workbench-open.js.map

package/dist/workbench-open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbench-open.js","sourceRoot":"","sources":["../src/workbench-open.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAChG,MAAM,CAAC,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;AAO/D,yFAAyF;AACzF,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,IACE,CAAC,KAAK;QACN,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;QAClB,KAAK,CAAC,IAAI,KAAK,yBAAyB;QACxC,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC;QACrB,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;QACrB,CAAC,CAAC,WAAW,IAAI,KAAK,CAAC;QACvB,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE;QAEvB,OAAO,IAAI,CAAC;IACd,IAAI,gBAAgB,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvF,IAAI,aAAa,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjF,MAAM,UAAU,GAAiE,EAAE,CAAC;IACpF,IAAI,YAAY,IAAI,KAAK,EAAE,CAAC;QAC1B,IACE,CAAC,KAAK,CAAC,UAAU;YACjB,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;YACpC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;YAE/B,OAAO,IAAI,CAAC;QACd,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3D,IAAI,YAAY,CAAC,IAAI,CAAC;gBAAE,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;iBAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;gBAAE,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;;gBAC5E,OAAO,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO;QACL,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,GAAG,CAAC,gBAAgB,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAwB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,GAAG,CAAC,aAAa,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,GAAG,CAAC,YAAY,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjD,CAAC;AACJ,CAAC;AACD,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS;QAC1B,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CACtD,CAAC;AACJ,CAAC"}

package/dist/workbench-open.mjs

@@ -0,0 +1,51 @@
+/** Live-only UI request. Project scope is mandatory; history playback must not reopen Views. */
+export const WORKBENCH_VIEW_OPEN_EVENT = 'workbench.view.open';
+/** Parse the public lg.chat.event boundary, keeping arbitrary logs out of navigation. */
+export function parseWorkbenchViewOpenEvent(value) {
+    if (!value ||
+        typeof value !== 'object' ||
+        Array.isArray(value) ||
+        !('type' in value) ||
+        value.type !== WORKBENCH_VIEW_OPEN_EVENT ||
+        !('viewKey' in value) ||
+        typeof value.viewKey !== 'string' ||
+        !value.viewKey.trim() ||
+        !('projectId' in value) ||
+        typeof value.projectId !== 'string' ||
+        !value.projectId.trim())
+        return null;
+    if ('conversationId' in value && typeof value.conversationId !== 'string')
+        return null;
+    if ('selectionId' in value && typeof value.selectionId !== 'string')
+        return null;
+    const parameters = {};
+    if ('parameters' in value) {
+        if (!value.parameters ||
+            typeof value.parameters !== 'object' ||
+            Array.isArray(value.parameters))
+            return null;
+        for (const [key, item] of Object.entries(value.parameters)) {
+            if (isViewScalar(item))
+                parameters[key] = item;
+            else if (Array.isArray(item) && item.every(isViewScalar))
+                parameters[key] = item;
+            else
+                return null;
+        }
+    }
+    return {
+        type: WORKBENCH_VIEW_OPEN_EVENT,
+        viewKey: value.viewKey,
+        projectId: value.projectId,
+        ...('conversationId' in value ? { conversationId: value.conversationId } : {}),
+        ...('selectionId' in value ? { selectionId: value.selectionId } : {}),
+        ...('parameters' in value ? { parameters } : {}),
+    };
+}
+function isViewScalar(value) {
+    return (value === null ||
+        typeof value === 'string' ||
+        typeof value === 'boolean' ||
+        (typeof value === 'number' && Number.isFinite(value)));
+}
+//# sourceMappingURL=workbench-open.mjs.map

package/dist/workbench-open.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbench-open.mjs","sourceRoot":"","sources":["../src/workbench-open.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAChG,MAAM,CAAC,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;AAO/D,yFAAyF;AACzF,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,IACE,CAAC,KAAK;QACN,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;QAClB,KAAK,CAAC,IAAI,KAAK,yBAAyB;QACxC,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC;QACrB,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;QACrB,CAAC,CAAC,WAAW,IAAI,KAAK,CAAC;QACvB,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE;QAEvB,OAAO,IAAI,CAAC;IACd,IAAI,gBAAgB,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvF,IAAI,aAAa,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjF,MAAM,UAAU,GAAiE,EAAE,CAAC;IACpF,IAAI,YAAY,IAAI,KAAK,EAAE,CAAC;QAC1B,IACE,CAAC,KAAK,CAAC,UAAU;YACjB,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;YACpC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;YAE/B,OAAO,IAAI,CAAC;QACd,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3D,IAAI,YAAY,CAAC,IAAI,CAAC;gBAAE,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;iBAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;gBAAE,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;;gBAC5E,OAAO,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO;QACL,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,GAAG,CAAC,gBAAgB,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAwB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,GAAG,CAAC,aAAa,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,GAAG,CAAC,YAAY,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjD,CAAC;AACJ,CAAC;AACD,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS;QAC1B,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CACtD,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/xpert-sdk",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "SDK Core functionality package",
   "type": "module",
   "main": "dist/index.js",