@squidcloud/slack-client 1.0.409

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

@@ -0,0 +1,172 @@
+import { UserAiChatModelName } from './backend.public-types';
+/**
+ * @category AI
+ */
+export declare const RERANK_PROVIDERS: readonly ["cohere", "none"];
+/**
+ * @category AI
+ */
+export type AiRerankProvider = (typeof RERANK_PROVIDERS)[number];
+/** List of available AI provider types. See AiProviderType. */
+export declare const AI_PROVIDER_TYPES: readonly ["anthropic", "flux", "gemini", "openai", "grok", "stability", "voyage", "external"];
+/**
+ * Type of the AI provider.
+ * References a single AI service, regardless of the model or other AI function it provides (like
+ * chat/search/transcribe etc...).
+ */
+export type AiProviderType = (typeof AI_PROVIDER_TYPES)[number];
+/**
+ * @category AI
+ */
+export declare const OPENAI_CHAT_MODEL_NAMES: readonly ["o1", "o3", "o3-mini", "o4-mini", "gpt-5", "gpt-5-mini", "gpt-5-nano", "gpt-4.1", "gpt-4.1-mini", "gpt-4.1-nano", "gpt-4o", "gpt-4o-mini"];
+/**
+ * @category AI
+ */
+export declare const GEMINI_CHAT_MODEL_NAMES: readonly ["gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.5-flash-lite"];
+/**
+ * Notes:
+ * - 'grok-3-mini' model os ~10x less expensive than 'grok-3'.
+ * - '*-fast' models are ~2x more expensive than non-fast variants and only marginally faster.
+ * - 'grok-4' cost is comparable to 'grok-3-fast'.
+ *
+ * @category AI
+ */
+export declare const GROK_CHAT_MODEL_NAMES: readonly ["grok-3", "grok-3-fast", "grok-3-mini", "grok-3-mini-fast", "grok-4"];
+/**
+ * @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"];
+/**
+ * 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-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"];
+/**
+ * Check if the given model name is a global AI chat model name.
+ */
+export declare function isVendorAiChatModelName(modelName: string): modelName is (typeof VENDOR_AI_CHAT_MODEL_NAMES)[number];
+/**
+ * @category AI
+ */
+export declare const OPENAI_EMBEDDINGS_MODEL_NAMES: readonly ["text-embedding-3-small"];
+/**
+ * @category AI
+ */
+export declare const VOYAGE_EMBEDDING_MODEL_NAMES: readonly ["voyage-3-large"];
+/**
+ * @category AI
+ */
+export declare const AI_EMBEDDINGS_MODEL_NAMES: readonly ["text-embedding-3-small", "voyage-3-large"];
+/**
+ * The supported AI image generation model names.
+ * @category AI
+ */
+export declare const OPENAI_IMAGE_MODEL_NAMES: readonly ["dall-e-3"];
+/**
+ * @category AI
+ */
+export declare const OPENAI_AUDIO_TRANSCRIPTION_MODEL_NAMES: readonly ["whisper-1", "gpt-4o-transcribe", "gpt-4o-mini-transcribe"];
+/**
+ * @category AI
+ */
+export declare const OPENAI_AUDIO_CREATE_SPEECH_MODEL_NAMES: readonly ["tts-1", "tts-1-hd", "gpt-4o-mini-tts"];
+/**
+ * @category AI
+ */
+export declare const OPENAI_AUDIO_MODEL_NAMES: readonly ["whisper-1", "gpt-4o-transcribe", "gpt-4o-mini-transcribe", "tts-1", "tts-1-hd", "gpt-4o-mini-tts"];
+/**
+ * @category AI
+ */
+export declare const STABLE_DIFFUSION_MODEL_NAMES: readonly ["stable-diffusion-core"];
+/**
+ * @category AI
+ */
+export declare const FLUX_MODEL_NAMES: readonly ["flux-pro-1.1", "flux-kontext-pro"];
+/**
+ * @category AI
+ */
+export declare const AI_IMAGE_MODEL_NAMES: readonly ["dall-e-3", "stable-diffusion-core", "flux-pro-1.1", "flux-kontext-pro"];
+/**
+ * @category AI
+ */
+export declare const AI_AUDIO_TRANSCRIPTION_MODEL_NAMES: readonly ["whisper-1", "gpt-4o-transcribe", "gpt-4o-mini-transcribe"];
+/**
+ * @category AI
+ */
+export declare const AI_AUDIO_CREATE_SPEECH_MODEL_NAMES: readonly ["tts-1", "tts-1-hd", "gpt-4o-mini-tts"];
+/**
+ * @category AI
+ */
+export declare const OPEN_AI_CREATE_SPEECH_FORMATS: readonly ["mp3", "opus", "aac", "flac", "wav", "pcm"];
+/**
+ * @category AI
+ */
+export type VendorAiChatModelName = (typeof VENDOR_AI_CHAT_MODEL_NAMES)[number];
+/**
+ * @category AI
+ */
+export type AiChatModelName = VendorAiChatModelName | UserAiChatModelName;
+/**
+ * @category AI
+ */
+export type AiEmbeddingsModelName = (typeof AI_EMBEDDINGS_MODEL_NAMES)[number];
+/**
+ * @category AI
+ */
+export type AiVoyageEmbeddingsModelName = (typeof VOYAGE_EMBEDDING_MODEL_NAMES)[number];
+/**
+ * @category AI
+ */
+export type OpenAiChatModelName = (typeof OPENAI_CHAT_MODEL_NAMES)[number];
+/**
+ * @category AI
+ */
+export type GeminiChatModelName = (typeof GEMINI_CHAT_MODEL_NAMES)[number];
+/**
+ * @category AI
+ */
+export type GrokChatModelName = (typeof GROK_CHAT_MODEL_NAMES)[number];
+/**
+ * @category AI
+ */
+export type AnthropicChatModelName = (typeof ANTHROPIC_CHAT_MODEL_NAMES)[number];
+/**
+ * @category AI
+ */
+export type AiImageModelName = (typeof AI_IMAGE_MODEL_NAMES)[number];
+/**
+ * @category AI
+ */
+export type AiAudioTranscriptionModelName = (typeof AI_AUDIO_TRANSCRIPTION_MODEL_NAMES)[number];
+/**
+ * @category AI
+ */
+export type AiAudioCreateSpeechModelName = (typeof OPENAI_AUDIO_CREATE_SPEECH_MODEL_NAMES)[number];
+/**
+ * @category AI
+ */
+export type AiAudioModelName = (typeof OPENAI_AUDIO_MODEL_NAMES)[number];
+/**
+ * @category AI
+ */
+export type OpenAiImageModelName = (typeof OPENAI_IMAGE_MODEL_NAMES)[number];
+/**
+ * @category AI
+ */
+export type OpenAiAudioTranscriptionModelName = (typeof OPENAI_AUDIO_TRANSCRIPTION_MODEL_NAMES)[number];
+/**
+ * @category AI
+ */
+export type OpenAiAudioCreateSpeechModelName = (typeof OPENAI_AUDIO_CREATE_SPEECH_MODEL_NAMES)[number];
+/**
+ * @category AI
+ */
+export type OpenAiCreateSpeechFormat = (typeof OPEN_AI_CREATE_SPEECH_FORMATS)[number];
+/**
+ * @category AI
+ */
+export type StableDiffusionModelName = (typeof STABLE_DIFFUSION_MODEL_NAMES)[number];
+/**
+ * @category AI
+ */
+export type FluxModelName = (typeof FLUX_MODEL_NAMES)[number];

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

