@framers/agentos 0.1.69 → 0.1.70

package/dist/api/toolAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolAdapter.d.ts","sourceRoot":"","sources":["../../src/api/toolAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,KAAK,EAA+D,MAAM,wBAAwB,CAAC;AAEjH;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACvC;AAED,oEAAoE;AACpE,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,KAAK,CAAC,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,GAAG,KAAK,EAAE,CAiDxE"}

package/dist/api/{tool-adapter.js → toolAdapter.js}

@@ -1,5 +1,26 @@
 /**
- * Adapts Zod schemas, JSON Schema objects, and ITool instances into ITool[].
+ * Converts a {@link ToolDefinitionMap} into an array of {@link ITool} instances
+ * suitable for use with the AgentOS provider layer.
+ *
+ * - Existing {@link ITool} instances (identified by `inputSchema` + `id` properties)
+ *   are passed through unchanged.
+ * - Plain {@link ToolDefinition} objects are wrapped in a minimal {@link ITool}
+ *   implementation.  Zod schemas are converted to JSON Schema when `zod-to-json-schema`
+ *   is available.
+ *
+ * @param tools - Optional map of tool names to definitions. Returns `[]` when falsy.
+ * @returns Flat array of normalised {@link ITool} instances ready for provider dispatch.
+ *
+ * @example
+ * ```ts
+ * const tools = adaptTools({
+ *   getWeather: {
+ *     description: 'Returns current weather for a city.',
+ *     parameters: { type: 'object', properties: { city: { type: 'string' } }, required: ['city'] },
+ *     execute: async ({ city }) => fetchWeather(city),
+ *   },
+ * });
+ * ```
  */
 export function adaptTools(tools) {
     if (!tools)
@@ -16,6 +37,7 @@ export function adaptTools(tools) {
         if (td.parameters && '_def' in td.parameters) {
             // Zod schema — convert to JSON Schema
             try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
                 const { zodToJsonSchema } = require('zod-to-json-schema');
                 schema = zodToJsonSchema(td.parameters);
             }
@@ -48,4 +70,4 @@ export function adaptTools(tools) {
     }
     return result;
 }
-//# sourceMappingURL=tool-adapter.js.map
+//# sourceMappingURL=toolAdapter.js.map

package/dist/api/toolAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolAdapter.js","sourceRoot":"","sources":["../../src/api/toolAdapter.ts"],"names":[],"mappings":"AAmCA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,UAAU,CAAC,KAAoC;IAC7D,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,oEAAoE;QACpE,IAAI,aAAa,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,GAAY,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,MAAM,EAAE,GAAG,GAAqB,CAAC;QACjC,IAAI,MAAwB,CAAC;QAE7B,IAAI,EAAE,CAAC,UAAU,IAAI,MAAM,IAAK,EAAE,CAAC,UAAkB,EAAE,CAAC;YACtD,sCAAsC;YACtC,IAAI,CAAC;gBACH,iEAAiE;gBACjE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAQ,CAAC;gBACjE,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,UAAU,CAAqB,CAAC;YAC9D,CAAC;YAAC,MAAM,CAAC;gBACP,0DAA0D;gBAC1D,MAAM,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;YAC9C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,CAAC,EAAE,CAAC,UAAU,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAqB,CAAC;QACrF,CAAC;QAED,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAElE,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,GAAG,IAAI,KAAK;YAChB,IAAI;YACJ,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE;YACvF,WAAW,EAAE,EAAE,CAAC,WAAW,IAAI,EAAE;YACjC,WAAW,EAAE,MAAM;YACnB,cAAc,EAAE,KAAK;YACrB,KAAK,CAAC,OAAO,CAAC,IAAS,EAAE,IAA0B;gBACjD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;oBACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACnC,CAAC;gBAAC,OAAO,GAAQ,EAAE,CAAC;oBAClB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChE,CAAC;YACH,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -59,6 +59,7 @@ export * from './types/rateLimitTypes';
 export * from './core/storage';
 export * from './rag';
 export * from './memory';
+export * from './orchestration/index.js';
 export * from './core/provenance';
 export * from './core/safety';
 export { EXTENSION_SECRET_DEFINITIONS, type ExtensionSecretDefinition, getSecretDefinition, resolveSecretForProvider, } from './config/extensionSecrets.js';
@@ -68,7 +69,9 @@ export { streamText } from './api/streamText.js';
 export type { StreamTextResult, StreamPart } from './api/streamText.js';
 export { agent } from './api/agent.js';
 export type { Agent, AgentSession, AgentOptions } from './api/agent.js';
+export { generateImage } from './api/generateImage.js';
+export type { GenerateImageOptions, GenerateImageResult } from './api/generateImage.js';
 export { parseModelString, resolveProvider } from './api/model.js';
-export { adaptTools } from './api/tool-adapter.js';
-export type { ToolDefinitionMap } from './api/tool-adapter.js';
+export { adaptTools } from './api/toolAdapter.js';
+export type { ToolDefinitionMap } from './api/toolAdapter.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -61,6 +61,7 @@ export * from './channels/index.js';
 export * from './voice/index.js';
 // Unified speech runtime (STT/TTS/VAD/wake-word)
 export * from './speech/index.js';
+// TODO: export * from './core/images' — module not yet implemented
 // Skills (SKILL.md prompt modules)
 export * from './skills.js';
 // Multilingual exports
@@ -75,6 +76,8 @@ export * from './core/storage/index.js';
 export * from './rag/index.js';
 // Cognitive Memory System
 export * from './memory/index.js';
+// Orchestration Layer (IR, Events, Checkpoint, Runtime)
+export * from './orchestration/index.js';
 // Provenance, Audit & Immutability
 export * from './core/provenance/index.js';
 // Safety Primitives (circuit breaker, dedup, cost guard, stuck detection)
@@ -85,6 +88,7 @@ export { EXTENSION_SECRET_DEFINITIONS, getSecretDefinition, resolveSecretForProv
 export { generateText } from './api/generateText.js';
 export { streamText } from './api/streamText.js';
 export { agent } from './api/agent.js';
+export { generateImage } from './api/generateImage.js';
 export { parseModelString, resolveProvider } from './api/model.js';
-export { adaptTools } from './api/tool-adapter.js';
+export { adaptTools } from './api/toolAdapter.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/orchestration/builders/AgentGraph.d.ts

@@ -0,0 +1,250 @@
+/**
+ * @file AgentGraph.ts
+ * @description Fluent builder for constructing compiled agent execution graphs.
+ *
+ * `AgentGraph` provides a type-safe, chainable API for declaring nodes and edges —
+ * including static, conditional, discovery-based, and personality-driven routing —
+ * and then compiling the resulting graph into a `CompiledExecutionGraph` IR object
+ * that the `GraphRuntime` can execute.
+ *
+ * ```
+ * AgentGraph (builder)
+ *   → GraphCompiler.compile()  → CompiledExecutionGraph (IR)
+ *   → GraphValidator.validate() → validation gate
+ *   → CompiledAgentGraph        → GraphRuntime.invoke() / stream() / resume()
+ * ```
+ *
+ * Typical usage:
+ * ```ts
+ * const graph = new AgentGraph({ input: z.object({ topic: z.string() }), ... })
+ *   .addNode('search', toolNode('web_search'))
+ *   .addEdge(START, 'search')
+ *   .addEdge('search', END)
+ *   .compile();
+ *
+ * const result = await graph.invoke({ topic: 'AgentOS' });
+ * ```
+ */
+import type { GraphNode, GraphState, CompiledExecutionGraph, StateReducers, MemoryConsistencyMode } from '../ir/types.js';
+import { START, END } from '../ir/types.js';
+import type { ICheckpointStore } from '../checkpoint/ICheckpointStore.js';
+import type { GraphEvent } from '../events/GraphEvent.js';
+export { START, END };
+/**
+ * Fluent builder for agent execution graphs.
+ *
+ * Each mutating method returns `this` to support method chaining.  All state is held
+ * in private Maps/arrays; nothing is compiled or validated until `.compile()` is called.
+ *
+ * @template TState - Narrows the `GraphState` type used in conditional-edge callbacks.
+ *   Defaults to the base `GraphState` when not specified.
+ */
+export declare class AgentGraph<TState extends GraphState = GraphState> {
+    private readonly stateSchema;
+    private readonly config?;
+    /** All user-declared nodes, keyed by their assigned id. */
+    private nodes;
+    /** All directed edges declared via `addEdge`, `addConditionalEdge`, etc. */
+    private edges;
+    /** Monotonically increasing counter used to generate unique edge ids. */
+    private edgeCounter;
+    /**
+     * @param stateSchema - Zod schemas for the three `GraphState` generic partitions.
+     *   - `input`     — shape of the frozen user-provided input passed to `invoke()`.
+     *   - `scratch`   — shape of the mutable node-to-node communication bag.
+     *   - `artifacts` — shape of the accumulated external outputs returned by `invoke()`.
+     * @param config - Optional graph-wide configuration overrides.
+     */
+    constructor(stateSchema: {
+        /** Zod schema for `GraphState.input`. */
+        input: any;
+        /** Zod schema for `GraphState.scratch`. */
+        scratch: any;
+        /** Zod schema for `GraphState.artifacts`. */
+        artifacts: any;
+    }, config?: {
+        /** Field-level merge strategies for `scratch` and `artifacts` fields. */
+        reducers?: StateReducers;
+        /** Graph-wide memory consistency mode (default: `'snapshot'`). */
+        memoryConsistency?: MemoryConsistencyMode;
+        /** Graph-wide checkpoint persistence strategy (default: `'none'`). */
+        checkpointPolicy?: "every_node" | "explicit" | "none";
+    } | undefined);
+    /**
+     * Add a node to the graph.
+     *
+     * The node's `id` field is overridden with the supplied `id` argument so the
+     * user-declared identifier is always canonical.
+     *
+     * @param id   - Unique node identifier within this graph.  Must not equal `START` or `END`.
+     * @param node - A `GraphNode` produced by one of the factory helpers in `builders/nodes.ts`.
+     * @returns `this` for chaining.
+     * @throws {Error} When `id` has already been registered.
+     */
+    addNode(id: string, node: GraphNode): this;
+    /**
+     * Add an unconditional (static) edge that is always followed at runtime.
+     *
+     * Either `source` or `target` (or both) may be the `START` / `END` sentinels.
+     *
+     * @param source - Source node id (or `START`).
+     * @param target - Target node id (or `END`).
+     * @returns `this` for chaining.
+     */
+    addEdge(source: string, target: string): this;
+    /**
+     * Add a conditional edge whose target is determined at runtime by a callback.
+     *
+     * The `condition` function receives the current `GraphState` and returns the id of
+     * the next node to activate.  The returned id is resolved against the edge list at
+     * runtime; no compile-time validation of the returned id is performed.
+     *
+     * Because conditional edges encode the target resolution in a closure, the `target`
+     * field stored in the IR is set to the placeholder `'__CONDITIONAL__'`.
+     *
+     * @param source    - Source node id (or `START`).
+     * @param condition - Pure function `(state: TState) => string` returning the next node id.
+     * @returns `this` for chaining.
+     */
+    addConditionalEdge(source: string, condition: (state: TState) => string): this;
+    /**
+     * Add a discovery edge whose target is resolved at runtime via the capability discovery engine.
+     *
+     * When discovery returns no result, execution falls back to `config.fallbackTarget` (if provided)
+     * or the placeholder `'__DISCOVERY__'`.
+     *
+     * @param source - Source node id.
+     * @param config - Discovery configuration.
+     * @param config.query          - Semantic search query forwarded to `CapabilityDiscoveryEngine`.
+     * @param config.kind           - Optional filter: restrict discovery to a specific capability kind.
+     * @param config.fallbackTarget - Node id to route to when discovery resolves no target.
+     * @returns `this` for chaining.
+     */
+    addDiscoveryEdge(source: string, config: {
+        /** Semantic query forwarded to the capability discovery engine. */
+        query: string;
+        /** Optional capability kind filter (`'tool'`, `'skill'`, `'extension'`, or `'any'`). */
+        kind?: 'tool' | 'skill' | 'extension' | 'any';
+        /** Fallback node id used when discovery resolves no target. */
+        fallbackTarget?: string;
+    }): this;
+    /**
+     * Add a personality edge whose target is chosen based on the agent's current trait value.
+     *
+     * At runtime the engine reads `config.trait` from the agent's HEXACO/PAD state and routes
+     * to `config.above` when the value is ≥ `config.threshold`, or `config.below` otherwise.
+     *
+     * @param source - Source node id.
+     * @param config - Personality routing configuration.
+     * @param config.trait     - HEXACO/PAD trait name to inspect (e.g. `'conscientiousness'`).
+     * @param config.threshold - Decision boundary (0–1).
+     * @param config.above     - Target node id when trait value ≥ threshold.
+     * @param config.below     - Target node id when trait value < threshold.
+     * @returns `this` for chaining.
+     */
+    addPersonalityEdge(source: string, config: {
+        /** HEXACO/PAD trait name, e.g. `'conscientiousness'` or `'openness'`. */
+        trait: string;
+        /** Decision threshold in range 0–1. */
+        threshold: number;
+        /** Target node id when the trait value is at or above the threshold. */
+        above: string;
+        /** Target node id when the trait value is below the threshold. */
+        below: string;
+    }): this;
+    /**
+     * Compile the builder state into a `CompiledAgentGraph` ready for execution.
+     *
+     * Compilation steps:
+     * 1. Call `GraphCompiler.compile()` to produce the raw `CompiledExecutionGraph` IR.
+     * 2. (Optional, default: enabled) Call `GraphValidator.validate()` to assert structural
+     *    correctness — any validation error or warning causes an exception.
+     * 3. Wrap the IR and a checkpoint store in a `CompiledAgentGraph` instance.
+     *
+     * Pass `{ validate: false }` to skip validation (e.g. for cyclic graphs under construction).
+     *
+     * @param options - Optional compilation flags.
+     * @param options.checkpointStore - Custom checkpoint store; defaults to `InMemoryCheckpointStore`.
+     * @param options.validate        - Set to `false` to skip structural validation (default: `true`).
+     * @returns A `CompiledAgentGraph` instance ready for `invoke()` / `stream()` / `resume()`.
+     * @throws {Error} When validation is enabled and the graph contains structural errors or warnings.
+     */
+    compile(options?: {
+        /** Custom checkpoint persistence backend. Defaults to an in-memory store. */
+        checkpointStore?: ICheckpointStore;
+        /**
+         * Whether to run `GraphValidator.validate()` before returning.
+         * Defaults to `true`. Set to `false` for cyclic or incomplete graphs under construction.
+         */
+        validate?: boolean;
+    }): CompiledAgentGraph<TState>;
+}
+/**
+ * A compiled, execution-ready agent graph.
+ *
+ * Returned by `AgentGraph.compile()` — do not instantiate directly.
+ *
+ * Wraps a `CompiledExecutionGraph` IR object and a `GraphRuntime` instance, exposing
+ * the three execution modes: synchronous `invoke()`, streaming `stream()`, and
+ * checkpoint-based `resume()`.
+ *
+ * @template TState - Type parameter threaded from the parent `AgentGraph`.
+ */
+export declare class CompiledAgentGraph<TState extends GraphState = GraphState> {
+    private readonly ir;
+    /** Internal `GraphRuntime` instance reused across all invocations. */
+    private readonly runtime;
+    /**
+     * @param ir              - Compiled execution graph IR produced by `GraphCompiler`.
+     * @param checkpointStore - Persistence backend for checkpoint snapshots.
+     */
+    constructor(ir: CompiledExecutionGraph, checkpointStore: ICheckpointStore);
+    /**
+     * Execute the graph to completion and return the final `artifacts` payload.
+     *
+     * This is the simplest execution mode — it buffers all events internally and returns
+     * only the terminal output.  Use `stream()` when you need real-time progress updates.
+     *
+     * @param input - Initial user-provided input frozen into `GraphState.input`.
+     * @returns The `GraphState.artifacts` value after the last node completes.
+     */
+    invoke(input: unknown): Promise<unknown>;
+    /**
+     * Execute the graph while yielding `GraphEvent` values at each significant step.
+     *
+     * Events are emitted in strict causal order:
+     * `run_start` → (`node_start` → `node_end` → `edge_transition`?)+ → `run_end`
+     *
+     * @param input - Initial user-provided input frozen into `GraphState.input`.
+     * @yields {GraphEvent} Runtime events in causal order.
+     */
+    stream(input: unknown): AsyncIterable<GraphEvent>;
+    /**
+     * Resume a previously interrupted run from its latest persisted checkpoint.
+     *
+     * The `patch` argument is accepted for API compatibility with future resume-with-patch
+     * support; it is not forwarded to the runtime in the current implementation.
+     *
+     * @param checkpointId - The run id returned by the original `stream()` call.
+     * @param patch        - Reserved for future use: optional partial state override.
+     * @returns The final `GraphState.artifacts` value after resumption completes.
+     * @throws {Error} When no checkpoint exists for the given `checkpointId`.
+     */
+    resume(checkpointId: string, patch?: Partial<TState>): Promise<unknown>;
+    /**
+     * Inspect execution state for a completed or in-progress run.
+     *
+     * @param runId - The unique run identifier assigned at `stream()` call-time.
+     * @returns A stub object — full inspection support is tracked separately.
+     *
+     * @todo Implement with full runtime inspection once the run-registry subsystem lands.
+     */
+    inspect(_runId: string): Promise<unknown>;
+    /**
+     * Return the underlying `CompiledExecutionGraph` IR.
+     *
+     * Useful for serialisation, debugging, or forwarding to external tooling.
+     */
+    toIR(): CompiledExecutionGraph;
+}
+//# sourceMappingURL=AgentGraph.d.ts.map

package/dist/orchestration/builders/AgentGraph.d.ts.map

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