casedev 0.67.2 → 0.69.0

package/src/resources/{mail/mail.ts → linc/linc.ts}

@@ -4,12 +4,12 @@ import { APIResource } from '../../core/resource';
 import * as V1API from './v1/v1';
 import { V1 } from './v1/v1';
 
-export class Mail extends APIResource {
+export class Linc extends APIResource {
   v1: V1API.V1 = new V1API.V1(this._client);
 }
 
-Mail.V1 = V1;
+Linc.V1 = V1;
 
-export declare namespace Mail {
+export declare namespace Linc {
   export { V1 as V1 };
 }

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

@@ -0,0 +1,12 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Sessions,
+  type SessionCreateParams,
+  type SessionCancelParams,
+  type SessionIngestEventsParams,
+  type SessionRetrieveEventsParams,
+  type SessionRetrieveMessagesParams,
+  type SessionSendRpcParams,
+} from './sessions';
+export { V1 } from './v1';

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

@@ -0,0 +1,270 @@
+// 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 { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+/**
+ * Durable, stateful legal agent sessions with sandboxed tools and files
+ */
+export class Sessions extends APIResource {
+  /**
+   * Creates a Daytona-backed native Linc session with scoped Case.dev credentials.
+   * This endpoint starts the sandbox actor only; messages and event replay use
+   * separate endpoints.
+   */
+  create(body: SessionCreateParams | null | undefined = {}, options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/linc/v1/sessions', {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * End native Linc session
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/linc/v1/sessions/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Sends an abort RPC to the session runtime, ending the current turn while keeping
+   * the session alive. Body handling is intentionally lenient — cancel is a stop
+   * control, so unknown fields are ignored and an invalid or missing body is treated
+   * as empty rather than rejected.
+   */
+  cancel(
+    id: string,
+    body: SessionCancelParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.post(path`/linc/v1/sessions/${id}/cancel`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Runtime ingest endpoint for sandbox runtimes. Frames are persisted for replay;
+   * terminal frames emit the durable Linc session ended webhook.
+   */
+  ingestEvents(id: string, body: SessionIngestEventsParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/linc/v1/sessions/${id}/events/ingest`, {
+      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.
+   */
+  retrieveEvents(
+    id: string,
+    query: SessionRetrieveEventsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.get(path`/linc/v1/sessions/${id}/events`, {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Returns completed Pi/Linc message entries derived from durable native Linc
+   * events. This is the stable session-message read model for callers that need to
+   * persist or recover chat history without depending on a live SSE stream.
+   */
+  retrieveMessages(
+    id: string,
+    query: SessionRetrieveMessagesParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.get(path`/linc/v1/sessions/${id}/messages`, {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Get native Linc session state
+   */
+  retrieveState(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.get(path`/linc/v1/sessions/${id}/state`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Forwards a native Pi/Linc RPC command object to the sandbox-local Linc bridge
+   * unchanged. The route returns after Pi accepts or rejects the command; native
+   * events are read through the events endpoint.
+   */
+  sendRpc(id: string, body: SessionSendRpcParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/linc/v1/sessions/${id}/rpc`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface SessionCreateParams {
+  /**
+   * Specific document template slugs to inject into the using-document-templates
+   * skill.
+   */
+  documentTemplateSlugs?: Array<string> | null;
+
+  idleTimeoutMs?: number | null;
+
+  /**
+   * 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.
+   */
+  instructions?: string | null;
+
+  model?: string | null;
+
+  /**
+   * 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.
+   */
+  serviceTier?: 'default' | 'priority';
+
+  /**
+   * Skills API slugs to install into the runtime sandbox before the native session
+   * starts.
+   */
+  skillSlugs?: Array<string> | null;
+
+  title?: string;
+
+  vaultIds?: Array<string> | null;
+}
+
+export interface SessionCancelParams {
+  /**
+   * Also clear queued steering/follow-up messages so the abort leaves the agent
+   * fully idle. Cleared texts are returned in the `response.data.clearedQueue` field
+   * of the response body. Without it, messages still queued when the abort settles
+   * are auto-continued as a new run. Runtimes older than the Linc release that
+   * supports this flag ignore it: the abort still happens but the queue is left
+   * untouched.
+   */
+  clearQueue?: boolean;
+
+  [k: string]: unknown;
+}
+
+export interface SessionIngestEventsParams {
+  /**
+   * Native Linc event frames to persist for replay.
+   */
+  frames: Array<SessionIngestEventsParams.Frame>;
+}
+
+export namespace SessionIngestEventsParams {
+  export interface Frame {
+    /**
+     * Native Linc event payload.
+     */
+    event: { [key: string]: unknown };
+
+    /**
+     * Monotonic native event sequence number.
+     */
+    seq: number;
+
+    /**
+     * Native Linc event type.
+     */
+    type: string;
+  }
+}
+
+export interface SessionRetrieveEventsParams {
+  /**
+   * Alias for cursor. Ignored when cursor is also provided.
+   */
+  afterSeq?: number;
+
+  /**
+   * Replay events with a sequence number greater than this cursor.
+   */
+  cursor?: number;
+
+  /**
+   * Comma-separated Linc event types to omit from replay.
+   */
+  excludeEventTypes?: Array<string>;
+
+  /**
+   * Maximum number of events to return.
+   */
+  limit?: number;
+}
+
+export interface SessionRetrieveMessagesParams {
+  /**
+   * Alias for cursor. Ignored when cursor is also provided.
+   */
+  afterSeq?: number;
+
+  /**
+   * Replay messages with a source event sequence number greater than this cursor.
+   */
+  cursor?: number;
+
+  /**
+   * Maximum number of source events to scan for completed messages.
+   */
+  limit?: number;
+}
+
+export interface SessionSendRpcParams {
+  /**
+   * Native Pi/Linc RPC command type. Prompt commands also require a string id for
+   * idempotency.
+   */
+  type: string;
+
+  /**
+   * Command idempotency key. Required when type is prompt.
+   */
+  id?: string;
+
+  [k: string]: unknown;
+}
+
+export declare namespace Sessions {
+  export {
+    type SessionCreateParams as SessionCreateParams,
+    type SessionCancelParams as SessionCancelParams,
+    type SessionIngestEventsParams as SessionIngestEventsParams,
+    type SessionRetrieveEventsParams as SessionRetrieveEventsParams,
+    type SessionRetrieveMessagesParams as SessionRetrieveMessagesParams,
+    type SessionSendRpcParams as SessionSendRpcParams,
+  };
+}

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

@@ -0,0 +1,31 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as SessionsAPI from './sessions';
+import {
+  SessionCancelParams,
+  SessionCreateParams,
+  SessionIngestEventsParams,
+  SessionRetrieveEventsParams,
+  SessionRetrieveMessagesParams,
+  SessionSendRpcParams,
+  Sessions,
+} from './sessions';
+
+export class V1 extends APIResource {
+  sessions: SessionsAPI.Sessions = new SessionsAPI.Sessions(this._client);
+}
+
+V1.Sessions = Sessions;
+
+export declare namespace V1 {
+  export {
+    Sessions as Sessions,
+    type SessionCreateParams as SessionCreateParams,
+    type SessionCancelParams as SessionCancelParams,
+    type SessionIngestEventsParams as SessionIngestEventsParams,
+    type SessionRetrieveEventsParams as SessionRetrieveEventsParams,
+    type SessionRetrieveMessagesParams as SessionRetrieveMessagesParams,
+    type SessionSendRpcParams as SessionSendRpcParams,
+  };
+}

package/src/resources/{format/v1.ts → linc.ts}

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

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

@@ -90,8 +90,9 @@ export interface ChatCreateCompletionParams {
   messages: Array<ChatCreateCompletionParams.Message>;
 
   /**
-   * CaseMark-only: when true, allows reasoning fields in responses. Defaults to
-   * false (reasoning is suppressed).
+   * 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;
 

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

@@ -21,5 +21,4 @@ export {
   type WorkItemUpdateParams,
   type WorkItemListParams,
   type WorkItemDecideParams,
-  type WorkItemListExecutionsParams,
 } from './work-items';

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

@@ -17,7 +17,6 @@ import * as WorkItemsAPI from './work-items';
 import {
   WorkItemCreateParams,
   WorkItemDecideParams,
-  WorkItemListExecutionsParams,
   WorkItemListParams,
   WorkItemRetrieveParams,
   WorkItemUpdateParams,
@@ -239,6 +238,5 @@ export declare namespace V1 {
     type WorkItemUpdateParams as WorkItemUpdateParams,
     type WorkItemListParams as WorkItemListParams,
     type WorkItemDecideParams as WorkItemDecideParams,
-    type WorkItemListExecutionsParams as WorkItemListExecutionsParams,
   };
 }

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

@@ -60,8 +60,7 @@ export class WorkItems extends APIResource {
   }
 
   /**
-   * Approve, revise, block, or reassign a work item. Used by humans or agents to
-   * move work items through their lifecycle.
+   * Approve or block a work item.
    */
   decide(workItemID: string, params: WorkItemDecideParams, options?: RequestOptions): APIPromise<void> {
     const { id, ...body } = params;
@@ -71,21 +70,6 @@ export class WorkItems extends APIResource {
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
-
-  /**
-   * List execution attempts for a work item, including agent and run linkage.
-   */
-  listExecutions(
-    workItemID: string,
-    params: WorkItemListExecutionsParams,
-    options?: RequestOptions,
-  ): APIPromise<void> {
-    const { id } = params;
-    return this._client.get(path`/matters/v1/${id}/work-items/${workItemID}/executions`, {
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
-  }
 }
 
 export interface WorkItemCreateParams {
@@ -220,12 +204,7 @@ export interface WorkItemDecideParams {
   /**
    * Body param
    */
-  decision: 'approve' | 'revise' | 'block' | 'reassign';
-
-  /**
-   * Body param
-   */
-  agent_type_id?: string | null;
+  decision: 'approve' | 'block';
 
   /**
    * Body param
@@ -238,10 +217,6 @@ export interface WorkItemDecideParams {
   reason?: string | null;
 }
 
-export interface WorkItemListExecutionsParams {
-  id: string;
-}
-
 export declare namespace WorkItems {
   export {
     type WorkItemCreateParams as WorkItemCreateParams,
@@ -249,6 +224,5 @@ export declare namespace WorkItems {
     type WorkItemUpdateParams as WorkItemUpdateParams,
     type WorkItemListParams as WorkItemListParams,
     type WorkItemDecideParams as WorkItemDecideParams,
-    type WorkItemListExecutionsParams as WorkItemListExecutionsParams,
   };
 }

package/src/resources/media/v1/clips.ts

@@ -6,6 +6,9 @@ import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
 
+/**
+ * Transcript retrieval and captioned media clip generation
+ */
 export class Clips extends APIResource {
   /**
    * Create a captioned media clip

package/src/resources/media/v1/transcripts/index.ts

@@ -1,4 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export { Retrieve, type RetrieveCreateResponse, type RetrieveCreateParams } from './retrieve';
 export { Search } from './search';
 export { Transcripts } from './transcripts';

package/src/resources/media/v1/transcripts/retrieve.ts

@@ -0,0 +1,94 @@
+// 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';
+
+/**
+ * Transcript retrieval and captioned media clip generation
+ */
+export class Retrieve extends APIResource {
+  /**
+   * Retrieves the full transcript text for a vault transcript object or an
+   * audio/video source object with a completed transcription job. When object_id is
+   * a source media object, access to that source object grants access to its
+   * generated transcript artifact.
+   */
+  create(body: RetrieveCreateParams, options?: RequestOptions): APIPromise<RetrieveCreateResponse> {
+    return this._client.post('/media/v1/transcripts/retrieve', { body, ...options });
+  }
+}
+
+export interface RetrieveCreateResponse {
+  /**
+   * Requested object ID.
+   */
+  object_id: string;
+
+  status: 'completed';
+
+  /**
+   * Full transcript text.
+   */
+  text: string;
+
+  vault_id: string;
+
+  audio_duration?: number;
+
+  confidence?: number;
+
+  filename?: string;
+
+  /**
+   * Source media object ID when known.
+   */
+  source_object_id?: string;
+
+  /**
+   * Transcript object ID when known.
+   */
+  transcript_object_id?: string;
+
+  /**
+   * Transcription job ID when known.
+   */
+  transcription_job_id?: string;
+
+  word_count?: number;
+}
+
+export interface RetrieveCreateParams {
+  /**
+   * Object ID for either the source audio/video file or transcript artifact.
+   */
+  object_id: string;
+
+  /**
+   * Vault ID containing the source media or transcript object.
+   */
+  vault_id: string;
+
+  /**
+   * Alternative nested transcript object reference.
+   */
+  transcript?: RetrieveCreateParams.Transcript;
+}
+
+export namespace RetrieveCreateParams {
+  /**
+   * Alternative nested transcript object reference.
+   */
+  export interface Transcript {
+    object_id?: string;
+
+    vault_id?: string;
+  }
+}
+
+export declare namespace Retrieve {
+  export {
+    type RetrieveCreateResponse as RetrieveCreateResponse,
+    type RetrieveCreateParams as RetrieveCreateParams,
+  };
+}

package/src/resources/media/v1/transcripts/search.ts

@@ -5,6 +5,9 @@ import { APIPromise } from '../../../../core/api-promise';
 import { buildHeaders } from '../../../../internal/headers';
 import { RequestOptions } from '../../../../internal/request-options';
 
+/**
+ * Transcript retrieval and captioned media clip generation
+ */
 export class Search extends APIResource {
   /**
    * Search transcript words

package/src/resources/media/v1/transcripts/transcripts.ts

@@ -1,15 +1,25 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../../core/resource';
+import * as RetrieveAPI from './retrieve';
+import { Retrieve, RetrieveCreateParams, RetrieveCreateResponse } from './retrieve';
 import * as SearchAPI from './search';
 import { Search } from './search';
 
 export class Transcripts extends APIResource {
   search: SearchAPI.Search = new SearchAPI.Search(this._client);
+  retrieve: RetrieveAPI.Retrieve = new RetrieveAPI.Retrieve(this._client);
 }
 
 Transcripts.Search = Search;
+Transcripts.Retrieve = Retrieve;
 
 export declare namespace Transcripts {
   export { Search as Search };
+
+  export {
+    Retrieve as Retrieve,
+    type RetrieveCreateResponse as RetrieveCreateResponse,
+    type RetrieveCreateParams as RetrieveCreateParams,
+  };
 }

package/src/resources/ocr/v1.ts

@@ -11,8 +11,8 @@ import { path } from '../../internal/utils/path';
  */
 export class V1 extends APIResource {
   /**
-   * Retrieve the status and results of an OCR job. Returns job progress, extracted
-   * text, and metadata when processing is complete.
+   * Retrieve the status and results of an OCR job. Returns job progress and
+   * metadata; full extracted text is included only when include_text=true.
    *
    * @example
    * ```ts
@@ -103,7 +103,7 @@ export interface V1RetrieveResponse {
   page_count?: number;
 
   /**
-   * Extracted text content (when completed)
+   * Extracted text content when completed and include_text=true
    */
   text?: string;
 }
@@ -147,7 +147,7 @@ export interface V1ProcessResponse {
 
 export interface V1RetrieveParams {
   /**
-   * Include full OCR text in completed responses (default: true)
+   * Include full OCR text in completed responses (default: false)
    */
   include_text?: 'true' | 'false';
 }

package/src/resources/search/index.ts

@@ -5,14 +5,10 @@ export {
   V1,
   type V1AnswerResponse,
   type V1ContentsResponse,
-  type V1ResearchResponse,
-  type V1RetrieveResearchResponse,
   type V1SearchResponse,
   type V1SimilarResponse,
   type V1AnswerParams,
   type V1ContentsParams,
-  type V1ResearchParams,
-  type V1RetrieveResearchParams,
   type V1SearchParams,
   type V1SimilarParams,
 } from './v1';

package/src/resources/search/search.ts

@@ -8,10 +8,6 @@ import {
   V1AnswerResponse,
   V1ContentsParams,
   V1ContentsResponse,
-  V1ResearchParams,
-  V1ResearchResponse,
-  V1RetrieveResearchParams,
-  V1RetrieveResearchResponse,
   V1SearchParams,
   V1SearchResponse,
   V1SimilarParams,
@@ -29,14 +25,10 @@ export declare namespace Search {
     V1 as V1,
     type V1AnswerResponse as V1AnswerResponse,
     type V1ContentsResponse as V1ContentsResponse,
-    type V1ResearchResponse as V1ResearchResponse,
-    type V1RetrieveResearchResponse as V1RetrieveResearchResponse,
     type V1SearchResponse as V1SearchResponse,
     type V1SimilarResponse as V1SimilarResponse,
     type V1AnswerParams as V1AnswerParams,
     type V1ContentsParams as V1ContentsParams,
-    type V1ResearchParams as V1ResearchParams,
-    type V1RetrieveResearchParams as V1RetrieveResearchParams,
     type V1SearchParams as V1SearchParams,
     type V1SimilarParams as V1SimilarParams,
   };