@oxygen-agent/cli 1.832.1 → 1.833.2

package/README.md

@@ -34,4 +34,4 @@ oxygen update
 
 For product documentation, visit https://oxygen-agent.com/docs. For support, visit https://oxygen-agent.com.
 
-Version: 1.832.1
+Version: 1.833.2

package/dist/index.js

@@ -2835,7 +2835,7 @@ export function createProgram() {
     }));
     program
         .command("support")
-        .description("Open and track Plain support conversations for the active OXYGEN organization. In the app, use Settings → Support → Open support chat. Retry is the only recovery control; it returns after each failed connection attempt and never creates a Thread. CLI filing is a zero-credit write to the canonical Plain queue. Guide: https://oxygen-agent.com/docs/surfaces/support.")
+        .description("Open and track Plain support conversations for the active OXYGEN organization. In the app, the support chat is the widget in the bottom-right corner of every page. Retry is the only recovery control; it returns after each failed connection attempt and never creates a Thread. CLI filing is a zero-credit write to the canonical Plain queue. Guide: https://oxygen-agent.com/docs/surfaces/support.")
         .addCommand(new Command("file")
         .description("Create a real, zero-credit Plain support Thread immediately. This is a separate filing action, not the in-app Retry, and can create a second Thread: check `support list --status open` first and reply to the existing Thread for the same issue. There is no preview: review the exact subject, body, category, and severity before running it. Use when you're stuck on an OXYGEN operation.")
         .requiredOption("--subject <subject>", "One-line summary of the problem.")

package/node_modules/@oxygen/formula/dist/evaluate.d.ts

@@ -14,6 +14,12 @@ export type FormulaScope = {
      * reference must fail loudly rather than silently evaluate to null.
      */
     resolve(identifier: string): unknown;
+    /**
+     * Resolve a direct identifier argument to COALESCE. Hosts may return null
+     * for a recognized-but-absent optional path while keeping typos, unknown
+     * roots, and identifiers nested inside larger expressions strict.
+     */
+    resolveCoalescible?(identifier: string): unknown;
     /**
      * Lenient read used only by cross-row functions, which take a column key
      * rather than an in-scope identifier and treat an absent value as blank.

package/node_modules/@oxygen/formula/dist/evaluate.js

@@ -6,15 +6,20 @@ export function evaluateFormulaInScope(expression, scope, options = {}) {
     return evaluateFormulaAst(parseFormulaExpression(expression, options), scope);
 }
 export function evaluateFormulaAst(node, scope) {
+    return evaluateFormulaAstWithMode(node, scope, "strict");
+}
+function evaluateFormulaAstWithMode(node, scope, resolutionMode) {
     switch (node.type) { // skipcq: JS-0047
         case "literal":
             return node.value;
         case "identifier":
-            return scope.resolve(node.name);
+            return resolutionMode === "coalescible" && scope.resolveCoalescible
+                ? scope.resolveCoalescible(node.name)
+                : scope.resolve(node.name);
         case "unary":
-            return evaluateUnary(node.operator, evaluateFormulaAst(node.argument, scope));
+            return evaluateUnary(node.operator, evaluateFormulaAstWithMode(node.argument, scope, "strict"));
         case "binary":
-            return evaluateBinary(node.operator, () => evaluateFormulaAst(node.left, scope), () => evaluateFormulaAst(node.right, scope));
+            return evaluateBinary(node.operator, () => evaluateFormulaAstWithMode(node.left, scope, "strict"), () => evaluateFormulaAstWithMode(node.right, scope, "strict"));
         case "call": {
             const normalized = node.name.toLowerCase();
             if (CROSS_ROW_FUNCTIONS.has(normalized)) {
@@ -23,11 +28,14 @@ export function evaluateFormulaAst(node, scope) {
             const spec = FORMULA_FUNCTION_REGISTRY.get(normalized);
             if (spec)
                 checkFormulaFunctionArity(spec, node.args.length);
+            const evaluateArgument = (arg) => evaluateFormulaAstWithMode(arg, scope, normalized === "coalesce" && arg.type === "identifier"
+                ? "coalescible"
+                : "strict");
             if (spec?.lazy && spec.evaluateLazy) {
-                return spec.evaluateLazy(node.args.map((arg) => () => evaluateFormulaAst(arg, scope)));
+                return spec.evaluateLazy(node.args.map((arg) => () => evaluateArgument(arg)));
             }
             if (spec?.evaluate) {
-                return spec.evaluate(node.args.map((arg) => evaluateFormulaAst(arg, scope)));
+                return spec.evaluate(node.args.map(evaluateArgument));
             }
             throw formulaExpressionError("Unsupported formula function.", {
                 function: node.name,

package/node_modules/@oxygen/formula/dist/formula-functions.js

@@ -1017,11 +1017,19 @@ const SPECS = [
         name: "coalesce",
         category: "null_handling",
         signature: "coalesce(a, b, ...)",
-        description: "First non-blank argument, or null when all are blank.",
+        description: "First non-blank argument, or null when all are blank. In Workflow formulas, an absent descendant of a valid trigger, step, or loop binding counts as blank.",
         minArgs: 0,
         maxArgs: null,
+        lazy: true,
         examples: [{ expression: "coalesce(work_email, personal_email)", result: "jo@acme.com" }],
-        evaluate: (args) => args.find((arg) => !isBlankFormulaValue(arg)) ?? null,
+        evaluateLazy: (thunks) => {
+            for (const thunk of thunks) {
+                const value = thunk();
+                if (!isBlankFormulaValue(value))
+                    return value;
+            }
+            return null;
+        },
     }),
     spec({
         name: "default",

package/node_modules/@oxygen/shared/dist/version.d.ts

@@ -1,4 +1,4 @@
-export declare const OXYGEN_VERSION = "1.832.1";
+export declare const OXYGEN_VERSION = "1.833.2";
 export declare const OXYGEN_MINIMUM_CLI_VERSION = "1.181.0";
 export declare const MANAGED_INBOX_MINIMUM_CLI_VERSION = "1.326.2";
 export declare const SUPPORT_AGENT_REPLY_MINIMUM_CLI_VERSION = "1.747.0";

package/node_modules/@oxygen/shared/dist/version.js

@@ -1,4 +1,4 @@
-export const OXYGEN_VERSION = "1.832.1";
+export const OXYGEN_VERSION = "1.833.2";
 // The GLOBAL CLI compatibility floor: the oldest CLI allowed to call any
 // operational route. Raising it hard-rejects every older CLI from the entire
 // product, so it obeys one law, enforced by scripts/ci/cli-min-version-gate.mjs:

package/node_modules/@oxygen/workflows/dist/graph/expression.js

@@ -559,6 +559,17 @@ function formulaScopeFor(scope) {
             const found = lookupFormulaIdentifier(scope, identifier);
             return found.found ? found.value : undefined;
         },
+        resolveCoalescible(identifier) {
+            const found = lookupFormulaIdentifier(scope, identifier);
+            if (found.found)
+                return found.value;
+            if (isCoalescibleWorkflowFormulaPath(scope, identifier))
+                return null;
+            throw formulaExpressionError("Unknown identifier in workflow formula.", {
+                identifier,
+                hint: "Reference a workflow input, a node id, or a loop node id.",
+            });
+        },
     };
 }
 function lookupFormulaIdentifier(scope, identifier) {
@@ -587,6 +598,35 @@ function lookupFormulaIdentifier(scope, identifier) {
         return { found: true, value: readSegment(loop, "item") };
     return { found: false };
 }
+/**
+ * COALESCE may absorb an optional value below a real workflow binding, but it
+ * must not turn a misspelled root, node id, or structural segment into blank.
+ */
+function isCoalescibleWorkflowFormulaPath(scope, identifier) {
+    const segments = parseScopePath(identifier);
+    if (!segments)
+        return false;
+    const [root, owner, slot] = segments;
+    if (root === "trigger") {
+        return segments.length >= 3
+            && scope.trigger !== undefined
+            && (owner === "input" || owner === "payload");
+    }
+    if (root === "steps") {
+        return segments.length >= 4
+            && owner !== undefined
+            && slot === "output"
+            && Object.prototype.hasOwnProperty.call(scope.steps, owner);
+    }
+    if (root === "loop") {
+        return segments.length >= 4
+            && owner !== undefined
+            && slot === "item"
+            && scope.loop !== undefined
+            && Object.prototype.hasOwnProperty.call(scope.loop, owner);
+    }
+    return false;
+}
 function isPlainObject(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxygen-agent/cli",
-  "version": "1.832.1",
+  "version": "1.833.2",
   "private": false,
   "license": "UNLICENSED",
   "type": "module",