@squidcloud/slack-client 1.0.420 → 1.0.421

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-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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/slack-client",
-  "version": "1.0.420",
+  "version": "1.0.421",
   "description": "Squid Slack Client",
   "main": "dist/index.js",
   "types": "dist/client/src/index.d.ts",
@@ -19,7 +19,7 @@
   "dependencies": {
     "assertic": "^1.3.0",
     "lodash": "^4.17.21",
-    "@squidcloud/client": "^1.0.420",
+    "@squidcloud/client": "^1.0.421",
     "@slack/bolt": "^4.5.0"
   },
   "engines": {