lemma-sdk 0.2.46 → 0.3.0

package/dist/namespaces/agents.js

@@ -2,13 +2,41 @@ import { AgentsService } from "../openapi_client/services/AgentsService.js";
 export class AgentsNamespace {
     client;
     podId;
-    constructor(client, podId) {
+    conversations;
+    constructor(client, podId, 
+    // Lazy accessor — conversations is constructed alongside agents on the client.
+    conversations) {
         this.client = client;
         this.podId = podId;
+        this.conversations = conversations;
     }
     list(options = {}) {
         return this.client.request(() => AgentsService.agentList(this.podId(), options.pageToken, options.limit ?? 100));
     }
+    /**
+     * Run an agent on a single message (the `.run` verb, alongside
+     * `functions.run` / `datastore.query`). Note the return contract differs:
+     * those return the result directly, whereas an agent reply is asynchronous —
+     * this opens a fresh conversation, sends `message`, and returns the created
+     * conversation (read the reply via `client.conversations.messages.list(conv.id)`).
+     * With `stream: true` it returns the SSE stream so you can consume tokens as
+     * they arrive.
+     */
+    async run(agentName, message, options = {}) {
+        if (!this.conversations) {
+            throw new Error("agents.run requires the conversations namespace — call it via client.agents.run().");
+        }
+        const conversations = this.conversations();
+        const conversation = await conversations.createForAgent(agentName, {
+            title: options.title,
+            metadata: options.metadata,
+        });
+        if (options.stream) {
+            return conversations.sendMessageStream(conversation.id, { content: message }, { signal: options.signal });
+        }
+        await conversations.messages.send(conversation.id, { content: message });
+        return conversation;
+    }
     create(payload) {
         return this.client.request(() => AgentsService.agentCreate(this.podId(), payload));
     }

package/dist/namespaces/conversations.d.ts

@@ -2,6 +2,7 @@ import type { HttpClient } from "../http.js";
 import type { ApprovalDecisionResponse } from "../openapi_client/models/ApprovalDecisionResponse.js";
 import type { AgentRuntimeConfig } from "../openapi_client/models/AgentRuntimeConfig.js";
 import type { ConversationListResponse } from "../openapi_client/models/ConversationListResponse.js";
+import type { ConversationType } from "../openapi_client/models/ConversationType.js";
 import type { CreateConversationRequest } from "../openapi_client/models/CreateConversationRequest.js";
 import type { HarnessKind } from "../openapi_client/models/HarnessKind.js";
 import type { ResolveUserApprovalRequest } from "../openapi_client/models/ResolveUserApprovalRequest.js";
@@ -44,6 +45,8 @@ export declare class ConversationsNamespace {
     list(options?: {
         agent_name?: string | null;
         pod_id?: string | null;
+        parent_id?: string | null;
+        type?: ConversationType | null;
         limit?: number;
         page_token?: string | null;
     }): Promise<ConversationListResponse>;

package/dist/namespaces/conversations.js

@@ -107,6 +107,8 @@ export class ConversationsNamespace {
         return this.http.request("GET", `/pods/${podId}/conversations`, {
             params: {
                 agent_name: options.agent_name,
+                parent_id: options.parent_id,
+                type: options.type,
                 limit: options.limit ?? 20,
                 page_token: options.page_token,
             },

package/dist/namespaces/desks.d.ts

@@ -16,6 +16,15 @@ export declare class DesksNamespace {
     get(name: string): Promise<import("../types.js").DeskDetailResponse>;
     update(name: string, payload: UpdateDeskRequest): Promise<import("../types.js").DeskDetailResponse>;
     delete(name: string): Promise<import("../types.js").DeskMessageResponse>;
+    /** Promote a conversation widget into a persisted desk (save as desk). */
+    createFromWidget(payload: {
+        conversation_id: string;
+        tool_call_id: string;
+        name: string;
+        public_slug?: string;
+        description?: string;
+        visibility?: string;
+    }): Promise<unknown>;
     readonly assets: {
         get: (name: string, path?: string) => Promise<string>;
     };

package/dist/namespaces/desks.js

@@ -23,6 +23,12 @@ export class DesksNamespace {
     delete(name) {
         return this.client.request(() => DesksService.deskDelete(this.podId(), name));
     }
+    /** Promote a conversation widget into a persisted desk (save as desk). */
+    createFromWidget(payload) {
+        return this.http.request("POST", `/pods/${this.podId()}/desks/from-widget`, {
+            body: payload,
+        });
+    }
     assets = {
         get: (name, path) => this.http.request("GET", `/pods/${this.podId()}/desks/${name}/assets${path ? `/${path.replace(/^\/+/, "")}` : ""}`),
     };

package/dist/namespaces/files.d.ts

@@ -3,6 +3,8 @@ import type { HttpClient } from "../http.js";
 import type { ConvertedFileResponse } from "../openapi_client/models/ConvertedFileResponse.js";
 import type { DirectoryTreeResponse } from "../openapi_client/models/DirectoryTreeResponse.js";
 import { FileSearchScopeMode } from "../openapi_client/models/FileSearchScopeMode.js";
+import type { FileSignedUrlResponse } from "../openapi_client/models/FileSignedUrlResponse.js";
+import type { FileUrlResponse } from "../openapi_client/models/FileUrlResponse.js";
 import { SearchMethod } from "../openapi_client/models/SearchMethod.js";
 type SearchMethodInput = SearchMethod | `${SearchMethod}`;
 type FileSearchScopeModeInput = FileSearchScopeMode | `${FileSearchScopeMode}`;
@@ -18,6 +20,22 @@ export declare class FilesNamespace {
         parentId?: string;
     }): Promise<import("../types.js").FileListResponse>;
     get(path: string): Promise<import("../types.js").FileDetailResponse>;
+    /**
+     * URLs for a file: a short-lived download `url` plus a permanent
+     * authenticated `app_url` deep-link that opens the file in the Lemma
+     * frontend (the viewer must be a signed-in pod member).
+     */
+    getUrl(path: string): Promise<FileUrlResponse>;
+    /**
+     * Mint a public, hit-capped short signed URL (no login needed to open).
+     * Expires after `expiresSeconds` (default 3h, max 24h) and serves the file
+     * at most `maxHits` times (default 50, max 100); both bounds are clamped
+     * server-side. Use it to share a file outside the pod without unbounded egress.
+     */
+    createSignedUrl(path: string, options?: {
+        expiresSeconds?: number;
+        maxHits?: number;
+    }): Promise<FileSignedUrlResponse>;
     delete(path: string): Promise<void>;
     search(query: string, options?: {
         limit?: number;

package/dist/namespaces/files.js

@@ -45,6 +45,27 @@ export class FilesNamespace {
     get(path) {
         return this.client.request(() => FilesService.fileGet(this.podId(), path));
     }
+    /**
+     * URLs for a file: a short-lived download `url` plus a permanent
+     * authenticated `app_url` deep-link that opens the file in the Lemma
+     * frontend (the viewer must be a signed-in pod member).
+     */
+    getUrl(path) {
+        return this.client.request(() => FilesService.fileUrl(this.podId(), path));
+    }
+    /**
+     * Mint a public, hit-capped short signed URL (no login needed to open).
+     * Expires after `expiresSeconds` (default 3h, max 24h) and serves the file
+     * at most `maxHits` times (default 50, max 100); both bounds are clamped
+     * server-side. Use it to share a file outside the pod without unbounded egress.
+     */
+    createSignedUrl(path, options = {}) {
+        const body = {
+            expires_seconds: options.expiresSeconds,
+            max_hits: options.maxHits,
+        };
+        return this.client.request(() => FilesService.fileSignedUrl(this.podId(), path, body));
+    }
     delete(path) {
         return this.client.request(() => FilesService.fileDelete(this.podId(), path));
     }

package/dist/namespaces/functions.d.ts

@@ -15,6 +15,9 @@ export declare class FunctionsNamespace {
     get(name: string): Promise<import("../types.js").FunctionDetailResponse>;
     update(name: string, payload: UpdateFunctionRequest): Promise<import("../types.js").FunctionActionResponse>;
     delete(name: string): Promise<import("../types.js").FunctionMessageResponse>;
+    /** Run a function — convenience alias for `functions.runs.create`, matching the
+     *  Python SDK's `functions.run(name, input)` and the unified `.run` verb. */
+    run(name: string, options?: RunFunctionOptions): Promise<import("../types.js").FunctionRunResponse>;
     readonly permissions: {
         get: (name: string) => Promise<import("../types.js").FunctionPermissionsResponse>;
         replace: (name: string, payload: FunctionPermissionsReplaceRequest) => Promise<import("../types.js").FunctionPermissionsResponse>;

package/dist/namespaces/functions.js

@@ -21,6 +21,11 @@ export class FunctionsNamespace {
     delete(name) {
         return this.client.request(() => FunctionsService.functionDelete(this.podId(), name));
     }
+    /** Run a function — convenience alias for `functions.runs.create`, matching the
+     *  Python SDK's `functions.run(name, input)` and the unified `.run` verb. */
+    run(name, options = {}) {
+        return this.runs.create(name, options);
+    }
     permissions = {
         get: (name) => this.client.request(() => FunctionsService.functionPermissionsGet(this.podId(), name)),
         replace: (name, payload) => this.client.request(() => FunctionsService.functionPermissionsReplace(this.podId(), name, payload)),

package/dist/namespaces/widgets.d.ts

@@ -0,0 +1,17 @@
+import type { HttpClient } from "../http.js";
+export declare class WidgetsNamespace {
+    private readonly http;
+    private readonly podId;
+    constructor(http: HttpClient, podId: () => string);
+    /**
+     * Mint a short-lived, signed embed URL for a conversation widget. The widget
+     * serve route is authenticated; this returns a URL the iframe can load even
+     * when the session cookie is not sent in a cross-site/embedded context.
+     */
+    embedUrl(payload: {
+        conversation_id: string;
+        tool_call_id: string;
+    }): Promise<{
+        url: string;
+    }>;
+}

package/dist/namespaces/widgets.js

@@ -0,0 +1,16 @@
+export class WidgetsNamespace {
+    http;
+    podId;
+    constructor(http, podId) {
+        this.http = http;
+        this.podId = podId;
+    }
+    /**
+     * Mint a short-lived, signed embed URL for a conversation widget. The widget
+     * serve route is authenticated; this returns a URL the iframe can load even
+     * when the session cookie is not sent in a cross-site/embedded context.
+     */
+    embedUrl(payload) {
+        return this.http.request("POST", `/pods/${this.podId()}/widgets/${payload.conversation_id}/${payload.tool_call_id}/embed-token`);
+    }
+}

package/dist/openapi_client/core/OpenAPI.js

@@ -1,6 +1,6 @@
 export const OpenAPI = {
     BASE: '',
-    VERSION: '1.0.0',
+    VERSION: '1.3.0',
     WITH_CREDENTIALS: false,
     CREDENTIALS: 'include',
     TOKEN: undefined,

package/dist/openapi_client/index.d.ts

@@ -22,6 +22,7 @@ export type { AgentPermissionsResponse } from './models/AgentPermissionsResponse
 export type { AgentResourcePermissionRequest } from './models/AgentResourcePermissionRequest.js';
 export type { AgentResourcePermissionResponse } from './models/AgentResourcePermissionResponse.js';
 export { AgentRunApprovalDecision } from './models/AgentRunApprovalDecision.js';
+export { AgentRunStatus } from './models/AgentRunStatus.js';
 export type { AgentRuntimeConfig } from './models/AgentRuntimeConfig.js';
 export type { AgentRuntimeProfileListResponse } from './models/AgentRuntimeProfileListResponse.js';
 export type { AgentRuntimeProfileResponse } from './models/AgentRuntimeProfileResponse.js';
@@ -108,6 +109,9 @@ export type { FileSearchRequest } from './models/FileSearchRequest.js';
 export type { FileSearchResponse } from './models/FileSearchResponse.js';
 export type { FileSearchResultSchema } from './models/FileSearchResultSchema.js';
 export { FileSearchScopeMode } from './models/FileSearchScopeMode.js';
+export type { FileSignedUrlRequest } from './models/FileSignedUrlRequest.js';
+export type { FileSignedUrlResponse } from './models/FileSignedUrlResponse.js';
+export type { FileUrlResponse } from './models/FileUrlResponse.js';
 export type { FlowDetailResponse } from './models/FlowDetailResponse.js';
 export { FlowRunStatus } from './models/FlowRunStatus.js';
 export type { ForeignKeySpec } from './models/ForeignKeySpec.js';

package/dist/openapi_client/index.js

@@ -6,6 +6,7 @@ export { ApiError } from './core/ApiError.js';
 export { CancelablePromise, CancelError } from './core/CancelablePromise.js';
 export { OpenAPI } from './core/OpenAPI.js';
 export { AgentRunApprovalDecision } from './models/AgentRunApprovalDecision.js';
+export { AgentRunStatus } from './models/AgentRunStatus.js';
 export { AgentSurfaceStatus } from './models/AgentSurfaceStatus.js';
 export { AgentToolset } from './models/AgentToolset.js';
 export { AuthProvider } from './models/AuthProvider.js';

package/dist/openapi_client/models/AgentRunStatus.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Internal lifecycle for one harness execution.
+ */
+export declare enum AgentRunStatus {
+    RUNNING = "RUNNING",
+    STOP_REQUESTED = "STOP_REQUESTED",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED",
+    STOPPED = "STOPPED"
+}

package/dist/openapi_client/models/AgentRunStatus.js

@@ -0,0 +1,15 @@
+/* generated using openapi-typescript-codegen -- do not edit */
+/* istanbul ignore file */
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Internal lifecycle for one harness execution.
+ */
+export var AgentRunStatus;
+(function (AgentRunStatus) {
+    AgentRunStatus["RUNNING"] = "RUNNING";
+    AgentRunStatus["STOP_REQUESTED"] = "STOP_REQUESTED";
+    AgentRunStatus["COMPLETED"] = "COMPLETED";
+    AgentRunStatus["FAILED"] = "FAILED";
+    AgentRunStatus["STOPPED"] = "STOPPED";
+})(AgentRunStatus || (AgentRunStatus = {}));

package/dist/openapi_client/models/AgentToolset.d.ts

@@ -2,12 +2,12 @@
  * Known tool bundles an agent may request.
  */
 export declare enum AgentToolset {
-    FILE_SYSTEM = "FILE_SYSTEM",
     WORKSPACE_CLI = "WORKSPACE_CLI",
     SKILLS = "SKILLS",
     WEB_SEARCH = "WEB_SEARCH",
     USER_INTERACTION = "USER_INTERACTION",
     IMAGE_GENERATION = "IMAGE_GENERATION",
     AUDIO_GENERATION = "AUDIO_GENERATION",
-    POD = "POD"
+    POD = "POD",
+    SUBAGENTS = "SUBAGENTS"
 }

package/dist/openapi_client/models/AgentToolset.js

@@ -7,7 +7,6 @@
  */
 export var AgentToolset;
 (function (AgentToolset) {
-    AgentToolset["FILE_SYSTEM"] = "FILE_SYSTEM";
     AgentToolset["WORKSPACE_CLI"] = "WORKSPACE_CLI";
     AgentToolset["SKILLS"] = "SKILLS";
     AgentToolset["WEB_SEARCH"] = "WEB_SEARCH";
@@ -15,4 +14,5 @@ export var AgentToolset;
     AgentToolset["IMAGE_GENERATION"] = "IMAGE_GENERATION";
     AgentToolset["AUDIO_GENERATION"] = "AUDIO_GENERATION";
     AgentToolset["POD"] = "POD";
+    AgentToolset["SUBAGENTS"] = "SUBAGENTS";
 })(AgentToolset || (AgentToolset = {}));

package/dist/openapi_client/models/ConversationResponse.d.ts

@@ -1,3 +1,4 @@
+import type { AgentRunStatus } from './AgentRunStatus.js';
 import type { AgentRuntimeConfig } from './AgentRuntimeConfig.js';
 import type { ConversationStatus } from './ConversationStatus.js';
 import type { ConversationType } from './ConversationType.js';
@@ -7,6 +8,9 @@ export type ConversationResponse = {
     created_at: string;
     id: string;
     instructions?: (string | null);
+    last_run_error?: (string | null);
+    last_run_finished_at?: (string | null);
+    last_run_status?: (AgentRunStatus | null);
     metadata?: (Record<string, any> | null);
     organization_id?: (string | null);
     output?: null;

package/dist/openapi_client/models/ConversationType.d.ts

@@ -3,5 +3,6 @@
  */
 export declare enum ConversationType {
     CHAT = "CHAT",
-    TASK = "TASK"
+    TASK = "TASK",
+    PROJECT = "PROJECT"
 }

package/dist/openapi_client/models/ConversationType.js

@@ -9,4 +9,5 @@ export var ConversationType;
 (function (ConversationType) {
     ConversationType["CHAT"] = "CHAT";
     ConversationType["TASK"] = "TASK";
+    ConversationType["PROJECT"] = "PROJECT";
 })(ConversationType || (ConversationType = {}));

package/dist/openapi_client/models/DatastoreQueryRequest.d.ts

@@ -3,7 +3,7 @@
  */
 export type DatastoreQueryRequest = {
     /**
-     * Read-only SQL query executed inside this datastore schema. Only SELECT-style queries are allowed; mutating statements are blocked. Queries against RLS-enabled tables are rejected; use table-scoped record APIs instead. Write queries such as INSERT, UPDATE, DELETE, ALTER, DROP, CREATE, and TRUNCATE are rejected. Example: `SELECT id, amount FROM expenses WHERE amount > 100 ORDER BY created_at DESC LIMIT 20`.
+     * Read-only SQL query executed inside this datastore schema. A single SELECT statement only; mutating statements (INSERT, UPDATE, DELETE, ALTER, DROP, CREATE, TRUNCATE, ...) and cross-schema references are rejected. Joins, aggregates, and subqueries across tables are allowed, including RLS-enabled tables — rows of an RLS table are scoped to the caller unless they administer it. Example: `SELECT id, amount FROM expenses WHERE amount > 100 ORDER BY created_at DESC LIMIT 20`.
      */
     query: string;
 };

package/dist/openapi_client/models/FileSearchResultSchema.d.ts

@@ -3,6 +3,8 @@ export type FileSearchResultSchema = {
     content: string;
     file_id: string;
     metadata?: (Record<string, any> | null);
+    page_end?: (number | null);
+    page_number?: (number | null);
     path: string;
     score: number;
 };

package/dist/openapi_client/models/FileSignedUrlRequest.d.ts

@@ -0,0 +1,4 @@
+export type FileSignedUrlRequest = {
+    expires_seconds?: (number | null);
+    max_hits?: (number | null);
+};

package/dist/openapi_client/models/FileSignedUrlRequest.js

@@ -0,0 +1 @@
+export {};

package/dist/openapi_client/models/FileSignedUrlResponse.d.ts

@@ -0,0 +1,6 @@
+export type FileSignedUrlResponse = {
+    expires_at: string;
+    max_hits: number;
+    path: string;
+    signed_url: string;
+};

package/dist/openapi_client/models/FileSignedUrlResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/openapi_client/models/FileUrlResponse.d.ts

@@ -0,0 +1,6 @@
+export type FileUrlResponse = {
+    app_url: string;
+    expires_at: string;
+    path: string;
+    url: string;
+};

package/dist/openapi_client/models/FileUrlResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/openapi_client/services/AgentConversationsService.d.ts

@@ -13,17 +13,18 @@ import type { CancelablePromise } from '../core/CancelablePromise.js';
 export declare class AgentConversationsService {
     /**
      * List Pod Agent Conversations
-     * List root conversations for the current user in a pod. Use agent_name to list conversations for a specific pod agent; omit it to list default pod assistant conversations. Child conversations are omitted from this root list.
+     * List root conversations for the current user in a pod. Use agent_name to list conversations for a specific pod agent; omit it to list default pod assistant conversations. Child (sub-agent) conversations are omitted by default; pass parent_id to list the children of a specific conversation instead.
      * @param podId
      * @param agentName
      * @param status
      * @param type
+     * @param parentId
      * @param pageToken
      * @param limit
      * @returns ConversationListResponse Successful Response
      * @throws ApiError
      */
-    static agentConversationList(podId: string, agentName?: (string | null), status?: (ConversationStatus | null), type?: (ConversationType | null), pageToken?: (string | null), limit?: number): CancelablePromise<ConversationListResponse>;
+    static agentConversationList(podId: string, agentName?: (string | null), status?: (ConversationStatus | null), type?: (ConversationType | null), parentId?: (string | null), pageToken?: (string | null), limit?: number): CancelablePromise<ConversationListResponse>;
     /**
      * Create Pod Agent Conversation
      * Create a new pod-scoped conversation. When agent_name is omitted, the conversation uses the default pod assistant. Workflow and sub-agent executions also use conversations as their external execution handle.

package/dist/openapi_client/services/AgentConversationsService.js

@@ -3,17 +3,18 @@ import { request as __request } from '../core/request.js';
 export class AgentConversationsService {
     /**
      * List Pod Agent Conversations
-     * List root conversations for the current user in a pod. Use agent_name to list conversations for a specific pod agent; omit it to list default pod assistant conversations. Child conversations are omitted from this root list.
+     * List root conversations for the current user in a pod. Use agent_name to list conversations for a specific pod agent; omit it to list default pod assistant conversations. Child (sub-agent) conversations are omitted by default; pass parent_id to list the children of a specific conversation instead.
      * @param podId
      * @param agentName
      * @param status
      * @param type
+     * @param parentId
      * @param pageToken
      * @param limit
      * @returns ConversationListResponse Successful Response
      * @throws ApiError
      */
-    static agentConversationList(podId, agentName, status, type, pageToken, limit = 20) {
+    static agentConversationList(podId, agentName, status, type, parentId, pageToken, limit = 20) {
         return __request(OpenAPI, {
             method: 'GET',
             url: '/pods/{pod_id}/conversations',
@@ -24,6 +25,7 @@ export class AgentConversationsService {
                 'agent_name': agentName,
                 'status': status,
                 'type': type,
+                'parent_id': parentId,
                 'page_token': pageToken,
                 'limit': limit,
             },

package/dist/openapi_client/services/FilesService.d.ts

@@ -6,6 +6,9 @@ import type { FileDetailResponse } from '../models/FileDetailResponse.js';
 import type { FileListResponse } from '../models/FileListResponse.js';
 import type { FileSearchRequest } from '../models/FileSearchRequest.js';
 import type { FileSearchResponse } from '../models/FileSearchResponse.js';
+import type { FileSignedUrlRequest } from '../models/FileSignedUrlRequest.js';
+import type { FileSignedUrlResponse } from '../models/FileSignedUrlResponse.js';
+import type { FileUrlResponse } from '../models/FileUrlResponse.js';
 import type { update } from '../models/update.js';
 import type { CancelablePromise } from '../core/CancelablePromise.js';
 export declare class FilesService {
@@ -109,6 +112,15 @@ export declare class FilesService {
      * @throws ApiError
      */
     static fileSearch(podId: string, requestBody: FileSearchRequest): CancelablePromise<FileSearchResponse>;
+    /**
+     * Create a public, hit-capped signed URL for a file
+     * @param podId
+     * @param path
+     * @param requestBody
+     * @returns FileSignedUrlResponse Successful Response
+     * @throws ApiError
+     */
+    static fileSignedUrl(podId: string, path: string, requestBody?: (FileSignedUrlRequest | null)): CancelablePromise<FileSignedUrlResponse>;
     /**
      * Get Directory Tree
      * @param podId
@@ -118,4 +130,12 @@ export declare class FilesService {
      * @throws ApiError
      */
     static fileTree(podId: string, rootPath?: string, filesPerDirectory?: number): CancelablePromise<DirectoryTreeResponse>;
+    /**
+     * Get a short-lived URL for a file
+     * @param podId
+     * @param path
+     * @returns FileUrlResponse Successful Response
+     * @throws ApiError
+     */
+    static fileUrl(podId: string, path: string): CancelablePromise<FileUrlResponse>;
 }

package/dist/openapi_client/services/FilesService.js

@@ -269,6 +269,31 @@ export class FilesService {
             },
         });
     }
+    /**
+     * Create a public, hit-capped signed URL for a file
+     * @param podId
+     * @param path
+     * @param requestBody
+     * @returns FileSignedUrlResponse Successful Response
+     * @throws ApiError
+     */
+    static fileSignedUrl(podId, path, requestBody) {
+        return __request(OpenAPI, {
+            method: 'POST',
+            url: '/pods/{pod_id}/datastore/files/signed-url',
+            path: {
+                'pod_id': podId,
+            },
+            query: {
+                'path': path,
+            },
+            body: requestBody,
+            mediaType: 'application/json',
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
     /**
      * Get Directory Tree
      * @param podId
@@ -293,4 +318,26 @@ export class FilesService {
             },
         });
     }
+    /**
+     * Get a short-lived URL for a file
+     * @param podId
+     * @param path
+     * @returns FileUrlResponse Successful Response
+     * @throws ApiError
+     */
+    static fileUrl(podId, path) {
+        return __request(OpenAPI, {
+            method: 'GET',
+            url: '/pods/{pod_id}/datastore/files/url',
+            path: {
+                'pod_id': podId,
+            },
+            query: {
+                'path': path,
+            },
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
 }

package/dist/openapi_client/services/QueryService.d.ts

@@ -4,7 +4,7 @@ import type { CancelablePromise } from '../core/CancelablePromise.js';
 export declare class QueryService {
     /**
      * Execute Query
-     * Execute a read-only SQL query inside the datastore schema. Joins, aggregates, subqueries, and cross-table reads are allowed as long as the statement is read only.
+     * Execute a read-only SQL query inside the datastore schema. Joins, aggregates, subqueries, and cross-table reads are allowed, including across RLS-enabled tables — rows of RLS tables are scoped to the caller (table admins see all rows). Only a single read-only statement is permitted; mutating statements and cross-schema references are rejected.
      * @param podId
      * @param requestBody
      * @returns DatastoreQueryResponse Successful Response

package/dist/openapi_client/services/QueryService.js

@@ -3,7 +3,7 @@ import { request as __request } from '../core/request.js';
 export class QueryService {
     /**
      * Execute Query
-     * Execute a read-only SQL query inside the datastore schema. Joins, aggregates, subqueries, and cross-table reads are allowed as long as the statement is read only.
+     * Execute a read-only SQL query inside the datastore schema. Joins, aggregates, subqueries, and cross-table reads are allowed, including across RLS-enabled tables — rows of RLS tables are scoped to the caller (table admins see all rows). Only a single read-only statement is permitted; mutating statements and cross-schema references are rejected.
      * @param podId
      * @param requestBody
      * @returns DatastoreQueryResponse Successful Response

package/dist/run-utils.d.ts

@@ -12,4 +12,28 @@ export declare function isTerminalFlowStatus(status: unknown, options?: {
 }): boolean;
 export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
 export declare function nextBackoffDelay(attempt: number, options?: BackoffOptions): number;
+/**
+ * Statuses worth retrying with backoff. Deliberately conservative: 429 is an
+ * explicit "back off", and 502/503/504 are gateway errors where the request
+ * usually never reached the handler — so retrying is safe even for writes.
+ * 500 is excluded (it may indicate a partial side effect).
+ */
+export declare const RETRYABLE_STATUS: ReadonlySet<number>;
+/** Parse a server `Retry-After` header (delta-seconds or HTTP-date) into ms,
+ *  capped at 30s. Returns null when the header is absent or unparseable. */
+export declare function serverRetryAfterMs(retryAfter: string | null | undefined): number | null;
+/** Resolve a backoff delay, honoring a server `Retry-After` header when present. */
+export declare function retryAfterMs(retryAfter: string | null | undefined, attempt: number): number;
+/** Equal jitter: keep half the delay fixed and randomize the other half, so the
+ *  result lands in `[delay/2, delay]`. Spreads correlated retries (thundering
+ *  herd) without ever waiting longer than the computed backoff. */
+export declare function applyJitter(delayMs: number, random?: () => number): number;
+/**
+ * Single source of truth for the retry decision shared by the hand-written
+ * `HttpClient` and the generated-client adapter. Returns the number of ms to
+ * wait before retrying, or `null` when the status is non-retryable or retries
+ * are exhausted. A server-advised `Retry-After` is honored verbatim (no jitter);
+ * the computed exponential backoff gets equal jitter.
+ */
+export declare function retryDelayForStatus(status: number, attempt: number, maxRetries: number, retryAfterHeader: string | null | undefined, random?: () => number): number | null;
 export {};