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

package/contract/conformance.js

@@ -280,6 +280,24 @@ export async function checkHostContract(options, checkOptions = {}) {
         });
         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

@@ -292,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';
@@ -456,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahmedramez-org/nexus-chat",
-  "version": "1.0.0-beta.17",
+  "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": {