donobu 5.23.0 → 5.24.0

package/dist/apis/SuitesApi.d.ts

@@ -0,0 +1,36 @@
+import type { Request, Response } from 'express';
+import type { SuitesManager } from '../managers/SuitesManager';
+import type { TestsManager } from '../managers/TestsManager';
+/**
+ * API controller for managing suites.
+ */
+export declare class SuitesApi {
+    private readonly suitesManager;
+    private readonly testsManager;
+    constructor(suitesManager: SuitesManager, testsManager: TestsManager);
+    /**
+     * GET /api/suites — list suites with optional filtering and pagination.
+     */
+    getSuites(req: Request, res: Response): Promise<void>;
+    /**
+     * POST /api/suites — create a new suite.
+     */
+    createSuite(req: Request, res: Response): Promise<void>;
+    /**
+     * GET /api/suites/:suiteId — get a suite by ID.
+     */
+    getSuite(req: Request, res: Response): Promise<void>;
+    /**
+     * PUT /api/suites/:suiteId — update an existing suite.
+     */
+    updateSuite(req: Request, res: Response): Promise<void>;
+    /**
+     * DELETE /api/suites/:suiteId — delete a suite (tests are orphaned).
+     */
+    deleteSuite(req: Request, res: Response): Promise<void>;
+    /**
+     * GET /api/suites/:suiteId/tests — list tests in a suite.
+     */
+    getSuiteTests(req: Request, res: Response): Promise<void>;
+}
+//# sourceMappingURL=SuitesApi.d.ts.map

package/dist/apis/SuitesApi.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SuitesApi = void 0;
+const CreateSuite_1 = require("../models/CreateSuite");
+const SuiteMetadata_1 = require("../models/SuiteMetadata");
+/**
+ * API controller for managing suites.
+ */
+class SuitesApi {
+    constructor(suitesManager, testsManager) {
+        this.suitesManager = suitesManager;
+        this.testsManager = testsManager;
+    }
+    /**
+     * GET /api/suites — list suites with optional filtering and pagination.
+     */
+    async getSuites(req, res) {
+        const query = SuiteMetadata_1.SuitesQuerySchema.parse(req.query);
+        const result = await this.suitesManager.getSuites(query);
+        res.json({ suites: result.items, nextPageToken: result.nextPageToken });
+    }
+    /**
+     * POST /api/suites — create a new suite.
+     */
+    async createSuite(req, res) {
+        const params = CreateSuite_1.CreateSuiteSchema.parse(req.body);
+        const suite = await this.suitesManager.createSuite(params);
+        res.json(suite);
+    }
+    /**
+     * GET /api/suites/:suiteId — get a suite by ID.
+     */
+    async getSuite(req, res) {
+        const suiteId = String(req.params.suiteId);
+        const suite = await this.suitesManager.getSuiteById(suiteId);
+        res.json(suite);
+    }
+    /**
+     * PUT /api/suites/:suiteId — update an existing suite.
+     */
+    async updateSuite(req, res) {
+        const suiteId = String(req.params.suiteId);
+        const suiteMetadata = SuiteMetadata_1.SuiteMetadataSchema.parse({
+            ...req.body,
+            id: suiteId,
+        });
+        await this.suitesManager.updateSuite(suiteMetadata);
+        res.json(suiteMetadata);
+    }
+    /**
+     * DELETE /api/suites/:suiteId — delete a suite (tests are orphaned).
+     */
+    async deleteSuite(req, res) {
+        const suiteId = String(req.params.suiteId);
+        await this.suitesManager.deleteSuite(suiteId);
+        res.status(200).json({ deleted: true });
+    }
+    /**
+     * GET /api/suites/:suiteId/tests — list tests in a suite.
+     */
+    async getSuiteTests(req, res) {
+        const suiteId = String(req.params.suiteId);
+        const result = await this.testsManager.getTests({ suiteId });
+        res.json({ tests: result.items, nextPageToken: result.nextPageToken });
+    }
+}
+exports.SuitesApi = SuitesApi;
+//# sourceMappingURL=SuitesApi.js.map

