@oxygen-agent/cli 1.982.3 → 1.1003.12

package/node_modules/@oxygen/shared/dist/type-guards.js

@@ -15,3 +15,38 @@
 export function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+/**
+ * `value` as a `Record<string, unknown>` when it is a non-null, non-array
+ * object, else null.
+ */
+export function asRecordOrNull(value) {
+    return isRecord(value) ? value : null;
+}
+/** Alias of {@link asRecordOrNull} for call sites that spell it `asRecord`. */
+export const asRecord = asRecordOrNull;
+/**
+ * `value` as a `Record<string, unknown>`, falling back to an empty object.
+ * Deliberately masks "absent" and "present but wrong shape" the same way its
+ * call sites always have — use {@link asRecordOrNull} when that matters.
+ */
+export function asRecordOrEmpty(value) {
+    return isRecord(value) ? value : {};
+}
+/** Finite number, else null. Does not parse numeric strings. */
+export function readFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+/** Trimmed non-empty string, else null. */
+export function readTrimmedString(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+/**
+ * Trimmed non-empty string, else null — additionally coercing a number to its
+ * string form. Distinct from {@link readTrimmedString}, which rejects numbers.
+ */
+export function readCoercedString(value) {
+    if (typeof value !== "string" && typeof value !== "number")
+        return null;
+    const trimmed = String(value).trim();
+    return trimmed ? trimmed : null;
+}

package/node_modules/@oxygen/shared/dist/value-readers.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Canonical readers that coerce an `unknown` value (or a field of an untyped
+ * record) into a string/number, used across every OXYGEN package.
+ */
+/** Trimmed non-empty string, else null. */
+export declare function readString(value: unknown): string | null;
+/** The first key in `keys` whose value is a non-empty string, trimmed. */
+export declare function readFirstString(source: Record<string, unknown>, keys: string[]): string | null;
+/** The first key in `keys` on `record` holding a non-empty string, trimmed. */
+export declare function readStringField(record: Record<string, unknown>, keys: string[]): string | null;
+/** Walk a dot-separated path through nested records; undefined when it breaks. */
+export declare function readByPath(value: unknown, path: string): unknown;
+/** Trimmed non-empty string, else null. */
+export declare function readStringValue(value: unknown): string | null;
+/**
+ * Non-empty string returned VERBATIM: emptiness is tested on the trimmed form
+ * but the original value is returned, so stored values keep their whitespace.
+ */
+export declare function readStringValueUntrimmed(value: unknown): string | null;
+/** Finite number, else null. Does not parse numeric strings. */
+export declare function readNumberValue(value: unknown): number | null;

package/node_modules/@oxygen/shared/dist/value-readers.js

@@ -0,0 +1,59 @@
+/**
+ * Canonical readers that coerce an `unknown` value (or a field of an untyped
+ * record) into a string/number, used across every OXYGEN package.
+ */
+import { isRecord } from "./type-guards.js";
+/** Trimmed non-empty string, else null. */
+export function readString(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+/** The first key in `keys` whose value is a non-empty string, trimmed. */
+export function readFirstString(source, keys) {
+    for (const key of keys) {
+        const value = source[key];
+        if (typeof value !== "string")
+            continue;
+        const trimmed = value.trim();
+        if (trimmed)
+            return trimmed;
+    }
+    return null;
+}
+/** The first key in `keys` on `record` holding a non-empty string, trimmed. */
+export function readStringField(record, keys) {
+    for (const key of keys) {
+        const value = record[key];
+        if (typeof value === "string" && value.trim())
+            return value.trim();
+    }
+    return null;
+}
+/** Walk a dot-separated path through nested records; undefined when it breaks. */
+export function readByPath(value, path) {
+    if (!path)
+        return value;
+    let current = value;
+    for (const segment of path.split(".")) {
+        if (!segment)
+            continue;
+        if (!isRecord(current))
+            return undefined;
+        current = current[segment];
+    }
+    return current;
+}
+/** Trimmed non-empty string, else null. */
+export function readStringValue(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+/**
+ * Non-empty string returned VERBATIM: emptiness is tested on the trimmed form
+ * but the original value is returned, so stored values keep their whitespace.
+ */
+export function readStringValueUntrimmed(value) {
+    return typeof value === "string" && value.trim() ? value : null;
+}
+/** Finite number, else null. Does not parse numeric strings. */
+export function readNumberValue(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}

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

@@ -1,6 +1,6 @@
 // Release metadata is a string API: a new version must not change the exported
 // declaration type and invalidate every dependent package's compiler state.
-export const OXYGEN_VERSION = "1.982.3";
+export const OXYGEN_VERSION = "1.1003.12";
 // 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/shared/package.json

@@ -96,6 +96,16 @@
       "import": "./dist/person-name.js",
       "default": "./dist/person-name.js"
     },
+    "./linkedin-countries": {
+      "types": "./dist/linkedin-countries.d.ts",
+      "import": "./dist/linkedin-countries.js",
+      "default": "./dist/linkedin-countries.js"
+    },
+    "./freemail-domains": {
+      "types": "./dist/freemail-domains.d.ts",
+      "import": "./dist/freemail-domains.js",
+      "default": "./dist/freemail-domains.js"
+    },
     "./select-options": {
       "types": "./dist/select-options.d.ts",
       "import": "./dist/select-options.js",
@@ -121,6 +131,21 @@
       "import": "./dist/cli-result.js",
       "default": "./dist/cli-result.js"
     },
+    "./type-guards": {
+      "types": "./dist/type-guards.d.ts",
+      "import": "./dist/type-guards.js",
+      "default": "./dist/type-guards.js"
+    },
+    "./value-readers": {
+      "types": "./dist/value-readers.d.ts",
+      "import": "./dist/value-readers.js",
+      "default": "./dist/value-readers.js"
+    },
+    "./timing": {
+      "types": "./dist/timing.d.ts",
+      "import": "./dist/timing.js",
+      "default": "./dist/timing.js"
+    },
     "./custom-http-safety": {
       "types": "./dist/custom-http-safety.d.ts",
       "import": "./dist/custom-http-safety.js",
@@ -176,6 +201,16 @@
       "import": "./dist/copilot-journeys.js",
       "default": "./dist/copilot-journeys.js"
     },
+    "./copilot-playbooks": {
+      "types": "./dist/copilot-playbooks.d.ts",
+      "import": "./dist/copilot-playbooks.js",
+      "default": "./dist/copilot-playbooks.js"
+    },
+    "./copilot-skills": {
+      "types": "./dist/copilot-skills.d.ts",
+      "import": "./dist/copilot-skills.js",
+      "default": "./dist/copilot-skills.js"
+    },
     "./hosted-ai": {
       "types": "./dist/hosted-ai.d.ts",
       "import": "./dist/hosted-ai.js",
@@ -215,6 +250,31 @@
       "types": "./dist/workspace-file-storage.d.ts",
       "import": "./dist/workspace-file-storage.js",
       "default": "./dist/workspace-file-storage.js"
+    },
+    "./company-enrichment-fields": {
+      "types": "./dist/company-enrichment-fields.d.ts",
+      "import": "./dist/company-enrichment-fields.js",
+      "default": "./dist/company-enrichment-fields.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
+    },
+    "./enrichment-intents": {
+      "types": "./dist/enrichment-intents.d.ts",
+      "import": "./dist/enrichment-intents.js",
+      "default": "./dist/enrichment-intents.js"
+    },
+    "./log": {
+      "types": "./dist/log.d.ts",
+      "import": "./dist/log.js",
+      "default": "./dist/log.js"
+    },
+    "./linkedin-sequences": {
+      "types": "./dist/linkedin-sequences.d.ts",
+      "import": "./dist/linkedin-sequences.js",
+      "default": "./dist/linkedin-sequences.js"
     }
   },
   "dependencies": {}

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

@@ -13,7 +13,7 @@
 //   - Reading is prototype-safe. Path segments are matched against own properties
 //     only, and the segments that reach JavaScript object internals
 //     (__proto__ / constructor / prototype) are rejected outright.
-import { analyzeFormulaDependencies, evaluateFormulaInScope, formulaExpressionError, } from "@oxygen/formula";
+import { analyzeFormulaDependencies, evaluateFormulaInScope, formulaExpressionError, isRecord, } from "@oxygen/formula";
 /** A deterministic authoring/data error; retrying the same revision cannot repair it. */
 export class WorkflowValueCoercionError extends Error {
     coercion;
@@ -587,7 +587,7 @@ function lookupFormulaIdentifier(scope, identifier) {
     if (BLOCKED_PATH_SEGMENTS.has(identifier))
         return { found: false };
     const input = scope.trigger?.input;
-    if (isPlainObject(input) && Object.prototype.hasOwnProperty.call(input, identifier)) {
+    if (isRecord(input) && Object.prototype.hasOwnProperty.call(input, identifier)) {
         return { found: true, value: input[identifier] };
     }
     const node = readSegment(scope.steps, identifier);
@@ -627,9 +627,6 @@ function isCoalescibleWorkflowFormulaPath(scope, identifier) {
     }
     return false;
 }
-function isPlainObject(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 // ---------------------------------------------------------------------------
 // Conditions
 // ---------------------------------------------------------------------------

package/node_modules/@oxygen/workflows/dist/graph/manifest-schema.d.ts

@@ -22,11 +22,10 @@ export declare const workflowCodeV1Schema: {
             readonly type: "object";
             readonly maxProperties: 100;
             readonly additionalProperties: {
+                readonly type: "object";
+                readonly required: readonly ["type"];
                 readonly description: "One explicit oxygen-js-v1 input binding. Knowledge context refs are excluded in Code v1; bind trigger, step, loop, literal, template, or formula data explicitly.";
                 readonly properties: {
-                    readonly type: {
-                        readonly enum: readonly ["literal", "template", "ref", "formula"];
-                    };
                     readonly value: {
                         readonly description: "literal: used verbatim. template: interpolated string, e.g. 'Hi {{ steps.find.output.first_name }}'.";
                     };
@@ -46,9 +45,10 @@ export declare const workflowCodeV1Schema: {
                         readonly type: "string";
                         readonly description: "context_asset: the Knowledge-layer asset id.";
                     };
+                    readonly type: {
+                        readonly enum: readonly ["literal", "template", "ref", "formula"];
+                    };
                 };
-                readonly type: "object";
-                readonly required: readonly ["type"];
             };
             readonly default: {};
         };
@@ -680,11 +680,10 @@ export declare const workflowGraphManifestSchema: {
                                 readonly type: "object";
                                 readonly maxProperties: 100;
                                 readonly additionalProperties: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["type"];
                                     readonly description: "One explicit oxygen-js-v1 input binding. Knowledge context refs are excluded in Code v1; bind trigger, step, loop, literal, template, or formula data explicitly.";
                                     readonly properties: {
-                                        readonly type: {
-                                            readonly enum: readonly ["literal", "template", "ref", "formula"];
-                                        };
                                         readonly value: {
                                             readonly description: "literal: used verbatim. template: interpolated string, e.g. 'Hi {{ steps.find.output.first_name }}'.";
                                         };
@@ -704,9 +703,10 @@ export declare const workflowGraphManifestSchema: {
                                             readonly type: "string";
                                             readonly description: "context_asset: the Knowledge-layer asset id.";
                                         };
+                                        readonly type: {
+                                            readonly enum: readonly ["literal", "template", "ref", "formula"];
+                                        };
                                     };
-                                    readonly type: "object";
-                                    readonly required: readonly ["type"];
                                 };
                                 readonly default: {};
                             };
@@ -1470,11 +1470,10 @@ export declare const portableWorkflowDefinitionSchema: {
                                         readonly type: "object";
                                         readonly maxProperties: 100;
                                         readonly additionalProperties: {
+                                            readonly type: "object";
+                                            readonly required: readonly ["type"];
                                             readonly description: "One explicit oxygen-js-v1 input binding. Knowledge context refs are excluded in Code v1; bind trigger, step, loop, literal, template, or formula data explicitly.";
                                             readonly properties: {
-                                                readonly type: {
-                                                    readonly enum: readonly ["literal", "template", "ref", "formula"];
-                                                };
                                                 readonly value: {
                                                     readonly description: "literal: used verbatim. template: interpolated string, e.g. 'Hi {{ steps.find.output.first_name }}'.";
                                                 };
@@ -1494,9 +1493,10 @@ export declare const portableWorkflowDefinitionSchema: {
                                                     readonly type: "string";
                                                     readonly description: "context_asset: the Knowledge-layer asset id.";
                                                 };
+                                                readonly type: {
+                                                    readonly enum: readonly ["literal", "template", "ref", "formula"];
+                                                };
                                             };
-                                            readonly type: "object";
-                                            readonly required: readonly ["type"];
                                         };
                                         readonly default: {};
                                     };

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

@@ -28,7 +28,7 @@ export const ANY_OF_REQUIREMENTS = {
  * Empty means ready.
  */
 export function missingToolParams(input) {
-    const { toolId, fields, params, closed } = input;
+    const { toolId, fields, params } = input;
     const label = (name) => fields.find((field) => field.name === name)?.title ?? name;
     // An unknown key suppresses the missing-required report, because a misspelled
     // name is simultaneously an unknown key AND the reason a required field looks

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxygen-agent/cli",
-  "version": "1.982.3",
+  "version": "1.1003.12",
   "private": false,
   "license": "UNLICENSED",
   "type": "module",
@@ -32,24 +32,27 @@
     "README.md"
   ],
   "dependencies": {
-    "@aws-sdk/client-s3": "3.1050.0",
+    "@aws-sdk/client-s3": "3.1136.0",
     "@aws-sdk/s3-request-presigner": "3.1050.0",
     "@langfuse/core": "^5.11.0",
     "@langfuse/otel": "^5.11.0",
     "@langfuse/tracing": "^5.11.0",
     "@opentelemetry/api": "1.9.1",
+    "@opentelemetry/resources": "2.10.0",
     "@opentelemetry/sdk-trace-base": "2.10.0",
     "commander": "14.0.3",
     "esbuild": "0.27.7",
     "read-excel-file": "6.0.3",
-    "typescript": "6.0.3",
+    "typescript": "npm:@typescript/typescript6@6.0.2",
     "yaml": "2.9.0",
+    "@oxygen/cli-ugc": "0.0.0",
     "@oxygen/formula": "0.0.0",
     "@oxygen/recipe-sdk": "0.0.0",
     "@oxygen/shared": "0.0.0",
     "@oxygen/workflows": "0.0.0"
   },
   "bundledDependencies": [
+    "@oxygen/cli-ugc",
     "@oxygen/formula",
     "@oxygen/recipe-sdk",
     "@oxygen/shared",