@squidcloud/client 1.0.497 → 1.0.499

package/dist/typescript-client/src/agent/ai-agent-client-reference.d.ts

@@ -1,5 +1,5 @@
 import { Observable } from 'rxjs';
-import { AiAgent, AiAgentMcpServerConfig, AiChatMessage, AiChatModelSelection, AiConnectedAgentMetadata, AiConnectedIntegrationMetadata, AiConnectedKnowledgeBaseMetadata, AiPiiOptions, AiStatusMessage, AiTranscribeAndAskResponse, AllAiAgentChatOptions, BuildAgentOptions, GenerateAgentMcpDescriptionsResponse, GuardrailsOptions, ListAgentRevisionsResponse, UpsertAgentRequest } from '../../../internal-common/src/public-types/ai-agent.public-types';
+import { AiAgent, AiAgentMcpServerConfig, AiAskModelSelection, AiChatMessage, AiChatModelSelection, AiConnectedAgentMetadata, AiConnectedIntegrationMetadata, AiConnectedKnowledgeBaseMetadata, AiPiiOptions, AiStatusMessage, AiTranscribeAndAskResponse, AllAiAgentChatOptions, BuildAgentOptions, GenerateAgentMcpDescriptionsResponse, GuardrailsOptions, ListAgentRevisionsResponse, UpsertAgentRequest } from '../../../internal-common/src/public-types/ai-agent.public-types';
 import { JobId } from '../../../internal-common/src/public-types/job.public-types';
 import { Paths } from '../../../internal-common/src/public-types/typescript.public-types';
 import { AiAskOptions, AiAskOptionsWithVoice, AiChatOptionsWithoutVoice, AskResponse, AskWithVoiceResponse, TranscribeAndAskWithVoiceResponse, TranscribeAndChatResponse } from './ai-agent-client.types';
@@ -113,7 +113,7 @@ export declare class AiAgentReference {
      *   `squid.jobs().getJob(jobId)` to track progress. Make sure each job ID is both unique and kept private—anyone who
      *   knows it can look up the job’s status.
      */
-    chat<T extends AiChatModelSelection | undefined>(prompt: string, options?: AiChatOptionsWithoutVoice<T>, jobId?: JobId): Observable<string>;
+    chat<T extends AiAskModelSelection | undefined>(prompt: string, options?: AiChatOptionsWithoutVoice<T>, jobId?: JobId): Observable<string>;
     /**
      * Transcribes the given file and performs a chat interaction.
      * @param fileToTranscribe The audio file to transcribe and send to the agent.
@@ -131,7 +131,7 @@ export declare class AiAgentReference {
      *   `squid.jobs().getJob(jobId)` to track progress. Make sure each job ID is both unique and kept private—anyone who
      *   knows it can look up the job’s status.
      */
-    ask<T extends AiChatModelSelection | undefined = undefined>(prompt: string, options?: AiAskOptions<T>, jobId?: JobId): Promise<string>;
+    ask<T extends AiAskModelSelection | undefined = undefined>(prompt: string, options?: AiAskOptions<T>, jobId?: JobId): Promise<string>;
     /**
      * Sends a prompt and returns the string response and file annotations.
      * @param prompt The text prompt to send to the agent.
@@ -140,7 +140,7 @@ export declare class AiAgentReference {
      *   `squid.jobs().getJob(jobId)` to track progress. Make sure each job ID is both unique and kept private—anyone who
      *   knows it can look up the job’s status.
      */
-    askWithAnnotations<T extends AiChatModelSelection | undefined = undefined>(prompt: string, options?: AiAskOptions<T>, jobId?: JobId): Promise<AskResponse>;
+    askWithAnnotations<T extends AiAskModelSelection | undefined = undefined>(prompt: string, options?: AiAskOptions<T>, jobId?: JobId): Promise<AskResponse>;
     /**
      * Sends a prompt and not wait for the result - the result can be tracked using the job ID
      * (`squid.jobs().awaitJob(jobId)` or `squid.jobs().getJob(jobId)).
@@ -151,7 +151,7 @@ export declare class AiAgentReference {
      to track progress. Make sure each job ID is both unique and kept private—anyone who knows it can look up the job’s status.
      * @param options Optional parameters for the AI ask request.
      */
-    askAsync<T extends AiChatModelSelection | undefined = undefined>(prompt: string, jobId: JobId, options?: AiAskOptions<T>): Promise<void>;
+    askAsync<T extends AiAskModelSelection | undefined = undefined>(prompt: string, jobId: JobId, options?: AiAskOptions<T>): Promise<void>;
     /**
      * Observes live status messages from the agent.
      * @param jobId The job ID to filter status updates for a specific job. If not provided, all status updates for the agent are observed.

package/dist/typescript-client/src/agent/ai-agent-client.types.d.ts

@@ -1,5 +1,5 @@
 import { Observable } from 'rxjs';
-import { AiAnnotation, AiChatModelSelection, AiChatOptions, AiChatRequestCredentials } from '../../../internal-common/src/public-types/ai-agent.public-types';
+import { AiAnnotation, AiAskModelSelection, AiChatModelSelection, AiChatOptions, AiChatRequestCredentials, AiModelRoutingResult } from '../../../internal-common/src/public-types/ai-agent.public-types';
 /**
  * Response format for transcribing audio and generating a chat response.
  * Contains the transcribed text and a stream of AI-generated responses.
@@ -33,6 +33,8 @@ export interface AskResponse {
     responseString: string;
     /** Optional annotations that provide additional context or metadata about the response. */
     annotations?: Record<string, AiAnnotation>;
+    /** Set when `model` was an {@link AiModelRoutingOptions}: which model answered and what the routing call cost. */
+    routing?: AiModelRoutingResult;
 }
 /**
  * Response format for AI-generated voice responses.
@@ -49,20 +51,26 @@ export interface AskWithVoiceResponse {
  * Chat options that exclude voice-specific configurations.
  * @category AI
  */
