@jini-ai/chat 0.6.15-rc.2 → 0.6.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jini-ai/chat",
-  "version": "0.6.15-rc.2",
+  "version": "0.6.16",
   "description": "Jini's chat/artifact frontend, consolidated into one package with two subpaths: framework-free chat vocabulary and pure parsers in `/core`, headless hooks + presentational components + slots in `/react`. Import only the layer you need.",
   "license": "Apache-2.0",
   "repository": {
@@ -33,22 +33,39 @@
       "./transports/http": "universal",
       "./transports/ag-ui": "universal",
       "./browser/session-store": "browser",
-      "./browser/page-actions": "browser",
       "./server/durable-runs": "node",
       "./store/runtime": "node",
       "./vanilla": "browser",
       "./browser/lazy-loader": "browser",
-      "./vanilla/style.css": "browser"
+      "./vanilla/style.css": "browser",
+      "./browser/frontend-session-bridge": "browser"
     },
     "neutralEntries": [
       "src/store/contracts"
     ],
     "isolation": {
       "entries": {
-        "./browser/page-actions": "core",
         "./transports/http": "core",
-        "./transports/ag-ui": "core"
+        "./transports/ag-ui": "core",
+        "./browser/frontend-session-bridge": "core"
       }
+    },
+    "optionalPeers": {
+      "better-sqlite3": "opt-in: sqlite storage — SQLite storage could not load better-sqlite3. Install better-sqlite3 to enable this feature, or check its installed version and native binaries.",
+      "@electric-sql/pglite": "opt-in: embedded postgresql storage — Embedded PostgreSQL storage could not load @electric-sql/pglite. Install @electric-sql/pglite to enable this feature, or check its installed version and native binaries.",
+      "pg": "opt-in: postgresql storage — PostgreSQL storage could not load pg. Install pg to enable this feature, or check its installed version and native binaries.",
+      "@ag-ui/core": "opt-in: ag ui protocol adapter; import @jini-ai/chat/core/ag-ui — AG UI protocol adapter could not load @ag-ui/core. Install @ag-ui/core to enable this feature, or check its installed version and native binaries.",
+      "@mcp-ui/client": "opt-in: mcp ui renderer; import @jini-ai/chat/react — MCP UI renderer could not load @mcp-ui/client. Install @mcp-ui/client to enable this feature, or check its installed version and native binaries.",
+      "@radix-ui/react-checkbox": "opt-in: interactive ui controls; import @jini-ai/chat/react — Interactive UI controls could not load @radix-ui/react-checkbox. Install @radix-ui/react-checkbox to enable this feature, or check its installed version and native binaries.",
+      "@radix-ui/react-label": "opt-in: interactive ui controls; import @jini-ai/chat/react — Interactive UI controls could not load @radix-ui/react-label. Install @radix-ui/react-label to enable this feature, or check its installed version and native binaries.",
+      "@radix-ui/react-radio-group": "opt-in: interactive ui controls; import @jini-ai/chat/react — Interactive UI controls could not load @radix-ui/react-radio-group. Install @radix-ui/react-radio-group to enable this feature, or check its installed version and native binaries.",
+      "@radix-ui/react-select": "opt-in: interactive ui controls; import @jini-ai/chat/react — Interactive UI controls could not load @radix-ui/react-select. Install @radix-ui/react-select to enable this feature, or check its installed version and native binaries.",
+      "@radix-ui/react-slot": "opt-in: interactive ui controls — Interactive UI controls could not load @radix-ui/react-slot. Install @radix-ui/react-slot to enable this feature, or check its installed version and native binaries.",
+      "@jini-ai/agent-runtime": "opt-in: agent execution adapters; import @jini-ai/chat/react — Agent execution adapters could not load @jini-ai/agent-runtime. Install @jini-ai/agent-runtime to enable this feature, or check its installed version and native binaries.",
+      "@jini-ai/protocol": "opt-in: agent protocol adapters; import @jini-ai/chat/server/durable-runs — Agent protocol adapters could not load @jini-ai/protocol. Install @jini-ai/protocol to enable this feature, or check its installed version and native binaries.",
+      "@jini-ai/ui": "opt-in: ui integrations; import @jini-ai/chat/react — UI integrations could not load @jini-ai/ui. Install @jini-ai/ui to enable this feature, or check its installed version and native binaries.",
+      "react": "opt-in: react chat ui; import @jini-ai/chat/react — React chat UI could not load react. Install react to enable this feature, or check its installed version.",
+      "react-dom": "opt-in: react chat ui; import @jini-ai/chat/react — React chat UI could not load react-dom. Install react-dom to enable this feature, or check its installed version."
     }
   },
   "type": "module",
