@x12i/graphenix-executable-format 1.0.0

package/dist/types/execution-trace.d.ts

@@ -0,0 +1,278 @@
+import type { AiModelSelection, AiModelSlot, ModelFallbackTrigger } from "./model-config.js";
+import type { ExecutionUnitKind } from "./execution-unit.js";
+export declare const EXECUTION_TRACE_FORMAT: "x12i.graphenix.execution-trace/v1";
+export type GraphExecutionStatus = "queued" | "running" | "completed" | "failed" | "cancelled" | "partial";
+export interface DataRef {
+    uri?: string;
+    hash?: string;
+    contentType?: string;
+}
+export interface TraceError {
+    code?: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface SchemaValidationResult {
+    valid: boolean;
+    errors?: Array<{
+        path: string;
+        message: string;
+    }>;
+}
+export interface BaseTraceEvent {
+    id: string;
+    ts: string;
+    level: "debug" | "info" | "warn" | "error";
+    type: string;
+    nodeId?: string;
+    unitId?: string;
+    stepId?: string;
+    message?: string;
+    evidence?: Record<string, unknown>;
+    assumptions?: string[];
+}
+export interface GraphStartedEvent extends BaseTraceEvent {
+    type: "graph.started";
+}
+export interface GraphCompletedEvent extends BaseTraceEvent {
+    type: "graph.completed";
+}
+export interface GraphFailedEvent extends BaseTraceEvent {
+    type: "graph.failed";
+}
+export interface NodeStartedEvent extends BaseTraceEvent {
+    type: "node.started";
+    nodeId: string;
+}
+export interface NodeCompletedEvent extends BaseTraceEvent {
+    type: "node.completed";
+    nodeId: string;
+}
+export interface NodeFailedEvent extends BaseTraceEvent {
+    type: "node.failed";
+    nodeId: string;
+}
+export interface ModelSlotResolvedEvent extends BaseTraceEvent {
+    type: "model.slot.resolved";
+    nodeId: string;
+}
+export interface ModelInvocationStartedEvent extends BaseTraceEvent {
+    type: "model.invocation.started";
+    nodeId: string;
+}
+export interface ModelInvocationCompletedEvent extends BaseTraceEvent {
+    type: "model.invocation.completed";
+    nodeId: string;
+}
+export interface ModelInvocationFailedEvent extends BaseTraceEvent {
+    type: "model.invocation.failed";
+    nodeId: string;
+}
+export interface ModelFallbackAppliedEvent extends BaseTraceEvent {
+    type: "model.fallback.applied";
+    nodeId: string;
+}
+export interface ValidationFailedEvent extends BaseTraceEvent {
+    type: "validation.failed";
+}
+export interface WarningEvent extends BaseTraceEvent {
+    type: "warning";
+}
+export interface ExecutionUnitStartedEvent extends BaseTraceEvent {
+    type: "executionUnit.started";
+    nodeId: string;
+    unitId: string;
+}
+export interface ExecutionUnitCompletedEvent extends BaseTraceEvent {
+    type: "executionUnit.completed";
+    nodeId: string;
+    unitId: string;
+}
+export interface ExecutionUnitFailedEvent extends BaseTraceEvent {
+    type: "executionUnit.failed";
+    nodeId: string;
+    unitId: string;
+}
+export interface ExecutionUnitSkippedEvent extends BaseTraceEvent {
+    type: "executionUnit.skipped";
+    nodeId: string;
+    unitId: string;
+}
+export interface ExecutionUnitModelResolvedEvent extends BaseTraceEvent {
+    type: "executionUnit.model.resolved";
+    nodeId: string;
+    unitId: string;
+}
+export interface ExecutionUnitModelFallbackAppliedEvent extends BaseTraceEvent {
+    type: "executionUnit.model.fallbackApplied";
+    nodeId: string;
+    unitId: string;
+}
+export interface ExecutionUnitValidationFailedEvent extends BaseTraceEvent {
+    type: "executionUnit.validation.failed";
+    nodeId: string;
+    unitId: string;
+}
+export type GraphExecutionEvent = GraphStartedEvent | GraphCompletedEvent | GraphFailedEvent | NodeStartedEvent | NodeCompletedEvent | NodeFailedEvent | ModelSlotResolvedEvent | ModelInvocationStartedEvent | ModelInvocationCompletedEvent | ModelInvocationFailedEvent | ModelFallbackAppliedEvent | ValidationFailedEvent | WarningEvent | ExecutionUnitStartedEvent | ExecutionUnitCompletedEvent | ExecutionUnitFailedEvent | ExecutionUnitSkippedEvent | ExecutionUnitModelResolvedEvent | ExecutionUnitModelFallbackAppliedEvent | ExecutionUnitValidationFailedEvent;
+export interface ModelInvocationAttempt {
+    attempt: number;
+    startedAt: string;
+    completedAt?: string;
+    status: "completed" | "failed" | "cancelled";
+    provider: string;
+    modelId: string;
+    requestRef?: DataRef;
+    responseRef?: DataRef;
+    error?: TraceError;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+    };
+    cost?: {
+        costUsd?: number;
+        costStatus?: "known" | "estimated" | "unknown";
+    };
+}
+export interface ModelSlotExecutionTrace {
+    slot: AiModelSlot;
+    plannedSelection: AiModelSelection;
+    resolvedInvocation?: {
+        provider: string;
+        modelId: string;
+        profileChoiceKey?: string;
+        profile?: string;
+        choice?: string;
+        registryVersion?: string;
+        catalogVersion?: string;
+    };
+    source: "graphDefault" | "nodeOverride" | "nodeCaseOverride" | "fallbackToGraphDefault";
+    fallback?: {
+        applied: boolean;
+        trigger?: ModelFallbackTrigger;
+        from?: AiModelSelection;
+        to?: AiModelSelection;
+        reason?: string;
+    };
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+    };
+    cost?: {
+        costUsd?: number;
+        costStatus?: "known" | "estimated" | "unknown";
+    };
+    attempts?: ModelInvocationAttempt[];
+}
+export interface ExecutionUnitTrace {
+    unitId: string;
+    nodeId: string;
+    unitKind: ExecutionUnitKind;
+    status: "pending" | "running" | "completed" | "failed" | "skipped";
+    startedAt?: string;
+    completedAt?: string;
+    durationMs?: number;
+    plannedModelSelection?: AiModelSelection;
+    resolvedInvocation?: {
+        provider: string;
+        modelId: string;
+        profileChoiceKey?: string;
+        profile?: string;
+        choice?: string;
+        registryVersion?: string;
+        catalogVersion?: string;
+    };
+    input?: {
+        valueRef?: DataRef;
+        preview?: unknown;
+        hash?: string;
+    };
+    output?: {
+        valueRef?: DataRef;
+        preview?: unknown;
+        hash?: string;
+    };
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+    };
+    cost?: {
+        costUsd?: number;
+        costStatus?: "known" | "estimated" | "unknown";
+    };
+    fallback?: {
+        applied: boolean;
+        trigger?: ModelFallbackTrigger;
+        from?: AiModelSelection;
+        to?: AiModelSelection;
+        reason?: string;
+    };
+    error?: TraceError;
+}
+export interface NodeExecutionTrace {
+    nodeId: string;
+    nodeType: "task" | "finalizer";
+    status: "pending" | "running" | "completed" | "failed" | "skipped";
+    startedAt?: string;
+    completedAt?: string;
+    durationMs?: number;
+    selectedCases?: {
+        graphCaseId: string;
+        nodeCaseId?: string;
+    };
+    units: Record<string, ExecutionUnitTrace>;
+    /** @deprecated Use units for unit-level model execution data. */
+    modelSlots?: Record<AiModelSlot, ModelSlotExecutionTrace>;
+    input?: {
+        valueRef?: DataRef;
+        preview?: unknown;
+        hash?: string;
+    };
+    output?: {
+        valueRef?: DataRef;
+        preview?: unknown;
+        hash?: string;
+    };
+    error?: TraceError;
+}
+export interface GraphExecutionTrace {
+    format: typeof EXECUTION_TRACE_FORMAT;
+    traceId: string;
+    jobId: string;
+    createdAt: string;
+    completedAt?: string;
+    status: GraphExecutionStatus;
+    source: {
+        graphId: string;
+        graphRevision?: string;
+        graphHash: string;
+    };
+    plan: {
+        planId: string;
+        planHash: string;
+    };
+    runtime: {
+        mode?: "simulate" | "live" | "plan";
+        environment?: string;
+        inputRef?: DataRef;
+        inputHash?: string;
+    };
+    events: GraphExecutionEvent[];
+    nodeExecutions: Record<string, NodeExecutionTrace>;
+    finalOutput?: {
+        valueRef?: DataRef;
+        valuePreview?: unknown;
+        schemaValidation?: SchemaValidationResult;
+    };
+    totals?: {
+        durationMs?: number;
+        inputTokens?: number;
+        outputTokens?: number;
+        costUsd?: number;
+        warnings?: number;
+        errors?: number;
+    };
+}
+//# sourceMappingURL=execution-trace.d.ts.map

