@datalayer/agent-runtimes 1.5.70 → 1.5.73

package/lib/identity/useIdentity.js

@@ -10,7 +10,7 @@
  * @module identity/useIdentity
  */
 import { useCallback, useEffect, useMemo } from 'react';
-import { useIdentityStore, useConnectedIdentities, useConnectedProviders, usePendingAuthorization, useIdentityLoading, useIdentityError, configureBuiltinProviders, } from './identityStore';
+import { useIdentityStore, useConnectedIdentities, useConnectedProviders, usePendingAuthorization, useIdentityLoading, useIdentityError, configureBuiltinProviders, } from './identityStore.js';
 /**
  * Hook for managing OAuth identities
  *

package/lib/index.js

@@ -2,17 +2,17 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-export * from './chat';
-export * from './client';
-export * from './collaboration';
-export * from './components';
-export * from './mcp';
-export * from './pap';
-export * from './stores';
-export * from './identity';
-export * from './config';
-export * from './specs';
+export * from './chat/index.js';
+export * from './client/index.js';
+export * from './collaboration/index.js';
+export * from './components/index.js';
+export * from './mcp/index.js';
+export * from './pap/index.js';
+export * from './stores/index.js';
+export * from './identity/index.js';
+export * from './config/index.js';
+export * from './specs/index.js';
 // The LOOP workspace and its plugins, for hosts that embed it: the Datalayer
 // application at /loop, and later the JupyterLab panel. Exported through one
 // surface rather than by deep import.
-export * from './apps';
+export * from './apps/index.js';

package/lib/inference/DatalayerInferenceProvider.js

@@ -2,8 +2,8 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { generateMessageId, createAssistantMessage } from '../types/messages';
-import { BaseInferenceProvider } from './BaseInferenceProvider';
+import { generateMessageId, createAssistantMessage } from '../types/messages.js';
+import { BaseInferenceProvider } from './BaseInferenceProvider.js';
 /**
  * Datalayer inference provider
  */

package/lib/inference/SelfHostedInferenceProvider.js

@@ -2,8 +2,8 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { generateMessageId, createAssistantMessage } from '../types/messages';
-import { BaseInferenceProvider } from './BaseInferenceProvider';
+import { generateMessageId, createAssistantMessage } from '../types/messages.js';
+import { BaseInferenceProvider } from './BaseInferenceProvider.js';
 /**
  * Self-hosted inference provider for custom OpenAI-compatible endpoints
  */

package/lib/inference/index.js

@@ -7,6 +7,6 @@
  *
  * @module inference
  */
-export { BaseInferenceProvider } from './BaseInferenceProvider';
-export { DatalayerInferenceProvider, } from './DatalayerInferenceProvider';
-export { SelfHostedInferenceProvider, } from './SelfHostedInferenceProvider';
+export { BaseInferenceProvider } from './BaseInferenceProvider.js';
+export { DatalayerInferenceProvider, } from './DatalayerInferenceProvider.js';
+export { SelfHostedInferenceProvider, } from './SelfHostedInferenceProvider.js';

package/lib/jupyter/exec/Snippets.js

@@ -2,7 +2,7 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import * as Python from './Python';
+import * as Python from './Python.js';
 /**
  * Facade to interact with kernels by requesting code execution.
  */

package/lib/jupyter/exec/index.js

@@ -2,5 +2,5 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-export * from './Python';
-export * from './Snippets';
+export * from './Python.js';
+export * from './Snippets.js';

package/lib/jupyter/index.js

@@ -2,6 +2,6 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-export * from './exec';
-export * from './serverExecution';
-export * from './useResumeServerExecutions';
+export * from './exec/index.js';
+export * from './serverExecution.js';
+export * from './useResumeServerExecutions.js';

package/lib/jupyter/useResumeServerExecutions.js

@@ -17,7 +17,7 @@
  */
 import { useEffect } from 'react';
 import { notebookStore } from '@datalayer/jupyter-react';
