@squidcloud/client 1.0.415 → 1.0.417

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

@@ -3,10 +3,11 @@ import { AiAgentClientOptions } from './agent/ai-agent-client';
 import { AiAgentReference } from './agent/ai-agent-client-reference';
 import { AiAssistantClient } from './ai-assistant-client';
 import { AiAudioClient } from './ai-audio-client';
+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, AiKnowledgeBase, AiKnowledgeBaseId, AiProviderType, ApplicationAiSettings, IntegrationId, SecretKey } from './public-types';
+import { AiAgent, AiAgentId, AiFileProviderType, AiKnowledgeBase, AiKnowledgeBaseId, AiProviderType, 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
@@ -56,6 +57,19 @@ export declare class AiClient {
      * @deprecated - Use `knowledgebase('kbId').searchContextsWith*()` instead.
      */
     matchMaking(): AiMatchMakingClient;
+    /**
+     * Creates a client to manage files for a specific AI provider.
+     *
+     * @param provider - The AI provider (openai, gemini, or anthropic).
+     * @returns An AiFilesClient bound to the specified provider.
+     * @example
+     * ```typescript
+     * const openaiFiles = squid.ai().files('openai');
+     * const fileId = await openaiFiles.uploadFile({ file });
+     * await openaiFiles.deleteFile(fileId);
+     * ```
+     */
+    files(provider: AiFileProviderType): AiFilesClient;
     /**
      * Executes an AI query using a specific DB integration, sending a prompt to the AI and returning its response.
      * This function allows for direct interaction with the AI's capabilities by sending text prompts and receiving

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

@@ -0,0 +1,33 @@
+/**
+ * Options for uploading a file to an AI provider.
+ * @category AI
+ */
+export interface UploadAiFileOptions {
+    /** The file to upload. */
+    file: File;
+    /** Optional expiration time in seconds for automatic cleanup. */
+    expirationInSeconds?: number;
+}
+/**
+ * AiFilesClient provides methods for managing files with a specific AI provider.
+ * The provider is bound when the client is created via `squid.ai().files(provider)`.
+ * @category AI
+ */
+export declare class AiFilesClient {
+    private readonly provider;
+    private readonly rpcManager;
+    /**
+     * Uploads a file to the AI provider for use with AI features like code interpreter.
+     *
+     * @param options - Options for uploading the file.
+     * @returns A Promise that resolves to the file ID assigned by the provider.
+     */
+    uploadFile(options: UploadAiFileOptions): Promise<string>;
+    /**
+     * Deletes a file from the AI provider's storage.
+     *
+     * @param fileId - The ID of the file to delete.
+     * @returns A Promise that resolves to true if the file was deleted, false if it didn't exist.
+     */
+    deleteFile(fileId: string): Promise<boolean>;
+}

package/dist/typescript-client/src/ai-knowledge-base/ai-knowledge-base-client-reference.d.ts

@@ -69,10 +69,12 @@ export declare class AiKnowledgeBaseReference {
     }): Promise<Array<AiKnowledgeBaseSearchResultChunk>>;
     /**
      * Performs a semantic search in the knowledge base and returns contexts with reasoning.
+     * Can be used for matchmaking or similarity search.
      */
     searchContextsWithPrompt(request: Omit<AiKnowledgeBaseSearchContextsWithPromptRequest, 'knowledgeBaseId'>): Promise<Array<AiKnowledgeBaseContextWithReasoning>>;
     /**
      * Performs a semantic search in the knowledge base and returns contexts with reasoning.
+     * Can be used for matchmaking or similarity search.
      */
     searchContextsWithContextId(request: Omit<AiKnowledgeBaseSearchContextsWithContextIdRequest, 'knowledgeBaseId'>): Promise<Array<AiKnowledgeBaseContextWithReasoning>>;
     /**

package/dist/typescript-client/src/distributed-lock.manager.d.ts

@@ -1,4 +1,16 @@
 import { Observable } from 'rxjs';
+/**
+ * Options for acquiring a distributed lock.
+ * @category Platform
+ */
+export interface DistributedLockOptions {
+    /**
+     * The maximum time the lock can be held before it is automatically released.
+     * If not specified, the lock will be held until explicitly released or the connection is lost.
+     * @default undefined (no limit).
+     */
+    maxHoldTimeMillis?: number;
+}
 /**
  * A handler for a distributed lock that can be released.
  * @category Platform
@@ -9,7 +21,7 @@ export interface DistributedLock {
      * The release process runs asynchronously. Use `observeRelease()` to be notified when the release completes.
      * @returns A promise that resolves when the release message is sent, or undefined for backward compatibility.
      */
-    release(): Promise<void> | void;
+    release(): Promise<void>;
     /**
      * Whether the lock has been released.
      * @returns True if the lock has been released.
@@ -20,4 +32,8 @@ export interface DistributedLock {
      * @returns An observable that emits when the lock is released.
      */
     observeRelease(): Observable<void>;
+    /** The resource identifier (mutex name) that was locked. */
+    get resourceId(): string;
+    /** Unique lock instance ID within the system. */
+    get lockId(): string;
 }

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

@@ -5,6 +5,7 @@ export * from './agent/ai-agent-client.types';
 export * from './ai-assistant-client';
 export * from './ai-audio-client';
 export * from './ai-client';
+export * from './ai-files-client';
 export * from './ai-image-client';
 export * from './ai-knowledge-base/ai-knowledge-base-client';
 export * from './ai-knowledge-base/ai-knowledge-base-client-reference';

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

@@ -3,7 +3,7 @@ import { AiClient } from './ai-client';
 import { ApiClient } from './api-client';
 import { CollectionReference } from './collection-reference';
 import { ConnectionDetails } from './connection-details';
-import { DistributedLock } from './distributed-lock.manager';
+import { DistributedLock, DistributedLockOptions } from './distributed-lock.manager';
 import { ExecuteFunctionOptions } from './execute-function-options';
 import { ExternalAuthClient } from './external-auth-client';
 import { ExtractionClient } from './extraction-client';
@@ -349,9 +349,11 @@ export declare class Squid {
      * The lock will be released when the release method on the returned object is invoked or whenever the connection
      * with the server is lost.
      * @param mutex A string that uniquely identifies the lock.
+     * @param options Optional configuration for the lock, including maxHoldTimeMillis to automatically release the lock
+     *   after a specified duration.
      * @returns A promise that resolves with the lock object. The promise will reject if failed to acquire the lock.
      */
-    acquireLock(mutex: string): Promise<DistributedLock>;
+    acquireLock(mutex: string, options?: DistributedLockOptions): Promise<DistributedLock>;
     /**
      * Executes the given callback while holding a lock for the given mutex. The lock will be released when the callback
      * finishes.

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

package/package.json

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