@datalayer/core 1.2.14 → 1.2.17

package/lib/components/anonymous/AnonymousKeyExpired.d.ts

@@ -51,6 +51,12 @@ export type AnonymousKeyExpiredProps = {
     temporary?: boolean;
     /** Called after a successful sign-in, once the token is stored. */
     onSignedIn?: () => void;
+    /**
+     * Called on *Sign up with email*, for a host with a router to send the
+     * reader to its own sign-up page; without it, the form opens its sign-up
+     * address.
+     */
+    onSignUp?: () => void;
 };
-export declare function AnonymousKeyExpired({ agentName, sandboxStillRuns, temporary, onSignedIn, }: AnonymousKeyExpiredProps): JSX.Element;
+export declare function AnonymousKeyExpired({ agentName, sandboxStillRuns, temporary, onSignedIn, onSignUp, }: AnonymousKeyExpiredProps): JSX.Element;
 export default AnonymousKeyExpired;

package/lib/components/anonymous/AnonymousKeyExpired.js

@@ -5,7 +5,7 @@ import { Box } from '@datalayer/primer-addons';
 import { KeyIcon } from '@primer/octicons-react';
 import { SignInSimple } from '../../views/iam/SignInSimple.js';
 import { useCoreStore, iamStore } from '../../state/substates/index.js';
