@meetkai/mka1 0.54.77 → 0.54.79

package/src/funcs/llmVectorStoresCreateFile.ts

@@ -30,7 +30,7 @@ import { Result } from "../types/fp.js";
  * Add a file to a vector store
  *
  * @remarks
- * Adds a file to a vector store for semantic search indexing.
+ * Adds a file to a vector store for semantic search indexing. Returns 410 once the vector store has expired.
  *
  * If set, this operation will use {@link Security.bearerAuth} from the global security.
  */

package/src/funcs/llmVectorStoresCreateFileBatch.ts

@@ -30,7 +30,7 @@ import { Result } from "../types/fp.js";
  * Batch add multiple files to vector store
  *
  * @remarks
- * Adds multiple files to a vector store in a single batch operation.
+ * Adds multiple files to a vector store in a single batch operation. Returns 410 once the vector store has expired.
  *
  * If set, this operation will use {@link Security.bearerAuth} from the global security.
  */

package/src/funcs/llmVectorStoresDeleteFile.ts

@@ -30,7 +30,7 @@ import { Result } from "../types/fp.js";
  * Remove file from vector store
  *
  * @remarks
- * Removes a file from a vector store and deletes its associated embeddings. If the file is no longer attached but the vector store still holds embeddings for it (for example, left behind by an earlier file deletion), those embeddings are deleted and the request succeeds, provided the file was deleted or you can read it; otherwise, and when there is nothing to remove, returns 404. Returns 409 if the file keeps being added back to the vector store while it is being removed; retrying completes the removal.
+ * Removes a file from a vector store and deletes its associated embeddings. If the file is no longer attached but the vector store still holds embeddings for it (for example, left behind by an earlier file deletion), those embeddings are deleted and the request succeeds, provided the file was deleted or you can read it; otherwise, and when there is nothing to remove, returns 404. Returns 409 if the file keeps being added back to the vector store while it is being removed; retrying completes the removal. Returns 410 once the vector store has expired.
  *
  * If set, this operation will use {@link Security.bearerAuth} from the global security.
  */

package/src/funcs/llmVectorStoresGet.ts

@@ -30,7 +30,7 @@ import { Result } from "../types/fp.js";
  * Retrieve a vector store
  *
  * @remarks
- * Retrieves a vector store by its ID.
+ * Retrieves a vector store by its ID. Returns 410 once the vector store has expired.
  *
  * If set, this operation will use {@link Security.bearerAuth} from the global security.
  */

package/src/funcs/llmVectorStoresGetFile.ts

@@ -30,7 +30,7 @@ import { Result } from "../types/fp.js";
  * Retrieve a vector store file
  *
  * @remarks
- * Retrieves detailed information about a specific file within a vector store.
+ * Retrieves detailed information about a specific file within a vector store. Returns 410 once the vector store has expired.
  *
  * If set, this operation will use {@link Security.bearerAuth} from the global security.
  */

package/src/funcs/llmVectorStoresGetFileBatch.ts

@@ -30,7 +30,7 @@ import { Result } from "../types/fp.js";
  * Retrieve file batch status
  *
  * @remarks
- * Retrieves the status of a specific file batch operation within a vector store.
+ * Retrieves the status of a specific file batch operation within a vector store. Returns 410 once the vector store has expired.
  *
  * If set, this operation will use {@link Security.bearerAuth} from the global security.
  */

package/src/funcs/llmVectorStoresGetFileContent.ts

@@ -30,7 +30,7 @@ import { Result } from "../types/fp.js";
  * Retrieve parsed file content
  *
  * @remarks
- * Retrieves the complete parsed contents of a file within a vector store.
+ * Retrieves the complete parsed contents of a file within a vector store. Returns 410 once the vector store has expired.
  *
  * If set, this operation will use {@link Security.bearerAuth} from the global security.
  */

package/src/funcs/llmVectorStoresListFiles.ts

@@ -30,7 +30,7 @@ import { Result } from "../types/fp.js";
  * List files in a vector store
  *
  * @remarks
- * Retrieves a paginated list of all files in a specific vector store.
+ * Retrieves a paginated list of all files in a specific vector store. Returns 410 once the vector store has expired.
  *
  * If set, this operation will use {@link Security.bearerAuth} from the global security.
  */

package/src/funcs/llmVectorStoresListFilesInBatch.ts

