casedev 0.69.0 → 0.70.0

package/src/resources/linc/v1/sessions.ts

@@ -15,19 +15,37 @@ export class Sessions extends APIResource {
    * This endpoint starts the sandbox actor only; messages and event replay use
    * separate endpoints.
    */
-  create(body: SessionCreateParams | null | undefined = {}, options?: RequestOptions): APIPromise<void> {
+  create(params: SessionCreateParams | null | undefined = {}, options?: RequestOptions): APIPromise<void> {
+    const {
+      'ai-reporting-tags': aiReportingTags,
+      'ai-reporting-user': aiReportingUser,
+      ...body
+    } = params ?? {};
     return this._client.post('/linc/v1/sessions', {
       body,
       ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(aiReportingTags != null ? { 'ai-reporting-tags': aiReportingTags } : undefined),
+          ...(aiReportingUser != null ? { 'ai-reporting-user': aiReportingUser } : undefined),
+        },
+        options?.headers,
+      ]),
     });
   }
 
   /**
    * End native Linc session
    */
-  delete(id: string, options?: RequestOptions): APIPromise<void> {
+  delete(
+    id: string,
+    params: SessionDeleteParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { reason } = params ?? {};
     return this._client.delete(path`/linc/v1/sessions/${id}`, {
+      query: { reason },
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -63,6 +81,19 @@ export class Sessions extends APIResource {
     });
   }
 
+  /**
+   * Stops the conversation worker, applies a newly authorized object scope, revokes
+   * its prior managed credential, and resumes the same native conversation in its
+   * existing workspace.
+   */
+  replaceScope(id: string, body: SessionReplaceScopeParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.put(path`/linc/v1/sessions/${id}/scope`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
   /**
    * Returns persisted native Pi/Linc event envelopes after the requested cursor.
    * Live delivery is handled by the Linc stream service.
@@ -122,46 +153,119 @@ export class Sessions extends APIResource {
 
 export interface SessionCreateParams {
   /**
-   * Specific document template slugs to inject into the using-document-templates
-   * skill.
+   * Body param: Optional server-enforced capability profile. read_only grants only
+   * retrieval/inference service reads; session event ingestion remains bound to the
+   * exact managed runtime credential.
+   */
+  capabilityPolicy?: 'read_only';
+
+  /**
+   * Body param: Stable conversation identity within workspaceKey. Required in
+   * workspace mode and idempotent for repeated creates.
+   */
+  conversationKey?: string;
+
+  /**
+   * Body param: Specific document template slugs to inject into the
+   * using-document-templates skill.
    */
   documentTemplateSlugs?: Array<string> | null;
 
+  /**
+   * Body param
+   */
   idleTimeoutMs?: number | null;
 
   /**
-   * When true, inject all active org document templates into the
+   * Body param: When true, inject all active org document templates into the
    * using-document-templates skill.
    */
   includeDocumentTemplates?: boolean | null;
 
   /**
-   * Privileged C3-only hidden app instructions to append to the sandbox AGENTS.md.
+   * Body param: Privileged C3-only hidden app instructions to append to the sandbox
+   * AGENTS.md.
    */
   instructions?: string | null;
 
+  /**
+   * Body param
+   */
   model?: string | null;
 
   /**
-   * Optional caller-provided scoped Case.dev API key for the runtime.
+   * Body param: Optional caller-provided scoped Case.dev API key for the runtime.
    */
   scopedApiKey?: string | null;
 
   /**
-   * Processing tier for eligible OpenAI GPT models. Priority provides lower latency
-   * at premium cost.
+   * Body param: Processing tier for eligible OpenAI GPT models. Priority provides
+   * lower latency at premium cost.
    */
   serviceTier?: 'default' | 'priority';
 
   /**
-   * Skills API slugs to install into the runtime sandbox before the native session
-   * starts.
+   * Body param: Skills API slugs to install into the runtime sandbox before the
+   * native session starts.
    */
   skillSlugs?: Array<string> | null;
 
+  /**
+   * Body param
+   */
   title?: string;
 
+  /**
+   * Body param: Legacy explicit whole-vault scope. Mutually exclusive with
+   * vaultScopes.
+   */
   vaultIds?: Array<string> | null;
+
+  /**
+   * Body param: Exact object allowlist per vault. Empty objectIds denies object
+   * access for that vault. Mutually exclusive with vaultIds.
+   */
+  vaultScopes?: Array<SessionCreateParams.VaultScope> | null;
+
+  /**
+   * Body param: Opt-in persistent workspace identity. Requires conversationKey. Omit
+   * both fields to preserve isolated legacy session behavior.
+   */
+  workspaceKey?: string;
+
+  /**
+   * Header param: Comma-separated AI Gateway reporting tags. At most 10 unique tags,
+   * each 1–64 characters.
+   */
+  'ai-reporting-tags'?: string;
+
+  /**
+   * Header param: Stable internal user or customer identifier for AI Gateway cost
+   * reporting.
+   */
+  'ai-reporting-user'?: string;
+}
+
+export namespace SessionCreateParams {
+  export interface VaultScope {
+    objectIds: Array<string>;
+
+    vaultId: string;
+  }
+}
+
+export interface SessionDeleteParams {
+  /**
+   * Why the session is being ended; recorded in the linc.session.ended event
+   * payload. Unknown values fall back to user*deleted. The replaced*\* values
+   * distinguish automatic session replacement (e.g. by C3) from a user-initiated
+   * deletion.
+   */
+  reason?:
+    | 'user_deleted'
+    | 'replaced_scope_changed'
+    | 'replaced_missing_session'
+    | 'replaced_runtime_unavailable';
 }
 
 export interface SessionCancelParams {
@@ -204,6 +308,26 @@ export namespace SessionIngestEventsParams {
   }
 }
 
+export interface SessionReplaceScopeParams {
+  /**
+   * Legacy whole-vault scope. Mutually exclusive with vaultScopes.
+   */
+  vaultIds?: Array<string>;
+
+  /**
+   * Authoritative object allowlist for the next and later turns.
+   */
+  vaultScopes?: Array<SessionReplaceScopeParams.VaultScope>;
+}
+
+export namespace SessionReplaceScopeParams {
+  export interface VaultScope {
+    objectIds: Array<string>;
+
+    vaultId: string;
+  }
+}
+
 export interface SessionRetrieveEventsParams {
   /**
    * Alias for cursor. Ignored when cursor is also provided.
@@ -261,8 +385,10 @@ export interface SessionSendRpcParams {
 export declare namespace Sessions {
   export {
     type SessionCreateParams as SessionCreateParams,
+    type SessionDeleteParams as SessionDeleteParams,
     type SessionCancelParams as SessionCancelParams,
     type SessionIngestEventsParams as SessionIngestEventsParams,
+    type SessionReplaceScopeParams as SessionReplaceScopeParams,
     type SessionRetrieveEventsParams as SessionRetrieveEventsParams,
     type SessionRetrieveMessagesParams as SessionRetrieveMessagesParams,
     type SessionSendRpcParams as SessionSendRpcParams,

package/src/resources/linc/v1/v1.ts

@@ -5,7 +5,9 @@ import * as SessionsAPI from './sessions';
 import {
   SessionCancelParams,
   SessionCreateParams,
+  SessionDeleteParams,
   SessionIngestEventsParams,
+  SessionReplaceScopeParams,
   SessionRetrieveEventsParams,
   SessionRetrieveMessagesParams,
   SessionSendRpcParams,
@@ -22,8 +24,10 @@ export declare namespace V1 {
   export {
     Sessions as Sessions,
     type SessionCreateParams as SessionCreateParams,
+    type SessionDeleteParams as SessionDeleteParams,
     type SessionCancelParams as SessionCancelParams,
     type SessionIngestEventsParams as SessionIngestEventsParams,
+    type SessionReplaceScopeParams as SessionReplaceScopeParams,
     type SessionRetrieveEventsParams as SessionRetrieveEventsParams,
     type SessionRetrieveMessagesParams as SessionRetrieveMessagesParams,
     type SessionSendRpcParams as SessionSendRpcParams,

package/src/resources/llm/v1/chat.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../../../core/resource';
 import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 
 /**
@@ -22,10 +23,21 @@ export class Chat extends APIResource {
    * ```
    */
   createCompletion(
-    body: ChatCreateCompletionParams,
+    params: ChatCreateCompletionParams,
     options?: RequestOptions,
   ): APIPromise<ChatCreateCompletionResponse> {
-    return this._client.post('/llm/v1/chat/completions', { body, ...options });
+    const { 'ai-reporting-tags': aiReportingTags, 'ai-reporting-user': aiReportingUser, ...body } = params;
+    return this._client.post('/llm/v1/chat/completions', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(aiReportingTags != null ? { 'ai-reporting-tags': aiReportingTags } : undefined),
+          ...(aiReportingUser != null ? { 'ai-reporting-user': aiReportingUser } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
   }
 }
 
@@ -85,51 +97,64 @@ export namespace ChatCreateCompletionResponse {
 
 export interface ChatCreateCompletionParams {
   /**
-   * List of messages comprising the conversation
+   * Body param: List of messages comprising the conversation
    */
   messages: Array<ChatCreateCompletionParams.Message>;
 
   /**
-   * CaseMark-only: controls whether reasoning fields appear in responses. Defaults
-   * to false (suppressed) for most CaseMark models; defaults to true for
-   * casemark/core-potassium.
+   * Body param: CaseMark-only: controls whether reasoning fields appear in
+   * responses. Defaults to false (suppressed) for most CaseMark models; defaults to
+   * true for casemark/core-potassium.
    */
   casemark_show_reasoning?: boolean;
 
   /**
-   * Frequency penalty parameter
+   * Body param: Frequency penalty parameter
    */
   frequency_penalty?: number;
 
   /**
-   * Maximum number of tokens to generate
+   * Body param: Maximum number of tokens to generate
    */
   max_tokens?: number;
 
   /**
-   * Model to use for completion. Defaults to casemark/core-large if not specified
+   * Body param: Model to use for completion. Defaults to casemark/core-large if not
+   * specified
    */
   model?: string;
 
   /**
-   * Presence penalty parameter
+   * Body param: Presence penalty parameter
    */
   presence_penalty?: number;
 
   /**
-   * Whether to stream back partial progress
+   * Body param: Whether to stream back partial progress
    */
   stream?: boolean;
 
   /**
-   * Sampling temperature between 0 and 2
+   * Body param: Sampling temperature between 0 and 2
    */
   temperature?: number;
 
   /**
-   * Nucleus sampling parameter
+   * Body param: Nucleus sampling parameter
    */
   top_p?: number;
+
+  /**
+   * Header param: Comma-separated AI Gateway reporting tags. At most 10 unique tags,
+   * each 1–64 characters.
+   */
+  'ai-reporting-tags'?: string;
+
+  /**
+   * Header param: Stable internal user or customer identifier for AI Gateway cost
+   * reporting.
+   */
+  'ai-reporting-user'?: string;
 }
 
 export namespace ChatCreateCompletionParams {

package/src/resources/llm/v1/v1.ts

@@ -33,9 +33,9 @@ export class V1 extends APIResource {
   }
 
   /**
-   * Retrieve a list of all available language models from 40+ providers including
-   * OpenAI, Anthropic, Google, and Case.dev's specialized legal models. Returns
-   * OpenAI-compatible model metadata with pricing information.
+   * Retrieve the curated list of available models: OpenAI and Google models plus
+   * Case.dev's specialized CaseMark legal models. Returns OpenAI-compatible model
+   * metadata with pricing information.
    *
    * This endpoint is compatible with OpenAI's models API format, making it easy to
    * integrate with existing applications.

package/src/resources/matters/index.ts

@@ -1,4 +1,11 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export { Matters } from './matters';
-export { V1, type V1CreateParams, type V1UpdateParams, type V1ListParams } from './v1/index';
+export {
+  V1,
+  type V1ListResponse,
+  type V1DeleteResponse,
+  type V1CreateParams,
+  type V1UpdateParams,
+  type V1ListParams,
+} from './v1/index';

package/src/resources/matters/matters.ts

@@ -2,7 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import * as V1API from './v1/v1';
-import { V1, V1CreateParams, V1ListParams, V1UpdateParams } from './v1/v1';
+import { V1, V1CreateParams, V1DeleteResponse, V1ListParams, V1ListResponse, V1UpdateParams } from './v1/v1';
 
 export class Matters extends APIResource {
   v1: V1API.V1 = new V1API.V1(this._client);
@@ -13,6 +13,8 @@ Matters.V1 = V1;
 export declare namespace Matters {
   export {
     V1 as V1,
+    type V1ListResponse as V1ListResponse,
+    type V1DeleteResponse as V1DeleteResponse,
     type V1CreateParams as V1CreateParams,
     type V1UpdateParams as V1UpdateParams,
     type V1ListParams as V1ListParams,

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

@@ -0,0 +1,115 @@
+// 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 ContentPurges extends APIResource {
+  /**
+   * Queues an idempotent hard deletion of explicitly owned content while preserving
+   * the Matter, Vault, and unrelated content. Use unified matter.content_purge
+   * webhooks for completion, not polling.
+   */
+  create(
+    id: string,
+    body: ContentPurgeCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<ContentPurgeCreateResponse> {
+    return this._client.post(path`/matters/v1/${id}/content-purges`, { body, ...options });
+  }
+
+  /**
+   * Owner-only receipt for operator diagnostics. Integrations must use unified
+   * content-purge webhooks rather than polling.
+   */
+  retrieve(purgeID: string, options?: RequestOptions): APIPromise<ContentPurgeRetrieveResponse> {
+    return this._client.get(path`/matters/v1/content-purges/${purgeID}`, options);
+  }
+}
+
+export interface ContentPurgeCreateResponse {
+  attempt: number;
+
+  matter_id: string;
+
+  purge_id: string;
+
+  request_id: string;
+
+  status: 'queued' | 'in_progress' | 'failed' | 'completed';
+
+  vault_id: string;
+
+  workflow_id: string | null;
+
+  completed_at?: string | null;
+
+  counts?: { [key: string]: number };
+
+  failed_at?: string | null;
+
+  failure_code?: string | null;
+
+  requested_at?: string;
+
+  started_at?: string | null;
+
+  terminal_event_id?: string | null;
+}
+
+export interface ContentPurgeRetrieveResponse {
+  attempt: number;
+
+  matter_id: string;
+
+  purge_id: string;
+
+  request_id: string;
+
+  status: 'queued' | 'in_progress' | 'failed' | 'completed';
+
+  vault_id: string;
+
+  workflow_id: string | null;
+
+  completed_at?: string | null;
+
+  counts?: { [key: string]: number };
+
+  failed_at?: string | null;
+
+  failure_code?: string | null;
+
+  requested_at?: string;
+
+  started_at?: string | null;
+
+  terminal_event_id?: string | null;
+}
+
+export interface ContentPurgeCreateParams {
+  /**
+   * Stable caller idempotency ID; cannot be reused with different targets.
+   */
+  request_id: string;
+
+  object_ids?: Array<string>;
+
+  session_ids?: Array<string>;
+
+  transcription_ids?: Array<string>;
+
+  work_item_ids?: Array<string>;
+}
+
+export declare namespace ContentPurges {
+  export {
+    type ContentPurgeCreateResponse as ContentPurgeCreateResponse,
+    type ContentPurgeRetrieveResponse as ContentPurgeRetrieveResponse,
+    type ContentPurgeCreateParams as ContentPurgeCreateParams,
+  };
+}

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

@@ -13,11 +13,15 @@ export class Subscriptions extends APIResource {
   /**
    * Creates a webhook subscription for matter and work-item events.
    */
-  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`/matters/v1/${id}/events/subscriptions`, {
       body,
       ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+      headers: buildHeaders([
+        { Accept: '*/*', ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+        options?.headers,
+      ]),
     });
   }
 
@@ -48,11 +52,26 @@ export class Subscriptions extends APIResource {
 }
 
 export interface SubscriptionCreateParams {
+  /**
+   * Body param
+   */
   callbackUrl: string;
 
+  /**
+   * Body param
+   */
   eventTypes?: Array<string>;
 
+  /**
+   * Body param
+   */
   signingSecret?: string;
+
+  /**
+   * Header param: Reusing a key for this Matter updates and returns the same webhook
+   * subscription.
+   */
+  'Idempotency-Key'?: string;
 }
 
 export interface SubscriptionDeleteParams {

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

@@ -1,6 +1,12 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export { AgentTypes, type AgentTypeCreateParams, type AgentTypeListParams } from './agent-types';
+export {
+  ContentPurges,
+  type ContentPurgeCreateResponse,
+  type ContentPurgeRetrieveResponse,
+  type ContentPurgeCreateParams,
+} from './content-purges';
 export { Events } from './events/index';
 export {
   Log,
@@ -10,12 +16,21 @@ export {
   type LogExportParams,
 } from './log';
 export { MatterParties, type MatterPartyCreateParams } from './matter-parties';
-export { Parties, type PartyCreateParams, type PartyListParams } from './parties';
+export { Parties, type PartyListResponse, type PartyCreateParams, type PartyListParams } from './parties';
+export { Purges, type PurgeRetrieveResponse } from './purges';
 export { Shares, type ShareCreateParams, type ShareDeleteParams } from './shares';
 export { Types, type TypeCreateParams, type TypeUpdateParams, type TypeListParams } from './types';
-export { V1, type V1CreateParams, type V1UpdateParams, type V1ListParams } from './v1';
+export {
+  V1,
+  type V1ListResponse,
+  type V1DeleteResponse,
+  type V1CreateParams,
+  type V1UpdateParams,
+  type V1ListParams,
+} from './v1';
 export {
   WorkItems,
+  type WorkItemListResponse,
   type WorkItemCreateParams,
   type WorkItemRetrieveParams,
   type WorkItemUpdateParams,

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

@@ -42,14 +42,34 @@ export class Parties extends APIResource {
   }
 
   /**
-   * List reusable legal parties for the authenticated organization.
+   * List reusable legal parties 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. A request with neither `limit` nor `cursor` still returns every party,
+   * and `pagination.limit` is null. That default will become a bounded page in a
+   * future release — paginate now to avoid the change.
    */
-  list(query: PartyListParams | null | undefined = {}, options?: RequestOptions): APIPromise<void> {
-    return this._client.get('/matters/v1/parties', {
-      query,
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
+  list(
+    query: PartyListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<PartyListResponse> {
+    return this._client.get('/matters/v1/parties', { query, ...options });
+  }
+}
+
+export interface PartyListResponse {
+  data?: Array<unknown>;
+
+  pagination?: PartyListResponse.Pagination;
+}
+
+export namespace PartyListResponse {
+  export interface Pagination {
+    has_more?: boolean;
+
+    limit?: number | null;
+
+    next_cursor?: string | null;
   }
 }
 
@@ -72,13 +92,29 @@ export interface PartyCreateParams {
 }
 
 export interface PartyListParams {
+  /**
+   * Opaque continuation cursor from `pagination.next_cursor` of the previous page.
+   * Must be replayed with the same filters that produced it.
+   */
+  cursor?: string;
+
   email?: string;
 
+  /**
+   * Parties per page (1-200). Omit to receive every party. Supplying a cursor
+   * without a limit uses 50.
+   */
+  limit?: number;
+
   query?: string;
 
   type?: 'person' | 'organization';
 }
 
 export declare namespace Parties {
-  export { type PartyCreateParams as PartyCreateParams, type PartyListParams as PartyListParams };
+  export {
+    type PartyListResponse as PartyListResponse,
+    type PartyCreateParams as PartyCreateParams,
+    type PartyListParams as PartyListParams,
+  };
 }