@exaudeus/workrail 3.25.0 → 3.26.1

package/dist/trigger/trigger-store.js

@@ -36,11 +36,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadTriggerConfig = loadTriggerConfig;
 exports.loadTriggerConfigFromFile = loadTriggerConfigFromFile;
 exports.buildTriggerIndex = buildTriggerIndex;
+const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
 const fs = __importStar(require("node:fs/promises"));
 const result_js_1 = require("../runtime/result.js");
 const types_js_1 = require("./types.js");
-const SUPPORTED_PROVIDERS = new Set(['generic']);
+const SUPPORTED_PROVIDERS = new Set(['generic', 'gitlab_poll']);
 function unquoteYamlScalar(raw) {
     const s = raw.trim();
     if ((s.startsWith('"') && s.endsWith('"')) ||
@@ -210,6 +211,10 @@ function parseTriggersYaml(content) {
                             return acValueResult;
                         if (acKey === 'model')
                             agentConfig.model = acValueResult.value;
+                        else if (acKey === 'maxSessionMinutes')
+                            agentConfig.maxSessionMinutes = acValueResult.value;
+                        else if (acKey === 'maxTurns')
+                            agentConfig.maxTurns = acValueResult.value;
                     }
                     lineIndex++;
                 }
@@ -263,6 +268,59 @@ function parseTriggersYaml(content) {
                 trigger.onComplete = onComplete;
                 continue;
             }
+            if (key === 'source') {
+                lineIndex++;
+                const source = {};
+                while (lineIndex < lines.length) {
+                    const srcLine = lines[lineIndex];
+                    if (srcLine === undefined)
+                        break;
+                    const srcTrimmed = srcLine.trim();
+                    if (srcTrimmed === '' || srcTrimmed.startsWith('#')) {
+                        lineIndex++;
+                        continue;
+                    }
+                    const srcIndent = srcLine.search(/\S/);
+                    if (srcIndent <= lineIndent)
+                        break;
+                    const srcColonIdx = srcTrimmed.indexOf(':');
+                    if (srcColonIdx === -1) {
+                        return (0, result_js_1.err)({
+                            kind: 'parse_error',
+                            message: `Missing colon in source entry at line ${lineIndex + 1}: "${srcTrimmed}"`,
+                            lineNumber: lineIndex + 1,
+                        });
+                    }
+                    const srcKey = srcTrimmed.slice(0, srcColonIdx).trim();
+                    const srcRawValue = srcTrimmed.slice(srcColonIdx + 1).trim();
+                    if (srcRawValue !== '') {
+                        const srcValueResult = parseScalar(srcRawValue, lineIndex + 1);
+                        if (srcValueResult.kind === 'err')
+                            return srcValueResult;
+                        switch (srcKey) {
+                            case 'baseUrl':
+                                source.baseUrl = srcValueResult.value;
+                                break;
+                            case 'projectId':
+                                source.projectId = srcValueResult.value;
+                                break;
+                            case 'token':
+                                source.token = srcValueResult.value;
+                                break;
+                            case 'events':
+                                source.events = srcValueResult.value;
+                                break;
+                            case 'pollIntervalSeconds':
+                                source.pollIntervalSeconds = srcValueResult.value;
+                                break;
+                            default: break;
+                        }
+                    }
+                    lineIndex++;
+                }
+                trigger.source = source;
+                continue;
+            }
             if (rawValue === '') {
                 lineIndex++;
                 continue;
@@ -303,10 +361,31 @@ function setTriggerField(trigger, key, value) {
         case 'referenceUrls':
             trigger.referenceUrls = value;
             break;
+        case 'concurrencyMode':
+            trigger.concurrencyMode = value;
+            break;
+        case 'callbackUrl':
+            trigger.callbackUrl = value;
+            break;
+        case 'autoCommit':
+            trigger.autoCommit = value;
+            break;
+        case 'autoOpenPR':
+            trigger.autoOpenPR = value;
+            break;
+        case 'workspaceName':
+            trigger.workspaceName = value;
+            break;
+        case 'soulFile':
+            trigger.soulFile = value;
+            break;
         default:
             break;
     }
 }
+function expandTildePath(p) {
+    return p.startsWith('~/') ? path.join(os.homedir(), p.slice(2)) : p;
+}
 function resolveSecret(value, triggerId, env) {
     if (!value.startsWith('$')) {
         return (0, result_js_1.ok)(value);
@@ -327,7 +406,7 @@ function assembleContextMapping(raw) {
     }));
     return { mappings };
 }
