@framers/agentos 0.1.69 → 0.1.71

package/dist/orchestration/ir/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/orchestration/ir/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/orchestration/ir/index.js

@@ -0,0 +1,2 @@
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/orchestration/ir/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/orchestration/ir/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/orchestration/ir/types.d.ts

@@ -0,0 +1,540 @@
+/**
+ * @file types.ts
+ * @description Core Intermediate Representation (IR) types for the AgentOS Unified Orchestration Layer.
+ *
+ * All three authoring APIs — AgentGraph (graph-based), workflow (sequential), and mission
+ * (goal-oriented) — compile down to these IR types before execution. Keeping a single shared IR
+ * means the runtime, checkpointing, memory, and diagnostics subsystems only need one implementation.
+ *
+ * Dependency graph (no circular imports):
+ *   primitive enums/constants → condition/executor unions → policy interfaces →
+ *   view interfaces → GraphNode / GraphEdge / GraphState → CompiledExecutionGraph
+ */
+/** Sentinel node-id representing the implicit entry point of every graph. */
+export declare const START: "__START__";
+/** Sentinel node-id representing the implicit exit point of every graph. */
+export declare const END: "__END__";
+/**
+ * Controls how many LLM turns a node may consume per invocation.
+ *
+ * - `single_turn`        — exactly one prompt/response pair; deterministic cost.
+ * - `react_bounded`      — ReAct-style tool-use loop capped by `maxInternalIterations`.
+ * - `planner_controlled` — the orchestrating planner decides when the node is "done".
+ */
+export type NodeExecutionMode = 'single_turn' | 'react_bounded' | 'planner_controlled';
+/**
+ * Broad classification of the side-effects a node may produce.
+ * Used by the runtime for scheduling, parallelism gating, and audit logging.
+ *
+ * - `pure`     — no I/O; can be cached and parallelised freely.
+ * - `read`     — reads external state but does not mutate it.
+ * - `write`    — mutates external state (DB, API, file-system, …).
+ * - `external` — fire-and-forget external call; mutation status unknown.
+ * - `human`    — requires a human in the loop; execution suspends until resolved.
+ */
+export type EffectClass = 'pure' | 'read' | 'write' | 'external' | 'human';
+/**
+ * Cognitive memory trace categories, modelled after the psychological taxonomy used
+ * throughout the AgentOS memory subsystem.
+ *
+ * - `episodic`    — autobiographical events tied to a moment in time.
+ * - `semantic`    — factual / world-knowledge, not time-stamped.
+ * - `procedural`  — how-to knowledge; encoded skills and routines.
+ * - `prospective` — future-oriented intentions ("remember to …").
+ */
+export type MemoryTraceType = 'episodic' | 'semantic' | 'procedural' | 'prospective';
+/**
+ * Visibility scope of a memory trace.
+ *
+ * - `global`       — shared across all agents and all sessions.
+ * - `persona`      — private to this agent identity.
+ * - `session`      — lives only for the lifetime of a single run.
+ * - `conversation` — lives only for the current conversation turn window.
+ */
+export type GraphMemoryScope = 'global' | 'persona' | 'session' | 'conversation';
+/**
+ * How the runtime handles in-flight memory reads/writes relative to concurrent graph branches.
+ *
+ * - `live`       — always reads/writes the latest committed value; no isolation.
+ * - `snapshot`   — reads a point-in-time snapshot taken at graph start; writes are deferred.
+ * - `journaled`  — writes are appended to a journal and replayed atomically at commit.
+ */
+export type MemoryConsistencyMode = 'live' | 'snapshot' | 'journaled';
+/**
+ * A TypeScript function that inspects `GraphState` and returns the id of the next node.
+ * Used with `{ type: 'function' }` conditions so authors can express arbitrary routing logic.
+ */
+export type GraphConditionFn = (state: GraphState) => string;
+/**
+ * A DSL expression string evaluated by the runtime's condition interpreter.
+ * Expressions may reference `state.*` fields using dot-notation.
+ * Example: `"state.scratch.confidence > 0.8 ? 'approve' : 'review'"`
+ */
+export type GraphConditionExpr = string;
+/**
+ * Discriminated union for all routing predicates supported by graph edges.
+ *
+ * - `{ type: 'function' }` — calls a runtime-registered TypeScript function.
+ * - `{ type: 'expression' }` — evaluates a sandboxed DSL string.
+ */
+export type GraphCondition = {
+    type: 'function';
+    fn: GraphConditionFn;
+    description?: string;
+} | {
+    type: 'expression';
+    expr: GraphConditionExpr;
+};
+/**
+ * Describes how the runtime should execute a `GraphNode`.  Each variant maps to a
+ * distinct execution strategy.
+ *
+ * - `gmi`        — General Model Invocation: call an LLM with system instructions.
+ * - `tool`       — Invoke a registered `ITool` by name, optionally with static args.
+ * - `extension`  — Call a method on a registered `IExtension`.
+ * - `human`      — Suspend execution and surface a prompt to a human operator.
+ * - `guardrail`  — Run one or more guardrail checks; route or block on violation.
+ * - `router`     — Pure routing node; evaluates a `GraphCondition` and emits no output.
+ * - `subgraph`   — Delegate to another `CompiledExecutionGraph` with optional field mapping.
+ */
+export type NodeExecutorConfig = {
+    type: 'gmi';
+    /** System-level instructions injected before the user message. */
+    instructions: string;
+    /** Maximum ReAct loop iterations when `executionMode` is `react_bounded`. Defaults to 10. */
+    maxInternalIterations?: number;
+    /** Whether to issue multiple tool calls in a single model turn. */
+    parallelTools?: boolean;
+    /** Sampling temperature forwarded to the LLM provider. */
+    temperature?: number;
+    /** Hard cap on output tokens for this node's completion. */
+    maxTokens?: number;
+} | {
+    type: 'tool';
+    /** Registered tool name as it appears in the tool catalogue. */
+    toolName: string;
+    /** Static arguments merged with runtime-provided arguments before invocation. */
+    args?: Record<string, unknown>;
+} | {
+    type: 'extension';
+    /** Extension identifier as registered in the capability registry. */
+    extensionId: string;
+    /** Name of the extension method to call. */
+    method: string;
+} | {
+    type: 'human';
+    /** Message displayed to the human operator while the graph is suspended. */
+    prompt: string;
+} | {
+    type: 'guardrail';
+    /** Ordered list of guardrail identifiers to evaluate. */
+    guardrailIds: string[];
+    /** Action taken when any guardrail fires. */
+    onViolation: 'block' | 'reroute' | 'warn' | 'sanitize';
+    /** Node id to route to when `onViolation` is `'reroute'`. */
+    rerouteTarget?: string;
+} | {
+    type: 'router';
+    /** Routing predicate; the returned node-id determines the next edge. */
+    condition: GraphCondition;
+} | {
+    type: 'subgraph';
+    /** Id of the `CompiledExecutionGraph` to delegate to. */
+    graphId: string;
+    /** Maps parent `scratch` field paths → child `input` field paths. */
+    inputMapping?: Record<string, string>;
+    /** Maps child `artifacts` field paths → parent `scratch` field paths. */
+    outputMapping?: Record<string, string>;
+};
+/**
+ * Governs automatic retry behaviour for transient node failures.
+ *
+ * @property maxAttempts - Total number of attempts (including the first).
+ * @property backoff     - Wait time growth strategy between attempts.
+ * @property backoffMs   - Base wait duration in milliseconds.
+ * @property retryOn     - Optional allowlist of error codes/names that trigger retry.
+ *                         When absent, all errors are retried up to `maxAttempts`.
+ */
+export interface RetryPolicy {
+    maxAttempts: number;
+    backoff: 'fixed' | 'linear' | 'exponential';
+    backoffMs: number;
+    retryOn?: string[];
+}
+/**
+ * Controls how a node reads from and writes to the agent's memory subsystem.
+ *
+ * @property consistency - Isolation mode applied for all memory I/O in this node.
+ * @property read        - Optional filter applied when loading traces before execution.
+ * @property write       - Optional encoding settings applied when persisting after execution.
+ */
+export interface MemoryPolicy {
+    consistency: MemoryConsistencyMode;
+    read?: {
+        /** Restrict loaded traces to these memory types. */
+        types?: MemoryTraceType[];
+        /** Restrict loaded traces to this scope. */
+        scope?: GraphMemoryScope;
+        /** Maximum number of traces to surface into `GraphState.memory`. */
+        maxTraces?: number;
+        /** Minimum consolidation strength (0–1) for a trace to be returned. */
+        minStrength?: number;
+        /** Free-text semantic query used for vector-similarity retrieval. */
+        semanticQuery?: string;
+    };
+    write?: {
+        /** When true, the runtime auto-encodes node output into a new trace. */
+        autoEncode?: boolean;
+        /** Trace category applied to auto-encoded output. */
+        type?: MemoryTraceType;
+        /** Scope applied to auto-encoded output. */
+        scope?: GraphMemoryScope;
+    };
+}
+/**
+ * Controls dynamic capability discovery performed before or during node execution.
+ *
+ * @property enabled    - Master switch; when false all other fields are ignored.
+ * @property query      - Semantic query forwarded to `CapabilityDiscoveryEngine`.
+ * @property kind       - Restricts discovery to a specific capability kind.
+ * @property maxResults - Maximum number of results injected into the node's context.
+ * @property fallback   - Behaviour when discovery returns no results.
+ *                        `'all'` injects the full capability list; `'error'` aborts the node.
+ */
+export interface DiscoveryPolicy {
+    enabled: boolean;
+    query?: string;
+    kind?: 'tool' | 'skill' | 'extension' | 'any';
+    maxResults?: number;
+    fallback?: 'all' | 'error';
+}
+/**
+ * Configures persona-layer traits injected into the node's prompt context.
+ *
+ * @property traits      - HEXACO-style trait overrides (values in range 0–1).
+ * @property mood        - Override the PAD mood state label for this node.
+ * @property adaptStyle  - Whether to apply learned communication-style preferences.
+ */
+export interface PersonaPolicy {
+    traits?: Record<string, number>;
+    mood?: string;
+    adaptStyle?: boolean;
+}
+/**
+ * Declarative guardrail policy attached to a node or edge.
+ *
+ * @property input        - Guardrail ids evaluated against the node's incoming payload.
+ * @property output       - Guardrail ids evaluated against the node's outgoing payload.
+ * @property onViolation  - Action taken when any guardrail fires.
+ * @property rerouteTarget - Required when `onViolation` is `'reroute'`.
+ */
+export interface GuardrailPolicy {
+    input?: string[];
+    output?: string[];
+    onViolation: 'block' | 'reroute' | 'warn' | 'sanitize';
+    rerouteTarget?: string;
+}
+/**
+ * A read-only snapshot of memory state visible to a node during execution.
+ * Populated by the runtime before the node's executor is called; immutable thereafter.
+ */
+export interface MemoryView {
+    /** Traces retrieved according to the node's `MemoryPolicy.read` configuration. */
+    traces: ReadonlyArray<{
+        traceId: string;
+        type: MemoryTraceType;
+        content: string;
+        /** Consolidation strength in range 0–1; higher = stronger/more salient. */
+        strength: number;
+        scope: GraphMemoryScope;
+        /** Unix epoch milliseconds when the trace was first encoded. */
+        createdAt: number;
+        metadata?: Record<string, unknown>;
+    }>;
+    /** Writes staged during this node's execution, not yet committed to the store. */
+    pendingWrites: ReadonlyArray<{
+        type: MemoryTraceType;
+        content: string;
+        scope: GraphMemoryScope;
+    }>;
+    /** Total number of traces that matched the read filter (before `maxTraces` capping). */
+    totalTracesRead: number;
+    /** Wall-clock time in milliseconds spent on the memory read operation. */
+    readLatencyMs: number;
+}
+/**
+ * Accumulated diagnostic telemetry for an entire graph run.
+ * Appended to `GraphState.diagnostics` after each node completes.
+ */
+export interface DiagnosticsView {
+    /** Cumulative LLM tokens consumed across all `gmi` nodes. */
+    totalTokensUsed: number;
+    /** Wall-clock duration from graph start to the latest completed node. */
+    totalDurationMs: number;
+    /** Per-node timing and token attribution. */
+    nodeTimings: Record<string, {
+        startMs: number;
+        endMs: number;
+        tokensUsed: number;
+    }>;
+    /** Results from each `DiscoveryPolicy`-triggered capability lookup. */
+    discoveryResults: Record<string, {
+        query: string;
+        toolsFound: string[];
+        latencyMs: number;
+    }>;
+    /** Results from each guardrail evaluation. */
+    guardrailResults: Record<string, {
+        guardrailId: string;
+        passed: boolean;
+        action: string;
+        latencyMs: number;
+    }>;
+    /** Number of checkpoint snapshots persisted during the run. */
+    checkpointsSaved: number;
+    /** Number of memory read operations performed. */
+    memoryReads: number;
+    /** Number of memory write operations performed (including pending). */
+    memoryWrites: number;
+}
+/**
+ * A single vertex in the compiled execution graph.
+ *
+ * Nodes are immutable once compiled; all runtime state lives in `GraphState`.
+ */
+export interface GraphNode {
+    /** Unique identifier within the parent `CompiledExecutionGraph`. Must not equal `START` or `END`. */
+    id: string;
+    /** Coarse type label kept in sync with `executorConfig.type` for fast switching. */
+    type: 'gmi' | 'tool' | 'extension' | 'human' | 'guardrail' | 'router' | 'subgraph';
+    /** Full executor configuration; discriminated union determines runtime strategy. */
+    executorConfig: NodeExecutorConfig;
+    /** Controls the LLM turn budget for this node. */
+    executionMode: NodeExecutionMode;
+    /** Classifies the side-effects this node may produce. */
+    effectClass: EffectClass;
+    /** Maximum wall-clock execution time in milliseconds before the node is aborted. */
+    timeout?: number;
+    /** Automatic retry configuration for transient failures. */
+    retryPolicy?: RetryPolicy;
+    /**
+     * When the runtime should persist a checkpoint snapshot.
+     * - `before` — snapshot taken before executor runs (enables re-entry on crash).
+     * - `after`  — snapshot taken after executor succeeds.
+     * - `both`   — snapshot taken at both points.
+     * - `none`   — no snapshot for this node.
+     */
+    checkpoint: 'before' | 'after' | 'both' | 'none';
+    /** JSON-Schema-compatible description of the expected input shape. */
+    inputSchema?: Record<string, unknown>;
+    /** JSON-Schema-compatible description of the expected output shape. */
+    outputSchema?: Record<string, unknown>;
+    /** Memory read/write configuration applied by the runtime around execution. */
+    memoryPolicy?: MemoryPolicy;
+    /** Dynamic capability discovery configuration applied before execution. */
+    discoveryPolicy?: DiscoveryPolicy;
+    /** Persona layer configuration injected into the prompt context. */
+    personaPolicy?: PersonaPolicy;
+    /** Declarative guardrails evaluated on input and/or output payloads. */
+    guardrailPolicy?: GuardrailPolicy;
+}
+/**
+ * A directed edge connecting two vertices in the compiled execution graph.
+ *
+ * The `source` and `target` fields may be `START` or `END` sentinels.
+ */
+export interface GraphEdge {
+    /** Unique identifier within the parent `CompiledExecutionGraph`. */
+    id: string;
+    /** Source node id (or `START`). */
+    source: string;
+    /** Target node id (or `END`). */
+    target: string;
+    /**
+     * Edge routing strategy:
+     * - `static`      — always followed; no condition evaluated.
+     * - `conditional` — followed only when `condition` evaluates to this edge's target.
+     * - `discovery`   — target is resolved at runtime via capability discovery.
+     * - `personality` — target is chosen based on the agent's current trait values.
+     */
+    type: 'static' | 'conditional' | 'discovery' | 'personality';
+    /** Routing predicate; required when `type` is `'conditional'`. */
+    condition?: GraphCondition;
+    /** Semantic query used to discover the target node at runtime; required for `'discovery'` edges. */
+    discoveryQuery?: string;
+    /** Capability kind filter applied during discovery-based routing. */
+    discoveryKind?: 'tool' | 'skill' | 'extension' | 'any';
+    /** Node id used as fallback when discovery resolves no target. */
+    discoveryFallback?: string;
+    /**
+     * Personality-based routing descriptor; required when `type` is `'personality'`.
+     * The runtime reads `trait` from the agent's current HEXACO/PAD state and
+     * routes to `above` or `below` depending on whether the value exceeds `threshold`.
+     */
+    personalityCondition?: {
+        trait: string;
+        threshold: number;
+        above: string;
+        below: string;
+    };
+    /** Optional guardrail policy evaluated when traffic crosses this edge. */
+    guardrailPolicy?: GuardrailPolicy;
+}
+/**
+ * The mutable execution state threaded through every node of a graph run.
+ *
+ * Generic parameters allow authors to provide precise types for their specific graph.
+ * All fields except `scratch` and `artifacts` are managed exclusively by the runtime.
+ *
+ * @template TInput     - Shape of the initial user-provided input.
+ * @template TScratch   - Shape of intermediate computation results passed between nodes.
+ * @template TArtifacts - Shape of outputs produced for external consumption.
+ */
+export interface GraphState<TInput = unknown, TScratch = unknown, TArtifacts = unknown> {
+    /** The original user-provided input; frozen after graph start. */
+    input: Readonly<TInput>;
+    /** Node-to-node communication bag; merged via `StateReducers` after each node. */
+    scratch: TScratch;
+    /** Read-only memory snapshot populated before each node executes. */
+    memory: MemoryView;
+    /** Accumulated outputs intended for the caller; merged via `StateReducers` after each node. */
+    artifacts: TArtifacts;
+    /** Append-only telemetry record updated after each node completes. */
+    diagnostics: DiagnosticsView;
+    /** Id of the node currently executing (or most recently completed). */
+    currentNodeId: string;
+    /** Ordered list of node ids that have completed execution in this run. */
+    visitedNodes: string[];
+    /** Number of times the graph has looped back to a previously visited node. */
+    iteration: number;
+    /** Id of the most recently persisted checkpoint snapshot, if any. */
+    checkpointId?: string;
+}
+/**
+ * Named built-in reducer strategies for `GraphState.scratch` and `GraphState.artifacts` fields.
+ *
+ * - `concat`  — append arrays or concatenate strings.
+ * - `merge`   — deep-merge objects (right wins on conflict).
+ * - `max`     — keep the larger numeric value.
+ * - `min`     — keep the smaller numeric value.
+ * - `avg`     — running arithmetic mean.
+ * - `sum`     — running total.
+ * - `last`    — always overwrite with the latest value (default semantics).
+ * - `first`   — keep the first value; ignore subsequent writes.
+ * - `longest` — keep the longer string or larger array.
+ */
+export type BuiltinReducer = 'concat' | 'merge' | 'max' | 'min' | 'avg' | 'sum' | 'last' | 'first' | 'longest';
+/**
+ * Custom reducer function for a single state field.
+ *
+ * @param existing - The current field value held in `GraphState`.
+ * @param incoming - The new value emitted by the most recently completed node.
+ * @returns The merged value to store back into `GraphState`.
+ */
+export type ReducerFn = (existing: unknown, incoming: unknown) => unknown;
+/**
+ * Maps dot-notation field paths in `GraphState.scratch` / `GraphState.artifacts` to
+ * either a `BuiltinReducer` name or a custom `ReducerFn`.
+ *
+ * Example:
+ * ```ts
+ * const reducers: StateReducers = {
+ *   'scratch.messages': 'concat',
+ *   'artifacts.summary': (a, b) => String(b ?? a),
+ * };
+ * ```
+ */
+export interface StateReducers {
+    [fieldPath: string]: ReducerFn | BuiltinReducer;
+}
+/**
+ * Lightweight descriptor stored alongside each persisted checkpoint snapshot.
+ * Used by the runtime to enumerate and restore checkpoints without deserialising
+ * the full `GraphState` payload.
+ */
+export interface CheckpointMetadata {
+    /** Unique checkpoint id (UUIDv4 assigned by the runtime). */
+    id: string;
+    /** Id of the graph run that produced this checkpoint. */
+    runId: string;
+    /** Id of the `CompiledExecutionGraph` being executed. */
+    graphId: string;
+    /** Id of the node that triggered checkpoint persistence. */
+    nodeId: string;
+    /** Unix epoch milliseconds when the checkpoint was persisted. */
+    timestamp: number;
+    /** Serialised byte size of the `GraphState` payload. */
+    stateSize: number;
+    /** Whether a full `MemoryView` snapshot was included in the payload. */
+    hasMemorySnapshot: boolean;
+}
+/**
+ * Complete inspection record for an in-progress or finished graph run.
+ * Returned by the runtime's run-management API.
+ */
+export interface RunInspection {
+    /** Unique run id (UUIDv4 assigned when the run was started). */
+    runId: string;
+    /** Id of the `CompiledExecutionGraph` being executed. */
+    graphId: string;
+    /** Current lifecycle phase of the run. */
+    status: 'running' | 'completed' | 'errored' | 'interrupted';
+    /** Id of the node currently executing; absent when `status` is terminal. */
+    currentNodeId?: string;
+    /** Ordered list of node ids that have completed execution. */
+    visitedNodes: string[];
+    /** Ordered stream of runtime events emitted during the run (type: `GraphEvent[]`). */
+    events: unknown[];
+    /** All checkpoint snapshots persisted during the run. */
+    checkpoints: CheckpointMetadata[];
+    /** Accumulated diagnostic telemetry. */
+    diagnostics: DiagnosticsView;
+    /** Final output value; only present when `status` is `'completed'`. */
+    finalOutput?: unknown;
+    /** Structured error detail; only present when `status` is `'errored'`. */
+    error?: {
+        message: string;
+        code: string;
+        nodeId?: string;
+    };
+}
+/**
+ * The fully compiled, execution-ready representation of an agent graph.
+ *
+ * All three authoring APIs (AgentGraph builder, workflow DSL, mission planner) produce
+ * a `CompiledExecutionGraph` as their final compilation artefact.  The runtime never
+ * interprets authoring-API-specific constructs — it operates exclusively on this type.
+ */
+export interface CompiledExecutionGraph {
+    /** Stable, globally unique graph identifier (slug or UUIDv4). */
+    id: string;
+    /** Human-readable display name. */
+    name: string;
+    /** All vertices, including any `START`/`END` bridge nodes inserted by the compiler. */
+    nodes: GraphNode[];
+    /** All directed edges, including static entry/exit edges from/to `START`/`END`. */
+    edges: GraphEdge[];
+    /**
+     * JSON-Schema-compatible schema declarations for the three `GraphState` generics.
+     * Used by the runtime for validation and by tooling for type generation.
+     */
+    stateSchema: {
+        input: Record<string, unknown>;
+        scratch: Record<string, unknown>;
+        artifacts: Record<string, unknown>;
+    };
+    /** Field-level reducer configuration applied after each node completes. */
+    reducers: StateReducers;
+    /**
+     * Graph-wide default checkpoint persistence policy.
+     * Per-node `GraphNode.checkpoint` settings override this default.
+     *
+     * - `every_node` — persist after every node (safe, high storage cost).
+     * - `explicit`   — persist only for nodes that declare `checkpoint !== 'none'`.
+     * - `none`       — never persist (lowest overhead; no recovery on crash).
+     */
+    checkpointPolicy: 'every_node' | 'explicit' | 'none';
+    /** Graph-wide memory consistency mode; may be overridden per-node via `MemoryPolicy.consistency`. */
+    memoryConsistency: MemoryConsistencyMode;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/orchestration/ir/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/orchestration/ir/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,6EAA6E;AAC7E,eAAO,MAAM,KAAK,EAAG,WAAoB,CAAC;AAE1C,4EAA4E;AAC5E,eAAO,MAAM,GAAG,EAAG,SAAkB,CAAC;AAMtC;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAEvF;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAM3E;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,aAAa,CAAC;AAErF;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;AAMtE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,MAAM,CAAC;AAE7D;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAExC;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,gBAAgB,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAMrD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,6FAA6F;IAC7F,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mEAAmE;IACnE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,yDAAyD;IACzD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,6CAA6C;IAC7C,WAAW,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IACvD,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,wEAAwE;IACxE,SAAS,EAAE,cAAc,CAAC;CAC3B,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC,CAAC;AAMN;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,qBAAqB,CAAC;IACnC,IAAI,CAAC,EAAE;QACL,oDAAoD;QACpD,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;QAC1B,4CAA4C;QAC5C,KAAK,CAAC,EAAE,gBAAgB,CAAC;QACzB,oEAAoE;QACpE,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,uEAAuE;QACvE,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,qEAAqE;QACrE,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,wEAAwE;QACxE,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,qDAAqD;QACrD,IAAI,CAAC,EAAE,eAAe,CAAC;QACvB,4CAA4C;QAC5C,KAAK,CAAC,EAAE,gBAAgB,CAAC;KAC1B,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,KAAK,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,kFAAkF;IAClF,MAAM,EAAE,aAAa,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,eAAe,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,2EAA2E;QAC3E,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,gBAAgB,CAAC;QACxB,gEAAgE;QAChE,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,CAAC;IACH,kFAAkF;IAClF,aAAa,EAAE,aAAa,CAAC;QAC3B,IAAI,EAAE,eAAe,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,gBAAgB,CAAC;KACzB,CAAC,CAAC;IACH,wFAAwF;IACxF,eAAe,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,eAAe,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpF,uEAAuE;IACvE,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7F,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9G,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,qGAAqG;IACrG,EAAE,EAAE,MAAM,CAAC;IACX,oFAAoF;IACpF,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;IACnF,oFAAoF;IACpF,cAAc,EAAE,kBAAkB,CAAC;IACnC,kDAAkD;IAClD,aAAa,EAAE,iBAAiB,CAAC;IACjC,yDAAyD;IACzD,WAAW,EAAE,WAAW,CAAC;IACzB,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;;;OAMG;IACH,UAAU,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACjD,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,2EAA2E;IAC3E,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oEAAoE;IACpE,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,wEAAwE;IACxE,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,IAAI,EAAE,QAAQ,GAAG,aAAa,GAAG,WAAW,GAAG,aAAa,CAAC;IAC7D,kEAAkE;IAClE,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,oGAAoG;IACpG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,KAAK,CAAC;IACvD,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,0EAA0E;IAC1E,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAMD;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU,CAAC,MAAM,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EAAE,UAAU,GAAG,OAAO;IACpF,kEAAkE;IAClE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxB,kFAAkF;IAClF,OAAO,EAAE,QAAQ,CAAC;IAClB,qEAAqE;IACrE,MAAM,EAAE,UAAU,CAAC;IACnB,+FAA+F;IAC/F,SAAS,EAAE,UAAU,CAAC;IACtB,sEAAsE;IACtE,WAAW,EAAE,eAAe,CAAC;IAC7B,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/G;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC;AAE1E;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAAC;CACjD;AAMD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;IAC5D,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,sFAAsF;IACtF,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,yDAAyD;IACzD,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,wCAAwC;IACxC,WAAW,EAAE,eAAe,CAAC;IAC7B,uEAAuE;IACvE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0EAA0E;IAC1E,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,mFAAmF;IACnF,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB;;;OAGG;IACH,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;IACF,2EAA2E;IAC3E,QAAQ,EAAE,aAAa,CAAC;IACxB;;;;;;;OAOG;IACH,gBAAgB,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;IACrD,qGAAqG;IACrG,iBAAiB,EAAE,qBAAqB,CAAC;CAC1C"}

package/dist/orchestration/ir/types.js

@@ -0,0 +1,20 @@
+/**
+ * @file types.ts
+ * @description Core Intermediate Representation (IR) types for the AgentOS Unified Orchestration Layer.
+ *
+ * All three authoring APIs — AgentGraph (graph-based), workflow (sequential), and mission
+ * (goal-oriented) — compile down to these IR types before execution. Keeping a single shared IR
+ * means the runtime, checkpointing, memory, and diagnostics subsystems only need one implementation.
+ *
+ * Dependency graph (no circular imports):
+ *   primitive enums/constants → condition/executor unions → policy interfaces →
+ *   view interfaces → GraphNode / GraphEdge / GraphState → CompiledExecutionGraph
+ */
+// ---------------------------------------------------------------------------
+// Sentinels
+// ---------------------------------------------------------------------------
+/** Sentinel node-id representing the implicit entry point of every graph. */
+export const START = '__START__';
+/** Sentinel node-id representing the implicit exit point of every graph. */
+export const END = '__END__';
+//# sourceMappingURL=types.js.map

package/dist/orchestration/ir/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/orchestration/ir/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,KAAK,GAAG,WAAoB,CAAC;AAE1C,4EAA4E;AAC5E,MAAM,CAAC,MAAM,GAAG,GAAG,SAAkB,CAAC"}