-import { resumeServerExecutions, } from './serverExecution';
+import { resumeServerExecutions, } from './serverExecution.js';
 /** How often the cells are looked at, and for how long. */
 const LOOK_EVERY_MS = 1_000;
 const LOOK_FOR_MS = 30_000;

package/lib/lexical/ChatInlinePlugin.js

@@ -5,7 +5,7 @@ import { $getSelection, $isRangeSelection, $createParagraphNode, $createTextNode
 import { useLexicalComposerContext } from '@lexical/react/LexicalComposerContext';
 import { autoUpdate, hide, limitShift, offset, shift, size, useFloating, } from '@floating-ui/react-dom';
 import { Box } from '@datalayer/primer-addons';
-import { ChatInline } from '../chat/ChatInline';
+import { ChatInline } from '../chat/ChatInline.js';
 // Margin from editor edges
 const MARGIN_X = 32;
 /**

package/lib/lexical/index.js

@@ -7,5 +7,5 @@
  *
  * @module lexical
  */
-export { ChatInlinePlugin, SAVE_SELECTION_COMMAND, RESTORE_SELECTION_COMMAND, } from './ChatInlinePlugin';
-export { useChatInlineToolbarItems, } from './useChatInlineToolbarItems';
+export { ChatInlinePlugin, SAVE_SELECTION_COMMAND, RESTORE_SELECTION_COMMAND, } from './ChatInlinePlugin.js';
+export { useChatInlineToolbarItems, } from './useChatInlineToolbarItems.js';

package/lib/loop-example-main.js

@@ -23,8 +23,8 @@ import { StrictMode, useEffect } from 'react';
 import { createRoot } from 'react-dom/client';
 import { QueryClientProvider } from '@tanstack/react-query';
 import { DatalayerThemeProvider, setupPrimerPortals, themeConfigs, useSystemColorMode, useThemeStore, } from '@datalayer/primer-addons';
-import { LoopWorkspaceExample } from './examples/LoopWorkspaceExample';
-import { internalQueryClient } from './utils';
+import { LoopWorkspaceExample } from './examples/LoopWorkspaceExample.js';
+import { internalQueryClient } from './utils/index.js';
 import '../style/primer-primitives.css';
 function Page() {
     const { colorMode, theme } = useThemeStore();

package/lib/loop-main.js

@@ -33,15 +33,15 @@ import { createRoot } from 'react-dom/client';
 import { QueryClientProvider } from '@tanstack/react-query';
 import { Box, DatalayerThemeProvider, setupPrimerPortals, themeConfigs, useSystemColorMode, useThemeStore, } from '@datalayer/primer-addons';
 import { configurePlugin } from '@datalayer/reactor';
-import { LoopWorkspace } from './apps/shell/LoopWorkspace';
-import { ChatPlugin } from './apps/plugins/chat';
-import { A2uiPlugin } from './apps/plugins/a2ui';
-import { AgentspecsPlugin } from './apps/plugins/agentspecs';
-import { AgentsPlugin } from './apps/plugins/agents';
-import { ModelsPlugin } from './apps/plugins/models';
-import { DocumentPlugin } from './apps/plugins/document';
-import { NotebookPlugin } from './apps/plugins/notebook';
-import { internalQueryClient } from './utils';
+import { LoopWorkspace } from './apps/shell/LoopWorkspace.js';
+import { ChatPlugin } from './apps/plugins/chat/index.js';
+import { A2uiPlugin } from './apps/plugins/a2ui/index.js';
+import { AgentspecsPlugin } from './apps/plugins/agentspecs/index.js';
+import { AgentsPlugin } from './apps/plugins/agents/index.js';
+import { ModelsPlugin } from './apps/plugins/models/index.js';
+import { DocumentPlugin } from './apps/plugins/document/index.js';
+import { NotebookPlugin } from './apps/plugins/notebook/index.js';
+import { internalQueryClient } from './utils/index.js';
 // `src/index.css` is the Vite starter template's stylesheet: it sets
 // `body { display: flex; place-items: center }`, which shrink-wraps #root to
 // its content — the workspace filled 407px of a 1280px window. The agent page

package/lib/main.js

@@ -4,7 +4,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * Distributed under the terms of the Modified BSD License.
  */
 import { createRoot } from 'react-dom/client';
-import App from './App';
+import App from './App.js';
 import './index.css';
 const rootElement = document.getElementById('root');
 if (rootElement) {

package/lib/mcp/index.js

@@ -2,4 +2,4 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-export { McpServerManager } from './McpServerManager';
+export { McpServerManager } from './McpServerManager.js';

package/lib/middleware/index.js

@@ -7,4 +7,4 @@
  *
  * @module middleware
  */
-export { MiddlewarePipeline, createMiddleware, loggingMiddleware, createHITLMiddleware, } from './MiddlewarePipeline';
+export { MiddlewarePipeline, createMiddleware, loggingMiddleware, createHITLMiddleware, } from './MiddlewarePipeline.js';

package/lib/mocks/models/CourseMock.js

@@ -4,7 +4,7 @@
  */
 import { uniqueNamesGenerator, names } from 'unique-names-generator';
 import { newUlid } from '@datalayer/core/lib/utils';
-import { newSpaceMock } from './SpaceMock';
+import { newSpaceMock } from './SpaceMock.js';
 import { newUserMock } from '@datalayer/core/lib/mocks/models/UserMock';
 export const newCourseMock = (name) => {
     const course = {

package/lib/models/CodeSandboxSnapshotDTO.js

@@ -2,7 +2,7 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { snapshots } from '../api/runtimes';
+import { snapshots } from '../api/runtimes/index.js';
 import { validateJSON } from '@datalayer/core/lib/api/utils/validation';
 /**
  * Snapshot domain model that wraps API responses with convenient methods.

package/lib/models/ItemDTO.js

@@ -2,7 +2,7 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import * as items from '../api/spacer/items';
+import * as items from '../api/spacer/items.js';
 /**
  * Abstract base class for all Datalayer content items.
  * Provides common functionality for content management including lifecycle tracking.

package/lib/models/LexicalDTO.js

@@ -7,9 +7,9 @@
  *
  * @module models/LexicalDTO
  */
-import * as lexicals from '../api/spacer/lexicals';
+import * as lexicals from '../api/spacer/lexicals.js';
 import { ItemTypes } from '@datalayer/core/lib/client';
-import { ItemDTO } from './ItemDTO';
+import { ItemDTO } from './ItemDTO.js';
 import { validateJSON } from '@datalayer/core/lib/api/utils/validation';
 /**
  * Lexical domain model that extends the base Item class.

package/lib/models/NotebookDTO.js

@@ -2,8 +2,8 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import * as notebooks from '../api/spacer/notebooks';
-import { ItemDTO } from './ItemDTO';
+import * as notebooks from '../api/spacer/notebooks.js';
+import { ItemDTO } from './ItemDTO.js';
 import { ItemTypes } from '@datalayer/core/lib/client/constants';
 import { validateJSON } from '@datalayer/core/lib/api/utils/validation';
 /**

package/lib/models/Page.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 import { asUser } from '@datalayer/core/lib/models/User';
-import { asCodeSandboxSnapshot, } from './CodeSandboxSnapshot';
+import { asCodeSandboxSnapshot, } from './CodeSandboxSnapshot.js';
 export const asPage = (s) => {
     return {
         id: s.uid,

package/lib/models/RuntimeDTO.js

@@ -7,7 +7,7 @@
  *
  * @module models/RuntimeDTO
  */
-import { updateRuntime } from '../api/runtimes/runtimes';
+import { updateRuntime } from '../api/runtimes/runtimes.js';
 import { validateJSON } from '@datalayer/core/lib/api/utils/validation';
 /**
  * Runtime domain model that wraps API responses with convenient methods.

package/lib/models/SpaceDTO.js

@@ -7,14 +7,14 @@
  *
  * @module models/SpaceDTO
  */
-import * as users from '../api/spacer/users';
-import * as items from '../api/spacer/items';
-import * as notebooks from '../api/spacer/notebooks';
-import * as lexicals from '../api/spacer/lexicals';
-import { NotebookDTO } from './NotebookDTO';
-import { LexicalDTO } from './LexicalDTO';
+import * as users from '../api/spacer/users.js';
+import * as items from '../api/spacer/items.js';
+import * as notebooks from '../api/spacer/notebooks.js';
+import * as lexicals from '../api/spacer/lexicals.js';
+import { NotebookDTO } from './NotebookDTO.js';
+import { LexicalDTO } from './LexicalDTO.js';
 import { ItemTypes } from '@datalayer/core/lib/client/constants';
-import { convertSpaceItemsToModels } from '../client/utils/spacerUtils';
+import { convertSpaceItemsToModels } from '../client/utils/spacerUtils.js';
 import { validateJSON } from '@datalayer/core/lib/api/utils/validation';
 /**
  * Space domain model that wraps API responses with convenient methods.

package/lib/models/index.js

@@ -3,38 +3,38 @@
  * Distributed under the terms of the Modified BSD License.
  */
 // Moved runtime + content + education models (owned by agent-runtimes).
-export * from './Assignment';
-export * from './Cell';
-export * from './CodeBlock';
-export * from './CodefeedBlocks';
-export * from './CodeSandboxSnapshot';
-export * from './CodeSandboxSnapshotDTO';
-export * from './Content';
-export * from './Course';
-export * from './Deck';
-export * from './Document';
-export * from './Environment';
-export * from './EnvironmentDTO';
-export * from './Exercise';
-export * from './Item';
-export * from './ItemDTO';
-export * from './ItemType';
-export * from './Lesson';
-export * from './LexicalDTO';
-export * from './Library';
-export * from './Notebook';
-export * from './NotebookDTO';
-export * from './Page';
-export * from './PageTag';
-export * from './ProjectDTO';
-export * from './CodeSandboxVariant';
-export * from './Runtime';
-export * from './RuntimeDTO';
-export * from './Space';
-export * from './SpaceDTO';
-export * from './SpaceItem';
-export * from './SpaceMember';
-export * from './StudentItem';
+export * from './Assignment.js';
+export * from './Cell.js';
+export * from './CodeBlock.js';
+export * from './CodefeedBlocks.js';
+export * from './CodeSandboxSnapshot.js';
+export * from './CodeSandboxSnapshotDTO.js';
+export * from './Content.js';
+export * from './Course.js';
+export * from './Deck.js';
+export * from './Document.js';
+export * from './Environment.js';
+export * from './EnvironmentDTO.js';
+export * from './Exercise.js';
+export * from './Item.js';
+export * from './ItemDTO.js';
+export * from './ItemType.js';
+export * from './Lesson.js';
+export * from './LexicalDTO.js';
+export * from './Library.js';
+export * from './Notebook.js';
+export * from './NotebookDTO.js';
+export * from './Page.js';
+export * from './PageTag.js';
+export * from './ProjectDTO.js';
+export * from './CodeSandboxVariant.js';
+export * from './Runtime.js';
+export * from './RuntimeDTO.js';
+export * from './Space.js';
+export * from './SpaceDTO.js';
+export * from './SpaceItem.js';
+export * from './SpaceMember.js';
+export * from './StudentItem.js';
 // Re-export identity/plans/account model interfaces that stay in core so
 // agent-runtimes code can resolve every model from this single barrel.
 export * from '@datalayer/core/lib/models';

package/lib/portable/activity.js

@@ -13,7 +13,7 @@
  *
  * @module portable/activity
  */
-import { RUN_END_WORDS } from './records';
+import { RUN_END_WORDS } from './records.js';
 const isRecord = (value) => Boolean(value) && typeof value === 'object' && !Array.isArray(value);
 const records = (value) => Array.isArray(value) ? value.filter(isRecord) : [];
 const said = (value) => typeof value === 'string' ? value : value == null ? '' : String(value);

package/lib/portable/approvalCard.js

@@ -12,7 +12,7 @@
  *
  * @module portable/approvalCard
  */
-import { messageOfApproval, whyAsked, } from './approvals';
+import { messageOfApproval, whyAsked, } from './approvals.js';
 /** What every approval card says. */
 export const APPROVAL_CARD_WORDS = {
     to: 'To',

package/lib/portable/attention.d.ts

@@ -0,0 +1,204 @@
+import type { SessionAttention } from './sessionList';
+export type { SessionAttention } from './sessionList';
+/** The Rules' classes of an action, as the Shield names them. */
+export type ActionClass = 'read' | 'write' | 'send' | 'buy' | 'delete' | 'execute' | 'publish';
+/** Every class, for a strict read of what an approval says. */
+export declare const ACTION_CLASSES: readonly ActionClass[];
+/**
+ * A coding agent's ACP `kind`, as a class: `read`, `search`, `fetch` read;
+ * `edit`, `move` write; `delete` deletes; `execute` executes; `other` is a
+ * write (fail closed), as the Shield maps them.
+ */
+export declare const ACP_KIND_CLASSES: Readonly<Record<string, ActionClass>>;
+/** An approval, as the chat's banner holds it. */
+export interface ApprovalRaised {
+    /** Its id where it is decided (ai-agents, or the local runtime). */
+    id: string;
+    /** The tool waiting on it. */
+    toolName: string;
+    /** Its arguments: read for the class only, never said in a notification. */
+    args: Record<string, unknown>;
+    /** The agent waiting on it. */
+    agentId: string;
+    /** When it was asked. */
+    requestedAt: string;
+}
+/**
+ * The class of what an approval asks: `_class` when it names one of the
+ * seven, else its ACP `_kind` mapped, else the verb its tool's name starts
+ * with; `write` when nothing says (fail closed, as `other` is).
+ *
+ * @param approval - Its tool and arguments.
+ *
+ * @returns One of the seven classes.
+ */
+export declare function actionClassOf(approval: Pick<ApprovalRaised, 'toolName' | 'args'>): ActionClass;
+/** The notification's three answers, in their order. */
+export declare const APPROVAL_ACTIONS: readonly ["Approve", "Decline", "Show"];
+/** One of the notification's answers. */
+export type ApprovalAction = (typeof APPROVAL_ACTIONS)[number];
+/** What a host says of approvals and decisions. */
+export declare const ATTENTION_WORDS: {
+    /**
+     * The sentence of a notification: *Support Desk asks to Run git push (execute)*.
+     *
+     * @param app - The application asking.
+     * @param action - What it asks to do, in words.
+     * @param cls - The action's class.
+     *
+     * @returns The sentence.
+     */
+    readonly asks: (app: string, action: string, cls: ActionClass) => string;
+    readonly notShown: "Open the chat to read the whole request before deciding it: Show.";
+    readonly answeredElsewhere: "This approval was answered elsewhere.";
+    readonly gone: "This approval is no longer waiting.";
+    readonly approved: (action: string) => string;
+    readonly declined: (action: string) => string;
+    readonly refused: (status: number) => string;
+    readonly working: "Datalayer: working…";
+    readonly waiting: (count: number) => string;
+    readonly finished: (title: string) => string;
+    readonly asksYou: (title: string) => string;
+    readonly runtimeGone: (title: string) => string;
+};
+/**
+ * The notification an approval is said as: the application, the action in
+ * words (`send_email` → *Send email*) and its class — never its arguments.
+ *
+ * @param app - The application asking.
+ * @param approval - What it asks: its tool and arguments.
+ *
+ * @returns The message and its answers.
+ */
+export declare function approvalNotification(app: string, approval: Pick<ApprovalRaised, 'toolName' | 'args'>): {
+    message: string;
+    actions: readonly ApprovalAction[];
+};
+/**
+ * The approvals to notify: those pending now that were not seen before —
+ * each is notified once, however often the banner is read again.
+ *
+ * @param seen - The ids notified already.
+ * @param pending - What is pending now.
+ *
+ * @returns The approvals not seen before, in the order asked.
+ */
+export declare function newlyRaised<T extends {
+    id: string;
+}>(seen: ReadonlySet<string>, pending: readonly T[]): T[];
+/**
+ * Whether a decision may be taken from the notification: only once the chat
+ * has shown the request whole at least once.
+ *
+ * @param shown - The ids the chat has shown.
+ * @param id - The approval to decide.
+ *
+ * @returns Whether deciding is allowed.
+ */
+export declare function decisionAllowed(shown: ReadonlySet<string>, id: string): boolean;
+/**
+ * Whether an approval read again still waits: decided only then.
+ *
+ * @param readAgain - The approval as read again, or null when the read failed.
+ *
+ * @returns Whether it is still pending.
+ */
+export declare function stillPending(readAgain: {
+    status?: unknown;
+} | null | undefined): boolean;
+/**
+ * What a decision came to, in a sentence: done; answered elsewhere (409);
+ * gone (404, which reveals nothing of it); refused with its status.
+ *
+ * @param status - The route's status.
+ * @param approved - Whether approval was asked.
+ * @param action - The action in words.
+ *
+ * @returns The sentence.
+ */
+export declare function decisionOutcome(status: number, approved: boolean, action: string): string;
+/**
+ * One session in a sentence: *Open · answering — shield-mvp-claude-code*.
+ *
+ * @param session - Its state, turn and agent.
+ *
+ * @returns The sentence.
+ */
+export declare function sessionSaid(session: SessionAttention): string;
+/**
+ * The sessions waiting for the person: open, their turn waiting.
+ *
+ * @param sessions - The sessions watched.
+ *
+ * @returns The waiting ones, in order.
+ */
+export declare function waitingSessions(sessions: readonly SessionAttention[]): SessionAttention[];
+/**
+ * What a dock badge counts (DK-14): the sessions waiting for the person.
+ *
+ * @param sessions - The sessions watched.
+ *
+ * @returns The count; zero clears the badge.
+ */
+export declare function badgeCount(sessions: readonly SessionAttention[]): number;
+/**
+ * The status bar's item (VS-10): *Datalayer: 2 waiting for you* when sessions
+ * wait (the first waiting one is what a click opens), *Datalayer: working…*
+ * while a turn of any runs, nothing otherwise. The tooltip says the
+ * session in front.
+ *
+ * @param sessions - The sessions watched.
+ *
+ * @returns The item, or null when it is hidden.
+ */
+export declare function statusBarItem(sessions: readonly SessionAttention[]): {
+    text: string;
+    tooltip: string;
+    first: string | null;
+} | null;
+/** One entry of a tray's menu (DK-14). */
+export interface TrayEntry {
+    /** The session's key, or empty for the heading. */
+    key: string;
+    label: string;
+}
+/**
+ * The tray's menu: a heading with the count, then one *Open* entry per
+ * session waiting for the person; *Nothing waits for you* when none does.
+ *
+ * @param sessions - The sessions watched.
+ *
+ * @returns The entries, the heading first.
+ */
+export declare function trayMenuOf(sessions: readonly SessionAttention[]): TrayEntry[];
+/** A notification about a session's turn. */
+export interface TurnNotice {
+    key: string;
+    title: string;
+    said: string;
+    /** What fired it. */
+    kind: 'finished' | 'asks' | 'gone';
+}
+/**
+ * The turns to notify between two readings: a session **not in front**
+ * whose turn was running and is not any more (the first line of its answer,
+ * else that it finished), whose turn came to wait for the person (a
+ * question, `loop.ask`), or whose runtime went away. The session in front
+ * is never notified; a session first seen is not.
+ *
+ * @param before - The sessions as last read.
+ * @param after - The sessions as read now.
+ *
+ * @returns The notices, in the order of `after`.
+ */
+export declare function finishedTurns(before: readonly SessionAttention[], after: readonly SessionAttention[]): TurnNotice[];
+/**
+ * How the OS cues the person (DK-14, Omnigent's rule): a banner when the
+ * host is not in front; a dock bounce or a taskbar flash when it is, so
+ * nothing covers what they look at.
+ *
+ * @param frontmost - Whether the host's window is focused.
+ *
+ * @returns `banner` or `cue`.
+ */
+export declare function cueOf(frontmost: boolean): 'banner' | 'cue';