package/dist/apis/TestsApi.d.ts

@@ -0,0 +1,40 @@
+import type { Request, Response } from 'express';
+import type { DonobuFlowsManager } from '../managers/DonobuFlowsManager';
+import type { TestsManager } from '../managers/TestsManager';
+/**
+ * API controller for managing tests.
+ */
+export declare class TestsApi {
+    private readonly testsManager;
+    private readonly flowsManager;
+    constructor(testsManager: TestsManager, flowsManager: DonobuFlowsManager);
+    /**
+     * GET /api/tests — list tests with optional filtering and pagination.
+     */
+    getTests(req: Request, res: Response): Promise<void>;
+    /**
+     * POST /api/tests — create a new test.
+     */
+    createTest(req: Request, res: Response): Promise<void>;
+    /**
+     * GET /api/tests/:testId — get a test by ID.
+     */
+    getTest(req: Request, res: Response): Promise<void>;
+    /**
+     * PUT /api/tests/:testId — update an existing test.
+     */
+    updateTest(req: Request, res: Response): Promise<void>;
+    /**
+     * DELETE /api/tests/:testId — delete a test and all its flows.
+     */
+    deleteTest(req: Request, res: Response): Promise<void>;
+    /**
+     * GET /api/tests/:testId/flows — list flows for a test.
+     */
+    getTestFlows(req: Request, res: Response): Promise<void>;
+    /**
+     * POST /api/tests/:testId/run — execute a test (create a new flow from it).
+     */
+    runTest(req: Request, res: Response): Promise<void>;
+}
+//# sourceMappingURL=TestsApi.d.ts.map

package/dist/apis/TestsApi.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestsApi = void 0;
+const CreateTest_1 = require("../models/CreateTest");
+const TestMetadata_1 = require("../models/TestMetadata");
+/**
+ * API controller for managing tests.
+ */
+class TestsApi {
+    constructor(testsManager, flowsManager) {
+        this.testsManager = testsManager;
+        this.flowsManager = flowsManager;
+    }
+    /**
+     * GET /api/tests — list tests with optional filtering and pagination.
+     */
+    async getTests(req, res) {
+        const query = TestMetadata_1.TestsQuerySchema.parse(req.query);
+        const result = await this.testsManager.getTests(query);
+        res.json({ tests: result.items, nextPageToken: result.nextPageToken });
+    }
+    /**
+     * POST /api/tests — create a new test.
+     */
+    async createTest(req, res) {
+        const params = CreateTest_1.CreateTestSchema.parse(req.body);
+        const test = await this.testsManager.createTest(params);
+        res.json(test);
+    }
+    /**
+     * GET /api/tests/:testId — get a test by ID.
+     */
+    async getTest(req, res) {
+        const testId = String(req.params.testId);
+        const test = await this.testsManager.getTestById(testId);
+        res.json(test);
+    }
+    /**
+     * PUT /api/tests/:testId — update an existing test.
+     */
+    async updateTest(req, res) {
+        const testId = String(req.params.testId);
+        const testMetadata = TestMetadata_1.TestMetadataSchema.parse({
+            ...req.body,
+            id: testId,
+        });
+        await this.testsManager.updateTest(testMetadata);
+        res.json(testMetadata);
+    }
+    /**
+     * DELETE /api/tests/:testId — delete a test and all its flows.
+     */
+    async deleteTest(req, res) {
+        const testId = String(req.params.testId);
+        await this.testsManager.deleteTest(testId);
+        res.status(200).json({ deleted: true });
+    }
+    /**
+     * GET /api/tests/:testId/flows — list flows for a test.
+     */
+    async getTestFlows(req, res) {
+        const testId = String(req.params.testId);
+        const flows = await this.flowsManager.getFlows({ testId });
+        res.json({ flows: flows.items, nextPageToken: flows.nextPageToken });
+    }
+    /**
+     * POST /api/tests/:testId/run — execute a test (create a new flow from it).
+     */
+    async runTest(req, res) {
+        const testId = String(req.params.testId);
+        const newFlowConfig = await this.testsManager.getNewFlowFromTest(testId);
+        const flowHandle = await this.flowsManager.createFlow(newFlowConfig);
+        // After starting an autonomous run, switch the test to deterministic
+        // so subsequent runs replay the recorded actions.
+        if (newFlowConfig.initialRunMode === 'AUTONOMOUS') {
+            const test = await this.testsManager.getTestById(testId);
+            await this.testsManager.updateTest({
+                ...test,
+                nextRunMode: 'DETERMINISTIC',
+            });
+        }
+        res.json(flowHandle.donobuFlow.metadata);
+    }
+}
+exports.TestsApi = TestsApi;
+//# sourceMappingURL=TestsApi.js.map

