casedev 0.0.1

package/src/resources/templates/v1.ts

@@ -0,0 +1,187 @@
+// 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';
+
+export class V1 extends APIResource {
+  /**
+   * Retrieve metadata for a published workflow by ID. Returns workflow configuration
+   * including input/output schemas, but excludes the prompt template for security.
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.get(path`/templates/v1/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Retrieve a paginated list of available workflows with optional filtering by
+   * category, subcategory, type, and publication status. Workflows are pre-built
+   * document processing pipelines optimized for legal use cases.
+   */
+  list(query: V1ListParams | null | undefined = {}, options?: RequestOptions): APIPromise<void> {
+    return this._client.get('/templates/v1', {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Execute a pre-built workflow with custom input data. Workflows automate common
+   * legal document processing tasks like contract analysis, due diligence reviews,
+   * and document classification.
+   *
+   * **Available Workflows:**
+   *
+   * - Contract analysis and risk assessment
+   * - Document classification and tagging
+   * - Legal research and case summarization
+   * - Due diligence document review
+   * - Compliance checking and reporting
+   */
+  execute(id: string, body: V1ExecuteParams, options?: RequestOptions): APIPromise<V1ExecuteResponse> {
+    return this._client.post(path`/templates/v1/${id}/execute`, { body, ...options });
+  }
+
+  /**
+   * Retrieves the status and details of a workflow execution. This endpoint is
+   * designed for future asynchronous execution support and currently returns a 501
+   * Not Implemented status since all executions are synchronous.
+   */
+  retrieveExecution(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.get(path`/templates/v1/executions/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Perform semantic search across available workflows to find the most relevant
+   * pre-built document processing pipelines for your legal use case.
+   */
+  search(body: V1SearchParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/templates/v1/search', {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface V1ExecuteResponse {
+  /**
+   * Workflow output (structure varies by workflow type)
+   */
+  result?: unknown;
+
+  status?: 'completed' | 'failed';
+
+  usage?: V1ExecuteResponse.Usage;
+
+  /**
+   * Name of the executed workflow
+   */
+  workflow_name?: string;
+}
+
+export namespace V1ExecuteResponse {
+  export interface Usage {
+    completion_tokens?: number;
+
+    /**
+     * Total cost in USD
+     */
+    cost?: number;
+
+    prompt_tokens?: number;
+
+    total_tokens?: number;
+  }
+}
+
+export interface V1ListParams {
+  /**
+   * Filter workflows by category (e.g., 'legal', 'compliance', 'contract')
+   */
+  category?: string;
+
+  /**
+   * Maximum number of workflows to return
+   */
+  limit?: number;
+
+  /**
+   * Number of workflows to skip for pagination
+   */
+  offset?: number;
+
+  /**
+   * Include only published workflows
+   */
+  published?: boolean;
+
+  /**
+   * Filter workflows by subcategory (e.g., 'due-diligence', 'litigation', 'mergers')
+   */
+  sub_category?: string;
+
+  /**
+   * Filter workflows by type (e.g., 'document-review', 'contract-analysis',
+   * 'compliance-check')
+   */
+  type?: string;
+}
+
+export interface V1ExecuteParams {
+  /**
+   * Input data for the workflow (structure varies by workflow type)
+   */
+  input: unknown;
+
+  options?: V1ExecuteParams.Options;
+}
+
+export namespace V1ExecuteParams {
+  export interface Options {
+    /**
+     * Output format preference
+     */
+    format?: 'json' | 'text';
+
+    /**
+     * LLM model to use for processing
+     */
+    model?: string;
+  }
+}
+
+export interface V1SearchParams {
+  /**
+   * Search query to find relevant workflows
+   */
+  query: string;
+
+  /**
+   * Optional category filter to narrow results
+   */
+  category?: string;
+
+  /**
+   * Maximum number of results to return (default: 10, max: 50)
+   */
+  limit?: number;
+}
+
+export declare namespace V1 {
+  export {
+    type V1ExecuteResponse as V1ExecuteResponse,
+    type V1ListParams as V1ListParams,
+    type V1ExecuteParams as V1ExecuteParams,
+    type V1SearchParams as V1SearchParams,
+  };
+}

package/src/resources/templates.ts

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

package/src/resources/vault/graphrag.ts

@@ -0,0 +1,45 @@
+// 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';
+
+export class Graphrag extends APIResource {
+  /**
+   * Retrieve GraphRAG (Graph Retrieval-Augmented Generation) statistics for a
+   * specific vault. This includes metrics about the knowledge graph structure,
+   * entity relationships, and processing status that enable advanced semantic search
+   * and AI-powered document analysis.
+   *
+   * @example
+   * ```ts
+   * await client.vault.graphrag.getStats('id');
+   * ```
+   */
+  getStats(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.get(path`/vault/${id}/graphrag/stats`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Initialize a GraphRAG workspace for a vault to enable advanced knowledge graph
+   * and retrieval-augmented generation capabilities. This creates the necessary
+   * infrastructure for semantic document analysis and graph-based querying within
+   * the vault.
+   *
+   * @example
+   * ```ts
+   * await client.vault.graphrag.init('id');
+   * ```
+   */
+  init(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/vault/${id}/graphrag/init`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}

package/src/resources/vault/index.ts

@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Graphrag } from './graphrag';
+export {
+  Objects,
+  type ObjectCreatePresignedURLResponse,
+  type ObjectRetrieveParams,
+  type ObjectCreatePresignedURLParams,
+  type ObjectDownloadParams,
+  type ObjectGetTextParams,
+} from './objects';
+export {
+  Vault,
+  type VaultCreateResponse,
+  type VaultListResponse,
+  type VaultIngestResponse,
+  type VaultSearchResponse,
+  type VaultUploadResponse,
+  type VaultCreateParams,
+  type VaultIngestParams,
+  type VaultSearchParams,
+  type VaultUploadParams,
+} from './vault';

package/src/resources/vault/objects.ts

@@ -0,0 +1,225 @@
+// 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';
+
+export class Objects extends APIResource {
+  /**
+   * Retrieves metadata for a specific document in a vault and generates a temporary
+   * download URL. The download URL expires after 1 hour for security. This endpoint
+   * also updates the file size if it wasn't previously calculated.
+   *
+   * @example
+   * ```ts
+   * await client.vault.objects.retrieve('objectId', {
+   *   id: 'id',
+   * });
+   * ```
+   */
+  retrieve(objectID: string, params: ObjectRetrieveParams, options?: RequestOptions): APIPromise<void> {
+    const { id } = params;
+    return this._client.get(path`/vault/${id}/objects/${objectID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Retrieve all objects stored in a specific vault, including document metadata,
+   * ingestion status, and processing statistics.
+   *
+   * @example
+   * ```ts
+   * await client.vault.objects.list('id');
+   * ```
+   */
+  list(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.get(path`/vault/${id}/objects`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Generate presigned URLs for direct S3 operations (GET, PUT, DELETE, HEAD) on
+   * vault objects. This allows secure, time-limited access to files without proxying
+   * through the API. Essential for large document uploads/downloads in legal
+   * workflows.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.vault.objects.createPresignedURL(
+   *     'objectId',
+   *     { id: 'id' },
+   *   );
+   * ```
+   */
+  createPresignedURL(
+    objectID: string,
+    params: ObjectCreatePresignedURLParams,
+    options?: RequestOptions,
+  ): APIPromise<ObjectCreatePresignedURLResponse> {
+    const { id, ...body } = params;
+    return this._client.post(path`/vault/${id}/objects/${objectID}/presigned-url`, { body, ...options });
+  }
+
+  /**
+   * Downloads a file from a vault. Returns the actual file content as a binary
+   * stream with appropriate headers for file download. Useful for retrieving
+   * contracts, depositions, case files, and other legal documents stored in your
+   * vault.
+   *
+   * @example
+   * ```ts
+   * await client.vault.objects.download('objectId', {
+   *   id: 'id',
+   * });
+   * ```
+   */
+  download(objectID: string, params: ObjectDownloadParams, options?: RequestOptions): APIPromise<void> {
+    const { id } = params;
+    return this._client.get(path`/vault/${id}/objects/${objectID}/download`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Retrieves the full extracted text content from a processed vault object. Returns
+   * the concatenated text from all chunks, useful for document review, analysis, or
+   * export. The object must have completed processing before text can be retrieved.
+   *
+   * @example
+   * ```ts
+   * await client.vault.objects.getText('objectId', {
+   *   id: 'id',
+   * });
+   * ```
+   */
+  getText(objectID: string, params: ObjectGetTextParams, options?: RequestOptions): APIPromise<void> {
+    const { id } = params;
+    return this._client.get(path`/vault/${id}/objects/${objectID}/text`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface ObjectCreatePresignedURLResponse {
+  /**
+   * URL expiration timestamp
+   */
+  expiresAt?: string;
+
+  /**
+   * URL expiration time in seconds
+   */
+  expiresIn?: number;
+
+  /**
+   * Original filename
+   */
+  filename?: string;
+
+  /**
+   * Usage instructions and examples
+   */
+  instructions?: unknown;
+
+  metadata?: ObjectCreatePresignedURLResponse.Metadata;
+
+  /**
+   * The object identifier
+   */
+  objectId?: string;
+
+  /**
+   * The operation type
+   */
+  operation?: string;
+
+  /**
+   * The presigned URL for direct S3 access
+   */
+  presignedUrl?: string;
+
+  /**
+   * S3 object key
+   */
+  s3Key?: string;
+
+  /**
+   * The vault identifier
+   */
+  vaultId?: string;
+}
+
+export namespace ObjectCreatePresignedURLResponse {
+  export interface Metadata {
+    bucket?: string;
+
+    contentType?: string;
+
+    region?: string;
+
+    sizeBytes?: number;
+  }
+}
+
+export interface ObjectRetrieveParams {
+  /**
+   * Vault ID
+   */
+  id: string;
+}
+
+export interface ObjectCreatePresignedURLParams {
+  /**
+   * Path param: The unique identifier of the vault
+   */
+  id: string;
+
+  /**
+   * Body param: Content type for PUT operations (optional, defaults to object's
+   * content type)
+   */
+  contentType?: string;
+
+  /**
+   * Body param: URL expiration time in seconds (1 minute to 7 days)
+   */
+  expiresIn?: number;
+
+  /**
+   * Body param: The S3 operation to generate URL for
+   */
+  operation?: 'GET' | 'PUT' | 'DELETE' | 'HEAD';
+}
+
+export interface ObjectDownloadParams {
+  /**
+   * Vault ID
+   */
+  id: string;
+}
+
+export interface ObjectGetTextParams {
+  /**
+   * The vault ID
+   */
+  id: string;
+}
+
+export declare namespace Objects {
+  export {
+    type ObjectCreatePresignedURLResponse as ObjectCreatePresignedURLResponse,
+    type ObjectRetrieveParams as ObjectRetrieveParams,
+    type ObjectCreatePresignedURLParams as ObjectCreatePresignedURLParams,
+    type ObjectDownloadParams as ObjectDownloadParams,
+    type ObjectGetTextParams as ObjectGetTextParams,
+  };
+}