package/dist/types/execution-trace.d.ts.map

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

package/dist/types/execution-trace.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXECUTION_TRACE_FORMAT = void 0;
+exports.EXECUTION_TRACE_FORMAT = "x12i.graphenix.execution-trace/v1";
+//# sourceMappingURL=execution-trace.js.map

package/dist/types/execution-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-trace.js","sourceRoot":"","sources":["../../src/types/execution-trace.ts"],"names":[],"mappings":";;;AAOa,QAAA,sBAAsB,GAAG,mCAA4C,CAAC"}

package/dist/types/execution-unit.d.ts

@@ -0,0 +1,19 @@
+import type { AiModelSelection, AiModelSlot } from "./model-config.js";
+export type ExecutionUnitKind = "preAction" | "skill" | "postAction" | "finalizer";
+export type ExecutionUnitModelSource = "graphDefault" | "graphCase" | "nodeOverride" | "nodeCaseOverride" | "actionOverride" | "fallbackToGraphDefault";
+export interface ExecutionUnitPlan {
+    unitId: string;
+    nodeId: string;
+    unitKind: ExecutionUnitKind;
+    order: number;
+    actionKey?: string;
+    skillKey?: string;
+    modelSlot?: AiModelSlot;
+    modelSelection?: AiModelSelection;
+    modelSource?: ExecutionUnitModelSource;
+    inherited?: boolean;
+    config?: Record<string, unknown>;
+    inputsConfig?: Record<string, unknown>;
+    outputMapping?: Record<string, unknown>;
+}
+//# sourceMappingURL=execution-unit.d.ts.map

