@framers/agentos 0.1.113 → 0.1.114

package/dist/api/resumeExternalToolRequestWithRegisteredTools.js

@@ -0,0 +1,159 @@
+import { AgentOSServiceError } from './errors.js';
+import { GMIErrorCode } from '../utils/errors.js';
+import { executeExternalToolFromRegistry, mergeExternalToolRegistries, registerTemporaryExternalTools, } from './externalToolRegistry.js';
+function normalizeOptionalString(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed || undefined;
+}
+function buildResumeOptions(options) {
+    const resumeOptions = {};
+    if (options.userApiKeys) {
+        resumeOptions.userApiKeys = options.userApiKeys;
+    }
+    if (options.preferredModelId) {
+        resumeOptions.preferredModelId = options.preferredModelId;
+    }
+    if (options.preferredProviderId) {
+        resumeOptions.preferredProviderId = options.preferredProviderId;
+    }
+    if (options.organizationId) {
+        resumeOptions.organizationId = options.organizationId;
+    }
+    return resumeOptions;
+}
+function resolveExternalToolsForRuntime(agentos, registry) {
+    return mergeExternalToolRegistries(agentos.getExternalToolRegistry?.(), registry);
+}
+/**
+ * Builds the `ToolExecutionContext` that a host should use when it wants to
+ * execute a persisted external tool pause against AgentOS's registered tool
+ * registry after restart.
+ */
+export function buildPendingExternalToolExecutionContext(pendingRequest, options = {}) {
+    const userContext = {
+        ...(options.userContext ?? {}),
+        userId: pendingRequest.userId,
+    };
+    const organizationId = normalizeOptionalString(options.organizationId ?? userContext.organizationId);
+    if (organizationId) {
+        userContext.organizationId = organizationId;
+    }
+    const sessionData = {
+        sessionId: pendingRequest.sessionId,
+        conversationId: pendingRequest.conversationId,
+    };
+    if (organizationId) {
+        sessionData.organizationId = organizationId;
+    }
+    return {
+        gmiId: pendingRequest.gmiInstanceId,
+        personaId: pendingRequest.personaId,
+        userContext,
+        correlationId: normalizeOptionalString(options.correlationId) ?? pendingRequest.streamId,
+        sessionData,
+    };
+}
+/**
+ * Executes one pending external tool call through AgentOS's registered tool
+ * registry using the correct resume-time execution context, then optionally
+ * falls back to a host-provided external tool registry or dynamic callback.
+ */
+export async function executePendingExternalToolCall(agentos, pendingRequest, toolCall, options = {}) {
+    const externalTools = resolveExternalToolsForRuntime(agentos, options.externalTools);
+    const tool = await agentos.getToolOrchestrator().getTool(toolCall.name);
+    if (!tool) {
+        const executionContext = buildPendingExternalToolExecutionContext(pendingRequest, {
+            ...options,
+            correlationId: options.correlationId ?? toolCall.id,
+        });
+        const registryExecution = await executeExternalToolFromRegistry(externalTools, toolCall.name, toolCall.arguments, executionContext, {
+            errorOrigin: 'executePendingExternalToolCall',
+            failureMessage: `Failed to execute external tool '${toolCall.name}' from externalTools registry`,
+        });
+        if (registryExecution) {
+            return {
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                toolOutput: registryExecution.toolOutput,
+                isSuccess: registryExecution.isSuccess ?? true,
+                errorMessage: registryExecution.errorMessage,
+            };
+        }
+        if (options.fallbackExternalToolHandler) {
+            try {
+                const execution = await options.fallbackExternalToolHandler({
+                    agentos,
+                    pendingRequest,
+                    toolCall,
+                });
+                return {
+                    toolCallId: toolCall.id,
+                    toolName: toolCall.name,
+                    toolOutput: execution.toolOutput,
+                    isSuccess: execution.isSuccess ?? true,
+                    errorMessage: execution.errorMessage,
+                };
+            }
+            catch (error) {
+                throw AgentOSServiceError.wrap(error, GMIErrorCode.TOOL_ERROR, `Failed to execute fallback external tool '${toolCall.name}'`, 'executePendingExternalToolCall');
+            }
+        }
+        throw new AgentOSServiceError(`Pending external tool '${toolCall.name}' is not registered.`, GMIErrorCode.RESOURCE_NOT_FOUND, {
+            conversationId: pendingRequest.conversationId,
+            streamId: pendingRequest.streamId,
+            toolCallId: toolCall.id,
+            toolName: toolCall.name,
+        }, 'executePendingExternalToolCall');
+    }
+    try {
+        const execution = await tool.execute(toolCall.arguments, buildPendingExternalToolExecutionContext(pendingRequest, {
+            ...options,
+            correlationId: options.correlationId ?? toolCall.id,
+        }));
+        return {
+            toolCallId: toolCall.id,
+            toolName: toolCall.name,
+            toolOutput: execution.output,
+            isSuccess: execution.success,
+            errorMessage: execution.error,
+        };
+    }
+    catch (error) {
+        throw AgentOSServiceError.wrap(error, GMIErrorCode.TOOL_ERROR, `Failed to execute pending external tool '${toolCall.name}'`, 'executePendingExternalToolCall');
+    }
+}
+/**
+ * Executes all tool calls from a persisted external-tool pause, in order,
+ * through AgentOS's registered tool registry.
+ */
+export async function executePendingExternalToolCalls(agentos, pendingRequest, options = {}) {
+    const toolResults = [];
+    for (const toolCall of pendingRequest.toolCalls) {
+        toolResults.push(await executePendingExternalToolCall(agentos, pendingRequest, toolCall, options));
+    }
+    return toolResults;
+}
+/**
+ * Executes all pending registered tool calls from a persisted external-tool
+ * pause and immediately resumes the AgentOS stream on the caller's behalf.
+ * Missing tool names can optionally fall back to `externalTools` or
+ * `fallbackExternalToolHandler`.
+ */
+export async function* resumeExternalToolRequestWithRegisteredTools(agentos, pendingRequest, options = {}) {
+    const externalTools = resolveExternalToolsForRuntime(agentos, options.externalTools);
+    const toolResults = await executePendingExternalToolCalls(agentos, pendingRequest, {
+        ...options,
+        externalTools,
+    });
+    const cleanup = await registerTemporaryExternalTools(agentos.getToolOrchestrator(), externalTools);
+    try {
+        yield* agentos.resumeExternalToolRequest(pendingRequest, toolResults, buildResumeOptions(options));
+    }
+    finally {
+        await cleanup();
+    }
+}
+//# sourceMappingURL=resumeExternalToolRequestWithRegisteredTools.js.map

