donobu 5.31.0 → 5.32.0

package/dist/esm/lib/page/extendPage.js

@@ -23,6 +23,7 @@ const GoToWebpageTool_1 = require("../../tools/GoToWebpageTool");
 const RunAccessibilityTestTool_1 = require("../../tools/RunAccessibilityTestTool");
 const ansi_1 = require("../../utils/ansi");
 const BrowserUtils_1 = require("../../utils/BrowserUtils");
+const buildProvenance_1 = require("../../utils/buildProvenance");
 const Logger_1 = require("../../utils/Logger");
 const MiscUtils_1 = require("../../utils/MiscUtils");
 const PlaywrightUtils_1 = require("../../utils/PlaywrightUtils");
@@ -120,6 +121,7 @@ async function extendPage(page, options) {
                 completedAt: null,
                 state: 'RUNNING_ACTION',
                 nextState: null,
+                provenance: (0, buildProvenance_1.buildProvenance)('CODE'),
             },
             interactionVisualizer: interactionVisualizer,
             donobuStack: donobuStack,

package/dist/esm/lib/test/testExtension.js

@@ -33,6 +33,7 @@ const DonobuFlowsManager_1 = require("../../managers/DonobuFlowsManager");
 const fileUploadWorkerRegistry_1 = require("../../persistence/files/fileUploadWorkerRegistry");
 const ansi_1 = require("../../utils/ansi");
 const BrowserUtils_1 = require("../../utils/BrowserUtils");
+const buildProvenance_1 = require("../../utils/buildProvenance");
 const FlowLogBuffer_1 = require("../../utils/FlowLogBuffer");
 const Logger_1 = require("../../utils/Logger");
 const MiscUtils_1 = require("../../utils/MiscUtils");
@@ -945,6 +946,7 @@ function flowMetadataToTestMetadata(testId, flowMeta) {
         maxToolCalls: flowMeta.maxToolCalls,
         suiteId: null,
         nextRunMode: 'DETERMINISTIC',
+        provenance: (0, buildProvenance_1.buildProvenance)('CODE'),
     };
 }
 //# sourceMappingURL=testExtension.js.map

package/dist/esm/main.d.ts

@@ -44,6 +44,7 @@ export type * from './models/GptMessage';
 export * from './models/InteractableElement';
 export type { PaginatedResult } from './models/PaginatedResult';
 export * from './models/ProposedToolCall';
+export * from './models/Provenance';
 export * from './models/RunConfig';
 export * from './models/SuiteMetadata';
 export * from './models/TargetConfig';
@@ -63,6 +64,7 @@ export type { TargetRuntime } from './targets/TargetRuntime';
 export { type TargetRuntimeParams, type TargetRuntimePlugin, TargetRuntimePluginRegistry, } from './targets/TargetRuntimePlugin';
 export * from './tools/ReplayableInteraction';
 export * from './tools/Tool';
+export * from './utils/buildProvenance';
 export * from './utils/createTool';
 export * from './utils/FlowLogBuffer';
 export * from './utils/JsonSchemaUtils';

package/dist/esm/main.js

@@ -82,6 +82,7 @@ __exportStar(require("./models/CreateDonobuFlow"), exports);
 __exportStar(require("./models/FlowMetadata"), exports);
 __exportStar(require("./models/InteractableElement"), exports);
 __exportStar(require("./models/ProposedToolCall"), exports);
+__exportStar(require("./models/Provenance"), exports);
 __exportStar(require("./models/RunConfig"), exports);
 __exportStar(require("./models/SuiteMetadata"), exports);
 __exportStar(require("./models/TargetConfig"), exports);
@@ -97,6 +98,7 @@ var TargetRuntimePlugin_1 = require("./targets/TargetRuntimePlugin");
 Object.defineProperty(exports, "TargetRuntimePluginRegistry", { enumerable: true, get: function () { return TargetRuntimePlugin_1.TargetRuntimePluginRegistry; } });
 __exportStar(require("./tools/ReplayableInteraction"), exports);
 __exportStar(require("./tools/Tool"), exports);
+__exportStar(require("./utils/buildProvenance"), exports);
 __exportStar(require("./utils/createTool"), exports);
 __exportStar(require("./utils/FlowLogBuffer"), exports);
 __exportStar(require("./utils/JsonSchemaUtils"), exports);

package/dist/esm/managers/AdminApiController.js

