botmux-workflow-core 3.16.0 → 3.17.0

package/dist/types/src/workflows/v3/artifact-contract-declarations.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Authored public-artifact contracts for v3 DAG schemaVersion 2.
+ *
+ * A stable output key is the only cross-node identifier. Manifest `name`
+ * remains presentation metadata; the contract resolves the key to path/kind.
+ */
+import { type Manifest, type ManifestFileKind } from './artifact-contract.js';
+export declare const V3_ARTIFACT_OUTPUT_KEY_RE: RegExp;
+export declare const V3_ARTIFACT_OUTPUT_MAX_COUNT = 32;
+export declare const V3_ARTIFACT_OUTPUT_MAX_BYTES: number;
+export interface V3ArtifactOutputDeclaration {
+    path: string;
+    kind: ManifestFileKind;
+}
+export type V3ArtifactOutputs = Record<string, V3ArtifactOutputDeclaration>;
+export interface V3ArtifactContractValidation {
+    ok: boolean;
+    problems: string[];
+}
+export declare function normalizeArtifactOutputs(value: unknown, where: string, problems: string[]): V3ArtifactOutputs | undefined;
+export declare function validateManifestArtifactContract(outputs: V3ArtifactOutputs | undefined, manifest: Manifest): V3ArtifactContractValidation;

package/dist/types/src/workflows/v3/dag.d.ts

@@ -11,6 +11,7 @@
  * two schemas would drag v0.2's complexity into the new engine.  See
  * `docs/design/2026-06-01-v3-mvp-engine-split.md` §3 for the authored shape.
  */
+import { type V3ArtifactOutputs } from './artifact-contract-declarations.js';
 /**
  * `goal` — an LLM node driven by the `botmux-goal` skill (single goal, one
  *   ephemeral worker).  `host` — a deterministic side-effect node (feishu-send
@@ -73,6 +74,8 @@ export interface V3InputRef {
         name?: string;
         path?: string;
     };
+    /** schemaVersion 2 stable public-output key. */
+    output?: string;
 }
 /**
  * A normalized incoming edge (edge-activation design 2026-06-06 §1.1).
@@ -224,6 +227,8 @@ export interface V3Node {
     override?: V3CapabilityOverride;
     /** Upstream products to thread in as inputs (every `from` ⊆ `depends`). */
     inputs: V3InputRef[];
+    /** schemaVersion 2 public products addressable by downstream output keys. */
+    outputs?: V3ArtifactOutputs;
     /** Wall-clock budget in seconds; falls back to DEFAULT_NODE_TIMEOUT_SEC. */
     timeoutSec?: number;
     /** Optional human approval gate, evaluated *before* the node's work runs. */
@@ -303,6 +308,8 @@ export declare function isLoopNode(node: V3Node): node is V3LoopNode;
  */
 export declare function loopInstanceId(loopId: string, iteration: number, bodyNodeId: string): string;
 export interface V3Dag {
+    /** Missing means legacy v1. Newly authored DAGs use schemaVersion 2. */
+    schemaVersion?: 1 | 2;
     /** Stable id for this run; used as the runDir name, so path-segment safe. */
     runId: string;
     nodes: V3Node[];

package/dist/types/src/workflows/v3/event-contract.d.ts

@@ -20,8 +20,9 @@ export type GoalAnswer = {
     text: string;
     by: string;
 };
-export type V3ErrorClass = 'workerError' | 'manifestInvalid' | 'resultInvalid' | 'timeout' | 'gateRejected' | 'cancelled';
+export type V3ErrorClass = 'workerError' | 'manifestInvalid' | 'artifactContractInvalid' | 'resultInvalid' | 'timeout' | 'gateRejected' | 'cancelled';
 export type V3RunFailureReason = 'allSinksSkipped';
+export type V3BlockedRecovery = 'retry' | 'reviseWorkflow';
 export interface V3UncertainHostEffect {
     nodeId: string;
     instanceId: string;
@@ -128,6 +129,7 @@ export type V3Event = {
     errorClass: V3ErrorClass;
     errorCode?: string;
     message?: string;
+    recovery?: V3BlockedRecovery;
     ask?: GoalAsk;
     revisitTo?: string;
 } | {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "botmux-workflow-core",
-  "version": "3.16.0",
+  "version": "3.17.0",
   "description": "Daemon-independent Workflow v3 schema, scheduler, control policy, and host contracts",
   "type": "module",
   "sideEffects": false,