@@ -150,11 +167,6 @@
       "import": "./dist/embed-widget/browser/session-store.js",
       "default": "./dist/embed-widget/browser/session-store.js"
     },
-    "./browser/page-actions": {
-      "types": "./dist/embed-widget/browser/page-actions.d.ts",
-      "import": "./dist/embed-widget/browser/page-actions.js",
-      "default": "./dist/embed-widget/browser/page-actions.js"
-    },
     "./server/durable-runs": {
       "types": "./dist/server/durable-runs/entry.d.ts",
       "import": "./dist/server/durable-runs/entry.js",
@@ -175,7 +187,12 @@
       "import": "./dist/embed-widget/browser/lazy-loader.js",
       "default": "./dist/embed-widget/browser/lazy-loader.js"
     },
-    "./vanilla/style.css": "./dist/embed-widget/vanilla/style.css"
+    "./vanilla/style.css": "./dist/embed-widget/vanilla/style.css",
+    "./browser/frontend-session-bridge": {
+      "types": "./dist/embed-widget/browser/frontend-session-bridge.d.ts",
+      "import": "./dist/embed-widget/browser/frontend-session-bridge.js",
+      "default": "./dist/embed-widget/browser/frontend-session-bridge.js"
+    }
   },
   "files": [
     "dist",
@@ -196,13 +213,15 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@jini-ai/core": "^0.6.15-rc.2"
+    "kysely": "^0.29.6",
+    "@jini-ai/core": "^0.6.16",
+    "@jini-ai/diagnostics": "^0.6.16",
+    "@jini-ai/db": "^0.6.16",
+    "@jini-ai/agentic": "^0.6.16"
   },
   "peerDependencies": {
     "react": "^18.3.0 || ^19.0.0",
     "react-dom": "^18.3.0 || ^19.0.0",
-    "@jini-ai/db": "^0.6.15-rc.2",
-    "kysely": "^0.29.6",
     "better-sqlite3": "^13.0.0",
     "@electric-sql/pglite": "0.5.8",
     "pg": "^8.23.0",
@@ -213,70 +232,9 @@
     "@radix-ui/react-radio-group": "^1.4.7",
     "@radix-ui/react-select": "^2.3.7",
     "@radix-ui/react-slot": "^1.3.3",
-    "@jini-ai/agent-runtime": "^0.6.15-rc.2",
-    "@jini-ai/agentic": "^0.6.15-rc.2",
-    "@jini-ai/protocol": "^0.6.15-rc.2",
-    "@jini-ai/ui": "^0.6.15-rc.2",
-    "@jini-ai/diagnostics": "^0.6.15-rc.2"
-  },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    },
-    "react-dom": {
-      "optional": true
-    },
-    "@jini-ai/db": {
-      "optional": true
-    },
-    "kysely": {
-      "optional": true
-    },
-    "better-sqlite3": {
-      "optional": true
-    },
-    "@electric-sql/pglite": {
-      "optional": true
-    },
-    "pg": {
-      "optional": true
-    },
-    "@ag-ui/core": {
-      "optional": true
-    },
-    "@mcp-ui/client": {
-      "optional": true
-    },
-    "@radix-ui/react-checkbox": {
-      "optional": true
-    },
-    "@radix-ui/react-label": {
-      "optional": true
-    },
-    "@radix-ui/react-radio-group": {
-      "optional": true
-    },
-    "@radix-ui/react-select": {
-      "optional": true
-    },
-    "@radix-ui/react-slot": {
-      "optional": true
-    },
-    "@jini-ai/agent-runtime": {
-      "optional": true
-    },
-    "@jini-ai/agentic": {
-      "optional": true
-    },
-    "@jini-ai/protocol": {
-      "optional": true
-    },
-    "@jini-ai/ui": {
-      "optional": true
-    },
-    "@jini-ai/diagnostics": {
-      "optional": true
-    }
+    "@jini-ai/agent-runtime": "^0.6.10",
+    "@jini-ai/protocol": "^0.6.10",
+    "@jini-ai/ui": "^0.6.10"
   },
   "devDependencies": {
     "@mcp-ui/client": "7.1.1",
@@ -303,13 +261,13 @@
     "pg": "8.23.0",
     "@ag-ui/core": "0.0.58",
     "fast-check": "4.3.0",
-    "@jini-ai/db": "0.6.15-rc.2",
-    "@jini-ai/agentic": "^0.6.15-rc.2",
-    "@jini-ai/agent-runtime": "0.6.15-rc.2",
-    "@jini-ai/ui": "^0.6.15-rc.2",
-    "@jini-ai/core": "^0.6.15-rc.2",
-    "@jini-ai/protocol": "^0.6.15-rc.2",
-    "@jini-ai/diagnostics": "^0.6.15-rc.2"
+    "@jini-ai/agent-runtime": "0.6.16",
+    "@jini-ai/db": "0.6.16",
+    "@jini-ai/agentic": "^0.6.16",
+    "@jini-ai/diagnostics": "^0.6.16",
+    "@jini-ai/core": "^0.6.16",
+    "@jini-ai/protocol": "^0.6.16",
+    "@jini-ai/ui": "^0.6.16"
   },
   "typesVersions": {
     "*": {
@@ -361,9 +319,6 @@
       "browser/session-store": [
         "./dist/embed-widget/browser/session-store.d.ts"
       ],
-      "browser/page-actions": [
-        "./dist/embed-widget/browser/page-actions.d.ts"
-      ],
       "server/durable-runs": [
         "./dist/server/durable-runs/entry.d.ts"
       ],
@@ -375,9 +330,59 @@
       ],
       "browser/lazy-loader": [
         "./dist/embed-widget/browser/lazy-loader.d.ts"
+      ],
+      "browser/frontend-session-bridge": [
+        "./dist/embed-widget/browser/frontend-session-bridge.d.ts"
       ]
     }
   },
