@squidcloud/client 1.0.419 → 1.0.421

package/dist/internal-common/src/public-types/ai-agent-integrations.public-types.d.ts

@@ -17,3 +17,19 @@ export interface AiAgentDatabaseIntegrationOptions {
     /** If provided, this agent will be used to generate the query. */
     generateQueryAgentId?: AiAgentId;
 }
+/**
+ * Configuration options for AI agent API integration.
+ */
+export interface AiAgentApiIntegrationOptions {
+    /**
+     * A list of API operation IDs (endpoint IDs) that the AI agent can call.
+     *
+     * When this list is not provided (i.e., it is `undefined`) or is empty,
+     * the AI agent has access to all operations.
+     */
+    operationsToUse?: string[];
+    /** If true, provides more detailed status updates during API call execution. Default: false. */
+    verboseStatusUpdates?: boolean;
+    /** If provided, this agent will be used to generate API calls. */
+    generateApiCallAgentId?: AiAgentId;
+}

package/dist/internal-common/src/public-types/ai-agent.public-types.d.ts

@@ -1,3 +1,4 @@
+import { JSONSchema } from 'json-schema-typed';
 import { AiAudioCreateSpeechModelName, AiAudioTranscriptionModelName, AiChatModelName, AiEmbeddingsModelName, AiImageModelName, AiProviderType, AiRerankProvider, AnthropicChatModelName, GeminiChatModelName, GrokChatModelName, OpenAiAudioCreateSpeechModelName, OpenAiAudioTranscriptionModelName, OpenAiChatModelName, OpenAiCreateSpeechFormat } from './ai-common.public-types';
 import { AiContextMetadata, AiContextMetadataFilter, AiKnowledgeBaseContextType, AiRagType } from './ai-knowledge-base.public-types';
 import { AiFunctionId, AiFunctionIdWithContext, UserAiChatModelName } from './backend.public-types';
