@exaudeus/workrail 3.35.1 → 3.36.0

package/dist/daemon/workflow-runner.js

@@ -43,6 +43,7 @@ exports.runStartupRecovery = runStartupRecovery;
 exports.makeContinueWorkflowTool = makeContinueWorkflowTool;
 exports.makeCompleteStepTool = makeCompleteStepTool;
 exports.makeBashTool = makeBashTool;
+exports.makeSpawnAgentTool = makeSpawnAgentTool;
 exports.makeReportIssueTool = makeReportIssueTool;
 exports.buildSessionRecap = buildSessionRecap;
 exports.buildSystemPrompt = buildSystemPrompt;
@@ -375,6 +376,30 @@ function getSchemas() {
             },
             required: ['filePath', 'content'],
         },
+        SpawnAgentParams: {
+            type: 'object',
+            properties: {
+                workflowId: {
+                    type: 'string',
+                    description: 'ID of the workflow to run in the child session (e.g. "wr.discovery").',
+                },
+                goal: {
+                    type: 'string',
+                    description: 'One-sentence description of what the child session should accomplish.',
+                },
+                workspacePath: {
+                    type: 'string',
+                    description: 'Absolute path to the workspace directory for the child session.',
+                },
+                context: {
+                    type: 'object',
+                    additionalProperties: true,
+                    description: 'Optional initial context variables to pass to the child workflow.',
+                },
+            },
+            required: ['workflowId', 'goal', 'workspacePath'],
+            additionalProperties: false,
+        },
     };
     return _schemas;
 }
@@ -657,6 +682,110 @@ function makeWriteTool(schemas, sessionId, emitter, workrailSessionId) {
         },
     };
 }
