@datalayer/agent-runtimes 1.3.10 → 1.3.13

package/lib/models/Environment.d.ts

@@ -170,6 +170,12 @@ export interface IDatalayerEnvironment {
      * from its public page expects to find it.
      */
     fromLibrary?: boolean;
+    /**
+     * How a reader is shown an entry whose launch name is not its name: a
+     * Library entry is launched by its environment's uid, and shown as the
+     * name its owner gave it, `steps-drill`, rather than that uid (E2-19).
+     */
+    label?: string;
 }
 /**
  * A refusal, as every registry route answers one (section 10): a code, a
@@ -358,6 +364,27 @@ export interface IEnvironmentConformanceReport {
     passed: boolean;
     checks: IEnvironmentConformanceCheck[];
 }
+/** One step of a build as its workflow ran it (E2-19). */
+export interface IEnvironmentBuildStep {
+    name: string;
+    status: 'running' | 'succeeded' | 'failed' | 'skipped';
+    startedAt?: string;
+    finishedAt?: string;
+    /** For a failure: its section 10 code. */
+    code?: string;
+    message?: string;
+    /**
+     * What the step found, for a page to list rather than leave in the log:
+     * `{kind: 'egress_refused', subject: 'github.com'}` for a host the build
+     * pool's egress proxy refused.
+     */
+    findings?: IEnvironmentBuildFinding[];
+}
+/** One finding of a build's step (E2-19): what it found, and what about. */
+export interface IEnvironmentBuildFinding {
+    kind: string;
+    subject: string;
+}
 export interface IEnvironmentBuildRecord {
     uid: string;
     environmentUid: string;
@@ -367,6 +394,13 @@ export interface IEnvironmentBuildRecord {
     region: string;
     /** Counted from 1; a retry is the next attempt. */
     attempt: number;
+    /**
+     * What this build is for: `build`, or `resolve` — a build that stops once
+     * the version has its lock (PLAN_ENVS.md E1-26). Absent from a Runtimes
+     * before that, and from every build recorded before the term existed, each
+     * of which is a build.
+     */
+    kind?: string;
     /** The request's key, suffixed with the variant and region. */
     idempotencyKey: string;
     /** `queued` when created; see `TERMINAL_ENVIRONMENT_BUILD_STATUSES`. */
@@ -379,6 +413,28 @@ export interface IEnvironmentBuildRecord {
      * report with `passed: false` names the checks that failed and why.
      */
     conformanceReport?: IEnvironmentConformanceReport | Record<string, never>;
+    /**
+     * Whether the retry route takes this build: cancelled, or failed under a
+     * code another attempt can pass (section 10). Said by Runtimes with the
+     * build, so a page offers Retry only where it would be taken (E2-19).
+     * Absent from a Runtimes before 1.0.36.
+     */
+    retryable?: boolean;
+    /**
+     * The build's steps as its workflow ran them (E2-19), each kept by its
+     * name: `resolve`, `build`, `attest`, `smoke_test`… Absent from a Runtimes
+     * before 1.0.37 and from a build nothing reported for.
+     */
+    steps?: IEnvironmentBuildStep[];
+    /**
+     * What the build spent (E2-19): its minutes by the daily quota's own rule —
+     * from its claim to its end, or to now while it runs — and those minutes at
+     * its variant's rate, in credits. `metered` is false where the provider
+     * bills the owner's own account (D-8). Absent from a Runtimes before them.
+     */
+    buildMinutes?: number;
+    credits?: number;
+    metered?: boolean;
     cacheHit: boolean;
     correlationId: string;
     requestedBy: string;
@@ -481,6 +537,13 @@ export interface IEnvironmentPublicationRecord {
     publishedAt: string;
     updatedAt: string;
     snapshot: IEnvironmentPublicationSnapshot;
+    /**
+     * What a second of the snapshot's size class costs, priced by Runtimes when
+     * the publication is read (E2-15, E2-19): what a launch of it reserves by,
+     * since a stranger has no listing entry of it to read a rate from. Absent
+     * from a Runtimes before 1.0.35, and `null` for a class nothing prices.
+     */
+    burningRate?: number | null;
     /** What a conditional write names in `If-Match`. */
     etag: string;
 }
@@ -640,3 +703,57 @@ export interface IEnvironmentBuildLogPage {
     complete: boolean;
 }
 export default IEnvironment;
+/** Section 13's preview limits, per owner. */
+export interface IEnvironmentQuotaLimits {
+    concurrentBuilds: number;
+    buildMinutesPerDay: number;
+    retainedVersions: number;
+    storedGib: number;
+}
+/** What an owner stores, and how it was measured. */
+export interface IEnvironmentStoredHoldings {
+    gib: number;
+    bytes: number;
+    source: string;
+    meteredArtifacts: number;
+    unmeteredArtifacts: number;
+}
+/** What an owner holds against each limit right now. */
+export interface IEnvironmentQuotaHoldings {
+    openBuilds: number;
+    buildMinutesToday: number;
+    retainedVersions: number;
+    storage: IEnvironmentStoredHoldings;
+}
+/**
+ * An owner's build quotas and holdings, `GET /environment-quotas`: the numbers
+ * a `DL_ENV_QUOTA_EXCEEDED` refusal quotes, read before one (E2-19).
+ */
+export interface IEnvironmentQuotas {
+    ownerType: 'user' | 'organization';
+    ownerUid: string;
+    limits: IEnvironmentQuotaLimits;
+    holdings: IEnvironmentQuotaHoldings;
+}
+/**
+ * One sandbox running a version. The caller's own carries its runtime uid,
+ * its digest and why it waits, if it does — the scheduler's own words, such
+ * as `Unschedulable: 0/6 nodes are available: 4 Insufficient cpu.`; anybody
+ * else's only its phase and start, so a page counts it without naming it.
+ */
+export interface IEnvironmentVersionSandbox {
+    /** `Pending` or `Running`: Kubernetes' phase of the sandbox's pod. */
+    phase: string;
+    startedAt: string;
+    yours: boolean;
+    runtimeUid?: string;
+    digest?: string;
+    waiting?: string;
+    /** Credits a second, for the caller's own: what it burns while it runs. */
+    burningRate?: number;
+}
+/** `GET /environment-versions/{uid}/sandboxes`. */
+export interface IEnvironmentVersionSandboxes {
+    versionUid: string;
+    sandboxes: IEnvironmentVersionSandbox[];
+}

package/lib/models/ItemType.d.ts

@@ -1,2 +1,2 @@
-export type IItemType = 'assignment' | 'authoring' | 'cell' | 'content' | 'credits' | 'dataset' | 'datasource' | 'document' | 'documentation' | 'environment' | 'exercise' | 'growth' | 'home' | 'invite' | 'lesson' | 'library' | 'mail' | 'management' | 'notebook' | 'onboarding' | 'organization' | 'page' | 'runtime' | 'runtime-snapshot' | 'settings' | 'share' | 'space' | 'storage' | 'success' | 'support' | 'tag' | 'team' | 'usage' | 'user' | 'undefined';
+export type IItemType = 'assignment' | 'authoring' | 'cell' | 'content' | 'credits' | 'dataset' | 'datasource' | 'deck' | 'document' | 'documentation' | 'environment' | 'exercise' | 'growth' | 'home' | 'invite' | 'lesson' | 'library' | 'mail' | 'management' | 'notebook' | 'onboarding' | 'organization' | 'page' | 'runtime' | 'runtime-snapshot' | 'settings' | 'share' | 'space' | 'storage' | 'success' | 'support' | 'tag' | 'team' | 'usage' | 'user' | 'undefined';
 export default IItemType;

package/lib/models/Runtime.d.ts

@@ -97,6 +97,12 @@ export interface IRuntimeRecord {
      * Runtime credits reservation expiration timestamp
      */
     expired_at?: string;
+    /**
+     * Why the runtime's pod does not run yet, in Kubernetes' own words — the
+     * scheduler's `Unschedulable: 0/6 nodes are available: 4 Insufficient
+     * cpu.`, or an image that cannot be pulled — or empty once it runs.
+     */
+    waiting?: string;
 }
 /**
  * Runtime description (UI layer).

package/lib/models/SpaceItem.d.ts

@@ -1,9 +1,10 @@
 import { INotebook } from './Notebook';
 import { IDocument } from './Document';
+import { IDeck } from './Deck';
 import { ICell } from './Cell';
 import { IEnvironment } from './Environment';
 import { ILesson } from './Lesson';
 import { IExercise } from './Exercise';
 import { IAssignment } from './Assignment';
-export type ISpaceItem = INotebook | ICell | IEnvironment | ILesson | IExercise | IAssignment | IDocument;
+export type ISpaceItem = INotebook | ICell | IEnvironment | ILesson | IExercise | IAssignment | IDocument | IDeck;
 export default ISpaceItem;

package/lib/models/environments.generated.d.ts

@@ -1,7 +1,7 @@
 /** The `$id` of the JSON Schema these types are generated from. */
 export declare const ENVIRONMENT_SCHEMA_ID = "https://datalayer.io/schemas/environments/v1alpha1/environment.json";
 /** The sha256 of the schema text these types are generated from. */
-export declare const ENVIRONMENT_SCHEMA_SHA256 = "76eb8c80d1e27f7c6519946a6f7022b53a717ff2645d993b34aaa54dea658201";
+export declare const ENVIRONMENT_SCHEMA_SHA256 = "3aa1a84206afd2d5d04d3a2eab28abca1d60e1a6a6ab8c14a94ace62b39e6015";
 /** The `apiVersion` an Environment document carries. */
 export declare const ENVIRONMENT_API_VERSION = "environments.datalayer.io/v1alpha1";
 /** The `kind` an Environment document carries. */
@@ -25,6 +25,9 @@ export interface BuildSecret {
     name: string;
 }
 export interface BuildSpec {
+    dependencyFile?: DependencyFileSpec | null;
+    dockerfile?: DockerfileSpec | null;
+    image?: ImageSourceSpec | null;
     /** Default: `"packages"`. */
     source?: 'packages' | 'dependencyFile' | 'dockerfile' | 'image';
 }
@@ -35,12 +38,36 @@ export interface Compatibility {
     regions?: string[];
     variants?: VariantSet;
 }
+/** One immutable file the Environment bakes from an external source. */
+export interface ContentsBuildEntry {
+    path: string;
+    /** Pattern: `^[0-9a-f]{64}$`. */
+    sha256: string;
+    /** Minimum: 0. */
+    sizeBytes?: number | null;
+    source: string;
+}
+/** A `requirements.txt`, a `pyproject.toml` with its `uv.lock`, or a conda `environment.yml` (E3-01, E3-02). */
+export interface DependencyFileSpec {
+    /** Default: `""`. */
+    content?: string;
+    /** Default: `""`. */
+    lockContent?: string;
+    /** Default: `"requirements"`. */
+    sourceFormat?: 'requirements' | 'pyproject' | 'conda';
+}
+/** The Dockerfile a `dockerfile`-sourced version builds from (E3-03). */
+export interface DockerfileSpec {
+    /** Default: `""`. */
+    content?: string;
+}
 export interface EnvironmentSpec {
     base: Base;
     build?: BuildSpec;
     buildSecrets?: BuildSecret[];
     commands?: Commands;
     compatibility?: Compatibility;
+    contentsBuild?: ContentsBuildEntry[];
     /** Default: `"sandbox-contract/v1"`. */
     contract?: string;
     env?: Record<string, string>;
@@ -58,6 +85,13 @@ export interface FileEntry {
     /** Minimum: 0. */
     sizeBytes?: number | null;
 }
+/** An existing OCI image, imported as the build's base (E3-04). */
+export interface ImageSourceSpec {
+    /** Pattern: `^dlsec_[0-9A-Za-z]+$`. */
+    credentialSecretId?: string | null;
+    /** Default: `""`. */
+    reference?: string;
+}
 export interface Language {
     name?: 'python';
     /** Pattern: `^3\.\d+$`. */

package/lib/models/environments.generated.js

@@ -6,7 +6,7 @@
 /** The `$id` of the JSON Schema these types are generated from. */
 export const ENVIRONMENT_SCHEMA_ID = 'https://datalayer.io/schemas/environments/v1alpha1/environment.json';
 /** The sha256 of the schema text these types are generated from. */
-export const ENVIRONMENT_SCHEMA_SHA256 = '76eb8c80d1e27f7c6519946a6f7022b53a717ff2645d993b34aaa54dea658201';
+export const ENVIRONMENT_SCHEMA_SHA256 = '3aa1a84206afd2d5d04d3a2eab28abca1d60e1a6a6ab8c14a94ace62b39e6015';
 /** The `apiVersion` an Environment document carries. */
 export const ENVIRONMENT_API_VERSION = 'environments.datalayer.io/v1alpha1';
 /** The `kind` an Environment document carries. */

package/lib/models/index.d.ts

@@ -6,6 +6,7 @@ export * from './CodeSandboxSnapshot';
 export * from './CodeSandboxSnapshotDTO';
 export * from './Content';
 export * from './Course';
+export * from './Deck';
 export * from './Document';
 export * from './Environment';
 export * from './EnvironmentDTO';

package/lib/models/index.js

@@ -11,6 +11,7 @@ export * from './CodeSandboxSnapshot';
 export * from './CodeSandboxSnapshotDTO';
 export * from './Content';
 export * from './Course';
+export * from './Deck';
 export * from './Document';
 export * from './Environment';
 export * from './EnvironmentDTO';

package/lib/protocols/BrowserAgentAdapter.d.ts

@@ -102,7 +102,14 @@ export declare class BrowserAgentAdapter extends BaseProtocolAdapter {
      * it and a host should not have to know which adapter it is holding.
      */
     sendToolResult(): Promise<void>;
-    /** The model this agent asks, resolved once per request. */
+    /**
+     * The model this agent asks, resolved once per request.
+     *
+     * The chat's model menu sends its choice with each message, as it does to
+     * a server-side harness; here it names the model the inference service is
+     * asked for, over the one the agent was built with. A ready-made
+     * `languageModel` is the host's own choice and is not swapped out.
+     */
     private resolveModel;
     /**
      * Run one turn of the loop and report it as it happens.
@@ -113,5 +120,6 @@ export declare class BrowserAgentAdapter extends BaseProtocolAdapter {
      */
     sendMessage(message: ChatMessage, options?: {
         messages?: ChatMessage[];
+        model?: string;
     }): Promise<void>;
 }

package/lib/protocols/BrowserAgentAdapter.js

@@ -122,8 +122,15 @@ export class BrowserAgentAdapter extends BaseProtocolAdapter {
      * it and a host should not have to know which adapter it is holding.
      */
     async sendToolResult() { }
-    /** The model this agent asks, resolved once per request. */
-    resolveModel() {
+    /**
+     * The model this agent asks, resolved once per request.
+     *
+     * The chat's model menu sends its choice with each message, as it does to
+     * a server-side harness; here it names the model the inference service is
+     * asked for, over the one the agent was built with. A ready-made
+     * `languageModel` is the host's own choice and is not swapped out.
+     */
+    resolveModel(requested) {
         const { languageModel, inference, model } = this.browserConfig;
         if (languageModel) {
             return languageModel;
@@ -131,7 +138,7 @@ export class BrowserAgentAdapter extends BaseProtocolAdapter {
         if (!inference) {
             throw new Error('A browser agent needs either a `languageModel` or an `inference` endpoint to reach one.');
         }
-        return createBrowserModel({ ...inference, model });
+        return createBrowserModel({ ...inference, model: requested || model });
     }
     /**
      * Run one turn of the loop and report it as it happens.
@@ -188,7 +195,7 @@ export class BrowserAgentAdapter extends BaseProtocolAdapter {
         };
         try {
             const result = streamText({
-                model: this.resolveModel(),
+                model: this.resolveModel(options?.model),
                 system: this.browserConfig.instructions,
                 messages: history,
                 tools: this.tools,

package/lib/runtimes/actions.d.ts

@@ -12,6 +12,11 @@ export declare function createRuntime(options: IRuntimeOptions): Promise<IRuntim
  * Get the Runtimes.
  */
 export declare function getRuntimes(): Promise<IRuntimeRecord[]>;
+/**
+ * One runtime as the platform answers it now — why its pod waits included —
+ * or `null` when there is none by that uid (E2-19).
+ */
+export declare function getRuntimeRecord(id: string): Promise<IRuntimeRecord | null>;
 /**
  * Delete a Runtime
  */

package/lib/runtimes/actions.js

@@ -109,6 +109,25 @@ export async function getRuntimes() {
     }
     return data.runtimes ?? [];
 }
+/**
+ * One runtime as the platform answers it now — why its pod waits included —
+ * or `null` when there is none by that uid (E2-19).
+ */
+export async function getRuntimeRecord(id) {
+    try {
+        const data = await requestDatalayerAPI({
+            url: runtimeUrl(runtimesStore.getState().runtimesUrl, id),
+            token: iamStore.getState().token,
+        });
+        return data.runtime ?? null;
+    }
+    catch (error) {
+        if (error.response?.status === 404) {
+            return null;
+        }
+        throw error;
+    }
+}
 /**
  * Delete a Runtime
  */

package/lib/specs/agents/agents.d.ts

@@ -11,6 +11,7 @@ export declare const EXAMPLE_A2A_WRITER_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_A2A_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_A2UI_AGENT_SPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_A2UI_JUPYTER_OUTPUT_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_A2UI_VIEWER_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_AGENT_CRITIC_LOOP_FOR_ANALYSIS_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_AGENTIC_CHAT_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_AGENTIC_GENERATIVE_UI_AGENTSPEC_0_0_1: Agentspec;
@@ -26,6 +27,7 @@ export declare const EXAMPLE_CODEMODE_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_COMPACTION_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_COMPARE_TWO_SPREADSHEETS_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_COST_COMPARISON_REPORT_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_DECKS_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_DOCUMENT_AGENT_SIDEBAR_AGENTSPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_DOCUMENT_AGENT_SPEC_0_0_1: Agentspec;
 export declare const EXAMPLE_EVALS_NOCODEMODE_AGENTSPEC_0_0_1: Agentspec;
@@ -109,7 +111,6 @@ export declare const WORKER_CURTAILMENT_INVESTIGATOR_AGENTSPEC_0_0_1: Agentspec;
 export declare const WORKER_CUSTOMER_CHURN_ANALYSIS_AGENTSPEC_0_0_1: Agentspec;
 export declare const WORKER_CUSTOMER_INTERVIEWER_AGENTSPEC_0_0_1: Agentspec;
 export declare const WORKER_DATA_ACQUISITION_AGENTSPEC_0_0_1: Agentspec;
-export declare const WORKER_DECKS_AGENTSPEC_0_0_1: Agentspec;
 export declare const WORKER_DISASTER_ASSESSMENT_AGENTSPEC_0_0_1: Agentspec;
 export declare const WORKER_DOCUMENT_QA_AGENTSPEC_0_0_1: Agentspec;
 export declare const WORKER_END_OF_MONTH_PERFORMANCE_AGENTSPEC_0_0_1: Agentspec;
@@ -144,6 +145,7 @@ export declare const WORKER_OPTIMIZE_GRID_OPERATIONS_AGENTSPEC_0_0_1: Agentspec;
 export declare const WORKER_OPTIMIZE_SQL_QUERY_PERFORMANCE_AGENTSPEC_0_0_1: Agentspec;
 export declare const WORKER_PERFORMANCE_ATTRIBUTION_AGENTSPEC_0_0_1: Agentspec;
 export declare const WORKER_PIPELINE_DEBUGGER_AGENTSPEC_0_0_1: Agentspec;
+export declare const WORKER_PITCHER_AGENTSPEC_0_0_1: Agentspec;
 export declare const WORKER_PORTFOLIO_ACCUMULATION_AGENTSPEC_0_0_1: Agentspec;
 export declare const WORKER_PORTFOLIO_RISK_AGENTSPEC_0_0_1: Agentspec;
 export declare const WORKER_PREDICTIVE_MAINTENANCE_AGENTSPEC_0_0_1: Agentspec;