package/dist/api/resumeExternalToolRequestWithRegisteredTools.js.map

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

package/dist/api/strategies/agentGraphBuilder.d.ts

@@ -0,0 +1,170 @@
+/**
+ * @file agentGraphBuilder.ts
+ * High-level builder for agent-to-agent dependency graphs.
+ *
+ * Wraps the low-level CompiledExecutionGraph IR with agent-centric syntax,
+ * making it easy to declare multi-agent DAGs without manually constructing
+ * graph nodes and edges.
+ *
+ * The builder handles:
+ *  - Converting agent configs into GMI nodes
+ *  - Auto-generating START -> root nodes and leaf nodes -> END edges
+ *  - Resolving `dependsOn` declarations into proper graph edges
+ *  - Setting up appropriate state reducers for inter-agent data flow
+ *  - Cycle detection via topological sort validation
+ *
+ * @example
+ * ```ts
+ * const graph = agentGraph()
+ *   .agent('researcher', { instructions: 'Find sources', tools: [webSearch] })
+ *   .agent('writer', { instructions: 'Write article', dependsOn: ['researcher'] })
+ *   .agent('editor', { instructions: 'Review article', dependsOn: ['writer'] })
+ *   .compile();
+ *
+ * const runtime = new GraphRuntime({ checkpointStore, nodeExecutor });
+ * const result = await runtime.invoke(graph, { prompt: 'Write about TypeScript' });
+ * ```
+ *
+ * @see {@link agentGraph} -- the entry-point factory function.
+ * @see {@link compileAgencyToGraph} -- the strategy-based compiler (an alternative).
+ */
+import type { CompiledExecutionGraph } from '../../orchestration/ir/types.js';
+/**
+ * Configuration for a single agent node in the graph builder.
+ *
+ * Extends the minimal set of fields needed to create a GMI node,
+ * plus a `dependsOn` array that declares execution dependencies.
+ */
+export interface AgentNodeConfig {
+    /** System instructions for this agent's GMI node. */
+    instructions: string;
+    /**
+     * Names of agents that must complete before this agent can run.
+     * Creates static edges from each dependency to this agent.
+     * Agents with no dependencies are "root" nodes connected from START.
+     *
+     * @example `dependsOn: ['researcher']` -- waits for researcher to finish
+     */
+    dependsOn?: string[];
+    /**
+     * Optional tool names available to this agent.
+     * Informational -- actual tool wiring happens at the NodeExecutor level.
+     */
+    tools?: unknown[];
+    /**
+     * Optional model override for this specific agent.
+     * When omitted, the agent uses the graph-wide default.
+     */
+    model?: string;
+    /**
+     * Maximum ReAct iterations for this agent's GMI node.
+     * Controls how many tool-call rounds the agent can perform.
+     * @default 10
+     */
+    maxIterations?: number;
+    /**
+     * Sampling temperature forwarded to the LLM provider.
+     * Lower values produce more deterministic output.
+     */
+    temperature?: number;
+}
+/**
+ * Fluent builder for constructing agent-to-agent dependency graphs.
+ *
+ * Usage:
+ * 1. Call `.agent(name, config)` for each agent in the graph.
+ * 2. Declare dependencies via `config.dependsOn`.
+ * 3. Call `.compile()` to produce a `CompiledExecutionGraph`.
+ *
+ * The builder validates at compile time that:
+ *  - All `dependsOn` references point to registered agents
+ *  - The dependency graph contains no cycles
+ *  - At least one agent is registered
+ *
+ * @example
+ * ```ts
+ * const graph = agentGraph()
+ *   .agent('a', { instructions: 'Do A' })
+ *   .agent('b', { instructions: 'Do B', dependsOn: ['a'] })
+ *   .agent('c', { instructions: 'Do C', dependsOn: ['a'] })
+ *   .agent('d', { instructions: 'Do D', dependsOn: ['b', 'c'] })
+ *   .compile();
+ * ```
+ */
+export declare class AgentGraphBuilder {
+    /** Map of agent name -> registration record. Preserves insertion order. */
+    private readonly agents;
+    /** Running counter for deterministic ordering. */
+    private orderCounter;
+    /**
+     * Registers an agent node in the graph.
+     *
+     * @param name - Unique name for this agent. Must not conflict with
+     *   START/END sentinels or previously registered names.
+     * @param config - Agent configuration including instructions and dependencies.
+     * @returns `this` for fluent chaining.
+     * @throws {Error} When the name is already registered or conflicts with sentinels.
+     *
+     * @example
+     * ```ts
+     * builder.agent('researcher', {
+     *   instructions: 'Find sources on the given topic.',
+     *   dependsOn: [],
+     * });
+     * ```
+     */
+    agent(name: string, config: AgentNodeConfig): this;
+    /**
+     * Compiles all registered agents into a `CompiledExecutionGraph`.
+     *
+     * The compilation process:
+     * 1. Validates all `dependsOn` references point to registered agents.
+     * 2. Detects cycles via Kahn's topological sort algorithm.
+     * 3. Creates a GMI node for each agent.
+     * 4. Creates START -> root nodes edges (agents with no dependencies).
+     * 5. Creates dependency edges between agents.
+     * 6. Creates leaf nodes -> END edges (agents with no dependents).
+     * 7. Sets up state reducers for inter-agent data flow.
+     *
+     * @returns A fully compiled execution graph ready for GraphRuntime.
+     * @throws {Error} When no agents are registered.
+     * @throws {Error} When a `dependsOn` reference points to an unknown agent.
+     * @throws {Error} When the dependency graph contains a cycle.
+     *
+     * @example
+     * ```ts
+     * const graph = builder.compile();
+     * const runtime = new GraphRuntime({ checkpointStore, nodeExecutor });
+     * const result = await runtime.invoke(graph, { prompt: 'Hello' });
+     * ```
+     */
+    compile(): CompiledExecutionGraph;
+}
+/**
+ * Creates a new AgentGraphBuilder instance.
+ *
+ * This is the recommended entry point for building agent dependency graphs.
+ * The builder provides a fluent API for declaring agents and their dependencies,
+ * then compiles to a CompiledExecutionGraph for execution by GraphRuntime.
+ *
+ * @returns A fresh AgentGraphBuilder ready for agent registration.
+ *
+ * @example
+ * ```ts
+ * import { agentGraph } from './agentGraphBuilder.js';
+ *
+ * const graph = agentGraph()
+ *   .agent('researcher', { instructions: 'Find sources', tools: [webSearch] })
+ *   .agent('writer', { instructions: 'Write article', dependsOn: ['researcher'] })
+ *   .agent('editor', { instructions: 'Review article', dependsOn: ['writer'] })
+ *   .compile();
+ *
+ * const runtime = new GraphRuntime({ checkpointStore, nodeExecutor });
+ * const result = await runtime.invoke(graph, { prompt: 'Write about TypeScript' });
+ * ```
+ *
+ * @see {@link AgentGraphBuilder} -- the builder class.
+ * @see {@link compileAgencyToGraph} -- the strategy-based compiler for agency() configs.
+ */
+export declare function agentGraph(): AgentGraphBuilder;
+//# sourceMappingURL=agentGraphBuilder.d.ts.map

