casedev 0.22.1 → 0.23.0

package/src/resources/agent/v1/run.ts

@@ -7,6 +7,9 @@ import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
 
+/**
+ * Create, manage, and execute AI agents with tool access, sandbox environments, and async run workflows
+ */
 export class Run extends APIResource {
   /**
    * Creates a run in queued state. Call POST /agent/v1/run/:id/exec to start
@@ -16,6 +19,14 @@ export class Run extends APIResource {
     return this._client.post('/agent/v1/run', { body, ...options });
   }
 
+  /**
+   * Lists agent runs for the authenticated organization. Supports filtering by
+   * agent, status, and cursor-based pagination.
+   */
+  list(query: RunListParams | null | undefined = {}, options?: RequestOptions): APIPromise<RunListResponse> {
+    return this._client.get('/agent/v1/run', { query, ...options });
+  }
+
   /**
    * Cancels a running or queued run. Idempotent — cancelling a finished run returns
    * its current status.
@@ -85,6 +96,40 @@ export interface RunCreateResponse {
   status?: 'queued';
 }
 
+export interface RunListResponse {
+  hasMore?: boolean;
+
+  /**
+   * Pass as cursor to fetch the next page
+   */
+  nextCursor?: string | null;
+
+  runs?: Array<RunListResponse.Run>;
+}
+
+export namespace RunListResponse {
+  export interface Run {
+    id?: string;
+
+    agentId?: string;
+
+    completedAt?: string | null;
+
+    createdAt?: string;
+
+    model?: string | null;
+
+    /**
+     * Truncated to first 200 characters
+     */
+    prompt?: string;
+
+    startedAt?: string | null;
+
+    status?: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+  }
+}
+
 export interface RunCancelResponse {
   id?: string;
 
@@ -311,6 +356,13 @@ export interface RunCreateParams {
    */
   prompt: string;
 
+  /**
+   * HTTPS callback URL to receive a notification when the run completes. Registered
+   * atomically with the run — eliminates the race condition of calling /watch after
+   * /exec. Additional watchers can still be added via POST /run/:id/watch.
+   */
+  callbackUrl?: string | null;
+
   /**
    * Additional guidance for this run
    */
@@ -328,6 +380,29 @@ export interface RunCreateParams {
   objectIds?: Array<string> | null;
 }
 
+export interface RunListParams {
+  /**
+   * Filter by agent ID
+   */
+  agentId?: string;
+
+  /**
+   * Pagination cursor (run ID from previous page). Returns runs created before this
+   * run.
+   */
+  cursor?: string;
+
+  /**
+   * Maximum number of runs to return (default 50, max 250)
+   */
+  limit?: number;
+
+  /**
+   * Filter by run status
+   */
+  status?: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+}
+
 export interface RunEventsParams {
   /**
    * Replay events after this sequence number
@@ -345,6 +420,7 @@ export interface RunWatchParams {
 export declare namespace Run {
   export {
     type RunCreateResponse as RunCreateResponse,
+    type RunListResponse as RunListResponse,
     type RunCancelResponse as RunCancelResponse,
     type RunEventsResponse as RunEventsResponse,
     type RunExecResponse as RunExecResponse,
@@ -352,6 +428,7 @@ export declare namespace Run {
     type RunGetStatusResponse as RunGetStatusResponse,
     type RunWatchResponse as RunWatchResponse,
     type RunCreateParams as RunCreateParams,
+    type RunListParams as RunListParams,
     type RunEventsParams as RunEventsParams,
     type RunWatchParams as RunWatchParams,
   };

package/src/resources/agent/v1/v1.ts

@@ -6,6 +6,7 @@ import {
   AgentCreateParams,
   AgentCreateResponse,
   AgentDeleteResponse,
+  AgentListParams,
   AgentListResponse,
   AgentRetrieveResponse,
   AgentUpdateParams,
@@ -25,8 +26,6 @@ import {
   ChatSendMessageParams,
   ChatStreamParams,
   ChatStreamResponse,
-  ChatUiStreamParams,
-  ChatUiStreamResponse,
 } from './chat';
 import * as ExecuteAPI from './execute';
 import { Execute, ExecuteCreateParams, ExecuteCreateResponse } from './execute';
@@ -41,6 +40,8 @@ import {
   RunExecResponse,
   RunGetDetailsResponse,
   RunGetStatusResponse,
+  RunListParams,
+  RunListResponse,
   RunWatchParams,
   RunWatchResponse,
 } from './run';
@@ -67,11 +68,13 @@ export declare namespace V1 {
     type AgentDeleteResponse as AgentDeleteResponse,
     type AgentCreateParams as AgentCreateParams,
     type AgentUpdateParams as AgentUpdateParams,
+    type AgentListParams as AgentListParams,
   };
 
   export {
     Run as Run,
     type RunCreateResponse as RunCreateResponse,
+    type RunListResponse as RunListResponse,
     type RunCancelResponse as RunCancelResponse,
     type RunEventsResponse as RunEventsResponse,
     type RunExecResponse as RunExecResponse,
@@ -79,6 +82,7 @@ export declare namespace V1 {
     type RunGetStatusResponse as RunGetStatusResponse,
     type RunWatchResponse as RunWatchResponse,
     type RunCreateParams as RunCreateParams,
+    type RunListParams as RunListParams,
     type RunEventsParams as RunEventsParams,
     type RunWatchParams as RunWatchParams,
   };
@@ -96,12 +100,10 @@ export declare namespace V1 {
     type ChatCancelResponse as ChatCancelResponse,
     type ChatRespondResponse as ChatRespondResponse,
     type ChatStreamResponse as ChatStreamResponse,
-    type ChatUiStreamResponse as ChatUiStreamResponse,
     type ChatCreateParams as ChatCreateParams,
     type ChatReplyToQuestionParams as ChatReplyToQuestionParams,
     type ChatRespondParams as ChatRespondParams,
     type ChatSendMessageParams as ChatSendMessageParams,
     type ChatStreamParams as ChatStreamParams,
-    type ChatUiStreamParams as ChatUiStreamParams,
   };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.22.1'; // x-release-please-version
+export const VERSION = '0.23.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.22.1";
+export declare const VERSION = "0.23.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.22.1";
+export declare const VERSION = "0.23.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.22.1'; // x-release-please-version
+exports.VERSION = '0.23.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.22.1'; // x-release-please-version
+export const VERSION = '0.23.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map