pika-shared 1.4.4 → 1.4.6

package/dist/types/chatbot/webcomp-types.d.mts

@@ -1,5 +1,5 @@
 import { UploadStatus } from '../upload-types.mjs';
-import { ShowToastFn, ChatUser, RecordOrUndef, UserAwsCredentials, WidgetRenderingContextType, ShareSessionState, UserPrefs, ChatAppMode, IUserWidgetDataStoreState, CustomDataUiRepresentation, ChatAppOverridableFeatures, TagDefinition, TagDefinitionWidget, ChatSession, UserDataOverrideSettings, ChatMessageForRendering, ChatApp, ChatAppActionMenu, ChatAppAction, InvokeAgentAsComponentOptions, WidgetMetadata, WidgetAction } from './chatbot-types.mjs';
+import { ShowToastFn, ChatUser, RecordOrUndef, UserAwsCredentials, WidgetRenderingContextType, ShareSessionState, UserPrefs, ChatAppMode, IUserWidgetDataStoreState, CustomDataUiRepresentation, ChatAppOverridableFeatures, TagDefinition, TagDefinitionWidget, ChatSession, UserDataOverrideSettings, ChatMessageForRendering, ChatApp, ChatAppActionMenu, ChatAppAction, WidgetInstance, WidgetMetadata, SpotlightWidgetDefinition, InvokeAgentAsComponentOptions, WidgetAction } from './chatbot-types.mjs';
 import '@aws-sdk/client-bedrock-agent-runtime';
 import '@aws-sdk/client-bedrock-agentcore';
 