package/dist/assets/openapi-schema.yaml

@@ -1496,6 +1496,7 @@ components:
         to restore when starting a flow. Exactly one variant should be provided:
         - `id` — Reference a flow by its ID and restore its persisted browser state.
         - `name` — Reference a flow by its name and restore its persisted browser state.
+        - `testId` — Reference a test by its ID and restore browser state from the most recent successful flow belonging to that test.
         - `json` — Provide the browser state inline as a JSON object.
       oneOf:
         - type: 'object'
@@ -1526,6 +1527,20 @@ components:
             value:
               type: 'string'
               description: 'The name of the flow whose browser state should be restored.'
+        - type: 'object'
+          description: 'Reference a test by ID to restore browser state from its most recent successful flow.'
+          required:
+            - 'type'
+            - 'value'
+          properties:
+            type:
+              type: 'string'
+              enum:
+                - 'testId'
+              description: 'Indicates the value is a test ID.'
+            value:
+              type: 'string'
+              description: 'A test ID. The browser state will be restored from the most recent successful flow belonging to this test.'
         - type: 'object'
           description: 'Provide browser state inline as a JSON object.'
           required:

package/dist/esm/apis/SuitesApi.d.ts

@@ -0,0 +1,36 @@
+import type { Request, Response } from 'express';
+import type { SuitesManager } from '../managers/SuitesManager';
+import type { TestsManager } from '../managers/TestsManager';
+/**
+ * API controller for managing suites.
+ */
+export declare class SuitesApi {
+    private readonly suitesManager;
+    private readonly testsManager;
+    constructor(suitesManager: SuitesManager, testsManager: TestsManager);
+    /**
+     * GET /api/suites — list suites with optional filtering and pagination.
+     */
+    getSuites(req: Request, res: Response): Promise<void>;
+    /**
+     * POST /api/suites — create a new suite.
+     */
+    createSuite(req: Request, res: Response): Promise<void>;
+    /**
+     * GET /api/suites/:suiteId — get a suite by ID.
+     */
+    getSuite(req: Request, res: Response): Promise<void>;
+    /**
+     * PUT /api/suites/:suiteId — update an existing suite.
+     */
+    updateSuite(req: Request, res: Response): Promise<void>;
+    /**
+     * DELETE /api/suites/:suiteId — delete a suite (tests are orphaned).
+     */
+    deleteSuite(req: Request, res: Response): Promise<void>;
+    /**
+     * GET /api/suites/:suiteId/tests — list tests in a suite.
+     */
+    getSuiteTests(req: Request, res: Response): Promise<void>;
+}
+//# sourceMappingURL=SuitesApi.d.ts.map

