@meetkai/mka1 0.49.2 → 0.49.4

package/src/models/components/createvectorstorefilebatchrequest.ts

@@ -32,7 +32,7 @@ export type CreateVectorStoreFileBatchRequestAttributes =
   | number;
 
 /**
- * Global chunking strategy to apply to all files if using 'file_ids'. Ignored if using 'files'.
+ * Batch-wide default chunking strategy, applied to every file that does not carry its own (a 'files' entry's chunking_strategy overrides this).
  */
 export type CreateVectorStoreFileBatchRequestChunkingStrategy =
   | AutoChunkingStrategy
@@ -47,15 +47,15 @@ export type CreateVectorStoreFileBatchRequest = {
    */
   fileIds?: Array<string> | undefined;
   /**
-   * A list of objects that each include a file_id plus optional attributes or chunking_strategy. Use this when you need to override metadata for specific files. The global attributes or chunking_strategy will be ignored. Mutually exclusive with 'file_ids'. At most 500 per batch.
+   * A list of objects that each include a file_id plus optional attributes or chunking_strategy. Use this when you need to override metadata for specific files. Entries without their own attributes or chunking_strategy fall back to the request-level values. Mutually exclusive with 'file_ids'. At most 500 per batch.
    */
   files?: Array<FileWithMetadata> | undefined;
   /**
-   * Global attributes to apply to all files if using 'file_ids'. Ignored if using 'files'.
+   * Batch-wide default attributes, applied to every file that does not carry its own (a 'files' entry's attributes override this).
    */
   attributes?: { [k: string]: string | boolean | number } | undefined;
   /**
-   * Global chunking strategy to apply to all files if using 'file_ids'. Ignored if using 'files'.
+   * Batch-wide default chunking strategy, applied to every file that does not carry its own (a 'files' entry's chunking_strategy overrides this).
    */
   chunkingStrategy?: AutoChunkingStrategy | StaticChunkingStrategy | undefined;
 };

package/src/react-query/agentConnectorsCreateAgentConnector.ts

@@ -51,7 +51,7 @@ export type AgentConnectorsCreateAgentConnectorMutationError =
  * Create a connector
  *
  * @remarks
- * Connects the agent to a Telegram bot, validates the bot token, and registers the agent's webhook. An API key with every listed scope is required; its identity tuple and current scopes are stored as a non-widening ceiling, then revalidated with mk-authentication before every connector run; session and delegated end-user contexts are rejected. The required access policy controls which Telegram chats may invoke the agent.
+ * Connects the agent to a Telegram bot, validates the bot token, and registers the agent's webhook. Telegram text, photos, and gateway-supported documents can invoke the agent; inbound media additionally requires write:files. Managed outbound files require read:files, and generated images require both file scopes so their transient provider URLs can be materialized before delivery. These conditional scopes are deliberately not part of x-required-scopes because text-only connectors do not need them. An API key with every listed scope is required; its identity tuple and current scopes are stored as a non-widening ceiling, then revalidated with mk-authentication before every connector run; session and delegated end-user contexts are rejected. The required access policy controls which Telegram chats may invoke the agent.
  */
 export function useAgentConnectorsCreateAgentConnectorMutation(
   options?: MutationHookOptions<

package/src/sdk/agentconnectors.ts

@@ -34,7 +34,7 @@ export class AgentConnectors extends ClientSDK {
    * Create a connector
    *
    * @remarks
-   * Connects the agent to a Telegram bot, validates the bot token, and registers the agent's webhook. An API key with every listed scope is required; its identity tuple and current scopes are stored as a non-widening ceiling, then revalidated with mk-authentication before every connector run; session and delegated end-user contexts are rejected. The required access policy controls which Telegram chats may invoke the agent.
+   * Connects the agent to a Telegram bot, validates the bot token, and registers the agent's webhook. Telegram text, photos, and gateway-supported documents can invoke the agent; inbound media additionally requires write:files. Managed outbound files require read:files, and generated images require both file scopes so their transient provider URLs can be materialized before delivery. These conditional scopes are deliberately not part of x-required-scopes because text-only connectors do not need them. An API key with every listed scope is required; its identity tuple and current scopes are stored as a non-widening ceiling, then revalidated with mk-authentication before every connector run; session and delegated end-user contexts are rejected. The required access policy controls which Telegram chats may invoke the agent.
    */
   async createAgentConnector(
     request: operations.CreateAgentConnectorRequest,