+  "peerDependenciesMeta": {
+    "better-sqlite3": {
+      "optional": true
+    },
+    "@electric-sql/pglite": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    },
+    "@ag-ui/core": {
+      "optional": true
+    },
+    "@mcp-ui/client": {
+      "optional": true
+    },
+    "@radix-ui/react-checkbox": {
+      "optional": true
+    },
+    "@radix-ui/react-label": {
+      "optional": true
+    },
+    "@radix-ui/react-radio-group": {
+      "optional": true
+    },
+    "@radix-ui/react-select": {
+      "optional": true
+    },
+    "@radix-ui/react-slot": {
+      "optional": true
+    },
+    "@jini-ai/agent-runtime": {
+      "optional": true
+    },
+    "@jini-ai/protocol": {
+      "optional": true
+    },
+    "@jini-ai/ui": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json && mkdir -p dist/react/styles && cp src/react/styles/reference.css dist/react/styles/ && mkdir -p dist/embed-widget/vanilla && node --input-type=module -e \"import {writeFileSync,readFileSync} from 'node:fs'; import {CHAT_BUBBLE_STYLE} from './dist/embed-widget/browser/lazy-loader.js'; writeFileSync('dist/embed-widget/vanilla/style.css',CHAT_BUBBLE_STYLE+'\\n'+readFileSync('src/embed-widget/vanilla/style.css','utf8'));\"",
     "typecheck": "tsc -p tsconfig.json --noEmit",

package/dist/core/browser/page-actions.d.ts

