@ddse/acm-adapters 0.5.0

package/dist/msaf.js

@@ -0,0 +1,269 @@
+// Microsoft Agent Framework Adapter for ACM
+import { InternalContextScopeImpl, } from '@ddse/acm-sdk';
+import { createInstrumentedToolGetter } from '@ddse/acm-runtime';
+/**
+ * Microsoft Agent Framework Adapter for ACM
+ *
+ * Converts ACM tasks into MS Agent Framework activities with proper
+ * hooks for policy, verification, and streaming.
+ */
+export class MSAgentFrameworkAdapter {
+    options;
+    activities = new Map();
+    constructor(options) {
+        this.options = options;
+        // Warn if resume options are provided but not supported
+        if (options.resumeFrom || options.checkpointStore) {
+            console.warn('⚠️  MS Agent Framework adapter does not support resume functionality. ' +
+                'Use the runtime engine (--engine runtime) for resumable executions.');
+        }
+        this.buildActivities();
+    }
+    /**
+     * Build activity handlers from ACM tasks
+     */
+    buildActivities() {
+        const { plan, capabilityRegistry, toolRegistry, policy, stream, ledger } = this.options;
+        for (const taskSpec of plan.tasks) {
+            const handler = async (state) => {
+                try {
+                    // Get task implementation
+                    const capabilityName = taskSpec.capabilityRef || taskSpec.capability;
+                    if (!capabilityName) {
+                        throw new Error(`Task ${taskSpec.id} missing capability reference`);
+                    }
+                    const task = capabilityRegistry.resolve(capabilityName);
+                    if (!task) {
+                        throw new Error(`Capability ${capabilityName} not found`);
+                    }
+                    // Build run context
+                    const allowedTools = new Set(this.options.nucleusConfig.allowedTools ?? []);
+                    for (const tool of taskSpec.tools ?? []) {
+                        allowedTools.add(tool.name);
+                    }
+                    const nucleus = this.options.nucleusFactory({
+                        goalId: this.options.goal.id,
+                        goalIntent: this.options.goal.intent,
+                        planId: this.options.plan.id,
+                        taskId: taskSpec.id,
+                        contextRef: this.options.plan.contextRef,
+                        context: state.context,
+                        llmCall: this.options.nucleusConfig.llmCall,
+                        hooks: this.options.nucleusConfig.hooks,
+                        allowedTools: Array.from(allowedTools),
+                    });
+                    const internalScope = new InternalContextScopeImpl(entry => {
+                        this.options.ledger?.append(entry.type, entry.details);
+                    });
+                    nucleus.setInternalContext(internalScope);
+                    const getTool = createInstrumentedToolGetter({
+                        taskId: taskSpec.id,
+                        capability: capabilityName,
+                        toolRegistry,
+                        ledger,
+                    });
+                    const runContext = {
+                        goal: this.options.goal,
+                        context: state.context,
+                        outputs: Object.fromEntries(state.outputs),
+                        metrics: { costUsd: 0, elapsedSec: 0 },
+                        getTool,
+                        getCapabilityRegistry: () => capabilityRegistry,
+                        stream,
+                        nucleus,
+                        internalContext: internalScope,
+                    };
+                    const preflight = await nucleus.preflight();
+                    if (preflight.status === 'NEEDS_CONTEXT') {
+                        throw new Error(`Task ${taskSpec.id} requires additional context retrieval: ${preflight.retrievalDirectives.join(', ')}`);
+                    }
+                    // Policy pre-check (PDP hook)
+                    if (policy) {
+                        const policyInput = task.policyInput?.(runContext, taskSpec.input || state.input) || {};
+                        const decision = await policy.evaluate('task.pre', {
+                            action: taskSpec.capability,
+                            input: policyInput,
+                            context: state.context,
+                        });
+                        if (!decision.allow) {
+                            if (ledger) {
+                                ledger.append('POLICY_PRE', {
+                                    taskId: taskSpec.id,
+                                    capability: taskSpec.capability,
+                                    allowed: false,
+                                });
+                            }
+                            throw new Error(`Policy denied execution of ${taskSpec.capability}`);
+                        }
+                        if (ledger) {
+                            ledger.append('POLICY_PRE', {
+                                taskId: taskSpec.id,
+                                capability: taskSpec.capability,
+                                allowed: true,
+                            });
+                        }
+                    }
+                    // Emit start event
+                    stream?.emit('task', {
+                        taskId: taskSpec.id,
+                        status: 'started',
+                        capability: taskSpec.capability,
+                    });
+                    // Execute task
+                    const output = await task.execute(runContext, taskSpec.input || state.input);
+                    // Verification (if provided)
+                    const verificationExprs = task.verification?.() || [];
+                    if (verificationExprs.length > 0) {
+                        for (const expr of verificationExprs) {
+                            try {
+                                const func = new Function('output', `return ${expr}`);
+                                const result = func(output);
+                                if (!result) {
+                                    throw new Error(`Verification failed: ${expr}`);
+                                }
+                                if (ledger) {
+                                    ledger.append('VERIFICATION', {
+                                        taskId: taskSpec.id,
+                                        expression: expr,
+                                        passed: true,
+                                    });
+                                }
+                            }
+                            catch (error) {
+                                if (ledger) {
+                                    ledger.append('VERIFICATION', {
+                                        taskId: taskSpec.id,
+                                        expression: expr,
+                                        error: String(error),
+                                        passed: false,
+                                    });
+                                }
+                                throw error;
+                            }
+                        }
+                    }
+                    // Emit completion event
+                    stream?.emit('task', {
+                        taskId: taskSpec.id,
+                        status: 'completed',
+                        output,
+                    });
+                    // Log completion
+                    if (ledger) {
+                        ledger.append('TASK_END', {
+                            taskId: taskSpec.id,
+                            capability: taskSpec.capability,
+                        });
+                    }
+                    const postcheck = await nucleus.postcheck(output);
+                    if (postcheck.status === 'NEEDS_COMPENSATION' || postcheck.status === 'ESCALATE') {
+                        throw new Error(`Task ${taskSpec.id} postcheck failed: ${postcheck.reason}`);
+                    }
+                    return output;
+                }
+                catch (error) {
+                    // Emit error event
+                    stream?.emit('task', {
+                        taskId: taskSpec.id,
+                        status: 'failed',
+                        error,
+                    });
+                    // Log error
+                    if (ledger) {
+                        ledger.append('ERROR', {
+                            taskId: taskSpec.id,
+                            error: String(error),
+                        });
+                    }
+                    throw error;
+                }
+            };
+            this.activities.set(taskSpec.id, handler);
+        }
+    }
+    /**
+     * Get activity handler for a task
+     */
+    getActivity(taskId) {
+        return this.activities.get(taskId);
+    }
+    /**
+     * Get all activities
+     */
+    getAllActivities() {
+        return new Map(this.activities);
+    }
+    /**
+     * Execute workflow using MS Agent Framework pattern
+     */
+    async execute() {
+        const { plan, context } = this.options;
+        const outputs = new Map();
+        // Build execution order based on edges
+        const executionOrder = this.topologicalSort(plan);
+        for (const taskId of executionOrder) {
+            const handler = this.activities.get(taskId);
+            if (!handler)
+                continue;
+            const taskSpec = plan.tasks.find((t) => t.id === taskId);
+            if (!taskSpec)
+                continue;
+            const state = {
+                taskId,
+                input: taskSpec.input || {},
+                context,
+                outputs,
+            };
+            const result = await handler(state);
+            outputs.set(taskId, result);
+        }
+        return {
+            outputsByTask: Object.fromEntries(outputs),
+            ledger: this.options.ledger?.getEntries() || [],
+        };
+    }
+    /**
+     * Topological sort of tasks based on edges
+     */
+    topologicalSort(plan) {
+        const inDegree = new Map();
+        const graph = new Map();
+        // Initialize
+        for (const task of plan.tasks) {
+            inDegree.set(task.id, 0);
+            graph.set(task.id, []);
+        }
+        // Build graph
+        for (const edge of plan.edges) {
+            graph.get(edge.from)?.push(edge.to);
+            inDegree.set(edge.to, (inDegree.get(edge.to) || 0) + 1);
+        }
+        // Find nodes with no incoming edges
+        const queue = [];
+        for (const [taskId, degree] of inDegree.entries()) {
+            if (degree === 0) {
+                queue.push(taskId);
+            }
+        }
+        const result = [];
+        while (queue.length > 0) {
+            const current = queue.shift();
+            result.push(current);
+            for (const neighbor of graph.get(current) || []) {
+                const newDegree = (inDegree.get(neighbor) || 0) - 1;
+                inDegree.set(neighbor, newDegree);
+                if (newDegree === 0) {
+                    queue.push(neighbor);
+                }
+            }
+        }
+        return result;
+    }
+}
+/**
+ * Helper function to create MS Agent Framework adapter
+ */
+export function wrapAgentNodes(options) {
+    return new MSAgentFrameworkAdapter(options);
+}
+//# sourceMappingURL=msaf.js.map