+function makeSpawnAgentTool(sessionId, ctx, apiKey, thisWorkrailSessionId, currentDepth, maxDepth, runWorkflowFn, schemas, emitter) {
+    return {
+        name: 'spawn_agent',
+        description: 'Spawn a child WorkRail session to handle a delegated sub-task. ' +
+            'Blocks until the child session completes, then returns the child\'s outcome and notes. ' +
+            'Use this when a step requires delegating a well-defined sub-task to a separate workflow. ' +
+            'IMPORTANT: The parent session\'s time limit (maxSessionMinutes) keeps ticking while the child runs. ' +
+            'Configure the parent with enough time to cover both its own work and the child\'s work. ' +
+            'Returns: { childSessionId, outcome: "success"|"error"|"timeout", notes: string }. ' +
+            'Check outcome before using notes -- on error/timeout, notes contains the error message.',
+        inputSchema: schemas['SpawnAgentParams'],
+        label: 'Spawn Agent',
+        execute: async (_toolCallId, params) => {
+            console.log(`[WorkflowRunner] Tool: spawn_agent sessionId=${sessionId} workflowId=${String(params.workflowId)} depth=${currentDepth}/${maxDepth}`);
+            emitter?.emit({ kind: 'tool_called', sessionId, toolName: 'spawn_agent', summary: `${String(params.workflowId)} depth=${currentDepth}`, ...withWorkrailSession(thisWorkrailSessionId) });
+            if (currentDepth >= maxDepth) {
+                const limitResult = {
+                    childSessionId: null,
+                    outcome: 'error',
+                    notes: `Max spawn depth exceeded (currentDepth=${currentDepth}, maxDepth=${maxDepth}). ` +
+                        `Cannot spawn a child session from this depth. ` +
+                        `Increase agentConfig.maxSubagentDepth if deeper delegation is intentional.`,
+                };
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(limitResult) }],
+                    details: limitResult,
+                };
+            }
+            const startInput = {
+                workflowId: String(params.workflowId),
+                workspacePath: String(params.workspacePath),
+                goal: String(params.goal),
+            };
+            const startResult = await (0, start_js_1.executeStartWorkflow)(startInput, ctx, { is_autonomous: 'true', workspacePath: String(params.workspacePath), parentSessionId: thisWorkrailSessionId });
+            if (startResult.isErr()) {
+                const errResult = {
+                    childSessionId: null,
+                    outcome: 'error',
+                    notes: `Failed to start child workflow: ${startResult.error.kind} -- ${JSON.stringify(startResult.error)}`,
+                };
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(errResult) }],
+                    details: errResult,
+                };
+            }
+            let childSessionId = null;
+            const childContinueToken = startResult.value.response.continueToken ?? '';
+            if (childContinueToken) {
+                const decoded = await (0, v2_token_ops_js_1.parseContinueTokenOrFail)(childContinueToken, ctx.v2.tokenCodecPorts, ctx.v2.tokenAliasStore);
+                if (decoded.isOk()) {
+                    childSessionId = decoded.value.sessionId;
+                }
+                else {
+                    console.warn(`[WorkflowRunner] spawn_agent: could not decode childSessionId from continueToken -- ` +
+                        `childSessionId will be null in result. Reason: ${decoded.error.message}`);
+                }
+            }
+            const childResult = await runWorkflowFn({
+                workflowId: String(params.workflowId),
+                goal: String(params.goal),
+                workspacePath: String(params.workspacePath),
+                context: params.context,
+                spawnDepth: currentDepth + 1,
+                parentSessionId: thisWorkrailSessionId,
+                _preAllocatedStartResponse: startResult.value.response,
+            }, ctx, apiKey, undefined, emitter);
+            let resultObj;
+            if (childResult._tag === 'success') {
+                resultObj = {
+                    childSessionId,
+                    outcome: 'success',
+                    notes: childResult.lastStepNotes ?? '(no notes from child session)',
+                };
+            }
+            else if (childResult._tag === 'error') {
+                resultObj = {
+                    childSessionId,
+                    outcome: 'error',
+                    notes: childResult.message,
+                };
+            }
+            else if (childResult._tag === 'timeout') {
+                resultObj = {
+                    childSessionId,
+                    outcome: 'timeout',
+                    notes: childResult.message,
+                };
+            }
+            else {
+                resultObj = {
+                    childSessionId,
+                    outcome: 'success',
+                    notes: `Child workflow completed, but result delivery failed: ${childResult.deliveryError}`,
+                };
+            }
+            console.log(`[WorkflowRunner] spawn_agent completed: sessionId=${sessionId} childSessionId=${childSessionId ?? 'null'} outcome=${resultObj.outcome}`);
+            emitter?.emit({ kind: 'tool_called', sessionId, toolName: 'spawn_agent_complete', summary: `outcome=${resultObj.outcome} child=${childSessionId ?? 'null'}`, ...withWorkrailSession(thisWorkrailSessionId) });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(resultObj) }],
+                details: resultObj,
+            };
+        },
+    };
+}
 async function appendIssueAsync(issuesDir, sessionId, record) {
     await fs.mkdir(issuesDir, { recursive: true });
     const filePath = path.join(issuesDir, `${sessionId}.jsonl`);
@@ -773,6 +902,7 @@ Good pattern: "Question: Should I check the middleware? Answer: The workflow ste
 - \`Read\`: Read files.
 - \`Write\`: Write files.
 - \`report_issue\`: Record a structured issue, error, or unexpected behavior. Call this AND complete_step (unless fatal). Does not stop the session -- it creates a record for the auto-fix coordinator.
+- \`spawn_agent\`: Delegate a sub-task to a child WorkRail session. BLOCKS until the child completes. Returns \`{ childSessionId, outcome: "success"|"error"|"timeout", notes: string }\`. Always check \`outcome\` before using \`notes\`. IMPORTANT: your session's time limit (maxSessionMinutes) keeps running while the child executes -- ensure your parent session has enough time for both your work AND the child's work. Maximum spawn depth is 3 by default (configurable). Use only when a step explicitly asks for delegation or when a clearly separable sub-task would benefit from its own WorkRail audit trail.
 
 ## Execution contract
 1. Read the step carefully. Do ALL the work the step asks for.
@@ -936,6 +1066,8 @@ async function runWorkflow(trigger, ctx, apiKey, daemonRegistry, emitter) {
         return { _tag: 'success', workflowId: trigger.workflowId, stopReason: 'stop' };
     }
     const schemas = getSchemas();
+    const spawnCurrentDepth = trigger.spawnDepth ?? 0;
+    const spawnMaxDepth = trigger.agentConfig?.maxSubagentDepth ?? 3;
     const tools = [
         makeCompleteStepTool(sessionId, ctx, () => currentContinueToken, onAdvance, onComplete, (t) => { currentContinueToken = t; }, schemas, index_js_1.executeContinueWorkflow, emitter, workrailSessionId),
         makeContinueWorkflowTool(sessionId, ctx, onAdvance, onComplete, schemas, index_js_1.executeContinueWorkflow, emitter, workrailSessionId),
@@ -947,6 +1079,7 @@ async function runWorkflow(trigger, ctx, apiKey, daemonRegistry, emitter) {
                 issueSummaries.push(summary);
             }
         }),
+        makeSpawnAgentTool(sessionId, ctx, apiKey, workrailSessionId ?? '', spawnCurrentDepth, spawnMaxDepth, runWorkflow, schemas, emitter),
     ];
     const [soulContent, workspaceContext, sessionNotes] = await Promise.all([
         loadDaemonSoul(trigger.soulFile),

package/dist/manifest.json

@@ -445,12 +445,12 @@
       "sha256": "cf9d09641f1c31fffe6c7835b30bbbad52572befec1acab7fb9a0c188431af36",
       "bytes": 60355
     },
-    "console-ui/assets/index-D7jQyCSD.js": {
-      "sha256": "f0692154276f354dbbdce868634b19caf01a3b5d2a2e033bb1ecd19d61889eb9",
+    "console-ui/assets/index-n8cJrS4v.js": {
+      "sha256": "a676f6e7685eebaf2edb1feaa6cfe382131ce9faaee8efe6974e4073d935af7b",
       "bytes": 754955
     },
     "console-ui/index.html": {
-      "sha256": "83c7ee221c0d7e05b7e1728f795a289cd317dfe922a49c460ac66f1cebd4c097",
+      "sha256": "14f1536e9c93a887a2c7c2a30c8297a0ae537c20f0f552cc2d79d1ee07728b7f",
       "bytes": 417
     },
     "console/standalone-console.d.ts": {
@@ -502,12 +502,12 @@
       "bytes": 1009
     },
     "daemon/workflow-runner.d.ts": {
-      "sha256": "598ca3cda5dba827d0eddf80baf4136b401d821c81ec83aacbee05a63b836d9a",
-      "bytes": 4103
+      "sha256": "0d6b407a188357fd00cc534f8af754e83d9f0f1a5f5f599d8b39f92ffeab8904",
+      "bytes": 4496
     },
     "daemon/workflow-runner.js": {
-      "sha256": "a54677cdf2d2083fd9672b25b9d2264defa8dde7b357055bc14748d0ce9e7098",
-      "bytes": 56093
+      "sha256": "d7a7781ac06354b73e3d8859aebd654986255f653ac8df49b2e4a68b3da2ae9b",
+      "bytes": 63759
     },
     "di/container.d.ts": {
       "sha256": "003bb7fb7478d627524b9b1e76bd0a963a243794a687ff233b96dc0e33a06d9f",
@@ -954,8 +954,8 @@
       "bytes": 2769
     },
     "mcp/handlers/v2-advance-events.js": {
-      "sha256": "6b77a18f4818355b986b96af50df86d629f235226d619e27a35eb50384c0f770",
-      "bytes": 5187
+      "sha256": "c23df725685ee2062f44e05512ee4463c9b29ed4d67a4e72846496d59920733c",
+      "bytes": 5235
     },
     "mcp/handlers/v2-checkpoint.d.ts": {
       "sha256": "8f22b341bb0ffffb3b24a89067e2a6513ef004ca21c1a42ce48979c2c663b18c",
@@ -1038,12 +1038,12 @@
       "bytes": 11397
     },
     "mcp/handlers/v2-execution/start.d.ts": {
-      "sha256": "3d93d6119b89d6cabf8bebbaafd24d8de53d84dd671440d221dda5a238ba4fc4",
-      "bytes": 3519
+      "sha256": "1ebd5c3790f5bedaf032e4f5271a78d43629b82ecc351c3fc0f17f326d915d5d",
+      "bytes": 3558
     },
     "mcp/handlers/v2-execution/start.js": {
-      "sha256": "f57771c4baa31204fc683615802a02c4c9cf65e8727426210fc656d173e9fe51",
-      "bytes": 21208
+      "sha256": "d2ffbf775d5ea6ce68174d428129fad1377033e09fcdeb69c24c9d8fb04885b4",
+      "bytes": 21354
     },
     "mcp/handlers/v2-execution/workflow-object-cache.d.ts": {
       "sha256": "7e58a2a020fd8443821dbe4e6a2702a9882c517f032a340c1b393cdebf4af907",
@@ -2166,8 +2166,8 @@
       "bytes": 3397
     },
     "v2/durable-core/schemas/export-bundle/index.d.ts": {
-      "sha256": "4705633548971164d18baa2564fc7306f3687665896a33743a0eccf753c701d4",
-      "bytes": 533636
+      "sha256": "fa406033adbb001b8044836a96c999273814d14b35e4c6d98b644ab22424d3d9",
+      "bytes": 535324
     },
     "v2/durable-core/schemas/export-bundle/index.js": {
       "sha256": "6e3566b2d05ea6302bbf4d311b8ec3e94725a8523834efe7670a79e7bd7dc40d",
@@ -2222,20 +2222,20 @@
       "bytes": 2138
     },
     "v2/durable-core/schemas/session/events.d.ts": {
-      "sha256": "825319ae3964b8983e823f4ed69804840ea69b494d583620387605fb5f127225",
-      "bytes": 80143
+      "sha256": "dc0098d909c240bccd9508c6ed987b50b6a9c162f1f9f7a1d49d53dfefc1535f",
+      "bytes": 80635
     },
     "v2/durable-core/schemas/session/events.js": {
-      "sha256": "cc9f2ae04c788e878533c0b807385bc48341df40c3e01aee22e5881ff5348364",
-      "bytes": 12904
+      "sha256": "8af751c61d8c30802ce13174020893c8dfd59fcb4d15a34efc1abe05a2116e0d",
+      "bytes": 12950
     },
     "v2/durable-core/schemas/session/gaps.d.ts": {
-      "sha256": "399cc4f39e065d60f1a339908da181016281d57903bb7ce525a41d07b53ecc71",
-      "bytes": 8721
+      "sha256": "c42f2b86dd8275f5e35c8b144d5f49775741612b8625806b1aebeeb594248338",
+      "bytes": 8983
     },
     "v2/durable-core/schemas/session/gaps.js": {
-      "sha256": "b57ac509c9cb6c13a5eb3ef7dd4d7bc97d072465613d31a0d24e5607525c2182",
-      "bytes": 2069
+      "sha256": "566d96b60855e4d62360d8ecf0058b810fd514e2be1249221b2bd2cc3e7490d0",
+      "bytes": 2101
     },
     "v2/durable-core/schemas/session/index.d.ts": {
       "sha256": "f4f500d33d212760f480d91fafd4474f7b12f9239a6c5e9c2d80d0fe96207b65",

package/dist/mcp/handlers/v2-advance-events.js

@@ -50,7 +50,7 @@ function buildRecommendationWarningEvents(args) {
             data: {
                 gapId,
                 severity: 'warning',
-                reason: w.kind,
+                reason: { category: 'unexpected', detail: 'evaluation_error' },
                 summary: w.summary,
                 resolution: { kind: 'unresolved' },
             },

package/dist/mcp/handlers/v2-execution/start.d.ts

@@ -46,6 +46,7 @@ export declare function buildInitialEvents(args: {
     };
     readonly goal: string;
     readonly extraContext?: Readonly<Record<string, string>>;
+    readonly parentSessionId?: string;
 }): readonly DomainEventV1[];
 export declare function mintStartTokens(args: {
     readonly sessionId: SessionId;

package/dist/mcp/handlers/v2-execution/start.js

@@ -109,7 +109,7 @@ function loadAndPinWorkflow(args) {
     });
 }
 function buildInitialEvents(args) {
-    const { sessionId, runId, nodeId, workflowId, workflowHash, workflowSourceKind, workflowSourceRef, snapshotRef, observations, idFactory, goal, extraContext, } = args;
+    const { sessionId, runId, nodeId, workflowId, workflowHash, workflowSourceKind, workflowSourceRef, snapshotRef, observations, idFactory, goal, extraContext, parentSessionId, } = args;
     const evtSessionCreated = idFactory.mintEventId();
     const evtRunStarted = idFactory.mintEventId();
     const evtNodeCreated = idFactory.mintEventId();
@@ -123,7 +123,7 @@ function buildInitialEvents(args) {
             sessionId,
             kind: constants_js_1.EVENT_KIND.SESSION_CREATED,
             dedupeKey: `session_created:${sessionId}`,
-            data: {},
+            data: parentSessionId !== undefined ? { parentSessionId } : {},
         },
         {
             v: 1,
@@ -314,6 +314,7 @@ function executeStartWorkflow(input, ctx, internalContext) {
                     idFactory,
                     goal: input.goal,
                     extraContext: internalContext,
+                    parentSessionId: internalContext?.['parentSessionId'],
                 });
                 const emptyTruth = { manifest: [], events: [] };
                 return gate.withHealthySessionLock(sessionId, (lock) => sessionStore.append(lock, {

package/dist/v2/durable-core/schemas/export-bundle/index.d.ts

@@ -75,10 +75,18 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
         }>>;
     } & {
         kind: z.ZodLiteral<"session_created">;
-        data: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        data: z.ZodObject<{
+            parentSessionId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            parentSessionId?: string | undefined;
+        }, {
+            parentSessionId?: string | undefined;
+        }>;
     }, "strip", z.ZodTypeAny, {
         kind: "session_created";
-        data: {};
+        data: {
+            parentSessionId?: string | undefined;
+        };
         v: 1;
         sessionId: string;
         eventIndex: number;
@@ -90,7 +98,9 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
         } | undefined;
     }, {
         kind: "session_created";
-        data: {};
+        data: {
+            parentSessionId?: string | undefined;
+        };
         v: 1;
         sessionId: string;
         eventIndex: number;
@@ -1849,12 +1859,12 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
                 category: "user_only_dependency";
             }>, z.ZodObject<{
                 category: z.ZodLiteral<"contract_violation">;
-                detail: z.ZodEnum<["missing_required_output", "invalid_required_output", "missing_required_notes"]>;
+                detail: z.ZodEnum<["missing_required_output", "invalid_required_output", "missing_required_notes", "assessment_followup_required"]>;
             }, "strip", z.ZodTypeAny, {
-                detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                 category: "contract_violation";
             }, {
-                detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                 category: "contract_violation";
             }>, z.ZodObject<{
                 category: z.ZodLiteral<"capability_missing">;
@@ -1917,7 +1927,7 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
                 detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
                 category: "user_only_dependency";
             } | {
-                detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                 category: "contract_violation";
             } | {
                 detail: "required_capability_unknown" | "required_capability_unavailable";
@@ -1947,7 +1957,7 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
                 detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
                 category: "user_only_dependency";
             } | {
-                detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                 category: "contract_violation";
             } | {
                 detail: "required_capability_unknown" | "required_capability_unavailable";
@@ -1980,7 +1990,7 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
                 detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
                 category: "user_only_dependency";
             } | {
-                detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                 category: "contract_violation";
             } | {
                 detail: "required_capability_unknown" | "required_capability_unavailable";
@@ -2022,7 +2032,7 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
                 detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
                 category: "user_only_dependency";
             } | {
-                detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                 category: "contract_violation";
             } | {
                 detail: "required_capability_unknown" | "required_capability_unavailable";
@@ -4724,7 +4734,9 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
     }>;
     events: ({
         kind: "session_created";
-        data: {};
+        data: {
+            parentSessionId?: string | undefined;
+        };
         v: 1;
         sessionId: string;
         eventIndex: number;
@@ -5022,7 +5034,7 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
                 detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
                 category: "user_only_dependency";
             } | {
-                detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                 category: "contract_violation";
             } | {
                 detail: "required_capability_unknown" | "required_capability_unavailable";
@@ -5300,7 +5312,9 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
     }>;
     events: ({
         kind: "session_created";
-        data: {};
+        data: {
+            parentSessionId?: string | undefined;
+        };
         v: 1;
         sessionId: string;
         eventIndex: number;
@@ -5598,7 +5612,7 @@ export declare const SessionContentsV1Schema: z.ZodObject<{
                 detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
                 category: "user_only_dependency";
             } | {
-                detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                 category: "contract_violation";
             } | {
                 detail: "required_capability_unknown" | "required_capability_unavailable";
@@ -5783,10 +5797,18 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
             }>>;
         } & {
             kind: z.ZodLiteral<"session_created">;
-            data: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+            data: z.ZodObject<{
+                parentSessionId: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                parentSessionId?: string | undefined;
+            }, {
+                parentSessionId?: string | undefined;
+            }>;
         }, "strip", z.ZodTypeAny, {
             kind: "session_created";
-            data: {};
+            data: {
+                parentSessionId?: string | undefined;
+            };
             v: 1;
             sessionId: string;
             eventIndex: number;
@@ -5798,7 +5820,9 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
             } | undefined;
         }, {
             kind: "session_created";
-            data: {};
+            data: {
+                parentSessionId?: string | undefined;
+            };
             v: 1;
             sessionId: string;
             eventIndex: number;
@@ -7557,12 +7581,12 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                     category: "user_only_dependency";
                 }>, z.ZodObject<{
                     category: z.ZodLiteral<"contract_violation">;
-                    detail: z.ZodEnum<["missing_required_output", "invalid_required_output", "missing_required_notes"]>;
+                    detail: z.ZodEnum<["missing_required_output", "invalid_required_output", "missing_required_notes", "assessment_followup_required"]>;
                 }, "strip", z.ZodTypeAny, {
-                    detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                    detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                     category: "contract_violation";
                 }, {
-                    detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                    detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                     category: "contract_violation";
                 }>, z.ZodObject<{
                     category: z.ZodLiteral<"capability_missing">;
@@ -7625,7 +7649,7 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                     detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
                     category: "user_only_dependency";
                 } | {
-                    detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                    detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                     category: "contract_violation";
                 } | {
                     detail: "required_capability_unknown" | "required_capability_unavailable";
@@ -7655,7 +7679,7 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                     detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
                     category: "user_only_dependency";
                 } | {
-                    detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                    detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                     category: "contract_violation";
                 } | {
                     detail: "required_capability_unknown" | "required_capability_unavailable";
@@ -7688,7 +7712,7 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                     detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
                     category: "user_only_dependency";
                 } | {
-                    detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                    detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                     category: "contract_violation";
                 } | {
                     detail: "required_capability_unknown" | "required_capability_unavailable";
@@ -7730,7 +7754,7 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                     detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
                     category: "user_only_dependency";
                 } | {
-                    detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                    detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                     category: "contract_violation";
                 } | {
                     detail: "required_capability_unknown" | "required_capability_unavailable";
@@ -10432,7 +10456,9 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
         }>;
         events: ({
             kind: "session_created";
-            data: {};
+            data: {
+                parentSessionId?: string | undefined;
+            };
             v: 1;
             sessionId: string;
             eventIndex: number;
@@ -10730,7 +10756,7 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                     detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
                     category: "user_only_dependency";
                 } | {
-                    detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                    detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                     category: "contract_violation";
                 } | {
                     detail: "required_capability_unknown" | "required_capability_unavailable";
@@ -11008,7 +11034,9 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
         }>;
         events: ({
             kind: "session_created";
-            data: {};
+            data: {
+                parentSessionId?: string | undefined;
+            };
             v: 1;
             sessionId: string;
             eventIndex: number;
@@ -11306,7 +11334,7 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                     detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
                     category: "user_only_dependency";
                 } | {
-                    detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                    detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                     category: "contract_violation";
                 } | {
                     detail: "required_capability_unknown" | "required_capability_unavailable";
@@ -11613,7 +11641,9 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
         }>;
         events: ({
             kind: "session_created";
-            data: {};
+            data: {
+                parentSessionId?: string | undefined;
+            };
             v: 1;
             sessionId: string;
             eventIndex: number;
@@ -11911,7 +11941,7 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                     detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
                     category: "user_only_dependency";
                 } | {
-                    detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                    detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                     category: "contract_violation";
                 } | {
                     detail: "required_capability_unknown" | "required_capability_unavailable";
@@ -12206,7 +12236,9 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
         }>;
         events: ({
             kind: "session_created";
-            data: {};
+            data: {
+                parentSessionId?: string | undefined;
+            };
             v: 1;
             sessionId: string;
             eventIndex: number;
@@ -12504,7 +12536,7 @@ export declare const ExportBundleV1Schema: z.ZodObject<{
                     detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
                     category: "user_only_dependency";
                 } | {
-                    detail: "invalid_required_output" | "missing_required_output" | "missing_required_notes";
+                    detail: "invalid_required_output" | "missing_required_output" | "assessment_followup_required" | "missing_required_notes";
                     category: "contract_violation";
                 } | {
                     detail: "required_capability_unknown" | "required_capability_unavailable";