package/dist/types/execution-unit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-unit.d.ts","sourceRoot":"","sources":["../../src/types/execution-unit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEvE,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,OAAO,GACP,YAAY,GACZ,WAAW,CAAC;AAEhB,MAAM,MAAM,wBAAwB,GAChC,cAAc,GACd,WAAW,GACX,cAAc,GACd,kBAAkB,GAClB,gBAAgB,GAChB,wBAAwB,CAAC;AAE7B,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC"}

package/dist/types/execution-unit.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=execution-unit.js.map

package/dist/types/execution-unit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-unit.js","sourceRoot":"","sources":["../../src/types/execution-unit.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,16 @@
+export type { ExecutableGraphDocument, ExecutableGraphMetadata, AuthoringGraphDocument, AuthoringExecutableGraphDocument, NormalizedExecutableGraphDocument } from "./executable-graph.js";
+export type { ExecutableGraphPlan, ExecutableGraphPlanSource, ExecutableGraphPlanProfileRegistry, ExecutableGraphPlanRuntimeBinding, SelectedCase, ResolvedModelSlotPlan, ResolvedNodeExecutionPlan, CompileExecutablePlanOptions, AiProfilesRegistry, HashFunction } from "./executable-plan.js";
+export { EXECUTABLE_PLAN_FORMAT } from "./executable-plan.js";
+export type { GraphExecutionTrace, GraphExecutionEvent, GraphExecutionStatus, BaseTraceEvent, GraphStartedEvent, GraphCompletedEvent, GraphFailedEvent, NodeStartedEvent, NodeCompletedEvent, NodeFailedEvent, ModelSlotResolvedEvent, ModelInvocationStartedEvent, ModelInvocationCompletedEvent, ModelInvocationFailedEvent, ModelFallbackAppliedEvent, ValidationFailedEvent, WarningEvent, ExecutionUnitTrace, ExecutionUnitStartedEvent, ExecutionUnitCompletedEvent, ExecutionUnitFailedEvent, ExecutionUnitSkippedEvent, ExecutionUnitModelResolvedEvent, ExecutionUnitModelFallbackAppliedEvent, ExecutionUnitValidationFailedEvent, NodeExecutionTrace, ModelSlotExecutionTrace, ModelInvocationAttempt, DataRef, TraceError, SchemaValidationResult } from "./execution-trace.js";
+export { EXECUTION_TRACE_FORMAT } from "./execution-trace.js";
+export type { ExecutionUnitKind, ExecutionUnitModelSource, ExecutionUnitPlan } from "./execution-unit.js";
+export type { ExecutableGraphProfile, ExecutableGraphPolicies } from "./executable-profile.js";
+export type { ExecutableTaskNode, ExecutableFinalizerNode, ExecutableNodeParameters, ExecutableTaskNodeParameters, ExecutableFinalizerNodeParameters, AuthoringTaskConfiguration, AuthoringActionConfig, ExecutableTaskConfiguration, NodeRetryPolicy, AddTaskNodeInput, AddFinalizerNodeInput } from "./executable-nodes.js";
+export type { GraphModelConfig, AuthoringGraphModelConfig, NormalizedGraphModelConfig, GraphModelConfigCase, GraphModelFallbackPolicy, NodeModelConfig, AuthoringNodeModelConfig, NodeModelConfigCase, RequiredAiModelTriplet, PartialAiModelTriplet, AiModelSelection, AiProfileChoiceModelSelection, AiProfileModelSelection, AiConcreteModelSelection, AiModelParams, AiModelSlot, ModelFallbackTrigger } from "./model-config.js";
+export type { CaseCondition, CaseAllCondition, CaseAnyCondition, CaseNotCondition, CasePredicateCondition, CasePredicateOperator, DeterministicCaseContext, CaseConditionValidationOptions, SelectedGraphModelCase, SelectedNodeModelCase } from "./case-condition.js";
+export type { GraphRuntimeObject, GraphRuntimeMode, RunLogMode } from "./runtime.js";
+export type { StudioGraphExecuteRequest, GraphExecutionRequest } from "./studio-execute.js";
+export type { ResolvedNodeAiPlan, ResolvedAiModelSlot, ResolveNodeModelSlotArgs, AiModelAvailabilityResult } from "./resolution.js";
+export type { ExecutableGraphErrorCode, ExecutableGraphValidationError, ExecutableGraphValidationResult, GraphValidationResult } from "./errors.js";
+export type { LegacyGraphModelObject } from "./legacy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,mBAAmB,EACnB,yBAAyB,EACzB,kCAAkC,EAClC,iCAAiC,EACjC,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,EACzB,4BAA4B,EAC5B,kBAAkB,EAClB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,2BAA2B,EAC3B,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,+BAA+B,EAC/B,sCAAsC,EACtC,kCAAkC,EAClC,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,OAAO,EACP,UAAU,EACV,sBAAsB,EACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EACV,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,EAC5B,iCAAiC,EACjC,0BAA0B,EAC1B,qBAAqB,EACrB,2BAA2B,EAC3B,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,gBAAgB,EAChB,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,6BAA6B,EAC7B,uBAAuB,EACvB,wBAAwB,EACxB,aAAa,EACb,WAAW,EACX,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,8BAA8B,EAC9B,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACX,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXECUTION_TRACE_FORMAT = exports.EXECUTABLE_PLAN_FORMAT = void 0;
+var executable_plan_js_1 = require("./executable-plan.js");
+Object.defineProperty(exports, "EXECUTABLE_PLAN_FORMAT", { enumerable: true, get: function () { return executable_plan_js_1.EXECUTABLE_PLAN_FORMAT; } });
+var execution_trace_js_1 = require("./execution-trace.js");
+Object.defineProperty(exports, "EXECUTION_TRACE_FORMAT", { enumerable: true, get: function () { return execution_trace_js_1.EXECUTION_TRACE_FORMAT; } });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;AAmBA,2DAA8D;AAArD,4HAAA,sBAAsB,OAAA;AAkC/B,2DAA8D;AAArD,4HAAA,sBAAsB,OAAA"}

