npm - @oxygen-agent/cli - Versions diffs - 1.739.1 → 1.766.0 - Mend

@oxygen-agent/cli 1.739.1 → 1.766.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (51) hide show

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

@@ -34,6 +34,10 @@ export declare const workflowCodeV1Schema: {
                         readonly type: "string";
                         readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                     };
+                    readonly coerce: {
+                        readonly enum: readonly ["string", "number", "integer", "boolean"];
+                        readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                    };
                     readonly expression: {
                         readonly type: "string";
                         readonly description: "formula: an OXYGEN formula-language expression.";
@@ -280,6 +284,10 @@ export declare const workflowGraphManifestSchema: {
                                     readonly type: "string";
                                     readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                 };
+                                readonly coerce: {
+                                    readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                    readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                };
                                 readonly expression: {
                                     readonly type: "string";
                                     readonly description: "formula: an OXYGEN formula-language expression.";
@@ -335,6 +343,10 @@ export declare const workflowGraphManifestSchema: {
                                         readonly type: "string";
                                         readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                     };
+                                    readonly coerce: {
+                                        readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                        readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                    };
                                     readonly expression: {
                                         readonly type: "string";
                                         readonly description: "formula: an OXYGEN formula-language expression.";
@@ -360,6 +372,10 @@ export declare const workflowGraphManifestSchema: {
                                         readonly type: "string";
                                         readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                     };
+                                    readonly coerce: {
+                                        readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                        readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                    };
                                     readonly expression: {
                                         readonly type: "string";
                                         readonly description: "formula: an OXYGEN formula-language expression.";
@@ -420,6 +436,10 @@ export declare const workflowGraphManifestSchema: {
                                                     readonly type: "string";
                                                     readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                                 };
+                                                readonly coerce: {
+                                                    readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                                    readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                                };
                                                 readonly expression: {
                                                     readonly type: "string";
                                                     readonly description: "formula: an OXYGEN formula-language expression.";
@@ -445,6 +465,10 @@ export declare const workflowGraphManifestSchema: {
                                                     readonly type: "string";
                                                     readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                                 };
+                                                readonly coerce: {
+                                                    readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                                    readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                                };
                                                 readonly expression: {
                                                     readonly type: "string";
                                                     readonly description: "formula: an OXYGEN formula-language expression.";
@@ -481,6 +505,10 @@ export declare const workflowGraphManifestSchema: {
                                 readonly type: "string";
                                 readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                             };
+                            readonly coerce: {
+                                readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                            };
                             readonly expression: {
                                 readonly type: "string";
                                 readonly description: "formula: an OXYGEN formula-language expression.";
@@ -531,6 +559,10 @@ export declare const workflowGraphManifestSchema: {
                                             readonly type: "string";
                                             readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                         };
+                                        readonly coerce: {
+                                            readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                            readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                        };
                                         readonly expression: {
                                             readonly type: "string";
                                             readonly description: "formula: an OXYGEN formula-language expression.";
@@ -568,6 +600,10 @@ export declare const workflowGraphManifestSchema: {
                                 readonly type: "string";
                                 readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                             };
+                            readonly coerce: {
+                                readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                            };
                             readonly expression: {
                                 readonly type: "string";
                                 readonly description: "formula: an OXYGEN formula-language expression.";
@@ -605,6 +641,10 @@ export declare const workflowGraphManifestSchema: {
                                     readonly type: "string";
                                     readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                 };
+                                readonly coerce: {
+                                    readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                    readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                };
                                 readonly expression: {
                                     readonly type: "string";
                                     readonly description: "formula: an OXYGEN formula-language expression.";
@@ -652,6 +692,10 @@ export declare const workflowGraphManifestSchema: {
                                             readonly type: "string";
                                             readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                         };
+                                        readonly coerce: {
+                                            readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                            readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                        };
                                         readonly expression: {
                                             readonly type: "string";
                                             readonly description: "formula: an OXYGEN formula-language expression.";
@@ -782,6 +826,10 @@ export declare const workflowGraphManifestSchema: {
                                     readonly type: "string";
                                     readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                 };
+                                readonly coerce: {
+                                    readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                    readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                };
                                 readonly expression: {
                                     readonly type: "string";
                                     readonly description: "formula: an OXYGEN formula-language expression.";
@@ -1026,6 +1074,10 @@ export declare const portableWorkflowDefinitionSchema: {
                                             readonly type: "string";
                                             readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                         };
+                                        readonly coerce: {
+                                            readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                            readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                        };
                                         readonly expression: {
                                             readonly type: "string";
                                             readonly description: "formula: an OXYGEN formula-language expression.";
@@ -1081,6 +1133,10 @@ export declare const portableWorkflowDefinitionSchema: {
                                                 readonly type: "string";
                                                 readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                             };
+                                            readonly coerce: {
+                                                readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                                readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                            };
                                             readonly expression: {
                                                 readonly type: "string";
                                                 readonly description: "formula: an OXYGEN formula-language expression.";
@@ -1106,6 +1162,10 @@ export declare const portableWorkflowDefinitionSchema: {
                                                 readonly type: "string";
                                                 readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                             };
+                                            readonly coerce: {
+                                                readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                                readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                            };
                                             readonly expression: {
                                                 readonly type: "string";
                                                 readonly description: "formula: an OXYGEN formula-language expression.";
@@ -1166,6 +1226,10 @@ export declare const portableWorkflowDefinitionSchema: {
                                                             readonly type: "string";
                                                             readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                                         };
+                                                        readonly coerce: {
+                                                            readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                                            readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                                        };
                                                         readonly expression: {
                                                             readonly type: "string";
                                                             readonly description: "formula: an OXYGEN formula-language expression.";
@@ -1191,6 +1255,10 @@ export declare const portableWorkflowDefinitionSchema: {
                                                             readonly type: "string";
                                                             readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                                         };
+                                                        readonly coerce: {
+                                                            readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                                            readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                                        };
                                                         readonly expression: {
                                                             readonly type: "string";
                                                             readonly description: "formula: an OXYGEN formula-language expression.";
@@ -1227,6 +1295,10 @@ export declare const portableWorkflowDefinitionSchema: {
                                         readonly type: "string";
                                         readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                     };
+                                    readonly coerce: {
+                                        readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                        readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                    };
                                     readonly expression: {
                                         readonly type: "string";
                                         readonly description: "formula: an OXYGEN formula-language expression.";
@@ -1277,6 +1349,10 @@ export declare const portableWorkflowDefinitionSchema: {
                                                     readonly type: "string";
                                                     readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                                 };
+                                                readonly coerce: {
+                                                    readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                                    readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                                };
                                                 readonly expression: {
                                                     readonly type: "string";
                                                     readonly description: "formula: an OXYGEN formula-language expression.";
@@ -1314,6 +1390,10 @@ export declare const portableWorkflowDefinitionSchema: {
                                         readonly type: "string";
                                         readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                     };
+                                    readonly coerce: {
+                                        readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                        readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                    };
                                     readonly expression: {
                                         readonly type: "string";
                                         readonly description: "formula: an OXYGEN formula-language expression.";
@@ -1351,6 +1431,10 @@ export declare const portableWorkflowDefinitionSchema: {
                                             readonly type: "string";
                                             readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                         };
+                                        readonly coerce: {
+                                            readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                            readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                        };
                                         readonly expression: {
                                             readonly type: "string";
                                             readonly description: "formula: an OXYGEN formula-language expression.";
@@ -1398,6 +1482,10 @@ export declare const portableWorkflowDefinitionSchema: {
                                                     readonly type: "string";
                                                     readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                                 };
+                                                readonly coerce: {
+                                                    readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                                    readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                                };
                                                 readonly expression: {
                                                     readonly type: "string";
                                                     readonly description: "formula: an OXYGEN formula-language expression.";
@@ -1528,6 +1616,10 @@ export declare const portableWorkflowDefinitionSchema: {
                                             readonly type: "string";
                                             readonly description: "ref: a scope path. context_*: an optional path inside the context value.";
                                         };
+                                        readonly coerce: {
+                                            readonly enum: readonly ["string", "number", "integer", "boolean"];
+                                            readonly description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.";
+                                        };
                                         readonly expression: {
                                             readonly type: "string";
                                             readonly description: "formula: an OXYGEN formula-language expression.";

package/node_modules/@oxygen/workflows/dist/graph/manifest-schema.js CHANGED Viewed

@@ -20,6 +20,10 @@ const valueRefSchema = {
         },
         value: { description: "literal: used verbatim. template: interpolated string, e.g. 'Hi {{ steps.find.output.first_name }}'." },
         path: { type: "string", description: "ref: a scope path. context_*: an optional path inside the context value." },
+        coerce: {
+            enum: ["string", "number", "integer", "boolean"],
+            description: "ref only: an explicit fail-closed scalar conversion applied after resolving the path.",
+        },
         expression: { type: "string", description: "formula: an OXYGEN formula-language expression." },
         assetId: { type: "string", description: "context_asset: the Knowledge-layer asset id." },
     },

package/node_modules/@oxygen/workflows/dist/graph/mapping.d.ts ADDED Viewed

@@ -0,0 +1,79 @@
+import type { WorkflowValueCoercion } from "./types.js";
+export type WorkflowMappingValueType = "array" | "boolean" | "integer" | "null" | "number" | "object" | "string" | "unknown";
+export type WorkflowMappingFieldSource = "declared" | "observed" | "pinned_sample";
+/** Types stay attached to their evidence instead of being flattened into one claim. */
+export type WorkflowMappingTypeEvidence = Partial<Record<WorkflowMappingFieldSource, WorkflowMappingValueType[]>>;
+export type WorkflowMappingObservation = {
+    /** Workflow-local observations may show a bounded sample; workspace observations never do. */
+    scope: "workflow" | "workspace";
+    runId: string;
+    revisionVersion: number;
+    sourceHash: string | null;
+    /** True when the editor has moved beyond this immutable evidence revision. */
+    stale?: boolean;
+};
+/** One typed, provenance-bearing field offered by the Workflow mapper. */
+export type WorkflowMappingField = {
+    /** Dotted path relative to a trigger input or node output. `[]` marks an array boundary. */
+    path: string;
+    /** Every JSON type this field may carry, including nullability. */
+    types: WorkflowMappingValueType[];
+    /** Per-source type claims, retained so declared/observed drift is visible. */
+    typesBySource?: WorkflowMappingTypeEvidence;
+    /** Independent evidence for the field, ordered by authoring authority. */
+    sources: WorkflowMappingFieldSource[];
+    /** Bounded display text only; the stable mapping stores path, never this value. */
+    sample?: string;
+    /** Which evidence supplied the display-only sample. */
+    sampleSource?: WorkflowMappingFieldSource;
+    /** Exact immutable run evidence behind an observed field. */
+    observedAt?: WorkflowMappingObservation;
+};
+export type WorkflowMappingFieldLimits = {
+    maxDepth: number;
+    maxKeysPerObject: number;
+    maxFields: number;
+};
+export declare const DEFAULT_WORKFLOW_MAPPING_FIELD_LIMITS: WorkflowMappingFieldLimits;
+/** Join one relative mapping path to a rooted executable scope path. */
+export declare function workflowMappingScopePath(base: string, relative: string): string;
+/** Canonical relative mapping path from decoded property segments. */
+export declare function workflowMappingPathFromSegments(segments: readonly string[]): string | null;
+/** True only for the display grammar's unquoted `[]` array marker. */
+export declare function workflowMappingPathHasArrayBoundary(path: string): boolean;
+export declare function workflowMappingValueType(value: unknown): WorkflowMappingValueType;
+/** Human-sized preview; never used to resolve a mapping or build a payload. */
+export declare function workflowMappingSample(value: unknown, maxLength?: number): string | undefined;
+/** Flatten a JSON Schema while retaining types, array boundaries, and pinned examples. */
+export declare function workflowMappingFieldsFromSchema(schema: unknown, options?: {
+    sample?: unknown;
+    /** Explicit samples are pins only when the caller says so. */
+    sampleSource?: WorkflowMappingFieldSource;
+    source?: Extract<WorkflowMappingFieldSource, "declared">;
+    omitRootPaths?: ReadonlySet<string>;
+    limits?: WorkflowMappingFieldLimits;
+}): WorkflowMappingField[];
+/** Describe actual JSON output without retaining more than a bounded display preview. */
+export declare function workflowMappingFieldsFromValue(value: unknown, options?: {
+    includeSamples?: boolean;
+    limits?: WorkflowMappingFieldLimits;
+}): WorkflowMappingField[];
+export declare function mergeWorkflowMappingFields(...groups: ReadonlyArray<readonly WorkflowMappingField[]>): WorkflowMappingField[];
+/** Compatibility adapter for older path-only observations and small fixtures. */
+export declare function workflowMappingFieldsFromPaths(paths: readonly string[], source?: WorkflowMappingFieldSource): WorkflowMappingField[];
+/** Attach immutable run lineage without changing the field's stable path/type contract. */
+export declare function withWorkflowMappingObservation(fields: readonly WorkflowMappingField[], observedAt: WorkflowMappingObservation): WorkflowMappingField[];
+export declare function workflowMappingSourceLabel(source: WorkflowMappingFieldSource): string;
+export declare function workflowMappingObservationLabel(observation: WorkflowMappingObservation): string;
+export type WorkflowMappingCompatibility = {
+    status: "compatible" | "unknown" | "nullable" | "coercible" | "incompatible";
+    sourceLabel: string;
+    targetLabel: string;
+    coercions: WorkflowValueCoercion[];
+};
+/** True when real run evidence contradicts the endpoint's declared type contract. */
+export declare function workflowMappingFieldHasTypeDrift(field: WorkflowMappingField): boolean;
+/** Compact, evidence-specific type copy for picker rows and diagnostics. */
+export declare function workflowMappingTypeEvidenceLabel(field: WorkflowMappingField): string;
+/** Compare one source field with one destination schema field. */
+export declare function workflowMappingCompatibility(sourceTypes: readonly WorkflowMappingValueType[] | undefined, destinationType: string | readonly string[] | undefined, coercion?: WorkflowValueCoercion): WorkflowMappingCompatibility;