@datalayer/core 1.2.13 → 1.2.15

package/lib/state/substates/NavigationState.d.ts

@@ -1,15 +1,17 @@
 /** The signed-in shell: the platform, the business cases, or the admin. */
 /**
- * The four shells of the signed-in application.
+ * The five shells of the signed-in application.
  *
  * `studio` is where an agentic UI application is composed, validated and
  * shipped — the default for somebody who has not chosen, and what the root
  * shows. `home` is the whole platform, shown as *Power*, at `/power`: the key
  * is kept so a cookie written before the Studio existed still names the
  * shell it meant. `agentify` is the business cases; `admin` is the
- * platform's administration.
+ * platform's administration. `loop` is LOOP: AI applications built by spec,
+ * by drag and drop or in Python — the Studio's app pages under a sidebar of
+ * their own, and the LOOP workspace at `/loop`.
  */
-export type NavigationView = 'studio' | 'home' | 'agentify' | 'admin';
+export type NavigationView = 'studio' | 'home' | 'agentify' | 'admin' | 'loop';
 /** The shells, and where each one opens when it has not been visited. */
 export declare const NAVIGATION_VIEW_HOMES: Record<NavigationView, string>;
 /** Well-known view identifiers for {@link NavigationState.tabsByView}. */
@@ -64,6 +66,16 @@ export type NavigationState = {
  * through or on a page that belongs to no shell.
  */
 export declare function isRememberableRoute(route: string): boolean;
+/**
+ * Whether a page belongs to no shell: the settings, the documentation and
+ * the decks.
+ *
+ * They are read from whichever shell the reader is in — its sidebar stays
+ * beside them and the header's selector does not move — so they are never a
+ * shell's own page: opening one does not change the shell, and no shell
+ * returns to one.
+ */
+export declare function isShellNeutralRoute(route: string): boolean;
 /**
  * The shell a route belongs to, read off its first segment.
  *
@@ -72,8 +84,13 @@ export declare function isRememberableRoute(route: string): boolean;
  * reached Home through a sidebar link while the toggle still said Agentify
  * had their Home pages filed under Agentify — and the toggle, seeing
  * "Agentify" already chosen, did nothing when they clicked it.
+ *
+ * A shell-neutral page (the settings, the documentation) has no shell of its
+ * own: given the shell the reader is in (`current`), that is the answer, so
+ * the sidebar and the header stay where they were. Without it the settings
+ * read as the Studio's and the documentation as Power's, as they once were.
  */
-export declare function viewForRoute(route: string): NavigationView;
+export declare function viewForRoute(route: string, current?: NavigationView): NavigationView;
 export declare const navigationStore: import("zustand").StoreApi<NavigationState>;
 /**
  * The hook, shaped like a `zustand` store created with `create`: callable

package/lib/state/substates/NavigationState.js

@@ -39,6 +39,8 @@ export const NAVIGATION_VIEW_HOMES = {
     home: '/power',
     agentify: '/agentify',
     admin: '/admin',
+    // The applications: what a builder opens LOOP for.
+    loop: '/loop/apps',
 };
 /** Well-known view identifiers for {@link NavigationState.tabsByView}. */
 export const LIBRARY_VIEW = 'library';
@@ -56,7 +58,8 @@ const COOKIE_MAX_AGE_DAYS = 365;
 const isView = (value) => value === 'studio' ||
     value === 'home' ||
     value === 'agentify' ||
-    value === 'admin';
+    value === 'admin' ||
+    value === 'loop';
 function readCookie(name) {
     if (typeof document === 'undefined') {
         return undefined;
@@ -159,6 +162,18 @@ function persist(state) {
     }
     writeCookie(SHELL_COOKIE, state.view);
 }
+/**
+ * The path of a route: what is before its query and its fragment.
+ *
+ * A route is what the reader was at — `/settings/profile?tab=keys#tokens` —
+ * and the shell it belongs to is decided by its path alone. Cutting only at
+ * `?` left a fragment attached, so `/settings#profile` was not `/settings`:
+ * it read as a shell's own page and moved the shell.
+ */
+function pathOf(route) {
+    const end = route.search(/[?#]/);
+    return end === -1 ? route : route.slice(0, end);
+}
 /**
  * Whether a page is worth remembering as a shell's.
  *
@@ -170,17 +185,30 @@ export function isRememberableRoute(route) {
     if (!route.startsWith('/')) {
         return false;
     }
-    const path = route.split('?')[0];
-    return ![
+    const path = pathOf(route);
+    return (![
         '/signin',
         '/signup',
         '/login',
         '/logout',
         '/oauth2',
         '/oauth',
-        '/docs',
         '/join',
-    ].some(prefix => path === prefix || path.startsWith(`${prefix}/`));
+    ].some(prefix => path === prefix || path.startsWith(`${prefix}/`)) &&
+        !isShellNeutralRoute(route));
+}
+/**
+ * Whether a page belongs to no shell: the settings, the documentation and
+ * the decks.
+ *
+ * They are read from whichever shell the reader is in — its sidebar stays
+ * beside them and the header's selector does not move — so they are never a
+ * shell's own page: opening one does not change the shell, and no shell
+ * returns to one.
+ */
+export function isShellNeutralRoute(route) {
+    const path = pathOf(route);
+    return ['/settings', '/docs', '/decks'].some(prefix => path === prefix || path.startsWith(`${prefix}/`));
 }
 /**
  * The shell a route belongs to, read off its first segment.
@@ -190,16 +218,27 @@ export function isRememberableRoute(route) {
  * reached Home through a sidebar link while the toggle still said Agentify
  * had their Home pages filed under Agentify — and the toggle, seeing
  * "Agentify" already chosen, did nothing when they clicked it.
+ *
+ * A shell-neutral page (the settings, the documentation) has no shell of its
+ * own: given the shell the reader is in (`current`), that is the answer, so
+ * the sidebar and the header stay where they were. Without it the settings
+ * read as the Studio's and the documentation as Power's, as they once were.
  */
-export function viewForRoute(route) {
-    const path = route.split('?')[0];
+export function viewForRoute(route, current) {
+    const path = pathOf(route);
+    if (current && isShellNeutralRoute(route)) {
+        return current;
+    }
     // The root is the Studio: what a signed-in reader opens on. The settings
-    // are read from it too, with its sidebar beside them.
+    // are read from it too, with its sidebar beside them — and so is the
+    // agentspecs catalogue, the specs an app is composed from.
     if (path === '/' ||
         path === '/studio' ||
         path.startsWith('/studio/') ||
         path === '/settings' ||
-        path.startsWith('/settings/')) {
+        path.startsWith('/settings/') ||
+        path === '/agentspecs' ||
+        path.startsWith('/agentspecs/')) {
         return 'studio';
     }
     if (path === '/agentify' || path.startsWith('/agentify/')) {
@@ -208,6 +247,9 @@ export function viewForRoute(route) {
     if (path === '/admin' || path.startsWith('/admin/')) {
         return 'admin';
     }
+    if (path === '/loop' || path.startsWith('/loop/')) {
+        return 'loop';
+    }
     return 'home';
 }
 /** Whether a page may be the one a shell returns to. */

package/lib/views/mcp/McpHome.js

@@ -1,8 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useState } from 'react';
+import { AiAgentIcon } from '@datalayer/icons-react';
 import { Button, Heading, IconButton, Link, Text } from '@primer/react';
 import { Box } from '@datalayer/primer-addons';
-import { CheckIcon, CopyIcon, KeyIcon, PlugIcon, PulseIcon, ShareIcon, TelescopeIcon, ToolsIcon, } from '@primer/octicons-react';
+import { CheckIcon, CopyIcon, KeyIcon, PulseIcon, RssIcon, ShieldCheckIcon, TelescopeIcon, ToolsIcon, } from '@primer/octicons-react';
 import { useConnectedAgents, useMcpActivity, useMcpMetrics, useTasks, } from '../../hooks/useMcp.js';
 import { useNavigate } from '../../hooks/index.js';
 import { useCoreStore, useIAMStore } from '../../state/index.js';
@@ -137,7 +138,7 @@ export const McpHome = ({ routes, clientDocsBase = '/docs/mcp-clients', showTitl
                     display: 'grid',
                     gap: 3,
                     gridTemplateColumns: ['1fr', 'repeat(2, 1fr)', 'repeat(3, 1fr)'],
-                }, children: [_jsx(Summary, { icon: PlugIcon, title: "Agents", to: routes.agents, onOpen: navigate, action: {
+                }, children: [_jsx(Summary, { icon: AiAgentIcon, title: "Agents", to: routes.agents, onOpen: navigate, action: {
                             label: 'Connected agents',
                             onClick: () => navigate(routes.agents),
                         }, children: connected.length === 0 ? (_jsx(Text, { children: "No agent has been authorized yet. Set up a client above and approve the scopes it asks for." })) : (_jsxs(_Fragment, { children: [_jsxs(Text, { children: [plural(connected.length, 'agent'), " authorized."] }), connected.slice(0, 3).map(agent => (_jsxs(Text, { children: [agent.clientName || agent.clientId, " \u2014", ' ', agent.lastUsedAt
@@ -152,7 +153,7 @@ export const McpHome = ({ routes, clientDocsBase = '/docs/mcp-clients', showTitl
                                     : 'Latency not measured yet.' }), _jsx(Text, { children: metrics.data?.slis.availability === null ||
                                     metrics.data?.slis.availability === undefined
                                     ? 'Error rate not measured yet.'
-                                    : `${((1 - metrics.data.slis.availability) * 100).toFixed(1)}% of calls failed.` })] }), _jsx(Summary, { icon: ToolsIcon, title: "Tools", children: _jsx(Text, { children: "The toolsets an agent may execute \u2014 the Contents sources you have enabled for it, their tools, their approval policy and their health \u2014 are managed here once toolset bindings ship." }) }), _jsx(Summary, { icon: ShareIcon, title: "Reach", children: _jsx(Text, { children: "Which notebooks and sources an agent can actually reach, as a list you can read at a glance, arrives with sharing to agents as principals." }) }), _jsx(Summary, { icon: KeyIcon, title: "Policies", to: routes.policies, onOpen: navigate, action: {
+                                    : `${((1 - metrics.data.slis.availability) * 100).toFixed(1)}% of calls failed.` })] }), _jsx(Summary, { icon: ToolsIcon, title: "Tools", children: _jsx(Text, { children: "The toolsets an agent may execute \u2014 the Contents sources you have enabled for it, their tools, their approval policy and their health \u2014 are managed here once toolset bindings ship." }) }), _jsx(Summary, { icon: RssIcon, title: "Reach", children: _jsx(Text, { children: "Which notebooks and sources an agent can actually reach, as a list you can read at a glance, arrives with sharing to agents as principals." }) }), _jsx(Summary, { icon: ShieldCheckIcon, title: "Policies", to: routes.policies, onOpen: navigate, action: {
                             label: 'What applies',
                             onClick: () => navigate(routes.policies),
                         }, children: _jsx(Text, { children: "What your agents are allowed to do, and which layer decided each rule." }) })] }))] }));

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/core",
-    "version": "1.2.13",
+    "version": "1.2.15",
     "type": "module",
     "workspaces": [
         ".",

package/scripts/generate-fluent-emoji.py

@@ -0,0 +1,188 @@
+#!/usr/bin/env python3
+# Copyright (c) 2023-2025 Datalayer, Inc.
+# Distributed under the terms of the Modified BSD License.
+
+"""
+Write the Fluent Emoji drawings of the faces Datalayer offers (LOOP T-20).
+
+Reads the emojis between the ``fluent-emoji:start`` and ``fluent-emoji:end``
+markers of ``src/components/emoji/faceEmojis.ts``, finds each in Microsoft's
+Fluent Emoji (MIT) at a pinned commit by the unicode its metadata gives, and
+writes its *Flat* drawing as a module of its own under
+``src/components/emoji/fluent/svg/`` -- fetched on first draw, from
+Datalayer's own bundle -- with ``loaders.ts`` naming them all and the licence
+beside them. An emoji Fluent does not draw stops the script.
+
+Run from the repository's root::
+
+    python scripts/generate-fluent-emoji.py [--cache DIR]
+"""
+
+from __future__ import annotations
+
+import argparse
+import concurrent.futures
+import json
+import re
+import urllib.parse
+import urllib.request
+from pathlib import Path
+
+REPO = "microsoft/fluentui-emoji"
+COMMIT = "1ffb34c752ecf5d402f04cfb4b392c77f57c54bc"
+RAW = f"https://raw.githubusercontent.com/{REPO}/{COMMIT}/"
+TREE = f"https://api.github.com/repos/{REPO}/git/trees/{COMMIT}?recursive=1"
+
+ROOT = Path(__file__).resolve().parent.parent
+LIST = ROOT / "src/components/emoji/faceEmojis.ts"
+OUT = ROOT / "src/components/emoji/fluent"
+
+
+def fetch(url: str) -> bytes:
+    """
+    Fetch a URL of GitHub's.
+
+    Parameters
+    ----------
+    url : str
+        The URL, at the pinned commit.
+
+    Returns
+    -------
+    bytes
+        Its body.
+    """
+    with urllib.request.urlopen(url, timeout=60) as response:  # nosec B310
+        return response.read()
+
+
+def cached(cache: Path | None, name: str, url: str) -> bytes:
+    """
+    Fetch a URL once, keeping it under ``cache`` when one is given.
+
+    Parameters
+    ----------
+    cache : Path or None
+        Where to keep what was fetched.
+    name : str
+        The file it is kept as.
+    url : str
+        The URL.
+
+    Returns
+    -------
+    bytes
+        Its body.
+    """
+    if cache is None:
+        return fetch(url)
+    path = cache / name
+    if not path.exists():
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_bytes(fetch(url))
+    return path.read_bytes()
+
+
+def key_of(codes: list[int]) -> str:
+    """
+    Name a drawing as ``emojiKey`` does in ``faceEmojis.ts``.
+
+    Parameters
+    ----------
+    codes : list of int
+        The emoji's code points.
+
+    Returns
+    -------
+    str
+        Lower-case hexadecimal code points joined by ``-``, without U+FE0F.
+    """
+    return "-".join(f"{code:x}" for code in codes if code != 0xFE0F)
+
+
+def main() -> None:
+    """Write the drawings, their loaders and the licence."""
+    parser = argparse.ArgumentParser(description=__doc__.splitlines()[1])
+    parser.add_argument("--cache", type=Path, help="keep what is fetched here")
+    args = parser.parse_args()
+
+    text = LIST.read_text(encoding="utf-8")
+    block = text.split("// fluent-emoji:start", 1)[1].split("// fluent-emoji:end", 1)[0]
+    emojis = re.findall(r"^\s*'([^']+)',", block, flags=re.M)
+    keys = list(dict.fromkeys(key_of([ord(c) for c in emoji]) for emoji in emojis))
+
+    tree = json.loads(cached(args.cache, "tree.json", TREE))["tree"]
+    paths = [item["path"] for item in tree if item["type"] == "blob"]
+    metadata = [p for p in paths if p.count("/") == 2 and p.endswith("/metadata.json")]
+
+    def read(path: str) -> tuple[str, dict]:
+        name = "meta/" + path.split("/")[1] + ".json"
+        return path.split("/")[1], json.loads(cached(args.cache, name, RAW + urllib.parse.quote(path)))
+
+    with concurrent.futures.ThreadPoolExecutor(16) as pool:
+        folders = dict(pool.map(read, metadata))
+    by_key = {
+        key_of([int(code, 16) for code in meta.get("unicode", "").split()]): (folder, meta)
+        for folder, meta in folders.items()
+    }
+
+    missing = [key for key in keys if key not in by_key]
+    if missing:
+        raise SystemExit(f"Fluent Emoji draws none of: {', '.join(missing)}")
+
+    (OUT / "svg").mkdir(parents=True, exist_ok=True)
+    for stale in (OUT / "svg").glob("*.ts"):
+        stale.unlink()
+    (OUT / "LICENSE").write_bytes(cached(args.cache, "LICENSE", RAW + "LICENSE"))
+
+    loaders = []
+    for key in keys:
+        folder, meta = by_key[key]
+        # The one drawing, or, for an emoji with skin tones, the default's.
+        flat = [
+            p
+            for p in paths
+            if p.startswith(f"assets/{folder}/Flat/")
+            or p.startswith(f"assets/{folder}/Default/Flat/")
+        ]
+        flat = [p for p in flat if p.endswith(".svg")]
+        if len(flat) != 1:
+            raise SystemExit(f"{folder}: {len(flat)} Flat drawings, not one")
+        svg = cached(args.cache, f"svg/{key}.svg", RAW + urllib.parse.quote(flat[0])).decode("utf-8")
+        svg = re.sub(r"\s*\n\s*", " ", svg.strip())
+        # In single quotes, as prettier writes a string with no quote of its own.
+        quoted = "'" + svg.replace("\\", "\\\\").replace("'", "\\'") + "'"
+        (OUT / "svg" / f"{key}.ts").write_text(
+            "/*\n"
+            f" * {meta['glyph']} {meta.get('cldr', folder)} — Fluent Emoji, Flat, by Microsoft (MIT,\n"
+            " * see ../LICENSE). Written by scripts/generate-fluent-emoji.py: do not edit.\n"
+            " */\n\n"
+            f"export default {quoted};\n",
+            encoding="utf-8",
+        )
+        loaders.append(f"  '{key}': () => import('./svg/{key}'),")
+
+    (OUT / "loaders.ts").write_text(
+        "/*\n"
+        " * Copyright (c) 2023-2025 Datalayer, Inc.\n"
+        " * Distributed under the terms of the Modified BSD License.\n"
+        " */\n\n"
+        "/**\n"
+        " * The Fluent Emoji drawings Datalayer ships, by `emojiKey`, each a module\n"
+        " * of its own, fetched the first time it is drawn. The drawings are\n"
+        f" * Microsoft's Fluent Emoji (MIT, see ./LICENSE), at {REPO}@{COMMIT[:12]}.\n"
+        " * Written by scripts/generate-fluent-emoji.py: do not edit.\n"
+        " *\n"
+        " * @module components/emoji/fluent/loaders\n"
+        " */\n\n"
+        f"export const FLUENT_EMOJI_COMMIT = '{COMMIT}';\n\n"
+        "export const FLUENT_EMOJI_LOADERS: Readonly<\n"
+        "  Record<string, () => Promise<{ default: string }>>\n"
+        "> = {\n" + "\n".join(loaders) + "\n};\n",
+        encoding="utf-8",
+    )
+    print(f"{len(keys)} drawings written to {OUT.relative_to(ROOT)}")
+
+
+if __name__ == "__main__":
+    main()