@datalayer/core 1.1.60 → 1.2.10

package/lib/models/Secret.js

@@ -55,22 +55,6 @@ export class SecretDTO {
             throw new Error(`Secret ${this._data.name_s} has been deleted and no longer exists`);
         }
     }
-    _decodeValue(encodedValue) {
-        try {
-            if (typeof Buffer !== 'undefined') {
-                // Node.js environment
-                return Buffer.from(encodedValue, 'base64').toString();
-            }
-            else {
-                // Browser environment
-                return atob(encodedValue);
-            }
-        }
-        catch (error) {
-            console.error('Failed to decode secret value:', error);
-            return encodedValue; // Return as-is if decode fails
-        }
-    }
     // ========================================================================
     // Properties
     // ========================================================================
@@ -90,10 +74,10 @@ export class SecretDTO {
         this._checkDeleted();
         return this._data.description_t;
     }
-    /** Returns decoded (plain text) secret value */
+    /** The value as its owner wrote it (PLAN_ENVS.md E3-05). */
     get value() {
         this._checkDeleted();
-        return this._decodeValue(this._data.value_s);
+        return this._data.value_s;
     }
     // ========================================================================
     // Action Methods

package/lib/models/StartedBy.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Who started a runtime: a person, one of their agents, or a service agent.
+ *
+ * The reservation has carried this since agents could make one — IAM writes
+ * `client_id_s` and `agent_uid_s` onto the usage record's metadata, and
+ * `useUsages` already hands the whole map to the views. Nothing displayed
+ * it, so a person looking at their running runtimes could not tell which of
+ * them they had started and which an agent had, on a platform whose premise
+ * is that agents start things on your behalf.
+ *
+ * The distinction that matters is **agent versus service agent**, not
+ * "automated versus not". A delegated agent runs as you, spends your
+ * credits, and stops when you disconnect it. A service agent is the
+ * organization's own principal with its own key: it keeps running when the
+ * person who set it up leaves, and it is the row somebody has to go and turn
+ * off. Told apart, one is "I did that yesterday" and the other is "who owns
+ * this".
+ *
+ * @module models/StartedBy
+ */
+/** The Solr field names IAM writes the dimensions on. */
+export declare const CLIENT_ID_KEY = "client_id_s";
+export declare const AGENT_UID_KEY = "agent_uid_s";
+export type StartedByKind = 'person' | 'agent' | 'service-agent';
+export interface StartedBy {
+    kind: StartedByKind;
+    /** What to show in a cell: a client id, an agent uid, or "You". */
+    label: string;
+    /** The MCP client it connected as, where there is one. */
+    clientId: string;
+    /** The service agent's uid, where it is one. */
+    agentUid: string;
+}
+/** Metadata as `useUsages` builds it, or as a plain object. */
+export type UsageMetadata = Map<string, unknown> | Record<string, unknown> | null | undefined;
+/**
+ * Who started this reservation.
+ *
+ * `agent_uid_s` decides before `client_id_s`, because a service agent
+ * reaching Runtimes through the MCP gateway carries **the gateway's** client
+ * id: read the other way round, every one of an organization's pipelines
+ * would show as the same agent.
+ *
+ * A record with neither dimension is a person's own work. It is *not* an
+ * agent whose name we failed to read, and saying "unknown" would suggest it
+ * was — so the answer is the reader themselves.
+ */
+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
+ * search box that is already there rather than a second control beside it.
+ */
+export declare const startedBySearchTerms: (metadata: UsageMetadata) => string;
+/** The choices a "started by" filter offers, `all` included. */
+export type StarterFilter = 'all' | StartedByKind;
+/** Those choices in the order they are drawn, with the words for each. */
+export declare const STARTER_FILTERS: {
+    id: StarterFilter;
+    label: string;
+}[];
+/** Enough of a usage record to say who started the resource it is for. */
+export interface StarterUsage {
+    /** The resource this reservation is for — a runtime's uid. */
+    id: string;
+    metadata: UsageMetadata;
+}
+/**
+ * Who started the resource a uid names, from the reservations in hand.
+ *
+ * `undefined` when no reservation for it has been read — which is a
+ * different answer from "a person did". `startedBy` reads a record with
+ * neither dimension as the reader's own work, and that is right *for a
+ * record*: the dimensions are written when the reservation is made, so their
+ * absence is meaningful. Their absence from a row that does not exist is
+ * not. Saying "You" while the reservations are still loading would put the
+ * reader's name on a runtime one of their agents started, in the one view
+ * built to tell those apart.
+ */
+export declare const startedByResource: (resourceUid: string, usages: readonly StarterUsage[] | null | undefined) => StartedBy | undefined;
+/**
+ * Whether a row survives the filter.
+ *
+ * A row nobody could classify passes only `all`. Narrowing to "Your agents"
+ * and being shown rows that might be anything is not a narrower answer —
+ * it is the same answer with a claim attached.
+ */
+export declare const matchesStarter: (who: StartedBy | undefined, filter: StarterFilter) => boolean;
+export default startedBy;

