@letta-ai/letta-client 1.0.0-alpha.6 → 1.0.0

package/src/resources/batches/batches.ts

@@ -0,0 +1,286 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as AgentsAPI from '../agents/agents';
+import * as MessagesAPI from '../agents/messages';
+import * as BatchesMessagesAPI from './messages';
+import { MessageListParams, Messages } from './messages';
+import * as RunsAPI from '../runs/runs';
+import { APIPromise } from '../../core/api-promise';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Batches extends APIResource {
+  messages: BatchesMessagesAPI.Messages = new BatchesMessagesAPI.Messages(this._client);
+
+  /**
+   * Submit a batch of agent runs for asynchronous processing.
+   *
+   * Creates a job that will fan out messages to all listed agents and process them
+   * in parallel. The request will be rejected if it exceeds 256MB.
+   */
+  create(body: BatchCreateParams, options?: RequestOptions): APIPromise<BatchJob> {
+    return this._client.post('/v1/messages/batches', { body, ...options });
+  }
+
+  /**
+   * Retrieve the status and details of a batch run.
+   */
+  retrieve(batchID: string, options?: RequestOptions): APIPromise<BatchJob> {
+    return this._client.get(path`/v1/messages/batches/${batchID}`, options);
+  }
+
+  /**
+   * List all batch runs.
+   */
+  list(
+    query: BatchListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<BatchJobsArrayPage, BatchJob> {
+    return this._client.getAPIList('/v1/messages/batches', ArrayPage<BatchJob>, { query, ...options });
+  }
+
+  /**
+   * Cancel a batch run.
+   */
+  cancel(batchID: string, options?: RequestOptions): APIPromise<unknown> {
+    return this._client.patch(path`/v1/messages/batches/${batchID}/cancel`, options);
+  }
+}
+
+export type BatchJobsArrayPage = ArrayPage<BatchJob>;
+
+export interface BatchJob {
+  /**
+   * The human-friendly ID of the Job
+   */
+  id: string;
+
+  /**
+   * The agent associated with this job/run.
+   */
+  agent_id?: string | null;
+
+  /**
+   * Whether the job was created in background mode.
+   */
+  background?: boolean | null;
+
+  /**
+   * Optional error message from attempting to POST the callback endpoint.
+   */
+  callback_error?: string | null;
+
+  /**
+   * Timestamp when the callback was last attempted.
+   */
+  callback_sent_at?: string | null;
+
+  /**
+   * HTTP status code returned by the callback endpoint.
+   */
+  callback_status_code?: number | null;
+
+  /**
+   * If set, POST to this URL when the job completes.
+   */
+  callback_url?: string | null;
+
+  /**
+   * The unix timestamp of when the job was completed.
+   */
+  completed_at?: string | null;
+
+  /**
+   * The unix timestamp of when the job was created.
+   */
+  created_at?: string;
+
+  /**
+   * The id of the user that made this object.
+   */
+  created_by_id?: string | null;
+
+  job_type?: MessagesAPI.JobType;
+
+  /**
+   * The id of the user that made this object.
+   */
+  last_updated_by_id?: string | null;
+
+  /**
+   * The metadata of the job.
+   */
+  metadata?: { [key: string]: unknown } | null;
+
+  /**
+   * The status of the job.
+   */
+  status?: MessagesAPI.JobStatus;
+
+  /**
+   * The reason why the job was stopped.
+   */
+  stop_reason?: RunsAPI.StopReasonType | null;
+
+  /**
+   * Total run duration in nanoseconds
+   */
+  total_duration_ns?: number | null;
+
+  /**
+   * Time to first token for a run in nanoseconds
+   */
+  ttft_ns?: number | null;
+
+  /**
+   * The timestamp when the object was last updated.
+   */
+  updated_at?: string | null;
+}
+
+export type BatchCancelResponse = unknown;
+
+export interface BatchCreateParams {
+  /**
+   * List of requests to be processed in batch.
+   */
+  requests: Array<BatchCreateParams.Request>;
+
+  /**
+   * Optional URL to call via POST when the batch completes. The callback payload
+   * will be a JSON object with the following fields: {'job_id': string, 'status':
+   * string, 'completed_at': string}. Where 'job_id' is the unique batch job
+   * identifier, 'status' is the final batch status (e.g., 'completed', 'failed'),
+   * and 'completed_at' is an ISO 8601 timestamp indicating when the batch job
+   * completed.
+   */
+  callback_url?: string | null;
+}
+
+export namespace BatchCreateParams {
+  export interface Request {
+    /**
+     * The ID of the agent to send this batch request for
+     */
+    agent_id: string;
+
+    /**
+     * @deprecated The name of the message argument in the designated message tool.
+     * Still supported for legacy agent types, but deprecated for letta_v1_agent
+     * onward.
+     */
+    assistant_message_tool_kwarg?: string;
+
+    /**
+     * @deprecated The name of the designated message tool. Still supported for legacy
+     * agent types, but deprecated for letta_v1_agent onward.
+     */
+    assistant_message_tool_name?: string;
+
+    /**
+     * @deprecated If set to True, enables reasoning before responses or tool calls
+     * from the agent.
+     */
+    enable_thinking?: string;
+
+    /**
+     * Only return specified message types in the response. If `None` (default) returns
+     * all messages.
+     */
+    include_return_message_types?: Array<MessagesAPI.MessageType> | null;
+
+    /**
+     * Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+     * 'user', 'content': input}].
+     */
+    input?:
+      | string
+      | Array<
+          | MessagesAPI.TextContent
+          | MessagesAPI.ImageContent
+          | MessagesAPI.ToolCallContent
+          | MessagesAPI.ToolReturnContent
+          | MessagesAPI.ReasoningContent
+          | MessagesAPI.RedactedReasoningContent
+          | MessagesAPI.OmittedReasoningContent
+          | Request.SummarizedReasoningContent
+        >
+      | null;
+
+    /**
+     * Maximum number of steps the agent should take to process the request.
+     */
+    max_steps?: number;
+
+    /**
+     * The messages to be sent to the agent.
+     */
+    messages?: Array<AgentsAPI.MessageCreate | MessagesAPI.ApprovalCreate> | null;
+
+    /**
+     * @deprecated Whether the server should parse specific tool call arguments
+     * (default `send_message`) as `AssistantMessage` objects. Still supported for
+     * legacy agent types, but deprecated for letta_v1_agent onward.
+     */
+    use_assistant_message?: boolean;
+  }
+
+  export namespace Request {
+    /**
+     * The style of reasoning content returned by the OpenAI Responses API
+     */
+    export interface SummarizedReasoningContent {
+      /**
+       * The unique identifier for this reasoning step.
+       */
+      id: string;
+
+      /**
+       * Summaries of the reasoning content.
+       */
+      summary: Array<SummarizedReasoningContent.Summary>;
+
+      /**
+       * The encrypted reasoning content.
+       */
+      encrypted_content?: string;
+
+      /**
+       * Indicates this is a summarized reasoning step.
+       */
+      type?: 'summarized_reasoning';
+    }
+
+    export namespace SummarizedReasoningContent {
+      export interface Summary {
+        /**
+         * The index of the summary part.
+         */
+        index: number;
+
+        /**
+         * The text of the summary part.
+         */
+        text: string;
+      }
+    }
+  }
+}
+
+export interface BatchListParams extends ArrayPageParams {}
+
+Batches.Messages = Messages;
+
+export declare namespace Batches {
+  export {
+    type BatchJob as BatchJob,
+    type BatchCancelResponse as BatchCancelResponse,
+    type BatchJobsArrayPage as BatchJobsArrayPage,
+    type BatchCreateParams as BatchCreateParams,
+    type BatchListParams as BatchListParams,
+  };
+
+  export { Messages as Messages, type MessageListParams as MessageListParams };
+}

package/src/resources/batches/index.ts

@@ -0,0 +1,11 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Batches,
+  type BatchJob,
+  type BatchCancelResponse,
+  type BatchCreateParams,
+  type BatchListParams,
+  type BatchJobsArrayPage,
+} from './batches';
+export { Messages, type MessageListParams } from './messages';