@@ -185,7 +185,10 @@ class AdminApiController {
             const start = performance.now();
             res.on('finish', () => {
                 const duration = Math.round(performance.now() - start);
-                const logLevel = req.path === '/api/ping' ? 'debug' : 'info';
+                // Turn down the log noise for the endpoints polled by the frontend.
+                const logLevel = req.path === '/api/ping' || req.path === '/api/uploads/status'
+                    ? 'debug'
+                    : 'info';
                 Logger_1.accessLogger[logLevel](`${req.method} | ${req.path} | ${res.statusCode} | ${duration}ms`);
             });
             next();

package/dist/esm/managers/DonobuFlowsManager.js

@@ -52,6 +52,7 @@ const UnknownToolException_1 = require("../exceptions/UnknownToolException");
 const GptConfig_1 = require("../models/GptConfig");
 const resolveTargetRuntime_1 = require("../targets/resolveTargetRuntime");
 const CustomToolRunnerTool_1 = require("../tools/CustomToolRunnerTool");
+const buildProvenance_1 = require("../utils/buildProvenance");
 const displayName_1 = require("../utils/displayName");
 const FlowLogBuffer_1 = require("../utils/FlowLogBuffer");
 const Logger_1 = require("../utils/Logger");
@@ -176,6 +177,7 @@ class DonobuFlowsManager {
                     testId: flowParams.testId ?? null,
                     // Target-specific fields (browser, targetWebsite, isControlPanelEnabled, etc.)
                     ...targetRuntime.getMetadataFields(),
+                    provenance: (0, buildProvenance_1.buildProvenance)('DONOBU_STUDIO'),
                 };
                 const flowsPersistence = await this.flowsPersistenceRegistry.get();
                 const envData = await this.envDataManager.getByNames(flowMetadata.envVars ?? []);

package/dist/esm/managers/SuitesManager.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SuitesManager = void 0;
 const crypto_1 = require("crypto");
 const SuiteNotFoundException_1 = require("../exceptions/SuiteNotFoundException");
+const buildProvenance_1 = require("../utils/buildProvenance");
 const FederatedPagination_1 = require("./FederatedPagination");
 class SuitesManager {
     constructor(suitesPersistenceRegistry, testsPersistenceRegistry) {
@@ -30,6 +31,7 @@ class SuitesManager {
             resultJsonSchema: params.resultJsonSchema ?? null,
             maxToolCalls: params.maxToolCalls ?? null,
             videoDisabled: params.videoDisabled,
+            provenance: (0, buildProvenance_1.buildProvenance)('DONOBU_STUDIO'),
         };
         // Create in the primary persistence layer only.
         const primary = await this.suitesPersistenceRegistry.get();

package/dist/esm/managers/TestsManager.js

@@ -4,6 +4,7 @@ exports.TestsManager = void 0;
 const crypto_1 = require("crypto");
 const CannotDeleteRunningFlowException_1 = require("../exceptions/CannotDeleteRunningFlowException");
 const TestNotFoundException_1 = require("../exceptions/TestNotFoundException");
+const buildProvenance_1 = require("../utils/buildProvenance");
 const displayName_1 = require("../utils/displayName");
 const FederatedPagination_1 = require("./FederatedPagination");
 class TestsManager {
@@ -35,6 +36,7 @@ class TestsManager {
             resultJsonSchema: params.resultJsonSchema ?? null,
             maxToolCalls: params.maxToolCalls ?? null,
             videoDisabled: params.videoDisabled,
+            provenance: (0, buildProvenance_1.buildProvenance)('DONOBU_STUDIO'),
         };
         // Create in the primary persistence layer only.
         const primary = await this.testsPersistenceRegistry.get();

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

@@ -181,6 +181,23 @@ export declare const FlowMetadataSchema: z.ZodObject<{
         FAILED: "FAILED";
         SUCCESS: "SUCCESS";
     }>>;
+    provenance: z.ZodOptional<z.ZodObject<{
+        source: z.ZodEnum<{
+            DONOBU_STUDIO: "DONOBU_STUDIO";
+            CODE: "CODE";
+        }>;
+        user: z.ZodOptional<z.ZodString>;
+        os: z.ZodOptional<z.ZodString>;
+        hostname: z.ZodOptional<z.ZodString>;
+        ci: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        git: z.ZodOptional<z.ZodObject<{
+            sha: z.ZodOptional<z.ZodString>;
+            branch: z.ZodOptional<z.ZodString>;
+            dirty: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
 }, z.core.$loose>;
 export type FlowMetadata = z.infer<typeof FlowMetadataSchema>;
 /**

package/dist/esm/models/FlowMetadata.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isComplete = exports.FlowsQuerySchema = exports.FlowMetadataSchema = exports.StateSchema = void 0;
 const v4_1 = require("zod/v4");
+const Provenance_1 = require("./Provenance");
 const RunConfig_1 = require("./RunConfig");
 const RunMode_1 = require("./RunMode");
 const SortOrder_1 = require("./SortOrder");
@@ -87,6 +88,8 @@ depends on how the flow completes:
         .describe('The Unix epoch millisecond timestamp of when the flow completed.'),
     state: exports.StateSchema.describe('The current state of the flow.'),
     nextState: exports.StateSchema.nullable().describe('The planned next state of the flow.'),
+    provenance: Provenance_1.ProvenanceSchema.optional().describe('Records how this flow came into existence (Studio vs. code-first). ' +
+        'Absent on rows written before provenance tracking was introduced.'),
 });
 const FlowSortBySchema = v4_1.z.enum(['created_at', 'name', 'run_mode', 'state']);
 /**

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

@@ -0,0 +1,43 @@
+import { z } from 'zod/v4';
+export declare const ProvenanceSourceSchema: z.ZodEnum<{
+    DONOBU_STUDIO: "DONOBU_STUDIO";
+    CODE: "CODE";
+}>;
+export type ProvenanceSource = z.infer<typeof ProvenanceSourceSchema>;
+export declare const GitProvenanceSchema: z.ZodObject<{
+    sha: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+    dirty: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+export type GitProvenance = z.infer<typeof GitProvenanceSchema>;
+export declare const CiProvenanceSchema: z.ZodObject<{
+    provider: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type CiProvenance = z.infer<typeof CiProvenanceSchema>;
+/**
+ * Provenance — records *how* a Suite/Test/Flow came into existence so downstream
+ * code can render origin badges and gate operations that aren't safe across run
+ * modes (e.g. running a CODE-created test from Studio).
+ *
+ * `.loose()` so newer SDKs can write extra provenance fields without breaking
+ * older readers that round-trip the metadata blob.
+ */
+export declare const ProvenanceSchema: z.ZodObject<{
+    source: z.ZodEnum<{
+        DONOBU_STUDIO: "DONOBU_STUDIO";
+        CODE: "CODE";
+    }>;
+    user: z.ZodOptional<z.ZodString>;
+    os: z.ZodOptional<z.ZodString>;
+    hostname: z.ZodOptional<z.ZodString>;
+    ci: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    git: z.ZodOptional<z.ZodObject<{
+        sha: z.ZodOptional<z.ZodString>;
+        branch: z.ZodOptional<z.ZodString>;
+        dirty: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export type Provenance = z.infer<typeof ProvenanceSchema>;
+//# sourceMappingURL=Provenance.d.ts.map

package/dist/esm/models/Provenance.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProvenanceSchema = exports.CiProvenanceSchema = exports.GitProvenanceSchema = exports.ProvenanceSourceSchema = void 0;
+const v4_1 = require("zod/v4");
+exports.ProvenanceSourceSchema = v4_1.z.enum(['DONOBU_STUDIO', 'CODE']);
+exports.GitProvenanceSchema = v4_1.z
+    .object({
+    sha: v4_1.z.string().optional().describe('The git commit SHA at HEAD.'),
+    branch: v4_1.z
+        .string()
+        .optional()
+        .describe('The git branch at HEAD; absent in detached-HEAD state.'),
+    dirty: v4_1.z
+        .boolean()
+        .optional()
+        .describe('True if the working tree had uncommitted changes.'),
+})
+    .loose();
+exports.CiProvenanceSchema = v4_1.z
+    .object({
+    provider: v4_1.z
+        .string()
+        .optional()
+        .describe('The CI provider name when identified (e.g. "github", "gitlab", "circle"); ' +
+        'absent when only a generic CI=true marker was present.'),
+})
+    .loose();
+/**
+ * Provenance — records *how* a Suite/Test/Flow came into existence so downstream
+ * code can render origin badges and gate operations that aren't safe across run
+ * modes (e.g. running a CODE-created test from Studio).
+ *
+ * `.loose()` so newer SDKs can write extra provenance fields without breaking
+ * older readers that round-trip the metadata blob.
+ */
+exports.ProvenanceSchema = v4_1.z
+    .object({
+    source: exports.ProvenanceSourceSchema.describe('The run mode that created this entity. ' +
+        'DONOBU_STUDIO = created via the Studio desktop app (HTTP API → managers); ' +
+        "CODE = created via a code-first SDK fixture (e.g. `donobu`'s `test` " +
+        "or `donobu-mobile`'s `mobileTest`)."),
+    user: v4_1.z
+        .string()
+        .optional()
+        .describe('The OS username under which the entity was created.'),
+    os: v4_1.z
+        .string()
+        .optional()
+        .describe('The OS platform (e.g. "darwin", "linux", "win32").'),
+    hostname: v4_1.z
+        .string()
+        .optional()
+        .describe('The hostname of the machine that created this entity.'),
+    ci: exports.CiProvenanceSchema.optional().describe('CI context when creation happened in a CI environment. Absent when ' +
+        '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.'),
+})
+    .loose();
+//# sourceMappingURL=Provenance.js.map

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

@@ -140,6 +140,23 @@ export declare const SuiteMetadataSchema: z.ZodObject<{
     metadataVersion: z.ZodOptional<z.ZodNumber>;
     name: z.ZodString;
     description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    provenance: z.ZodOptional<z.ZodObject<{
+        source: z.ZodEnum<{
+            DONOBU_STUDIO: "DONOBU_STUDIO";
+            CODE: "CODE";
+        }>;
+        user: z.ZodOptional<z.ZodString>;
+        os: z.ZodOptional<z.ZodString>;
+        hostname: z.ZodOptional<z.ZodString>;
+        ci: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        git: z.ZodOptional<z.ZodObject<{
+            sha: z.ZodOptional<z.ZodString>;
+            branch: z.ZodOptional<z.ZodString>;
+            dirty: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
 }, z.core.$loose>;
 export type SuiteMetadata = z.infer<typeof SuiteMetadataSchema>;
 /**

package/dist/esm/models/SuiteMetadata.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SuitesQuerySchema = exports.SuiteMetadataSchema = void 0;
 const v4_1 = require("zod/v4");
+const Provenance_1 = require("./Provenance");
 const RunConfig_1 = require("./RunConfig");
 const SortOrder_1 = require("./SortOrder");
 /**
@@ -24,6 +25,8 @@ exports.SuiteMetadataSchema = RunConfig_1.RunConfigSchema.partial().extend({
         .nullable()
         .optional()
         .describe('An optional description of the suite.'),
+    provenance: Provenance_1.ProvenanceSchema.optional().describe('Records how this suite came into existence (Studio vs. code-first). ' +
+        'Absent on rows written before provenance tracking was introduced.'),
 });
 const SuiteSortBySchema = v4_1.z.enum(['created_at', 'name']);
 /**

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

@@ -143,6 +143,23 @@ export declare const TestMetadataSchema: z.ZodObject<{
         INSTRUCT: "INSTRUCT";
         DETERMINISTIC: "DETERMINISTIC";
     }>;
+    provenance: z.ZodOptional<z.ZodObject<{
+        source: z.ZodEnum<{
+            DONOBU_STUDIO: "DONOBU_STUDIO";
+            CODE: "CODE";
+        }>;
+        user: z.ZodOptional<z.ZodString>;
+        os: z.ZodOptional<z.ZodString>;
+        hostname: z.ZodOptional<z.ZodString>;
+        ci: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        git: z.ZodOptional<z.ZodObject<{
+            sha: z.ZodOptional<z.ZodString>;
+            branch: z.ZodOptional<z.ZodString>;
+            dirty: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
 }, z.core.$loose>;
 export type TestMetadata = z.infer<typeof TestMetadataSchema>;
 /**
@@ -307,6 +324,23 @@ export declare const TestListItemSchema: z.ZodObject<{
         INSTRUCT: "INSTRUCT";
         DETERMINISTIC: "DETERMINISTIC";
     }>;
+    provenance: z.ZodOptional<z.ZodObject<{
+        source: z.ZodEnum<{
+            DONOBU_STUDIO: "DONOBU_STUDIO";
+            CODE: "CODE";
+        }>;
+        user: z.ZodOptional<z.ZodString>;
+        os: z.ZodOptional<z.ZodString>;
+        hostname: z.ZodOptional<z.ZodString>;
+        ci: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        git: z.ZodOptional<z.ZodObject<{
+            sha: z.ZodOptional<z.ZodString>;
+            branch: z.ZodOptional<z.ZodString>;
+            dirty: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
     flowCount: z.ZodNumber;
     latestFlow: z.ZodNullable<z.ZodObject<{
         target: z.ZodString;
@@ -478,6 +512,23 @@ export declare const TestListItemSchema: z.ZodObject<{
             FAILED: "FAILED";
             SUCCESS: "SUCCESS";
         }>>;
+        provenance: z.ZodOptional<z.ZodObject<{
+            source: z.ZodEnum<{
+                DONOBU_STUDIO: "DONOBU_STUDIO";
+                CODE: "CODE";
+            }>;
+            user: z.ZodOptional<z.ZodString>;
+            os: z.ZodOptional<z.ZodString>;
+            hostname: z.ZodOptional<z.ZodString>;
+            ci: z.ZodOptional<z.ZodObject<{
+                provider: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            git: z.ZodOptional<z.ZodObject<{
+                sha: z.ZodOptional<z.ZodString>;
+                branch: z.ZodOptional<z.ZodString>;
+                dirty: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
 export type TestListItem = z.infer<typeof TestListItemSchema>;
@@ -621,6 +672,23 @@ export declare const TestListItemPaginatedResultSchema: z.ZodObject<{
             INSTRUCT: "INSTRUCT";
             DETERMINISTIC: "DETERMINISTIC";
         }>;
+        provenance: z.ZodOptional<z.ZodObject<{
+            source: z.ZodEnum<{
+                DONOBU_STUDIO: "DONOBU_STUDIO";
+                CODE: "CODE";
+            }>;
+            user: z.ZodOptional<z.ZodString>;
+            os: z.ZodOptional<z.ZodString>;
+            hostname: z.ZodOptional<z.ZodString>;
+            ci: z.ZodOptional<z.ZodObject<{
+                provider: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            git: z.ZodOptional<z.ZodObject<{
+                sha: z.ZodOptional<z.ZodString>;
+                branch: z.ZodOptional<z.ZodString>;
+                dirty: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>;
         flowCount: z.ZodNumber;
         latestFlow: z.ZodNullable<z.ZodObject<{
             target: z.ZodString;
@@ -792,6 +860,23 @@ export declare const TestListItemPaginatedResultSchema: z.ZodObject<{
                 FAILED: "FAILED";
                 SUCCESS: "SUCCESS";
             }>>;
+            provenance: z.ZodOptional<z.ZodObject<{
+                source: z.ZodEnum<{
+                    DONOBU_STUDIO: "DONOBU_STUDIO";
+                    CODE: "CODE";
+                }>;
+                user: z.ZodOptional<z.ZodString>;
+                os: z.ZodOptional<z.ZodString>;
+                hostname: z.ZodOptional<z.ZodString>;
+                ci: z.ZodOptional<z.ZodObject<{
+                    provider: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>;
+                git: z.ZodOptional<z.ZodObject<{
+                    sha: z.ZodOptional<z.ZodString>;
+                    branch: z.ZodOptional<z.ZodString>;
+                    dirty: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$loose>>;
+            }, z.core.$loose>>;
         }, z.core.$loose>>;
     }, z.core.$loose>>;
     nextPageToken: z.ZodOptional<z.ZodString>;

package/dist/esm/models/TestMetadata.js

@@ -4,6 +4,7 @@ exports.TestListItemPaginatedResultSchema = exports.TestListItemSchema = exports
 const v4_1 = require("zod/v4");
 const FlowMetadata_1 = require("./FlowMetadata");
 const PaginatedResult_1 = require("./PaginatedResult");
+const Provenance_1 = require("./Provenance");
 const RunConfig_1 = require("./RunConfig");
 const RunMode_1 = require("./RunMode");
 const SortOrder_1 = require("./SortOrder");
@@ -28,6 +29,8 @@ exports.TestMetadataSchema = RunConfig_1.RunConfigSchema.extend({
         .nullable()
         .describe('The ID of the suite this test belongs to, or null if the test has not been added to a test suite (or was orphaned when the suite was deleted).'),
     nextRunMode: RunMode_1.RunModeSchema.describe('The run mode to use when creating the next flow from this test.'),
+    provenance: Provenance_1.ProvenanceSchema.optional().describe('Records how this test came into existence (Studio vs. code-first). ' +
+        'Absent on rows written before provenance tracking was introduced.'),
 });
 const TestSortBySchema = v4_1.z.enum([
     'created_at',

package/dist/esm/utils/buildProvenance.d.ts

@@ -0,0 +1,3 @@
+import type { Provenance, ProvenanceSource } from '../models/Provenance';
+export declare function buildProvenance(source: ProvenanceSource): Provenance;
+//# sourceMappingURL=buildProvenance.d.ts.map

package/dist/esm/utils/buildProvenance.js

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildProvenance = buildProvenance;
+const node_child_process_1 = require("node:child_process");
+const node_os_1 = __importDefault(require("node:os"));
+function detectCi() {
+    const env = process.env;
+    if (env.GITHUB_ACTIONS) {
+        return { provider: 'github' };
+    }
+    if (env.GITLAB_CI) {
+        return { provider: 'gitlab' };
+    }
+    if (env.CIRCLECI) {
+        return { provider: 'circle' };
+    }
+    if (env.BUILDKITE) {
+        return { provider: 'buildkite' };
+    }
+    if (env.JENKINS_URL) {
+        return { provider: 'jenkins' };
+    }
+    if (env.TF_BUILD) {
+        return { provider: 'azure-pipelines' };
+    }
+    if (env.BITBUCKET_BUILD_NUMBER) {
+        return { provider: 'bitbucket' };
+    }
+    if (env.TRAVIS) {
+        return { provider: 'travis' };
+    }
+    if (env.CI === 'true' || env.CI === '1') {
+        return {};
+    }
+    return undefined;
+}
+function detectGit() {
+    const opts = {
+        timeout: 500,
+        stdio: ['ignore', 'pipe', 'ignore'],
+        encoding: 'utf8',
+        windowsHide: true,
+    };
+    let sha;
+    try {
+        sha = (0, node_child_process_1.execFileSync)('git', ['rev-parse', 'HEAD'], opts).trim() || undefined;
+    }
+    catch {
+        // Not a git repo, git missing, or timed out — nothing useful to report.
+        return undefined;
+    }
+    let branch;
+    try {
+        const raw = (0, node_child_process_1.execFileSync)('git', ['rev-parse', '--abbrev-ref', 'HEAD'], opts).trim();
+        branch = raw && raw !== 'HEAD' ? raw : undefined;
+    }
+    catch {
+        /* leave undefined */
+    }
+    let dirty;
+    try {
+        const status = (0, node_child_process_1.execFileSync)('git', ['status', '--porcelain'], opts);
+        dirty = status.length > 0;
+    }
+    catch {
+        /* leave undefined */
+    }
+    return { sha, branch, dirty };
+}
+function buildProvenance(source) {
+    let user;
+    let hostname;
+    try {
+        user = node_os_1.default.userInfo().username;
+    }
+    catch {
+        // os.userInfo() can throw in containerised envs with no passwd entry.
+    }
+    try {
+        hostname = node_os_1.default.hostname() || undefined;
+    }
+    catch {
+        // Defensive: hostname() is documented to throw only on rare libuv errors.
+    }
+    // CI and git context only make sense for CODE-source entities — they
+    // describe the user's project environment, not Studio's own runtime. Skip
+    // both for DONOBU_STUDIO to avoid the `git` shell-outs on every create.
+    const isCode = source === 'CODE';
+    return {
+        source,
+        user,
+        os: process.platform,
+        hostname,
+        ci: isCode ? detectCi() : undefined,
+        git: isCode ? detectGit() : undefined,
+    };
+}
+//# sourceMappingURL=buildProvenance.js.map

package/dist/lib/page/extendPage.js

@@ -23,6 +23,7 @@ const GoToWebpageTool_1 = require("../../tools/GoToWebpageTool");
 const RunAccessibilityTestTool_1 = require("../../tools/RunAccessibilityTestTool");
 const ansi_1 = require("../../utils/ansi");
 const BrowserUtils_1 = require("../../utils/BrowserUtils");
+const buildProvenance_1 = require("../../utils/buildProvenance");
 const Logger_1 = require("../../utils/Logger");
 const MiscUtils_1 = require("../../utils/MiscUtils");
 const PlaywrightUtils_1 = require("../../utils/PlaywrightUtils");
@@ -120,6 +121,7 @@ async function extendPage(page, options) {
                 completedAt: null,
                 state: 'RUNNING_ACTION',
                 nextState: null,
+                provenance: (0, buildProvenance_1.buildProvenance)('CODE'),
             },
             interactionVisualizer: interactionVisualizer,
             donobuStack: donobuStack,

package/dist/lib/test/testExtension.js

@@ -33,6 +33,7 @@ const DonobuFlowsManager_1 = require("../../managers/DonobuFlowsManager");
 const fileUploadWorkerRegistry_1 = require("../../persistence/files/fileUploadWorkerRegistry");
 const ansi_1 = require("../../utils/ansi");
 const BrowserUtils_1 = require("../../utils/BrowserUtils");
+const buildProvenance_1 = require("../../utils/buildProvenance");
 const FlowLogBuffer_1 = require("../../utils/FlowLogBuffer");
 const Logger_1 = require("../../utils/Logger");
 const MiscUtils_1 = require("../../utils/MiscUtils");
@@ -945,6 +946,7 @@ function flowMetadataToTestMetadata(testId, flowMeta) {
         maxToolCalls: flowMeta.maxToolCalls,
         suiteId: null,
         nextRunMode: 'DETERMINISTIC',
+        provenance: (0, buildProvenance_1.buildProvenance)('CODE'),
     };
 }
 //# sourceMappingURL=testExtension.js.map

package/dist/main.d.ts

@@ -44,6 +44,7 @@ export type * from './models/GptMessage';
 export * from './models/InteractableElement';
 export type { PaginatedResult } from './models/PaginatedResult';
 export * from './models/ProposedToolCall';
+export * from './models/Provenance';
 export * from './models/RunConfig';
 export * from './models/SuiteMetadata';
 export * from './models/TargetConfig';
@@ -63,6 +64,7 @@ export type { TargetRuntime } from './targets/TargetRuntime';
 export { type TargetRuntimeParams, type TargetRuntimePlugin, TargetRuntimePluginRegistry, } from './targets/TargetRuntimePlugin';
 export * from './tools/ReplayableInteraction';
 export * from './tools/Tool';
+export * from './utils/buildProvenance';
 export * from './utils/createTool';
 export * from './utils/FlowLogBuffer';
 export * from './utils/JsonSchemaUtils';

package/dist/main.js

@@ -82,6 +82,7 @@ __exportStar(require("./models/CreateDonobuFlow"), exports);
 __exportStar(require("./models/FlowMetadata"), exports);
 __exportStar(require("./models/InteractableElement"), exports);
 __exportStar(require("./models/ProposedToolCall"), exports);
+__exportStar(require("./models/Provenance"), exports);
 __exportStar(require("./models/RunConfig"), exports);
 __exportStar(require("./models/SuiteMetadata"), exports);
 __exportStar(require("./models/TargetConfig"), exports);
@@ -97,6 +98,7 @@ var TargetRuntimePlugin_1 = require("./targets/TargetRuntimePlugin");
 Object.defineProperty(exports, "TargetRuntimePluginRegistry", { enumerable: true, get: function () { return TargetRuntimePlugin_1.TargetRuntimePluginRegistry; } });
 __exportStar(require("./tools/ReplayableInteraction"), exports);
 __exportStar(require("./tools/Tool"), exports);
+__exportStar(require("./utils/buildProvenance"), exports);
 __exportStar(require("./utils/createTool"), exports);
 __exportStar(require("./utils/FlowLogBuffer"), exports);
 __exportStar(require("./utils/JsonSchemaUtils"), exports);

package/dist/managers/AdminApiController.js

@@ -185,7 +185,10 @@ class AdminApiController {
             const start = performance.now();
             res.on('finish', () => {
                 const duration = Math.round(performance.now() - start);
-                const logLevel = req.path === '/api/ping' ? 'debug' : 'info';
+                // Turn down the log noise for the endpoints polled by the frontend.
+                const logLevel = req.path === '/api/ping' || req.path === '/api/uploads/status'
+                    ? 'debug'
+                    : 'info';
                 Logger_1.accessLogger[logLevel](`${req.method} | ${req.path} | ${res.statusCode} | ${duration}ms`);
             });
             next();

package/dist/managers/DonobuFlowsManager.js

@@ -52,6 +52,7 @@ const UnknownToolException_1 = require("../exceptions/UnknownToolException");
 const GptConfig_1 = require("../models/GptConfig");
 const resolveTargetRuntime_1 = require("../targets/resolveTargetRuntime");
 const CustomToolRunnerTool_1 = require("../tools/CustomToolRunnerTool");
+const buildProvenance_1 = require("../utils/buildProvenance");
 const displayName_1 = require("../utils/displayName");
 const FlowLogBuffer_1 = require("../utils/FlowLogBuffer");
 const Logger_1 = require("../utils/Logger");
@@ -176,6 +177,7 @@ class DonobuFlowsManager {
                     testId: flowParams.testId ?? null,
                     // Target-specific fields (browser, targetWebsite, isControlPanelEnabled, etc.)
                     ...targetRuntime.getMetadataFields(),
+                    provenance: (0, buildProvenance_1.buildProvenance)('DONOBU_STUDIO'),
                 };
                 const flowsPersistence = await this.flowsPersistenceRegistry.get();
                 const envData = await this.envDataManager.getByNames(flowMetadata.envVars ?? []);

package/dist/managers/SuitesManager.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SuitesManager = void 0;
 const crypto_1 = require("crypto");
 const SuiteNotFoundException_1 = require("../exceptions/SuiteNotFoundException");
+const buildProvenance_1 = require("../utils/buildProvenance");
 const FederatedPagination_1 = require("./FederatedPagination");
 class SuitesManager {
     constructor(suitesPersistenceRegistry, testsPersistenceRegistry) {
@@ -30,6 +31,7 @@ class SuitesManager {
             resultJsonSchema: params.resultJsonSchema ?? null,
             maxToolCalls: params.maxToolCalls ?? null,
             videoDisabled: params.videoDisabled,
+            provenance: (0, buildProvenance_1.buildProvenance)('DONOBU_STUDIO'),
         };
         // Create in the primary persistence layer only.
         const primary = await this.suitesPersistenceRegistry.get();

package/dist/managers/TestsManager.js

@@ -4,6 +4,7 @@ exports.TestsManager = void 0;
 const crypto_1 = require("crypto");
 const CannotDeleteRunningFlowException_1 = require("../exceptions/CannotDeleteRunningFlowException");
 const TestNotFoundException_1 = require("../exceptions/TestNotFoundException");
+const buildProvenance_1 = require("../utils/buildProvenance");
 const displayName_1 = require("../utils/displayName");
 const FederatedPagination_1 = require("./FederatedPagination");
 class TestsManager {
@@ -35,6 +36,7 @@ class TestsManager {
             resultJsonSchema: params.resultJsonSchema ?? null,
             maxToolCalls: params.maxToolCalls ?? null,
             videoDisabled: params.videoDisabled,
+            provenance: (0, buildProvenance_1.buildProvenance)('DONOBU_STUDIO'),
         };
         // Create in the primary persistence layer only.
         const primary = await this.testsPersistenceRegistry.get();

package/dist/models/FlowMetadata.d.ts

@@ -181,6 +181,23 @@ export declare const FlowMetadataSchema: z.ZodObject<{
         FAILED: "FAILED";
         SUCCESS: "SUCCESS";
     }>>;
+    provenance: z.ZodOptional<z.ZodObject<{
+        source: z.ZodEnum<{
+            DONOBU_STUDIO: "DONOBU_STUDIO";
+            CODE: "CODE";
+        }>;
+        user: z.ZodOptional<z.ZodString>;
+        os: z.ZodOptional<z.ZodString>;
+        hostname: z.ZodOptional<z.ZodString>;
+        ci: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        git: z.ZodOptional<z.ZodObject<{
+            sha: z.ZodOptional<z.ZodString>;
+            branch: z.ZodOptional<z.ZodString>;
+            dirty: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
 }, z.core.$loose>;
 export type FlowMetadata = z.infer<typeof FlowMetadataSchema>;
 /**

package/dist/models/FlowMetadata.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isComplete = exports.FlowsQuerySchema = exports.FlowMetadataSchema = exports.StateSchema = void 0;
 const v4_1 = require("zod/v4");
+const Provenance_1 = require("./Provenance");
 const RunConfig_1 = require("./RunConfig");
 const RunMode_1 = require("./RunMode");
 const SortOrder_1 = require("./SortOrder");
@@ -87,6 +88,8 @@ depends on how the flow completes:
         .describe('The Unix epoch millisecond timestamp of when the flow completed.'),
     state: exports.StateSchema.describe('The current state of the flow.'),
     nextState: exports.StateSchema.nullable().describe('The planned next state of the flow.'),
+    provenance: Provenance_1.ProvenanceSchema.optional().describe('Records how this flow came into existence (Studio vs. code-first). ' +
+        'Absent on rows written before provenance tracking was introduced.'),
 });
 const FlowSortBySchema = v4_1.z.enum(['created_at', 'name', 'run_mode', 'state']);
 /**

package/dist/models/Provenance.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod/v4';
+export declare const ProvenanceSourceSchema: z.ZodEnum<{
+    DONOBU_STUDIO: "DONOBU_STUDIO";
+    CODE: "CODE";
+}>;
+export type ProvenanceSource = z.infer<typeof ProvenanceSourceSchema>;
+export declare const GitProvenanceSchema: z.ZodObject<{
+    sha: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+    dirty: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+export type GitProvenance = z.infer<typeof GitProvenanceSchema>;
+export declare const CiProvenanceSchema: z.ZodObject<{
+    provider: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type CiProvenance = z.infer<typeof CiProvenanceSchema>;
+/**
+ * Provenance — records *how* a Suite/Test/Flow came into existence so downstream
+ * code can render origin badges and gate operations that aren't safe across run
+ * modes (e.g. running a CODE-created test from Studio).
+ *
+ * `.loose()` so newer SDKs can write extra provenance fields without breaking
+ * older readers that round-trip the metadata blob.
+ */
+export declare const ProvenanceSchema: z.ZodObject<{
+    source: z.ZodEnum<{
+        DONOBU_STUDIO: "DONOBU_STUDIO";
+        CODE: "CODE";
+    }>;
+    user: z.ZodOptional<z.ZodString>;
+    os: z.ZodOptional<z.ZodString>;
+    hostname: z.ZodOptional<z.ZodString>;
+    ci: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    git: z.ZodOptional<z.ZodObject<{
+        sha: z.ZodOptional<z.ZodString>;
+        branch: z.ZodOptional<z.ZodString>;
+        dirty: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export type Provenance = z.infer<typeof ProvenanceSchema>;
+//# sourceMappingURL=Provenance.d.ts.map

package/dist/models/Provenance.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProvenanceSchema = exports.CiProvenanceSchema = exports.GitProvenanceSchema = exports.ProvenanceSourceSchema = void 0;
+const v4_1 = require("zod/v4");
+exports.ProvenanceSourceSchema = v4_1.z.enum(['DONOBU_STUDIO', 'CODE']);
+exports.GitProvenanceSchema = v4_1.z
+    .object({
+    sha: v4_1.z.string().optional().describe('The git commit SHA at HEAD.'),
+    branch: v4_1.z
+        .string()
+        .optional()
+        .describe('The git branch at HEAD; absent in detached-HEAD state.'),
+    dirty: v4_1.z
+        .boolean()
+        .optional()
+        .describe('True if the working tree had uncommitted changes.'),
+})
+    .loose();
+exports.CiProvenanceSchema = v4_1.z
+    .object({
+    provider: v4_1.z
+        .string()
+        .optional()
+        .describe('The CI provider name when identified (e.g. "github", "gitlab", "circle"); ' +
+        'absent when only a generic CI=true marker was present.'),
+})
+    .loose();
+/**
+ * Provenance — records *how* a Suite/Test/Flow came into existence so downstream
+ * code can render origin badges and gate operations that aren't safe across run
+ * modes (e.g. running a CODE-created test from Studio).
+ *
+ * `.loose()` so newer SDKs can write extra provenance fields without breaking
+ * older readers that round-trip the metadata blob.
+ */
+exports.ProvenanceSchema = v4_1.z
+    .object({
+    source: exports.ProvenanceSourceSchema.describe('The run mode that created this entity. ' +
+        'DONOBU_STUDIO = created via the Studio desktop app (HTTP API → managers); ' +
+        "CODE = created via a code-first SDK fixture (e.g. `donobu`'s `test` " +
+        "or `donobu-mobile`'s `mobileTest`)."),
+    user: v4_1.z
+        .string()
+        .optional()
+        .describe('The OS username under which the entity was created.'),
+    os: v4_1.z
+        .string()
+        .optional()
+        .describe('The OS platform (e.g. "darwin", "linux", "win32").'),
+    hostname: v4_1.z
+        .string()
+        .optional()
+        .describe('The hostname of the machine that created this entity.'),
+    ci: exports.CiProvenanceSchema.optional().describe('CI context when creation happened in a CI environment. Absent when ' +
+        '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.'),
+})
+    .loose();
+//# sourceMappingURL=Provenance.js.map

package/dist/models/SuiteMetadata.d.ts

@@ -140,6 +140,23 @@ export declare const SuiteMetadataSchema: z.ZodObject<{
     metadataVersion: z.ZodOptional<z.ZodNumber>;
     name: z.ZodString;
     description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    provenance: z.ZodOptional<z.ZodObject<{
+        source: z.ZodEnum<{
+            DONOBU_STUDIO: "DONOBU_STUDIO";
+            CODE: "CODE";
+        }>;
+        user: z.ZodOptional<z.ZodString>;
+        os: z.ZodOptional<z.ZodString>;
+        hostname: z.ZodOptional<z.ZodString>;
+        ci: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        git: z.ZodOptional<z.ZodObject<{
+            sha: z.ZodOptional<z.ZodString>;
+            branch: z.ZodOptional<z.ZodString>;
+            dirty: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
 }, z.core.$loose>;
 export type SuiteMetadata = z.infer<typeof SuiteMetadataSchema>;
 /**

package/dist/models/SuiteMetadata.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SuitesQuerySchema = exports.SuiteMetadataSchema = void 0;
 const v4_1 = require("zod/v4");
+const Provenance_1 = require("./Provenance");
 const RunConfig_1 = require("./RunConfig");
 const SortOrder_1 = require("./SortOrder");
 /**
@@ -24,6 +25,8 @@ exports.SuiteMetadataSchema = RunConfig_1.RunConfigSchema.partial().extend({
         .nullable()
         .optional()
         .describe('An optional description of the suite.'),
+    provenance: Provenance_1.ProvenanceSchema.optional().describe('Records how this suite came into existence (Studio vs. code-first). ' +
+        'Absent on rows written before provenance tracking was introduced.'),
 });
 const SuiteSortBySchema = v4_1.z.enum(['created_at', 'name']);
 /**

package/dist/models/TestMetadata.d.ts

@@ -143,6 +143,23 @@ export declare const TestMetadataSchema: z.ZodObject<{
         INSTRUCT: "INSTRUCT";
         DETERMINISTIC: "DETERMINISTIC";
     }>;
+    provenance: z.ZodOptional<z.ZodObject<{
+        source: z.ZodEnum<{
+            DONOBU_STUDIO: "DONOBU_STUDIO";
+            CODE: "CODE";
+        }>;
+        user: z.ZodOptional<z.ZodString>;
+        os: z.ZodOptional<z.ZodString>;
+        hostname: z.ZodOptional<z.ZodString>;
+        ci: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        git: z.ZodOptional<z.ZodObject<{
+            sha: z.ZodOptional<z.ZodString>;
+            branch: z.ZodOptional<z.ZodString>;
+            dirty: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
 }, z.core.$loose>;
 export type TestMetadata = z.infer<typeof TestMetadataSchema>;
 /**
@@ -307,6 +324,23 @@ export declare const TestListItemSchema: z.ZodObject<{
         INSTRUCT: "INSTRUCT";
         DETERMINISTIC: "DETERMINISTIC";
     }>;
+    provenance: z.ZodOptional<z.ZodObject<{
+        source: z.ZodEnum<{
+            DONOBU_STUDIO: "DONOBU_STUDIO";
+            CODE: "CODE";
+        }>;
+        user: z.ZodOptional<z.ZodString>;
+        os: z.ZodOptional<z.ZodString>;
+        hostname: z.ZodOptional<z.ZodString>;
+        ci: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        git: z.ZodOptional<z.ZodObject<{
+            sha: z.ZodOptional<z.ZodString>;
+            branch: z.ZodOptional<z.ZodString>;
+            dirty: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
     flowCount: z.ZodNumber;
     latestFlow: z.ZodNullable<z.ZodObject<{
         target: z.ZodString;
@@ -478,6 +512,23 @@ export declare const TestListItemSchema: z.ZodObject<{
             FAILED: "FAILED";
             SUCCESS: "SUCCESS";
         }>>;
+        provenance: z.ZodOptional<z.ZodObject<{
+            source: z.ZodEnum<{
+                DONOBU_STUDIO: "DONOBU_STUDIO";
+                CODE: "CODE";
+            }>;
+            user: z.ZodOptional<z.ZodString>;
+            os: z.ZodOptional<z.ZodString>;
+            hostname: z.ZodOptional<z.ZodString>;
+            ci: z.ZodOptional<z.ZodObject<{
+                provider: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            git: z.ZodOptional<z.ZodObject<{
+                sha: z.ZodOptional<z.ZodString>;
+                branch: z.ZodOptional<z.ZodString>;
+                dirty: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
 export type TestListItem = z.infer<typeof TestListItemSchema>;
@@ -621,6 +672,23 @@ export declare const TestListItemPaginatedResultSchema: z.ZodObject<{
             INSTRUCT: "INSTRUCT";
             DETERMINISTIC: "DETERMINISTIC";
         }>;
+        provenance: z.ZodOptional<z.ZodObject<{
+            source: z.ZodEnum<{
+                DONOBU_STUDIO: "DONOBU_STUDIO";
+                CODE: "CODE";
+            }>;
+            user: z.ZodOptional<z.ZodString>;
+            os: z.ZodOptional<z.ZodString>;
+            hostname: z.ZodOptional<z.ZodString>;
+            ci: z.ZodOptional<z.ZodObject<{
+                provider: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            git: z.ZodOptional<z.ZodObject<{
+                sha: z.ZodOptional<z.ZodString>;
+                branch: z.ZodOptional<z.ZodString>;
+                dirty: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>;
         flowCount: z.ZodNumber;
         latestFlow: z.ZodNullable<z.ZodObject<{
             target: z.ZodString;
@@ -792,6 +860,23 @@ export declare const TestListItemPaginatedResultSchema: z.ZodObject<{
                 FAILED: "FAILED";
                 SUCCESS: "SUCCESS";
             }>>;
+            provenance: z.ZodOptional<z.ZodObject<{
+                source: z.ZodEnum<{
+                    DONOBU_STUDIO: "DONOBU_STUDIO";
+                    CODE: "CODE";
+                }>;
+                user: z.ZodOptional<z.ZodString>;
+                os: z.ZodOptional<z.ZodString>;
+                hostname: z.ZodOptional<z.ZodString>;
+                ci: z.ZodOptional<z.ZodObject<{
+                    provider: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>;
+                git: z.ZodOptional<z.ZodObject<{
+                    sha: z.ZodOptional<z.ZodString>;
+                    branch: z.ZodOptional<z.ZodString>;
+                    dirty: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$loose>>;
+            }, z.core.$loose>>;
         }, z.core.$loose>>;
     }, z.core.$loose>>;
     nextPageToken: z.ZodOptional<z.ZodString>;

package/dist/models/TestMetadata.js

@@ -4,6 +4,7 @@ exports.TestListItemPaginatedResultSchema = exports.TestListItemSchema = exports
 const v4_1 = require("zod/v4");
 const FlowMetadata_1 = require("./FlowMetadata");
 const PaginatedResult_1 = require("./PaginatedResult");
+const Provenance_1 = require("./Provenance");
 const RunConfig_1 = require("./RunConfig");
 const RunMode_1 = require("./RunMode");
 const SortOrder_1 = require("./SortOrder");
@@ -28,6 +29,8 @@ exports.TestMetadataSchema = RunConfig_1.RunConfigSchema.extend({
         .nullable()
         .describe('The ID of the suite this test belongs to, or null if the test has not been added to a test suite (or was orphaned when the suite was deleted).'),
     nextRunMode: RunMode_1.RunModeSchema.describe('The run mode to use when creating the next flow from this test.'),
+    provenance: Provenance_1.ProvenanceSchema.optional().describe('Records how this test came into existence (Studio vs. code-first). ' +
+        'Absent on rows written before provenance tracking was introduced.'),
 });
 const TestSortBySchema = v4_1.z.enum([
     'created_at',

package/dist/utils/buildProvenance.d.ts

@@ -0,0 +1,3 @@
+import type { Provenance, ProvenanceSource } from '../models/Provenance';
+export declare function buildProvenance(source: ProvenanceSource): Provenance;
+//# sourceMappingURL=buildProvenance.d.ts.map

package/dist/utils/buildProvenance.js

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildProvenance = buildProvenance;
+const node_child_process_1 = require("node:child_process");
+const node_os_1 = __importDefault(require("node:os"));
+function detectCi() {
+    const env = process.env;
+    if (env.GITHUB_ACTIONS) {
+        return { provider: 'github' };
+    }
+    if (env.GITLAB_CI) {
+        return { provider: 'gitlab' };
+    }
+    if (env.CIRCLECI) {
+        return { provider: 'circle' };
+    }
+    if (env.BUILDKITE) {
+        return { provider: 'buildkite' };
+    }
+    if (env.JENKINS_URL) {
+        return { provider: 'jenkins' };
+    }
+    if (env.TF_BUILD) {
+        return { provider: 'azure-pipelines' };
+    }
+    if (env.BITBUCKET_BUILD_NUMBER) {
+        return { provider: 'bitbucket' };
+    }
+    if (env.TRAVIS) {
+        return { provider: 'travis' };
+    }
+    if (env.CI === 'true' || env.CI === '1') {
+        return {};
+    }
+    return undefined;
+}
+function detectGit() {
+    const opts = {
+        timeout: 500,
+        stdio: ['ignore', 'pipe', 'ignore'],
+        encoding: 'utf8',
+        windowsHide: true,
+    };
+    let sha;
+    try {
+        sha = (0, node_child_process_1.execFileSync)('git', ['rev-parse', 'HEAD'], opts).trim() || undefined;
+    }
+    catch {
+        // Not a git repo, git missing, or timed out — nothing useful to report.
+        return undefined;
+    }
+    let branch;
+    try {
+        const raw = (0, node_child_process_1.execFileSync)('git', ['rev-parse', '--abbrev-ref', 'HEAD'], opts).trim();
+        branch = raw && raw !== 'HEAD' ? raw : undefined;
+    }
+    catch {
+        /* leave undefined */
+    }
+    let dirty;
+    try {
+        const status = (0, node_child_process_1.execFileSync)('git', ['status', '--porcelain'], opts);
+        dirty = status.length > 0;
+    }
+    catch {
+        /* leave undefined */
+    }
+    return { sha, branch, dirty };
+}
+function buildProvenance(source) {
+    let user;
+    let hostname;
+    try {
+        user = node_os_1.default.userInfo().username;
+    }
+    catch {
+        // os.userInfo() can throw in containerised envs with no passwd entry.
+    }
+    try {
+        hostname = node_os_1.default.hostname() || undefined;
+    }
+    catch {
+        // Defensive: hostname() is documented to throw only on rare libuv errors.
+    }
+    // CI and git context only make sense for CODE-source entities — they
+    // describe the user's project environment, not Studio's own runtime. Skip
+    // both for DONOBU_STUDIO to avoid the `git` shell-outs on every create.
+    const isCode = source === 'CODE';
+    return {
+        source,
+        user,
+        os: process.platform,
+        hostname,
+        ci: isCode ? detectCi() : undefined,
+        git: isCode ? detectGit() : undefined,
+    };
+}
+//# sourceMappingURL=buildProvenance.js.map

package/package.json

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