@botpress/runtime 1.11.9 → 1.12.1

package/dist/library.js

@@ -48,7 +48,7 @@ var init_define_BUILD = __esm({
 var define_PACKAGE_VERSIONS_default;
 var init_define_PACKAGE_VERSIONS = __esm({
   "<define:__PACKAGE_VERSIONS__>"() {
-    define_PACKAGE_VERSIONS_default = { runtime: "1.11.9", adk: "1.11.9", sdk: "4.20.2", llmz: "0.0.33", zai: "2.5.0", cognitive: "0.2.0" };
+    define_PACKAGE_VERSIONS_default = { runtime: "1.12.1", adk: "1.12.1", sdk: "4.20.2", llmz: "0.0.33", zai: "2.5.0", cognitive: "0.2.0" };
   }
 });
 
@@ -34045,12 +34045,12 @@ If the question is not related to the knowledge bases, do NOT use this tool.`.tr
           input: z2.string().describe("The query to search for.").min(1).max(1024),
           output: z2.string().describe("The search results."),
           handler: async (query) => {
-            const client = context.get("client");
+            const client2 = context.get("client");
             const citations = context.get("citations");
-            if (!client) {
+            if (!client2) {
               throw new Error("Client is not available in this context. Make sure to run in a context with a client.");
             }
-            const { passages } = await client.searchFiles({
+            const { passages } = await client2.searchFiles({
               query,
               withContext: true,
               includeBreadcrumb: true,
@@ -34431,9 +34431,9 @@ var init_actions = __esm({
           return handler;
         }
         let integrations;
-        let client;
+        let client2;
         integrations ??= context.get("integrations", { optional: true });
-        client ??= context.get("client", { optional: true });
+        client2 ??= context.get("client", { optional: true });
         const integrationName = propertyName.replace("__", "/");
         return new Proxy(
           {},
@@ -34443,19 +34443,19 @@ var init_actions = __esm({
                 return void 0;
               }
               integrations ??= context.get("integrations", { optional: true });
-              client ??= context.get("client", { optional: true });
+              client2 ??= context.get("client", { optional: true });
               const integration = integrations.find((i) => i.alias === integrationName);
               const actionDef = integration?.definition.actions?.[actionName];
               const handler = async (params) => {
                 integrations ??= context.get("integrations", { optional: true });
-                client ??= context.get("client", { optional: true });
+                client2 ??= context.get("client", { optional: true });
                 if (!integration || !actionDef) {
                   throw new Error(`Could not find integration "${integrationName}" and action "${actionName}"`);
                 }
                 if (!integration.definition.actions?.[actionName]) {
                   throw new Error(`Action "${actionName}" not found in integration "${integrationName}"`);
                 }
-                return client.callAction({
+                return client2.callAction({
                   type: `${integration.alias}:${actionName}`,
                   input: params
                 }).then((res) => res.output);
@@ -35107,7 +35107,7 @@ var init_workflow = __esm({
        * @returns The workflow instance
        */
       async getOrCreate(props) {
-        const client = context.get("client");
+        const client2 = context.get("client");
         const statuses = props.statuses || ["pending", "in_progress", "listening", "paused"];
         const validatedInput = this._inputSchema.parse(props.input);
         const tags = {};
@@ -35125,10 +35125,10 @@ var init_workflow = __esm({
           timeoutAt: new Date(Date.now() + (this.timeout ?? (0, import_ms.default)("5m"))).toISOString(),
           ...discriminator && { discriminateBy: { tags: discriminator } }
         };
-        let { workflow } = await client._inner.getOrCreateWorkflow(createArgs);
+        let { workflow } = await client2._inner.getOrCreateWorkflow(createArgs);
         if (props.key && !statuses.includes(workflow.status)) {
-          await client._inner.deleteWorkflow({ id: workflow.id });
-          ({ workflow } = await client._inner.getOrCreateWorkflow(createArgs));
+          await client2._inner.deleteWorkflow({ id: workflow.id });
+          ({ workflow } = await client2._inner.getOrCreateWorkflow(createArgs));
         }
         return await BaseWorkflowInstance.load({
           id: workflow.id,
@@ -35146,9 +35146,9 @@ var init_workflow = __esm({
        * }
        */
       async provide(event, data) {
-        const client = context.get("client");
+        const client2 = context.get("client");
         const { workflowId, stepName } = event.payload;
-        const state = createWorkflowExecutionState(client._inner, workflowId);
+        const state = createWorkflowExecutionState(client2._inner, workflowId);
         await state.load();
         if (!state.value) {
           throw new Error(`Workflow execution state not found for workflow ${workflowId}`);
@@ -35167,7 +35167,7 @@ var init_workflow = __esm({
         }
         state.value.revision++;
         await state.save();
-        await client.createEvent({
+        await client2.createEvent({
           type: WorkflowContinueEvent.name,
           workflowId,
           payload: {}
@@ -35175,10 +35175,10 @@ var init_workflow = __esm({
       }
       async start(input) {
         const validatedInput = this._inputSchema.parse(input);
-        const client = context.get("client");
+        const client2 = context.get("client");
         const event = context.get("event", { optional: true });
         const workflow = context.get("workflow", { optional: true });
-        const res = await client._inner.createWorkflow({
+        const res = await client2._inner.createWorkflow({
           name: this.name,
           status: event ? "in_progress" : "pending",
           eventId: event?.id,
@@ -35432,8 +35432,8 @@ var init_action = __esm({
       /**
        * Execute the action with input validation and output validation
        */
-      async execute({ input, client }) {
-        return await this.handler({ input, client });
+      async execute({ input, client: client2 }) {
+        return await this.handler({ input, client: client2 });
       }
     };
   }
@@ -35499,9 +35499,9 @@ var init_computed_columns = __esm({
         isFinished: z9.boolean(),
         rows: z9.array(z9.any())
       }),
-      handler: async ({ input, client }) => {
+      handler: async ({ input, client: client2 }) => {
         const { tableId, requests } = input;
-        const { table: remoteTable } = await client._inner.getTable({ table: tableId });
+        const { table: remoteTable } = await client2._inner.getTable({ table: tableId });
         const table = adk.project.tables.find((x) => x.name === remoteTable.name);
         async function computeRow(row, columnsToRecompute) {
           const newRow = { id: row.id };
@@ -35574,7 +35574,35 @@ __export(adk_exports, {
   register: () => register,
   registerIntegration: () => registerIntegration
 });
+import { BotSpecificClient } from "@botpress/sdk";
 import { Zai } from "@botpress/zai";
+import { Cognitive as Cognitive2 } from "@botpress/cognitive";
+import { Client } from "@botpress/client";
+function getStandaloneCognitive() {
+  return getSingleton("__ADK_GLOBAL_STANDALONE_COGNITIVE", () => {
+    const token = process.env.BP_TOKEN || process.env.ADK_TOKEN;
+    if (!token) {
+      throw new Error(
+        'No token found. Set BP_TOKEN or ADK_TOKEN environment variable, or run this script using "adk run".'
+      );
+    }
+    const botId = process.env.ADK_BOT_ID;
+    if (!botId) {
+      throw new Error('No bot ID found. Set ADK_BOT_ID environment variable, or run this script using "adk run".');
+    }
+    const apiUrl = process.env.ADK_API_URL || "https://api.botpress.cloud";
+    const vanillaClient = new Client({
+      token,
+      apiUrl,
+      botId
+    });
+    const botClient = new BotSpecificClient(vanillaClient);
+    return new Cognitive2({
+      client: botClient,
+      __experimental_beta: true
+    });
+  });
+}
 function initialize(options) {
   const state = getState();
   if (state.initialized) {
@@ -35662,8 +35690,10 @@ var init_adk = __esm({
         return Environment;
       },
       get zai() {
+        const contextCognitive = context.get("cognitive", { optional: true });
+        const cognitive = contextCognitive ?? getStandaloneCognitive();
         return new Zai({
-          client: context.get("cognitive"),
+          client: cognitive,
           modelId: Array.isArray(adk.project.config.defaultModels.zai) ? adk.project.config.defaultModels.zai[0] ?? "auto" : adk.project.config.defaultModels.zai
         });
       },
@@ -35688,6 +35718,29 @@ var init_adk = __esm({
           conversations: state.primitives.conversations,
           triggers: state.primitives.triggers
         };
+      },
+      async execute(props) {
+        const contextCognitive = context.get("cognitive", { optional: true });
+        const cognitive = contextCognitive ?? getStandaloneCognitive();
+        const defaultModel = adk.project.config.defaultModels.autonomous;
+        const { execute: llmz_execute, getValue: getValue2 } = await import("llmz");
+        return llmz_execute({
+          client: cognitive,
+          instructions: props.instructions,
+          ...props.tools && { tools: props.tools },
+          ...props.objects && { objects: props.objects },
+          ...props.exits && { exits: props.exits },
+          ...props.signal && { signal: props.signal },
+          temperature: async (ctx) => props.temperature ? await getValue2(props.temperature, ctx) : 0.7,
+          model: async (ctx) => props.model ? await getValue2(props.model, ctx) : defaultModel,
+          options: { loop: props.iterations ?? 10 },
+          ...props.hooks?.onTrace && { onTrace: props.hooks.onTrace },
+          ...props.hooks?.onIterationEnd && { onIterationEnd: props.hooks.onIterationEnd },
+          ...props.hooks?.onBeforeTool && { onBeforeTool: props.hooks.onBeforeTool },
+          ...props.hooks?.onAfterTool && { onAfterTool: props.hooks.onAfterTool },
+          ...props.hooks?.onBeforeExecution && { onBeforeExecution: props.hooks.onBeforeExecution },
+          ...props.hooks?.onExit && { onExit: props.hooks.onExit }
+        });
       }
     };
   }
@@ -35729,7 +35782,7 @@ var init_workflow_utils = __esm({
     init_runtime();
     init_events();
     updateWorkflow = async (props) => {
-      const client = context.get("client");
+      const client2 = context.get("client");
       const workflowId = props.id;
       const workflowsToUpdate = [];
       const ctxWorkflow = context.get("workflow", { optional: true });
@@ -35748,7 +35801,7 @@ var init_workflow_utils = __esm({
       if (workflowAlreadyDone) {
         return { workflow: workflowAlreadyDone };
       }
-      const response = await client.updateWorkflow(props);
+      const response = await client2.updateWorkflow(props);
       for (const wf of workflowsToUpdate) {
         Object.assign(wf, response.workflow);
       }
@@ -35986,9 +36039,9 @@ var init_workflow_step = __esm({
         async () => {
           const remainingTime = context.get("runtime").getRemainingExecutionTimeInMs();
           if (remainingTime - MIN_STEP_REMAINING_TIME_MS <= ms3 || ms3 >= 1e4) {
-            const client = context.get("client");
+            const client2 = context.get("client");
             const workflowControlContext = context.get("workflowControlContext");
-            await client.createEvent({
+            await client2.createEvent({
               type: WorkflowContinueEvent.name,
               payload: {},
               workflowId: workflowControlContext.workflow.id,
@@ -36024,13 +36077,13 @@ var init_workflow_step = __esm({
       return await _step(
         name,
         async () => {
-          const client = context.get("client");
+          const client2 = context.get("client");
           const state = createWorkflowExecutionState(
             context.get("client")._inner,
             workflowControlContext.workflow.id
           );
           assert(state.value, "State is not loaded");
-          const { workflow } = await client.getWorkflow({ id: workflowId });
+          const { workflow } = await client2.getWorkflow({ id: workflowId });
           if (isWorkflowFinished(workflow.status)) {
             return workflow;
           }
@@ -36118,7 +36171,7 @@ var init_workflow_step = __esm({
         actualStepName,
         async () => {
           const workflowControlContext = context.get("workflowControlContext");
-          const client = context.get("client");
+          const client2 = context.get("client");
           if (!workflowControlContext.workflow.conversationId) {
             throw new Error(`Cannot request data: workflow ${workflowControlContext.workflow.id} has no conversationId`);
           }
@@ -36132,14 +36185,14 @@ var init_workflow_step = __esm({
               `Request "${request}" not found in workflow "${workflowDef.name}". Available requests: ${Object.keys(workflowDef._requestsSchemas || {}).join(", ") || "none"}`
             );
           }
-          const state = createWorkflowExecutionState(client._inner, workflowControlContext.workflow.id);
+          const state = createWorkflowExecutionState(client2._inner, workflowControlContext.workflow.id);
           if (!state.value) {
             throw new Error("Workflow execution state not loaded");
           }
           if (state.value.steps?.[actualStepName]?.output !== void 0) {
             return requestSchema.parse(state.value.steps[actualStepName].output);
           }
-          await client.createEvent({
+          await client2.createEvent({
             type: WorkflowDataRequestEvent2.name,
             conversationId: workflowControlContext.workflow.conversationId,
             payload: {
@@ -36169,7 +36222,7 @@ var init_workflow_step = __esm({
 
 // src/primitives/workflow-cancellation-monitor.ts
 function startWorkflowCancellationMonitor(props) {
-  const { client, workflowId, workflowControlContext, abortSignal, pollIntervalMs = 1e3 } = props;
+  const { client: client2, workflowId, workflowControlContext, abortSignal, pollIntervalMs = 1e3 } = props;
   if (abortSignal.aborted) {
     return () => {
     };
@@ -36180,7 +36233,7 @@ function startWorkflowCancellationMonitor(props) {
       return;
     }
     try {
-      const { workflow } = await client.getWorkflow({ id: workflowId });
+      const { workflow } = await client2.getWorkflow({ id: workflowId });
       const isTerminated = workflow.status === "cancelled" || workflow.status === "failed" || workflow.status === "timedout";
       if (isTerminated) {
         workflowControlContext.aborted = true;
@@ -36224,10 +36277,10 @@ function createStepSignal() {
     [StepSymbol]: true
   };
 }
-function createWorkflowExecutionState(client, workflowId) {
+function createWorkflowExecutionState(client2, workflowId) {
   return TrackedState.create({
     type: "workflow",
-    client,
+    client: client2,
     id: workflowId,
     schema: workflowExecutionContextSchema,
     name: BUILT_IN_STATES.workflowSteps
@@ -36285,18 +36338,18 @@ var init_workflow_instance = __esm({
       TrackedState;
       // @internal
       TrackedTags;
-      constructor(workflow, client) {
+      constructor(workflow, client2) {
         const definition = adk.project.workflows.find((w) => w.name === workflow.name);
         this.TrackedState = TrackedState.create({
           type: "workflow",
-          client: client._inner,
+          client: client2._inner,
           id: workflow.id,
           schema: definition?.stateSchema,
           name: BUILT_IN_STATES.workflowState
         });
         this.TrackedTags = TrackedTags.create({
           type: "workflow",
-          client: client._inner,
+          client: client2._inner,
           id: workflow.id,
           initialTags: workflow.tags
         });
@@ -36306,7 +36359,7 @@ var init_workflow_instance = __esm({
         this.input = workflow.input;
         this.createdAt = new Date(workflow.createdAt);
         this.updatedAt = new Date(workflow.updatedAt);
-        this.client = client;
+        this.client = client2;
         this.workflow = workflow;
       }
       get tags() {
@@ -36327,19 +36380,19 @@ var init_workflow_instance = __esm({
       }
       static Primitive = "workflow_instance";
       static async load(props) {
-        const client = context.get("client");
-        const workflow = props.workflow ? props.workflow : await client.getWorkflow({ id: props.id }).then((x) => x.workflow);
+        const client2 = context.get("client");
+        const workflow = props.workflow ? props.workflow : await client2.getWorkflow({ id: props.id }).then((x) => x.workflow);
         if (!adk.project.workflows.find((w) => w.name === workflow.name)) {
           throw new Error(`No ADK Workflow definition found for "${workflow.name}"`);
         }
         TrackedTags.create({
           type: "workflow",
-          client: client._inner,
+          client: client2._inner,
           id: workflow.id,
           initialTags: workflow.tags
         });
         await TrackedTags.loadAll();
-        return new _BaseWorkflowInstance(workflow, client);
+        return new _BaseWorkflowInstance(workflow, client2);
       }
       /**
        * Executes the workflow with the provided autonomous engine configuration.
@@ -36376,8 +36429,8 @@ var init_workflow_instance = __esm({
        * }
        */
       async provide(request, data) {
-        const client = context.get("client");
-        const state = createWorkflowExecutionState(client._inner, this.id);
+        const client2 = context.get("client");
+        const state = createWorkflowExecutionState(client2._inner, this.id);
         await state.load();
         if (!state.value) {
           throw new Error(`Workflow execution state not found for workflow ${this.id}`);
@@ -36396,7 +36449,7 @@ var init_workflow_instance = __esm({
         }
         state.value.revision++;
         await state.save();
-        await client.createEvent({
+        await client2.createEvent({
           type: WorkflowContinueEvent.name,
           workflowId: this.id,
           payload: {}
@@ -36447,8 +36500,8 @@ var init_workflow_instance = __esm({
           }
         };
         try {
-          const client = context.get("client");
-          const workflowExecutionState = createWorkflowExecutionState(client._inner, this.id);
+          const client2 = context.get("client");
+          const workflowExecutionState = createWorkflowExecutionState(client2._inner, this.id);
           await workflowExecutionState.load();
           await this.TrackedState.load();
           abortSignal.throwIfAborted();
@@ -36470,7 +36523,7 @@ var init_workflow_instance = __esm({
           }
           context.set("workflowControlContext", workflowControlContext);
           const stopCancellationMonitor = startWorkflowCancellationMonitor({
-            client: client._inner,
+            client: client2._inner,
             workflowId: this.id,
             workflowControlContext,
             abortSignal
@@ -36835,14 +36888,14 @@ var init_tracked_state = __esm({
       }
       static async loadAll() {
         await span("state.loadAll", {}, async () => {
-          const client = context.get("client")._inner;
+          const client2 = context.get("client")._inner;
           const botId = context.get("botId", { optional: true });
           const user2 = context.get("user", { optional: true });
           const conversation = context.get("conversation", { optional: true });
           const { adk: adk2 } = await Promise.resolve().then(() => (init_adk(), adk_exports));
           if (botId) {
             _TrackedState.create({
-              client,
+              client: client2,
               name: BUILT_IN_STATES.bot,
               type: "bot",
               id: botId,
@@ -36851,7 +36904,7 @@ var init_tracked_state = __esm({
           }
           if (user2) {
             _TrackedState.create({
-              client,
+              client: client2,
               name: BUILT_IN_STATES.user,
               type: "user",
               id: user2.id,
@@ -36868,7 +36921,7 @@ var init_tracked_state = __esm({
               }
             });
             _TrackedState.create({
-              client,
+              client: client2,
               name: BUILT_IN_STATES.conversation,
               type: "conversation",
               id: conversation.id,
@@ -37175,7 +37228,7 @@ var init_events2 = __esm({
 // src/runtime/context/handlers.ts
 import * as sdk from "@botpress/sdk";
 import { CitationsManager } from "llmz";
-import { Client } from "@botpress/client";
+import { Client as Client2 } from "@botpress/client";
 import { ulid as ulid2 } from "ulid";
 var init_handlers = __esm({
   "src/runtime/context/handlers.ts"() {
@@ -37899,12 +37952,12 @@ var init_conversation_instance = __esm({
       TrackedState;
       // @internal
       TrackedTags;
-      constructor(conversation, client) {
+      constructor(conversation, client2) {
         this.id = conversation.id;
         this.channel = `${conversation.integration}.${conversation.channel}`;
         this.integration = conversation.integration;
         this.conversation = conversation;
-        this.client = client;
+        this.client = client2;
         const states = context.get("states", { optional: true });
         const existingState = states?.find(
           (s) => s.type === "conversation" && s.id === conversation.id && s.name === BUILT_IN_STATES.conversation
@@ -37918,7 +37971,7 @@ var init_conversation_instance = __esm({
         const tags = TrackedTags.create({
           type: "conversation",
           id: conversation.id,
-          client: client._inner,
+          client: client2._inner,
           initialTags: conversation.tags
         });
         this.TrackedTags = tags;
@@ -38086,9 +38139,9 @@ var init_conversation = __esm({
         const message = context.get("message", { optional: true });
         const event = context.get("event", { optional: true });
         const chat = context.get("chat");
-        const client = context.get("client");
+        const client2 = context.get("client");
         const botpressConversation = context.get("conversation");
-        const conversationInstance = new BaseConversationInstance(botpressConversation, client);
+        const conversationInstance = new BaseConversationInstance(botpressConversation, client2);
         const startTypingPromise = conversationInstance.startTyping().catch(() => {
         });
         let type;
@@ -38125,7 +38178,7 @@ var init_conversation = __esm({
               if (controller.signal.aborted) {
                 return;
               }
-              const { events } = await client.listEvents({
+              const { events } = await client2.listEvents({
                 conversationId: conversationInstance.id,
                 status: "pending"
               });
@@ -38198,7 +38251,7 @@ var init_conversation = __esm({
           request: requestObject,
           conversation: conversationInstance,
           state: stateProxy,
-          client,
+          client: client2,
           execute
         });
         controller.abort();
@@ -40463,7 +40516,7 @@ var init_source_website = __esm({
         return createSyncWorkflow({
           type: "website",
           state: State,
-          async handler({ input, step: step2, state, client }) {
+          async handler({ input, step: step2, state, client: client2 }) {
             const crypto3 = await import("crypto");
             console.log(
               `Starting sync for WebsiteSource [${this.id}] in mode [${this.mode}, maxPages=${this.maxPages}, maxDepth=${this.maxDepth}, baseUrl=${this.baseUrl}, sitemapUrl=${this.sitemapUrl}]`
@@ -40484,7 +40537,7 @@ var init_source_website = __esm({
             console.log(`Will process up to ${this.maxPages} pages`);
             const existingFiles = await step2(
               "list existing files",
-              () => client._inner.list.files({
+              () => client2._inner.list.files({
                 tags
               }).collect()
             );
@@ -40495,7 +40548,7 @@ var init_source_website = __esm({
               await step2.map(
                 "deleting all existing files for recrawl",
                 existingFiles,
-                (f) => client.deleteFile({ id: f.id }).catch(() => null),
+                (f) => client2.deleteFile({ id: f.id }).catch(() => null),
                 { concurrency: 5 }
               );
               console.log(`\u2705 Deleted ${existingFiles.length} files, starting fresh crawl`);
@@ -40527,7 +40580,7 @@ var init_source_website = __esm({
             const deleted = await step2.map(
               "deleting removed urls",
               toRemove,
-              (f) => client.deleteFile({ id: f.id }).catch(() => null).then(
+              (f) => client2.deleteFile({ id: f.id }).catch(() => null).then(
                 () => ({
                   file: f.id,
                   name: f.key,
@@ -40552,7 +40605,7 @@ var init_source_website = __esm({
                   contentType = content.includes("<html") ? "text/html" : "text/markdown";
                 }
                 const key = `data_source://${this.type}/${this.id}/${encodeURIComponent(url2)}`;
-                const uploaded = await client.uploadFile({
+                const uploaded = await client2.uploadFile({
                   key,
                   content,
                   contentType,
@@ -40612,7 +40665,7 @@ var init_source_website = __esm({
             await step2("register web page source", async () => {
               try {
                 const botId = context.get("botId");
-                const getStateResult = await client._inner.getState({ id: botId, type: "bot", name: "dsData" }).catch(() => ({ state: null }));
+                const getStateResult = await client2._inner.getState({ id: botId, type: "bot", name: "dsData" }).catch(() => ({ state: null }));
                 const freshState = getStateResult.state;
                 const existingPayload = freshState?.payload || {};
                 const kbPayload = existingPayload[input.kbId] || {};
@@ -40634,7 +40687,7 @@ var init_source_website = __esm({
                   data: { websiteUrl, pages: [], indexingJobs: [] }
                 };
                 existingPayload[input.kbId] = kbPayload;
-                await client._inner.setState({
+                await client2._inner.setState({
                   id: botId,
                   type: "bot",
                   name: "dsData",
@@ -47512,7 +47565,7 @@ var init_source_directory = __esm({
         return createSyncWorkflow({
           type: "directory",
           state: z24.object({}),
-          handler: async ({ input, step: step2, client }) => {
+          handler: async ({ input, step: step2, client: client2 }) => {
             if (!adk.environment.isDevelopment()) {
               console.log("Directory ingestion is only supported in development environment");
               return {
@@ -47564,7 +47617,7 @@ var init_source_directory = __esm({
             );
             const existingFiles = await step2(
               "list existing files",
-              () => client._inner.list.files({
+              () => client2._inner.list.files({
                 tags
               }).collect()
             );
@@ -47578,7 +47631,7 @@ var init_source_directory = __esm({
             const deleted = await step2.map(
               "deleting removed files",
               toRemove,
-              (f) => client.deleteFile({ id: f.id }).catch(() => null).then(
+              (f) => client2.deleteFile({ id: f.id }).catch(() => null).then(
                 () => ({
                   file: f.id,
                   name: f.key,
@@ -47592,7 +47645,7 @@ var init_source_directory = __esm({
               const key = `data_source://${this.type}/${this.id}/${local.rel}`;
               const content = await fs3.readFile(local.abs);
               const hash = crypto3.createHash("sha256").update(content).digest("hex");
-              const { file } = await client.getFile({ id: key }).catch(() => ({ file: null }));
+              const { file } = await client2.getFile({ id: key }).catch(() => ({ file: null }));
               if (!input.force && file?.metadata?.hash === hash) {
                 console.log(`Skipping unchanged file: ${local.rel}`);
                 return null;
@@ -47601,7 +47654,7 @@ var init_source_directory = __esm({
                 console.log(`Force re-indexing file (unchanged): ${local.rel}`);
               }
               const title = path4.basename(local.name, path4.extname(local.name));
-              const uploaded = await client.uploadFile({
+              const uploaded = await client2.uploadFile({
                 key,
                 content,
                 accessPolicies: [],
@@ -47712,8 +47765,8 @@ var init_knowledge = __esm({
        * Look up the KB ID from Botpress
        */
       async getKbId() {
-        const client = context.get("client")._inner;
-        const kbs = await client.list.knowledgeBases({}).collect();
+        const client2 = context.get("client")._inner;
+        const kbs = await client2.list.knowledgeBases({}).collect();
         const remoteKb = kbs.find((k) => k.name === this.name);
         if (!remoteKb) {
           throw new Error(`KB '${this.name}' not found in Botpress - run 'adk deploy' or approve KB sync in 'adk dev'`);
@@ -47783,6 +47836,9 @@ var init_table = __esm({
       factor;
       columns;
       schema;
+      type = "table";
+      keyColumn;
+      tags;
       nullableColumns = /* @__PURE__ */ new Set();
       searchableColumns = /* @__PURE__ */ new Set();
       computedColumns = /* @__PURE__ */ new Set();
@@ -47794,6 +47850,7 @@ var init_table = __esm({
           (name) => /^[a-zA-Z_$][a-zA-Z0-9_]{0,29}Table$/.test(name),
           "Table name must start with a letter/underscore, be 35 chars or less, contain only letters/numbers/underscores, and end with 'Table'"
         );
+        const tagsSchema = z25.record(z25.string().min(3).max(50), z25.string().min(1).max(255)).optional();
         const validation = tableNameSchema.safeParse(props.name);
         if (!validation.success) {
           throw new Errors.InvalidPrimitiveError(`Invalid table name '${props.name}'`, validation.error);
@@ -47802,7 +47859,19 @@ var init_table = __esm({
         if (props.description !== void 0) {
           this.description = props.description;
         }
+        if (props.factor !== void 0 && (props.factor < 1 || props.factor > 30)) {
+          throw new Errors.InvalidPrimitiveError(
+            `Invalid factor for table '${props.name}': must be between 1 and 30 but got ${props.factor}`
+          );
+        }
         this.factor = props.factor ?? 1;
+        if (props.tags !== void 0) {
+          const parsed = tagsSchema.safeParse(props.tags);
+          if (!parsed.success) {
+            throw new Errors.InvalidPrimitiveError(`Invalid tags for table '${props.name}'`, parsed.error);
+          }
+          this.tags = props.tags;
+        }
         this.columns = {};
         let schema = z25.object({});
         for (const [key, value] of Object.entries(props.columns)) {
@@ -47852,6 +47921,14 @@ var init_table = __esm({
             };
           }
         }
+        if (props.keyColumn) {
+          if (typeof props.keyColumn !== "string" || !(props.keyColumn in this.columns)) {
+            throw new Errors.InvalidPrimitiveError(
+              `Invalid keyColumn '${String(props.keyColumn)}' for table '${props.name}': column does not exist`
+            );
+          }
+          this.keyColumn = String(props.keyColumn);
+        }
         this.schema = schema;
       }
       /** @internal */
@@ -47872,7 +47949,9 @@ var init_table = __esm({
           type: "table",
           name: this.name,
           schema,
-          factor: this.factor
+          factor: this.factor,
+          keyColumn: this.keyColumn,
+          tags: this.tags
         };
       }
       async getRow(props) {
@@ -48206,7 +48285,7 @@ var init_tracked_tags = __esm({
       }
       static async loadAll() {
         await span("tags.loadAll", {}, async () => {
-          const client = context.get("client")._inner;
+          const client2 = context.get("client")._inner;
           const bot2 = context.get("bot", { optional: true });
           const user2 = context.get("user", { optional: true });
           const conversation = context.get("conversation", { optional: true });
@@ -48214,7 +48293,7 @@ var init_tracked_tags = __esm({
           if (bot2) {
             const botTags = bot2.tags;
             _TrackedTags.create({
-              client,
+              client: client2,
               type: "bot",
               id: bot2.id,
               ...botTags && { initialTags: botTags }
@@ -48223,7 +48302,7 @@ var init_tracked_tags = __esm({
           if (user2) {
             const userTags = user2.tags;
             _TrackedTags.create({
-              client,
+              client: client2,
               type: "user",
               id: user2.id,
               ...userTags && { initialTags: userTags }
@@ -48232,7 +48311,7 @@ var init_tracked_tags = __esm({
           if (conversation) {
             const conversationTags = conversation.tags;
             _TrackedTags.create({
-              client,
+              client: client2,
               type: "conversation",
               id: conversation.id,
               ...conversationTags && { initialTags: conversationTags }
@@ -48241,7 +48320,7 @@ var init_tracked_tags = __esm({
           if (workflow) {
             const workflowTags = workflow.tags;
             _TrackedTags.create({
-              client,
+              client: client2,
               type: "workflow",
               id: workflow.id,
               ...workflowTags && { initialTags: workflowTags }
@@ -48381,6 +48460,51 @@ var init_tracked_tags = __esm({
   }
 });
 
+// src/runtime/client.ts
+import { Client as Client3 } from "@botpress/client";
+function getStandaloneClient() {
+  return getSingleton("__ADK_GLOBAL_STANDALONE_CLIENT", () => {
+    const token = process.env.BP_TOKEN || process.env.ADK_TOKEN;
+    if (!token) {
+      throw new Error(
+        'No token found. Set BP_TOKEN or ADK_TOKEN environment variable, or run this script using "adk run".'
+      );
+    }
+    const botId = process.env.ADK_BOT_ID;
+    if (!botId) {
+      throw new Error(
+        'No bot ID found. Set ADK_BOT_ID environment variable, or run this script using "adk run".'
+      );
+    }
+    const apiUrl = process.env.ADK_API_URL || "https://api.botpress.cloud";
+    return new Client3({
+      token,
+      apiUrl,
+      botId
+    });
+  });
+}
+var client;
+var init_client = __esm({
+  "src/runtime/client.ts"() {
+    "use strict";
+    init_define_BUILD();
+    init_define_PACKAGE_VERSIONS();
+    init_context();
+    init_singletons();
+    client = new Proxy({}, {
+      get(_target, prop) {
+        const contextClient = context.get("client", { optional: true });
+        if (contextClient) {
+          return contextClient[prop];
+        }
+        const standaloneClient = getStandaloneClient();
+        return standaloneClient[prop];
+      }
+    });
+  }
+});
+
 // src/runtime/index.ts
 var init_runtime2 = __esm({
   "src/runtime/index.ts"() {
@@ -48399,18 +48523,20 @@ var init_runtime2 = __esm({
     init_tracked_tags();
     init_actions();
     init_events2();
+    init_client();
   }
 });
 
 // src/library.ts
 import { z as z27 } from "@botpress/sdk";
-import { Cognitive as Cognitive2 } from "@botpress/cognitive";
+import { Cognitive as Cognitive3 } from "@botpress/cognitive";
 import { Zai as Zai2 } from "@botpress/zai";
 var init_library = __esm({
   "src/library.ts"() {
     init_define_BUILD();
     init_define_PACKAGE_VERSIONS();
     init_runtime2();
+    init_client();
     init_primitives();
     init_workflow_utils();
     init_events();
@@ -48429,7 +48555,7 @@ export {
   Action,
   Autonomous,
   BaseConversationInstance,
-  Cognitive2 as Cognitive,
+  Cognitive3 as Cognitive,
   BaseConversation as Conversation,
   DataSource2 as DataSource,
   Errors,
@@ -48443,6 +48569,7 @@ export {
   actions,
   adk,
   bot,
+  client,
   configuration,
   context,
   defineConfig,