@@ -0,0 +1,387 @@
+import { AgentContextRequest, UpsertContextStatusError } from './ai-agent.public-types';
+import { AiChatModelName, AiEmbeddingsModelName, AiRerankProvider } from './ai-common.public-types';
+import { AiContextId, AiKnowledgeBaseId, AppId } from './communication.public-types';
+import { DocumentExtractionMethod } from './extraction.public-types';
+/**
+ * Represents an AI knowledge base that can be attached to an AI agent.
+ * @category AI
+ */
+export interface AiKnowledgeBase {
+    /** The unique identifier of the knowledge base.*/
+    id: AiKnowledgeBaseId;
+    /** The app id that the knowledge base belongs to. */
+    appId: AppId;
+    /** The user's description of the knowledge base */
+    description: string;
+    /** A set of predefined metadata fields for the knowledge base that can be used for filtering.*/
+    metadataFields: Array<AiKnowledgeBaseMetadataField>;
+    /** The embedding model name that should be used for this knowledge base.*/
+    embeddingModel: AiEmbeddingsModelName;
+    /** The model name that should be used when asking questions of this knowledge base. */
+    chatModel: AiChatModelName;
+    /** The timestamp the knowledge base was last updated */
+    updatedAt: Date;
+}
+/**
+ * Represents a field in an AI knowledge base metadata.
+ */
+export interface AiKnowledgeBaseMetadataField {
+    /** The name of field.*/
+    name: string;
+    /** The field data type - used for filtering. For array, only array of strings is supported. */
+    dataType: 'string' | 'number' | 'boolean' | 'date' | 'array';
+    /** Indicates if the field is required for knowledge base entries.*/
+    required: boolean;
+    /**
+     * In case that the field is required and not provided when uploaded to the knowledge base,
+     * this description will be used for extracting the value from the document.
+     * Also, it will be used for auto filtering when a prompt is sent to an AI agent.
+     */
+    description?: string;
+}
+/**
+ * A record of metadata key-value pairs for AI context, where values are primitive types or undefined.
+ * @category AI
+ */
+export type AiContextMetadata = Record<string, AiContextMetadataValue>;
+/**
+ * @category AI
+ */
+export type AiContextMetadataValue = number | string | boolean | undefined;
+/**
+ * @category AI
+ */
+export type AiContextMetadataValueArray = AiContextMetadataValue[];
+interface AiContextMetadataEqFilter {
+    $eq: AiContextMetadataValue;
+}
+interface AiContextMetadataNeFilter {
+    $ne: AiContextMetadataValue;
+}
+interface AiContextMetadataGtFilter {
+    $gt: number;
+}
+interface AiContextMetadataGteFilter {
+    $gte: number;
+}
+interface AiContextMetadataLtFilter {
+    $lt: number;
+}
+interface AiContextMetadataLteFilter {
+    $lte: number;
+}
+interface AiContextMetadataInFilter {
+    $in: AiContextMetadataValueArray;
+}
+interface AiContextMetadataNinFilter {
+    $nin: AiContextMetadataValueArray;
+}
+interface AiContextMetadataExistsFilter {
+    $exists: boolean;
+}
+/**
+ * @category AI
+ */
+export type AiContextMetadataSimpleFilter = AiContextMetadataEqFilter | AiContextMetadataNeFilter | AiContextMetadataGtFilter | AiContextMetadataGteFilter | AiContextMetadataLtFilter | AiContextMetadataLteFilter | AiContextMetadataInFilter | AiContextMetadataNinFilter | AiContextMetadataExistsFilter;
+/**
+ * A filter for AI context metadata based on field-specific conditions or values.
+ * @category AI
+ */
+export interface AiContextMetadataFieldFilter {
+    /** A record where keys are field names and values are either simple filters or direct metadata values. */
+    [field: string]: AiContextMetadataSimpleFilter | AiContextMetadataValue;
+}
+/**
+ * A filter combining multiple AI context metadata filters with a logical AND operation.
+ * @category AI
+ */
+export interface AiContextMetadataAndFilter {
+    /** An array of filters that must all be true for the condition to pass. */
+    $and: AiContextMetadataFilter[];
+}
+/**
+ * A filter combining multiple AI context metadata filters with a logical OR operation.
+ * @category AI
+ */
+export interface AiContextMetadataOrFilter {
+    /** An array of filters where at least one must be true for the condition to pass. */
+    $or: AiContextMetadataFilter[];
+}
+/**
+ * The options for the AI knowledgebase search method.
+ * @category AI
+ */
+export interface AiKnowledgeBaseChatOptions {
+    /** A set of filters that will limit the context the AI can access. */
+    contextMetadataFilter?: AiContextMetadataFilter;
+    /** Whether to include references from the source context in the response. Default to false. */
+    includeReference?: boolean;
+    /** Include metadata in the context */
+    includeMetadata?: boolean;
+    /** Which provider's reranker to use for reranking the context. Defaults to 'cohere'. */
+    rerankProvider?: AiRerankProvider;
+    /** The maximum number of results to return */
+    limit?: number;
+    /** How many chunks to look over. Defaults to 100 */
+    chunkLimit?: number;
+    /** Which chat model to use when asking the question */
+    chatModel?: AiChatModelName;
+}
+/**
+ * @category AI
+ */
+export type AiContextMetadataFilter = AiContextMetadataFieldFilter | AiContextMetadataAndFilter | AiContextMetadataOrFilter;
+/**
+ * Represents an AI knowledge base's context entry with metadata and content.
+ * @category AI
+ */
+export interface AiKnowledgeBaseContext {
+    /** The unique identifier of the context entry. */
+    id: string;
+    /** The knowledge base id of the context entry */
+    knowledgeBaseId: AiKnowledgeBaseId;
+    /** The date and time the context was created. */
+    createdAt: Date;
+    /** The date and time the context was last updated. */
+    updatedAt: Date;
+    /** The type of context (e.g., 'text' or 'file'). */
+    type: AiKnowledgeBaseContextType;
+    /** A title describing the context content. */
+    title: string;
+    /** The text content of the context. */
+    text: string;
+    /** Indicates whether the context is a preview; defaults to false. */
+    preview: boolean;
+    /** The size of the context content in bytes. */
+    sizeBytes: number;
+    /** Metadata associated with the context. */
+    metadata: AiContextMetadata;
+    /** Original request configuration for how the context content was processed. */
+    requestConfig?: AgentContextRequest;
+}
+/**
+ * @category AI
+ */
+export type AiKnowledgeBaseContextType = 'text' | 'file';
+/**
+ * @category AI
+ */
+export type AiKnowledgeBaseContextRequest = AiKnowledgeBaseTextContextRequest | AiKnowledgeBaseFileContextRequest;
+interface BaseAiKnowledgeBaseContextRequest {
+    contextId: string;
+    type: AiKnowledgeBaseContextType;
+    metadata?: AiContextMetadata;
+}
+/**
+ * Base options for upserting text content into the AI agent's context.
+ * @category AI
+ */
+export interface AiKnowledgeBaseContextTextOptions extends BaseAiKnowledgeBaseContextOptions {
+}
+/**
+ * Base options for upserting file content into the AI agent's context.
+ * @category AI
+ */
+export interface AiKnowledgeBaseContextFileOptions extends BaseAiKnowledgeBaseContextOptions {
+}
+/**
+ * Request structure for adding text-based context to an AI agent.
+ * @category AI
+ */
+export interface AiKnowledgeBaseTextContextRequest extends BaseAiKnowledgeBaseContextRequest {
+    /** The id of the context */
+    contextId: AiContextId;
+    /** Specifies the context type as 'text'. */
+    type: 'text';
+    /** A title for the text context. */
+    title: string;
+    /** The text content to add to the context. */
+    text: string;
+    /** General options for how to process the text. */
+    options?: AiKnowledgeBaseContextTextOptions;
+}
+/**
+ * Request structure for adding file-based context to an AI agent.
+ * @category AI
+ */
+export interface AiKnowledgeBaseFileContextRequest extends BaseAiKnowledgeBaseContextRequest {
+    /** The id of the context */
+    contextId: AiContextId;
+    /** Specifies the context type as 'file'. */
+    type: 'file';
+    /** Whether to extract images from the file; defaults to false. */
+    extractImages?: boolean;
+    /** The minimum size for extracted images, if applicable. */
+    imageMinSizePixels?: number;
+    /** The AI model to use for extraction, if specified. */
+    imageExtractionModel?: AiChatModelName;
+    /** General options for how to process the file. */
+    options?: AiKnowledgeBaseContextFileOptions;
+    /** The preferred method for extracting data from the document. */
+    preferredExtractionMethod?: DocumentExtractionMethod;
+    /**
+     * Whether Squid keeps or discards the original file.
+     *
+     * Keeping the original file allows reprocessing and the ability for the user to download it later.
+     *
+     * Defaults to false.
+     */
+    discardOriginalFile?: boolean;
+}
+/**
+ * @category AI
+ */
+export declare const RAG_TYPES: readonly ["contextual", "basic"];
+/**
+ * @category AI
+ */
+export type AiRagType = (typeof RAG_TYPES)[number];
+/**
+ * Base options for how to deal with the content being upserted.
+ * @category AI
+ */
+export type BaseAiKnowledgeBaseContextOptions = {
+    /** The type of RAG to use for the content. */
+    ragType?: AiRagType;
+    /** Amount of chunk overlap, in characters. */
+    chunkOverlap?: number;
+};
+/**
+ * Specific options for the AI knowledgebase search method.
+ * @category AI
+ */
+export interface AiKnowledgeBaseSearchOptions {
+    /** The prompt to search for */
+    prompt: string;
+    /** The maximum number of results to return */
+    limit?: number;
+    /** Which provider's reranker to use for reranking the context. Defaults to 'cohere'. */
+    rerankProvider?: AiRerankProvider;
+    /** How many chunks to look over. Defaults to 100 */
+    chunkLimit?: number;
+    /** Which chat model to use when asking the question */
+    chatModel?: string;
+}
+/**
+ * A single chunk of data returned from an AI search operation.
+ * @category AI
+ */
+export interface AiKnowledgeBaseSearchResultChunk {
+    /** The unique identifier of the context. */
+    contextId: string;
+    /** The data content of the search result chunk. */
+    data: string;
+    /** Optional metadata associated with the chunk. */
+    metadata?: AiContextMetadata;
+    /** The relevance score of the chunk, indicating match quality. */
+    score: number;
+}
+/**
+ * Response structure for upserting context for an AiKnowledgeBase
+ * @category AI
+ */
+export interface UpsertKnowledgeBaseContextResponse {
+    /** List of the upsert status of each item sent in the request. */
+    failure?: UpsertContextStatusError;
+}
+/**
+ * Response structure for upserting contexts for an AiKnowledgeBase
+ * @category AI
+ */
+export interface UpsertKnowledgeBaseContextsResponse {
+    /** List of the upsert status of each item sent in the request. */
+    failures: Array<UpsertContextStatusError>;
+}
+/**
+ * Request structure for searching an AiKnowledgeBase
+ * @category AI
+ */
+export interface AiKnowledgeBaseSearchRequest {
+    /** The id of the AiKnowledgeBase */
+    knowledgeBaseId: string;
+    /** The user prompt to search on */
+    prompt: string;
+    /** The search options for this search */
+    options: AiKnowledgeBaseSearchOptions;
+}
+/**
+ * Request structure for searching AI contexts in the AiKnowledgeBase.
+ * @category AI
+ */
+export interface BaseAiKnowledgeBaseSearchContextsRequest {
+    /** The id of the AiKnowledgeBase */
+    knowledgeBaseId: AiKnowledgeBaseId;
+    /** The maximum number of results to return */
+    limit?: number;
+    /** A set of filters that will limit the context the AI can access. */
+    contextMetadataFilter?: AiContextMetadataFilter;
+    /** Whether to rerank the results with AI and provide reasoning - defaults to true */
+    rerank?: boolean;
+    /** Which chat model to use when doing reranking */
+    chatModel?: string;
+}
+/**
+ * Request structure for searching AI contexts in the AiKnowledgeBase with prompt.
+ * @category AI
+ */
+export interface AiKnowledgeBaseSearchContextsWithPromptRequest extends BaseAiKnowledgeBaseSearchContextsRequest {
+    /** The user prompt to search on */
+    prompt: string;
+}
+/**
+ * Request structure for searching AI contexts in the AiKnowledgeBase with an existing context.
+ * @category AI
+ */
+export interface AiKnowledgeBaseSearchContextsWithContextIdRequest extends BaseAiKnowledgeBaseSearchContextsRequest {
+    /** The contextId to search with */
+    contextId: string;
+}
+/**
+ * A context with reasoning and matching score.
+ * @category AI
+ */
+export interface AiKnowledgeBaseContextWithReasoning {
+    /** The actual context */
+    context: AiKnowledgeBaseContext;
+    /** The reasoning behind why this context was matched - can be undefined if no reasoning was requested */
+    reasoning?: string;
+    /** The score of the match, ranging from 0 to 100, where 100 is the best match. */
+    score: number;
+}
+/**
+ * Response structure for searching contexts in an AiKnowledgeBase.
+ * @category AI
+ */
+export interface AiKnowledgeBaseSearchContextsResponse {
+    /** The resulting contexts, with reasoning if it was requested */
+    results: Array<AiKnowledgeBaseContextWithReasoning>;
+}
+/**
+ * Request structure for requesting a download link to the context file that you previously provided.
+ * @category AI
+ */
+export interface AiKnowledgeBaseDownloadContextRequest {
+    /** The id of the AiKnowledgeBase */
+    knowledgeBaseId: string;
+    /** The id of the particular AiKnowledgeBaseContext */
+    contextId: string;
+}
+/**
+ * Response structure with the URL to download the specified context.
+ *
+ * Can be undefined if the file is not available in Squid.
+ * @category AI
+ */
+export interface AiKnowledgeBaseDownloadContextResponse {
+    /** The URL to download the file, if available. */
+    url?: string;
+}
+/**
+ * KnowledgeBase with optional chatModel param, used during upsert
+ * @category AI
+ */
+export type AiKnowledgeBaseWithOptionalChatModel = Omit<AiKnowledgeBase, 'chatModel'> & {
+    chatModel?: AiKnowledgeBase['chatModel'];
+    name?: string;
+};
+export {};

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