package/lib/models/StartedBy.js

@@ -0,0 +1,117 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/*
+ * Copyright (c) 2023-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * Who started a runtime: a person, one of their agents, or a service agent.
+ *
+ * The reservation has carried this since agents could make one — IAM writes
+ * `client_id_s` and `agent_uid_s` onto the usage record's metadata, and
+ * `useUsages` already hands the whole map to the views. Nothing displayed
+ * it, so a person looking at their running runtimes could not tell which of
+ * them they had started and which an agent had, on a platform whose premise
+ * is that agents start things on your behalf.
+ *
+ * The distinction that matters is **agent versus service agent**, not
+ * "automated versus not". A delegated agent runs as you, spends your
+ * credits, and stops when you disconnect it. A service agent is the
+ * organization's own principal with its own key: it keeps running when the
+ * person who set it up leaves, and it is the row somebody has to go and turn
+ * off. Told apart, one is "I did that yesterday" and the other is "who owns
+ * this".
+ *
+ * @module models/StartedBy
+ */
+/** The Solr field names IAM writes the dimensions on. */
+export const CLIENT_ID_KEY = 'client_id_s';
+export const AGENT_UID_KEY = 'agent_uid_s';
+const read = (metadata, key) => {
+    if (!metadata) {
+        return '';
+    }
+    const value = metadata instanceof Map
+        ? metadata.get(key)
+        : metadata[key];
+    return typeof value === 'string' ? value.trim() : '';
+};
+/**
+ * Who started this reservation.
+ *
+ * `agent_uid_s` decides before `client_id_s`, because a service agent
+ * reaching Runtimes through the MCP gateway carries **the gateway's** client
+ * id: read the other way round, every one of an organization's pipelines
+ * would show as the same agent.
+ *
+ * A record with neither dimension is a person's own work. It is *not* an
+ * agent whose name we failed to read, and saying "unknown" would suggest it
+ * was — so the answer is the reader themselves.
+ */
+export const startedBy = (metadata) => {
+    const agentUid = read(metadata, AGENT_UID_KEY);
+    const clientId = read(metadata, CLIENT_ID_KEY);
+    if (agentUid) {
+        return { kind: 'service-agent', label: agentUid, clientId, agentUid };
+    }
+    if (clientId) {
+        return { kind: 'agent', label: clientId, clientId, agentUid: '' };
+    }
+    return { kind: 'person', label: 'You', clientId: '', agentUid: '' };
+};
+/**
+ * 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
+ * search box that is already there rather than a second control beside it.
+ */
+export const startedBySearchTerms = (metadata) => {
+    const who = startedBy(metadata);
+    if (who.kind === 'person') {
+        return 'you person';
+    }
+    if (who.kind === 'service-agent') {
+        return `agent service-agent ${who.agentUid} ${who.clientId}`.trim();
+    }
+    return `agent ${who.clientId}`;
+};
+/** Those choices in the order they are drawn, with the words for each. */
+export const STARTER_FILTERS = [
+    { id: 'all', label: 'Anyone' },
+    { id: 'person', label: 'You' },
+    { id: 'agent', label: 'Your agents' },
+    { id: 'service-agent', label: 'Service agents' },
+];
+/**
+ * Who started the resource a uid names, from the reservations in hand.
+ *
+ * `undefined` when no reservation for it has been read — which is a
+ * different answer from "a person did". `startedBy` reads a record with
+ * neither dimension as the reader's own work, and that is right *for a
+ * record*: the dimensions are written when the reservation is made, so their
+ * absence is meaningful. Their absence from a row that does not exist is
+ * not. Saying "You" while the reservations are still loading would put the
+ * reader's name on a runtime one of their agents started, in the one view
+ * built to tell those apart.
+ */
+export const startedByResource = (resourceUid, usages) => {
+    const usage = (usages ?? []).find(entry => entry.id === resourceUid);
+    return usage ? startedBy(usage.metadata) : undefined;
+};
+/**
+ * Whether a row survives the filter.
+ *
+ * A row nobody could classify passes only `all`. Narrowing to "Your agents"
+ * and being shown rows that might be anything is not a narrower answer —
+ * it is the same answer with a claim attached.
+ */
+export const matchesStarter = (who, filter) => {
+    if (filter === 'all') {
+        return true;
+    }
+    return who?.kind === filter;
+};
+export default startedBy;

