@datalayer/agent-runtimes 1.0.29 → 1.3.11

package/lib/examples/scenes/A2UiViewerScene.js

@@ -0,0 +1,395 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/*
+ * Scene extracted from the A2UiViewerExample page: the same canned A2UI
+ * messages, rendered as a Loop workspace view. The page itself now mounts
+ * a reactor application with this scene as a plugin.
+ */
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { Box } from '@datalayer/primer-addons';
+import { SegmentedControl, Text } from '@primer/react';
+import { A2UI_RENDER_SCOPE_SX, A2uiSurfaceComposed, } from '../../components/a2ui';
+import { A2uiMarkdownProvider } from '../utils/a2uiMarkdownProvider';
+import { createSceneMessages, useA2uiProcessor } from '../utils/a2ui';
+const SCENES = [
+    {
+        id: 'recipe',
+        label: 'Recipe Card',
+        emoji: '🍲',
+        description: 'Rich recipe card with image and metadata.',
+        messages: createSceneMessages({
+            surfaceId: 'viewer-recipe',
+            components: [
+                { id: 'root', component: 'Card', child: 'main' },
+                {
+                    id: 'main',
+                    component: 'Column',
+                    children: [
+                        'recipe-image',
+                        'title',
+                        'rating-row',
+                        'timing-row',
+                        'servings',
+                    ],
+                },
+                {
+                    id: 'recipe-image',
+                    component: 'Image',
+                    url: { path: '/image' },
+                    fit: 'cover',
+                    variant: 'largeFeature',
+                },
+                {
+                    id: 'title',
+                    component: 'Text',
+                    variant: 'h3',
+                    text: { path: '/title' },
+                },
+                {
+                    id: 'rating-row',
+                    component: 'Row',
+                    align: 'center',
+                    children: ['star', 'rating', 'reviews'],
+                },
+                { id: 'star', component: 'Icon', name: 'star' },
+                { id: 'rating', component: 'Text', text: { path: '/rating' } },
+                {
+                    id: 'reviews',
+                    component: 'Text',
+                    variant: 'caption',
+                    text: { path: '/reviewCount' },
+                },
+                { id: 'timing-row', component: 'Row', children: ['prep', 'cook'] },
+                {
+                    id: 'prep',
+                    component: 'Text',
+                    variant: 'caption',
+                    text: { path: '/prepTime' },
+                },
+                {
+                    id: 'cook',
+                    component: 'Text',
+                    variant: 'caption',
+                    text: { path: '/cookTime' },
+                },
+                {
+                    id: 'servings',
+                    component: 'Text',
+                    variant: 'caption',
+                    text: { path: '/servings' },
+                },
+            ],
+            value: {
+                image: 'https://images.unsplash.com/photo-1546069901-ba9599a7e63c?w=300&h=180&fit=crop',
+                title: 'Mediterranean Quinoa Bowl',
+                rating: '4.9',
+                reviewCount: '(1,247 reviews)',
+                prepTime: '15 min prep',
+                cookTime: '20 min cook',
+                servings: 'Serves 4',
+            },
+        }),
+    },
+    {
+        id: 'booking',
+        label: 'Booking Form',
+        emoji: '📅',
+        description: 'Form controls and a submit action payload.',
+        messages: createSceneMessages({
+            surfaceId: 'viewer-booking',
+            components: [
+                {
+                    id: 'root',
+                    component: 'Column',
+                    children: [
+                        'title',
+                        'party-size',
+                        'date-time',
+                        'dietary',
+                        'submit-label',
+                        'submit-button',
+                    ],
+                },
+                {
+                    id: 'title',
+                    component: 'Text',
+                    variant: 'h2',
+                    text: { path: '/title' },
+                },
+                {
+                    id: 'party-size',
+                    component: 'TextField',
+                    label: 'Party Size',
+                    value: { path: '/partySize' },
+                },
+                {
+                    id: 'date-time',
+                    component: 'DateTimeInput',
+                    label: 'Date & Time',
+                    value: { path: '/dateTime' },
+                },
+                {
+                    id: 'dietary',
+                    component: 'TextField',
+                    label: 'Dietary Requirements',
+                    value: { path: '/dietary' },
+                    variant: 'longText',
+                },
+                { id: 'submit-label', component: 'Text', text: 'Submit Reservation' },
+                {
+                    id: 'submit-button',
+                    component: 'Button',
+                    variant: 'primary',
+                    child: 'submit-label',
+                    action: {
+                        event: {
+                            name: 'submit_booking',
+                            context: {
+                                partySize: { path: '/partySize' },
+                                dateTime: { path: '/dateTime' },
+                                dietary: { path: '/dietary' },
+                            },
+                        },
+                    },
+                },
+            ],
+            value: {
+                title: 'Book Your Table',
+                partySize: '4',
+                dateTime: '2026-05-15T19:30:00Z',
+                dietary: 'No peanuts',
+            },
+        }),
+    },
+    {
+        id: 'dashboard',
+        label: 'Sales Snapshot',
+        emoji: '📈',
+        description: 'Nested cards and list-like KPI tiles.',
+        messages: createSceneMessages({
+            surfaceId: 'viewer-dashboard',
+            components: [
+                {
+                    id: 'root',
+                    component: 'Column',
+                    children: ['headline', 'subtitle', 'tiles'],
+                },
+                {
+                    id: 'headline',
+                    component: 'Text',
+                    variant: 'h2',
+                    text: 'Sales by Category',
+                },
+                { id: 'subtitle', component: 'Text', text: 'Q2 performance snapshot' },
+                {
+                    id: 'tiles',
+                    component: 'Column',
+                    children: ['tile-1', 'tile-2', 'tile-3', 'tile-4'],
+                },
+                { id: 'tile-1', component: 'Card', child: 'tile-1-row' },
+                {
+                    id: 'tile-1-row',
+                    component: 'Row',
+                    justify: 'spaceBetween',
+                    children: ['tile-1-label', 'tile-1-value'],
+                },
+                {
+                    id: 'tile-1-label',
+                    component: 'Text',
+                    variant: 'caption',
+                    text: 'Apparel',
+                },
+                {
+                    id: 'tile-1-value',
+                    component: 'Text',
+                    variant: 'h3',
+                    text: '$41,200',
+                },
+                { id: 'tile-2', component: 'Card', child: 'tile-2-row' },
+                {
+                    id: 'tile-2-row',
+                    component: 'Row',
+                    justify: 'spaceBetween',
+                    children: ['tile-2-label', 'tile-2-value'],
+                },
+                {
+                    id: 'tile-2-label',
+                    component: 'Text',
+                    variant: 'caption',
+                    text: 'Electronics',
+                },
+                {
+                    id: 'tile-2-value',
+                    component: 'Text',
+                    variant: 'h3',
+                    text: '$28,900',
+                },
+                { id: 'tile-3', component: 'Card', child: 'tile-3-row' },
+                {
+                    id: 'tile-3-row',
+                    component: 'Row',
+                    justify: 'spaceBetween',
+                    children: ['tile-3-label', 'tile-3-value'],
+                },
+                {
+                    id: 'tile-3-label',
+                    component: 'Text',
+                    variant: 'caption',
+                    text: 'Home Goods',
+                },
+                {
+                    id: 'tile-3-value',
+                    component: 'Text',
+                    variant: 'h3',
+                    text: '$15,600',
+                },
+                { id: 'tile-4', component: 'Card', child: 'tile-4-row' },
+                {
+                    id: 'tile-4-row',
+                    component: 'Row',
+                    justify: 'spaceBetween',
+                    children: ['tile-4-label', 'tile-4-value'],
+                },
+                {
+                    id: 'tile-4-label',
+                    component: 'Text',
+                    variant: 'caption',
+                    text: 'Health & Beauty',
+                },
+                {
+                    id: 'tile-4-value',
+                    component: 'Text',
+                    variant: 'h3',
+                    text: '$10,300',
+                },
+            ],
+        }),
+    },
+    {
+        id: 'shipping',
+        label: 'Shipping Status',
+        emoji: '📦',
+        description: 'Order fulfillment timeline with current package state.',
+        messages: createSceneMessages({
+            surfaceId: 'viewer-shipping',
+            components: [
+                { id: 'root', component: 'Card', child: 'main' },
+                {
+                    id: 'main',
+                    component: 'Column',
+                    children: [
+                        'title-row',
+                        'tracking',
+                        'divider',
+                        'status-1',
+                        'status-2',
+                        'status-3',
+                        'eta',
+                    ],
+                },
+                {
+                    id: 'title-row',
+                    component: 'Row',
+                    align: 'center',
+                    children: ['title-icon', 'title'],
+                },
+                { id: 'title-icon', component: 'Icon', name: 'inventory' },
+                {
+                    id: 'title',
+                    component: 'Text',
+                    variant: 'h2',
+                    text: 'Package Status',
+                },
+                {
+                    id: 'tracking',
+                    component: 'Text',
+                    variant: 'caption',
+                    text: { path: '/tracking' },
+                },
+                { id: 'divider', component: 'Divider' },
+                { id: 'status-1', component: 'Text', text: { path: '/statusPlaced' } },
+                { id: 'status-2', component: 'Text', text: { path: '/statusShipped' } },
+                {
+                    id: 'status-3',
+                    component: 'Text',
+                    variant: 'h3',
+                    text: { path: '/statusDelivery' },
+                },
+                {
+                    id: 'eta',
+                    component: 'Text',
+                    variant: 'caption',
+                    text: { path: '/eta' },
+                },
+            ],
+            value: {
+                tracking: 'Tracking: 17999AA10123456784',
+                statusPlaced: '✓ Order Placed',
+                statusShipped: '✓ Shipped',
+                statusDelivery: '🚚 Out for Delivery',
+                eta: 'Estimated delivery: Today by 8 PM',
+            },
+        }),
+    },
+];
+function ViewerContent({ onAction, }) {
+    const { surfaces, processMessages, resetSurfaces, themeStyle } = useA2uiProcessor(onAction);
+    const [selectedSceneId, setSelectedSceneId] = useState(SCENES[0].id);
+    const selectedScene = useMemo(() => SCENES.find(scene => scene.id === selectedSceneId) ?? SCENES[0], [selectedSceneId]);
+    useEffect(() => {
+        resetSurfaces();
+        processMessages(selectedScene.messages);
+    }, [selectedScene, processMessages, resetSurfaces]);
+    return (_jsxs(Box, { sx: { display: 'flex', flexDirection: 'column', gap: 3, p: 3 }, children: [_jsxs(Box, { sx: {
+                    width: '100%',
+                    border: '1px solid',
+                    borderColor: 'border.default',
+                    borderRadius: 2,
+                    p: 3,
+                    backgroundColor: 'canvas.default',
+                    display: 'flex',
+                    flexDirection: 'column',
+                    gap: 3,
+                }, children: [_jsx(Text, { sx: { fontSize: 2, fontWeight: 'bold' }, children: "Select Scene" }), _jsx(SegmentedControl, { "aria-label": "A2UI viewer scene picker", fullWidth: true, children: SCENES.map(scene => (_jsx(SegmentedControl.Button, { selected: scene.id === selectedSceneId, onClick: () => setSelectedSceneId(scene.id), children: `${scene.emoji} ${scene.label}` }, scene.id))) }), _jsx(Text, { sx: { color: 'fg.muted', fontSize: 1 }, children: selectedScene.description })] }), _jsx(Box, { style: themeStyle, sx: {
+                    ...A2UI_RENDER_SCOPE_SX,
+                    width: '100%',
+                    display: 'flex',
+                    flexDirection: 'column',
+                    gap: 3,
+                }, children: surfaces.map(surface => (_jsx(Box, { sx: { width: '100%' }, children: _jsx(A2uiSurfaceComposed, { surface: surface }) }, surface.id))) })] }));
+}
+const A2UiViewerScene = () => {
+    const [lastAction, setLastAction] = useState(null);
+    const handleAction = useCallback((action) => {
+        console.log('A2UI Viewer Action:', action);
+        setLastAction(action);
+    }, []);
+    return (_jsx(_Fragment, { children: _jsx(A2uiMarkdownProvider, { children: _jsxs(Box, { sx: {
+                    height: '100%',
+                    overflow: 'auto',
+                    display: 'flex',
+                    flexDirection: 'column',
+                }, children: [_jsxs(Box, { sx: {
+                            px: 3,
+                            py: 3,
+                            borderBottom: '1px solid',
+                            borderColor: 'border.default',
+                            backgroundColor: 'canvas.default',
+                        }, children: [_jsx(Text, { as: "h1", sx: { fontSize: 3, fontWeight: 'bold' }, children: "\uD83D\uDD0D A2UI Viewer" }), _jsx(Text, { sx: { color: 'fg.muted' }, children: "Standalone viewer scenes powered by MessageProcessor and A2uiSurface." })] }), _jsx(ViewerContent, { onAction: handleAction }), _jsx(Box, { sx: {
+                            borderTop: '1px solid',
+                            borderColor: 'border.default',
+                            p: 3,
+                            fontFamily: 'mono',
+                            fontSize: 0,
+                            backgroundColor: 'canvas.default',
+                            whiteSpace: 'pre-wrap',
+                            maxHeight: 180,
+                            overflow: 'auto',
+                        }, children: lastAction
+                            ? JSON.stringify(lastAction, null, 2)
+                            : 'No action triggered yet.' })] }) }) }));
+};
+export default A2UiViewerScene;