package/dist/esm/apis/SuitesApi.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SuitesApi = void 0;
+const CreateSuite_1 = require("../models/CreateSuite");
+const SuiteMetadata_1 = require("../models/SuiteMetadata");
+/**
+ * API controller for managing suites.
+ */
+class SuitesApi {
+    constructor(suitesManager, testsManager) {
+        this.suitesManager = suitesManager;
+        this.testsManager = testsManager;
+    }
+    /**
+     * GET /api/suites — list suites with optional filtering and pagination.
+     */
+    async getSuites(req, res) {
+        const query = SuiteMetadata_1.SuitesQuerySchema.parse(req.query);
+        const result = await this.suitesManager.getSuites(query);
+        res.json({ suites: result.items, nextPageToken: result.nextPageToken });
+    }
+    /**
+     * POST /api/suites — create a new suite.
+     */
+    async createSuite(req, res) {
+        const params = CreateSuite_1.CreateSuiteSchema.parse(req.body);
+        const suite = await this.suitesManager.createSuite(params);
+        res.json(suite);
+    }
+    /**
+     * GET /api/suites/:suiteId — get a suite by ID.
+     */
+    async getSuite(req, res) {
+        const suiteId = String(req.params.suiteId);
+        const suite = await this.suitesManager.getSuiteById(suiteId);
+        res.json(suite);
+    }
+    /**
+     * PUT /api/suites/:suiteId — update an existing suite.
+     */
+    async updateSuite(req, res) {
+        const suiteId = String(req.params.suiteId);
+        const suiteMetadata = SuiteMetadata_1.SuiteMetadataSchema.parse({
+            ...req.body,
+            id: suiteId,
+        });
+        await this.suitesManager.updateSuite(suiteMetadata);
+        res.json(suiteMetadata);
+    }
+    /**
+     * DELETE /api/suites/:suiteId — delete a suite (tests are orphaned).
+     */
+    async deleteSuite(req, res) {
+        const suiteId = String(req.params.suiteId);
+        await this.suitesManager.deleteSuite(suiteId);
+        res.status(200).json({ deleted: true });
+    }
+    /**
+     * GET /api/suites/:suiteId/tests — list tests in a suite.
+     */
+    async getSuiteTests(req, res) {
+        const suiteId = String(req.params.suiteId);
+        const result = await this.testsManager.getTests({ suiteId });
+        res.json({ tests: result.items, nextPageToken: result.nextPageToken });
+    }
+}
+exports.SuitesApi = SuitesApi;
+//# sourceMappingURL=SuitesApi.js.map

package/dist/esm/apis/TestsApi.d.ts

@@ -0,0 +1,40 @@
+import type { Request, Response } from 'express';
+import type { DonobuFlowsManager } from '../managers/DonobuFlowsManager';
+import type { TestsManager } from '../managers/TestsManager';
+/**
+ * API controller for managing tests.
+ */
+export declare class TestsApi {
+    private readonly testsManager;
+    private readonly flowsManager;
+    constructor(testsManager: TestsManager, flowsManager: DonobuFlowsManager);
+    /**
+     * GET /api/tests — list tests with optional filtering and pagination.
+     */
+    getTests(req: Request, res: Response): Promise<void>;
+    /**
+     * POST /api/tests — create a new test.
+     */
+    createTest(req: Request, res: Response): Promise<void>;
+    /**
+     * GET /api/tests/:testId — get a test by ID.
+     */
+    getTest(req: Request, res: Response): Promise<void>;
+    /**
+     * PUT /api/tests/:testId — update an existing test.
+     */
+    updateTest(req: Request, res: Response): Promise<void>;
+    /**
+     * DELETE /api/tests/:testId — delete a test and all its flows.
+     */
+    deleteTest(req: Request, res: Response): Promise<void>;
+    /**
+     * GET /api/tests/:testId/flows — list flows for a test.
+     */
+    getTestFlows(req: Request, res: Response): Promise<void>;
+    /**
+     * POST /api/tests/:testId/run — execute a test (create a new flow from it).
+     */
+    runTest(req: Request, res: Response): Promise<void>;
+}
+//# sourceMappingURL=TestsApi.d.ts.map