@@ -1,121 +0,0 @@
-/** Resolved target supplied by the host; the client never derives a path from a title. */
-export interface ResolvedPageTarget {
-    readonly slug: string;
-    readonly title: string;
-    readonly path: string;
-}
-export type PageAction = {
-    readonly type: 'navigate';
-    readonly target: ResolvedPageTarget;
-    readonly auto: boolean;
-} | {
-    readonly type: 'scroll_to' | 'highlight';
-    readonly target: ResolvedPageTarget;
-};
-export type NavigateAction = Extract<PageAction, {
-    type: 'navigate';
-}>;
-export type NonNavigateAction = Exclude<PageAction, {
-    type: 'navigate';
-}>;
-export interface DirectiveCarryingEvent {
-    readonly kind: string;
-    readonly name?: string;
-    readonly data?: unknown;
-}
-export interface SplitPageActions {
-    readonly navigate: NavigateAction | null;
-    readonly other: NonNavigateAction | null;
-}
-/** Narrows an untrusted, bare queued action. URL authorization remains a separate host policy. O(1). */
-export declare function isQueuedPageAction(args: {
-    value: unknown;
-}): args is {
-    value: PageAction;
-};
-/** Narrows an untrusted directive envelope, dropping unknown kinds. O(1). */
-export declare function isPageActionDirective(args: {
-    value: unknown;
-}): args is {
-    value: {
-        kind: 'page_action';
-        action: PageAction;
-    };
-};
-/** Preserves valid action order while ignoring unrelated events. O(events) time and output space. */
-export declare function extractPageActions({ events, directiveEventName }: {
-    events: readonly DirectiveCarryingEvent[] | undefined;
-    directiveEventName: string;
-}): PageAction[];
-/** Returns only the first navigation and first page treatment. O(actions), O(1) extra space. */
-export declare function splitPageActions({ actions }: {
-    actions: readonly PageAction[];
-}): SplitPageActions;
-export interface TargetSelectionPolicy {
-    readonly candidateSelector: string;
-    readonly excludedAncestorSelector: string;
-}
-/** Exact title match first, case-insensitive fallback; never searches excluded UI. O(candidates). */
-export declare function findTargetElement({ title, root, selection }: {
-    title: string;
-    root: Pick<ParentNode, 'querySelectorAll'>;
-    selection: TargetSelectionPolicy;
-}): Element | null;
-export interface PageActionTimerPort {
-    schedule(args: {
-        callback: () => void;
-        delayMs: number;
-    }): unknown;
-    cancel(args: {
-        handle: unknown;
-    }): void;
-}
-export interface PageActionPort {
-    allows(args: {
-        action: PageAction;
-    }): boolean;
-    navigate(args: {
-        action: NavigateAction;
-    }): boolean;
-    execute(args: {
-        action: NonNavigateAction;
-    }): boolean;
-    clearHighlight(args: Record<string, never>): void;
-}
-export interface BrowserPageActionController extends PageActionPort {
-    applyHighlight(args: {
-        element: Element;
-    }): void;
-    scrollToElement(args: {
-        element: Element;
-    }): void;
-}
-export interface BrowserPageActionsArgs {
-    readonly root: Pick<ParentNode, 'querySelectorAll'>;
-    readonly selection: TargetSelectionPolicy;
-    readonly allowPath: (args: {
-        path: string;
-    }) => boolean;
-    readonly navigate: (args: {
-        path: string;
-    }) => void;
-    readonly reducedMotion: (args: Record<string, never>) => boolean;
-    readonly scroll: (args: {
-        element: Element;
-        options: ScrollIntoViewOptions;
-    }) => void;
-    readonly timers: PageActionTimerPort;
-    readonly highlightClass: string;
-    readonly fadeAnimationName: string;
-    readonly cleanupFallbackMs: number;
-}
-/**
- * Creates page effects with injected DOM, navigation, URL policy, scroll and timers.
- * At most one highlight belongs to this instance; cleanup and navigation remove it.
- * URL policy is checked before queueing, navigation or page effects. Stale timers and descendant
- * animation events cannot remove the current highlight. Navigation paths are resolved by the host,
- * never guessed from a title; each controller owns its mutable highlight state.
- * @complexity Execute O(candidates); other operations O(1), with one timer/listener retained.
- */
-export declare function createBrowserPageActions(args: BrowserPageActionsArgs): BrowserPageActionController;
-//# sourceMappingURL=page-actions.d.ts.map

package/dist/core/browser/page-actions.js