package/lib/examples/utils/agentSummaryStore.d.ts

@@ -1,9 +1,15 @@
-export type AgentSummaryLocation = 'local' | 'cloud';
+import type { ExampleRuntimeTarget } from './runtimeTargetStore';
+/** Where the summarised runtime lives — the same four the control offers. */
+export type AgentSummaryLocation = ExampleRuntimeTarget;
 export interface AgentSummary {
     exampleId: string;
     agentName: string;
     agentId?: string;
     specId?: string;
+    /** The framework turning the loop, as the spec declares it. */
+    harness?: string;
+    /** The runtime variant the example runs on: `<location>-<harness>`. */
+    variant?: string;
     location: AgentSummaryLocation;
     /**
      * Base URL of the agent-runtimes API server. Hosts both the agent status

package/lib/examples/utils/agents/earthquake-detector.ipynb.json

@@ -41,7 +41,7 @@
     {
       "id": "3a857810-de1c-4afa-9eaa-06f77214b900",
       "cell_type": "code",
-      "source": "dls = ImageDataLoaders.from_name_func(\n    path=\"/home/jovyan/home/training7\",\n    fnames=files,\n    label_func=label_func,\n    item_tfms=Resize(224),\n    batch_tfms=[*aug_transforms(xtra_tfms=None)],\n    splitter=my_splitter\n)",
+      "source": "dls = ImageDataLoaders.from_name_func(\n    path=\"/home/datalayer/home/training7\",\n    fnames=files,\n    label_func=label_func,\n    item_tfms=Resize(224),\n    batch_tfms=[*aug_transforms(xtra_tfms=None)],\n    splitter=my_splitter\n)",
       "metadata": {
         "execution": {
           "iopub.execute_input": "2025-08-22T11:34:35.979092Z",

package/lib/examples/utils/agents/earthquake-detector.lexical.json

@@ -447,7 +447,7 @@
             "format": 0,
             "mode": "normal",
             "style": "",
-            "text": "\"/home/jovyan/home/training7\"",
+            "text": "\"/home/datalayer/home/training7\"",
             "type": "jupyter-input-highlight",
             "version": 1,
             "highlightType": "string"

package/lib/examples/utils/agents/sales-forecaster.ipynb.json

@@ -41,7 +41,7 @@
     {
       "id": "3a857810-de1c-4afa-9eaa-06f77214b900",
       "cell_type": "code",
-      "source": "dls = ImageDataLoaders.from_name_func(\n    path=\"/home/jovyan/home/training7\",\n    fnames=files,\n    label_func=label_func,\n    item_tfms=Resize(224),\n    batch_tfms=[*aug_transforms(xtra_tfms=None)],\n    splitter=my_splitter\n)",
+      "source": "dls = ImageDataLoaders.from_name_func(\n    path=\"/home/datalayer/home/training7\",\n    fnames=files,\n    label_func=label_func,\n    item_tfms=Resize(224),\n    batch_tfms=[*aug_transforms(xtra_tfms=None)],\n    splitter=my_splitter\n)",
       "metadata": {
         "execution": {
           "iopub.execute_input": "2025-08-22T11:34:35.979092Z",

package/lib/examples/utils/agents/sales-forecaster.lexical.json

@@ -447,7 +447,7 @@
             "format": 0,
             "mode": "normal",
             "style": "",
-            "text": "\"/home/jovyan/home/training7\"",
+            "text": "\"/home/datalayer/home/training7\"",
             "type": "jupyter-input-highlight",
             "version": 1,
             "highlightType": "string"

package/lib/examples/utils/agents/social-post-generator.ipynb.json

@@ -41,7 +41,7 @@
     {
       "id": "3a857810-de1c-4afa-9eaa-06f77214b900",
       "cell_type": "code",
-      "source": "dls = ImageDataLoaders.from_name_func(\n    path=\"/home/jovyan/home/training7\",\n    fnames=files,\n    label_func=label_func,\n    item_tfms=Resize(224),\n    batch_tfms=[*aug_transforms(xtra_tfms=None)],\n    splitter=my_splitter\n)",
+      "source": "dls = ImageDataLoaders.from_name_func(\n    path=\"/home/datalayer/home/training7\",\n    fnames=files,\n    label_func=label_func,\n    item_tfms=Resize(224),\n    batch_tfms=[*aug_transforms(xtra_tfms=None)],\n    splitter=my_splitter\n)",
       "metadata": {
         "execution": {
           "iopub.execute_input": "2025-08-22T11:34:35.979092Z",

package/lib/examples/utils/agents/social-post-generator.lexical.json

@@ -447,7 +447,7 @@
             "format": 0,
             "mode": "normal",
             "style": "",
-            "text": "\"/home/jovyan/home/training7\"",
+            "text": "\"/home/datalayer/home/training7\"",
             "type": "jupyter-input-highlight",
             "version": 1,
             "highlightType": "string"

package/lib/examples/utils/exampleSurfaces.d.ts

@@ -0,0 +1,31 @@
+/**
+ * What an example brings with it, read from its id.
+ *
+ * There used to be a second predicate here, `canBootstrapCloudSandbox`, gating
+ * which examples were allowed a cloud runtime. It was wrong twice over.
+ *
+ * The first version excluded any id containing `Agent`, which deadlocked every
+ * agent example: a cloud runtime was offered only to an example that had
+ * already published one, and an example can only publish one once it has been
+ * given one. The second version listed the surfaces that need a kernel —
+ * notebook, cell, document — and refused everything else. That was wrong on
+ * the premise rather than the details: an agent needs a runtime to run *on*,
+ * not a notebook to run *against*. `AgentToolApprovalsExample` renders no code
+ * surface at all and still wants an agent in the cloud.
+ *
+ * So there is no gate. Any example may be given a cloud runtime; whether it
+ * renders a surface on that runtime is the example's business. Guessing wrong
+ * in the permissive direction wastes a pod, and in the restrictive direction
+ * breaks the example — which is the failure this file has now produced twice.
+ *
+ * @module examples/utils/exampleSurfaces
+ */
+/**
+ * Whether this example is a sandbox and nothing else.
+ *
+ * An example with `Agent` in its name creates an agent of its own and so has an
+ * agent base URL worth recording in the summary; one without is a bare surface.
+ * A different question from where it can run, and the only one a name can
+ * actually answer.
+ */
+export declare function isSandboxOnlyExample(exampleId: string): boolean;

package/lib/examples/utils/exampleSurfaces.js

@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * What an example brings with it, read from its id.
+ *
+ * There used to be a second predicate here, `canBootstrapCloudSandbox`, gating
+ * which examples were allowed a cloud runtime. It was wrong twice over.
+ *
+ * The first version excluded any id containing `Agent`, which deadlocked every
+ * agent example: a cloud runtime was offered only to an example that had
+ * already published one, and an example can only publish one once it has been
+ * given one. The second version listed the surfaces that need a kernel —
+ * notebook, cell, document — and refused everything else. That was wrong on
+ * the premise rather than the details: an agent needs a runtime to run *on*,
+ * not a notebook to run *against*. `AgentToolApprovalsExample` renders no code
+ * surface at all and still wants an agent in the cloud.
+ *
+ * So there is no gate. Any example may be given a cloud runtime; whether it
+ * renders a surface on that runtime is the example's business. Guessing wrong
+ * in the permissive direction wastes a pod, and in the restrictive direction
+ * breaks the example — which is the failure this file has now produced twice.
+ *
+ * @module examples/utils/exampleSurfaces
+ */
+/**
+ * Whether this example is a sandbox and nothing else.
+ *
+ * An example with `Agent` in its name creates an agent of its own and so has an
+ * agent base URL worth recording in the summary; one without is a bare surface.
+ * A different question from where it can run, and the only one a name can
+ * actually answer.
+ */
+export function isSandboxOnlyExample(exampleId) {
+    return ((exampleId.includes('Notebook') || exampleId.includes('Cell')) &&
+        !exampleId.includes('Agent'));
+}

package/lib/examples/utils/jupyterSandboxUrl.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Which URL to hand an agent as its Jupyter sandbox.
+ *
+ * Its own module, and free of every runtime import, because the answer is
+ * about a URL and nothing else — and because getting it wrong is what sent the
+ * examples' agents at the Vite dev server.
+ *
+ * @module examples/utils/jupyterSandboxUrl
+ */
+import type { ServiceManager } from '@jupyterlab/services';
+/**
+ * Whether this URL could be a Jupyter server.
+ *
+ * It cannot be the page's own origin: the examples app is served by Vite, and
+ * Vite answers `/api` with the single-page app rather than a Jupyter API. That
+ * is precisely the URL an in-page (Pyodide) runtime reports as its `baseUrl`,
+ * so without this check the browser target hands the agent runtime a sandbox
+ * that can only 404 — which is exactly what it did.
+ */
+export declare function couldBeJupyterServer(url: string): boolean;
+/**
+ * The Jupyter server to hand the agent, if there is one.
+ *
+ * `VITE_JUPYTER_SANDBOX_URL` wins when set: an operator naming the sandbox
+ * outright knows better than anything inferred here.
+ */
+export declare function exampleJupyterSandboxUrl(serviceManager?: ServiceManager.IManager): string | undefined;

package/lib/examples/utils/jupyterSandboxUrl.js

@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * Whether this URL could be a Jupyter server.
+ *
+ * It cannot be the page's own origin: the examples app is served by Vite, and
+ * Vite answers `/api` with the single-page app rather than a Jupyter API. That
+ * is precisely the URL an in-page (Pyodide) runtime reports as its `baseUrl`,
+ * so without this check the browser target hands the agent runtime a sandbox
+ * that can only 404 — which is exactly what it did.
+ */
+export function couldBeJupyterServer(url) {
+    if (typeof window === 'undefined') {
+        return true;
+    }
+    try {
+        const parsed = new URL(url, window.location.href);
+        if (parsed.origin !== window.location.origin) {
+            return true;
+        }
+        // Same origin is fine when it is served under a Jupyter path — that is how
+        // a proxied server looks — but not when it is the bare app root.
+        return /\/(api\/)?jupyter/i.test(parsed.pathname);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The Jupyter server to hand the agent, if there is one.
+ *
+ * `VITE_JUPYTER_SANDBOX_URL` wins when set: an operator naming the sandbox
+ * outright knows better than anything inferred here.
+ */
+export function exampleJupyterSandboxUrl(serviceManager) {
+    const envUrl = import.meta.env.VITE_JUPYTER_SANDBOX_URL?.trim();
+    if (envUrl) {
+        return envUrl;
+    }
+    const baseUrl = serviceManager?.serverSettings?.baseUrl?.replace(/\/$/, '');
+    if (!baseUrl || !couldBeJupyterServer(baseUrl)) {
+        return undefined;
+    }
+    if (baseUrl.includes('token=')) {
+        return baseUrl;
+    }
+    const token = serviceManager?.serverSettings?.token;
+    if (!token) {
+        return baseUrl;
+    }
+    const separator = baseUrl.includes('?') ? '&' : '?';
+    return `${baseUrl}${separator}token=${encodeURIComponent(token)}`;
+}

package/lib/examples/utils/localUrl.d.ts

@@ -0,0 +1,2 @@
+export declare function isLocalUrl(value?: string | null): boolean;
+export default isLocalUrl;