@datalayer/core 1.2.20 → 1.2.22

package/lib/api/evals/client.d.ts

@@ -15,7 +15,7 @@ export type ListEvalsetsQuery = {
     run_environment?: EvalRunEnvironment;
     category?: EvalsetCategory;
     q?: string;
-    /** Only the benchmarks reading this dataset (B5-12, section 15.3). */
+    /** Only the benchmarks reading this dataset (B5-12). */
     dataset?: string;
     /** …and pinned to this revision of it: one revision is not evidence about another. */
     revision?: string;
@@ -68,8 +68,8 @@ export declare const previewEvalsetPublication: (options: EvalsClientOptions, ev
 /**
  * Publish the package: the immutable snapshot of the definition, the data, the
  * subjects, the environment, the results, the report, the evidence and the
- * evaluators (section 14.3). Refused with `detail.problems` where section 14.5
- * says it cannot be published.
+ * evaluators. Refused with `detail.problems` where something stands in the
+ * way of publishing it.
  */
 export declare const publishEvalsetPackage: (options: EvalsClientOptions, evalsetId: string, body?: {
     launch_ids?: string[];
@@ -118,13 +118,13 @@ export declare const getPublicEvalsetLeaderboard: (options: EvalsClientOptions,
  */
 export declare const getSubjectUsage: (options: EvalsClientOptions, subjectRef: string) => Promise<SubjectUsageResponse>;
 /**
- * Whether anything will run the account's benchmarks (B5-12, section 15.2):
+ * Whether anything will run the account's benchmarks (B5-12):
  * the executor, whether a worker polls the benchmark queue, and the account's
  * own queued and running launches.
  */
 export declare const getBenchmarkCompute: (options: EvalsClientOptions) => Promise<BenchmarkComputeResponse>;
 /**
- * What benchmark work a sandbox is doing (B5-12, section 15.4).
+ * What benchmark work a sandbox is doing (B5-12).
  *
  * The ref is a pool slot's name (`benchmark-<run>-slot-<n>`) or the snapshot
  * a sandbox was restored from. A sandbox of nobody's benchmark answers
@@ -132,7 +132,7 @@ export declare const getBenchmarkCompute: (options: EvalsClientOptions) => Promi
  */
 export declare const getSandboxProvenance: (options: EvalsClientOptions, sandboxRef: string) => Promise<SandboxProvenanceResponse>;
 /**
- * Find things across the caller's benchmarks (B5-11, section 19): benchmarks,
+ * Find things across the caller's benchmarks (B5-11): benchmarks,
  * launches, tasks, reports and investigations, each row keeping its kind and
  * what it belongs to.
  *

package/lib/api/evals/client.js

@@ -58,8 +58,8 @@ export const previewEvalsetPublication = (options, evalsetId, query = {}) => eva
 /**
  * Publish the package: the immutable snapshot of the definition, the data, the
  * subjects, the environment, the results, the report, the evidence and the
- * evaluators (section 14.3). Refused with `detail.problems` where section 14.5
- * says it cannot be published.
+ * evaluators. Refused with `detail.problems` where something stands in the
+ * way of publishing it.
  */
 export const publishEvalsetPackage = (options, evalsetId, body = {}) => evalsRequest(options, `/evalsets/${segment(evalsetId)}/publications`, {
     method: 'POST',
@@ -97,13 +97,13 @@ export const getPublicEvalsetLeaderboard = (options, evalsetId) => evalsRequest(
  */
 export const getSubjectUsage = (options, subjectRef) => evalsRequest(options, `/subjects/${subjectRef.split('/').map(encodeURIComponent).join('/')}/usage`);
 /**
- * Whether anything will run the account's benchmarks (B5-12, section 15.2):
+ * Whether anything will run the account's benchmarks (B5-12):
  * the executor, whether a worker polls the benchmark queue, and the account's
  * own queued and running launches.
  */
 export const getBenchmarkCompute = (options) => evalsRequest(options, '/compute/operations');
 /**
- * What benchmark work a sandbox is doing (B5-12, section 15.4).
+ * What benchmark work a sandbox is doing (B5-12).
  *
  * The ref is a pool slot's name (`benchmark-<run>-slot-<n>`) or the snapshot
  * a sandbox was restored from. A sandbox of nobody's benchmark answers
@@ -111,7 +111,7 @@ export const getBenchmarkCompute = (options) => evalsRequest(options, '/compute/
  */
 export const getSandboxProvenance = (options, sandboxRef) => evalsRequest(options, `/sandboxes/${sandboxRef.split('/').map(encodeURIComponent).join('/')}/provenance`);
 /**
- * Find things across the caller's benchmarks (B5-11, section 19): benchmarks,
+ * Find things across the caller's benchmarks (B5-11): benchmarks,
  * launches, tasks, reports and investigations, each row keeping its kind and
  * what it belongs to.
  *

package/lib/api/evals/status.d.ts

@@ -5,7 +5,7 @@
  * time (`queued`, `init`, `pending`, `running`, `completed`, `failed`,
  * `error`, `success`, `done`, …). This is the same mapping as
  * `agent_runtimes.evals.status` in Python: every word a writer has used maps
- * onto the product vocabulary of BENCHMARK.md section 11.4, and "finished" is
+ * onto the product vocabulary, and "finished" is
  * answered once. A word nobody has used maps to itself, lower-cased, so it is
  * visible rather than misread.
  *
@@ -17,9 +17,9 @@ export declare const CASE_STATUSES: readonly ["waiting", "provisioning", "runnin
 export type CaseStatus = (typeof CASE_STATUSES)[number];
 export declare const TERMINAL_RUN_STATUSES: ReadonlySet<string>;
 export declare const TERMINAL_CASE_STATUSES: ReadonlySet<string>;
-/** The section 11.4 word for a run status, whatever a writer wrote. */
+/** The product word for a run status, whatever a writer wrote. */
 export declare const normalizeRunStatus: (value: unknown) => RunStatus | string;
-/** The section 11.4 word for a case status. */
+/** The product word for a case status. */
 export declare const normalizeCaseStatus: (value: unknown) => CaseStatus | string;
 /** Whether a run with this status is over. */
 export declare const isTerminalRunStatus: (value: unknown) => boolean;

package/lib/api/evals/status.js

@@ -13,7 +13,7 @@
  * time (`queued`, `init`, `pending`, `running`, `completed`, `failed`,
  * `error`, `success`, `done`, …). This is the same mapping as
  * `agent_runtimes.evals.status` in Python: every word a writer has used maps
- * onto the product vocabulary of BENCHMARK.md section 11.4, and "finished" is
+ * onto the product vocabulary, and "finished" is
  * answered once. A word nobody has used maps to itself, lower-cased, so it is
  * visible rather than misread.
  *
@@ -106,12 +106,12 @@ const word = (value) => String(value ?? '')
     .trim()
     .toLowerCase()
     .replace(/[-\s]/g, '_');
-/** The section 11.4 word for a run status, whatever a writer wrote. */
+/** The product word for a run status, whatever a writer wrote. */
 export const normalizeRunStatus = (value) => {
     const key = word(value);
     return LEGACY_RUN_STATUS[key] ?? key;
 };
-/** The section 11.4 word for a case status. */
+/** The product word for a case status. */
 export const normalizeCaseStatus = (value) => {
     const key = word(value);
     return LEGACY_CASE_STATUS[key] ?? key;

package/lib/api/evals/types.d.ts

@@ -17,7 +17,7 @@
 export type EvalRunEnvironment = 'ui' | 'sdk';
 /** Fixed cases replayed (`batch`) or live events evaluated (`interactive`). */
 export type EvalKind = 'batch' | 'interactive';
-/** What a benchmark measures, the closed list section 12.5 renders by. */
+/** What a benchmark measures, the closed list the benchmark pages render by. */
 export type EvalsetCategory = 'data' | 'coding' | 'tool-use' | 'model' | 'visual' | 'performance';
 /** The dataset revision a benchmark reads; contents holds the revision. */
 export interface DatasetRef {
@@ -285,7 +285,7 @@ export interface LaunchPlanResponse {
     /**
      * How run mode, run environment and execution target relate, stated by
      * the service so the wizard explains it inline rather than failing after
-     * submission (BENCHMARK.md section 9).
+     * submission.
      */
     run_mode_constraint: string;
     problems: LaunchPlanProblem[];
@@ -466,7 +466,7 @@ export interface EvalsetPackageItem {
     uid: string;
     label: string;
 }
-/** What stands in the way of a publication (section 14.5). */
+/** What stands in the way of a publication. */
 export interface EvalsetPackageProblem {
     code: string;
     detail: string;
@@ -636,7 +636,7 @@ export interface SubjectUsage {
     active_launches: SubjectLaunch[];
     totals: SubjectTotals;
 }
-/** What a search made of the words somebody typed (B5-11, section 19). */
+/** What a search made of the words somebody typed (B5-11). */
 export interface EvalsSearchQuery {
     raw: string;
     /** What is left to look for by name, once the words that mean something else are taken out. */
@@ -676,7 +676,7 @@ export interface SubjectUsageResponse {
     usage: SubjectUsage;
 }
 /**
- * What benchmark work a sandbox is doing (B5-12, section 15.4).
+ * What benchmark work a sandbox is doing (B5-12).
  *
  * A pool slot's sandbox is named after the run it serves, and a sandbox
  * restored from a task's snapshot is found by that snapshot; either way the
@@ -723,7 +723,7 @@ export interface SandboxProvenanceResponse {
     provenance: SandboxProvenance;
 }
 /**
- * Whether anything will run the account's benchmarks (B5-12, section 15.2).
+ * Whether anything will run the account's benchmarks (B5-12).
  *
  * A launch at `queued` looks the same whether the queue is busy or nothing
  * polls it. `serving` is the difference. The depth is the account's own
@@ -1050,7 +1050,7 @@ export interface EvalsetVersionResponse {
 }
 export type InvestigationScope = 'case' | 'run' | 'launch' | 'window';
 export type InvestigationStatus = 'open' | 'closed';
-/** The restored sandbox, per section 12.6. */
+/** The restored sandbox. */
 export type SandboxState = 'available' | 'restoring' | 'running' | 'expired' | 'none';
 /** The work a person does on a benchmark result: one per task, run, launch or window. */
 export interface EvalInvestigation {
@@ -1165,7 +1165,7 @@ export interface EvalsSharingResponse extends SuccessResponse {
     };
 }
 /**
- * How far a record reaches (BENCHMARKS.md, B5-09, section 14.5), narrowest
+ * How far a record reaches (B5-09), narrowest
  * first. Derived from the grants and the public flag rather than stored, so it
  * cannot disagree with who may actually read the thing.
  */
@@ -1178,7 +1178,7 @@ export interface EvalsPermissionsResponse extends SuccessResponse {
     /** The widest thing that is true of this record. */
     visibility: EvalsVisibility;
 }
-/** The states of a report (section 13.3), in the order a report goes through them. */
+/** The states of a report, in the order a report goes through them. */
 export type ReportState = 'draft' | 'in_review' | 'approved' | 'published_private' | 'published_public' | 'superseded';
 /** A report over runs of one benchmark: its document and its state. */
 export interface EvalReport {

package/lib/api/iam/secrets.js

@@ -36,8 +36,8 @@ export const createSecret = async (token, data, baseUrl = DEFAULT_SERVICE_URLS.I
         variant: data.variant || 'generic',
         name: data.name,
         description: data.description || '',
-        // As it is. A secret has one representation end to end (PLAN_ENVS.md
-        // E3-05): this used to base64-encode, and nothing on the read side undid
+        // As it is. A secret has one representation end to end (E3-05):
+        // this used to base64-encode, and nothing on the read side undid
         // it, so a build secret arrived at its build encoded and opened nothing.
         value: data.value,
     };

package/lib/api/iam/servicePrincipals.js

@@ -4,7 +4,7 @@
  */
 /**
  * Service principals: a deployed LOOP application as a principal of its
- * own (plans/LOOP.md, I-02).
+ * own (I-02).
  *
  * The service agents' kin — a key that is exchanged for an hour's token, an
  * audit that names it — with two differences: a person may own one, not only

package/lib/api/iam/trials.js

@@ -8,7 +8,7 @@
  */
 /**
  * The anonymous trial: running the public benchmark before signing up
- * (BENCHMARK.md, B2-14).
+ * (B2-14).
  *
  * A visitor with no account asks for a trial and gets a principal of its
  * own with one benchmark it may run, a few credits and a short expiry. The

package/lib/api/orchestration/generated.d.ts

@@ -11,7 +11,7 @@ export interface Acknowledgement {
     checkpointId?: string | null;
     detail?: string | null;
 }
-/** The five milestones of section 6.3, in the order they are reached. */
+/** The five acknowledgement milestones, in the order they are reached. */
 export type AcknowledgementKind = 'received' | 'accepted' | 'started' | 'checkpointed' | 'completed';
 /** What a caller must present to be let in. */
 export interface AgentAuthentication {
@@ -148,11 +148,11 @@ export interface ArtifactProvenance {
     contentHash?: string | null;
     traceId?: string | null;
 }
-/** Where an artifact stands against the commit rule of 19.8. */
+/** Where an artifact stands against the commit rule: the first attempt to commit wins. */
 export type ArtifactStatus = 'registered' | 'committed' | 'superseded';
-/** What an artifact is, from the nine kinds of section 5.4. */
+/** What an artifact is, one of nine kinds. */
 export type ArtifactType = 'notebook' | 'report' | 'dataset' | 'cell-output' | 'file' | 'evaluation' | 'execution-log' | 'sandbox-snapshot' | 'json';
-/** One dispatch of an execution to a worker (section 6.4). */
+/** One dispatch of an execution to a worker. */
 export interface Attempt {
     attemptId: string;
     executionId: string;
@@ -227,7 +227,7 @@ export interface CommandAnswer {
     execution: Execution;
     success?: boolean;
 }
-/** The twelve commands of section 6.2. */
+/** The twelve commands of the orchestration lifecycle. */
 export type CommandName = 'agents.discover' | 'agents.create' | 'agents.attach' | 'executions.delegate' | 'executions.steer' | 'executions.pause' | 'executions.resume' | 'executions.cancel' | 'executions.checkpoint' | 'executions.collect' | 'executions.terminate' | 'executions.subscribe';
 /** Whether a worker may only read the reference, or also write it. */
 export type ContextAccess = 'read-only' | 'writable';
@@ -272,7 +272,7 @@ export interface DelegateAnswer {
     execution: Execution;
     success?: boolean;
 }
-/** The bounds a tree is created under, defaulted to 19.8's decision. */
+/** The bounds a tree is created under, with the decided defaults. */
 export interface DelegationLimits {
     maxDepth?: number;
     maxChildrenPerParent?: number;
@@ -588,7 +588,7 @@ export interface ReportAnswer {
     execution: Execution;
     success?: boolean;
 }
-/** How a failed attempt is tried again: 19.8's two retries, backing off. */
+/** How a failed attempt is tried again: two retries, backing off. */
 export interface RetryPolicy {
     maxRetries?: number;
     initialBackoffSeconds?: number;
@@ -604,7 +604,7 @@ export interface RuntimeRequirements {
     /** A Datalayer runtime environment name, when it runs on one. */
     environment?: string | null;
 }
-/** The W3C context that makes one tree one trace (section 10, O0-11). */
+/** The W3C context that makes one tree one trace (O0-11). */
 export interface Trace {
     traceparent?: string | null;
     tracestate?: string | null;
@@ -649,9 +649,9 @@ export interface WorkerAnswer {
     success?: boolean;
     worker: Worker;
 }
-/** A lifecycle operation a worker supports, named as section 6.2 names it. */
+/** A lifecycle operation a worker supports, named as the orchestration lifecycle names it. */
 export type WorkerOperation = 'delegate' | 'steer' | 'pause' | 'resume' | 'cancel' | 'checkpoint' | 'collect' | 'terminate' | 'subscribe';
-/** The lifecycle of section 6.1: what a state accepts, and where it leads. */
+/** The lifecycle: what a state accepts, and where it leads. */
 export interface OrchestrationLifecycle {
     readonly initial: ExecutionState;
     readonly states: readonly ExecutionState[];
@@ -668,9 +668,9 @@ export interface OrchestrationCommand {
     readonly mutating: boolean;
 }
 export declare const ORCHESTRATION_COMMANDS: readonly OrchestrationCommand[];
-/** The five milestones of section 6.3, in the order they are reached. */
+/** The five milestones, in the order they are reached. */
 export declare const ORCHESTRATION_ACKNOWLEDGEMENT_ORDER: readonly AcknowledgementKind[];
-/** The default limits of 19.8, read from the models' own defaults. */
+/** The default limits, read from the models' own defaults. */
 export interface OrchestrationLimits {
     readonly delegation: DelegationLimits;
     readonly retry: RetryPolicy;

package/lib/api/orchestration/generated.js

@@ -91,7 +91,7 @@ export const ORCHESTRATION_COMMANDS = [
     { name: 'executions.terminate', mutating: true },
     { name: 'executions.subscribe', mutating: false },
 ];
-/** The five milestones of section 6.3, in the order they are reached. */
+/** The five milestones, in the order they are reached. */
 export const ORCHESTRATION_ACKNOWLEDGEMENT_ORDER = ['received', 'accepted', 'started', 'checkpointed', 'completed'];
 export const ORCHESTRATION_LIMITS = {
     delegation: {

package/lib/api/orchestration/index.d.ts

@@ -3,8 +3,8 @@
  * work it is delegating, supervising, steering, recovering or stopping.
  *
  * Every type here is generated from the pydantic models in
- * `datalayer_core/orchestration`, which are the source of truth
- * (PLAN_ORCHESTRATOR.md, 19.8), and from the control plane's OpenAPI
+ * `datalayer_core/orchestration`, which are the source of truth,
+ * and from the control plane's OpenAPI
  * document for the answers it wraps them in and the operations it serves.
  * Regenerate with `npm run generate:orchestration`;
  * `npm run check:orchestration-generated` is the gate that fails when the

package/lib/api/orchestration/index.js

@@ -7,8 +7,8 @@
  * work it is delegating, supervising, steering, recovering or stopping.
  *
  * Every type here is generated from the pydantic models in
- * `datalayer_core/orchestration`, which are the source of truth
- * (PLAN_ORCHESTRATOR.md, 19.8), and from the control plane's OpenAPI
+ * `datalayer_core/orchestration`, which are the source of truth,
+ * and from the control plane's OpenAPI
  * document for the answers it wraps them in and the operations it serves.
  * Regenerate with `npm run generate:orchestration`;
  * `npm run check:orchestration-generated` is the gate that fails when the

package/lib/api/orchestration/lifecycle.d.ts

@@ -1,5 +1,5 @@
 /**
- * The canonical execution lifecycle (PLAN_ORCHESTRATOR.md, section 6.1, O0-02).
+ * The canonical execution lifecycle (O0-02).
  *
  * The states and the moves between them are not written here: they are
  * generated from `datalayer_core/orchestration/lifecycle.py`, which is the

package/lib/api/orchestration/lifecycle.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * The canonical execution lifecycle (PLAN_ORCHESTRATOR.md, section 6.1, O0-02).
+ * The canonical execution lifecycle (O0-02).
  *
  * The states and the moves between them are not written here: they are
  * generated from `datalayer_core/orchestration/lifecycle.py`, which is the

package/lib/api/scheduler/client.d.ts

@@ -17,7 +17,7 @@ export declare const listSchedules: (options: SchedulerClientOptions, query?: {
 /** One schedule. */
 export declare const getSchedule: (options: SchedulerClientOptions, scheduleUid: string) => Promise<ScheduleResponse>;
 /**
- * Create the one schedule a target has, or replace it (BENCHMARK.md, B2-16):
+ * Create the one schedule a target has, or replace it (B2-16):
  * a schedule is unique per owner and target, so upserting is how a person
  * changes an `evalset` schedule's cron or configuration too.
  */

package/lib/api/scheduler/client.js

@@ -24,7 +24,7 @@ export const listSchedules = (options, query = {}) => schedulerRequest(options,
 /** One schedule. */
 export const getSchedule = (options, scheduleUid) => schedulerRequest(options, `/schedules/${scheduleSegment(scheduleUid)}`);
 /**
- * Create the one schedule a target has, or replace it (BENCHMARK.md, B2-16):
+ * Create the one schedule a target has, or replace it (B2-16):
  * a schedule is unique per owner and target, so upserting is how a person
  * changes an `evalset` schedule's cron or configuration too.
  */

package/lib/api/scheduler/types.d.ts

@@ -33,7 +33,7 @@ export interface ScheduleRecord {
     creation_ts_dt?: string;
     last_update_ts_dt?: string;
 }
-/** What an `evalset` schedule's `config_json_t` holds (BENCHMARK.md, B2-16). */
+/** What an `evalset` schedule's `config_json_t` holds (B2-16). */
 export interface EvalsetScheduleConfig {
     /** Empty means every live experiment of the evalset, resolved at run time. */
     experiment_ids?: string[];

package/lib/api/spacer/comments.d.ts

@@ -1,5 +1,5 @@
 /**
- * Comments on documents and notebooks (BENCHMARK.md, B4-01).
+ * Comments on documents and notebooks (B4-01).
  *
  * A thread is its first comment, about one anchor — the highlighted text, a
  * report's evidence block, a cell, a task, a data point — and a reply names

package/lib/api/spacer/comments.js

@@ -7,7 +7,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * Comments on documents and notebooks (BENCHMARK.md, B4-01).
+ * Comments on documents and notebooks (B4-01).
  *
  * A thread is its first comment, about one anchor — the highlighted text, a
  * report's evidence block, a cell, a task, a data point — and a reply names

package/lib/api/spacer/spaces.d.ts

@@ -55,7 +55,7 @@ export interface WorkspaceSearchResponse {
 }
 /**
  * Search the caller's own workspace: notebooks, documents, datasets, files
- * (BENCHMARKS.md, B5-11, section 19).
+ * (B5-11).
  *
  * Scoped by the service to what this person may open — never other people's
  * public items, which the Library's own search answers. An empty query lists

package/lib/api/spacer/spaces.js

@@ -34,7 +34,7 @@ export const getManagedSpace = async (options, kind, accountUid) => {
 };
 /**
  * Search the caller's own workspace: notebooks, documents, datasets, files
- * (BENCHMARKS.md, B5-11, section 19).
+ * (B5-11).
  *
  * Scoped by the service to what this person may open — never other people's
  * public items, which the Library's own search answers. An empty query lists

package/lib/client/mixins/IAMMixin.js

@@ -46,7 +46,7 @@ export function IAMMixin(Base) {
                     email_s: response.profile.email_s || response.profile.email,
                     first_name_t: response.profile.first_name_t || response.profile.first_name || '',
                     last_name_t: response.profile.last_name_t || response.profile.last_name || '',
-                    // Use avatar_url_s if available, otherwise leave undefined for fallback
+                    // The avatar's URL when the profile has one; without, the user's avatarUrl is ''.
                     avatar_url_s: response.profile.avatar_url_s || response.profile.avatar_url,
                 };
             }

package/lib/hooks/useCache.js

@@ -1271,7 +1271,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
             tags: Array.isArray(raw_evalset.tags_ss) ? raw_evalset.tags_ss : [],
             /*
              * What the runs of a benchmark say about it, projected onto its
-             * library card whenever a run moves (BENCHMARK.md, B2-10 and B1-09).
+             * library card whenever a run moves (B2-10 and B1-09).
              *
              * These were dropped here, so a card in the Library or on the home
              * page could show a name and a description and nothing that would
@@ -1297,7 +1297,7 @@ export const useCache = ({ loginRoute = '/login' } = {}) => {
         };
     };
     /**
-     * A published environment version as a library artifact (PLAN_ENV E2-16).
+     * A published environment version as a library artifact (E2-16).
      *
      * Keyed on the version uid, so one published version is one card, and read
      * from the publication's immutable snapshot: its name, title, README (the

package/lib/models/Secret.d.ts

@@ -144,7 +144,7 @@ export declare class SecretDTO {
     get variant(): ISecretVariant;
     get name(): string;
     get description(): string;
-    /** The value as its owner wrote it (PLAN_ENVS.md E3-05). */
+    /** The value as its owner wrote it (E3-05). */
     get value(): string;
     /**
      * Update this secret.

package/lib/models/Secret.js

@@ -74,7 +74,7 @@ export class SecretDTO {
         this._checkDeleted();
         return this._data.description_t;
     }
-    /** The value as its owner wrote it (PLAN_ENVS.md E3-05). */
+    /** The value as its owner wrote it (E3-05). */
     get value() {
         this._checkDeleted();
         return this._data.value_s;

package/lib/models/StartedBy.d.ts

@@ -50,7 +50,7 @@ export declare const startedBy: (metadata: UsageMetadata) => StartedBy;
  * The words a search box matches on for this row.
  *
  * "agent" matches every agent-started runtime, the client id matches one
- * client, and "you" matches your own — so the filter the plan asks for is the
+ * client, and "you" matches your own — so the filter asked for is the
  * search box that is already there rather than a second control beside it.
  */
 export declare const startedBySearchTerms: (metadata: UsageMetadata) => string;

package/lib/models/StartedBy.js

@@ -65,7 +65,7 @@ export const startedBy = (metadata) => {
  * The words a search box matches on for this row.
  *
  * "agent" matches every agent-started runtime, the client id matches one
- * client, and "you" matches your own — so the filter the plan asks for is the
+ * client, and "you" matches your own — so the filter asked for is the
  * search box that is already there rather than a second control beside it.
  */
 export const startedBySearchTerms = (metadata) => {

package/lib/models/UserDTO.d.ts

@@ -68,6 +68,7 @@ export declare class UserDTO {
     get firstName(): string;
     get lastName(): string;
     get displayName(): string;
+    /** The avatar's URL, or `''` when the profile has none: a person without a picture is still a user. */
     get avatarUrl(): string;
     get avatarIcon(): string | undefined;
     get banner(): string | undefined;

package/lib/models/UserDTO.js

@@ -40,8 +40,9 @@ export class UserDTO {
     get displayName() {
         return `${this.firstName} ${this.lastName}`.trim();
     }
+    /** The avatar's URL, or `''` when the profile has none: a person without a picture is still a user. */
     get avatarUrl() {
-        return this._data.avatar_url_s;
+        return this._data.avatar_url_s ?? '';
     }
     get avatarIcon() {
         return this._data.avatar_icon_s;

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

@@ -70,6 +70,12 @@ export type NavigationState = {
  * through or on a page that belongs to no shell.
  */
 export declare function isRememberableRoute(route: string): boolean;
+/**
+ * Whether a page is a hosted application, run at its address, rather than a
+ * page of the Apps shell. It is visited, not returned to: the Apps shell
+ * never reopens on one, and one remembered before is dropped on load.
+ */
+export declare function isHostedAppRoute(route: string): boolean;
 /**
  * Whether a page belongs to no shell: the settings, the documentation and
  * the decks.

package/lib/state/substates/NavigationState.js

@@ -199,7 +199,48 @@ export function isRememberableRoute(route) {
         '/oauth',
         '/join',
     ].some(prefix => path === prefix || path.startsWith(`${prefix}/`)) &&
-        !isShellNeutralRoute(route));
+        !isShellNeutralRoute(route) &&
+        !isHostedAppRoute(route));
+}
+/**
+ * The Apps shell's own pages under `/apps/<section>`. Any other first segment
+ * is an application's hosted address (`/apps/<slug>`, its preview at
+ * `/apps/<slug>/preview/<version>`).
+ */
+const APPS_SHELL_SECTIONS = new Set([
+    'activity',
+    'agents',
+    'apps',
+    'components',
+    'connections',
+    'contents',
+    'context',
+    'deployments',
+    'evalsets',
+    'examples',
+    'home',
+    'models',
+    'readiness',
+    'reports',
+    'rules',
+    'runs',
+    'shared',
+    'skills',
+    'usage',
+    'workspace',
+]);
+/**
+ * Whether a page is a hosted application, run at its address, rather than a
+ * page of the Apps shell. It is visited, not returned to: the Apps shell
+ * never reopens on one, and one remembered before is dropped on load.
+ */
+export function isHostedAppRoute(route) {
+    const segments = pathOf(route).split('/').filter(Boolean);
+    return (segments[0] === 'apps' &&
+        segments.length >= 2 &&
+        !APPS_SHELL_SECTIONS.has(segments[1]) &&
+        (segments.length === 2 ||
+            (segments.length === 4 && segments[2] === 'preview')));
 }
 /**
  * Whether a page belongs to no shell: the settings, the documentation and

package/lib/views/secrets/SecretNew.js

@@ -77,7 +77,7 @@ export const SecretNew = ({ secretsListRoute = '/settings/secrets', } = {}) => {
             name: formValues.name,
             description: formValues.description,
             // As it is: a secret has one representation end to end
-            // (PLAN_ENVS.md E3-05). This used to `btoa` and nothing on the read
+            // (E3-05). This used to `btoa` and nothing on the read
             // side undid it, so a build secret arrived at its build encoded and
             // opened nothing.
             value: formValues.value,

package/package.json

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

package/scripts/generate-orchestration-types.py

@@ -6,7 +6,7 @@
 Generate deterministic TypeScript types from the canonical orchestration models.
 
 The pydantic models in ``datalayer_core/orchestration`` are the source of
-truth (PLAN_ORCHESTRATOR.md, 19.8) and ``src/api/orchestration/generated.ts``
+truth and ``src/api/orchestration/generated.ts``
 is what they say, in TypeScript, for the browser and the app. This is the
 ``generate-contents-types.py`` and ``generate-mcp-types.py`` pattern with two
 documents rather than one:
@@ -24,19 +24,19 @@ documents rather than one:
 What is written:
 
 - one ``interface`` per model and one ``type`` per shared vocabulary, camel
-  case on the wire because the plan writes the model that way in section 5.2
+  case on the wire because the model is written that way
   and because a browser that has to convert is a browser that can convert
   wrongly;
 - ``ORCHESTRATION_LIFECYCLE``: the states, the terminal states and the
-  transition table of section 6.1, so the TypeScript state machine (O0-02)
+  transition table, so the TypeScript state machine (O0-02)
   reads the same data the Python one does rather than a copy of it;
 - ``ORCHESTRATION_COMMANDS``: the twelve commands and which of them mutate,
-  so that "every mutating command carries an idempotency key" (6.4) is one
+  so that "every mutating command carries an idempotency key" is one
   fact in one place;
-- ``ORCHESTRATION_ACKNOWLEDGEMENT_ORDER``: the five milestones of 6.3, in
+- ``ORCHESTRATION_ACKNOWLEDGEMENT_ORDER``: the five milestones, in
   order, because "has it reached acceptance yet" is a comparison;
-- ``ORCHESTRATION_LIMITS``: the default depth, fan-out and retry limits of
-  19.8, read from the models' own defaults;
+- ``ORCHESTRATION_LIMITS``: the default depth, fan-out and retry limits,
+  read from the models' own defaults;
 - ``ORCHESTRATION_FIELDS``: which fields each model has, and which model
   each nested one holds. TypeScript
   types vanish at runtime and ``src/**/__tests__`` is outside the tsconfig,
@@ -630,7 +630,7 @@ def _api(paths: dict[str, Any]) -> list[str]:
 
 def _lifecycle() -> list[str]:
     """
-    Render the lifecycle of section 6.1 as data (O0-02).
+    Render the lifecycle as data (O0-02).
 
     Returns
     -------
@@ -651,7 +651,7 @@ def _lifecycle() -> list[str]:
         "transitions": transitions,
     }
     return [
-        "/** The lifecycle of section 6.1: what a state accepts, and where it leads. */",
+        "/** The lifecycle: what a state accepts, and where it leads. */",
         "export interface OrchestrationLifecycle {",
         f"{INDENT}readonly initial: ExecutionState;",
         f"{INDENT}readonly states: readonly ExecutionState[];",
@@ -693,7 +693,7 @@ def _commands() -> list[str]:
             "ORCHESTRATION_COMMANDS", "readonly OrchestrationCommand[]", commands
         ),
         "",
-        "/** The five milestones of section 6.3, in the order they are reached. */",
+        "/** The five milestones, in the order they are reached. */",
         *_declare(
             "ORCHESTRATION_ACKNOWLEDGEMENT_ORDER",
             "readonly AcknowledgementKind[]",
@@ -705,7 +705,7 @@ def _commands() -> list[str]:
 
 def _limits() -> list[str]:
     """
-    Render the default delegation and retry limits of 19.8.
+    Render the default delegation and retry limits.
 
     Returns
     -------
@@ -717,7 +717,7 @@ def _limits() -> list[str]:
         "retry": RetryPolicy().to_wire(),
     }
     return [
-        "/** The default limits of 19.8, read from the models' own defaults. */",
+        "/** The default limits, read from the models' own defaults. */",
         "export interface OrchestrationLimits {",
         f"{INDENT}readonly delegation: DelegationLimits;",
         f"{INDENT}readonly retry: RetryPolicy;",