package/dist/esm/apis/TestsApi.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestsApi = void 0;
+const CreateTest_1 = require("../models/CreateTest");
+const TestMetadata_1 = require("../models/TestMetadata");
+/**
+ * API controller for managing tests.
+ */
+class TestsApi {
+    constructor(testsManager, flowsManager) {
+        this.testsManager = testsManager;
+        this.flowsManager = flowsManager;
+    }
+    /**
+     * GET /api/tests — list tests with optional filtering and pagination.
+     */
+    async getTests(req, res) {
+        const query = TestMetadata_1.TestsQuerySchema.parse(req.query);
+        const result = await this.testsManager.getTests(query);
+        res.json({ tests: result.items, nextPageToken: result.nextPageToken });
+    }
+    /**
+     * POST /api/tests — create a new test.
+     */
+    async createTest(req, res) {
+        const params = CreateTest_1.CreateTestSchema.parse(req.body);
+        const test = await this.testsManager.createTest(params);
+        res.json(test);
+    }
+    /**
+     * GET /api/tests/:testId — get a test by ID.
+     */
+    async getTest(req, res) {
+        const testId = String(req.params.testId);
+        const test = await this.testsManager.getTestById(testId);
+        res.json(test);
+    }
+    /**
+     * PUT /api/tests/:testId — update an existing test.
+     */
+    async updateTest(req, res) {
+        const testId = String(req.params.testId);
+        const testMetadata = TestMetadata_1.TestMetadataSchema.parse({
+            ...req.body,
+            id: testId,
+        });
+        await this.testsManager.updateTest(testMetadata);
+        res.json(testMetadata);
+    }
+    /**
+     * DELETE /api/tests/:testId — delete a test and all its flows.
+     */
+    async deleteTest(req, res) {
+        const testId = String(req.params.testId);
+        await this.testsManager.deleteTest(testId);
+        res.status(200).json({ deleted: true });
+    }
+    /**
+     * GET /api/tests/:testId/flows — list flows for a test.
+     */
+    async getTestFlows(req, res) {
+        const testId = String(req.params.testId);
+        const flows = await this.flowsManager.getFlows({ testId });
+        res.json({ flows: flows.items, nextPageToken: flows.nextPageToken });
+    }
+    /**
+     * POST /api/tests/:testId/run — execute a test (create a new flow from it).
+     */
+    async runTest(req, res) {
+        const testId = String(req.params.testId);
+        const newFlowConfig = await this.testsManager.getNewFlowFromTest(testId);
+        const flowHandle = await this.flowsManager.createFlow(newFlowConfig);
+        // After starting an autonomous run, switch the test to deterministic
+        // so subsequent runs replay the recorded actions.
+        if (newFlowConfig.initialRunMode === 'AUTONOMOUS') {
+            const test = await this.testsManager.getTestById(testId);
+            await this.testsManager.updateTest({
+                ...test,
+                nextRunMode: 'DETERMINISTIC',
+            });
+        }
+        res.json(flowHandle.donobuFlow.metadata);
+    }
+}
+exports.TestsApi = TestsApi;
+//# sourceMappingURL=TestsApi.js.map

package/dist/esm/assets/openapi-schema.yaml

@@ -1496,6 +1496,7 @@ components:
         to restore when starting a flow. Exactly one variant should be provided:
         - `id` — Reference a flow by its ID and restore its persisted browser state.
         - `name` — Reference a flow by its name and restore its persisted browser state.
+        - `testId` — Reference a test by its ID and restore browser state from the most recent successful flow belonging to that test.
         - `json` — Provide the browser state inline as a JSON object.
       oneOf:
         - type: 'object'
@@ -1526,6 +1527,20 @@ components:
             value:
               type: 'string'
               description: 'The name of the flow whose browser state should be restored.'
+        - type: 'object'
+          description: 'Reference a test by ID to restore browser state from its most recent successful flow.'
+          required:
+            - 'type'
+            - 'value'
+          properties:
+            type:
+              type: 'string'
+              enum:
+                - 'testId'
+              description: 'Indicates the value is a test ID.'
+            value:
+              type: 'string'
+              description: 'A test ID. The browser state will be restored from the most recent successful flow belonging to this test.'
         - type: 'object'
           description: 'Provide browser state inline as a JSON object.'
           required:

package/dist/esm/main.d.ts

@@ -30,6 +30,7 @@ export type * from './managers/TargetInspector';
 export { ToolManager } from './managers/ToolManager';
 export { createDefaultToolRegistry, type ToolRegistry, } from './managers/ToolRegistry';
 export * from './managers/WebTargetInspector';
+export type * from './models/AiQuery';
 export type * from './models/AuditReport';
 export * from './models/BrowserStorageState';
 export * from './models/CodeGenerationOptions';

package/dist/esm/managers/AdminApiController.d.ts

