@botpress/adk 1.13.10 → 1.13.11

package/dist/runner/index.d.ts

@@ -7,6 +7,6 @@
  * - Ad-hoc operations requiring an instantiated client
  * - Running tests (vitest etc) with programmatic API
  */
-export { ScriptRunner, runScript } from './script-runner.js';
-export type { ScriptRunnerOptions, RunScriptOptions, ScriptRunnerCredentials, RunOptions } from './script-runner.js';
+export { ScriptRunner, runScript, setupTestRuntime } from './script-runner.js';
+export type { ScriptRunnerOptions, RunScriptOptions, ScriptRunnerCredentials, RunOptions, TestRuntimeResult, SetupTestRuntimeOptions, } from './script-runner.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/runner/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC5D,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC9E,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,UAAU,EACV,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,oBAAoB,CAAA"}

package/dist/runner/script-runner.d.ts

@@ -33,6 +33,26 @@ export interface RunOptions {
     /** Whether to inherit stdio */
     inheritStdio?: boolean;
 }
+export interface TestRuntimeResult {
+    /** Path to the bot project */
+    botPath: string;
+    /** Path to the adk-runtime module that can be imported */
+    runtimePath: string;
+    /** Bot ID being used */
+    botId: string;
+    /** Workspace ID */
+    workspaceId: string;
+    /** Whether using production bot */
+    isProd: boolean;
+    /** The prepared project instance */
+    project: AgentProject;
+    /**
+     * Import and initialize the ADK runtime in the current process.
+     * Call this once before running tests that need the runtime.
+     * Returns the bot instance.
+     */
+    initialize: () => Promise<unknown>;
+}
 export declare class ScriptRunner {
     private projectPath;
     private forceRegenerate;
@@ -55,6 +75,28 @@ export declare class ScriptRunner {
      * Generate the script runner entry point that bootstraps the ADK runtime
      */
     private generateScriptRunner;
+    /**
+     * Setup the ADK runtime for use in tests (vitest, bun test, etc.)
+     *
+     * Unlike `run()`, this doesn't spawn a child process. Instead, it:
+     * 1. Prepares the bot project (generates types, etc.)
+     * 2. Sets up environment variables in the current process
+     * 3. Returns paths and an initialize() function to import the runtime
+     *
+     * Usage in tests:
+     * ```typescript
+     * import { ScriptRunner } from '@botpress/adk'
+     *
+     * const runner = new ScriptRunner({ projectPath: '.', credentials: {...} })
+     * const runtime = await runner.setupTestRuntime()
+     * await runtime.initialize()
+     *
+     * // Now you can import and use your actions, tools, etc.
+     * ```
+     */
+    setupTestRuntime(options?: {
+        env?: Record<string, string>;
+    }): Promise<TestRuntimeResult>;
     /**
      * Run a script with the ADK runtime initialized
      */
@@ -64,4 +106,55 @@ export declare class ScriptRunner {
  * Convenience function to run a script with the ADK runtime
  */
 export declare function runScript(options: RunScriptOptions): Promise<number>;
+export interface SetupTestRuntimeOptions {
+    /**
+     * Path to the agent project root.
+     * If not provided, auto-detects by walking up from CWD looking for agent.config.ts
+     */
+    projectPath?: string;
+    /**
+     * Credentials for API access.
+     * If not provided, loads from the current ADK profile (~/.adk/credentials)
+     */
+    credentials?: ScriptRunnerCredentials;
+    /** Whether to regenerate the bot project even if it exists */
+    forceRegenerate?: boolean;
+    /** Use production bot ID instead of dev bot ID (default: false, uses devId) */
+    prod?: boolean;
+    /** Additional environment variables to set */
+    env?: Record<string, string>;
+}
+/**
+ * Convenience function to setup the ADK runtime for tests.
+ *
+ * This is designed to be called from test setup (beforeAll, globalSetup, etc.)
+ * to prepare the ADK runtime environment without spawning a child process.
+ *
+ * Features:
+ * - Auto-detects project path by walking up from CWD looking for agent.config.ts
+ * - Auto-loads credentials from the current ADK profile (~/.adk/credentials)
+ * - Both can be overridden via options
+ *
+ * @example
+ * ```typescript
+ * // Minimal usage - auto-detects everything
+ * import { setupTestRuntime } from '@botpress/adk'
+ *
+ * beforeAll(async () => {
+ *   const runtime = await setupTestRuntime()
+ *   await runtime.initialize()
+ * })
+ *
+ * // With explicit options
+ * beforeAll(async () => {
+ *   const runtime = await setupTestRuntime({
+ *     projectPath: '/path/to/agent',
+ *     credentials: { token: 'custom-token', apiUrl: 'https://api.botpress.cloud' },
+ *     prod: true,
+ *   })
+ *   await runtime.initialize()
+ * })
+ * ```
+ */
+export declare function setupTestRuntime(options?: SetupTestRuntimeOptions): Promise<TestRuntimeResult>;
 //# sourceMappingURL=script-runner.d.ts.map

package/dist/runner/script-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"script-runner.d.ts","sourceRoot":"","sources":["../../src/runner/script-runner.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAOxD,MAAM,WAAW,uBAAuB;IACtC,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,cAAc;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,iCAAiC;IACjC,WAAW,EAAE,uBAAuB,CAAA;IACpC,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,+BAA+B;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,+BAA+B;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,WAAW,CAAyB;gBAEhC,OAAO,EAAE,mBAAmB;IAOxC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE,CAAC;IAqCxF;;OAEG;YACW,UAAU;IAUxB;;OAEG;YACW,oBAAoB;IAiElC;;OAEG;IACG,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC;CA0EzE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAa1E"}
+{"version":3,"file":"script-runner.d.ts","sourceRoot":"","sources":["../../src/runner/script-runner.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botpress/adk",
-  "version": "1.13.10",
+  "version": "1.13.11",
   "description": "Core ADK library for building AI agents on Botpress",
   "type": "module",
   "main": "dist/index.js",
@@ -47,7 +47,7 @@
     "@botpress/cli": "^5.1.1",
     "@botpress/client": "^1.28.0",
     "@botpress/cognitive": "^0.3.3",
-    "@botpress/runtime": "^1.13.10",
+    "@botpress/runtime": "^1.13.11",
     "@botpress/sdk": "^5.0.2",
     "@bpinternal/jex": "^1.2.4",
     "@bpinternal/yargs-extra": "^0.0.21",