-export function AnonymousKeyExpired({ agentName, sandboxStillRuns = false, temporary = true, onSignedIn, }) {
+export function AnonymousKeyExpired({ agentName, sandboxStillRuns = false, temporary = true, onSignedIn, onSignUp, }) {
     const { configuration } = useCoreStore();
     const handleSignIn = useCallback((token) => {
         /*
@@ -91,6 +91,6 @@ export function AnonymousKeyExpired({ agentName, sandboxStillRuns = false, tempo
                     // has one and harmless for one that does not.
                     loginUrl: configuration?.iamUrl
                         ? `${configuration.iamUrl}/api/iam/v1/login`
-                        : undefined, onSignIn: handleSignIn })] }) }));
+                        : undefined, onSignIn: handleSignIn, onSignUp: onSignUp })] }) }));
 }
 export default AnonymousKeyExpired;

package/lib/components/labels/StatusLabels.d.ts

@@ -18,6 +18,17 @@ export type StatusLabelProps = {
     size?: 'small' | 'large';
     sx?: Record<string, unknown>;
 };
+/**
+ * The tone of each named label. A role or a stage is a quality, not a
+ * verdict, so none is in attention's amber: the theme keeps success, attention
+ * and danger for verdicts (LOOP T-14, T-29) — *admin* is quiet.
+ */
+export declare const NAMED_LABEL_TONES: {
+    readonly alpha: "accent";
+    readonly admin: "neutral";
+    readonly default: "accent";
+    readonly soon: "neutral";
+};
 /**
  * The pill the named labels below are made of.
  *

package/lib/components/labels/StatusLabels.js

@@ -22,6 +22,17 @@ const TONES = {
         borderColor: 'border.default',
     },
 };
+/**
+ * The tone of each named label. A role or a stage is a quality, not a
+ * verdict, so none is in attention's amber: the theme keeps success, attention
+ * and danger for verdicts (LOOP T-14, T-29) — *admin* is quiet.
+ */
+export const NAMED_LABEL_TONES = {
+    alpha: 'accent',
+    admin: 'neutral',
+    default: 'accent',
+    soon: 'neutral',
+};
 /**
  * The pill the named labels below are made of.
  *
@@ -42,25 +53,25 @@ export function StatusLabel(props) {
  */
 export function AlphaLabel(props = {}) {
     const { children = 'alpha', ...rest } = props;
-    return (_jsx(StatusLabel, { tone: "accent", ...rest, children: children }));
+    return (_jsx(StatusLabel, { tone: NAMED_LABEL_TONES.alpha, ...rest, children: children }));
 }
 /**
  * Something reserved to the administrators of the platform.
  */
 export function AdminLabel(props = {}) {
     const { children = 'admin', ...rest } = props;
-    return (_jsx(StatusLabel, { tone: "attention", ...rest, children: children }));
+    return (_jsx(StatusLabel, { tone: NAMED_LABEL_TONES.admin, ...rest, children: children }));
 }
 /**
  * The one that is taken when none is chosen — the default space of an account.
  */
 export function DefaultLabel(props = {}) {
     const { children = 'default', ...rest } = props;
-    return (_jsx(StatusLabel, { tone: "accent", ...rest, children: children }));
+    return (_jsx(StatusLabel, { tone: NAMED_LABEL_TONES.default, ...rest, children: children }));
 }
 /** "soon": what is announced but not yet there. */
 export function SoonLabel(props = {}) {
     const { children = 'soon', ...rest } = props;
-    return (_jsx(StatusLabel, { tone: "neutral", ...rest, children: children }));
+    return (_jsx(StatusLabel, { tone: NAMED_LABEL_TONES.soon, ...rest, children: children }));
 }
 export default StatusLabel;

package/lib/hooks/index.d.ts

@@ -2,6 +2,7 @@ export * from './useAuthorization';
 export * from './useBackdrop';
 export * from './useBackdropJupyterLab';
 export * from './useCache';
+export * from './libraryApp';
 export * from './useContainsFocus';
 export * from './useContents';
 export * from './useDatalayer';

package/lib/hooks/index.js

@@ -6,6 +6,7 @@ export * from './useAuthorization.js';
 export * from './useBackdrop.js';
 export * from './useBackdropJupyterLab.js';
 export * from './useCache.js';
+export * from './libraryApp.js';
 export * from './useContainsFocus.js';
 export * from './useContents.js';
 export * from './useDatalayer.js';

package/lib/hooks/libraryApp.d.ts

@@ -0,0 +1,37 @@
+/**
+ * What the Library says of a published application beyond any item's fields:
+ * its face, its kind and whether it runs live.
+ *
+ * Spacer keeps them beside the app's item, from its Appspec, and the Library
+ * projection carries them: `face_s` (the JSON of its `id`, `emoji`, `avatar`
+ * and `banner`, each only when set), `app_kind_s` and `runs_live_b` — an app
+ * that runs live can be tried before it is cloned: not a decision, and naming
+ * the agent it runs on.
+ *
+ * @module hooks/libraryApp
+ */
+/** The kinds of application. */
+export declare const LIBRARY_APP_KINDS: readonly ["decision", "chat", "widget", "worker"];
+export type LibraryAppKind = (typeof LIBRARY_APP_KINDS)[number];
+/** An application's face, as its Appspec says it: each only when set. */
+export type LibraryAppFace = {
+    /** The Appspec's id: what seeds its banner, and the agent it runs as. */
+    id?: string;
+    emoji?: string;
+    /** The drawing chosen, by name, from the profile's set. */
+    avatar?: string;
+    /** The banner chosen, by name, from the profile's set. */
+    banner?: string;
+};
+export type LibraryAppFields = {
+    /** None when the Library answered without one. */
+    face?: LibraryAppFace;
+    /** None when the Library answered without one. */
+    appKind?: LibraryAppKind;
+    /** Whether it can be tried before it is cloned. */
+    runsLive: boolean;
+};
+/** The face `face_s` carries; a value that is not a face's JSON is refused. */
+export declare function libraryAppFaceOf(value: unknown): LibraryAppFace | undefined;
+/** The face, kind and liveness of an app as the Library answers it. */
+export declare function libraryAppFieldsOf(raw: Record<string, unknown>): LibraryAppFields;

package/lib/hooks/libraryApp.js

@@ -0,0 +1,59 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * What the Library says of a published application beyond any item's fields:
+ * its face, its kind and whether it runs live.
+ *
+ * Spacer keeps them beside the app's item, from its Appspec, and the Library
+ * projection carries them: `face_s` (the JSON of its `id`, `emoji`, `avatar`
+ * and `banner`, each only when set), `app_kind_s` and `runs_live_b` — an app
+ * that runs live can be tried before it is cloned: not a decision, and naming
+ * the agent it runs on.
+ *
+ * @module hooks/libraryApp
+ */
+/** The kinds of application. */
+export const LIBRARY_APP_KINDS = [
+    'decision',
+    'chat',
+    'widget',
+    'worker',
+];
+const FACE_KEYS = ['id', 'emoji', 'avatar', 'banner'];
+/** The face `face_s` carries; a value that is not a face's JSON is refused. */
+export function libraryAppFaceOf(value) {
+    if (value === undefined || value === null || value === '') {
+        return undefined;
+    }
+    if (typeof value !== 'string') {
+        throw new Error(`An app's face is not a string: ${String(value)}`);
+    }
+    const parsed = JSON.parse(value);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`An app's face is not an object: ${value}`);
+    }
+    const face = {};
+    for (const key of FACE_KEYS) {
+        const field = parsed[key];
+        if (typeof field === 'string' && field) {
+            face[key] = field;
+        }
+    }
+    return face;
+}
+/** The face, kind and liveness of an app as the Library answers it. */
+export function libraryAppFieldsOf(raw) {
+    const kind = raw.app_kind_s;
+    if (kind !== undefined &&
+        !LIBRARY_APP_KINDS.includes(kind)) {
+        throw new Error(`An app's kind is not one of ${LIBRARY_APP_KINDS}: ${String(kind)}`);
+    }
+    const face = libraryAppFaceOf(raw.face_s);
+    return {
+        ...(face ? { face } : {}),
+        ...(kind ? { appKind: kind } : {}),
+        runsLive: raw.runs_live_b === true,
+    };
+}

package/lib/hooks/useCache.js

@@ -39,6 +39,7 @@
 import { useQuery, useQueries, useMutation, useQueryClient, } from '@tanstack/react-query';
 import { BOOTSTRAP_USER_ONBOARDING, asContact, asInvite, asOrganization, asSecret, asTeam, asToken, asUser, } from '../models/index.js';
 import { asSpace } from './cacheConverters.js';
+import { libraryAppFieldsOf } from './libraryApp.js';
 import { useCoreStore, useIAMStore, profileStore } from '../state/index.js';
 import { asDisplayName, namesAsInitials, asArray } from '../utils/index.js';
 import { useDatalayer } from './useDatalayer.js';
@@ -880,10 +881,13 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
     /**
      * A published agentic UI application: what it answers, and its definition
      * as the library hands it over — `model_s`, the string the Studio reads
-     * the definition from, left unparsed because the Studio owns its shape.
+     * the definition from, left unparsed because the Studio owns its shape —
+     * and its face, its kind and whether it runs live (`libraryAppFieldsOf`),
+     * so its card draws it and the gallery opens one that runs live.
      */
     const toApp = (raw) => {
         return {
+            ...libraryAppFieldsOf(raw),
             id: raw.uid,
             type: 'app',
             name: raw.name_t,
@@ -1836,6 +1840,9 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
                 if (settings.docsInPlace !== undefined) {
                     body.docs_in_place_b = settings.docsInPlace;
                 }
+                if (settings.showAdvanced !== undefined) {
+                    body.show_advanced_b = settings.showAdvanced;
+                }
                 return requestDatalayer({
                     url: `${configuration.iamUrl}/api/iam/v1/users/${userId}/settings`,
                     method: 'PUT',

package/lib/models/UserSettings.d.ts

@@ -1,6 +1,7 @@
 export declare const AI_AGENTS_URL_KEY = "aiAgents_url_s";
 export declare const CAN_INVITE_URL_KEY = "can_invite_b";
 export declare const DOCS_IN_PLACE_KEY = "docs_in_place_b";
+export declare const SHOW_ADVANCED_KEY = "show_advanced_b";
 export type IUserSettings = {
     aiAgentsUrl?: string;
     canInvite?: boolean;
@@ -13,11 +14,19 @@ export type IUserSettings = {
      * full-window documentation.
      */
     docsInPlace?: boolean;
+    /**
+     * Whether the Studio shows what a Maker does not need — *Show advanced*.
+     *
+     * Undefined means the user has never chosen: the Studio makes a first
+     * choice for them, and keeps it here.
+     */
+    showAdvanced?: boolean;
 };
 export declare class UserSettings implements IUserSettings {
     private _aiAgentsUrl?;
     private _canInvite?;
     private _docsInPlace?;
+    private _showAdvanced?;
     constructor(s: any);
     get aiAgentsUrl(): string | undefined;
     set aiAgentsUrl(value: string | undefined);
@@ -25,5 +34,7 @@ export declare class UserSettings implements IUserSettings {
     set canInvite(value: boolean | undefined);
     get docsInPlace(): boolean | undefined;
     set docsInPlace(value: boolean | undefined);
+    get showAdvanced(): boolean | undefined;
+    set showAdvanced(value: boolean | undefined);
 }
 export default UserSettings;

package/lib/models/UserSettings.js

@@ -5,14 +5,17 @@
 export const AI_AGENTS_URL_KEY = 'aiAgents_url_s';
 export const CAN_INVITE_URL_KEY = 'can_invite_b';
 export const DOCS_IN_PLACE_KEY = 'docs_in_place_b';
+export const SHOW_ADVANCED_KEY = 'show_advanced_b';
 export class UserSettings {
     _aiAgentsUrl;
     _canInvite;
     _docsInPlace;
+    _showAdvanced;
     constructor(s) {
         this._aiAgentsUrl = s[AI_AGENTS_URL_KEY] ?? undefined;
         this._canInvite = s[CAN_INVITE_URL_KEY] ?? undefined;
         this._docsInPlace = s[DOCS_IN_PLACE_KEY] ?? undefined;
+        this._showAdvanced = s[SHOW_ADVANCED_KEY] ?? undefined;
     }
     get aiAgentsUrl() {
         return this._aiAgentsUrl;
@@ -32,5 +35,11 @@ export class UserSettings {
     set docsInPlace(value) {
         this._docsInPlace = value;
     }
+    get showAdvanced() {
+        return this._showAdvanced;
+    }
+    set showAdvanced(value) {
+        this._showAdvanced = value;
+    }
 }
 export default UserSettings;

package/lib/views/iam/SignInSimple.d.ts

@@ -122,6 +122,12 @@ export interface SignInSimpleProps {
      * Sign-up URL opened when clicking the sign-up button.
      */
     signUpHref?: string;
+    /**
+     * Called on the sign-up button instead of opening `signUpHref`: a host
+     * with a router sends the reader to its own sign-up page without leaving
+     * the app.
+     */
+    onSignUp?: () => void;
     /**
      * Forgot-password URL for password form.
      */

package/lib/views/iam/SignInSimple.js

@@ -101,7 +101,7 @@ const SignInInputGlobalStyle = createGlobalStyle `
   }
 `;
 // ── Component ────────────────────────────────────────────────────────
-export const SignInSimple = ({ onSignIn, onApiKeySignIn, loginUrl: loginUrlProp, name, title = 'Datalayer OTEL', description = 'Sign in to access the observability dashboard.', icon, leadingIcon = _jsx(TelescopeIcon, { size: 24 }), github = false, google = false, linkedin = false, apiKey = false, signUp = true, socialSignInNavigationTarget, asDoc = false, fillHeight = true, hideHero = false, calloutTitle, calloutDescription, passwordToggleLabel = 'Sign in with a password', signUpTitle = "Don't have an account?", signUpDescription = 'Create a free Datalayer account with your email address.', signUpLabel = 'Sign up with email', signUpHref = 'https://datalayer.ai/signup', forgotPasswordHref = '/password', forgotPasswordLabel = 'Forgot password?', showForgotPassword = true, socialButtonMarginTop = 3, actionButtonMaxWidth = 320, }) => {
+export const SignInSimple = ({ onSignIn, onApiKeySignIn, loginUrl: loginUrlProp, name, title = 'Datalayer OTEL', description = 'Sign in to access the observability dashboard.', icon, leadingIcon = _jsx(TelescopeIcon, { size: 24 }), github = false, google = false, linkedin = false, apiKey = false, signUp = true, socialSignInNavigationTarget, asDoc = false, fillHeight = true, hideHero = false, calloutTitle, calloutDescription, passwordToggleLabel = 'Sign in with a password', signUpTitle = "Don't have an account?", signUpDescription = 'Create a free Datalayer account with your email address.', signUpLabel = 'Sign up with email', signUpHref = 'https://datalayer.ai/signup', onSignUp, forgotPasswordHref = '/password', forgotPasswordLabel = 'Forgot password?', showForgotPassword = true, socialButtonMarginTop = 3, actionButtonMaxWidth = 320, }) => {
     const compactDocMode = asDoc && !hideHero;
     const headingText = name ?? (asDoc && title === 'Datalayer OTEL' ? 'Datalayer Sign In' : title);
     const headingIcon = icon ?? (asDoc ? _jsx(SignInIcon, { size: 24 }) : leadingIcon);
@@ -208,8 +208,12 @@ export const SignInSimple = ({ onSignIn, onApiKeySignIn, loginUrl: loginUrlProp,
         closeApiKeyDialog();
     }, [apiKeyValue, onApiKeySignIn, closeApiKeyDialog]);
     const handleSignUp = useCallback(() => {
+        if (onSignUp) {
+            onSignUp();
+            return;
+        }
         window.location.assign(signUpHref);
-    }, [signUpHref]);
+    }, [onSignUp, signUpHref]);
     const handleForgotPassword = useCallback(() => {
         if (!forgotPasswordHref) {
             return;

package/package.json

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