@@ -146,9 +147,76 @@ export interface StableDiffusionCoreOptions extends BaseAiGenerateImageOptions {
  */
 export type ApiKeySource = 'user' | 'system';
 /**
+ * Structured output format configuration for AI models that support schema-constrained responses.
+ *
+ * When used with supported Anthropic models (claude-sonnet-4-5-20250929, claude-opus-4-1-20250805),
+ * this guarantees that responses will strictly conform to the provided JSON schema through
+ * constrained decoding - the model cannot generate tokens that violate the schema.
+ *
+ * **Example:**
+ * ```typescript
+ * {
+ *   type: 'json_schema',
+ *   schema: {
+ *     type: 'object',
+ *     properties: {
+ *       name: { type: 'string' },
+ *       age: { type: 'number' }
+ *     },
+ *     required: ['name', 'age'],
+ *     additionalProperties: false
+ *   }
+ * }
+ * ```
+ *
+ * @see https://docs.anthropic.com/en/docs/build-with-claude/structured-outputs
  * @category AI
  */
-export type AiAgentResponseFormat = 'text' | 'json_object';
+export interface AiStructuredOutputFormat {
+    /**
+     * The type of structured output.
+     * Currently only 'json_schema' is supported by Anthropic models.
+     */
+    type: 'json_schema';
+    /**
+     * The JSON schema that the AI response must strictly conform to.
+     * Uses constrained decoding to guarantee schema compliance.
+     */
+    schema: JSONSchema;
+}
+/**
+ * Response format for AI agent responses.
+ *
+ * **Available formats:**
+ * - `'text'`: Plain text response (default) - standard conversational output
+ * - `'json_object'`: JSON response - model attempts to return valid JSON, but without strict schema validation
+ * - `AiStructuredOutputFormat`: Structured output with schema (Anthropic only) - guarantees JSON conforms exactly to provided schema
+ *
+ * **Structured outputs (Anthropic-specific):**
+ * For Anthropic models that support structured outputs, you can pass an object with `type: 'json_schema'`
+ * and a JSON schema. This uses constrained decoding to guarantee the response matches your schema perfectly,
+ * eliminating parsing errors and validation issues.
+ *
+ * **Example with structured output:**
+ * ```typescript
+ * {
+ *   responseFormat: {
+ *     type: 'json_schema',
+ *     schema: {
+ *       type: 'object',
+ *       properties: {
+ *         sentiment: { type: 'string', enum: ['positive', 'negative', 'neutral'] },
+ *         confidence: { type: 'number', minimum: 0, maximum: 1 }
+ *       },
+ *       required: ['sentiment', 'confidence']
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @category AI
+ */
+export type AiAgentResponseFormat = 'text' | 'json_object' | AiStructuredOutputFormat;
 /**
  * @category AI
  */
@@ -429,6 +497,32 @@ export type AiReasoningEffort = 'minimal' | 'low' | 'medium' | 'high';
 export type AiVerbosityLevel = 'low' | 'medium' | 'high';
 /**
  * Chat options specific to Anthropic models, extending base options.
+ *
+ * **Structured Outputs:**
+ * Anthropic models (claude-sonnet-4-5-20250929, claude-opus-4-1-20250805) support structured outputs
+ * through the `responseFormat` field. Pass an object with `type: 'json_schema'` and a JSON schema
+ * to guarantee the response conforms exactly to your schema.
+ *
+ * **Example:**
+ * ```typescript
+ * {
+ *   model: 'claude-sonnet-4-5-20250929',
+ *   responseFormat: {
+ *     type: 'json_schema',
+ *     schema: {
+ *       type: 'object',
+ *       properties: {
+ *         name: { type: 'string' },
+ *         age: { type: 'number' }
+ *       },
+ *       required: ['name', 'age'],
+ *       additionalProperties: false
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @see https://docs.anthropic.com/en/docs/build-with-claude/structured-outputs
  * @category AI
  */
 export interface AnthropicChatOptions extends BaseAiChatOptions {
@@ -764,4 +858,42 @@ export type AiSessionContext = {
     /** The ID of the job associated with the session. */
     jobId: JobId;
 };
+/**
+ * API request to delete an AI agent
+ * @category AI
+ */
+export interface DeleteAgentRequest {
+    /** The ID of the agent to delete */
+    agentId: string;
+}
+/**
+ * API response from agent ask methods
+ * @category AI
+ */
+export interface AiAskResponse {
+    /** The response string from the agent */
+    responseString: string;
+    /** Optional annotations (e.g., file references) in the response */
+    annotations?: Record<string, AiAnnotation>;
+}
+/**
+ * API request to create speech from text
+ * @category AI
+ */
+export interface AiAudioCreateSpeechRequest {
+    /** The text input to convert to speech */
+    input: string;
+    /** Options for speech generation */
+    options: AiAudioCreateSpeechOptions;
+}
+/**
+ * API request to generate an image
+ * @category AI
+ */
+export interface AiGenerateImageRequest {
+    /** The prompt describing the image to generate */
+    prompt: string;
+    /** Options for image generation */
+    options?: AiGenerateImageOptions;
+}
 export {};

package/dist/internal-common/src/public-types/ai-assistant.public-types.d.ts

@@ -1,6 +1,11 @@
-import { AiAgentResponseFormat, AiReasoningEffort } from './ai-agent.public-types';
+import { AiReasoningEffort } from './ai-agent.public-types';
 import { OpenAiChatModelName } from './ai-common.public-types';
 import { AiFunctionId } from './backend.public-types';
+/**
+ * Response format for AI assistant responses.
+ * @category AI
+ */
+export type AiAssistantResponseFormat = 'text' | 'json_object';
 /**
  * The type of assistant tool.
  * @category AI
@@ -16,7 +21,7 @@ export interface QueryAssistantOptions {
     /** Specific context provided per AI function, keyed by function ID. */
     functionContexts?: Record<AiFunctionId, Record<string, unknown>>;
     /** The desired format of the AI model's response; defaults to 'text'. */
-    responseFormat?: AiAgentResponseFormat;
+    responseFormat?: AiAssistantResponseFormat;
     /** The OpenAI chat model to use for the assistant, if specified. */
     model?: OpenAiChatModelName;
     /** The level of reasoning effort to apply, as defined by OpenAI. */

package/dist/internal-common/src/public-types/ai-common.public-types.d.ts

@@ -36,16 +36,16 @@ export declare const GEMINI_CHAT_MODEL_NAMES: readonly ["gemini-2.5-pro", "gemin
  *
  * @category AI
  */
-export declare const GROK_CHAT_MODEL_NAMES: readonly ["grok-3", "grok-3-fast", "grok-3-mini", "grok-3-mini-fast", "grok-4", "grok-4-fast-reasoning", "grok-4-fast-non-reasoning"];
+export declare const GROK_CHAT_MODEL_NAMES: readonly ["grok-3", "grok-3-fast", "grok-3-mini", "grok-3-mini-fast", "grok-4", "grok-4-fast-reasoning", "grok-4-fast-non-reasoning", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
 /**
  * @category AI
  */
-export declare const ANTHROPIC_CHAT_MODEL_NAMES: readonly ["claude-3-7-sonnet-latest", "claude-haiku-4-5-20251001", "claude-opus-4-20250514", "claude-opus-4-1-20250805", "claude-sonnet-4-20250514", "claude-sonnet-4-5-20250929"];
+export declare const ANTHROPIC_CHAT_MODEL_NAMES: readonly ["claude-3-7-sonnet-latest", "claude-haiku-4-5-20251001", "claude-opus-4-20250514", "claude-opus-4-1-20250805", "claude-opus-4-5-20251101", "claude-sonnet-4-20250514", "claude-sonnet-4-5-20250929"];
 /**
  * The supported AI model names.
  * @category AI
  */
-export declare const VENDOR_AI_CHAT_MODEL_NAMES: readonly ["o1", "o3", "o3-mini", "o4-mini", "gpt-5", "gpt-5-mini", "gpt-5-nano", "gpt-5.1", "gpt-4.1", "gpt-4.1-mini", "gpt-4.1-nano", "gpt-4o", "gpt-4o-mini", "claude-3-7-sonnet-latest", "claude-haiku-4-5-20251001", "claude-opus-4-20250514", "claude-opus-4-1-20250805", "claude-sonnet-4-20250514", "claude-sonnet-4-5-20250929", "gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite", "grok-3", "grok-3-fast", "grok-3-mini", "grok-3-mini-fast", "grok-4", "grok-4-fast-reasoning", "grok-4-fast-non-reasoning"];
+export declare const VENDOR_AI_CHAT_MODEL_NAMES: readonly ["o1", "o3", "o3-mini", "o4-mini", "gpt-5", "gpt-5-mini", "gpt-5-nano", "gpt-5.1", "gpt-4.1", "gpt-4.1-mini", "gpt-4.1-nano", "gpt-4o", "gpt-4o-mini", "claude-3-7-sonnet-latest", "claude-haiku-4-5-20251001", "claude-opus-4-20250514", "claude-opus-4-1-20250805", "claude-opus-4-5-20251101", "claude-sonnet-4-20250514", "claude-sonnet-4-5-20250929", "gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite", "grok-3", "grok-3-fast", "grok-3-mini", "grok-3-mini-fast", "grok-4", "grok-4-fast-reasoning", "grok-4-fast-non-reasoning", "grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning"];
 /**
  * Check if the given model name is a global AI chat model name.
  */

package/dist/internal-common/src/public-types/ai-knowledge-base.public-types.d.ts

@@ -386,4 +386,46 @@ export type AiKnowledgeBaseWithOptionalChatModel = Omit<AiKnowledgeBase, 'chatMo
     chatModel?: AiKnowledgeBase['chatModel'];
     name?: string;
 };
+/**
+ * API request for deleting an AiKnowledgeBase
+ * @category AI
+ */
+export interface DeleteAiKnowledgeBaseRequest {
+    /** The id of the AiKnowledgeBase */
+    id: string;
+}
+/**
+ * API request for upserting an AiKnowledgeBase
+ * @category AI
+ */
+export interface UpsertAiKnowledgeBaseRequest {
+    /** The AiKnowledgeBase to upsert */
+    knowledgeBase: Omit<AiKnowledgeBaseWithOptionalChatModel, 'appId' | 'updatedAt'>;
+}
+/**
+ * API request for deleting AiKnowledgeBaseContexts
+ * @category AI
+ */
+export interface DeleteAiKnowledgeBaseContextsRequest {
+    /** The id of the AiKnowledgeBase */
+    knowledgeBaseId: string;
+    /** An array of AiKnowledgeBaseContext ids */
+    contextIds: Array<string>;
+}
+/**
+ * API response to list AiKnowledgeBaseContexts
+ * @category AI
+ */
+export interface ListAiKnowledgeBaseContextsResponse {
+    /** The list of AiKnowledgeBaseContexts */
+    contexts: Array<AiKnowledgeBaseContext>;
+}
+/**
+ * API response for searching an AiKnowledgeBase
+ * @category AI
+ */
+export interface AiKnowledgeBaseSearchResponse {
+    /** Array of result chunks from the search */
+    chunks: Array<AiKnowledgeBaseSearchResultChunk>;
+}
 export {};

package/dist/internal-common/src/public-types/ai-matchmaking.public-types.d.ts

@@ -72,3 +72,115 @@ export interface MmListEntitiesOptions {
     /** The maximum number of entities to return; defaults to 100. */
     limit?: number;
 }
+/**
+ * API request to delete a matchmaker
+ * @category AI
+ */
+export interface MmDeleteMatchMakerRequest {
+    /** The ID of the matchmaker to delete */
+    matchMakerId: string;
+}
+/**
+ * API response for getting a matchmaker
+ * @category AI
+ */
+export interface MmGetMatchMakerResponse {
+    /** The matchmaker, if found */
+    matchMaker: MmMatchMaker | undefined;
+}
+/**
+ * API request to delete an entity
+ * @category AI
+ */
+export interface MmDeleteEntityRequest {
+    /** The ID of the matchmaker */
+    matchMakerId: string;
+    /** The ID of the entity to delete */
+    entityId: string;
+}
+/**
+ * API request to insert multiple entities
+ * @category AI
+ */
+export interface MmInsertEntitiesRequest {
+    /** The ID of the matchmaker */
+    matchMakerId: string;
+    /** Array of entities to insert */
+    entities: Array<MmEntity>;
+}
+/**
+ * API request to find matches for an entity
+ * @category AI
+ */
+export interface MmFindMatchesRequest {
+    /** The ID of the matchmaker */
+    matchMakerId: string;
+    /** The ID of the entity to find matches for */
+    entityId: string;
+    /** Options for finding matches */
+    options: MmFindMatchesOptions;
+}
+/**
+ * API response for finding matches
+ * @category AI
+ */
+export interface MmFindMatchesResponse {
+    /** Array of matching entities */
+    matches: Array<MmEntityMatch>;
+}
+/**
+ * API request to find matches for an entity not yet inserted
+ * @category AI
+ */
+export interface MmFindMatchesForEntityRequest {
+    /** The ID of the matchmaker */
+    matchMakerId: string;
+    /** The entity to find matches for */
+    entity: Omit<MmEntity, 'metadata' | 'id'>;
+    /** Options for finding matches */
+    options: MmFindMatchesOptions;
+}
+/**
+ * API response for finding matches for an entity
+ * @category AI
+ */
+export interface MmFindMatchesForEntityResponse {
+    /** Array of matching entities */
+    matches: Array<MmEntityMatch>;
+}
+/**
+ * API response for listing matchmakers
+ * @category AI
+ */
+export interface MmListMatchMakersResponse {
+    /** Array of matchmakers */
+    matchMakers: Array<MmMatchMaker>;
+}
+/**
+ * API request to list entities
+ * @category AI
+ */
+export interface MmListEntitiesRequest {
+    /** The ID of the matchmaker */
+    matchMakerId: string;
+    /** The ID of the category */
+    categoryId: string;
+    /** Options for listing entities */
+    options: MmListEntitiesOptions;
+}
+/**
+ * API response for listing entities
+ * @category AI
+ */
+export interface MmListEntitiesResponse {
+    /** Array of entities */
+    entities: Array<MmEntity>;
+}
+/**
+ * API response for getting an entity
+ * @category AI
+ */
+export interface MmGetEntityResponse {
+    /** The entity, if found */
+    entity: MmEntity | undefined;
+}

package/dist/internal-common/src/public-utils/id-utils.d.ts

@@ -13,8 +13,10 @@ export declare const DEFAULT_SHORT_ID_LENGTH = 18;
 /**
  * Generates an ID of the given `length` using lowercase latin letters and digits.
  * If the 'prefix' provided replaces the first generated characters with the prefix.
+ * If the 'prefixToAvoid' provided, ensures the generated ID does not start with this prefix.
+ * When both 'prefix' and 'prefixToAvoid' are provided, 'prefixToAvoid' must be longer than 'prefix'.
  */
-export declare function generateShortId(length?: number, prefix?: string): string;
+export declare function generateShortId(length?: number, prefix?: string, prefixToAvoid?: string): string;
 /**
  * Generates a set of unique IDs under the same behavior as `generateShortId`.
  *

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

@@ -7,7 +7,7 @@ import { AiFilesClient } from './ai-files-client';
 import { AiImageClient } from './ai-image-client';
 import { AiKnowledgeBaseReference } from './ai-knowledge-base/ai-knowledge-base-client-reference';
 import { AiMatchMakingClient } from './ai-matchmaking-client';
-import { AiAgent, AiAgentId, AiFileProviderType, AiKnowledgeBase, AiKnowledgeBaseId, AiProviderType, ApplicationAiSettings, IntegrationId, SecretKey } from './public-types';
+import { AiAgent, AiAgentId, AiFileProviderType, AiKnowledgeBase, AiKnowledgeBaseId, AiProviderType, AiSessionContext, ApplicationAiSettings, IntegrationId, SecretKey } from './public-types';
 /**
  * AiClient class serves as a facade for interacting with different AI services.
  * It provides simplified access to AI chatbot and assistant functionalities
@@ -102,7 +102,7 @@ export declare class AiClient {
      * Request to execute an AI-powered API call.
      * Allows specifying allowed endpoints and whether to provide an explanation.
      */
-    executeAiApiCall(integrationId: IntegrationId, prompt: string, allowedEndpoints?: string[], provideExplanation?: boolean): Promise<ExecuteAiApiResponse>;
+    executeAiApiCall(integrationId: IntegrationId, prompt: string, allowedEndpoints?: string[], provideExplanation?: boolean, generateApiCallAgentId?: AiAgentId, sessionContext?: AiSessionContext): Promise<ExecuteAiApiResponse>;
     /**
      * Returns name of the secret that stores API key for the given AI provider type.
      * This API key is used for all requests to the AI provider done from the application.

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.419";
+export declare const SQUIDCLOUD_CLIENT_PACKAGE_VERSION = "1.0.421";

package/package.json

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