@ahmedramez-org/nexus-chat 1.0.0-beta.16 → 1.0.0-beta.18

package/contract/conformance.js

@@ -267,14 +267,37 @@ export async function checkHostContract(options, checkOptions = {}) {
         });
         ensure(new Set(kinds).size === kinds.length, 'a context kind is listed twice (a source replaces its bare kind: list only the source).');
     });
-    await checks.run('chat.triggers', 'each trigger is @ or # with a search', () => {
+    await checks.run('chat.triggers', 'each trigger is a bare @ or #, or one with a search', () => {
         const chars = (chat?.triggers ?? []).map((trigger) => {
+            if (typeof trigger === 'string') {
+                ensure(TRIGGER_CHARS.includes(trigger), `unknown trigger ${JSON.stringify(trigger)}; a bare string is one of: ${TRIGGER_CHARS.join(', ')}.`);
+                ensure(connection?.incortaApi?.type === 'bff', `the bare ${trigger} trigger needs a connection.incortaApi of type 'bff'.`);
+                return trigger;
+            }
             ensure(TRIGGER_CHARS.includes(trigger.char), `unknown trigger ${JSON.stringify(trigger.char)}.`);
             ensure(typeof trigger.search === 'function', `the ${trigger.char} trigger has no search().`);
             return trigger.char;
         });
         ensure(new Set(chars).size === chars.length, 'a trigger is listed twice.');
     });
+    const sessionLink = chat?.sessionLink;
+    if (!sessionLink) {
+        checks.skip('chat.sessionLink', 'links reopen a conversation', 'No session link declared.');
+    }
+    else {
+        await checks.run('chat.sessionLink', 'links reopen a conversation', () => {
+            const link = sessionLink('contract-check-session');
+            let absolute = false;
+            try {
+                absolute = typeof link === 'string' && /^https?:$/.test(new URL(link).protocol);
+            }
+            catch {
+                // A relative path throws: the link must carry the host's origin.
+            }
+            ensure(absolute, `chat.sessionLink must return an absolute URL; received ${JSON.stringify(link)}.`);
+            ensure(link.includes('contract-check-session'), 'chat.sessionLink must carry the conversation id.');
+        });
+    }
     await checks.run('actions', 'each action has can() and run()', () => {
         Object.entries(actions ?? {}).forEach(([name, action]) => {
             if (action === undefined)

package/contract/index.d.ts

@@ -133,15 +133,18 @@ export interface ValueMatch {
     dataType?: string;
     complete?: boolean;
 }
+/** The composer trigger characters the chat can serve itself. */
+export declare const BUILT_IN_TRIGGERS: readonly ["@", "#"];
+export type BuiltInTrigger = (typeof BUILT_IN_TRIGGERS)[number];
 /**
- * A composer trigger character. Both search inside the one attached business
- * view (`viewId` is that context's `id`); with none or several attached the
- * character stays plain text.
+ * A composer trigger the host serves. Both search inside the one attached
+ * business view (`viewId` is that context's `id`); with none or several
+ * attached the character stays plain text.
  *
  * - `@` mentions a column. Asked once per view; the chat filters as you type.
  * - `#` searches the view's values for the typed text.
  */
-export type TriggerSpec = {
+export type TriggerSource = {
     char: '@';
     search(request: {
         viewId: string;
@@ -154,6 +157,21 @@ export type TriggerSpec = {
         limit: number;
     }, signal: AbortSignal): Promise<readonly ValueMatch[]>;
 };
+/**
+ * One composer trigger; `chat.triggers` lists them.
+ *
+ * - A bare `'@'` or `'#'`: the chat serves it itself through a BFF
+ *   `connection.incortaApi`, across every attached business view and physical
+ *   table. The user can narrow to one view, then one column, and `#` searches
+ *   text columns only. Without a BFF `incortaApi` the character is left out
+ *   with a console warning.
+ * - A `TriggerSource`: the host serves it, for one attached view.
+ *
+ * List each character once. Migrating: code that read `trigger.char` must
+ * narrow with `typeof trigger === 'string'` first. Pass bare characters only
+ * to a chat that has them (this release or later): an older chat ignores them.
+ */
+export type TriggerSpec = BuiltInTrigger | TriggerSource;
 /** Switches for things the chat builds itself. Each one defaults to `true`. */
 export interface NexusChatFeatures {
     /**
@@ -274,6 +292,13 @@ export interface NexusChatChat {
     beforeSend?(request: {
         prompt: string;
     }): SendAddition | Promise<SendAddition>;
+    /**
+     * The absolute URL that reopens a saved conversation in this host (the
+     * instance root plus the conversation id, for example
+     * `https://host/incorta/?chat-session-id=<id>`, in the page query before any hash route, which in-app redirects never drop). The host reads that URL
+     * back and calls `handle.openSession`. Absent: no Copy link.
+     */
+    sessionLink?(sessionId: string): string;
 }
 export type OpenIntent = {
     type: 'open-dashboard';
@@ -438,6 +463,13 @@ export interface NexusChatHandle {
      * gates: the agent must support the kind; `false` when refused).
      */
     attach(kind: Exclude<ContextKind, 'file'>, item: ContextItem): boolean;
+    /**
+     * Opens a saved conversation by its id (a `chat.sessionLink` the host read
+     * back from its URL). A conversation with no messages, or one the backend
+     * refuses (deleted, someone else's), stays closed and the chat says so.
+     * While an unsent question is still being recovered nothing opens.
+     */
+    openSession(sessionId: string): void;
 }
 /** The federated entry point `nexusChat/mount`. */
 export type NexusChatMount = (element: HTMLElement, options: NexusChatOptions) => NexusChatHandle;

package/contract/index.js

@@ -11,6 +11,8 @@ export const BUILT_IN_CONTEXT_KINDS = [
     'ai-container',
     'knowledge-store',
 ];
+/** The composer trigger characters the chat can serve itself. */
+export const BUILT_IN_TRIGGERS = ['@', '#'];
 /**
  * Reads the namespaced-kind convention. Returns null for bare legacy kinds.
  * Framework-free on purpose: hosts use this inside `canRender` to route by

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahmedramez-org/nexus-chat",
-  "version": "1.0.0-beta.16",
+  "version": "1.0.0-beta.18",
   "description": "NexusChat for any app: a connector and React component that load the prebuilt chat from IncortaCopilot (or a pinned copy), and the host contract types and checks.",
   "license": "UNLICENSED",
   "repository": {

package/react.js

@@ -304,7 +304,7 @@ function EmbeddedChat({ embedUrl, modes, defaultMode, theme = 'light', locale })
           ref: frame,
           title: NAME,
           src,
-          allow: 'storage-access; microphone',
+          allow: 'storage-access; microphone; clipboard-write',
           style: { display: 'block', width: '100%', height: '100%', border: 0 },
         }),
     ),

package/window.js

@@ -357,7 +357,7 @@ export function createEmbeddedChat({
     if (embedded || !win.opened) return;
     const iframe = document.createElement('iframe');
     iframe.title = NAME;
-    iframe.allow = 'storage-access; microphone';
+    iframe.allow = 'storage-access; microphone; clipboard-write';
     iframe.src = embedSrc(embedUrl, theme, locale);
     iframe.style.cssText = 'display:block;width:100%;height:100%;border:0';
     win.panel.prepend(iframe);