@@ -176,6 +176,8 @@ interface IChatAppState {
     readonly pageTitle: string | undefined;
     readonly customDataForChatApp: Record<string, unknown> | undefined;
     readonly customTitleBarActions: (ChatAppActionMenu | ChatAppAction)[];
+    readonly widgetInstances: Map<string, WidgetInstance>;
+    readonly user: ChatUser;
     setCurrentSessionById(sessionId: string): void;
     removeFile(s3Key: string): void;
     startNewChatSession(): void;
@@ -186,11 +188,126 @@ interface IChatAppState {
     getMessageByMessageId(messageId: string): ChatMessageForRendering | undefined;
     uploadFiles(files: File[]): Promise<void>;
     initializeData(): Promise<void>;
-    renderTag(tagId: string, context: 'spotlight' | 'inline' | 'dialog' | 'canvas', data?: Record<string, any>): Promise<void>;
+    renderTag(tagId: string, context: 'spotlight' | 'inline' | 'dialog' | 'canvas' | 'static', data?: Record<string, any>, metadata?: WidgetMetadata): Promise<void>;
     closeCanvas(): void;
     closeDialog(): void;
     setOrUpdateCustomTitleBarAction(action: ChatAppActionMenu | ChatAppAction): void;
     removeCustomTitleBarAction(actionId: string): void;
+    getWidgetInstance(instanceId: string): WidgetInstance | undefined;
+    /**
+     * Update context for a widget. Call this when your widget's context has changed.
+     *
+     * This method will re-check your widget's `getContextForLlm()` method and update
+     * the context accordingly. Use this when:
+     * - Your widget initially had no context, but now has context to share
+     * - Your widget's context data has changed (e.g., user selected different items)
+     * - You want to change whether context should be auto-added
+     *
+     * @param instanceId - Your widget's instance ID (from getPikaContext())
+     *
+     * @example
+     * ```typescript
+     * // In a Svelte widget component:
+     * let selectedCities = $state<string[]>([]);
+     *
+     * onMount(async () => {
+     *     const context = await getPikaContext($host());
+     *
+     *     // Update context whenever selection changes
+     *     $effect(() => {
+     *         if (selectedCities.length > 0) {
+     *             // This triggers re-evaluation of getContextForLlm()
+     *             context.chatAppState.updateWidgetContext(context.instanceId);
+     *         }
+     *     });
+     * });
+     *
+     * // Your getContextForLlm() method will be called again
+     * getContextForLlm() {
+     *     if (selectedCities.length === 0) return undefined;
+     *
+     *     return {
+     *         origin: 'auto',
+     *         title: 'Selected Cities',
+     *         description: `User selected ${selectedCities.length} cities`,
+     *         data: { cities: selectedCities },
+     *         addAutomatically: true
+     *     };
+     * }
+     * ```
+     */
+    updateWidgetContext(instanceId: string): void;
+    /**
+     * Manually register a web component as a spotlight widget. This allows components to
+     * dynamically add themselves to the spotlight area at runtime.
+     *
+     * Note: Registration is ephemeral and does not persist across page refreshes.
+     * Components must re-register themselves on each page load.
+     *
+     * @param definition - Simplified definition for the spotlight widget
+     *
+     * @example
+     * ```typescript
+     * chatAppState.manuallyRegisterSpotlightWidget({
+     *     tag: 'my-widget',
+     *     scope: 'my-app',
+     *     tagTitle: 'My Widget',
+     *     displayOrder: 0
+     * });
+     * ```
+     */
+    manuallyRegisterSpotlightWidget(definition: SpotlightWidgetDefinition): void;
+    /**
+     * Save a persistent spotlight instance using the Virtual Tags Pattern.
+     * Creates a new instance with its own UserWidgetDataStore (400KB limit per instance),
+     * saves the data, registers it as a spotlight widget, and renders it immediately.
+     *
+     * Use this when users save content (like charts, queries, etc.) to spotlight.
+     *
+     * @param scope - Widget scope (e.g., 'weather')
+     * @param baseTag - Base tag name (e.g., 'chart-saved')
+     * @param displayName - User-facing name for this instance
+     * @param customElementName - The custom element name (same for all instances)
+     * @param data - The data to pass to this instance
+     * @param dataKey - The key to store data under (default: 'data')
+     * @param metadata - Optional widget metadata (title, actions, icon, etc.)
+     * @returns The instance ID (UUID)
+     *
+     * @example
+     * ```typescript
+     * const instanceId = await chatAppState.saveSpotlightInstance(
+     *     'weather',
+     *     'chart-saved',
+     *     'Q4 Revenue Chart',
+     *     'weather-chart-saved',
+     *     { chartType: 'bar', data: [...] },
+     *     'chartData',
+     *     {
+     *         title: 'Q4 Revenue Chart',
+     *         iconSvg: '<svg>...</svg>',
+     *         actions: [...]
+     *     }
+     * );
+     * ```
+     */
+    saveSpotlightInstance(scope: string, baseTag: string, displayName: string, customElementName: string, data: Record<string, any>, dataKey?: string, metadata?: WidgetMetadata): Promise<string>;
+    /**
+     * Delete a saved spotlight instance.
+     * Removes from spotlight, removes from registry, and unregisters from state.
+     *
+     * Note: Instance data is currently orphaned (not deleted) but could be recovered.
+     * Future: Will add deleteAll() method to UserWidgetDataStore.
+     *
+     * @param scope - Widget scope
+     * @param baseTag - Base tag name
+     * @param instanceId - Instance UUID
+     *
+     * @example
+     * ```typescript
+     * await chatAppState.deleteSpotlightInstance('weather', 'chart-saved', instanceId);
+     * ```
+     */
+    deleteSpotlightInstance(scope: string, baseTag: string, instanceId: string): Promise<void>;
     /**
      * Invoke the agent directly from a web component using the 'chat-app-component' invocation mode.
      * This allows components to make out-of-band requests to the LLM without creating user sessions.
@@ -324,6 +441,54 @@ interface IUploadInstance {
         error?: string;
     };
 }
+/**
+ * Callback invoked when the web component has been created and is ready.
+ * Called after the element is created but before it's added to the DOM.
+ */
+interface OnReadyCallback {
+    (params: {
+        /** The web component element that was created */
+        element: HTMLElement;
+        /** The unique instance ID assigned to this component */
+        instanceId: string;
+        /** The full Pika context with instanceId */
+        context: PikaWCContext;
+    }): void;
+}
+/**
+ * Structure for data passed to web components.
+ *
+ * Special fields that affect element initialization:
+ * - `attributes`: Set as HTML attributes (stringified) and also as properties if they exist
+ * - `properties`: Set as JavaScript properties only (not attributes)
+ * - `onReady`: Callback invoked when the component is created and ready
+ *
+ * All other fields are available through `context.dataForWidget` but not set on the element.
+ */
+interface DataForWidget {
+    /**
+     * HTML attributes to set on the element.
+     * Values are stringified and set via `setAttributeNS()`.
+     * If a corresponding property exists on the element, it's also set with the original value.
+     */
+    attributes?: Record<string, any>;
+    /**
+     * JavaScript properties to set on the element (not as HTML attributes).
+     * Only properties that exist on the element will be set.
+     * Use this for complex objects, arrays, functions, etc.
+     */
+    properties?: Record<string, any>;
+    /**
+     * Callback invoked when the web component is created and ready.
+     * Called after element creation, property/attribute setting, and context setup,
+     * but before the element is added to the DOM.
+     *
+     * Use this to get notified when the component is ready and to access the element directly.
+     */
+    onReady?: OnReadyCallback;
+    /** Any other data available through context (not set on the element) */
+    [key: string]: any;
+}
 /**
  * This is the context object that is passed to the web component when it is rendered.
  */
@@ -337,8 +502,8 @@ interface PikaWCContext {
      * Set by injectChatAppWebComponent() and used by getWidgetMetadataAPI().
      */
     instanceId: string;
-    /** Arbitrary data to be passed to the widget. */
-    dataForWidget: Record<string, any>;
+    /** Data passed to the widget, available through `context.dataForWidget`. */
+    dataForWidget: DataForWidget;
 }
 type PikaWCContextWithoutInstanceId = Omit<PikaWCContext, 'instanceId'>;
 type PikaWCContextRequestCallbackFn = (contextRequest: PikaWCContext) => void;
@@ -349,4 +514,4 @@ interface PikaWCContextRequestEvent extends CustomEvent<PikaWCContextRequestDeta
     detail: PikaWCContextRequestDetail;
 }
 
-export type { IAppState, IChatAppState, IIdentityState, IUploadInstance, IUserPrefsState, IWidgetMetadataAPI, PikaWCContext, PikaWCContextRequestCallbackFn, PikaWCContextRequestDetail, PikaWCContextRequestEvent, PikaWCContextWithoutInstanceId, SidebarState, Snippet };
+export type { DataForWidget, IAppState, IChatAppState, IIdentityState, IUploadInstance, IUserPrefsState, IWidgetMetadataAPI, OnReadyCallback, PikaWCContext, PikaWCContextRequestCallbackFn, PikaWCContextRequestDetail, PikaWCContextRequestEvent, PikaWCContextWithoutInstanceId, SidebarState, Snippet };

package/dist/types/chatbot/webcomp-types.d.ts

@@ -1,5 +1,5 @@
 import { UploadStatus } from '../upload-types.js';
-import { ShowToastFn, ChatUser, RecordOrUndef, UserAwsCredentials, WidgetRenderingContextType, ShareSessionState, UserPrefs, ChatAppMode, IUserWidgetDataStoreState, CustomDataUiRepresentation, ChatAppOverridableFeatures, TagDefinition, TagDefinitionWidget, ChatSession, UserDataOverrideSettings, ChatMessageForRendering, ChatApp, ChatAppActionMenu, ChatAppAction, InvokeAgentAsComponentOptions, WidgetMetadata, WidgetAction } from './chatbot-types.js';
+import { ShowToastFn, ChatUser, RecordOrUndef, UserAwsCredentials, WidgetRenderingContextType, ShareSessionState, UserPrefs, ChatAppMode, IUserWidgetDataStoreState, CustomDataUiRepresentation, ChatAppOverridableFeatures, TagDefinition, TagDefinitionWidget, ChatSession, UserDataOverrideSettings, ChatMessageForRendering, ChatApp, ChatAppActionMenu, ChatAppAction, WidgetInstance, WidgetMetadata, SpotlightWidgetDefinition, InvokeAgentAsComponentOptions, WidgetAction } from './chatbot-types.js';
 import '@aws-sdk/client-bedrock-agent-runtime';
 import '@aws-sdk/client-bedrock-agentcore';
 
@@ -176,6 +176,8 @@ interface IChatAppState {
     readonly pageTitle: string | undefined;
     readonly customDataForChatApp: Record<string, unknown> | undefined;
     readonly customTitleBarActions: (ChatAppActionMenu | ChatAppAction)[];
+    readonly widgetInstances: Map<string, WidgetInstance>;
+    readonly user: ChatUser;
     setCurrentSessionById(sessionId: string): void;
     removeFile(s3Key: string): void;
     startNewChatSession(): void;
@@ -186,11 +188,126 @@ interface IChatAppState {
     getMessageByMessageId(messageId: string): ChatMessageForRendering | undefined;
     uploadFiles(files: File[]): Promise<void>;
     initializeData(): Promise<void>;
-    renderTag(tagId: string, context: 'spotlight' | 'inline' | 'dialog' | 'canvas', data?: Record<string, any>): Promise<void>;
+    renderTag(tagId: string, context: 'spotlight' | 'inline' | 'dialog' | 'canvas' | 'static', data?: Record<string, any>, metadata?: WidgetMetadata): Promise<void>;
     closeCanvas(): void;
     closeDialog(): void;
     setOrUpdateCustomTitleBarAction(action: ChatAppActionMenu | ChatAppAction): void;
     removeCustomTitleBarAction(actionId: string): void;
+    getWidgetInstance(instanceId: string): WidgetInstance | undefined;
+    /**
+     * Update context for a widget. Call this when your widget's context has changed.
+     *
+     * This method will re-check your widget's `getContextForLlm()` method and update
+     * the context accordingly. Use this when:
+     * - Your widget initially had no context, but now has context to share
+     * - Your widget's context data has changed (e.g., user selected different items)
+     * - You want to change whether context should be auto-added
+     *
+     * @param instanceId - Your widget's instance ID (from getPikaContext())
+     *
+     * @example
+     * ```typescript
+     * // In a Svelte widget component:
+     * let selectedCities = $state<string[]>([]);
+     *
+     * onMount(async () => {
+     *     const context = await getPikaContext($host());
+     *
+     *     // Update context whenever selection changes
+     *     $effect(() => {
+     *         if (selectedCities.length > 0) {
+     *             // This triggers re-evaluation of getContextForLlm()
+     *             context.chatAppState.updateWidgetContext(context.instanceId);
+     *         }
+     *     });
+     * });
+     *
+     * // Your getContextForLlm() method will be called again
+     * getContextForLlm() {
+     *     if (selectedCities.length === 0) return undefined;
+     *
+     *     return {
+     *         origin: 'auto',
+     *         title: 'Selected Cities',
+     *         description: `User selected ${selectedCities.length} cities`,
+     *         data: { cities: selectedCities },
+     *         addAutomatically: true
+     *     };
+     * }
+     * ```
+     */
+    updateWidgetContext(instanceId: string): void;
+    /**
+     * Manually register a web component as a spotlight widget. This allows components to
+     * dynamically add themselves to the spotlight area at runtime.
+     *
+     * Note: Registration is ephemeral and does not persist across page refreshes.
+     * Components must re-register themselves on each page load.
+     *
+     * @param definition - Simplified definition for the spotlight widget
+     *
+     * @example
+     * ```typescript
+     * chatAppState.manuallyRegisterSpotlightWidget({
+     *     tag: 'my-widget',
+     *     scope: 'my-app',
+     *     tagTitle: 'My Widget',
+     *     displayOrder: 0
+     * });
+     * ```
+     */
+    manuallyRegisterSpotlightWidget(definition: SpotlightWidgetDefinition): void;
+    /**
+     * Save a persistent spotlight instance using the Virtual Tags Pattern.
+     * Creates a new instance with its own UserWidgetDataStore (400KB limit per instance),
+     * saves the data, registers it as a spotlight widget, and renders it immediately.
+     *
+     * Use this when users save content (like charts, queries, etc.) to spotlight.
+     *
+     * @param scope - Widget scope (e.g., 'weather')
+     * @param baseTag - Base tag name (e.g., 'chart-saved')
+     * @param displayName - User-facing name for this instance
+     * @param customElementName - The custom element name (same for all instances)
+     * @param data - The data to pass to this instance
+     * @param dataKey - The key to store data under (default: 'data')
+     * @param metadata - Optional widget metadata (title, actions, icon, etc.)
+     * @returns The instance ID (UUID)
+     *
+     * @example
+     * ```typescript
+     * const instanceId = await chatAppState.saveSpotlightInstance(
+     *     'weather',
+     *     'chart-saved',
+     *     'Q4 Revenue Chart',
+     *     'weather-chart-saved',
+     *     { chartType: 'bar', data: [...] },
+     *     'chartData',
+     *     {
+     *         title: 'Q4 Revenue Chart',
+     *         iconSvg: '<svg>...</svg>',
+     *         actions: [...]
+     *     }
+     * );
+     * ```
+     */
+    saveSpotlightInstance(scope: string, baseTag: string, displayName: string, customElementName: string, data: Record<string, any>, dataKey?: string, metadata?: WidgetMetadata): Promise<string>;
+    /**
+     * Delete a saved spotlight instance.
+     * Removes from spotlight, removes from registry, and unregisters from state.
+     *
+     * Note: Instance data is currently orphaned (not deleted) but could be recovered.
+     * Future: Will add deleteAll() method to UserWidgetDataStore.
+     *
+     * @param scope - Widget scope
+     * @param baseTag - Base tag name
+     * @param instanceId - Instance UUID
+     *
+     * @example
+     * ```typescript
+     * await chatAppState.deleteSpotlightInstance('weather', 'chart-saved', instanceId);
+     * ```
+     */
+    deleteSpotlightInstance(scope: string, baseTag: string, instanceId: string): Promise<void>;
     /**
      * Invoke the agent directly from a web component using the 'chat-app-component' invocation mode.
      * This allows components to make out-of-band requests to the LLM without creating user sessions.
@@ -324,6 +441,54 @@ interface IUploadInstance {
         error?: string;
     };
 }
+/**
+ * Callback invoked when the web component has been created and is ready.
+ * Called after the element is created but before it's added to the DOM.
+ */
+interface OnReadyCallback {
+    (params: {
+        /** The web component element that was created */
+        element: HTMLElement;
+        /** The unique instance ID assigned to this component */
+        instanceId: string;
+        /** The full Pika context with instanceId */
+        context: PikaWCContext;
+    }): void;
+}
+/**
+ * Structure for data passed to web components.
+ *
+ * Special fields that affect element initialization:
+ * - `attributes`: Set as HTML attributes (stringified) and also as properties if they exist
+ * - `properties`: Set as JavaScript properties only (not attributes)
+ * - `onReady`: Callback invoked when the component is created and ready
+ *
+ * All other fields are available through `context.dataForWidget` but not set on the element.
+ */
+interface DataForWidget {
+    /**
+     * HTML attributes to set on the element.
+     * Values are stringified and set via `setAttributeNS()`.
+     * If a corresponding property exists on the element, it's also set with the original value.
+     */
+    attributes?: Record<string, any>;
+    /**
+     * JavaScript properties to set on the element (not as HTML attributes).
+     * Only properties that exist on the element will be set.
+     * Use this for complex objects, arrays, functions, etc.
+     */
+    properties?: Record<string, any>;
+    /**
+     * Callback invoked when the web component is created and ready.
+     * Called after element creation, property/attribute setting, and context setup,
+     * but before the element is added to the DOM.
+     *
+     * Use this to get notified when the component is ready and to access the element directly.
+     */
+    onReady?: OnReadyCallback;
+    /** Any other data available through context (not set on the element) */
+    [key: string]: any;
+}
 /**
  * This is the context object that is passed to the web component when it is rendered.
  */
@@ -337,8 +502,8 @@ interface PikaWCContext {
      * Set by injectChatAppWebComponent() and used by getWidgetMetadataAPI().
      */
     instanceId: string;
-    /** Arbitrary data to be passed to the widget. */
-    dataForWidget: Record<string, any>;
+    /** Data passed to the widget, available through `context.dataForWidget`. */
+    dataForWidget: DataForWidget;
 }
 type PikaWCContextWithoutInstanceId = Omit<PikaWCContext, 'instanceId'>;
 type PikaWCContextRequestCallbackFn = (contextRequest: PikaWCContext) => void;
@@ -349,4 +514,4 @@ interface PikaWCContextRequestEvent extends CustomEvent<PikaWCContextRequestDeta
     detail: PikaWCContextRequestDetail;
 }
 
-export type { IAppState, IChatAppState, IIdentityState, IUploadInstance, IUserPrefsState, IWidgetMetadataAPI, PikaWCContext, PikaWCContextRequestCallbackFn, PikaWCContextRequestDetail, PikaWCContextRequestEvent, PikaWCContextWithoutInstanceId, SidebarState, Snippet };
+export type { DataForWidget, IAppState, IChatAppState, IIdentityState, IUploadInstance, IUserPrefsState, IWidgetMetadataAPI, OnReadyCallback, PikaWCContext, PikaWCContextRequestCallbackFn, PikaWCContextRequestDetail, PikaWCContextRequestEvent, PikaWCContextWithoutInstanceId, SidebarState, Snippet };

package/dist/util/server-client-utils.d.mts

@@ -27,5 +27,9 @@ declare function parseScope(scope: string): {
     scopeType: string;
     scopeValue: string | number | Record<string, string | number>;
 };
+/**
+ * Useful for simple hashing like to figure out if content has changed since last sent or something.
+ */
+declare function getContentHashString(content: unknown): Promise<string>;
 
-export { constructScope, parseScope, redactData, redactValue };
+export { constructScope, getContentHashString, parseScope, redactData, redactValue };

package/dist/util/server-client-utils.d.ts

@@ -27,5 +27,9 @@ declare function parseScope(scope: string): {
     scopeType: string;
     scopeValue: string | number | Record<string, string | number>;
 };
+/**
+ * Useful for simple hashing like to figure out if content has changed since last sent or something.
+ */
+declare function getContentHashString(content: unknown): Promise<string>;
 
-export { constructScope, parseScope, redactData, redactValue };
+export { constructScope, getContentHashString, parseScope, redactData, redactValue };

package/dist/util/server-client-utils.js

@@ -91,8 +91,17 @@ function parseScope(scope) {
   }
   throw new Error(`Unsupported scope format: ${scope}`);
 }
+async function getContentHashString(content) {
+  const encoder = new TextEncoder();
+  const data = encoder.encode(JSON.stringify(content));
+  const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+  const hashArray = Array.from(new Uint8Array(hashBuffer));
+  const hashHex = hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+  return hashHex;
+}
 
 exports.constructScope = constructScope;
+exports.getContentHashString = getContentHashString;
 exports.parseScope = parseScope;
 exports.redactData = redactData;
 exports.redactValue = redactValue;

package/dist/util/server-client-utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/util/server-client-utils.ts"],"names":[],"mappings":"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","file":"server-client-utils.js","sourcesContent":["/*\n * These are utils that are safe to use both on the server and the client.\n */\n\n/**\n * Helper function to redact sensitive data from specified attributes\n * @param data - The object containing data to redact\n * @param attributesToRedact - Single attribute name or array of attribute names to redact\n * @returns A new object with specified attributes redacted\n */\nfunction redactData(data: any, attributesToRedact: string | string[]): any {\n    if (!data || typeof data !== 'object') {\n        return data;\n    }\n\n    const attributes = Array.isArray(attributesToRedact) ? attributesToRedact : [attributesToRedact];\n    const redacted = { ...data };\n\n    for (const attr of attributes) {\n        if (attr in redacted) {\n            redacted[attr] = redactValue(redacted[attr]);\n        }\n    }\n\n    return redacted;\n}\n\n/**\n * Recursively redacts a value based on its type\n * @param value - The value to redact\n * @returns The redacted value\n */\nfunction redactValue(value: any): any {\n    if (typeof value === 'string') {\n        return '[REDACTED]';\n    } else if (Array.isArray(value)) {\n        return value.map((item) => redactValue(item));\n    } else if (value && typeof value === 'object') {\n        const redactedObj: any = {};\n        for (const key in value) {\n            if (value.hasOwnProperty(key)) {\n                redactedObj[key] = redactValue(value[key]);\n            }\n        }\n        return redactedObj;\n    }\n    return value; // Return as-is for other types (numbers, booleans, null, etc.)\n}\n\n/**\n * Validates that a scope value doesn't contain the '#' character which is reserved for scope construction\n */\nfunction validateScopeValue(scopeValue: string | number | Record<string, string | number>, scopeType: string): void {\n    if (typeof scopeValue === 'string' && scopeValue.includes('#')) {\n        throw new Error(`Scope value cannot contain '#' character. Found in ${scopeType} scope value: ${scopeValue}`);\n    }\n    if (typeof scopeValue === 'object' && scopeValue !== null) {\n        for (const [key, value] of Object.entries(scopeValue)) {\n            if (typeof value === 'string' && value.includes('#')) {\n                throw new Error(`Scope value cannot contain '#' character. Found in ${scopeType}.${key}: ${value}`);\n            }\n        }\n    }\n}\n\n/**\n * Constructs a scope string from scopeType and scopeValue\n * @param scopeType - The type of scope (chatapp, agent, tool, entity, agent-entity)\n * @param scopeValue - The value(s) for the scope\n * @returns The constructed scope string\n */\nfunction constructScope(scopeType: string, scopeValue: string | number | Record<string, string | number>): string {\n    // Validate scope value doesn't contain '#'\n    validateScopeValue(scopeValue, scopeType);\n\n    switch (scopeType) {\n        case 'chatapp':\n        case 'agent':\n        case 'tool':\n        case 'entity':\n            return `${scopeType}#${scopeValue}`;\n        case 'agent-entity':\n            if (typeof scopeValue !== 'object' || scopeValue === null) {\n                throw new Error('agent-entity scopeType requires an object with agent and entity properties');\n            }\n\n            const agentEntityValue = scopeValue as Record<string, string | number>;\n            if (!('agent' in agentEntityValue) || !('entity' in agentEntityValue)) {\n                throw new Error('agent-entity scopeType requires an object with both agent and entity properties');\n            }\n\n            return `agent#${agentEntityValue.agent}#entity#${agentEntityValue.entity}`;\n\n        default:\n            throw new Error(`Unsupported scopeType: ${scopeType}`);\n    }\n}\n\n/**\n * Parses a scope string back into scopeType and scopeValue\n * @param scope - The scope string to parse\n * @returns Object containing scopeType and scopeValue\n */\nfunction parseScope(scope: string): { scopeType: string; scopeValue: string | number | Record<string, string | number> } {\n    if (!scope || typeof scope !== 'string') {\n        throw new Error('Invalid scope: must be a non-empty string');\n    }\n\n    const parts = scope.split('#');\n    if (parts.length < 2) {\n        throw new Error(`Invalid scope format: ${scope}. Expected format: scopeType#scopeValue`);\n    }\n\n    const [firstType, firstValue, ...remaining] = parts;\n\n    // Handle compound scopes (agent-entity)\n    if (remaining.length >= 2 && firstType === 'agent' && remaining[0] === 'entity') {\n        return {\n            scopeType: 'agent-entity',\n            scopeValue: {\n                agent: firstValue,\n                entity: remaining[1]\n            }\n        };\n    }\n\n    // Handle simple scopes\n    if (remaining.length === 0) {\n        // For simple scopes, try to convert to number if it's numeric\n        const numericValue = Number(firstValue);\n        const scopeValue = !isNaN(numericValue) && isFinite(numericValue) ? numericValue : firstValue;\n\n        return {\n            scopeType: firstType,\n            scopeValue: scopeValue\n        };\n    }\n\n    throw new Error(`Unsupported scope format: ${scope}`);\n}\n\n// Export both functions\nexport { redactData, redactValue, constructScope, parseScope };\n"]}
+{"version":3,"sources":["../../src/util/server-client-utils.ts"],"names":[],"mappings":"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","file":"server-client-utils.js","sourcesContent":["/*\n * These are utils that are safe to use both on the server and the client.\n */\n\n/**\n * Helper function to redact sensitive data from specified attributes\n * @param data - The object containing data to redact\n * @param attributesToRedact - Single attribute name or array of attribute names to redact\n * @returns A new object with specified attributes redacted\n */\nfunction redactData(data: any, attributesToRedact: string | string[]): any {\n    if (!data || typeof data !== 'object') {\n        return data;\n    }\n\n    const attributes = Array.isArray(attributesToRedact) ? attributesToRedact : [attributesToRedact];\n    const redacted = { ...data };\n\n    for (const attr of attributes) {\n        if (attr in redacted) {\n            redacted[attr] = redactValue(redacted[attr]);\n        }\n    }\n\n    return redacted;\n}\n\n/**\n * Recursively redacts a value based on its type\n * @param value - The value to redact\n * @returns The redacted value\n */\nfunction redactValue(value: any): any {\n    if (typeof value === 'string') {\n        return '[REDACTED]';\n    } else if (Array.isArray(value)) {\n        return value.map((item) => redactValue(item));\n    } else if (value && typeof value === 'object') {\n        const redactedObj: any = {};\n        for (const key in value) {\n            if (value.hasOwnProperty(key)) {\n                redactedObj[key] = redactValue(value[key]);\n            }\n        }\n        return redactedObj;\n    }\n    return value; // Return as-is for other types (numbers, booleans, null, etc.)\n}\n\n/**\n * Validates that a scope value doesn't contain the '#' character which is reserved for scope construction\n */\nfunction validateScopeValue(scopeValue: string | number | Record<string, string | number>, scopeType: string): void {\n    if (typeof scopeValue === 'string' && scopeValue.includes('#')) {\n        throw new Error(`Scope value cannot contain '#' character. Found in ${scopeType} scope value: ${scopeValue}`);\n    }\n    if (typeof scopeValue === 'object' && scopeValue !== null) {\n        for (const [key, value] of Object.entries(scopeValue)) {\n            if (typeof value === 'string' && value.includes('#')) {\n                throw new Error(`Scope value cannot contain '#' character. Found in ${scopeType}.${key}: ${value}`);\n            }\n        }\n    }\n}\n\n/**\n * Constructs a scope string from scopeType and scopeValue\n * @param scopeType - The type of scope (chatapp, agent, tool, entity, agent-entity)\n * @param scopeValue - The value(s) for the scope\n * @returns The constructed scope string\n */\nfunction constructScope(scopeType: string, scopeValue: string | number | Record<string, string | number>): string {\n    // Validate scope value doesn't contain '#'\n    validateScopeValue(scopeValue, scopeType);\n\n    switch (scopeType) {\n        case 'chatapp':\n        case 'agent':\n        case 'tool':\n        case 'entity':\n            return `${scopeType}#${scopeValue}`;\n        case 'agent-entity':\n            if (typeof scopeValue !== 'object' || scopeValue === null) {\n                throw new Error('agent-entity scopeType requires an object with agent and entity properties');\n            }\n\n            const agentEntityValue = scopeValue as Record<string, string | number>;\n            if (!('agent' in agentEntityValue) || !('entity' in agentEntityValue)) {\n                throw new Error('agent-entity scopeType requires an object with both agent and entity properties');\n            }\n\n            return `agent#${agentEntityValue.agent}#entity#${agentEntityValue.entity}`;\n\n        default:\n            throw new Error(`Unsupported scopeType: ${scopeType}`);\n    }\n}\n\n/**\n * Parses a scope string back into scopeType and scopeValue\n * @param scope - The scope string to parse\n * @returns Object containing scopeType and scopeValue\n */\nfunction parseScope(scope: string): { scopeType: string; scopeValue: string | number | Record<string, string | number> } {\n    if (!scope || typeof scope !== 'string') {\n        throw new Error('Invalid scope: must be a non-empty string');\n    }\n\n    const parts = scope.split('#');\n    if (parts.length < 2) {\n        throw new Error(`Invalid scope format: ${scope}. Expected format: scopeType#scopeValue`);\n    }\n\n    const [firstType, firstValue, ...remaining] = parts;\n\n    // Handle compound scopes (agent-entity)\n    if (remaining.length >= 2 && firstType === 'agent' && remaining[0] === 'entity') {\n        return {\n            scopeType: 'agent-entity',\n            scopeValue: {\n                agent: firstValue,\n                entity: remaining[1]\n            }\n        };\n    }\n\n    // Handle simple scopes\n    if (remaining.length === 0) {\n        // For simple scopes, try to convert to number if it's numeric\n        const numericValue = Number(firstValue);\n        const scopeValue = !isNaN(numericValue) && isFinite(numericValue) ? numericValue : firstValue;\n\n        return {\n            scopeType: firstType,\n            scopeValue: scopeValue\n        };\n    }\n\n    throw new Error(`Unsupported scope format: ${scope}`);\n}\n\n/**\n * Useful for simple hashing like to figure out if content has changed since last sent or something.\n */\nasync function getContentHashString(content: unknown): Promise<string> {\n    const encoder = new TextEncoder();\n    const data = encoder.encode(JSON.stringify(content));\n    const hashBuffer = await crypto.subtle.digest('SHA-256', data);\n    const hashArray = Array.from(new Uint8Array(hashBuffer));\n    const hashHex = hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');\n    return hashHex;\n}\n\n// Export both functions\nexport { redactData, redactValue, constructScope, parseScope, getContentHashString };\n"]}

package/dist/util/server-client-utils.mjs

@@ -89,7 +89,15 @@ function parseScope(scope) {
   }
   throw new Error(`Unsupported scope format: ${scope}`);
 }
+async function getContentHashString(content) {
+  const encoder = new TextEncoder();
+  const data = encoder.encode(JSON.stringify(content));
+  const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+  const hashArray = Array.from(new Uint8Array(hashBuffer));
+  const hashHex = hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+  return hashHex;
+}
 
-export { constructScope, parseScope, redactData, redactValue };
+export { constructScope, getContentHashString, parseScope, redactData, redactValue };
 //# sourceMappingURL=server-client-utils.mjs.map
 //# sourceMappingURL=server-client-utils.mjs.map

package/dist/util/server-client-utils.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/util/server-client-utils.ts"],"names":[],"mappings":"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","file":"server-client-utils.mjs","sourcesContent":["/*\n * These are utils that are safe to use both on the server and the client.\n */\n\n/**\n * Helper function to redact sensitive data from specified attributes\n * @param data - The object containing data to redact\n * @param attributesToRedact - Single attribute name or array of attribute names to redact\n * @returns A new object with specified attributes redacted\n */\nfunction redactData(data: any, attributesToRedact: string | string[]): any {\n    if (!data || typeof data !== 'object') {\n        return data;\n    }\n\n    const attributes = Array.isArray(attributesToRedact) ? attributesToRedact : [attributesToRedact];\n    const redacted = { ...data };\n\n    for (const attr of attributes) {\n        if (attr in redacted) {\n            redacted[attr] = redactValue(redacted[attr]);\n        }\n    }\n\n    return redacted;\n}\n\n/**\n * Recursively redacts a value based on its type\n * @param value - The value to redact\n * @returns The redacted value\n */\nfunction redactValue(value: any): any {\n    if (typeof value === 'string') {\n        return '[REDACTED]';\n    } else if (Array.isArray(value)) {\n        return value.map((item) => redactValue(item));\n    } else if (value && typeof value === 'object') {\n        const redactedObj: any = {};\n        for (const key in value) {\n            if (value.hasOwnProperty(key)) {\n                redactedObj[key] = redactValue(value[key]);\n            }\n        }\n        return redactedObj;\n    }\n    return value; // Return as-is for other types (numbers, booleans, null, etc.)\n}\n\n/**\n * Validates that a scope value doesn't contain the '#' character which is reserved for scope construction\n */\nfunction validateScopeValue(scopeValue: string | number | Record<string, string | number>, scopeType: string): void {\n    if (typeof scopeValue === 'string' && scopeValue.includes('#')) {\n        throw new Error(`Scope value cannot contain '#' character. Found in ${scopeType} scope value: ${scopeValue}`);\n    }\n    if (typeof scopeValue === 'object' && scopeValue !== null) {\n        for (const [key, value] of Object.entries(scopeValue)) {\n            if (typeof value === 'string' && value.includes('#')) {\n                throw new Error(`Scope value cannot contain '#' character. Found in ${scopeType}.${key}: ${value}`);\n            }\n        }\n    }\n}\n\n/**\n * Constructs a scope string from scopeType and scopeValue\n * @param scopeType - The type of scope (chatapp, agent, tool, entity, agent-entity)\n * @param scopeValue - The value(s) for the scope\n * @returns The constructed scope string\n */\nfunction constructScope(scopeType: string, scopeValue: string | number | Record<string, string | number>): string {\n    // Validate scope value doesn't contain '#'\n    validateScopeValue(scopeValue, scopeType);\n\n    switch (scopeType) {\n        case 'chatapp':\n        case 'agent':\n        case 'tool':\n        case 'entity':\n            return `${scopeType}#${scopeValue}`;\n        case 'agent-entity':\n            if (typeof scopeValue !== 'object' || scopeValue === null) {\n                throw new Error('agent-entity scopeType requires an object with agent and entity properties');\n            }\n\n            const agentEntityValue = scopeValue as Record<string, string | number>;\n            if (!('agent' in agentEntityValue) || !('entity' in agentEntityValue)) {\n                throw new Error('agent-entity scopeType requires an object with both agent and entity properties');\n            }\n\n            return `agent#${agentEntityValue.agent}#entity#${agentEntityValue.entity}`;\n\n        default:\n            throw new Error(`Unsupported scopeType: ${scopeType}`);\n    }\n}\n\n/**\n * Parses a scope string back into scopeType and scopeValue\n * @param scope - The scope string to parse\n * @returns Object containing scopeType and scopeValue\n */\nfunction parseScope(scope: string): { scopeType: string; scopeValue: string | number | Record<string, string | number> } {\n    if (!scope || typeof scope !== 'string') {\n        throw new Error('Invalid scope: must be a non-empty string');\n    }\n\n    const parts = scope.split('#');\n    if (parts.length < 2) {\n        throw new Error(`Invalid scope format: ${scope}. Expected format: scopeType#scopeValue`);\n    }\n\n    const [firstType, firstValue, ...remaining] = parts;\n\n    // Handle compound scopes (agent-entity)\n    if (remaining.length >= 2 && firstType === 'agent' && remaining[0] === 'entity') {\n        return {\n            scopeType: 'agent-entity',\n            scopeValue: {\n                agent: firstValue,\n                entity: remaining[1]\n            }\n        };\n    }\n\n    // Handle simple scopes\n    if (remaining.length === 0) {\n        // For simple scopes, try to convert to number if it's numeric\n        const numericValue = Number(firstValue);\n        const scopeValue = !isNaN(numericValue) && isFinite(numericValue) ? numericValue : firstValue;\n\n        return {\n            scopeType: firstType,\n            scopeValue: scopeValue\n        };\n    }\n\n    throw new Error(`Unsupported scope format: ${scope}`);\n}\n\n// Export both functions\nexport { redactData, redactValue, constructScope, parseScope };\n"]}
+{"version":3,"sources":["../../src/util/server-client-utils.ts"],"names":[],"mappings":"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","file":"server-client-utils.mjs","sourcesContent":["/*\n * These are utils that are safe to use both on the server and the client.\n */\n\n/**\n * Helper function to redact sensitive data from specified attributes\n * @param data - The object containing data to redact\n * @param attributesToRedact - Single attribute name or array of attribute names to redact\n * @returns A new object with specified attributes redacted\n */\nfunction redactData(data: any, attributesToRedact: string | string[]): any {\n    if (!data || typeof data !== 'object') {\n        return data;\n    }\n\n    const attributes = Array.isArray(attributesToRedact) ? attributesToRedact : [attributesToRedact];\n    const redacted = { ...data };\n\n    for (const attr of attributes) {\n        if (attr in redacted) {\n            redacted[attr] = redactValue(redacted[attr]);\n        }\n    }\n\n    return redacted;\n}\n\n/**\n * Recursively redacts a value based on its type\n * @param value - The value to redact\n * @returns The redacted value\n */\nfunction redactValue(value: any): any {\n    if (typeof value === 'string') {\n        return '[REDACTED]';\n    } else if (Array.isArray(value)) {\n        return value.map((item) => redactValue(item));\n    } else if (value && typeof value === 'object') {\n        const redactedObj: any = {};\n        for (const key in value) {\n            if (value.hasOwnProperty(key)) {\n                redactedObj[key] = redactValue(value[key]);\n            }\n        }\n        return redactedObj;\n    }\n    return value; // Return as-is for other types (numbers, booleans, null, etc.)\n}\n\n/**\n * Validates that a scope value doesn't contain the '#' character which is reserved for scope construction\n */\nfunction validateScopeValue(scopeValue: string | number | Record<string, string | number>, scopeType: string): void {\n    if (typeof scopeValue === 'string' && scopeValue.includes('#')) {\n        throw new Error(`Scope value cannot contain '#' character. Found in ${scopeType} scope value: ${scopeValue}`);\n    }\n    if (typeof scopeValue === 'object' && scopeValue !== null) {\n        for (const [key, value] of Object.entries(scopeValue)) {\n            if (typeof value === 'string' && value.includes('#')) {\n                throw new Error(`Scope value cannot contain '#' character. Found in ${scopeType}.${key}: ${value}`);\n            }\n        }\n    }\n}\n\n/**\n * Constructs a scope string from scopeType and scopeValue\n * @param scopeType - The type of scope (chatapp, agent, tool, entity, agent-entity)\n * @param scopeValue - The value(s) for the scope\n * @returns The constructed scope string\n */\nfunction constructScope(scopeType: string, scopeValue: string | number | Record<string, string | number>): string {\n    // Validate scope value doesn't contain '#'\n    validateScopeValue(scopeValue, scopeType);\n\n    switch (scopeType) {\n        case 'chatapp':\n        case 'agent':\n        case 'tool':\n        case 'entity':\n            return `${scopeType}#${scopeValue}`;\n        case 'agent-entity':\n            if (typeof scopeValue !== 'object' || scopeValue === null) {\n                throw new Error('agent-entity scopeType requires an object with agent and entity properties');\n            }\n\n            const agentEntityValue = scopeValue as Record<string, string | number>;\n            if (!('agent' in agentEntityValue) || !('entity' in agentEntityValue)) {\n                throw new Error('agent-entity scopeType requires an object with both agent and entity properties');\n            }\n\n            return `agent#${agentEntityValue.agent}#entity#${agentEntityValue.entity}`;\n\n        default:\n            throw new Error(`Unsupported scopeType: ${scopeType}`);\n    }\n}\n\n/**\n * Parses a scope string back into scopeType and scopeValue\n * @param scope - The scope string to parse\n * @returns Object containing scopeType and scopeValue\n */\nfunction parseScope(scope: string): { scopeType: string; scopeValue: string | number | Record<string, string | number> } {\n    if (!scope || typeof scope !== 'string') {\n        throw new Error('Invalid scope: must be a non-empty string');\n    }\n\n    const parts = scope.split('#');\n    if (parts.length < 2) {\n        throw new Error(`Invalid scope format: ${scope}. Expected format: scopeType#scopeValue`);\n    }\n\n    const [firstType, firstValue, ...remaining] = parts;\n\n    // Handle compound scopes (agent-entity)\n    if (remaining.length >= 2 && firstType === 'agent' && remaining[0] === 'entity') {\n        return {\n            scopeType: 'agent-entity',\n            scopeValue: {\n                agent: firstValue,\n                entity: remaining[1]\n            }\n        };\n    }\n\n    // Handle simple scopes\n    if (remaining.length === 0) {\n        // For simple scopes, try to convert to number if it's numeric\n        const numericValue = Number(firstValue);\n        const scopeValue = !isNaN(numericValue) && isFinite(numericValue) ? numericValue : firstValue;\n\n        return {\n            scopeType: firstType,\n            scopeValue: scopeValue\n        };\n    }\n\n    throw new Error(`Unsupported scope format: ${scope}`);\n}\n\n/**\n * Useful for simple hashing like to figure out if content has changed since last sent or something.\n */\nasync function getContentHashString(content: unknown): Promise<string> {\n    const encoder = new TextEncoder();\n    const data = encoder.encode(JSON.stringify(content));\n    const hashBuffer = await crypto.subtle.digest('SHA-256', data);\n    const hashArray = Array.from(new Uint8Array(hashBuffer));\n    const hashHex = hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');\n    return hashHex;\n}\n\n// Export both functions\nexport { redactData, redactValue, constructScope, parseScope, getContentHashString };\n"]}