botmux 3.16.0 → 3.17.0

package/dist/workflows/v3/run-envelope.d.ts

@@ -153,8 +153,8 @@ export declare const V3RunEnvelopeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         specSha256: `sha256:${string}`;
         authorizedByOpenId?: string | undefined;
     };
-    runId: string;
     schemaVersion: 1;
+    runId: string;
     artifacts: {
         spec: {
             sha256: `sha256:${string}`;
@@ -191,8 +191,8 @@ export declare const V3RunEnvelopeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         specSha256: string;
         authorizedByOpenId?: string | undefined;
     };
-    runId: string;
     schemaVersion: 1;
+    runId: string;
     artifacts: {
         spec: {
             sha256: string;
@@ -395,8 +395,8 @@ export declare const V3RunEnvelopeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         revisionId: string;
         definitionSnapshotSha256: `sha256:${string}`;
     };
-    runId: string;
     schemaVersion: 1;
+    runId: string;
     artifacts: {
         spec: {
             sha256: `sha256:${string}`;
@@ -445,8 +445,8 @@ export declare const V3RunEnvelopeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         revisionId: string;
         definitionSnapshotSha256: string;
     };
-    runId: string;
     schemaVersion: 1;
+    runId: string;
     artifacts: {
         spec: {
             sha256: string;
@@ -598,8 +598,8 @@ export declare const V3RunEnvelopeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         dagSha256: `sha256:${string}`;
         goalRequestSha256?: `sha256:${string}` | undefined;
     };
-    runId: string;
     schemaVersion: 1;
+    runId: string;
     artifacts: {
         dag: {
             sha256: `sha256:${string}`;
@@ -634,8 +634,8 @@ export declare const V3RunEnvelopeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         dagSha256: string;
         goalRequestSha256?: string | undefined;
     };
-    runId: string;
     schemaVersion: 1;
+    runId: string;
     artifacts: {
         dag: {
             sha256: string;
@@ -790,8 +790,8 @@ export declare const V3RunEnvelopeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         integrity: "unverifiable_before_backfill";
         specSha256?: `sha256:${string}` | undefined;
     };
-    runId: string;
     schemaVersion: 1;
+    runId: string;
     artifacts: {
         dag: {
             sha256: `sha256:${string}`;
@@ -829,8 +829,8 @@ export declare const V3RunEnvelopeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         integrity: "unverifiable_before_backfill";
         specSha256?: string | undefined;
     };
-    runId: string;
     schemaVersion: 1;
+    runId: string;
     artifacts: {
         dag: {
             sha256: string;
@@ -867,8 +867,8 @@ export declare const V3RunEnvelopeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         specSha256: `sha256:${string}`;
         authorizedByOpenId?: string | undefined;
     };
-    runId: string;
     schemaVersion: 1;
+    runId: string;
     artifacts: {
         spec: {
             sha256: `sha256:${string}`;
@@ -909,8 +909,8 @@ export declare const V3RunEnvelopeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         revisionId: string;
         definitionSnapshotSha256: `sha256:${string}`;
     };
-    runId: string;
     schemaVersion: 1;
+    runId: string;
     artifacts: {
         spec: {
             sha256: `sha256:${string}`;
@@ -953,8 +953,8 @@ export declare const V3RunEnvelopeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         dagSha256: `sha256:${string}`;
         goalRequestSha256?: `sha256:${string}` | undefined;
     };
-    runId: string;
     schemaVersion: 1;
+    runId: string;
     artifacts: {
         dag: {
             sha256: `sha256:${string}`;
@@ -992,8 +992,8 @@ export declare const V3RunEnvelopeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         integrity: "unverifiable_before_backfill";
         specSha256?: `sha256:${string}` | undefined;
     };
-    runId: string;
     schemaVersion: 1;
+    runId: string;
     artifacts: {
         dag: {
             sha256: `sha256:${string}`;
@@ -1030,8 +1030,8 @@ export declare const V3RunEnvelopeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         specSha256: string;
         authorizedByOpenId?: string | undefined;
     };
-    runId: string;
     schemaVersion: 1;
+    runId: string;
     artifacts: {
         spec: {
             sha256: string;
@@ -1072,8 +1072,8 @@ export declare const V3RunEnvelopeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         revisionId: string;
         definitionSnapshotSha256: string;
     };
-    runId: string;
     schemaVersion: 1;
+    runId: string;
     artifacts: {
         spec: {
             sha256: string;
@@ -1116,8 +1116,8 @@ export declare const V3RunEnvelopeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         dagSha256: string;
         goalRequestSha256?: string | undefined;
     };
-    runId: string;
     schemaVersion: 1;
+    runId: string;
     artifacts: {
         dag: {
             sha256: string;
@@ -1155,8 +1155,8 @@ export declare const V3RunEnvelopeSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         integrity: "unverifiable_before_backfill";
         specSha256?: string | undefined;
     };
-    runId: string;
     schemaVersion: 1;
+    runId: string;
     artifacts: {
         dag: {
             sha256: string;

package/dist/workflows/v3/shared-node-runtime.d.ts

@@ -17,6 +17,7 @@
  * `docs/design/2026-06-01-v3-mvp-engine-split.md`.
  */
 import { type V3Dag, type V3Node, type V3ResultSchema } from './dag.js';
+import { type V3ArtifactOutputs } from './artifact-contract-declarations.js';
 export { matchLoopExitWhen, revisitBudgetStatus, } from './core-control.js';
 import { type StoredEvent, type V3ErrorClass, type V3UncertainHostEffect } from './journal.js';
 import type { RunChatBinding } from './grill-state.js';
@@ -38,7 +39,7 @@ export declare function renderGoalFile(goal: string, resultSchema?: V3ResultSche
     loopId: string;
     iteration: number;
     maxIterations: number;
-}, nodeInstructions?: string, hasWorkflowParams?: boolean): string;
+}, nodeInstructions?: string, hasWorkflowParams?: boolean, outputs?: V3ArtifactOutputs): string;
 /**
  * Map a node's failure to its terminal kind (the blocked/failed split):
  *   - `blocked`  = semantic/contract failure — retryable via a new attempt

package/dist/workflows/v3/shared-node-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared-node-runtime.d.ts","sourceRoot":"","sources":["../../../src/workflows/v3/shared-node-runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shared-node-runtime.d.ts","sourceRoot":"","sources":["../../../src/workflows/v3/shared-node-runtime.ts"],"names":[],"mappings":"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"}

package/dist/workflows/v3/shared-node-runtime.js

@@ -21,6 +21,7 @@ import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
 import { join, dirname, relative, isAbsolute, resolve, sep } from 'node:path';
 import { computeInputHash } from '../../utils/canonical-input-hash.js';
 import { DEFAULT_NODE_TIMEOUT_SEC, isGoalNode, isHostNode, isLoopNode, loopInstanceId, validateDag, } from './dag.js';
+import { validateManifestArtifactContract, } from './artifact-contract-declarations.js';
 import { matchLoopExitWhen, revisitBudgetStatus, } from './core-control.js';
 export { matchLoopExitWhen, revisitBudgetStatus, } from './core-control.js';
 import { decideNext } from './orchestrator.js';
@@ -47,7 +48,7 @@ import { composeV3HostGatePrompt, renderV3HostInputPreview, resolveV3HostInputTe
  * Rendered from `contract.ts` constants so the manifest shape stays a single
  * source of truth shared with codex's validator.
  */
-export function renderGoalFile(goal, resultSchema, loopCtx, nodeInstructions, hasWorkflowParams = false) {
+export function renderGoalFile(goal, resultSchema, loopCtx, nodeInstructions, hasWorkflowParams = false, outputs) {
     const E = GOAL_ENV;
     const kinds = MANIFEST_FILE_KINDS.join(' | ');
     const [okStatus, failStatus] = MANIFEST_STATUSES;
@@ -69,6 +70,18 @@ export function renderGoalFile(goal, resultSchema, loopCtx, nodeInstructions, ha
             '',
         ]
         : [];
+    const artifactSection = outputs
+        ? [
+            '## Public artifact outputs (REQUIRED for this node)',
+            'These stable output keys are part of the Workflow interface. Write every declared path under the output directory and list it in the success Manifest with the exact kind:',
+            '',
+            '  ' + JSON.stringify(outputs),
+            '',
+            'Manifest `name` is presentation-only and may be human-readable; downstream nodes resolve these products by output key → declared path.',
+            'A missing path or mismatched kind blocks the run and requires a Workflow revision; ordinary retry is disabled.',
+            '',
+        ]
+        : [];
     const loopSection = loopCtx
         ? [
             '## Loop context',
@@ -101,6 +114,7 @@ export function renderGoalFile(goal, resultSchema, loopCtx, nodeInstructions, ha
         ...instructionsSection,
         ...paramsSection,
         ...loopSection,
+        ...artifactSection,
         '## How to complete this node',
         'You are an autonomous agent completing exactly ONE botmux v3 workflow node.',
         'Work toward the goal above until it is done, then stop. Do NOT ask the user with interactive tools (they are disabled in this mode). If you genuinely need a human DECISION to proceed, use the human-ask escape hatch described below (also available as the `botmux-goal-ask` skill).',
@@ -153,6 +167,7 @@ export function classifyTerminal(errorClass, opts) {
         return opts.retryable === false ? 'failed' : 'blocked';
     switch (errorClass) {
         case 'manifestInvalid': // agent wrote a bad manifest — a retry may fix it
+        case 'artifactContractInvalid': // definition/manifest public product mismatch
         case 'resultInvalid': // result.json missing/violating — same
             return 'blocked';
         case 'workerError': // process crash = infrastructure
@@ -2054,7 +2069,7 @@ export async function runWorkflow(dag, deps, opts) {
                 maxIterations: nodesById.get(loopRef.loopId).maxIterations,
             }
             : undefined;
-        writeFileSync(goalPath, renderGoalFile(node.goal ?? '', node.resultSchema, loopCtx, node.override?.systemPromptAppend, !!workflowDataPath));
+        writeFileSync(goalPath, renderGoalFile(node.goal ?? '', node.resultSchema, loopCtx, node.override?.systemPromptAppend, !!workflowDataPath, node.outputs));
         // P2: per-dispatch capability merge — model redirect + sticky restriction.
         const effSnap = mergeNodeCapability(botSnap, node.override);
         const inputsPath = join(attemptDir, 'inputs.json');
@@ -2288,6 +2303,17 @@ export async function runWorkflow(dag, deps, opts) {
                         return;
                     }
                 }
+                const artifactContract = validateManifestArtifactContract(node.outputs, verdict.manifest);
+                if (!artifactContract.ok) {
+                    appendWorkerOutcome({
+                        type: 'nodeBlocked', nodeId: node.id, ...(instanceId ? { instanceId } : {}), attemptId,
+                        errorClass: 'artifactContractInvalid',
+                        errorCode: 'OUTPUT_CONTRACT_VIOLATION',
+                        recovery: 'reviseWorkflow',
+                        message: artifactContract.problems.join('; '),
+                    });
+                    return;
+                }
                 appendWorkerOutcome({
                     type: 'nodeSucceeded', nodeId: node.id, ...(instanceId ? { instanceId } : {}), attemptId, manifestPath: result.manifestPath,
                 });
@@ -2597,6 +2623,7 @@ export async function runWorkflow(dag, deps, opts) {
             inputs: bodyDef.inputs.map((r) => ({
                 from: loopInstanceId(ref.loopId, ref.iteration, r.from),
                 ...(r.select ? { select: r.select } : {}), // P3: 实例化时保留 selector
+                ...(r.output !== undefined ? { output: r.output } : {}),
             })),
         };
     }
@@ -2847,7 +2874,7 @@ export async function runWorkflow(dag, deps, opts) {
         const latestSuccess = (key) => [...events]
             .reverse()
             .find((e) => e.type === 'nodeSucceeded' && (e.instanceId ?? e.nodeId) === key);
-        const pushFrom = (label, nodeId, filter) => {
+        const pushFrom = (label, nodeId, filter, output) => {
             // Pin to the source's current effective instance (falls back to nodeId for
             // loop bodies / legacy with no instance).
             const key = snap.nodes.get(nodeId)?.effectiveInstanceId ?? nodeId;
@@ -2861,6 +2888,7 @@ export async function runWorkflow(dag, deps, opts) {
                     continue;
                 inputs.push({
                     from: label,
+                    ...(output ? { output } : {}),
                     ...(succ.instanceId ? { instanceId: succ.instanceId } : {}),
                     name: f.name,
                     path: join(upstreamOutputDir, f.path),
@@ -2904,11 +2932,24 @@ export async function runWorkflow(dag, deps, opts) {
         // so the agent reads the gap as a known contract issue, not silence.
         const selectorMisses = [];
         const pushRef = (ref) => {
-            const filter = ref.select
-                ? (f) => ref.select.name !== undefined ? f.name === ref.select.name : f.path === ref.select.path
-                : undefined;
+            // Loop-body refs have already been rewritten to iteration-qualified ids,
+            // which are intentionally absent from the outer DAG map. Resolve the
+            // matching authored body definition so output keys still map to their
+            // declared path instead of degrading to whole-manifest injection.
+            const source = nodesById.get(ref.from) ?? (loopRef
+                ? nodesById.get(loopRef.loopId).body.nodes.find((bodyNode) => loopInstanceId(loopRef.loopId, loopRef.iteration, bodyNode.id) === ref.from)
+                : undefined);
+            const declaredOutputs = source?.type === 'loop'
+                ? source.body?.nodes.find((bodyNode) => bodyNode.id === source.output?.from)?.outputs
+                : source?.outputs;
+            const declared = ref.output ? declaredOutputs?.[ref.output] : undefined;
+            const filter = declared
+                ? (f) => f.path === declared.path
+                : ref.select
+                    ? (f) => ref.select.name !== undefined ? f.name === ref.select.name : f.path === ref.select.path
+                    : undefined;
             const before = inputs.length;
-            pushFrom(ref.from, ref.from, filter);
+            pushFrom(ref.from, ref.from, filter, ref.output);
             if (ref.select && inputs.length === before) {
                 selectorMisses.push({ from: ref.from, reason: 'selectorMiss' });
             }