donobu 5.49.0 → 5.51.0

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

@@ -50,7 +50,7 @@ export declare class DonobuFlowsManager {
     static readonly DEFAULT_MESSAGE_DURATION = 2247;
     static readonly DEFAULT_MAX_TOOL_CALLS = 50;
     static readonly DEFAULT_BROWSER_STATE_FILENAME = "browserstate.json";
-    static readonly FLOW_NAME_MAX_LENGTH = 255;
+    static readonly FLOW_NAME_MAX_LENGTH = 1024;
     private readonly flowRuntime;
     private readonly flowCatalog;
     constructor(deploymentEnvironment: DonobuDeploymentEnvironment, gptClientFactory: GptClientFactory, gptConfigsManager: GptConfigsManager, agentsManager: AgentsManager, flowsPersistenceRegistry: FlowsPersistenceRegistry, envDataManager: EnvDataManager, controlPanelFactory: ControlPanelFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'ANTHROPIC_MODEL_NAME' | 'AWS_ACCESS_KEY_ID' | 'AWS_BEDROCK_MODEL_NAME' | 'AWS_SECRET_ACCESS_KEY' | 'BASE64_GPT_CONFIG' | 'BROWSERBASE_API_KEY' | 'BROWSERBASE_PROJECT_ID' | 'DONOBU_API_KEY' | 'GOOGLE_GENERATIVE_AI_API_KEY' | 'GOOGLE_GENERATIVE_AI_MODEL_NAME' | 'OLLAMA_API_URL' | 'OLLAMA_MODEL_NAME' | 'OPENAI_API_KEY' | 'OPENAI_API_MODEL_NAME'>, toolRegistry: ToolRegistry, targetRuntimePlugins: TargetRuntimePluginRegistry, testsPersistenceRegistry: TestsPersistenceRegistry);

package/dist/esm/managers/DonobuFlowsManager.js

@@ -51,6 +51,7 @@ const InvalidParamValueException_1 = require("../exceptions/InvalidParamValueExc
 const TestNotFoundException_1 = require("../exceptions/TestNotFoundException");
 const ToolRequiresGptException_1 = require("../exceptions/ToolRequiresGptException");
 const UnknownToolException_1 = require("../exceptions/UnknownToolException");
+const CreateDonobuFlow_1 = require("../models/CreateDonobuFlow");
 const GptConfig_1 = require("../models/GptConfig");
 const resolveTargetRuntime_1 = require("../targets/resolveTargetRuntime");
 const CustomToolRunnerTool_1 = require("../tools/CustomToolRunnerTool");
@@ -736,7 +737,10 @@ DonobuFlowsManager.DEFAULT_MESSAGE_DURATION = 2247;
 // value in createFlowDefaults in flow-types.ts.
 DonobuFlowsManager.DEFAULT_MAX_TOOL_CALLS = 50;
 DonobuFlowsManager.DEFAULT_BROWSER_STATE_FILENAME = 'browserstate.json';
-DonobuFlowsManager.FLOW_NAME_MAX_LENGTH = 255;
+// Re-exported from models/CreateDonobuFlow so existing callers can keep using
+// DonobuFlowsManager.FLOW_NAME_MAX_LENGTH. The source of truth (and the
+// rationale for keeping it in sync with the donobu-api gateway) lives there.
+DonobuFlowsManager.FLOW_NAME_MAX_LENGTH = CreateDonobuFlow_1.FLOW_NAME_MAX_LENGTH;
 /**
  * Extracts environment variable names from the given objective and combines
  * it with the given explicitly allowed variables.

package/dist/esm/models/CreateDonobuFlow.d.ts

@@ -1,4 +1,11 @@
 import { z } from 'zod/v4';
+/**
+ * Maximum length for a flow's human-readable name. Must stay in sync with the
+ * limit enforced by the donobu-api gateway (z.string().max(...) in its flow
+ * schema); a longer name causes the remote setFlowMetadata request to be
+ * rejected. Also re-exported as DonobuFlowsManager.FLOW_NAME_MAX_LENGTH.
+ */
+export declare const FLOW_NAME_MAX_LENGTH = 1024;
 export declare const CreateDonobuFlowSchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodString>;
     target: z.ZodString;

package/dist/esm/models/CreateDonobuFlow.js

@@ -1,11 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateDonobuFlowSchema = void 0;
+exports.CreateDonobuFlowSchema = exports.FLOW_NAME_MAX_LENGTH = void 0;
 const v4_1 = require("zod/v4");
 const BrowserConfig_1 = require("./BrowserConfig");
 const FlowMetadata_1 = require("./FlowMetadata");
 const ProposedToolCall_1 = require("./ProposedToolCall");
 const RunMode_1 = require("./RunMode");
+/**
+ * Maximum length for a flow's human-readable name. Must stay in sync with the
+ * limit enforced by the donobu-api gateway (z.string().max(...) in its flow
+ * schema); a longer name causes the remote setFlowMetadata request to be
+ * rejected. Also re-exported as DonobuFlowsManager.FLOW_NAME_MAX_LENGTH.
+ */
+exports.FLOW_NAME_MAX_LENGTH = 1024;
 exports.CreateDonobuFlowSchema = v4_1.z
     .looseObject({
     id: v4_1.z
@@ -38,10 +45,10 @@ not need this, omit it and let the SDK mint an ID.`),
     // -- Target-invariant fields --
     name: v4_1.z
         .string()
-        .max(256)
+        .max(exports.FLOW_NAME_MAX_LENGTH)
         .nullable()
         .optional()
-        .describe('The name for this Donobu flow; if present, must be fewer than 256 characters'),
+        .describe(`The name for this Donobu flow; if present, must be at most ${exports.FLOW_NAME_MAX_LENGTH} characters`),
     envVars: FlowMetadata_1.FlowMetadataSchema.shape.envVars.nullable().optional(),
     customTools: FlowMetadata_1.FlowMetadataSchema.shape.customTools.nullable().optional(),
     defaultMessageDuration: FlowMetadata_1.FlowMetadataSchema.shape.defaultMessageDuration

package/dist/esm/models/CreateSuite.d.ts

@@ -1,4 +1,10 @@
 import { z } from 'zod/v4';
+/**
+ * Maximum length for a suite's human-readable name. Must stay in sync with the
+ * limit enforced by the donobu-api gateway (z.string().max(...) in its suite
+ * schema); a longer name causes the remote metadata request to be rejected.
+ */
+export declare const SUITE_NAME_MAX_LENGTH = 1024;
 /**
  * Payload for creating a new suite.  Uses the RunConfig fields (all made
  * optional as defaults) plus suite-specific fields like name and description.

package/dist/esm/models/CreateSuite.js

@@ -1,16 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateSuiteSchema = void 0;
+exports.CreateSuiteSchema = exports.SUITE_NAME_MAX_LENGTH = void 0;
 const v4_1 = require("zod/v4");
 const BrowserConfig_1 = require("./BrowserConfig");
 const RunConfig_1 = require("./RunConfig");
+/**
+ * Maximum length for a suite's human-readable name. Must stay in sync with the
+ * limit enforced by the donobu-api gateway (z.string().max(...) in its suite
+ * schema); a longer name causes the remote metadata request to be rejected.
+ */
+exports.SUITE_NAME_MAX_LENGTH = 1024;
 /**
  * Payload for creating a new suite.  Uses the RunConfig fields (all made
  * optional as defaults) plus suite-specific fields like name and description.
  */
 exports.CreateSuiteSchema = RunConfig_1.RunConfigSchema.partial()
     .extend({
-    name: v4_1.z.string().max(256).describe('The name for this suite (required).'),
+    name: v4_1.z
+        .string()
+        .max(exports.SUITE_NAME_MAX_LENGTH)
+        .describe('The name for this suite (required).'),
     description: v4_1.z
         .string()
         .nullable()

package/dist/esm/models/CreateTest.d.ts

@@ -1,4 +1,10 @@
 import { z } from 'zod/v4';
+/**
+ * Maximum length for a test's human-readable name. Must stay in sync with the
+ * limit enforced by the donobu-api gateway (z.string().max(...) in its test
+ * schema); a longer name causes the remote metadata request to be rejected.
+ */
+export declare const TEST_NAME_MAX_LENGTH = 1024;
 /**
  * Payload for creating a new test.  Uses the RunConfig fields (all made
  * nullable/optional for creation) plus test-specific fields like suiteId

package/dist/esm/models/CreateTest.js

@@ -1,10 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateTestSchema = void 0;
+exports.CreateTestSchema = exports.TEST_NAME_MAX_LENGTH = void 0;
 const v4_1 = require("zod/v4");
 const BrowserConfig_1 = require("./BrowserConfig");
 const RunConfig_1 = require("./RunConfig");
 const RunMode_1 = require("./RunMode");
+/**
+ * Maximum length for a test's human-readable name. Must stay in sync with the
+ * limit enforced by the donobu-api gateway (z.string().max(...) in its test
+ * schema); a longer name causes the remote metadata request to be rejected.
+ */
+exports.TEST_NAME_MAX_LENGTH = 1024;
 /**
  * Payload for creating a new test.  Uses the RunConfig fields (all made
  * nullable/optional for creation) plus test-specific fields like suiteId
@@ -24,7 +30,7 @@ exports.CreateTestSchema = RunConfig_1.RunConfigSchema.partial()
         .describe('Web target configuration. Required when target is "web".'),
     name: v4_1.z
         .string()
-        .max(256)
+        .max(exports.TEST_NAME_MAX_LENGTH)
         .nullable()
         .optional()
         .describe('The name for this test.'),

package/dist/esm/models/FlowMetadata.d.ts

@@ -197,6 +197,7 @@ export declare const FlowMetadataSchema: z.ZodObject<{
             branch: z.ZodOptional<z.ZodString>;
             dirty: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$loose>>;
+        runId: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
 export type FlowMetadata = z.infer<typeof FlowMetadataSchema>;

package/dist/esm/models/Provenance.d.ts

@@ -38,6 +38,7 @@ export declare const ProvenanceSchema: z.ZodObject<{
         branch: z.ZodOptional<z.ZodString>;
         dirty: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$loose>>;
+    runId: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
 export type Provenance = z.infer<typeof ProvenanceSchema>;
 //# sourceMappingURL=Provenance.d.ts.map

package/dist/esm/models/Provenance.js

@@ -55,6 +55,15 @@ exports.ProvenanceSchema = v4_1.z
         'no CI markers were detected.'),
     git: exports.GitProvenanceSchema.optional().describe('Git working-tree context at creation time. Absent when the CWD is ' +
         'not a git repo or `git` is unavailable.'),
+    runId: v4_1.z
+        .string()
+        .optional()
+        .describe('Stable identifier for the CI/CD invocation (or local test run) that ' +
+        'produced this flow. Read verbatim from the DONOBU_RUN_ID environment ' +
+        'variable, which the test runner is responsible for setting (so every ' +
+        'flow in the same run shares it and it differs across runs). Absent ' +
+        'for flows created before runId capture, or by a run that did not set ' +
+        'DONOBU_RUN_ID.'),
 })
     .loose();
 //# sourceMappingURL=Provenance.js.map

package/dist/esm/models/SuiteMetadata.d.ts

@@ -156,6 +156,7 @@ export declare const SuiteMetadataSchema: z.ZodObject<{
             branch: z.ZodOptional<z.ZodString>;
             dirty: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$loose>>;
+        runId: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
 export type SuiteMetadata = z.infer<typeof SuiteMetadataSchema>;

package/dist/esm/models/TestMetadata.d.ts

@@ -159,6 +159,7 @@ export declare const TestMetadataSchema: z.ZodObject<{
             branch: z.ZodOptional<z.ZodString>;
             dirty: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$loose>>;
+        runId: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
 export type TestMetadata = z.infer<typeof TestMetadataSchema>;
@@ -340,6 +341,7 @@ export declare const TestListItemSchema: z.ZodObject<{
             branch: z.ZodOptional<z.ZodString>;
             dirty: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$loose>>;
+        runId: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
     flowCount: z.ZodNumber;
     latestFlow: z.ZodNullable<z.ZodObject<{
@@ -528,6 +530,7 @@ export declare const TestListItemSchema: z.ZodObject<{
                 branch: z.ZodOptional<z.ZodString>;
                 dirty: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$loose>>;
+            runId: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
@@ -688,6 +691,7 @@ export declare const TestListItemPaginatedResultSchema: z.ZodObject<{
                 branch: z.ZodOptional<z.ZodString>;
                 dirty: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$loose>>;
+            runId: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>;
         flowCount: z.ZodNumber;
         latestFlow: z.ZodNullable<z.ZodObject<{
@@ -876,6 +880,7 @@ export declare const TestListItemPaginatedResultSchema: z.ZodObject<{
                     branch: z.ZodOptional<z.ZodString>;
                     dirty: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$loose>>;
+                runId: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>>;
         }, z.core.$loose>>;
     }, z.core.$loose>>;

package/dist/esm/utils/buildProvenance.js

@@ -96,6 +96,7 @@ function buildProvenance(source) {
         hostname,
         ci: isCode ? detectCi() : undefined,
         git: isCode ? detectGit() : undefined,
+        runId: process.env.DONOBU_RUN_ID,
     };
 }
 //# sourceMappingURL=buildProvenance.js.map

package/dist/managers/DonobuFlowsManager.d.ts

@@ -50,7 +50,7 @@ export declare class DonobuFlowsManager {
     static readonly DEFAULT_MESSAGE_DURATION = 2247;
     static readonly DEFAULT_MAX_TOOL_CALLS = 50;
     static readonly DEFAULT_BROWSER_STATE_FILENAME = "browserstate.json";
-    static readonly FLOW_NAME_MAX_LENGTH = 255;
+    static readonly FLOW_NAME_MAX_LENGTH = 1024;
     private readonly flowRuntime;
     private readonly flowCatalog;
     constructor(deploymentEnvironment: DonobuDeploymentEnvironment, gptClientFactory: GptClientFactory, gptConfigsManager: GptConfigsManager, agentsManager: AgentsManager, flowsPersistenceRegistry: FlowsPersistenceRegistry, envDataManager: EnvDataManager, controlPanelFactory: ControlPanelFactory, environ: EnvPick<typeof env, 'ANTHROPIC_API_KEY' | 'ANTHROPIC_MODEL_NAME' | 'AWS_ACCESS_KEY_ID' | 'AWS_BEDROCK_MODEL_NAME' | 'AWS_SECRET_ACCESS_KEY' | 'BASE64_GPT_CONFIG' | 'BROWSERBASE_API_KEY' | 'BROWSERBASE_PROJECT_ID' | 'DONOBU_API_KEY' | 'GOOGLE_GENERATIVE_AI_API_KEY' | 'GOOGLE_GENERATIVE_AI_MODEL_NAME' | 'OLLAMA_API_URL' | 'OLLAMA_MODEL_NAME' | 'OPENAI_API_KEY' | 'OPENAI_API_MODEL_NAME'>, toolRegistry: ToolRegistry, targetRuntimePlugins: TargetRuntimePluginRegistry, testsPersistenceRegistry: TestsPersistenceRegistry);

package/dist/managers/DonobuFlowsManager.js

@@ -51,6 +51,7 @@ const InvalidParamValueException_1 = require("../exceptions/InvalidParamValueExc
 const TestNotFoundException_1 = require("../exceptions/TestNotFoundException");
 const ToolRequiresGptException_1 = require("../exceptions/ToolRequiresGptException");
 const UnknownToolException_1 = require("../exceptions/UnknownToolException");
+const CreateDonobuFlow_1 = require("../models/CreateDonobuFlow");
 const GptConfig_1 = require("../models/GptConfig");
 const resolveTargetRuntime_1 = require("../targets/resolveTargetRuntime");
 const CustomToolRunnerTool_1 = require("../tools/CustomToolRunnerTool");
@@ -736,7 +737,10 @@ DonobuFlowsManager.DEFAULT_MESSAGE_DURATION = 2247;
 // value in createFlowDefaults in flow-types.ts.
 DonobuFlowsManager.DEFAULT_MAX_TOOL_CALLS = 50;
 DonobuFlowsManager.DEFAULT_BROWSER_STATE_FILENAME = 'browserstate.json';
-DonobuFlowsManager.FLOW_NAME_MAX_LENGTH = 255;
+// Re-exported from models/CreateDonobuFlow so existing callers can keep using
+// DonobuFlowsManager.FLOW_NAME_MAX_LENGTH. The source of truth (and the
+// rationale for keeping it in sync with the donobu-api gateway) lives there.
+DonobuFlowsManager.FLOW_NAME_MAX_LENGTH = CreateDonobuFlow_1.FLOW_NAME_MAX_LENGTH;
 /**
  * Extracts environment variable names from the given objective and combines
  * it with the given explicitly allowed variables.

package/dist/models/CreateDonobuFlow.d.ts

@@ -1,4 +1,11 @@
 import { z } from 'zod/v4';
+/**
+ * Maximum length for a flow's human-readable name. Must stay in sync with the
+ * limit enforced by the donobu-api gateway (z.string().max(...) in its flow
+ * schema); a longer name causes the remote setFlowMetadata request to be
+ * rejected. Also re-exported as DonobuFlowsManager.FLOW_NAME_MAX_LENGTH.
+ */
+export declare const FLOW_NAME_MAX_LENGTH = 1024;
 export declare const CreateDonobuFlowSchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodString>;
     target: z.ZodString;

package/dist/models/CreateDonobuFlow.js

@@ -1,11 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateDonobuFlowSchema = void 0;
+exports.CreateDonobuFlowSchema = exports.FLOW_NAME_MAX_LENGTH = void 0;
 const v4_1 = require("zod/v4");
 const BrowserConfig_1 = require("./BrowserConfig");
 const FlowMetadata_1 = require("./FlowMetadata");
 const ProposedToolCall_1 = require("./ProposedToolCall");
 const RunMode_1 = require("./RunMode");
+/**
+ * Maximum length for a flow's human-readable name. Must stay in sync with the
+ * limit enforced by the donobu-api gateway (z.string().max(...) in its flow
+ * schema); a longer name causes the remote setFlowMetadata request to be
+ * rejected. Also re-exported as DonobuFlowsManager.FLOW_NAME_MAX_LENGTH.
+ */
+exports.FLOW_NAME_MAX_LENGTH = 1024;
 exports.CreateDonobuFlowSchema = v4_1.z
     .looseObject({
     id: v4_1.z
@@ -38,10 +45,10 @@ not need this, omit it and let the SDK mint an ID.`),
     // -- Target-invariant fields --
     name: v4_1.z
         .string()
-        .max(256)
+        .max(exports.FLOW_NAME_MAX_LENGTH)
         .nullable()
         .optional()
-        .describe('The name for this Donobu flow; if present, must be fewer than 256 characters'),
+        .describe(`The name for this Donobu flow; if present, must be at most ${exports.FLOW_NAME_MAX_LENGTH} characters`),
     envVars: FlowMetadata_1.FlowMetadataSchema.shape.envVars.nullable().optional(),
     customTools: FlowMetadata_1.FlowMetadataSchema.shape.customTools.nullable().optional(),
     defaultMessageDuration: FlowMetadata_1.FlowMetadataSchema.shape.defaultMessageDuration

package/dist/models/CreateSuite.d.ts

@@ -1,4 +1,10 @@
 import { z } from 'zod/v4';
+/**
+ * Maximum length for a suite's human-readable name. Must stay in sync with the
+ * limit enforced by the donobu-api gateway (z.string().max(...) in its suite
+ * schema); a longer name causes the remote metadata request to be rejected.
+ */
+export declare const SUITE_NAME_MAX_LENGTH = 1024;
 /**
  * Payload for creating a new suite.  Uses the RunConfig fields (all made
  * optional as defaults) plus suite-specific fields like name and description.

package/dist/models/CreateSuite.js

@@ -1,16 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateSuiteSchema = void 0;
+exports.CreateSuiteSchema = exports.SUITE_NAME_MAX_LENGTH = void 0;
 const v4_1 = require("zod/v4");
 const BrowserConfig_1 = require("./BrowserConfig");
 const RunConfig_1 = require("./RunConfig");
+/**
+ * Maximum length for a suite's human-readable name. Must stay in sync with the
+ * limit enforced by the donobu-api gateway (z.string().max(...) in its suite
+ * schema); a longer name causes the remote metadata request to be rejected.
+ */
+exports.SUITE_NAME_MAX_LENGTH = 1024;
 /**
  * Payload for creating a new suite.  Uses the RunConfig fields (all made
  * optional as defaults) plus suite-specific fields like name and description.
  */
 exports.CreateSuiteSchema = RunConfig_1.RunConfigSchema.partial()
     .extend({
-    name: v4_1.z.string().max(256).describe('The name for this suite (required).'),
+    name: v4_1.z
+        .string()
+        .max(exports.SUITE_NAME_MAX_LENGTH)
+        .describe('The name for this suite (required).'),
     description: v4_1.z
         .string()
         .nullable()

package/dist/models/CreateTest.d.ts

@@ -1,4 +1,10 @@
 import { z } from 'zod/v4';
+/**
+ * Maximum length for a test's human-readable name. Must stay in sync with the
+ * limit enforced by the donobu-api gateway (z.string().max(...) in its test
+ * schema); a longer name causes the remote metadata request to be rejected.
+ */
+export declare const TEST_NAME_MAX_LENGTH = 1024;
 /**
  * Payload for creating a new test.  Uses the RunConfig fields (all made
  * nullable/optional for creation) plus test-specific fields like suiteId

package/dist/models/CreateTest.js

@@ -1,10 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateTestSchema = void 0;
+exports.CreateTestSchema = exports.TEST_NAME_MAX_LENGTH = void 0;
 const v4_1 = require("zod/v4");
 const BrowserConfig_1 = require("./BrowserConfig");
 const RunConfig_1 = require("./RunConfig");
 const RunMode_1 = require("./RunMode");
+/**
+ * Maximum length for a test's human-readable name. Must stay in sync with the
+ * limit enforced by the donobu-api gateway (z.string().max(...) in its test
+ * schema); a longer name causes the remote metadata request to be rejected.
+ */
+exports.TEST_NAME_MAX_LENGTH = 1024;
 /**
  * Payload for creating a new test.  Uses the RunConfig fields (all made
  * nullable/optional for creation) plus test-specific fields like suiteId
@@ -24,7 +30,7 @@ exports.CreateTestSchema = RunConfig_1.RunConfigSchema.partial()
         .describe('Web target configuration. Required when target is "web".'),
     name: v4_1.z
         .string()
-        .max(256)
+        .max(exports.TEST_NAME_MAX_LENGTH)
         .nullable()
         .optional()
         .describe('The name for this test.'),

package/dist/models/FlowMetadata.d.ts

@@ -197,6 +197,7 @@ export declare const FlowMetadataSchema: z.ZodObject<{
             branch: z.ZodOptional<z.ZodString>;
             dirty: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$loose>>;
+        runId: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
 export type FlowMetadata = z.infer<typeof FlowMetadataSchema>;

package/dist/models/Provenance.d.ts

@@ -38,6 +38,7 @@ export declare const ProvenanceSchema: z.ZodObject<{
         branch: z.ZodOptional<z.ZodString>;
         dirty: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$loose>>;
+    runId: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
 export type Provenance = z.infer<typeof ProvenanceSchema>;
 //# sourceMappingURL=Provenance.d.ts.map

package/dist/models/Provenance.js

@@ -55,6 +55,15 @@ exports.ProvenanceSchema = v4_1.z
         'no CI markers were detected.'),
     git: exports.GitProvenanceSchema.optional().describe('Git working-tree context at creation time. Absent when the CWD is ' +
         'not a git repo or `git` is unavailable.'),
+    runId: v4_1.z
+        .string()
+        .optional()
+        .describe('Stable identifier for the CI/CD invocation (or local test run) that ' +
+        'produced this flow. Read verbatim from the DONOBU_RUN_ID environment ' +
+        'variable, which the test runner is responsible for setting (so every ' +
+        'flow in the same run shares it and it differs across runs). Absent ' +
+        'for flows created before runId capture, or by a run that did not set ' +
+        'DONOBU_RUN_ID.'),
 })
     .loose();
 //# sourceMappingURL=Provenance.js.map

package/dist/models/SuiteMetadata.d.ts

@@ -156,6 +156,7 @@ export declare const SuiteMetadataSchema: z.ZodObject<{
             branch: z.ZodOptional<z.ZodString>;
             dirty: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$loose>>;
+        runId: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
 export type SuiteMetadata = z.infer<typeof SuiteMetadataSchema>;

package/dist/models/TestMetadata.d.ts

@@ -159,6 +159,7 @@ export declare const TestMetadataSchema: z.ZodObject<{
             branch: z.ZodOptional<z.ZodString>;
             dirty: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$loose>>;
+        runId: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
 export type TestMetadata = z.infer<typeof TestMetadataSchema>;
@@ -340,6 +341,7 @@ export declare const TestListItemSchema: z.ZodObject<{
             branch: z.ZodOptional<z.ZodString>;
             dirty: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$loose>>;
+        runId: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
     flowCount: z.ZodNumber;
     latestFlow: z.ZodNullable<z.ZodObject<{
@@ -528,6 +530,7 @@ export declare const TestListItemSchema: z.ZodObject<{
                 branch: z.ZodOptional<z.ZodString>;
                 dirty: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$loose>>;
+            runId: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
@@ -688,6 +691,7 @@ export declare const TestListItemPaginatedResultSchema: z.ZodObject<{
                 branch: z.ZodOptional<z.ZodString>;
                 dirty: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$loose>>;
+            runId: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>>;
         flowCount: z.ZodNumber;
         latestFlow: z.ZodNullable<z.ZodObject<{
@@ -876,6 +880,7 @@ export declare const TestListItemPaginatedResultSchema: z.ZodObject<{
                     branch: z.ZodOptional<z.ZodString>;
                     dirty: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$loose>>;
+                runId: z.ZodOptional<z.ZodString>;
             }, z.core.$loose>>;
         }, z.core.$loose>>;
     }, z.core.$loose>>;

package/dist/utils/buildProvenance.js

@@ -96,6 +96,7 @@ function buildProvenance(source) {
         hostname,
         ci: isCode ? detectCi() : undefined,
         git: isCode ? detectGit() : undefined,
+        runId: process.env.DONOBU_RUN_ID,
     };
 }
 //# sourceMappingURL=buildProvenance.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "donobu",
-  "version": "5.49.0",
+  "version": "5.51.0",
   "description": "Create browser automations with an LLM agent and replay them as Playwright scripts.",
   "main": "dist/main.js",
   "module": "dist/esm/main.js",