casedev 0.69.0 → 0.70.0

package/src/resources/matters/v1/purges.ts

@@ -0,0 +1,66 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+/**
+ * Matter-native legal workspaces and orchestration primitives
+ */
+export class Purges extends APIResource {
+  /**
+   * Returns a Matter purge receipt for manual diagnostics. Integrations should
+   * subscribe to Matter purge webhooks rather than polling this route.
+   */
+  retrieve(purgeID: string, options?: RequestOptions): APIPromise<PurgeRetrieveResponse> {
+    return this._client.get(path`/matters/v1/purges/${purgeID}`, options);
+  }
+}
+
+export interface PurgeRetrieveResponse {
+  attempt: number;
+
+  matter_id: string;
+
+  purge_id: string;
+
+  status: 'queued' | 'in_progress' | 'failed' | 'completed';
+
+  vault_id: string;
+
+  workflow_id: string | null;
+
+  completed_at?: string | null;
+
+  counts?: PurgeRetrieveResponse.Counts;
+
+  failed_at?: string | null;
+
+  failure_code?: string | null;
+
+  requested_at?: string;
+
+  started_at?: string | null;
+
+  /**
+   * Stable ID of the failed or completed terminal webhook event
+   */
+  terminal_event_id?: string | null;
+}
+
+export namespace PurgeRetrieveResponse {
+  export interface Counts {
+    chats?: number;
+
+    objects?: number;
+
+    sessions?: number;
+
+    transcriptions?: number;
+  }
+}
+
+export declare namespace Purges {
+  export { type PurgeRetrieveResponse as PurgeRetrieveResponse };
+}

package/src/resources/matters/v1/v1.ts

@@ -3,12 +3,21 @@
 import { APIResource } from '../../../core/resource';
 import * as AgentTypesAPI from './agent-types';
 import { AgentTypeCreateParams, AgentTypeListParams, AgentTypes } from './agent-types';
+import * as ContentPurgesAPI from './content-purges';
+import {
+  ContentPurgeCreateParams,
+  ContentPurgeCreateResponse,
+  ContentPurgeRetrieveResponse,
+  ContentPurges,
+} from './content-purges';
 import * as LogAPI from './log';
 import { Log, LogCreateParams, LogExportParams, LogExportResponse, LogListParams } from './log';
 import * as MatterPartiesAPI from './matter-parties';
 import { MatterParties, MatterPartyCreateParams } from './matter-parties';
 import * as PartiesAPI from './parties';
-import { Parties, PartyCreateParams, PartyListParams } from './parties';
+import { Parties, PartyCreateParams, PartyListParams, PartyListResponse } from './parties';
+import * as PurgesAPI from './purges';
+import { PurgeRetrieveResponse, Purges } from './purges';
 import * as SharesAPI from './shares';
 import { ShareCreateParams, ShareDeleteParams, Shares } from './shares';
 import * as TypesAPI from './types';