package/dist/api/strategies/agentGraphBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentGraphBuilder.d.ts","sourceRoot":"","sources":["../../../src/api/strategies/agentGraphBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EACV,sBAAsB,EAIvB,MAAM,iCAAiC,CAAC;AAOzC;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IAErB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAmBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,iBAAiB;IAC5B,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAE/D,kDAAkD;IAClD,OAAO,CAAC,YAAY,CAAK;IAEzB;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAiBlD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,IAAI,sBAAsB;CAsKlC;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,IAAI,iBAAiB,CAE9C"}

package/dist/api/strategies/agentGraphBuilder.js

@@ -0,0 +1,299 @@
+/**
+ * @file agentGraphBuilder.ts
+ * High-level builder for agent-to-agent dependency graphs.
+ *
+ * Wraps the low-level CompiledExecutionGraph IR with agent-centric syntax,
+ * making it easy to declare multi-agent DAGs without manually constructing
+ * graph nodes and edges.
+ *
+ * The builder handles:
+ *  - Converting agent configs into GMI nodes
+ *  - Auto-generating START -> root nodes and leaf nodes -> END edges
+ *  - Resolving `dependsOn` declarations into proper graph edges
+ *  - Setting up appropriate state reducers for inter-agent data flow
+ *  - Cycle detection via topological sort validation
+ *
+ * @example
+ * ```ts
+ * const graph = agentGraph()
+ *   .agent('researcher', { instructions: 'Find sources', tools: [webSearch] })
+ *   .agent('writer', { instructions: 'Write article', dependsOn: ['researcher'] })
+ *   .agent('editor', { instructions: 'Review article', dependsOn: ['writer'] })
+ *   .compile();
+ *
+ * const runtime = new GraphRuntime({ checkpointStore, nodeExecutor });
+ * const result = await runtime.invoke(graph, { prompt: 'Write about TypeScript' });
+ * ```
+ *
+ * @see {@link agentGraph} -- the entry-point factory function.
+ * @see {@link compileAgencyToGraph} -- the strategy-based compiler (an alternative).
+ */
+import { START, END } from '../../orchestration/ir/types.js';
+// ---------------------------------------------------------------------------
+// AgentGraphBuilder
+// ---------------------------------------------------------------------------
+/**
+ * Fluent builder for constructing agent-to-agent dependency graphs.
+ *
+ * Usage:
+ * 1. Call `.agent(name, config)` for each agent in the graph.
+ * 2. Declare dependencies via `config.dependsOn`.
+ * 3. Call `.compile()` to produce a `CompiledExecutionGraph`.
+ *
+ * The builder validates at compile time that:
+ *  - All `dependsOn` references point to registered agents
+ *  - The dependency graph contains no cycles
+ *  - At least one agent is registered
+ *
+ * @example
+ * ```ts
+ * const graph = agentGraph()
+ *   .agent('a', { instructions: 'Do A' })
+ *   .agent('b', { instructions: 'Do B', dependsOn: ['a'] })
+ *   .agent('c', { instructions: 'Do C', dependsOn: ['a'] })
+ *   .agent('d', { instructions: 'Do D', dependsOn: ['b', 'c'] })
+ *   .compile();
+ * ```
+ */
+export class AgentGraphBuilder {
+    constructor() {
+        /** Map of agent name -> registration record. Preserves insertion order. */
+        this.agents = new Map();
+        /** Running counter for deterministic ordering. */
+        this.orderCounter = 0;
+    }
+    /**
+     * Registers an agent node in the graph.
+     *
+     * @param name - Unique name for this agent. Must not conflict with
+     *   START/END sentinels or previously registered names.
+     * @param config - Agent configuration including instructions and dependencies.
+     * @returns `this` for fluent chaining.
+     * @throws {Error} When the name is already registered or conflicts with sentinels.
+     *
+     * @example
+     * ```ts
+     * builder.agent('researcher', {
+     *   instructions: 'Find sources on the given topic.',
+     *   dependsOn: [],
+     * });
+     * ```
+     */
+    agent(name, config) {
+        if (this.agents.has(name)) {
+            throw new Error(`Agent "${name}" is already registered in the graph builder`);
+        }
+        if (name === START || name === END) {
+            throw new Error(`Agent name cannot be "${name}" -- reserved sentinel`);
+        }
+        this.agents.set(name, {
+            name,
+            config,
+            order: this.orderCounter++,
+        });
+        return this;
+    }
+    /**
+     * Compiles all registered agents into a `CompiledExecutionGraph`.
+     *
+     * The compilation process:
+     * 1. Validates all `dependsOn` references point to registered agents.
+     * 2. Detects cycles via Kahn's topological sort algorithm.
+     * 3. Creates a GMI node for each agent.
+     * 4. Creates START -> root nodes edges (agents with no dependencies).
+     * 5. Creates dependency edges between agents.
+     * 6. Creates leaf nodes -> END edges (agents with no dependents).
+     * 7. Sets up state reducers for inter-agent data flow.
+     *
+     * @returns A fully compiled execution graph ready for GraphRuntime.
+     * @throws {Error} When no agents are registered.
+     * @throws {Error} When a `dependsOn` reference points to an unknown agent.
+     * @throws {Error} When the dependency graph contains a cycle.
+     *
+     * @example
+     * ```ts
+     * const graph = builder.compile();
+     * const runtime = new GraphRuntime({ checkpointStore, nodeExecutor });
+     * const result = await runtime.invoke(graph, { prompt: 'Hello' });
+     * ```
+     */
+    compile() {
+        if (this.agents.size === 0) {
+            throw new Error('Cannot compile an empty agent graph -- register at least one agent');
+        }
+        // ------------------------------------------------------------------
+        // Phase 1: Validate dependency references
+        // ------------------------------------------------------------------
+        for (const [name, reg] of this.agents) {
+            for (const dep of reg.config.dependsOn ?? []) {
+                if (!this.agents.has(dep)) {
+                    throw new Error(`Agent "${name}" depends on "${dep}" which is not registered in the graph`);
+                }
+            }
+        }
+        // ------------------------------------------------------------------
+        // Phase 2: Cycle detection via Kahn's algorithm
+        // ------------------------------------------------------------------
+        const inDegree = new Map();
+        const adjacency = new Map();
+        for (const [name] of this.agents) {
+            inDegree.set(name, 0);
+            adjacency.set(name, []);
+        }
+        for (const [name, reg] of this.agents) {
+            for (const dep of reg.config.dependsOn ?? []) {
+                adjacency.get(dep).push(name);
+                inDegree.set(name, (inDegree.get(name) ?? 0) + 1);
+            }
+        }
+        const queue = [];
+        for (const [name, degree] of inDegree) {
+            if (degree === 0)
+                queue.push(name);
+        }
+        const sorted = [];
+        while (queue.length > 0) {
+            const current = queue.shift();
+            sorted.push(current);
+            for (const neighbor of adjacency.get(current) ?? []) {
+                const newDegree = (inDegree.get(neighbor) ?? 1) - 1;
+                inDegree.set(neighbor, newDegree);
+                if (newDegree === 0)
+                    queue.push(neighbor);
+            }
+        }
+        if (sorted.length < this.agents.size) {
+            const stuck = [...this.agents.keys()].filter(n => !sorted.includes(n));
+            throw new Error(`Cycle detected in agent graph. Stuck agents: ${stuck.join(', ')}`);
+        }
+        // ------------------------------------------------------------------
+        // Phase 3: Build graph nodes
+        // ------------------------------------------------------------------
+        const nodes = [];
+        const edges = [];
+        let edgeId = 0;
+        // Track which agents have dependents so we can identify leaf nodes.
+        const hasDependents = new Set();
+        for (const [, reg] of this.agents) {
+            for (const dep of reg.config.dependsOn ?? []) {
+                hasDependents.add(dep);
+            }
+        }
+        for (const [name, reg] of this.agents) {
+            const config = reg.config;
+            const depKeys = (config.dependsOn ?? []).map(d => `output_${d}`);
+            // Build context instructions: tell the agent where to find
+            // predecessor outputs in the scratch partition.
+            const contextInstructions = depKeys.length > 0
+                ? `\n\nRead the following scratch keys for context from your dependencies: ${depKeys.join(', ')}.`
+                : '\n\nRead scratch.prompt for the initial task.';
+            const nodeId = `agent_${name}`;
+            nodes.push({
+                id: nodeId,
+                type: 'gmi',
+                executorConfig: {
+                    type: 'gmi',
+                    instructions: `You are agent "${name}". ${config.instructions}${contextInstructions}` +
+                        `\n\nWrite your output to scratch key "output_${name}".`,
+                    maxInternalIterations: config.maxIterations,
+                    temperature: config.temperature,
+                },
+                executionMode: config.maxIterations && config.maxIterations > 1
+                    ? 'react_bounded'
+                    : 'single_turn',
+                effectClass: 'pure',
+                checkpoint: 'after',
+            });
+            // ------------------------------------------------------------------
+            // Phase 4: Wire edges
+            // ------------------------------------------------------------------
+            const deps = config.dependsOn ?? [];
+            if (deps.length === 0) {
+                // Root node: connect from START.
+                edges.push({
+                    id: `edge_${edgeId++}`,
+                    source: START,
+                    target: nodeId,
+                    type: 'static',
+                });
+            }
+            else {
+                // Connect from each dependency.
+                for (const dep of deps) {
+                    edges.push({
+                        id: `edge_${edgeId++}`,
+                        source: `agent_${dep}`,
+                        target: nodeId,
+                        type: 'static',
+                    });
+                }
+            }
+            // Leaf node: connect to END.
+            if (!hasDependents.has(name)) {
+                edges.push({
+                    id: `edge_${edgeId++}`,
+                    source: nodeId,
+                    target: END,
+                    type: 'static',
+                });
+            }
+        }
+        // ------------------------------------------------------------------
+        // Phase 5: State reducers
+        // ------------------------------------------------------------------
+        const reducers = {};
+        for (const [name] of this.agents) {
+            // Each agent writes to its own output key.
+            reducers[`scratch.output_${name}`] = 'last';
+        }
+        // Collected outputs for downstream synthesis.
+        reducers['scratch.agentOutputs'] = 'concat';
+        return {
+            id: `agent-graph-${crypto.randomUUID().slice(0, 8)}`,
+            name: 'Agent Graph',
+            nodes,
+            edges,
+            stateSchema: {
+                input: { type: 'object', properties: { prompt: { type: 'string' } } },
+                scratch: { type: 'object' },
+                artifacts: { type: 'object' },
+            },
+            reducers,
+            checkpointPolicy: 'explicit',
+            memoryConsistency: 'live',
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory function
+// ---------------------------------------------------------------------------
+/**
+ * Creates a new AgentGraphBuilder instance.
+ *
+ * This is the recommended entry point for building agent dependency graphs.
+ * The builder provides a fluent API for declaring agents and their dependencies,
+ * then compiles to a CompiledExecutionGraph for execution by GraphRuntime.
+ *
+ * @returns A fresh AgentGraphBuilder ready for agent registration.
+ *
+ * @example
+ * ```ts
+ * import { agentGraph } from './agentGraphBuilder.js';
+ *
+ * const graph = agentGraph()
+ *   .agent('researcher', { instructions: 'Find sources', tools: [webSearch] })
+ *   .agent('writer', { instructions: 'Write article', dependsOn: ['researcher'] })
+ *   .agent('editor', { instructions: 'Review article', dependsOn: ['writer'] })
+ *   .compile();
+ *
+ * const runtime = new GraphRuntime({ checkpointStore, nodeExecutor });
+ * const result = await runtime.invoke(graph, { prompt: 'Write about TypeScript' });
+ * ```
+ *
+ * @see {@link AgentGraphBuilder} -- the builder class.
+ * @see {@link compileAgencyToGraph} -- the strategy-based compiler for agency() configs.
+ */
+export function agentGraph() {
+    return new AgentGraphBuilder();
+}
+//# sourceMappingURL=agentGraphBuilder.js.map

package/dist/api/strategies/agentGraphBuilder.js.map

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