@squidcloud/backend 1.0.288 → 1.0.290

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

@@ -1,4 +1,5 @@
 import { AiChatbotMutationType, AiChatbotResourceType } from '@squidcloud/client';
+import { AiAgentId } from '@squidcloud/client';
 /** A context provided to the security rules of an AI Chatbot mutation. */
 export declare class AiChatbotMutationContext {
     readonly type: AiChatbotMutationType;
@@ -6,10 +7,21 @@ export declare class AiChatbotMutationContext {
     readonly profileId: string;
     readonly payload: any;
 }
-/** A context passed to every AI function call as a second parameter. */
-export interface AiFunctionContext {
-    /** Per AI agent context. Same for all AI functions used the agent. */
-    agentContext: Record<string, unknown>;
-    /** Per AI function context. */
-    functionContext: Record<string, unknown>;
+/**
+ * Context object passed as a second parameter to every AI function call,
+ * providing both agent-specific and function-specific context.
+ */
+export interface AiFunctionContext<AgentContextType = unknown, FunctionContextType = unknown> {
+    /** Unique identifier for the AI agent making the call. */
+    agentId?: AiAgentId;
+    /**
+     * Persistent context for the specific AI agent.
+     * Remains constant across all AI functions used by this agent.
+     */
+    agentContext: AgentContextType;
+    /**
+     * Context specific to each individual AI function call.
+     * Can contain parameters or data unique to the current function invocation.
+     */
+    functionContext: FunctionContextType;
 }

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

@@ -9,7 +9,7 @@ import { ClientId, SquidDocId } from '@squidcloud/client';
 import { TopicReadContext, TopicWriteContext } from './topic.public-context';
 import { DistributedLockContext } from './distributed-lock.public-context';
 import { GraphqlContext } from './graphql.public-context';
-import { AiChatbotMutationContext } from './ai-chatbot.public-context';
+import { AiChatbotMutationContext, AiFunctionContext } from './ai-chatbot.public-context';
 import { StorageContext } from '@squidcloud/client';
 import { NativeQueryContext } from './native-query.public-context';
 import { AiChatbotChatContext } from '@squidcloud/client';
@@ -25,7 +25,7 @@ export type SecureGraphQLAction = ((context: GraphqlContext) => boolean | Promis
 export type SecureAiChatbotAction<T extends AiChatbotActionType> = T extends 'all' ? () => boolean | Promise<boolean> : T extends 'chat' ? ((context: AiChatbotChatContext) => boolean | Promise<boolean>) | (() => boolean | Promise<boolean>) : ((context: AiChatbotMutationContext) => boolean | Promise<boolean>) | (() => boolean | Promise<boolean>);
 export type ClientConnectionStateChangeAction = (clientId: ClientId, clientConnectionState: ClientConnectionState) => Promise<void> | void;
 export type ExecutableAction = (...args: any[]) => any;
-export type AiFunctionAction<T extends Record<string, any> = any> = (params: T) => any;
+export type AiFunctionAction<T extends Record<string, any> = any> = (params: T, context: AiFunctionContext) => any;
 export type TriggerAction = ((request: TriggerRequest) => void | Promise<void>) | (() => void | Promise<void>);
 /** The context provided to a trigger function. */
 export interface TriggerRequest<T extends DocumentData = any> {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squidcloud/backend",
-  "version": "1.0.288",
+  "version": "1.0.290",
   "description": "Squid Cloud's backend SDK",
   "main": "dist/index.js",
   "types": "dist/backend/src/index.d.ts",
@@ -26,7 +26,7 @@
     "graphql": "^16.9.0"
   },
   "peerDependencies": {
-    "@squidcloud/client": "^1.0.288"
+    "@squidcloud/client": "^1.0.290"
   },
   "engines": {
     "node": ">=20.0.0"