@@ -18,6 +27,7 @@ import {
   WorkItemCreateParams,
   WorkItemDecideParams,
   WorkItemListParams,
+  WorkItemListResponse,
   WorkItemRetrieveParams,
   WorkItemUpdateParams,
   WorkItems,
@@ -33,6 +43,8 @@ import { path } from '../../../internal/utils/path';
  * Matter-native legal workspaces and orchestration primitives
  */
 export class V1 extends APIResource {
+  purges: PurgesAPI.Purges = new PurgesAPI.Purges(this._client);
+  contentPurges: ContentPurgesAPI.ContentPurges = new ContentPurgesAPI.ContentPurges(this._client);
   agentTypes: AgentTypesAPI.AgentTypes = new AgentTypesAPI.AgentTypes(this._client);
   parties: PartiesAPI.Parties = new PartiesAPI.Parties(this._client);
   types: TypesAPI.Types = new TypesAPI.Types(this._client);
@@ -75,14 +87,84 @@ export class V1 extends APIResource {
   }
 
   /**
-   * List matters for the authenticated organization.
+   * List matters for the authenticated organization, newest update first. Pagination
+   * is opt-in: pass `limit` (1-200) to receive a bounded page, then replay
+   * `pagination.next_cursor` as `?cursor=` while `pagination.has_more` is true.
+   * Cursors are opaque and are only valid for the exact filter set they were issued
+   * under. A request with neither `limit` nor `cursor` still returns every matter,
+   * and `pagination.limit` is null. That default will become a bounded page in a
+   * future release — paginate now to avoid the change.
    */
-  list(query: V1ListParams | null | undefined = {}, options?: RequestOptions): APIPromise<void> {
-    return this._client.get('/matters/v1', {
-      query,
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
+  list(query: V1ListParams | null | undefined = {}, options?: RequestOptions): APIPromise<V1ListResponse> {
+    return this._client.get('/matters/v1', { query, ...options });
+  }
+
+  /**
+   * Queues a durable, idempotent purge of a Matter and all linked live content. Use
+   * matter purge webhooks for status changes; the inspection route is intended for
+   * manual diagnostics only.
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<V1DeleteResponse> {
+    return this._client.delete(path`/matters/v1/${id}`, options);
+  }
+}
+
+export interface V1ListResponse {
+  data?: Array<unknown>;
+
+  pagination?: V1ListResponse.Pagination;
+}
+
+export namespace V1ListResponse {
+  export interface Pagination {
+    has_more?: boolean;
+
+    limit?: number | null;
+
+    next_cursor?: string | null;
+  }
+}
+
+export interface V1DeleteResponse {
+  attempt: number;
+
+  matter_id: string;
+
+  purge_id: string;
+
+  status: 'queued' | 'in_progress' | 'failed' | 'completed';
+
+  vault_id: string;
+
+  workflow_id: string | null;
+
+  completed_at?: string | null;
+
+  counts?: V1DeleteResponse.Counts;
+
+  failed_at?: string | null;
+
+  failure_code?: string | null;
+
+  requested_at?: string;
+
+  started_at?: string | null;
+
+  /**
+   * Stable ID of the failed or completed terminal webhook event
+   */
+  terminal_event_id?: string | null;
+}
+
+export namespace V1DeleteResponse {
+  export interface Counts {
+    chats?: number;
+
+    objects?: number;
+
+    sessions?: number;
+
+    transcriptions?: number;
   }
 }
 
@@ -126,8 +208,6 @@ export namespace V1CreateParams {
   export interface Vault {
     description?: string;
 
-    enableGraph?: boolean;
-
     enableIndexing?: boolean;
 
     metadata?: { [key: string]: unknown };
@@ -169,6 +249,18 @@ export interface V1UpdateParams {
 }
 
 export interface V1ListParams {
+  /**
+   * Opaque continuation cursor from `pagination.next_cursor` of the previous page.
+   * Must be replayed with the same filters that produced it.
+   */
+  cursor?: string;
+
+  /**
+   * Matters per page (1-200). Omit to receive every matter. Supplying a cursor
+   * without a limit uses 50.
+   */
+  limit?: number;
+
   matter_type?: string;
 
   practice_area?: string;
@@ -178,6 +270,8 @@ export interface V1ListParams {
   status?: string;
 }
 
+V1.Purges = Purges;
+V1.ContentPurges = ContentPurges;
 V1.AgentTypes = AgentTypes;
 V1.Parties = Parties;
 V1.Types = Types;
@@ -189,11 +283,22 @@ V1.WorkItems = WorkItems;
 
 export declare namespace V1 {
   export {
+    type V1ListResponse as V1ListResponse,
+    type V1DeleteResponse as V1DeleteResponse,
     type V1CreateParams as V1CreateParams,
     type V1UpdateParams as V1UpdateParams,
     type V1ListParams as V1ListParams,
   };
 
+  export { Purges as Purges, type PurgeRetrieveResponse as PurgeRetrieveResponse };
+
+  export {
+    ContentPurges as ContentPurges,
+    type ContentPurgeCreateResponse as ContentPurgeCreateResponse,
+    type ContentPurgeRetrieveResponse as ContentPurgeRetrieveResponse,
+    type ContentPurgeCreateParams as ContentPurgeCreateParams,
+  };
+
   export {
     AgentTypes as AgentTypes,
     type AgentTypeCreateParams as AgentTypeCreateParams,
@@ -202,6 +307,7 @@ export declare namespace V1 {
 
   export {
     Parties as Parties,
+    type PartyListResponse as PartyListResponse,
     type PartyCreateParams as PartyCreateParams,
     type PartyListParams as PartyListParams,
   };
@@ -233,6 +339,7 @@ export declare namespace V1 {
 
   export {
     WorkItems as WorkItems,
+    type WorkItemListResponse as WorkItemListResponse,
     type WorkItemCreateParams as WorkItemCreateParams,
     type WorkItemRetrieveParams as WorkItemRetrieveParams,
     type WorkItemUpdateParams as WorkItemUpdateParams,

package/src/resources/matters/v1/work-items.ts

@@ -45,18 +45,19 @@ export class WorkItems extends APIResource {
   }
 
   /**
-   * List active work items for a matter.
+   * List active work items for a matter, newest update first. Pagination is opt-in:
+   * pass `limit` (1-200) to receive a bounded page, then replay
+   * `pagination.next_cursor` as `?cursor=` while `pagination.has_more` is true. A
+   * request with neither `limit` nor `cursor` still returns every work item, and
+   * `pagination.limit` is null. That default will become a bounded page in a future
+   * release — paginate now to avoid the change.
    */
   list(
     id: string,
     query: WorkItemListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<void> {
-    return this._client.get(path`/matters/v1/${id}/work-items`, {
-      query,
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
+  ): APIPromise<WorkItemListResponse> {
+    return this._client.get(path`/matters/v1/${id}/work-items`, { query, ...options });
   }
 
   /**
@@ -72,6 +73,22 @@ export class WorkItems extends APIResource {
   }
 }
 
+export interface WorkItemListResponse {
+  data?: Array<unknown>;
+
+  pagination?: WorkItemListResponse.Pagination;
+}
+
+export namespace WorkItemListResponse {
+  export interface Pagination {
+    has_more?: boolean;
+
+    limit?: number | null;
+
+    next_cursor?: string | null;
+  }
+}
+
 export interface WorkItemCreateParams {
   title: string;
 
@@ -192,6 +209,18 @@ export interface WorkItemUpdateParams {
 export interface WorkItemListParams {
   assignee_id?: string;
 
+  /**
+   * Opaque continuation cursor from `pagination.next_cursor` of the previous page.
+   * Must be replayed with the same filters that produced it.
+   */
+  cursor?: string;
+
+  /**
+   * Work items per page (1-200). Omit to receive every work item. Supplying a cursor
+   * without a limit uses 50.
+   */
+  limit?: number;
+
   status?: string;
 }
 
@@ -219,6 +248,7 @@ export interface WorkItemDecideParams {
 
 export declare namespace WorkItems {
   export {
+    type WorkItemListResponse as WorkItemListResponse,
     type WorkItemCreateParams as WorkItemCreateParams,
     type WorkItemRetrieveParams as WorkItemRetrieveParams,
     type WorkItemUpdateParams as WorkItemUpdateParams,

package/src/resources/skills/index.ts

@@ -8,11 +8,13 @@ export {
   type SkillCreateResponse,
   type SkillUpdateResponse,
   type SkillDeleteResponse,
+  type SkillCatalogResponse,
   type SkillExportResponse,
   type SkillReadResponse,
   type SkillResolveResponse,
   type SkillCreateParams,
   type SkillUpdateParams,
+  type SkillCatalogParams,
   type SkillExportParams,
   type SkillResolveParams,
 } from './skills';

package/src/resources/skills/skills.ts

@@ -37,6 +37,17 @@ export class Skills extends APIResource {
     return this._client.delete(path`/skills/${slug}`, options);
   }
 
+  /**
+   * Browse public and organization skills using one authenticated catalog. Returns
+   * metadata only; skill content is loaded separately.
+   */
+  catalog(
+    query: SkillCatalogParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<SkillCatalogResponse> {
+    return this._client.get('/skills/catalog', { query, ...options });
+  }
+
   /**
    * Export a skill as an installable filesystem tree for sandbox runtimes.
    * Authenticated org-scoped custom skills are resolved before curated skills.
@@ -74,6 +85,11 @@ export interface ReadResponseFileBundle {
   root_slug: string;
 
   content_type?: string | null;
+
+  /**
+   * Encoding of the returned content field.
+   */
+  encoding?: 'utf8' | 'base64';
 }
 
 export interface ReadResponseRootBundle {
@@ -90,6 +106,11 @@ export namespace ReadResponseRootBundle {
 
     content_type?: string | null;
 
+    /**
+     * Encoding used by content when this companion slug is read.
+     */
+    encoding?: 'utf8' | 'base64';
+
     name?: string | null;
   }
 }
@@ -140,6 +161,38 @@ export interface SkillDeleteResponse {
   slug?: string;
 }
 
+export interface SkillCatalogResponse {
+  count?: number;
+
+  hasMore?: boolean;
+
+  limit?: number;
+
+  nextOffset?: number | null;
+
+  offset?: number;
+
+  query?: string;
+
+  skills?: Array<SkillCatalogResponse.Skill>;
+
+  total?: number;
+}
+
+export namespace SkillCatalogResponse {
+  export interface Skill {
+    description?: string;
+
+    name?: string;
+
+    slug?: string;
+
+    source?: 'custom' | 'curated';
+
+    tags?: Array<string>;
+  }
+}
+
 export interface SkillExportResponse {
   files?: Array<SkillExportResponse.File>;
 
@@ -158,6 +211,11 @@ export namespace SkillExportResponse {
 
     content_type?: string;
 
+    /**
+     * Encoding of content. Binary files use canonical base64.
+     */
+    encoding?: 'utf8' | 'base64';
+
     path?: string;
 
     sha256?: string;
@@ -279,7 +337,8 @@ export interface SkillCreateParams {
 
   /**
    * Optional bundled companion files installed alongside the skill as <slug>/<path>
-   * in sandbox skill directories.
+   * in sandbox skill directories. The complete file set may contain at most 12 MiB
+   * of decoded content.
    */
   files?: Array<SkillCreateParams.File>;
 
@@ -306,6 +365,10 @@ export interface SkillCreateParams {
 
 export namespace SkillCreateParams {
   export interface File {
+    /**
+     * UTF-8 text when encoding is utf8 (max 65,536 characters), or canonical base64
+     * when encoding is base64 (max 262,144 decoded bytes).
+     */
     content: string;
 
     /**
@@ -316,6 +379,11 @@ export namespace SkillCreateParams {
 
     contentType?: string;
 
+    /**
+     * How content is encoded. Omit for UTF-8 text files.
+     */
+    encoding?: 'utf8' | 'base64';
+
     metadata?: unknown;
 
     name?: string;
@@ -330,8 +398,13 @@ export interface SkillUpdateParams {
   content?: string;
 
   /**
-   * Optional replacement companion file tree. Omit to leave existing bundled files
-   * unchanged; send [] to remove bundled files.
+   * Reject with 409 if the skill changed since this version was read.
+   */
+  expectedVersion?: number;
+
+  /**
+   * Optional replacement companion file tree, limited to 12 MiB of decoded content.
+   * Omit to leave existing bundled files unchanged; send [] to remove bundled files.
    */
   files?: Array<SkillUpdateParams.File> | null;
 
@@ -351,12 +424,21 @@ export interface SkillUpdateParams {
 
 export namespace SkillUpdateParams {
   export interface File {
+    /**
+     * UTF-8 text when encoding is utf8 (max 65,536 characters), or canonical base64
+     * when encoding is base64 (max 262,144 decoded bytes).
+     */
     content: string;
 
     path: string;
 
     contentType?: string;
 
+    /**
+     * How content is encoded. Omit for UTF-8 text files.
+     */
+    encoding?: 'utf8' | 'base64';
+
     metadata?: unknown;
 
     name?: string;
@@ -367,6 +449,34 @@ export namespace SkillUpdateParams {
   }
 }
 
+export interface SkillCatalogParams {
+  /**
+   * Maximum results to return
+   */
+  limit?: number;
+
+  /**
+   * Number of results to skip
+   */
+  offset?: number;
+
+  /**
+   * Optional text search
+   */
+  q?: string;
+
+  /**
+   * Optional source filter, applied after organization overrides and before
+   * pagination. Omit to browse both sources.
+   */
+  source?: 'custom' | 'curated';
+
+  /**
+   * Optional tag filter
+   */
+  tag?: string;
+}
+
 export interface SkillExportParams {
   /**
    * Agent runtime skill directory convention to export for. Most callers should omit
@@ -396,11 +506,13 @@ export declare namespace Skills {
     type SkillCreateResponse as SkillCreateResponse,
     type SkillUpdateResponse as SkillUpdateResponse,
     type SkillDeleteResponse as SkillDeleteResponse,
+    type SkillCatalogResponse as SkillCatalogResponse,
     type SkillExportResponse as SkillExportResponse,
     type SkillReadResponse as SkillReadResponse,
     type SkillResolveResponse as SkillResolveResponse,
     type SkillCreateParams as SkillCreateParams,
     type SkillUpdateParams as SkillUpdateParams,
+    type SkillCatalogParams as SkillCatalogParams,
     type SkillExportParams as SkillExportParams,
     type SkillResolveParams as SkillResolveParams,
   };

package/src/resources/vault/events/subscriptions.ts

@@ -21,11 +21,15 @@ export class Subscriptions extends APIResource {
    * });
    * ```
    */
-  create(id: string, body: SubscriptionCreateParams, options?: RequestOptions): APIPromise<void> {
+  create(id: string, params: SubscriptionCreateParams, options?: RequestOptions): APIPromise<void> {
+    const { 'Idempotency-Key': idempotencyKey, ...body } = params;
     return this._client.post(path`/vault/${id}/events/subscriptions`, {
       body,
       ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+      headers: buildHeaders([
+        { Accept: '*/*', ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+        options?.headers,
+      ]),
     });
   }
 
@@ -116,25 +120,32 @@ export class Subscriptions extends APIResource {
 
 export interface SubscriptionCreateParams {
   /**
-   * Webhook endpoint URL that will receive vault event deliveries
+   * Body param: Webhook endpoint URL that will receive vault event deliveries
    */
   callbackUrl: string;
 
   /**
-   * Vault event types to deliver. Omit to receive the default supported set.
+   * Body param: Vault event types to deliver. Omit to receive the default supported
+   * set.
    */
   eventTypes?: Array<string>;
 
   /**
-   * Vault object IDs to limit notifications to. Omit to receive events for all
-   * objects in the vault.
+   * Body param: Vault object IDs to limit notifications to. Omit to receive events
+   * for all objects in the vault.
    */
   objectIds?: Array<string>;
 
   /**
-   * Optional secret used to sign outbound webhook deliveries
+   * Body param: Optional secret used to sign outbound webhook deliveries
    */
   signingSecret?: string;
+
+  /**
+   * Header param: Reusing a key for this Vault updates and returns the same webhook
+   * subscription.
+   */
+  'Idempotency-Key'?: string;
 }
 
 export interface SubscriptionUpdateParams {

package/src/resources/vault/groups.ts

@@ -7,7 +7,7 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 /**
- * Secure document storage with semantic search and GraphRAG
+ * Secure document storage with semantic search
  */
 export class Groups extends APIResource {
   /**

package/src/resources/vault/index.ts

@@ -14,6 +14,7 @@ export {
 } from './memory';
 export {
   Multipart,
+  type MultipartCompleteResponse,
   type MultipartGetPartURLsResponse,
   type MultipartInitResponse,
   type MultipartAbortParams,
@@ -34,6 +35,7 @@ export {
   type ObjectGetPagesResponse,
   type ObjectGetTextResponse,
   type ObjectMergeResponse,
+  type ObjectMoveResponse,
   type ObjectRetrieveParams,
   type ObjectUpdateParams,
   type ObjectListParams,
@@ -46,6 +48,7 @@ export {
   type ObjectGetPagesParams,
   type ObjectGetTextParams,
   type ObjectMergeParams,
+  type ObjectMoveParams,
 } from './objects';
 export {
   Vault,
@@ -60,6 +63,7 @@ export {
   type VaultUploadResponse,
   type VaultCreateParams,
   type VaultUpdateParams,
+  type VaultListParams,
   type VaultDeleteParams,
   type VaultConfirmUploadParams,
   type VaultIngestParams,