botmux 2.33.0 → 2.34.0

package/dist/workflows/output-binding.js

@@ -0,0 +1,265 @@
+/**
+ * Output binding resolver.
+ *
+ * Workflow author writes `{ "$ref": "<nodeId>.output.<path>" }` somewhere
+ * inside a hostExecutor `input` or a subagent / humanGate `prompt`.  At
+ * dispatch time we walk the value, find every `$ref`, and substitute
+ * it with the corresponding upstream value.  The substitution happens
+ * BEFORE `parseInput` / spawn / wait so consumers see fully-resolved
+ * literals.
+ *
+ * Failure model (codex round 6 tightenings):
+ *   - All errors are `BindingError` — caller maps to `activityFailed`
+ *     with `errorCode = 'InputBindingFailed'`, `errorClass = 'userFault'`.
+ *   - We never silently fall back to the event payload `externalRefs` —
+ *     `outputRef` blob is the contract.  Missing blob file ⇒ binding fails
+ *     loudly so the operator notices a write-side bug rather than getting
+ *     a half-resolved input.
+ *   - `{ "$ref": "..." }` is the typed binding primitive: an entire field
+ *     value is replaced and objects/arrays/numbers are preserved.
+ *   - String interpolation is intentionally narrow: `${...}` may embed the
+ *     same ref grammar inside a string, and only scalar values are allowed.
+ *     Objects/arrays must use whole-field `$ref`.
+ *
+ * Reference syntax:
+ *   `<nodeId>.output.<segment>(.<segment>)*`
+ *   `params.<segment>(.<segment>)*`
+ *
+ *   - `nodeId` is everything before the FIRST `.output.` occurrence.  We
+ *     split on `.output.` rather than the first `.` because `NODE_ID_PATTERN`
+ *     allows dots in node ids (e.g. `team.draft`).
+ *   - `params.*` reads the immutable run input blob written at runCreated.
+ *   - Each path segment must match `[A-Za-z0-9_-]+` or be a non-negative
+ *     integer (array index).  `__proto__` / `prototype` / `constructor`
+ *     are explicitly rejected to prevent prototype pollution.
+ */
+import { promises as fs } from 'node:fs';
+import { workActivityId } from './orchestrator.js';
+export class BindingError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'BindingError';
+    }
+}
+const REF_MARKER = '.output.';
+const PARAMS_PREFIX = 'params.';
+const SEGMENT_PATTERN = /^[A-Za-z0-9_-]+$/;
+const FORBIDDEN_SEGMENTS = new Set(['__proto__', 'prototype', 'constructor']);
+export function parseRef(ref) {
+    const idx = ref.indexOf(REF_MARKER);
+    if (idx < 0 && ref.startsWith(PARAMS_PREFIX)) {
+        const rawPath = ref.slice(PARAMS_PREFIX.length);
+        return { nodeId: 'params', pathSegments: parsePathSegments(rawPath, ref) };
+    }
+    if (idx < 0) {
+        throw new BindingError(`$ref '${ref}' missing '.output.' separator (expected '<nodeId>.output.<path>' or 'params.<path>')`);
+    }
+    const nodeId = ref.slice(0, idx);
+    if (!nodeId) {
+        throw new BindingError(`$ref '${ref}' has empty nodeId before '.output.'`);
+    }
+    const rawPath = ref.slice(idx + REF_MARKER.length);
+    if (!rawPath) {
+        throw new BindingError(`$ref '${ref}' has empty path after '.output.'`);
+    }
+    const segments = parsePathSegments(rawPath, ref);
+    return { nodeId, pathSegments: segments };
+}
+function parsePathSegments(rawPath, ref) {
+    if (!rawPath) {
+        throw new BindingError(`$ref '${ref}' has empty path`);
+    }
+    const segments = rawPath.split('.');
+    for (const seg of segments) {
+        if (!seg) {
+            throw new BindingError(`$ref '${ref}' has empty path segment`);
+        }
+        if (FORBIDDEN_SEGMENTS.has(seg)) {
+            throw new BindingError(`$ref '${ref}' uses forbidden segment '${seg}'`);
+        }
+        if (!SEGMENT_PATTERN.test(seg)) {
+            throw new BindingError(`$ref '${ref}' has invalid segment '${seg}' (must match [A-Za-z0-9_-]+)`);
+        }
+    }
+    return segments;
+}
+function isOutputRefSpec(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    if (Array.isArray(value))
+        return false;
+    const keys = Object.keys(value);
+    if (keys.length !== 1 || keys[0] !== '$ref')
+        return false;
+    return typeof value.$ref === 'string';
+}
+export async function resolveOutputRef(ref, ctx) {
+    const { nodeId, pathSegments } = parseRef(ref);
+    if (nodeId === 'params' && !ref.includes(REF_MARKER)) {
+        const params = await loadRunParams(ref, ctx);
+        return walkPath(params, pathSegments, ref);
+    }
+    const nodeDef = ctx.def.nodes[nodeId];
+    if (!nodeDef) {
+        throw new BindingError(`$ref '${ref}' targets unknown node '${nodeId}' (not in workflow definition)`);
+    }
+    const actId = workActivityId(ctx.snapshot.run.runId, nodeId);
+    const outputRef = ctx.snapshot.outputs.get(actId);
+    if (!outputRef) {
+        throw new BindingError(`$ref '${ref}' references node '${nodeId}' which has not produced a successful output yet`);
+    }
+    if (!outputRef.outputPath) {
+        // OutputRef.outputPath is optional in the schema (for older runs whose
+        // blob was inlined elsewhere), but v0 writes all blobs to disk via
+        // writeJsonBlob.  Fail loud rather than reading from event payload —
+        // codex round 6 finding: outputRef is the contract.
+        throw new BindingError(`$ref '${ref}' resolved to node '${nodeId}' outputRef with no outputPath; blob not on disk`);
+    }
+    let blob;
+    try {
+        const raw = await fs.readFile(outputRef.outputPath, 'utf-8');
+        blob = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new BindingError(`$ref '${ref}' failed to read output blob at ${outputRef.outputPath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // hostExecutor blob is `{ output, externalRefs }`; subagent blob is the
+    // bare `output` payload.  The `.output.` prefix in `$ref` syntax means
+    // "the logical output side" — for hostExecutor we go through the
+    // wrapping `output` key, for subagent we walk directly.
+    const root = nodeDef.type === 'hostExecutor'
+        ? blob?.output
+        : blob;
+    return walkPath(root, pathSegments, ref);
+}
+async function loadRunParams(ref, ctx) {
+    if (ctx.loadParams)
+        return ctx.loadParams();
+    const inputRef = ctx.snapshot.run.input;
+    if (!inputRef?.outputPath) {
+        throw new BindingError(`$ref '${ref}' requires run input params, but runCreated.inputRef has no outputPath`);
+    }
+    let params;
+    try {
+        const raw = await fs.readFile(inputRef.outputPath, 'utf-8');
+        params = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new BindingError(`$ref '${ref}' failed to read run params at ${inputRef.outputPath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (params === null || typeof params !== 'object' || Array.isArray(params)) {
+        throw new BindingError(`$ref '${ref}' resolved run params to non-object input`);
+    }
+    return params;
+}
+function walkPath(value, segments, ref) {
+    let cursor = value;
+    for (const [i, seg] of segments.entries()) {
+        if (cursor === null || cursor === undefined) {
+            throw new BindingError(`$ref '${ref}' hit ${cursor === null ? 'null' : 'undefined'} at segment '${seg}' (index ${i})`);
+        }
+        if (Array.isArray(cursor)) {
+            if (!/^\d+$/.test(seg)) {
+                throw new BindingError(`$ref '${ref}' segment '${seg}' is not a numeric index, but the current value is an array`);
+            }
+            const idx = Number(seg);
+            if (idx >= cursor.length) {
+                throw new BindingError(`$ref '${ref}' segment '${seg}' is out of array bounds (length ${cursor.length})`);
+            }
+            cursor = cursor[idx];
+            continue;
+        }
+        if (typeof cursor !== 'object') {
+            throw new BindingError(`$ref '${ref}' hit non-object '${typeof cursor}' at segment '${seg}' (index ${i})`);
+        }
+        // Use Object.prototype.hasOwnProperty to refuse inherited / prototype
+        // chain lookups even after the FORBIDDEN_SEGMENTS rejection in parseRef.
+        if (!Object.prototype.hasOwnProperty.call(cursor, seg)) {
+            throw new BindingError(`$ref '${ref}' segment '${seg}' not found on object (own-property check)`);
+        }
+        cursor = cursor[seg];
+    }
+    return cursor;
+}
+/**
+ * Recursive walker: every `$ref` form replaced by its resolved value,
+ * every other value left as-is.  Arrays/objects are reconstructed
+ * fresh so the caller gets a tree it can mutate without aliasing the
+ * workflow definition.
+ *
+ * NOTE: We do not resolve refs nested inside resolved values.  i.e. if
+ * upstream `output.x` itself contains a `$ref`-shaped object, that's
+ * data, not a ref.  Refs only originate from the workflow definition.
+ */
+export async function resolveBindings(value, ctx) {
+    if (isOutputRefSpec(value)) {
+        return resolveOutputRef(value.$ref, ctx);
+    }
+    if (typeof value === 'string') {
+        return interpolateStringRefs(value, ctx);
+    }
+    if (Array.isArray(value)) {
+        const out = [];
+        for (const v of value) {
+            out.push(await resolveBindings(v, ctx));
+        }
+        return out;
+    }
+    if (value !== null && typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = await resolveBindings(v, ctx);
+        }
+        return out;
+    }
+    return value;
+}
+async function interpolateStringRefs(value, ctx) {
+    if (!value.includes('${'))
+        return value;
+    let out = '';
+    let cursor = 0;
+    while (cursor < value.length) {
+        const start = value.indexOf('${', cursor);
+        if (start < 0) {
+            out += value.slice(cursor);
+            break;
+        }
+        out += value.slice(cursor, start);
+        const end = value.indexOf('}', start + 2);
+        if (end < 0) {
+            throw new BindingError(`unterminated string ref interpolation in '${value}'`);
+        }
+        const ref = value.slice(start + 2, end);
+        if (!ref) {
+            throw new BindingError(`empty string ref interpolation in '${value}'`);
+        }
+        const resolved = await resolveOutputRef(ref, ctx);
+        out += stringifyInterpolatedValue(ref, resolved);
+        cursor = end + 1;
+    }
+    return out;
+}
+function stringifyInterpolatedValue(ref, value) {
+    if (value === null)
+        return 'null';
+    const t = typeof value;
+    if (t === 'string')
+        return value;
+    if (t === 'number' || t === 'boolean')
+        return String(value);
+    throw new BindingError(`string interpolation '\${${ref}}' resolved to ${Array.isArray(value) ? 'array' : t} ` +
+        `(expected string/number/boolean/null; use whole-field $ref for structured values)`);
+}
+/**
+ * Convenience for fields typed as `BoundString` — guaranteed to resolve
+ * to a string.  Throws BindingError if a non-string ref slipped through.
+ */
+export async function resolveBoundString(value, ctx) {
+    const resolved = await resolveBindings(value, ctx);
+    if (typeof resolved !== 'string') {
+        throw new BindingError(`bound string field resolved to ${typeof resolved} (expected string)`);
+    }
+    return resolved;
+}
+//# sourceMappingURL=output-binding.js.map

package/dist/workflows/output-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-binding.js","sourceRoot":"","sources":["../../src/workflows/output-binding.ts"],"names":[],"mappings":"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"}

package/dist/workflows/params.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Shared params coercion + validation for `workflow run`.
+ *
+ * Used by:
+ *   - IM `/workflow run <id> key=value …`  (key=value strings from chat)
+ *   - CLI `botmux workflow run <id> --param key=value [--param-json key=<json>]`
+ *
+ * Behaviour contract (matches the schema in `ParamDefSchema`):
+ *   - Unknown param names → throw `unknown param` (don't silently pass through;
+ *     the workflow author hasn't declared them, so any binding would be a
+ *     latent typo).
+ *   - Missing required → throw.
+ *   - Missing optional + has `default` → fill with default verbatim.
+ *   - Missing optional + no default → omit (downstream `${params.X}` lookup
+ *     surfaces a `BindingError` on use, which is the right place to fail).
+ *   - Present + type=string → keep as string.
+ *   - Present + type=number → `Number(raw)`; reject NaN / Infinity.
+ *   - Present + type=boolean → accept `true/1/yes/y` / `false/0/no/n` (case
+ *     insensitive); reject anything else.
+ *   - Present + type=object|array → only valid via the JSON channel; the
+ *     plain string channel throws to tell the caller to use `--param-json`
+ *     (CLI) or pre-decoded JSON (programmatic).
+ */
+import type { WorkflowDefinition } from './definition.js';
+export type RawParamInput = {
+    kind: 'string';
+    value: string;
+} | {
+    kind: 'json';
+    value: unknown;
+};
+export type ParamCoerceError = {
+    /** Param name that failed; undefined for whole-record-shape errors. */
+    name?: string;
+    /** Machine code for the failure category. */
+    code: 'unknown_param' | 'missing_required' | 'type_mismatch' | 'unsupported_string_channel' | 'invalid_json';
+    /** Human-readable Chinese-localized message (matches existing CLI/IM output). */
+    message: string;
+};
+export declare class ParamCoerceFailure extends Error {
+    readonly issues: ParamCoerceError[];
+    constructor(issues: ParamCoerceError[]);
+}
+/**
+ * Validate + coerce raw caller input against the workflow's `params` schema.
+ *
+ * `rawParams` accepts a mixed map of `{ kind: 'string' | 'json' }` so that
+ * the CLI can pipe `--param-json` through the same code path as `--param`.
+ * The IM `/workflow run` legacy entry calls `coerceWorkflowParamsFromStrings`
+ * below which wraps every value as `{ kind: 'string' }`.
+ *
+ * All errors are aggregated into a single `ParamCoerceFailure` so the caller
+ * can render every issue at once instead of one-by-one Enter-key fixes.
+ */
+export declare function coerceWorkflowParams(def: WorkflowDefinition, rawParams: Record<string, RawParamInput>): Record<string, unknown>;
+/**
+ * Legacy convenience: when every input is a raw string (IM chat path), wrap
+ * each value into `{ kind: 'string' }` and delegate to `coerceWorkflowParams`.
+ */
+export declare function coerceWorkflowParamsFromStrings(def: WorkflowDefinition, rawParams: Record<string, string>): Record<string, unknown>;
+//# sourceMappingURL=params.d.ts.map

package/dist/workflows/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/workflows/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAY,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEpE,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAErC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,EACA,eAAe,GACf,kBAAkB,GAClB,eAAe,GACf,4BAA4B,GAC5B,cAAc,CAAC;IACnB,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC;gBACxB,MAAM,EAAE,gBAAgB,EAAE;CAKvC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,kBAAkB,EACvB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkDzB;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,kBAAkB,EACvB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB"}

package/dist/workflows/params.js

@@ -0,0 +1,195 @@
+/**
+ * Shared params coercion + validation for `workflow run`.
+ *
+ * Used by:
+ *   - IM `/workflow run <id> key=value …`  (key=value strings from chat)
+ *   - CLI `botmux workflow run <id> --param key=value [--param-json key=<json>]`
+ *
+ * Behaviour contract (matches the schema in `ParamDefSchema`):
+ *   - Unknown param names → throw `unknown param` (don't silently pass through;
+ *     the workflow author hasn't declared them, so any binding would be a
+ *     latent typo).
+ *   - Missing required → throw.
+ *   - Missing optional + has `default` → fill with default verbatim.
+ *   - Missing optional + no default → omit (downstream `${params.X}` lookup
+ *     surfaces a `BindingError` on use, which is the right place to fail).
+ *   - Present + type=string → keep as string.
+ *   - Present + type=number → `Number(raw)`; reject NaN / Infinity.
+ *   - Present + type=boolean → accept `true/1/yes/y` / `false/0/no/n` (case
+ *     insensitive); reject anything else.
+ *   - Present + type=object|array → only valid via the JSON channel; the
+ *     plain string channel throws to tell the caller to use `--param-json`
+ *     (CLI) or pre-decoded JSON (programmatic).
+ */
+export class ParamCoerceFailure extends Error {
+    issues;
+    constructor(issues) {
+        super(issues.map((i) => i.message).join('; '));
+        this.name = 'ParamCoerceFailure';
+        this.issues = issues;
+    }
+}
+/**
+ * Validate + coerce raw caller input against the workflow's `params` schema.
+ *
+ * `rawParams` accepts a mixed map of `{ kind: 'string' | 'json' }` so that
+ * the CLI can pipe `--param-json` through the same code path as `--param`.
+ * The IM `/workflow run` legacy entry calls `coerceWorkflowParamsFromStrings`
+ * below which wraps every value as `{ kind: 'string' }`.
+ *
+ * All errors are aggregated into a single `ParamCoerceFailure` so the caller
+ * can render every issue at once instead of one-by-one Enter-key fixes.
+ */
+export function coerceWorkflowParams(def, rawParams) {
+    const paramDefs = def.params ?? {};
+    const issues = [];
+    // 1) Reject unknown keys first.  The user's mental model is "I told you
+    //    everything I want"; unknown keys are likely typos.
+    for (const key of Object.keys(rawParams)) {
+        if (!Object.prototype.hasOwnProperty.call(paramDefs, key)) {
+            issues.push({
+                name: key,
+                code: 'unknown_param',
+                message: `未知参数：${key}`,
+            });
+        }
+    }
+    const out = {};
+    // 2) Walk the schema (not the caller input) so required + default rules
+    //    always apply.
+    for (const [name, param] of Object.entries(paramDefs)) {
+        const raw = rawParams[name];
+        if (!raw) {
+            if (param.default !== undefined) {
+                out[name] = param.default;
+                continue;
+            }
+            if (param.required) {
+                issues.push({
+                    name,
+                    code: 'missing_required',
+                    message: `缺少必填参数：${name}`,
+                });
+            }
+            continue;
+        }
+        try {
+            out[name] = coerceParam(name, param, raw);
+        }
+        catch (err) {
+            if (err instanceof ParamCoerceFailure)
+                issues.push(...err.issues);
+            else if (err instanceof Error) {
+                issues.push({ name, code: 'type_mismatch', message: err.message });
+            }
+            else {
+                issues.push({ name, code: 'type_mismatch', message: String(err) });
+            }
+        }
+    }
+    if (issues.length)
+        throw new ParamCoerceFailure(issues);
+    return out;
+}
+/**
+ * Legacy convenience: when every input is a raw string (IM chat path), wrap
+ * each value into `{ kind: 'string' }` and delegate to `coerceWorkflowParams`.
+ */
+export function coerceWorkflowParamsFromStrings(def, rawParams) {
+    const wrapped = {};
+    for (const [k, v] of Object.entries(rawParams)) {
+        wrapped[k] = { kind: 'string', value: v };
+    }
+    return coerceWorkflowParams(def, wrapped);
+}
+function coerceParam(name, param, raw) {
+    if (raw.kind === 'json') {
+        return coerceParamFromJson(name, param, raw.value);
+    }
+    return coerceParamFromString(name, param, raw.value);
+}
+function coerceParamFromString(name, param, raw) {
+    switch (param.type) {
+        case 'string':
+            return raw;
+        case 'number': {
+            const n = Number(raw);
+            if (!Number.isFinite(n)) {
+                throw new ParamCoerceFailure([
+                    {
+                        name,
+                        code: 'type_mismatch',
+                        message: `参数 ${name} 必须是 number,收到 "${raw}"`,
+                    },
+                ]);
+            }
+            return n;
+        }
+        case 'boolean':
+            return coerceBoolean(name, raw);
+        case 'object':
+        case 'array':
+            throw new ParamCoerceFailure([
+                {
+                    name,
+                    code: 'unsupported_string_channel',
+                    message: `参数 ${name} 的 ${param.type} 类型不能用 key=value 字符串传入,` +
+                        `请用 CLI \`--param-json ${name}=<json>\` 或 IM 端目前不支持 object/array`,
+                },
+            ]);
+    }
+}
+function coerceParamFromJson(name, param, value) {
+    switch (param.type) {
+        case 'string':
+            if (typeof value !== 'string') {
+                throw typeMismatch(name, param.type, value);
+            }
+            return value;
+        case 'number':
+            if (typeof value !== 'number' || !Number.isFinite(value)) {
+                throw typeMismatch(name, param.type, value);
+            }
+            return value;
+        case 'boolean':
+            if (typeof value !== 'boolean') {
+                throw typeMismatch(name, param.type, value);
+            }
+            return value;
+        case 'object':
+            if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+                throw typeMismatch(name, param.type, value);
+            }
+            return value;
+        case 'array':
+            if (!Array.isArray(value)) {
+                throw typeMismatch(name, param.type, value);
+            }
+            return value;
+    }
+}
+function coerceBoolean(name, raw) {
+    const normalized = raw.trim().toLowerCase();
+    if (['true', '1', 'yes', 'y'].includes(normalized))
+        return true;
+    if (['false', '0', 'no', 'n'].includes(normalized))
+        return false;
+    throw new ParamCoerceFailure([
+        {
+            name,
+            code: 'type_mismatch',
+            message: `参数 ${name} 必须是 boolean (true/false/1/0/yes/no),收到 "${raw}"`,
+        },
+    ]);
+}
+function typeMismatch(name, expected, got) {
+    const actual = Array.isArray(got) ? 'array' : got === null ? 'null' : typeof got;
+    return new ParamCoerceFailure([
+        {
+            name,
+            code: 'type_mismatch',
+            message: `参数 ${name} 必须是 ${expected},收到 ${actual}`,
+        },
+    ]);
+}
+//# sourceMappingURL=params.js.map

package/dist/workflows/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../src/workflows/params.ts"],"names":[],"mappings":"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"}