@@ -30,7 +30,7 @@ import { Result } from "../types/fp.js";
  * List files in a batch
  *
  * @remarks
- * Retrieves a paginated list of all files within a specific batch operation.
+ * Retrieves a paginated list of all files within a specific batch operation. Returns 410 once the vector store has expired.
  *
  * If set, this operation will use {@link Security.bearerAuth} from the global security.
  */

package/src/funcs/llmVectorStoresSearch.ts

@@ -30,7 +30,7 @@ import { Result } from "../types/fp.js";
  * Search a vector store
  *
  * @remarks
- * Performs semantic search within a vector store to find the most relevant document chunks for a query.
+ * Performs semantic search within a vector store to find the most relevant document chunks for a query. Returns 410 once the vector store has expired.
  *
  * If set, this operation will use {@link Security.bearerAuth} from the global security.
  */

package/src/funcs/llmVectorStoresUpdate.ts

@@ -30,7 +30,7 @@ import { Result } from "../types/fp.js";
  * Modify a vector store
  *
  * @remarks
- * Updates the properties of an existing vector store.
+ * Updates the properties of an existing vector store. Returns 410 once the vector store has expired.
  *
  * If set, this operation will use {@link Security.bearerAuth} from the global security.
  */

package/src/funcs/llmVectorStoresUpdateFile.ts

@@ -30,7 +30,7 @@ import { Result } from "../types/fp.js";
  * Update file attributes
  *
  * @remarks
- * Updates the metadata attributes attached to a file within a vector store.
+ * Updates the metadata attributes attached to a file within a vector store. Returns 410 once the vector store has expired.
  *
  * If set, this operation will use {@link Security.bearerAuth} from the global security.
  */

package/src/lib/config.ts

@@ -65,7 +65,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.1.0",
-  sdkVersion: "0.54.77",
+  sdkVersion: "0.54.79",
   genVersion: "2.946.0",
-  userAgent: "speakeasy-sdk/typescript 0.54.77 2.946.0 1.1.0 @meetkai/mka1",
+  userAgent: "speakeasy-sdk/typescript 0.54.79 2.946.0 1.1.0 @meetkai/mka1",
 } as const;

package/src/mcp-server/mcp-server.ts

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.54.77",
+    currentVersion: "0.54.79",
   },
 });
 

package/src/mcp-server/server.ts