@@ -0,0 +1,50 @@
+/** Backend related public types that should be available on the client SDK */
+/** A type alias for a string that represents an AI function ID. */
+export type AiFunctionId = string;
+/** A type alias for a string that represents an AI functions configurator ID. */
+export type AiFunctionsConfiguratorId = string;
+/**
+ * A type alias for a service identifier.
+ * @category Queue
+ */
+export type TopicName = string;
+/** A type alias for a service class name. */
+export type ServiceName = string;
+/** A type alias for a function name within a service. */
+export type FunctionName = string;
+/**
+ * Function name with contextual data, where the data must be serializable as JSON.
+ */
+export interface AiFunctionIdWithContext {
+    /**
+     * The ID of the AI function as described in @aiFunction decorator.
+     * Historically named as 'name' because AI function name is the default value for 'ID'.
+     */
+    name: AiFunctionId;
+    /** A record of contextual data associated with the function call. */
+    context?: Record<string, unknown>;
+    /** A list of predefined parameter values for the AI function. These parameters are hidden from the AI. */
+    predefinedParameters?: Record<string, unknown>;
+}
+/**
+ * A combined service and function name in the format 'ServiceName:FunctionName'.
+ * Uniquely identifies a function within a service.
+ */
+export type ServiceFunctionName = `${ServiceName}:${FunctionName}`;
+/**
+ * LLM model name for use in API calls, eg. "gpt-4o-mini".
+ */
+export type UserAiChatModelName = string;
+/**
+ * Stats about a given LLM model.
+ */
+export type LlmModelMetadata = {
+    /**
+     * A friendly name for the model, to display in UIs.
+     */
+    displayName: string;
+    /** Maximum tokens the model can generate in a single response. */
+    maxOutputTokens: number;
+    /** Total context window size: input (aka prompt) + output (aka completion) tokens combined. */
+    contextWindowTokens: number;
+};

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

@@ -0,0 +1,30 @@
+/** A type alias for an application id. */
+export type AppId = string;
+/** A tuple of environment identifiers like 'dev' or 'prod'. */
+export declare const ENVIRONMENT_IDS: readonly ["dev", "prod"];
+/** A type representing valid environment identifiers derived from ENVIRONMENT_IDS. */
+export type EnvironmentId = (typeof ENVIRONMENT_IDS)[number];
+/** A type alias for a squid developer identifier. */
+export type SquidDeveloperId = string;
+/** A type alias for an integration id. */
+export type IntegrationId = string;
+/** A type alias for a client identifier. */
+export type ClientId = string;
+/** A type alias for a squid document identifier. */
+export type SquidDocId = string;
+/** A type alias for a client request identifier. */
+export type ClientRequestId = string;
+/** ID of AI agent. Also known as AI profile id. */
+export type AiAgentId = string;
+/** App-level ID of AI Knowledge Base */
+export type AiKnowledgeBaseId = string;
+/**
+ * The built-in agent id. Cannot be customized.
+ * @category AI
+ */
+export declare const BUILT_IN_AGENT_ID = "built_in_agent";
+/**
+ * A type alias for an AI context identifier.
+ * @category AI
+ */
+export type AiContextId = string;