package/dist/msaf.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@ddse/acm-adapters",
+  "version": "0.5.0",
+  "description": "Framework adapters for ACM (LangGraph, Microsoft Agent Framework)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@ddse/acm-sdk": "0.5.0",
+    "@ddse/acm-runtime": "0.5.0"
+  },
+  "peerDependencies": {
+    "@langchain/langgraph": "^0.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@langchain/langgraph": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "keywords": [
+    "acm",
+    "langgraph",
+    "microsoft-agent-framework",
+    "adapters"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch"
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+// Framework adapters for ACM
+export { LangGraphAdapter, asLangGraph, type LangGraphAdapterOptions, type GraphState } from './langgraph.js';
+export { MSAgentFrameworkAdapter, wrapAgentNodes, type MSAgentFrameworkAdapterOptions, type ActivityState } from './msaf.js';

package/src/langgraph.ts

@@ -0,0 +1,312 @@
+// LangGraph Adapter for ACM
+import {
+  InternalContextScopeImpl,
+  type Goal,
+  type Context,
+  type Plan,
+  type CapabilityRegistry,
+  type ToolRegistry,
+  type PolicyEngine,
+  type StreamSink,
+  type RunContext,
+  type NucleusFactory,
+  type NucleusConfig,
+} from '@ddse/acm-sdk';
+import { createInstrumentedToolGetter } from '@ddse/acm-runtime';
+import type { MemoryLedger } from '@ddse/acm-runtime';
+
+/**
+ * LangGraph adapter options
+ */
+export interface LangGraphAdapterOptions {
+  goal: Goal;
+  context: Context;
+  plan: Plan;
+  capabilityRegistry: CapabilityRegistry;
+  toolRegistry: ToolRegistry;
+  policy?: PolicyEngine;
+  stream?: StreamSink;
+  ledger?: MemoryLedger;
+  resumeFrom?: string; // Checkpoint ID to resume from (optional, may not be supported)
+  checkpointStore?: any; // Checkpoint store (optional, may not be supported)
+  nucleusFactory: NucleusFactory;
+  nucleusConfig: {
+    llmCall: NucleusConfig['llmCall'];
+    hooks?: NucleusConfig['hooks'];
+    allowedTools?: string[];
+  };
+}
+
+/**
+ * LangGraph node state
+ */
+export interface GraphState {
+  taskId: string;
+  input: any;
+  output?: any;
+  error?: Error;
+  context: Context;
+  outputs: Map<string, any>;
+}
+
+/**
+ * Convert ACM Plan to LangGraph-compatible structure
+ * 
+ * This adapter converts ACM tasks and edges into LangGraph nodes and edges.
+ * Each ACM task becomes a LangGraph node, and guards become conditional edges.
+ */
+export class LangGraphAdapter {
+  constructor(private options: LangGraphAdapterOptions) {
+    // Warn if resume options are provided but not supported
+    if (options.resumeFrom || options.checkpointStore) {
+      console.warn(
+        '⚠️  LangGraph adapter does not support resume functionality. ' +
+        'Use the runtime engine (--engine runtime) for resumable executions.'
+      );
+    }
+  }
+
+  /**
+   * Create a LangGraph-compatible node function from an ACM task
+   */
+  private createNodeFunction(taskId: string) {
+    return async (state: GraphState): Promise<Partial<GraphState>> => {
+      const { plan, capabilityRegistry, toolRegistry, policy, stream, ledger } = this.options;
+      
+      // Find task spec in plan
+      const taskSpec = plan.tasks.find((t) => t.id === taskId);
+      if (!taskSpec) {
+        throw new Error(`Task ${taskId} not found in plan`);
+      }
+
+      try {
+        // Get task implementation
+        const capabilityName = taskSpec.capabilityRef || taskSpec.capability;
+        if (!capabilityName) {
+          throw new Error(`Task ${taskId} missing capability reference`);
+        }
+
+        const task = capabilityRegistry.resolve(capabilityName);
+        if (!task) {
+          throw new Error(`Capability ${capabilityName} not found`);
+        }
+
+        // Build run context
+        const allowedTools = new Set<string>(this.options.nucleusConfig.allowedTools ?? []);
+        for (const tool of taskSpec.tools ?? []) {
+          allowedTools.add(tool.name);
+        }
+
+        const nucleus = this.options.nucleusFactory({
+          goalId: this.options.goal.id,
+          goalIntent: this.options.goal.intent,
+          planId: plan.id,
+          taskId,
+          contextRef: plan.contextRef,
+          context: state.context,
+          llmCall: this.options.nucleusConfig.llmCall,
+          hooks: this.options.nucleusConfig.hooks,
+          allowedTools: Array.from(allowedTools),
+        });
+
+        const internalScope = new InternalContextScopeImpl(entry => {
+          this.options.ledger?.append(entry.type, entry.details);
+        });
+        nucleus.setInternalContext(internalScope);
+
+        const getTool = createInstrumentedToolGetter({
+          taskId,
+          capability: capabilityName,
+          toolRegistry,
+          ledger: this.options.ledger,
+        });
+
+        const runContext: RunContext = {
+          goal: this.options.goal,
+          context: state.context,
+          outputs: Object.fromEntries(state.outputs),
+          metrics: { costUsd: 0, elapsedSec: 0 },
+          getTool,
+          getCapabilityRegistry: () => capabilityRegistry,
+          stream,
+          nucleus,
+          internalContext: internalScope,
+        };
+
+        const preflight = await nucleus.preflight();
+        if (preflight.status === 'NEEDS_CONTEXT') {
+          throw new Error(
+            `Task ${taskId} requires additional context retrieval: ${preflight.retrievalDirectives.join(', ')}`
+          );
+        }
+
+        // Policy pre-check
+        if (policy) {
+          const policyInput = task.policyInput?.(runContext, taskSpec.input || state.input) || {};
+          
+          const decision = await policy.evaluate('task.pre', {
+            action: taskSpec.capability,
+            input: policyInput,
+            context: state.context,
+          });
+
+          if (!decision.allow) {
+            throw new Error(`Policy denied execution of ${taskSpec.capability}`);
+          }
+        }
+
+        // Execute task
+        stream?.emit('task', { taskId, status: 'started' });
+
+  const output = await task.execute(runContext, taskSpec.input || state.input);
+
+        // Update outputs map
+        const newOutputs = new Map(state.outputs);
+        newOutputs.set(taskId, output);
+
+        stream?.emit('task', { taskId, status: 'completed', output });
+
+        // Log to ledger
+        if (ledger) {
+          ledger.append('TASK_END', { taskId, capability: taskSpec.capability });
+        }
+
+        const postcheck = await nucleus.postcheck(output);
+        if (postcheck.status === 'NEEDS_COMPENSATION' || postcheck.status === 'ESCALATE') {
+          throw new Error(`Task ${taskId} postcheck failed: ${postcheck.reason}`);
+        }
+
+        return {
+          taskId,
+          output,
+          outputs: newOutputs,
+        };
+      } catch (error) {
+        stream?.emit('task', { taskId, status: 'failed', error });
+
+        if (ledger) {
+          ledger.append('ERROR', { taskId, error: String(error) });
+        }
+
+        return {
+          taskId,
+          error: error as Error,
+        };
+      }
+    };
+  }
+
+  /**
+   * Create guard evaluator for conditional edges
+   */
+  private createGuardEvaluator(guard?: string) {
+    if (!guard) {
+      return () => true;
+    }
+
+    return (state: GraphState): boolean => {
+      try {
+        // Simple guard evaluation
+        const func = new Function('state', 'outputs', `return ${guard}`);
+        return func(state, Object.fromEntries(state.outputs));
+      } catch {
+        return false;
+      }
+    };
+  }
+
+  /**
+   * Build LangGraph structure
+   * 
+   * Returns a configuration object that can be used with LangGraph's StateGraph
+   */
+  buildGraph(): {
+    nodes: Map<string, (state: GraphState) => Promise<Partial<GraphState>>>;
+    edges: Array<{ from: string; to: string; condition?: (state: GraphState) => boolean }>;
+    entryPoint: string;
+  } {
+    const { plan } = this.options;
+    const nodes = new Map<string, (state: GraphState) => Promise<Partial<GraphState>>>();
+    const edges: Array<{ from: string; to: string; condition?: (state: GraphState) => boolean }> = [];
+
+    // Create nodes for each task
+    for (const task of plan.tasks) {
+      nodes.set(task.id, this.createNodeFunction(task.id));
+    }
+
+    // Create edges
+    for (const edge of plan.edges) {
+      edges.push({
+        from: edge.from,
+        to: edge.to,
+        condition: edge.guard ? this.createGuardEvaluator(edge.guard) : undefined,
+      });
+    }
+
+    // Find entry point (task with no incoming edges)
+    const hasIncoming = new Set(plan.edges.map((e) => e.to));
+    const entryPoint = plan.tasks.find((t) => !hasIncoming.has(t.id))?.id || plan.tasks[0]?.id;
+
+    if (!entryPoint) {
+      throw new Error('No entry point found in plan');
+    }
+
+    return { nodes, edges, entryPoint };
+  }
+
+  /**
+   * Execute the plan using LangGraph (if available)
+   * 
+   * Note: This is a simplified implementation. In practice, you would use
+   * LangGraph's StateGraph API directly with the graph structure.
+   */
+  async execute(): Promise<{ outputsByTask: Record<string, any>; ledger: readonly any[] }> {
+    const { nodes, edges, entryPoint } = this.buildGraph();
+    
+    // Initialize state
+    const state: GraphState = {
+      taskId: entryPoint,
+      input: {},
+      context: this.options.context,
+      outputs: new Map(),
+    };
+
+    // Simple sequential execution based on edges
+    // In a real implementation, this would use LangGraph's execution engine
+    let currentTaskId: string | null = entryPoint;
+    const visited = new Set<string>();
+
+    while (currentTaskId && !visited.has(currentTaskId)) {
+      visited.add(currentTaskId);
+      
+      const nodeFunc = nodes.get(currentTaskId);
+      if (!nodeFunc) break;
+
+      const result = await nodeFunc(state);
+      Object.assign(state, result);
+
+      // Find next task
+      const outgoingEdges = edges.filter((e) => e.from === currentTaskId);
+      currentTaskId = null;
+
+      for (const edge of outgoingEdges) {
+        if (!edge.condition || edge.condition(state)) {
+          currentTaskId = edge.to;
+          break;
+        }
+      }
+    }
+
+    return {
+      outputsByTask: Object.fromEntries(state.outputs),
+      ledger: this.options.ledger?.getEntries() || [],
+    };
+  }
+}
+
+/**
+ * Helper function to create a LangGraph adapter
+ */
+export function asLangGraph(options: LangGraphAdapterOptions): LangGraphAdapter {
+  return new LangGraphAdapter(options);
+}