package/lib/models/Team.d.ts

@@ -11,6 +11,8 @@ export type IBaseTeam = {
     avatarIcon?: string;
     banner?: string;
     public: boolean;
+    /** The origin of its organization, inherited at creation; absent for a native one. */
+    origin?: string;
     creationDate: Date;
     lastUpdateDate?: Date;
     lastPublicationDate?: Date;

package/lib/models/Team.js

@@ -21,6 +21,8 @@ export function asTeam(t, organizationId) {
         avatarIcon: t.avatar_icon_s ?? t.avatarIcon,
         banner: t.banner_s ?? t.banner,
         public: t.public_b,
+        // Inherited from the organization at creation; absent for a native one.
+        origin: t.origin_s ?? t.origin ?? undefined,
         members,
         organization: {
             id: organizationId,

package/lib/models/User.d.ts

@@ -27,6 +27,8 @@ export declare class User implements IUser {
     avatarUrl?: string;
     avatarIcon?: string;
     banner?: string;
+    /** Whether this account publishes what it orbits, on its public profile. */
+    showOrbits?: boolean;
     origin?: string;
     invites?: Array<IInvite>;
     iamProviders: Array<IIAMProviderLinked>;
@@ -67,6 +69,8 @@ export type IUser = IBaseUser & {
     avatarUrl?: string;
     avatarIcon?: string;
     banner?: string;
+    /** Whether this account publishes what it orbits, on its public profile. */
+    showOrbits?: boolean;
     origin?: string;
     invites?: Array<IInvite>;
     iamProviders: Array<IIAMProviderLinked>;

package/lib/models/User.js

@@ -43,6 +43,8 @@ export class User {
     avatarUrl;
     avatarIcon;
     banner;
+    /** Whether this account publishes what it orbits, on its public profile. */
+    showOrbits;
     origin;
     invites;
     iamProviders;
@@ -68,6 +70,7 @@ export class User {
         this.avatarUrl = u.avatar_url_s;
         this.avatarIcon = u.avatar_icon_s ?? u.avatarIcon;
         this.banner = u.banner_s ?? u.banner;
+        this.showOrbits = Boolean(u.show_orbits_b ?? u.showOrbits ?? false);
         this.origin = u.origin_s;
         this.joinDate = u.join_ts_dt ? new Date(u.join_ts_dt) : undefined;
         this.credits = u.credits_i ? Number(u.credits_i) : 0;

package/lib/models/UserDTO.js

@@ -60,6 +60,8 @@ export class UserDTO {
      * @returns Core user data with camelCase properties
      */
     toJSON() {
+        // avatarIcon and banner are optional: omit them when the API did not
+        // return them, as validateJSON rejects undefined property values.
         const obj = {
             id: this.id,
             uid: this.uid,
@@ -69,8 +71,8 @@ export class UserDTO {
             email: this.email,
             handle: this.handle,
             avatarUrl: this.avatarUrl,
-            avatarIcon: this.avatarIcon,
-            banner: this.banner,
+            ...(this.avatarIcon !== undefined ? { avatarIcon: this.avatarIcon } : {}),
+            ...(this.banner !== undefined ? { banner: this.banner } : {}),
         };
         validateJSON(obj, 'User');
         return obj;

package/lib/models/UserSettings.d.ts

@@ -1,16 +1,29 @@
 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 type IUserSettings = {
     aiAgentsUrl?: string;
     canInvite?: boolean;
+    /**
+     * Whether the documentation opens inside the application shell, keeping the
+     * navigation alongside it, rather than taking over the window.
+     *
+     * Undefined means the user has never chosen, which reads as `true`: opening
+     * in place is the default. Only a deliberate `false` takes the reader to the
+     * full-window documentation.
+     */
+    docsInPlace?: boolean;
 };
 export declare class UserSettings implements IUserSettings {
     private _aiAgentsUrl?;
     private _canInvite?;
+    private _docsInPlace?;
     constructor(s: any);
     get aiAgentsUrl(): string | undefined;
     set aiAgentsUrl(value: string | undefined);
     get canInvite(): boolean | undefined;
     set canInvite(value: boolean | undefined);
+    get docsInPlace(): boolean | undefined;
+    set docsInPlace(value: boolean | undefined);
 }
 export default UserSettings;

package/lib/models/UserSettings.js

@@ -4,12 +4,15 @@
  */
 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 class UserSettings {
     _aiAgentsUrl;
     _canInvite;
+    _docsInPlace;
     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;
     }
     get aiAgentsUrl() {
         return this._aiAgentsUrl;
@@ -23,5 +26,11 @@ export class UserSettings {
     set canInvite(value) {
         this._canInvite = value;
     }
+    get docsInPlace() {
+        return this._docsInPlace;
+    }
+    set docsInPlace(value) {
+        this._docsInPlace = value;
+    }
 }
 export default UserSettings;

package/lib/models/contents/__fixtures__/solr-codec.json

@@ -0,0 +1,57 @@
+{
+  "solr": {
+    "id": "internal-root",
+    "_version_": 42,
+    "uid": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+    "source_uid": "01BX5ZZKBKACTAV9WEVGEMMVRZ",
+    "type_s": "content_source",
+    "name_t": "Earth observations",
+    "code_s": "earth-observations",
+    "capabilities_ss": ["browse", "query"],
+    "rank_i": 7,
+    "ranks_is": [7, 8],
+    "completed_bytes_l": 12,
+    "part_sizes_ls": [5, 7],
+    "progress_f": 0.5,
+    "progress_samples_fs": [0.25, 0.5],
+    "ratio_d": 0.125,
+    "ratios_ds": [0.125, 0.25],
+    "is_public_b": false,
+    "checks_bs": [true, false],
+    "created_at_dt": "2026-08-24T12:00:00Z",
+    "observed_at_dts": ["2026-08-24T12:00:00Z", "2026-08-24T12:01:00Z"],
+    "notes_txt": "typed suffix coverage",
+    "description_t": null,
+    "grants": [{
+      "id": "internal-child",
+      "_root_": "internal-root",
+      "_nest_parent_": "internal-root",
+      "uid": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+      "principal_uid": "01BX5ZZKBKACTAV9WEVGEMMVRZ",
+      "access_level_s": "view"
+    }]
+  },
+  "python": {
+    "uid": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+    "source_uid": "01BX5ZZKBKACTAV9WEVGEMMVRZ",
+    "type": "content_source",
+    "name": "Earth observations",
+    "code": "earth-observations",
+    "capabilities": ["browse", "query"],
+    "rank": 7,
+    "ranks": [7, 8],
+    "completed_bytes": 12,
+    "part_sizes": [5, 7],
+    "progress": 0.5,
+    "progress_samples": [0.25, 0.5],
+    "ratio": 0.125,
+    "ratios": [0.125, 0.25],
+    "is_public": false,
+    "checks": [true, false],
+    "created_at": "2026-08-24T12:00:00Z",
+    "observed_at": ["2026-08-24T12:00:00Z", "2026-08-24T12:01:00Z"],
+    "notes": "typed suffix coverage",
+    "description": null,
+    "grants": [{"uid": "01ARZ3NDEKTSV4RRFFQ69G5FAV", "principal_uid": "01BX5ZZKBKACTAV9WEVGEMMVRZ", "access_level": "view"}]
+  }
+}

package/lib/models/contents/__fixtures__/v1-contracts.json

@@ -0,0 +1,194 @@
+{
+  "sources": [
+    {
+      "contract_version": "v1",
+      "uid": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+      "kind": "files",
+      "name": "User Folder",
+      "principal_uid": "01BX5ZZKBKACTAV9WEVGEMMVRZ",
+      "principal_kind": "user",
+      "configuration": {
+        "kind": "files",
+        "owning_user_uid": "01BX5ZZKBKACTAV9WEVGEMMVRZ",
+        "storage_backend_id": "users",
+        "quota_policy": "standard",
+        "versioning_policy": "retained"
+      },
+      "capabilities": ["browse", "transfer", "mount"],
+      "status": "ready",
+      "created_at": "2026-08-24T12:00:00Z",
+      "updated_at": "2026-08-24T12:00:00Z"
+    },
+    {
+      "contract_version": "v1",
+      "uid": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+      "kind": "dataset",
+      "name": "Dataset",
+      "principal_uid": "01BX5ZZKBKACTAV9WEVGEMMVRZ",
+      "principal_kind": "user",
+      "configuration": {
+        "kind": "dataset",
+        "tags": ["curated"],
+        "publication_eligible": true
+      },
+      "capabilities": ["browse", "materialize"],
+      "status": "ready",
+      "created_at": "2026-08-24T12:00:00Z",
+      "updated_at": "2026-08-24T12:00:00Z"
+    },
+    {
+      "contract_version": "v1",
+      "uid": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+      "kind": "volume",
+      "name": "Volume",
+      "principal_uid": "01BX5ZZKBKACTAV9WEVGEMMVRZ",
+      "principal_kind": "user",
+      "configuration": {
+        "kind": "volume",
+        "capacity_bytes": 1073741824,
+        "scope": "user",
+        "backing_resource_id": "pvc-1",
+        "default_mount_path": "/home/datalayer/data",
+        "access_modes": ["ro", "rw"],
+        "concurrent_readers": true,
+        "concurrent_writers": false
+      },
+      "capabilities": ["browse", "mount"],
+      "status": "ready",
+      "created_at": "2026-08-24T12:00:00Z",
+      "updated_at": "2026-08-24T12:00:00Z"
+    },
+    {
+      "contract_version": "v1",
+      "uid": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+      "kind": "cloud-storage",
+      "name": "S3",
+      "principal_uid": "01BX5ZZKBKACTAV9WEVGEMMVRZ",
+      "principal_kind": "user",
+      "configuration": {
+        "kind": "cloud-storage",
+        "provider": "s3",
+        "bucket_or_container": "research",
+        "prefix": "inputs/",
+        "region": "eu-west-1",
+        "access_preference": "automatic"
+      },
+      "capabilities": ["browse", "transfer"],
+      "status": "ready",
+      "created_at": "2026-08-24T12:00:00Z",
+      "updated_at": "2026-08-24T12:00:00Z"
+    },
+    {
+      "contract_version": "v1",
+      "uid": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+      "kind": "datasource",
+      "name": "Warehouse",
+      "principal_uid": "01BX5ZZKBKACTAV9WEVGEMMVRZ",
+      "principal_kind": "user",
+      "configuration": {
+        "kind": "datasource",
+        "connector_type": "sql",
+        "endpoint": "duckdb://",
+        "credential_uid": "01HZY7WQ8XKJ4M2N5P6R7S8T9V",
+        "database_or_project": "analytics",
+        "allowed_operations": ["select"],
+        "default_row_limit": 10000
+      },
+      "capabilities": ["query"],
+      "status": "ready",
+      "created_at": "2026-08-24T12:00:00Z",
+      "updated_at": "2026-08-24T12:00:00Z"
+    },
+    {
+      "contract_version": "v1",
+      "uid": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+      "kind": "data-server",
+      "name": "Private gateway",
+      "principal_uid": "01BX5ZZKBKACTAV9WEVGEMMVRZ",
+      "principal_kind": "organization",
+      "configuration": {
+        "kind": "data-server",
+        "registration_identity": "gateway-1",
+        "mtls_issuer": "datalayer-contents-ca",
+        "connectors": [
+          {
+            "connector_type": "sql",
+            "operations": ["select"],
+            "policy_version": "v1"
+          }
+        ],
+        "policy_version": "v1"
+      },
+      "capabilities": ["query"],
+      "status": "ready",
+      "created_at": "2026-08-24T12:00:00Z",
+      "updated_at": "2026-08-24T12:00:00Z"
+    },
+    {
+      "contract_version": "v1",
+      "uid": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+      "kind": "mcp",
+      "name": "Earthdata",
+      "principal_uid": "01BX5ZZKBKACTAV9WEVGEMMVRZ",
+      "principal_kind": "team",
+      "configuration": {
+        "kind": "mcp",
+        "transport": "streamable-http",
+        "endpoint": "https://example.test/mcp",
+        "allowed_tools": ["search_earthdata"],
+        "allowed_domains": ["earthdata.nasa.gov"],
+        "allowed_destinations": ["home-folder:///acquisitions/"],
+        "approval_policy": "explicit",
+        "destination_policy": "home-folder-only",
+        "max_result_bytes": 67108864
+      },
+      "capabilities": ["browse", "transfer"],
+      "status": "ready",
+      "created_at": "2026-08-24T12:00:00Z",
+      "updated_at": "2026-08-24T12:00:00Z"
+    },
+    {
+      "contract_version": "v1",
+      "uid": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+      "kind": "environment",
+      "name": "Environment content",
+      "principal_uid": "01BX5ZZKBKACTAV9WEVGEMMVRZ",
+      "principal_kind": "organization",
+      "configuration": {
+        "kind": "environment",
+        "environment_uid": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+        "build_uid": "01BX5ZZKBKACTAV9WEVGEMMVRZ",
+        "runtime_content_uids": [],
+        "resolved_provider_paths": {},
+        "build_entries": []
+      },
+      "capabilities": ["materialize"],
+      "status": "ready",
+      "created_at": "2026-08-24T12:00:00Z",
+      "updated_at": "2026-08-24T12:00:00Z"
+    }
+  ],
+  "attachment_manifest": {
+    "contract_version": "v1",
+    "sandbox_uid": "01BX5ZZKBKACTAV9WEVGEMMVRZ",
+    "sandbox_provider": "daytona",
+    "generated_at": "2026-08-24T12:00:00Z",
+    "attachments": [
+      {
+        "uid": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+        "source_uid": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
+        "sandbox_uid": "01BX5ZZKBKACTAV9WEVGEMMVRZ",
+        "sandbox_provider": "daytona",
+        "mode": "ro",
+        "mount_path": "/home/daytona/data",
+        "delivery": "materialize",
+        "required": true,
+        "capabilities": ["browse", "materialize"],
+        "status": "ready",
+        "limits": { "bytes": 1073741824 },
+        "created_at": "2026-08-24T12:00:00Z",
+        "cleanup_policy": "remove-materialization"
+      }
+    ]
+  }
+}

package/lib/models/contents/fieldCase.d.ts

@@ -0,0 +1,8 @@
+/** JSON values accepted at the Contents HTTP boundary. */
+export type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/** Recursively convert suffixless Python/API snake-case fields to camel case. */
+export declare const contentsToCamelCase: (value: JsonValue) => JsonValue;
+/** Recursively convert camel-case Contents client values to API snake case. */
+export declare const contentsToSnakeCase: (value: JsonValue) => JsonValue;