@@ -1,115 +0,0 @@
-function record(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function target(value) {
-    return record(value) && typeof value.slug === 'string' && typeof value.title === 'string' && typeof value.path === 'string';
-}
-/** Narrows an untrusted, bare queued action. URL authorization remains a separate host policy. O(1). */
-export function isQueuedPageAction(args) {
-    const { value } = args;
-    if (!record(value) || !target(value.target))
-        return false;
-    return value.type === 'navigate' ? typeof value.auto === 'boolean' : value.type === 'scroll_to' || value.type === 'highlight';
-}
-/** Narrows an untrusted directive envelope, dropping unknown kinds. O(1). */
-export function isPageActionDirective(args) {
-    const { value } = args;
-    return record(value) && value.kind === 'page_action' && isQueuedPageAction({ value: value.action });
-}
-/** Preserves valid action order while ignoring unrelated events. O(events) time and output space. */
-export function extractPageActions({ events, directiveEventName }) {
-    const actions = [];
-    for (const event of events ?? []) {
-        const envelope = { value: event.data };
-        if (event.kind === 'ext' && event.name === directiveEventName && isPageActionDirective(envelope)) {
-            actions.push(envelope.value.action);
-        }
-    }
-    return actions;
-}
-/** Returns only the first navigation and first page treatment. O(actions), O(1) extra space. */
-export function splitPageActions({ actions }) {
-    return {
-        navigate: actions.find((a) => a.type === 'navigate') ?? null,
-        other: actions.find((a) => a.type !== 'navigate') ?? null,
-    };
-}
-/** Exact title match first, case-insensitive fallback; never searches excluded UI. O(candidates). */
-export function findTargetElement({ title, root, selection }) {
-    const needle = title.trim();
-    if (!needle)
-        return null;
-    const candidates = Array.from(root.querySelectorAll(selection.candidateSelector))
-        .filter(el => !el.closest(selection.excludedAncestorSelector));
-    // `textContent` is null only for documents and doctypes; every Element the selector yields has a string.
-    const text = (el) => el.textContent.trim();
-    return candidates.find(el => text(el) === needle)
-        ?? candidates.find(el => text(el).toLowerCase() === needle.toLowerCase()) ?? null;
-}
-/**
- * Creates page effects with injected DOM, navigation, URL policy, scroll and timers.
- * At most one highlight belongs to this instance; cleanup and navigation remove it.
- * URL policy is checked before queueing, navigation or page effects. Stale timers and descendant
- * animation events cannot remove the current highlight. Navigation paths are resolved by the host,
- * never guessed from a title; each controller owns its mutable highlight state.
- * @complexity Execute O(candidates); other operations O(1), with one timer/listener retained.
- */
-export function createBrowserPageActions(args) {
-    if (!Number.isFinite(args.cleanupFallbackMs) || args.cleanupFallbackMs < 0)
-        throw new Error('Invalid highlight deadline');
-    let current = null;
-    const clearHighlight = (_args) => {
-        if (!current)
-            return;
-        const old = current;
-        current = null;
-        args.timers.cancel({ handle: old.handle });
-        old.element.removeEventListener('animationend', old.onEnd);
-        old.element.classList.remove(args.highlightClass);
-    };
-    function highlight(element) {
-        if (current?.element === element)
-            return;
-        clearHighlight({});
-        const onEnd = event => {
-            if (event.target === element && event.animationName === args.fadeAnimationName)
-                clearHighlight({});
-        };
-        element.classList.add(args.highlightClass);
-        element.addEventListener('animationend', onEnd);
-        // Identity check makes even a late callback from a canceled timer harmless.
-        const handle = args.timers.schedule({ delayMs: args.cleanupFallbackMs, callback: () => {
-                if (current?.element === element && current.onEnd === onEnd)
-                    clearHighlight({});
-            } });
-        current = { element, handle, onEnd };
-    }
-    const scrollToElement = ({ element }) => {
-        args.scroll({ element, options: { behavior: args.reducedMotion({}) ? 'auto' : 'smooth', block: 'center' } });
-    };
-    return {
-        applyHighlight({ element }) { highlight(element); },
-        scrollToElement,
-        allows({ action }) { return args.allowPath({ path: action.target.path }); },
-        navigate({ action }) {
-            if (!args.allowPath({ path: action.target.path }))
-                return false;
-            clearHighlight({});
-            args.navigate({ path: action.target.path });
-            return true;
-        },
-        execute({ action }) {
-            if (!args.allowPath({ path: action.target.path }))
-                return false;
-            const element = findTargetElement({ title: action.target.title, root: args.root, selection: args.selection });
-            if (!element)
-                return false;
-            scrollToElement({ element });
-            if (action.type === 'highlight')
-                highlight(element);
-            return true;
-        },
-        clearHighlight,
-    };
-}
-//# sourceMappingURL=page-actions.js.map

package/dist/embed-widget/browser/page-actions.d.ts

@@ -1,2 +0,0 @@
-export * from '../../core/browser/page-actions.js';
-//# sourceMappingURL=page-actions.d.ts.map

package/dist/embed-widget/browser/page-actions.js

@@ -1,3 +0,0 @@
-// Compatibility path; shared page-action decisions belong to chat core.
-export * from '../../core/browser/page-actions.js';
-//# sourceMappingURL=page-actions.js.map