package/dist/types/legacy.d.ts

@@ -0,0 +1,21 @@
+export interface LegacyGraphModelObject {
+    id?: string;
+    version?: string;
+    name?: string;
+    nodes?: unknown[];
+    edges?: unknown[];
+    modelConfig?: unknown;
+    variables?: Record<string, unknown>;
+    jobKnowledge?: Record<string, unknown>;
+    response?: {
+        shape?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+    metadata?: {
+        graphEntry?: Record<string, unknown>;
+        graphResponse?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+//# sourceMappingURL=legacy.d.ts.map

package/dist/types/legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.d.ts","sourceRoot":"","sources":["../../src/types/legacy.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/types/legacy.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=legacy.js.map

package/dist/types/legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.js","sourceRoot":"","sources":["../../src/types/legacy.ts"],"names":[],"mappings":""}

package/dist/types/model-config.d.ts

@@ -0,0 +1,80 @@
+import type { CaseCondition } from "./case-condition.js";
+export type AiModelSlot = "preActionModel" | "skillModel" | "postActionModel";
+export type ModelFallbackTrigger = "nodeSlotMissing" | "nodeModelInvalid" | "nodeModelUnavailable" | "nodeModelUnsupported" | "nodeProviderNotConfigured" | "nodeModelRateLimited" | "nodeModelTransientFailure";
+export interface AiModelParams {
+    temperature?: number;
+    maxTokens?: number;
+    reasoningEffort?: "none" | "low" | "medium" | "high";
+    timeoutMs?: number;
+}
+/** @deprecated Use AiProfileChoiceModelSelection with kind "profileChoice". */
+export interface AiProfileModelSelection {
+    kind: "profile";
+    profile: string;
+    choice?: string;
+    params?: AiModelParams;
+}
+export interface AiProfileChoiceModelSelection {
+    kind: "profileChoice";
+    key: string;
+    params?: AiModelParams;
+}
+export interface AiConcreteModelSelection {
+    kind: "model";
+    provider: string;
+    modelId: string;
+    /** @deprecated Use modelId. Accepted during validation for backward compatibility. */
+    model?: string;
+    params?: AiModelParams;
+}
+export type AiModelSelection = AiProfileChoiceModelSelection | AiConcreteModelSelection | AiProfileModelSelection;
+export interface RequiredAiModelTriplet {
+    preActionModel: AiModelSelection;
+    skillModel: AiModelSelection;
+    postActionModel: AiModelSelection;
+}
+export interface PartialAiModelTriplet {
+    preActionModel?: AiModelSelection;
+    skillModel?: AiModelSelection;
+    postActionModel?: AiModelSelection;
+}
+export interface GraphModelConfigCase {
+    id: string;
+    when?: CaseCondition;
+    modelConfig: RequiredAiModelTriplet;
+    description?: string;
+}
+export interface GraphModelFallbackPolicy {
+    enabled: boolean;
+    slots?: AiModelSlot[];
+    allowedTriggers: ModelFallbackTrigger[];
+    maxAttemptsPerSlot?: number;
+}
+export interface NormalizedGraphModelConfig {
+    version: "graph-model-config/v1";
+    cases: GraphModelConfigCase[];
+    fallbackPolicy?: GraphModelFallbackPolicy;
+}
+/** Authoring form may use `default` shorthand instead of `cases`. */
+export interface AuthoringGraphModelConfig {
+    version: "graph-model-config/v1";
+    default?: RequiredAiModelTriplet;
+    cases?: GraphModelConfigCase[];
+    fallbackPolicy?: GraphModelFallbackPolicy;
+}
+export type GraphModelConfig = NormalizedGraphModelConfig;
+export interface NodeModelConfigCase {
+    id: string;
+    when?: CaseCondition;
+    modelConfig: PartialAiModelTriplet;
+    description?: string;
+}
+/** Authoring form may use `modelConfig` shorthand instead of `cases`. */
+export interface AuthoringNodeModelConfig {
+    version?: "node-model-config/v1";
+    inherit?: boolean;
+    modelConfig?: PartialAiModelTriplet;
+    cases?: NodeModelConfigCase[];
+}
+export type NodeModelConfig = AuthoringNodeModelConfig;
+//# sourceMappingURL=model-config.d.ts.map

package/dist/types/model-config.d.ts.map

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

package/dist/types/model-config.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=model-config.js.map

package/dist/types/model-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-config.js","sourceRoot":"","sources":["../../src/types/model-config.ts"],"names":[],"mappings":""}

package/dist/types/resolution.d.ts

@@ -0,0 +1,55 @@
+import type { AiModelSelection, AiModelSlot, GraphModelFallbackPolicy, ModelFallbackTrigger } from "./model-config.js";
+export interface AiModelAvailabilityResult {
+    available: boolean;
+    trigger?: ModelFallbackTrigger;
+    reason?: string;
+}
+export interface ResolveNodeModelSlotArgs {
+    slot: AiModelSlot;
+    graphSelection: AiModelSelection;
+    nodeSelection?: AiModelSelection;
+    fallbackPolicy: GraphModelFallbackPolicy;
+    availabilityResult?: AiModelAvailabilityResult;
+}
+export interface ResolvedAiModelSlot {
+    slot: AiModelSlot;
+    selected: AiModelSelection;
+    source: "graphDefault" | "nodeOverride" | "nodeCaseOverride" | "fallbackToGraphDefault";
+    inherited: boolean;
+    fallback?: {
+        attempted: boolean;
+        from?: AiModelSelection;
+        to: AiModelSelection;
+        trigger: ModelFallbackTrigger;
+        reason?: string;
+    };
+    provenance: {
+        graphPath: string;
+        nodePath?: string;
+        graphCaseId: string;
+        nodeCaseId?: string;
+    };
+}
+export interface ResolvedNodeAiPlan {
+    graphId: string;
+    graphRevision?: string;
+    nodeId: string;
+    graphCaseId: string;
+    nodeCaseId?: string;
+    slots: {
+        preActionModel: ResolvedAiModelSlot;
+        skillModel: ResolvedAiModelSlot;
+        postActionModel: ResolvedAiModelSlot;
+    };
+    caseSelection: {
+        graph: {
+            selectedCaseId: string;
+            matchedConditions: string[];
+        };
+        node?: {
+            selectedCaseId: string;
+            matchedConditions: string[];
+        };
+    };
+}
+//# sourceMappingURL=resolution.d.ts.map

package/dist/types/resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolution.d.ts","sourceRoot":"","sources":["../../src/types/resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,WAAW,CAAC;IAClB,cAAc,EAAE,gBAAgB,CAAC;IACjC,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACjC,cAAc,EAAE,wBAAwB,CAAC;IACzC,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;CAChD;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EACF,cAAc,GACd,cAAc,GACd,kBAAkB,GAClB,wBAAwB,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE;QACT,SAAS,EAAE,OAAO,CAAC;QACnB,IAAI,CAAC,EAAE,gBAAgB,CAAC;QACxB,EAAE,EAAE,gBAAgB,CAAC;QACrB,OAAO,EAAE,oBAAoB,CAAC;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,UAAU,EAAE;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE;QACL,cAAc,EAAE,mBAAmB,CAAC;QACpC,UAAU,EAAE,mBAAmB,CAAC;QAChC,eAAe,EAAE,mBAAmB,CAAC;KACtC,CAAC;IACF,aAAa,EAAE;QACb,KAAK,EAAE;YACL,cAAc,EAAE,MAAM,CAAC;YACvB,iBAAiB,EAAE,MAAM,EAAE,CAAC;SAC7B,CAAC;QACF,IAAI,CAAC,EAAE;YACL,cAAc,EAAE,MAAM,CAAC;YACvB,iBAAiB,EAAE,MAAM,EAAE,CAAC;SAC7B,CAAC;KACH,CAAC;CACH"}

package/dist/types/resolution.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=resolution.js.map

package/dist/types/resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolution.js","sourceRoot":"","sources":["../../src/types/resolution.ts"],"names":[],"mappings":""}

package/dist/types/runtime.d.ts

@@ -0,0 +1,19 @@
+export type GraphRuntimeMode = "simulate" | "live" | "plan";
+export type RunLogMode = "off" | "minimal" | "verbose" | "debug";
+export interface GraphRuntimeObject {
+    jobId: string;
+    job: {
+        id: string;
+        jobId: string;
+        agentId?: string;
+        jobTypeId?: string;
+    };
+    input?: Record<string, unknown>;
+    mode?: GraphRuntimeMode;
+    runLogMode?: RunLogMode;
+    maxRunLogEntries?: number;
+    maxRunLogDataJsonChars?: number;
+    runTaskDiagnostics?: boolean;
+    variables?: Record<string, unknown>;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/types/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/types/runtime.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5D,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE;QACH,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC"}

package/dist/types/runtime.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=runtime.js.map

package/dist/types/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/types/runtime.ts"],"names":[],"mappings":""}

package/dist/types/studio-execute.d.ts

@@ -0,0 +1,25 @@
+import type { AuthoringGraphDocument } from "./executable-graph.js";
+import type { ExecutableGraphPlan } from "./executable-plan.js";
+import type { GraphRuntimeMode, GraphRuntimeObject, RunLogMode } from "./runtime.js";
+export interface StudioGraphExecuteRequest {
+    mode: "graph";
+    jobId: string;
+    graph: AuthoringGraphDocument;
+    runtime?: Partial<GraphRuntimeObject>;
+    graphExecution?: {
+        mode?: GraphRuntimeMode;
+    };
+    runLogMode?: RunLogMode;
+    maxRunLogEntries?: number;
+    maxRunLogDataJsonChars?: number;
+    runTaskDiagnostics?: boolean;
+    studioId?: string;
+    exampleIndex?: number;
+    validateGraphEntrySeed?: boolean;
+    openrouterApiKey?: string;
+}
+export interface GraphExecutionRequest {
+    plan: ExecutableGraphPlan;
+    runtime: GraphRuntimeObject;
+}
+//# sourceMappingURL=studio-execute.d.ts.map

package/dist/types/studio-execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-execute.d.ts","sourceRoot":"","sources":["../../src/types/studio-execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAErF,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,sBAAsB,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE;QACf,IAAI,CAAC,EAAE,gBAAgB,CAAC;KACzB,CAAC;IACF,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,kBAAkB,CAAC;CAC7B"}

package/dist/types/studio-execute.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=studio-execute.js.map

package/dist/types/studio-execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-execute.js","sourceRoot":"","sources":["../../src/types/studio-execute.ts"],"names":[],"mappings":""}