-function validateAndResolveTrigger(raw, env) {
+function validateAndResolveTrigger(raw, env, workspaces = {}) {
     const rawId = raw.id?.trim() ?? '';
     if (!rawId) {
         return (0, result_js_1.err)({ kind: 'missing_field', field: 'id', triggerId: '(unknown)' });
@@ -335,7 +414,6 @@ function validateAndResolveTrigger(raw, env) {
     const requiredStringFields = [
         'provider',
         'workflowId',
-        'workspacePath',
         'goal',
     ];
     for (const field of requiredStringFields) {
@@ -348,6 +426,52 @@ function validateAndResolveTrigger(raw, env) {
     if (!SUPPORTED_PROVIDERS.has(provider)) {
         return (0, result_js_1.err)({ kind: 'unknown_provider', provider, triggerId: rawId });
     }
+    let resolvedWorkspacePath;
+    let resolvedWorkspaceName;
+    let resolvedSoulFile;
+    const rawWorkspaceName = raw.workspaceName?.trim();
+    const rawWorkspacePath = raw.workspacePath?.trim();
+    const rawSoulFile = raw.soulFile?.trim();
+    if (rawWorkspaceName) {
+        if (!/^[a-zA-Z0-9_-]+$/.test(rawWorkspaceName)) {
+            return (0, result_js_1.err)({
+                kind: 'invalid_field_value',
+                field: `workspaceName (must match ^[a-zA-Z0-9_-]+$, got: "${rawWorkspaceName}")`,
+                triggerId: rawId,
+            });
+        }
+        const workspaceConfig = workspaces[rawWorkspaceName];
+        if (!workspaceConfig) {
+            return (0, result_js_1.err)({ kind: 'unknown_workspace', workspaceName: rawWorkspaceName, triggerId: rawId });
+        }
+        if (!path.isAbsolute(workspaceConfig.path)) {
+            return (0, result_js_1.err)({
+                kind: 'invalid_field_value',
+                field: `workspace "${rawWorkspaceName}".path (must be absolute, got: "${workspaceConfig.path}")`,
+                triggerId: rawId,
+            });
+        }
+        if (rawWorkspacePath) {
+            console.warn(`[TriggerStore] WARNING: trigger "${rawId}" has both workspaceName and workspacePath. ` +
+                `workspaceName takes precedence; workspacePath "${rawWorkspacePath}" is ignored.`);
+        }
+        resolvedWorkspacePath = workspaceConfig.path;
+        resolvedWorkspaceName = (0, types_js_1.asWorkspaceName)(rawWorkspaceName);
+        resolvedSoulFile = rawSoulFile ?? workspaceConfig.soulFile;
+    }
+    else {
+        if (!rawWorkspacePath) {
+            return (0, result_js_1.err)({ kind: 'missing_field', field: 'workspacePath', triggerId: rawId });
+        }
+        resolvedWorkspacePath = rawWorkspacePath;
+        resolvedSoulFile = rawSoulFile;
+    }
+    if (resolvedSoulFile) {
+        resolvedSoulFile = expandTildePath(resolvedSoulFile);
+    }
+    if (resolvedSoulFile && !path.isAbsolute(resolvedSoulFile)) {
+        return (0, result_js_1.err)({ kind: 'invalid_field_value', field: 'soulFile', triggerId: rawId });
+    }
     let hmacSecret;
     if (raw.hmacSecret?.trim()) {
         const secretResult = resolveSecret(raw.hmacSecret.trim(), rawId, env);
@@ -365,17 +489,72 @@ function validateAndResolveTrigger(raw, env) {
             try {
                 const parsed = new URL(url);
                 if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {
-                    return (0, result_js_1.err)({ kind: 'missing_field', field: `referenceUrls (non-HTTP URL rejected: ${url})`, triggerId: raw.id ?? '?' });
+                    return (0, result_js_1.err)({ kind: 'invalid_field_value', field: `referenceUrls (non-HTTP URL rejected: ${url})`, triggerId: raw.id ?? '?' });
                 }
             }
             catch {
-                return (0, result_js_1.err)({ kind: 'missing_field', field: `referenceUrls (invalid URL: ${url})`, triggerId: raw.id ?? '?' });
+                return (0, result_js_1.err)({ kind: 'invalid_field_value', field: `referenceUrls (invalid URL: ${url})`, triggerId: raw.id ?? '?' });
             }
         }
     }
-    const agentConfig = raw.agentConfig?.model?.trim()
-        ? { model: raw.agentConfig.model.trim() }
-        : undefined;
+    let callbackUrl;
+    if (raw.callbackUrl?.trim()) {
+        const rawCb = raw.callbackUrl.trim();
+        try {
+            const parsedCb = new URL(rawCb);
+            if (parsedCb.protocol !== 'https:' && parsedCb.protocol !== 'http:') {
+                return (0, result_js_1.err)({ kind: 'invalid_field_value', field: `callbackUrl (non-HTTP URL rejected: ${rawCb})`, triggerId: rawId });
+            }
+        }
+        catch {
+            return (0, result_js_1.err)({ kind: 'invalid_field_value', field: `callbackUrl (invalid URL: ${rawCb})`, triggerId: rawId });
+        }
+        callbackUrl = rawCb;
+    }
+    let agentConfig;
+    if (raw.agentConfig) {
+        const model = raw.agentConfig.model?.trim() || undefined;
+        let maxSessionMinutes;
+        if (raw.agentConfig.maxSessionMinutes !== undefined) {
+            const asNumber = Number(raw.agentConfig.maxSessionMinutes);
+            if (!Number.isInteger(asNumber) || asNumber <= 0) {
+                return (0, result_js_1.err)({
+                    kind: 'invalid_field_value',
+                    field: 'agentConfig.maxSessionMinutes (must be a positive integer)',
+                    triggerId: rawId,
+                });
+            }
+            maxSessionMinutes = asNumber;
+        }
+        let maxTurns;
+        if (raw.agentConfig.maxTurns !== undefined) {
+            const asNumber = Number(raw.agentConfig.maxTurns);
+            if (!Number.isInteger(asNumber) || asNumber <= 0) {
+                return (0, result_js_1.err)({
+                    kind: 'invalid_field_value',
+                    field: 'agentConfig.maxTurns (must be a positive integer)',
+                    triggerId: rawId,
+                });
+            }
+            maxTurns = asNumber;
+        }
+        if (model !== undefined || maxSessionMinutes !== undefined || maxTurns !== undefined) {
+            agentConfig = {
+                ...(model !== undefined ? { model } : {}),
+                ...(maxSessionMinutes !== undefined ? { maxSessionMinutes } : {}),
+                ...(maxTurns !== undefined ? { maxTurns } : {}),
+            };
+        }
+    }
+    const rawConcurrencyMode = raw.concurrencyMode?.trim();
+    if (rawConcurrencyMode !== undefined && rawConcurrencyMode !== 'serial' && rawConcurrencyMode !== 'parallel') {
+        return (0, result_js_1.err)({
+            kind: 'invalid_field_value',
+            field: `concurrencyMode (invalid value: "${rawConcurrencyMode}"; must be "serial" or "parallel")`,
+            triggerId: rawId,
+        });
+    }
+    const concurrencyMode = rawConcurrencyMode === 'parallel' ? 'parallel' : 'serial';
     let onComplete;
     if (raw.onComplete) {
         const rawRunOn = raw.onComplete.runOn?.trim();
@@ -392,12 +571,68 @@ function validateAndResolveTrigger(raw, env) {
             };
         }
     }
+    const autoCommit = raw.autoCommit?.trim().toLowerCase() === 'true';
+    const autoOpenPR = raw.autoOpenPR?.trim().toLowerCase() === 'true';
+    if (autoOpenPR && !autoCommit) {
+        console.warn(`[TriggerStore] Warning: trigger "${rawId}" has autoOpenPR: true but autoCommit is not true. ` +
+            `A PR requires a commit -- delivery will be skipped unless autoCommit is also set to true.`);
+    }
+    let pollingSource;
+    if (provider === 'gitlab_poll') {
+        if (!raw.source) {
+            return (0, result_js_1.err)({ kind: 'missing_field', field: 'source', triggerId: rawId });
+        }
+        const src = raw.source;
+        const requiredSourceFields = [
+            'baseUrl', 'projectId', 'token', 'events',
+        ];
+        for (const field of requiredSourceFields) {
+            if (!src[field]?.trim()) {
+                return (0, result_js_1.err)({ kind: 'missing_field', field: `source.${field}`, triggerId: rawId });
+            }
+        }
+        const tokenRaw = src.token.trim();
+        const tokenResult = resolveSecret(tokenRaw, rawId, env);
+        if (tokenResult.kind === 'err')
+            return tokenResult;
+        const eventsRaw = src.events.trim();
+        const events = eventsRaw.split(/\s+/).filter(Boolean);
+        if (events.length === 0) {
+            return (0, result_js_1.err)({ kind: 'missing_field', field: 'source.events (empty)', triggerId: rawId });
+        }
+        const intervalRaw = src.pollIntervalSeconds?.trim();
+        let pollIntervalSeconds = 60;
+        if (intervalRaw) {
+            const asNumber = Number(intervalRaw);
+            if (!Number.isInteger(asNumber) || asNumber <= 0) {
+                return (0, result_js_1.err)({
+                    kind: 'invalid_field_value',
+                    field: `source.pollIntervalSeconds (must be a positive integer, got: ${intervalRaw})`,
+                    triggerId: rawId,
+                });
+            }
+            pollIntervalSeconds = asNumber;
+        }
+        pollingSource = {
+            baseUrl: src.baseUrl.trim(),
+            projectId: src.projectId.trim(),
+            token: tokenResult.value,
+            events,
+            pollIntervalSeconds,
+        };
+    }
+    else if (raw.source) {
+        console.warn(`[TriggerStore] WARNING: trigger '${rawId}' has provider='${provider}' but also ` +
+            `defines a source: block. The source: block is only used for provider='gitlab_poll'. ` +
+            `It will be ignored for this trigger.`);
+    }
     const trigger = {
         id: (0, types_js_1.asTriggerId)(rawId),
         provider,
         workflowId: raw.workflowId.trim(),
-        workspacePath: raw.workspacePath.trim(),
+        workspacePath: resolvedWorkspacePath,
         goal: raw.goal.trim(),
+        concurrencyMode,
         ...(hmacSecret !== undefined ? { hmacSecret } : {}),
         ...(raw.contextMapping !== undefined
             ? { contextMapping: assembleContextMapping(raw.contextMapping) }
@@ -405,18 +640,24 @@ function validateAndResolveTrigger(raw, env) {
         ...(goalTemplate ? { goalTemplate } : {}),
         ...(referenceUrls !== undefined && referenceUrls.length > 0 ? { referenceUrls } : {}),
         ...(agentConfig !== undefined ? { agentConfig } : {}),
+        ...(callbackUrl !== undefined ? { callbackUrl } : {}),
         ...(onComplete !== undefined ? { onComplete } : {}),
+        ...(autoCommit ? { autoCommit } : {}),
+        ...(autoOpenPR ? { autoOpenPR } : {}),
+        ...(pollingSource !== undefined ? { pollingSource } : {}),
+        ...(resolvedWorkspaceName !== undefined ? { workspaceName: resolvedWorkspaceName } : {}),
+        ...(resolvedSoulFile ? { soulFile: resolvedSoulFile } : {}),
     };
     return (0, result_js_1.ok)(trigger);
 }
-function loadTriggerConfig(yamlContent, env = process.env) {
+function loadTriggerConfig(yamlContent, env = process.env, workspaces = {}) {
     const parsedResult = parseTriggersYaml(yamlContent);
     if (parsedResult.kind === 'err')
         return parsedResult;
     const validTriggers = [];
     const validationErrors = [];
     for (const rawTrigger of parsedResult.value) {
-        const triggerResult = validateAndResolveTrigger(rawTrigger, env);
+        const triggerResult = validateAndResolveTrigger(rawTrigger, env, workspaces);
         if (triggerResult.kind === 'err') {
             console.warn(`[TriggerStore] Skipping invalid trigger: ${JSON.stringify(triggerResult.error)}`);
             validationErrors.push(triggerResult.error);
@@ -430,7 +671,7 @@ function loadTriggerConfig(yamlContent, env = process.env) {
     }
     return (0, result_js_1.ok)({ triggers: validTriggers });
 }
-async function loadTriggerConfigFromFile(workspacePath, env = process.env) {
+async function loadTriggerConfigFromFile(workspacePath, env = process.env, workspaces = {}) {
     const filePath = path.join(workspacePath, 'triggers.yml');
     let content;
     try {
@@ -443,7 +684,7 @@ async function loadTriggerConfigFromFile(workspacePath, env = process.env) {
         }
         return (0, result_js_1.err)({ kind: 'io_error', message: error.message ?? String(e) });
     }
-    return loadTriggerConfig(content, env);
+    return loadTriggerConfig(content, env, workspaces);
 }
 function buildTriggerIndex(config) {
     const index = new Map();

package/dist/trigger/types.d.ts

@@ -2,6 +2,14 @@ export type TriggerId = string & {
     readonly _brand: 'TriggerId';
 };
 export declare function asTriggerId(value: string): TriggerId;
+export type WorkspaceName = string & {
+    readonly _brand: 'WorkspaceName';
+};
+export declare function asWorkspaceName(value: string): WorkspaceName;
+export interface WorkspaceConfig {
+    readonly path: string;
+    readonly soulFile?: string;
+}
 export interface ContextMappingEntry {
     readonly workflowContextKey: string;
     readonly payloadPath: string;
@@ -10,6 +18,13 @@ export interface ContextMappingEntry {
 export interface ContextMapping {
     readonly mappings: readonly ContextMappingEntry[];
 }
+export interface GitLabPollingSource {
+    readonly baseUrl: string;
+    readonly projectId: string;
+    readonly token: string;
+    readonly events: readonly string[];
+    readonly pollIntervalSeconds: number;
+}
 export interface TriggerDefinition {
     readonly id: TriggerId;
     readonly provider: string;
@@ -22,12 +37,21 @@ export interface TriggerDefinition {
     readonly referenceUrls?: readonly string[];
     readonly agentConfig?: {
         readonly model?: string;
+        readonly maxSessionMinutes?: number;
+        readonly maxTurns?: number;
     };
+    readonly concurrencyMode: 'serial' | 'parallel';
+    readonly callbackUrl?: string;
+    readonly autoCommit?: boolean;
+    readonly autoOpenPR?: boolean;
     readonly onComplete?: {
         readonly runOn: 'success' | 'failure' | 'always';
         readonly workflowId?: string;
         readonly goal?: string;
     };
+    readonly pollingSource?: GitLabPollingSource;
+    readonly workspaceName?: WorkspaceName;
+    readonly soulFile?: string;
 }
 export interface TriggerConfig {
     readonly triggers: readonly TriggerDefinition[];

package/dist/trigger/types.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.asTriggerId = asTriggerId;
+exports.asWorkspaceName = asWorkspaceName;
 function asTriggerId(value) {
     return value;
 }
+function asWorkspaceName(value) {
+    return value;
+}

package/dist/v2/durable-core/schemas/execution-snapshot/blocked-snapshot.d.ts

@@ -39,11 +39,11 @@ export declare const ContractViolationReasonV1Schema: z.ZodDiscriminatedUnion<"k
     kind: z.ZodLiteral<"missing_context_key">;
     key: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    key: string;
     kind: "missing_context_key";
-}, {
     key: string;
+}, {
     kind: "missing_context_key";
+    key: string;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"context_budget_exceeded">;
 }, "strict", z.ZodTypeAny, {
@@ -151,11 +151,11 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
         kind: z.ZodLiteral<"missing_context_key">;
         key: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        key: string;
         kind: "missing_context_key";
-    }, {
         key: string;
+    }, {
         kind: "missing_context_key";
+        key: string;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"context_budget_exceeded">;
     }, "strict", z.ZodTypeAny, {
@@ -181,11 +181,11 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
                 kind: z.ZodLiteral<"context_key">;
                 key: z.ZodString;
             }, "strict", z.ZodTypeAny, {
-                key: string;
                 kind: "context_key";
-            }, {
                 key: string;
+            }, {
                 kind: "context_key";
+                key: string;
             }>, z.ZodObject<{
                 kind: z.ZodLiteral<"context_budget">;
             }, "strict", z.ZodTypeAny, {
@@ -238,8 +238,8 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
             message: string;
             code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "ASSESSMENT_FOLLOWUP_REQUIRED" | "MISSING_REQUIRED_NOTES" | "MISSING_CONTEXT_KEY" | "CONTEXT_BUDGET_EXCEEDED" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
             pointer: {
-                key: string;
                 kind: "context_key";
+                key: string;
             } | {
                 kind: "context_budget";
             } | {
@@ -261,8 +261,8 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
             message: string;
             code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "ASSESSMENT_FOLLOWUP_REQUIRED" | "MISSING_REQUIRED_NOTES" | "MISSING_CONTEXT_KEY" | "CONTEXT_BUDGET_EXCEEDED" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
             pointer: {
-                key: string;
                 kind: "context_key";
+                key: string;
             } | {
                 kind: "context_budget";
             } | {
@@ -286,8 +286,8 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
             message: string;
             code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "ASSESSMENT_FOLLOWUP_REQUIRED" | "MISSING_REQUIRED_NOTES" | "MISSING_CONTEXT_KEY" | "CONTEXT_BUDGET_EXCEEDED" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
             pointer: {
-                key: string;
                 kind: "context_key";
+                key: string;
             } | {
                 kind: "context_budget";
             } | {
@@ -311,8 +311,8 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
             message: string;
             code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "ASSESSMENT_FOLLOWUP_REQUIRED" | "MISSING_REQUIRED_NOTES" | "MISSING_CONTEXT_KEY" | "CONTEXT_BUDGET_EXCEEDED" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
             pointer: {
-                key: string;
                 kind: "context_key";
+                key: string;
             } | {
                 kind: "context_budget";
             } | {
@@ -347,8 +347,8 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
         guidance: string;
         dimensionId: string;
     } | {
-        key: string;
         kind: "missing_context_key";
+        key: string;
     } | {
         kind: "context_budget_exceeded";
     } | {
@@ -360,8 +360,8 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
             message: string;
             code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "ASSESSMENT_FOLLOWUP_REQUIRED" | "MISSING_REQUIRED_NOTES" | "MISSING_CONTEXT_KEY" | "CONTEXT_BUDGET_EXCEEDED" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
             pointer: {
-                key: string;
                 kind: "context_key";
+                key: string;
             } | {
                 kind: "context_budget";
             } | {
@@ -398,8 +398,8 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
         guidance: string;
         dimensionId: string;
     } | {
-        key: string;
         kind: "missing_context_key";
+        key: string;
     } | {
         kind: "context_budget_exceeded";
     } | {
@@ -411,8 +411,8 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
             message: string;
             code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "ASSESSMENT_FOLLOWUP_REQUIRED" | "MISSING_REQUIRED_NOTES" | "MISSING_CONTEXT_KEY" | "CONTEXT_BUDGET_EXCEEDED" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
             pointer: {
-                key: string;
                 kind: "context_key";
+                key: string;
             } | {
                 kind: "context_budget";
             } | {
@@ -493,11 +493,11 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
                 kind: z.ZodLiteral<"context_key">;
                 key: z.ZodString;
             }, "strict", z.ZodTypeAny, {
-                key: string;
                 kind: "context_key";
-            }, {
                 key: string;
+            }, {
                 kind: "context_key";
+                key: string;
             }>, z.ZodObject<{
                 kind: z.ZodLiteral<"context_budget">;
             }, "strict", z.ZodTypeAny, {
@@ -550,8 +550,8 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
             message: string;
             code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "ASSESSMENT_FOLLOWUP_REQUIRED" | "MISSING_REQUIRED_NOTES" | "MISSING_CONTEXT_KEY" | "CONTEXT_BUDGET_EXCEEDED" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
             pointer: {
-                key: string;
                 kind: "context_key";
+                key: string;
             } | {
                 kind: "context_budget";
             } | {
@@ -573,8 +573,8 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
             message: string;
             code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "ASSESSMENT_FOLLOWUP_REQUIRED" | "MISSING_REQUIRED_NOTES" | "MISSING_CONTEXT_KEY" | "CONTEXT_BUDGET_EXCEEDED" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
             pointer: {
-                key: string;
                 kind: "context_key";
+                key: string;
             } | {
                 kind: "context_budget";
             } | {
@@ -598,8 +598,8 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
             message: string;
             code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "ASSESSMENT_FOLLOWUP_REQUIRED" | "MISSING_REQUIRED_NOTES" | "MISSING_CONTEXT_KEY" | "CONTEXT_BUDGET_EXCEEDED" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
             pointer: {
-                key: string;
                 kind: "context_key";
+                key: string;
             } | {
                 kind: "context_budget";
             } | {
@@ -623,8 +623,8 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
             message: string;
             code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "ASSESSMENT_FOLLOWUP_REQUIRED" | "MISSING_REQUIRED_NOTES" | "MISSING_CONTEXT_KEY" | "CONTEXT_BUDGET_EXCEEDED" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
             pointer: {
-                key: string;
                 kind: "context_key";
+                key: string;
             } | {
                 kind: "context_budget";
             } | {
@@ -668,8 +668,8 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
             message: string;
             code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "ASSESSMENT_FOLLOWUP_REQUIRED" | "MISSING_REQUIRED_NOTES" | "MISSING_CONTEXT_KEY" | "CONTEXT_BUDGET_EXCEEDED" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
             pointer: {
-                key: string;
                 kind: "context_key";
+                key: string;
             } | {
                 kind: "context_budget";
             } | {
@@ -714,8 +714,8 @@ export declare const BlockedSnapshotV1Schema: z.ZodDiscriminatedUnion<"kind", [z
             message: string;
             code: "USER_ONLY_DEPENDENCY" | "MISSING_REQUIRED_OUTPUT" | "INVALID_REQUIRED_OUTPUT" | "ASSESSMENT_FOLLOWUP_REQUIRED" | "MISSING_REQUIRED_NOTES" | "MISSING_CONTEXT_KEY" | "CONTEXT_BUDGET_EXCEEDED" | "REQUIRED_CAPABILITY_UNKNOWN" | "REQUIRED_CAPABILITY_UNAVAILABLE" | "INVARIANT_VIOLATION" | "STORAGE_CORRUPTION_DETECTED";
             pointer: {
-                key: string;
                 kind: "context_key";
+                key: string;
             } | {
                 kind: "context_budget";
             } | {