@@ -105,6 +105,14 @@ export declare class AdminApiController {
      * Registers flow-related routes.
      */
     private static registerFlowRoutes;
+    /**
+     * Registers test-related routes.
+     */
+    private static registerTestRoutes;
+    /**
+     * Registers suite-related routes.
+     */
+    private static registerSuiteRoutes;
     /**
      * Registers utility routes (version, ping).
      */

package/dist/esm/managers/AdminApiController.js

@@ -16,7 +16,9 @@ const FlowsToolCallsApi_1 = require("../apis/FlowsToolCallsApi");
 const GptConfigsApi_1 = require("../apis/GptConfigsApi");
 const PingApi_1 = require("../apis/PingApi");
 const SchemaApi_1 = require("../apis/SchemaApi");
+const SuitesApi_1 = require("../apis/SuitesApi");
 const TargetsApi_1 = require("../apis/TargetsApi");
+const TestsApi_1 = require("../apis/TestsApi");
 const ToolsApi_1 = require("../apis/ToolsApi");
 const DonobuException_1 = require("../exceptions/DonobuException");
 const Logger_1 = require("../utils/Logger");
@@ -239,6 +241,8 @@ class AdminApiController {
             flowsFilesApi: new FlowsFilesApi_1.FlowsFilesApi(donobuStack.flowsPersistenceRegistry),
             flowsToolCallsApi: new FlowsToolCallsApi_1.FlowsToolCallsApi(donobuStack.flowsManager),
             flowsAiQueriesApi: new FlowsAiQueriesApi_1.FlowsAiQueriesApi(donobuStack.flowsManager),
+            testsApi: new TestsApi_1.TestsApi(donobuStack.testsManager, donobuStack.flowsManager),
+            suitesApi: new SuitesApi_1.SuitesApi(donobuStack.suitesManager, donobuStack.testsManager),
             pingApi: new PingApi_1.PingApi(),
             schemaApi: new SchemaApi_1.SchemaApi(),
             targetsApi: new TargetsApi_1.TargetsApi(donobuStack.targetRuntimePlugins),
@@ -290,6 +294,8 @@ class AdminApiController {
         app.get('/api/tools', this.asyncHandler(apis.toolsApi.getSupportedTools.bind(apis.toolsApi)));
         app.get('/api/targets', this.asyncHandler(apis.targetsApi.getTargets.bind(apis.targetsApi)));
         this.registerFlowRoutes(app, apis);
+        this.registerTestRoutes(app, apis);
+        this.registerSuiteRoutes(app, apis);
         this.registerUtilityRoutes(app, apis);
     }
     /**
@@ -313,6 +319,29 @@ class AdminApiController {
         app.get('/api/flows/:flowId/ai-queries', this.asyncHandler(apis.flowsAiQueriesApi.getAiQueries.bind(apis.flowsAiQueriesApi)));
         app.get('/api/flows/:flowId/logs', this.asyncHandler(apis.flowsApi.getFlowLogs.bind(apis.flowsApi)));
     }
+    /**
+     * Registers test-related routes.
+     */
+    static registerTestRoutes(app, apis) {
+        app.get('/api/tests', this.asyncHandler(apis.testsApi.getTests.bind(apis.testsApi)));
+        app.post('/api/tests', this.asyncHandler(apis.testsApi.createTest.bind(apis.testsApi)));
+        app.get('/api/tests/:testId', this.asyncHandler(apis.testsApi.getTest.bind(apis.testsApi)));
+        app.put('/api/tests/:testId', this.asyncHandler(apis.testsApi.updateTest.bind(apis.testsApi)));
+        app.delete('/api/tests/:testId', this.asyncHandler(apis.testsApi.deleteTest.bind(apis.testsApi)));
+        app.get('/api/tests/:testId/flows', this.asyncHandler(apis.testsApi.getTestFlows.bind(apis.testsApi)));
+        app.post('/api/tests/:testId/run', this.asyncHandler(apis.testsApi.runTest.bind(apis.testsApi)));
+    }
+    /**
+     * Registers suite-related routes.
+     */
+    static registerSuiteRoutes(app, apis) {
+        app.get('/api/suites', this.asyncHandler(apis.suitesApi.getSuites.bind(apis.suitesApi)));
+        app.post('/api/suites', this.asyncHandler(apis.suitesApi.createSuite.bind(apis.suitesApi)));
+        app.get('/api/suites/:suiteId', this.asyncHandler(apis.suitesApi.getSuite.bind(apis.suitesApi)));
+        app.put('/api/suites/:suiteId', this.asyncHandler(apis.suitesApi.updateSuite.bind(apis.suitesApi)));
+        app.delete('/api/suites/:suiteId', this.asyncHandler(apis.suitesApi.deleteSuite.bind(apis.suitesApi)));
+        app.get('/api/suites/:suiteId/tests', this.asyncHandler(apis.suitesApi.getSuiteTests.bind(apis.suitesApi)));
+    }
     /**
      * Registers utility routes (version, ping).
      */

package/dist/esm/managers/DonobuFlowsManager.d.ts

@@ -18,6 +18,8 @@ import type { FlowMetadata } from '../models/FlowMetadata';
 import type { FlowsQuery } from '../models/FlowMetadata';
 import type { PaginatedResult } from '../models/PaginatedResult';
 import type { ProposedToolCall } from '../models/ProposedToolCall';
+import type { RunConfig } from '../models/RunConfig';
+import type { RunMode } from '../models/RunMode';
 import type { ToolCall } from '../models/ToolCall';
 import type { FlowsPersistenceRegistry } from '../persistence/flows/FlowsPersistenceRegistry';
 import type { TargetRuntimePluginRegistry } from '../targets/TargetRuntimePlugin';
@@ -64,14 +66,40 @@ export declare class DonobuFlowsManager {
     createFlow(flowParams: CreateDonobuFlow, gptClient?: GptClient, browserContextOverride?: BrowserContext): Promise<FlowHandle>;
     getFlowLogs(flowId: string): Promise<FlowLogSnapshot>;
     renameFlow(flowId: string, name: string | null): Promise<FlowMetadata>;
+    /**
+     * Converts a prior flow's tool calls into a list of tool calls to invoke when
+     * starting a new flow as a rerun (i.e. without agentic decisioning).
+     *
+     * @param priorFlowMetadata The metadata of the flow to prepare as a rerun.
+     * @param options           The code generation options to use for the rerun.
+     *
+     * @returns A list of tool calls to invoke when starting the flow.
+     */
+    getToolCallsForRerun(priorFlowMetadata: FlowMetadata, options: CodeGenerationOptions): Promise<ProposedToolCall[]>;
     /**
      * Loads the given flow by ID and returns a `CreateDonobuFlow` object that can be passed to `createFlow`
-     * as to execute the flow as a rerun (i.e. without agentic decisioning).
+     * to execute the flow as a rerun (i.e. without agentic decisioning).
      *
      * @param flowId The ID of the flow to prepare as a rerun.
      * @returns Parameters that can be passed to createFlow to execute the flow as a rerun.
      */
     getFlowAsRerun(flowId: string, options: CodeGenerationOptions): Promise<CreateDonobuFlow>;
+    /**
+     * Takes a RunConfig object, or anything derived from it (FlowMetadata,
+     * TestMetadata), plus some additional parameters, and returns a
+     * CreateDonobuFlow object that can be passed to `createFlow` to execute the
+     * flow.
+     *
+     * @param name             The name for the new flow
+     * @param runMode          The run mode to be used for the flow
+     * @param config           The RunConfig object
+     * @param toolCallsOnStart An ordered series of tool calls to invoke when
+     *                         starting the flow
+     *
+     * @returns A CreateDonobuFlow object that can be passed to createFlow to
+     * execute the flow.
+     */
+    getFlowFromConfigAndToolCalls(name: string, runMode: RunMode, config: RunConfig, toolCallsOnStart: ProposedToolCall[]): CreateDonobuFlow;
     /** Add a proposed tool call the tool call queue for the given flow by ID. */
     proposeToolCall(flowId: string, toolName: string, parameters: Record<string, unknown>): Promise<void>;
     /**