-export type AiChatOptionsWithoutVoice<T extends AiChatModelSelection | undefined = undefined> = Omit<AiChatOptions<T>, 'voiceOptions'> & {
+export type AiChatOptionsWithoutVoice<T extends AiAskModelSelection | undefined = undefined> = Omit<AiChatOptions<ConcreteModelOf<T>>, 'voiceOptions' | 'model'> & {
     model?: T;
 } & AiChatRequestCredentials;
 /**
  * Options for AI-generated responses that exclude voice-specific settings and smooth typing behavior.
  * @category AI
  */
-export type AiAskOptions<T extends AiChatModelSelection | undefined = undefined> = Omit<AiChatOptions<T>, 'voiceOptions' | 'smoothTyping'> & {
+export type AiAskOptions<T extends AiAskModelSelection | undefined = undefined> = Omit<AiChatOptions<ConcreteModelOf<T>>, 'voiceOptions' | 'smoothTyping' | 'model'> & {
     model?: T;
 } & AiChatRequestCredentials;
 /**
  * Options for AI-generated responses that include voice-specific settings but excludes smooth typing.
  * @category AI
  */
-export type AiAskOptionsWithVoice<T extends AiChatModelSelection | undefined = undefined> = Omit<AiChatOptions<T>, 'smoothTyping'> & {
+export type AiAskOptionsWithVoice<T extends AiAskModelSelection | undefined = undefined> = Omit<AiChatOptions<ConcreteModelOf<T>>, 'smoothTyping' | 'model'> & {
     model?: T;
 } & AiChatRequestCredentials;
+/**
+ * The concrete model a request's model selection names, which picks the provider-specific option set;
+ * a routing choice names none, so it gets the provider-agnostic options.
+ * @category AI
+ */
+export type ConcreteModelOf<T extends AiAskModelSelection | undefined> = T extends AiChatModelSelection ? T : undefined;

package/dist/typescript-client/src/ai-knowledge-base/ai-knowledge-base-client-reference.d.ts

@@ -1,5 +1,5 @@
 import { Observable } from 'rxjs';
-import { AiEmbeddingsModelWithOptionalFields, AiKnowledgeBase, AiKnowledgeBaseChatOptions, AiKnowledgeBaseContext, AiKnowledgeBaseContextRequest, AiKnowledgeBaseContextWithReasoning, AiKnowledgeBaseDownloadContextResponse, AiKnowledgeBaseSearchContextsWithContextIdRequest, AiKnowledgeBaseSearchContextsWithPromptRequest, AiKnowledgeBaseSearchResponse, AiKnowledgeBaseSearchResultChunk, BulkIngestionContext, BulkIngestionCreateUploadUrlsResponse, BulkIngestionJobStatusResponse, BulkIngestionUpsertContextsOptions, BulkIngestionUpsertContextsResponse, ExploreKnowledgeBaseGraphRequest, ExploreKnowledgeBaseGraphResponse, GenerateMetadataFieldDescriptionsRequest, GenerateMetadataFieldDescriptionsResponse, GetKnowledgeBaseGraphStatusResponse, GrepKnowledgeBaseOptions, GrepKnowledgeBaseResponse, ListAiKnowledgeBaseContextsPageResponse, ListKnowledgeBaseContextsOptions, QueryKnowledgeBaseGraphRequest, QueryKnowledgeBaseGraphResponse, RebuildKnowledgeBaseGraphRequest, UpsertKnowledgeBaseContextResponse, UpsertKnowledgeBaseContextsResponse } from '../../../internal-common/src/public-types/ai-knowledge-base.public-types';
+import { AiEmbeddingsModelWithOptionalFields, AiKnowledgeBase, AiKnowledgeBaseChatOptions, AiKnowledgeBaseContext, AiKnowledgeBaseContextRequest, AiKnowledgeBaseContextWithReasoning, AiKnowledgeBaseDownloadContextResponse, AiKnowledgeBaseFileStatusInfo, AiKnowledgeBaseFolderStatusResponse, AiKnowledgeBaseSearchContextsWithContextIdRequest, AiKnowledgeBaseSearchContextsWithPromptRequest, AiKnowledgeBaseSearchResponse, AiKnowledgeBaseSearchResultChunk, BulkIngestionContext, BulkIngestionCreateUploadUrlsResponse, BulkIngestionJobStatusResponse, BulkIngestionUpsertContextsOptions, BulkIngestionUpsertContextsResponse, ExploreKnowledgeBaseGraphRequest, ExploreKnowledgeBaseGraphResponse, GenerateMetadataFieldDescriptionsRequest, GenerateMetadataFieldDescriptionsResponse, GetKnowledgeBaseGraphStatusResponse, GrepKnowledgeBaseOptions, GrepKnowledgeBaseResponse, ListAiKnowledgeBaseContextsPageResponse, ListKnowledgeBaseContextsOptions, QueryKnowledgeBaseGraphRequest, QueryKnowledgeBaseGraphResponse, RebuildKnowledgeBaseGraphRequest, UpsertKnowledgeBaseContextResponse, UpsertKnowledgeBaseContextsResponse } from '../../../internal-common/src/public-types/ai-knowledge-base.public-types';
 import { AiContextId } from '../../../internal-common/src/public-types/communication.public-types';
 /**
  * Parameters for creating or updating an AI agent.
@@ -207,6 +207,20 @@ export declare class AiKnowledgeBaseReference {
      * recent rebuild job, and the graph's LLM token/cost usage (`ingestUsage`, `lastRebuildUsage`).
      */
     getGraphStatus(): Promise<GetKnowledgeBaseGraphStatusResponse>;
+    /**
+     * Looks up the durable ingestion status of one file by path (`folderPath/filename`, or just
+     * `filename` at the upload root): `'completed'`, `'failed'` (with `errorMessage`/`errorCode`),
+     * `'in_progress'`, or `'no_record'` when the knowledge base has no trace of that path.
+     */
+    getFileStatus(path: string): Promise<AiKnowledgeBaseFileStatusInfo>;
+    /**
+     * Searches and aggregates the durable ingestion status of every file matching `folderPath`, read
+     * three ways and unioned: a folder subtree (matched the same segment-safe way as `$underPath`
+     * metadata filters), a bare filename anywhere in the knowledge base, and — when it contains a `/` —
+     * an exact `folderPath/filename` path. Returns per-status counts plus the files themselves (failures
+     * prioritized, capped at `fileLimit`, default 50).
+     */
+    getFolderStatus(folderPath: string, fileLimit?: number): Promise<AiKnowledgeBaseFolderStatusResponse>;
     /**
      * Enqueues a graph rebuild/backfill. The default `'structural'` mode keeps the already-extracted
      * entity graph (extracting only contexts never graph-indexed) and rebuilds just the concept layer

package/dist/typescript-client/src/langgraph-client.d.ts

@@ -1,5 +1,5 @@
 import { JobId } from '../../internal-common/src/public-types/job.public-types';
-import { GetLangGraphStateSuccessResult, InvokeLangGraphOptions, InvokeLangGraphSuccessResult } from '../../internal-common/src/public-types/langgraph.public-types';
+import { GetLangGraphStateSuccessResult, InvokeLangGraphOptions, InvokeLangGraphSuccessResult, ResumeLangGraphOptions } from '../../internal-common/src/public-types/langgraph.public-types';
 /**
  * Reference to a specific LangGraph.
  * @category AI
@@ -13,9 +13,7 @@ export declare class LangGraphReference {
      *
      * For very long graphs where you don't want to hold a Promise, use `invokeAsync()` instead.
      *
-     * Note: graph execution caps at the tenant IPC timeout (currently 4 minutes).
-     *
-     * @param options Initial state and optional thread to run against.
+     * @param options Initial state, optional thread to run against, and optional timeout and context of the run.
      */
     invoke(options?: InvokeLangGraphOptions): Promise<InvokeLangGraphSuccessResult>;
     /**
@@ -24,31 +22,27 @@ export declare class LangGraphReference {
      *
      * Use this for graphs that may run longer than is comfortable to hold a Promise for.
      *
-     * Note: the underlying graph execution still caps at the tenant IPC timeout (currently 4 minutes)
-     *
-     * @param options Initial state and optional thread to run against.
+     * @param options Initial state, optional thread to run against, and optional timeout and context of the run.
      */
     invokeAsync(options?: InvokeLangGraphOptions): Promise<JobId>;
     /**
      * Resumes an interrupted LangGraph thread and waits for the result.
      * The thread must currently be in `interrupted` status.
      *
-     * Note: graph execution caps at the tenant IPC timeout (currently 4 minutes).
-     *
      * @param threadId The thread to resume.
      * @param resumePayload Value passed to the `interrupt()` call inside the graph.
+     * @param options Optional timeout and context of the resumed run.
      */
-    resume(threadId: string, resumePayload: unknown): Promise<InvokeLangGraphSuccessResult>;
+    resume(threadId: string, resumePayload: unknown, options?: ResumeLangGraphOptions): Promise<InvokeLangGraphSuccessResult>;
     /**
      * Resumes an interrupted LangGraph thread without waiting for the result.
      * Returns a jobId — pass it to `squid.job().awaitJob(jobId)` or `getJob(jobId)` to retrieve the result later.
      *
-     * Note: graph execution caps at the tenant IPC timeout (currently 4 minutes)
-     *
      * @param threadId The thread to resume.
      * @param resumePayload Value passed to the `interrupt()` call inside the graph.
+     * @param options Optional timeout and context of the resumed run.
      */
-    resumeAsync(threadId: string, resumePayload: unknown): Promise<JobId>;
+    resumeAsync(threadId: string, resumePayload: unknown, options?: ResumeLangGraphOptions): Promise<JobId>;
     /** Returns the current state of a LangGraph thread. */
     getState(threadId: string): Promise<GetLangGraphStateSuccessResult>;
     /**

package/dist/typescript-client/src/version.d.ts

@@ -2,4 +2,4 @@
  * The current version of the SquidCloud client package.
  * @category Platform
  */
-export declare const SQUIDCLOUD_CLIENT_PACKAGE_VERSION = "1.0.497";
+export declare const SQUIDCLOUD_CLIENT_PACKAGE_VERSION = "1.0.499";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/client",
-  "version": "1.0.497",
+  "version": "1.0.499",
   "description": "A typescript implementation of the Squid client",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",