@@ -472,7 +472,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "SDK",
-    version: "0.54.77",
+    version: "0.54.79",
   });
 
   const client = new SDKCore({

package/src/mcp-server/tools/llmVectorStoresCancelFileBatch.ts

@@ -15,7 +15,7 @@ export const tool$llmVectorStoresCancelFileBatch: ToolDefinition<typeof args> =
     name: "llm-vector-stores-cancel-file-batch",
     description: `Cancel batch file processing
 
-Cancels an in-progress file batch operation.`,
+Cancels an in-progress file batch operation. Returns 410 once the vector store has expired.`,
     args,
     tool: async (client, args, ctx) => {
       const [result, apiCall] = await llmVectorStoresCancelFileBatch(

package/src/mcp-server/tools/llmVectorStoresCreateFile.ts

@@ -14,7 +14,7 @@ export const tool$llmVectorStoresCreateFile: ToolDefinition<typeof args> = {
   name: "llm-vector-stores-create-file",
   description: `Add a file to a vector store
 
-Adds a file to a vector store for semantic search indexing.`,
+Adds a file to a vector store for semantic search indexing. Returns 410 once the vector store has expired.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await llmVectorStoresCreateFile(

package/src/mcp-server/tools/llmVectorStoresCreateFileBatch.ts

@@ -15,7 +15,7 @@ export const tool$llmVectorStoresCreateFileBatch: ToolDefinition<typeof args> =
     name: "llm-vector-stores-create-file-batch",
     description: `Batch add multiple files to vector store
 
-Adds multiple files to a vector store in a single batch operation.`,
+Adds multiple files to a vector store in a single batch operation. Returns 410 once the vector store has expired.`,
     args,
     tool: async (client, args, ctx) => {
       const [result, apiCall] = await llmVectorStoresCreateFileBatch(

package/src/mcp-server/tools/llmVectorStoresDeleteFile.ts

@@ -14,7 +14,7 @@ export const tool$llmVectorStoresDeleteFile: ToolDefinition<typeof args> = {
   name: "llm-vector-stores-delete-file",
   description: `Remove file from vector store
 
-Removes a file from a vector store and deletes its associated embeddings. If the file is no longer attached but the vector store still holds embeddings for it (for example, left behind by an earlier file deletion), those embeddings are deleted and the request succeeds, provided the file was deleted or you can read it; otherwise, and when there is nothing to remove, returns 404. Returns 409 if the file keeps being added back to the vector store while it is being removed; retrying completes the removal.`,
+Removes a file from a vector store and deletes its associated embeddings. If the file is no longer attached but the vector store still holds embeddings for it (for example, left behind by an earlier file deletion), those embeddings are deleted and the request succeeds, provided the file was deleted or you can read it; otherwise, and when there is nothing to remove, returns 404. Returns 409 if the file keeps being added back to the vector store while it is being removed; retrying completes the removal. Returns 410 once the vector store has expired.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await llmVectorStoresDeleteFile(

package/src/mcp-server/tools/llmVectorStoresGet.ts

@@ -14,7 +14,7 @@ export const tool$llmVectorStoresGet: ToolDefinition<typeof args> = {
   name: "llm-vector-stores-get",
   description: `Retrieve a vector store
 
-Retrieves a vector store by its ID.`,
+Retrieves a vector store by its ID. Returns 410 once the vector store has expired.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await llmVectorStoresGet(

package/src/mcp-server/tools/llmVectorStoresGetFile.ts

@@ -14,7 +14,7 @@ export const tool$llmVectorStoresGetFile: ToolDefinition<typeof args> = {
   name: "llm-vector-stores-get-file",
   description: `Retrieve a vector store file
 
-Retrieves detailed information about a specific file within a vector store.`,
+Retrieves detailed information about a specific file within a vector store. Returns 410 once the vector store has expired.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await llmVectorStoresGetFile(

package/src/mcp-server/tools/llmVectorStoresGetFileBatch.ts

@@ -14,7 +14,7 @@ export const tool$llmVectorStoresGetFileBatch: ToolDefinition<typeof args> = {
   name: "llm-vector-stores-get-file-batch",
   description: `Retrieve file batch status
 
-Retrieves the status of a specific file batch operation within a vector store.`,
+Retrieves the status of a specific file batch operation within a vector store. Returns 410 once the vector store has expired.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await llmVectorStoresGetFileBatch(

package/src/mcp-server/tools/llmVectorStoresGetFileContent.ts

@@ -14,7 +14,7 @@ export const tool$llmVectorStoresGetFileContent: ToolDefinition<typeof args> = {
   name: "llm-vector-stores-get-file-content",
   description: `Retrieve parsed file content
 
-Retrieves the complete parsed contents of a file within a vector store.`,
+Retrieves the complete parsed contents of a file within a vector store. Returns 410 once the vector store has expired.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await llmVectorStoresGetFileContent(

package/src/mcp-server/tools/llmVectorStoresListFiles.ts

@@ -14,7 +14,7 @@ export const tool$llmVectorStoresListFiles: ToolDefinition<typeof args> = {
   name: "llm-vector-stores-list-files",
   description: `List files in a vector store
 
-Retrieves a paginated list of all files in a specific vector store.`,
+Retrieves a paginated list of all files in a specific vector store. Returns 410 once the vector store has expired.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await llmVectorStoresListFiles(

package/src/mcp-server/tools/llmVectorStoresListFilesInBatch.ts

@@ -15,7 +15,7 @@ export const tool$llmVectorStoresListFilesInBatch: ToolDefinition<typeof args> =
     name: "llm-vector-stores-list-files-in-batch",
     description: `List files in a batch
 
-Retrieves a paginated list of all files within a specific batch operation.`,
+Retrieves a paginated list of all files within a specific batch operation. Returns 410 once the vector store has expired.`,
     args,
     tool: async (client, args, ctx) => {
       const [result, apiCall] = await llmVectorStoresListFilesInBatch(

package/src/mcp-server/tools/llmVectorStoresSearch.ts

@@ -14,7 +14,7 @@ export const tool$llmVectorStoresSearch: ToolDefinition<typeof args> = {
   name: "llm-vector-stores-search",
   description: `Search a vector store
 
-Performs semantic search within a vector store to find the most relevant document chunks for a query.`,
+Performs semantic search within a vector store to find the most relevant document chunks for a query. Returns 410 once the vector store has expired.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await llmVectorStoresSearch(

package/src/mcp-server/tools/llmVectorStoresUpdate.ts

@@ -14,7 +14,7 @@ export const tool$llmVectorStoresUpdate: ToolDefinition<typeof args> = {
   name: "llm-vector-stores-update",
   description: `Modify a vector store
 
-Updates the properties of an existing vector store.`,
+Updates the properties of an existing vector store. Returns 410 once the vector store has expired.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await llmVectorStoresUpdate(

package/src/mcp-server/tools/llmVectorStoresUpdateFile.ts

@@ -14,7 +14,7 @@ export const tool$llmVectorStoresUpdateFile: ToolDefinition<typeof args> = {
   name: "llm-vector-stores-update-file",
   description: `Update file attributes
 
-Updates the metadata attributes attached to a file within a vector store.`,
+Updates the metadata attributes attached to a file within a vector store. Returns 410 once the vector store has expired.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await llmVectorStoresUpdateFile(

package/src/models/components/createvectorstorerequest.ts

@@ -30,7 +30,7 @@ export type ExpiresAfter = {
    */
   anchor: "last_active_at";
   /**
-   * The number of days after the anchor time that the vector store will expire.
+   * The number of days after the anchor time that the vector store will expire. Must be between 1 and 365.
    */
   days: number;
 };

package/src/models/components/filesearchtooldefinition.ts

@@ -41,6 +41,9 @@ export type FileSearchToolDefinitionFilters =
  */
 export type FileSearchToolDefinition = {
   type: "file_search";
+  /**
+   * The vector stores to search. If any of them has expired, the tool call fails with an error naming the expired stores; once an expired store has been deleted (within the hour), it is skipped like a missing one.
+   */
   vectorStoreIds: Array<string>;
   filters?:
     | (ComparisonFilter & { type: "eq" })

package/src/models/components/modifyvectorstorerequest.ts

@@ -17,7 +17,7 @@ export type ModifyVectorStoreRequestExpiresAfter = {
    */
   anchor: "last_active_at";
   /**
-   * The number of days after the anchor time that the vector store will expire.
+   * The number of days after the anchor time that the vector store will expire. Must be between 1 and 365.
    */
   days: number;
 };

package/src/models/components/openaichatcompletionrequestparams.ts

@@ -173,7 +173,7 @@ export type OpenAIChatCompletionRequestParams = {
    */
   topLogprobs?: number | undefined;
   /**
-   * A unique identifier representing your end-user, which can help monitor and detect abuse. Also used for usage tracking and analytics.
+   * A unique identifier representing your end-user. `/chat/completions` and `/chat/completions/stream` ignore this value and send the authenticated caller's external user id to the model provider instead. A Batch request line sends its own value.
    */
   user?: string | undefined;
   /**

package/src/models/components/responseobject.ts

@@ -233,6 +233,9 @@ export type ToolsFilters =
  */
 export type ToolsFileSearchToolDefinition = {
   type: "file_search";
+  /**
+   * The vector stores to search. If any of them has expired, the tool call fails with an error naming the expired stores; once an expired store has been deleted (within the hour), it is skipped like a missing one.
+   */
   vectorStoreIds: Array<string>;
   filters?:
     | (ComparisonFilter & { type: "eq" })

package/src/models/components/vectorstore.ts

@@ -52,7 +52,7 @@ export type VectorStoreExpiresAfter = {
    */
   anchor: "last_active_at";
   /**
-   * The number of days after the anchor time that the vector store will expire.
+   * The number of days after the anchor time that the vector store will expire. Must be between 1 and 365.
    */
   days: number;
 };
@@ -116,11 +116,11 @@ export type VectorStore = {
    */
   expiresAfter?: VectorStoreExpiresAfter | undefined;
   /**
-   * The Unix timestamp (in seconds) for when the vector store will expire.
+   * The Unix timestamp (in seconds) for when the vector store will expire: last_active_at plus expires_after.days.
    */
   expiresAt?: number | null | undefined;
   /**
-   * The Unix timestamp (in seconds) for when the vector store was last active.
+   * The Unix timestamp (in seconds) for when the vector store was last active: searched (directly or via file_search), modified, or had files ingested, re-tagged or removed. Searches update it at most once a minute; the service's own cleanup, such as removing an expired file, does not count.
    */
   lastActiveAt: number | null;
   /**