package/src/resources/batches/messages.ts

@@ -0,0 +1,38 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as MessagesAPI from '../agents/messages';
+import { InternalMessagesObjectPage } from '../agents/messages';
+import { ObjectPage, type ObjectPageParams, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Messages extends APIResource {
+  /**
+   * Get response messages for a specific batch job.
+   */
+  list(
+    batchID: string,
+    query: MessageListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<InternalMessagesObjectPage, MessagesAPI.InternalMessage> {
+    return this._client.getAPIList(
+      path`/v1/messages/batches/${batchID}/messages`,
+      ObjectPage<MessagesAPI.InternalMessage>,
+      { query, ...options },
+    );
+  }
+}
+
+export interface MessageListParams extends ObjectPageParams {
+  /**
+   * Filter messages by agent ID
+   */
+  agent_id?: string | null;
+}
+
+export declare namespace Messages {
+  export { type MessageListParams as MessageListParams };
+}
+
+export { type InternalMessagesObjectPage };

package/src/resources/batches.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './batches/index';

package/src/resources/blocks/agents.ts

@@ -0,0 +1,55 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as AgentsAPI from '../agents/agents';
+import { AgentStatesArrayPage } from '../agents/agents';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Agents extends APIResource {
+  /**
+   * Retrieves all agents associated with the specified block. Raises a 404 if the
+   * block does not exist.
+   */
+  list(
+    blockID: string,
+    query: AgentListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<AgentStatesArrayPage, AgentsAPI.AgentState> {
+    return this._client.getAPIList(path`/v1/blocks/${blockID}/agents`, ArrayPage<AgentsAPI.AgentState>, {
+      query,
+      ...options,
+    });
+  }
+}
+
+export interface AgentListParams extends ArrayPageParams {
+  /**
+   * Specify which relational fields to include in the response. No relationships are
+   * included by default.
+   */
+  include?: Array<
+    | 'agent.blocks'
+    | 'agent.identities'
+    | 'agent.managed_group'
+    | 'agent.secrets'
+    | 'agent.sources'
+    | 'agent.tags'
+    | 'agent.tools'
+  >;
+
+  /**
+   * Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include
+   * in the response. If not provided, all relationships are loaded by default. Using
+   * this can optimize performance by reducing unnecessary joins.This is a legacy
+   * parameter, and no longer supported after 1.0.0 SDK versions.
+   */
+  include_relationships?: Array<string> | null;
+}
+
+export declare namespace Agents {
+  export { type AgentListParams as AgentListParams };
+}
+
+export { type AgentStatesArrayPage };