@weavelogic/knowledge-graph-agent 0.2.0 → 0.4.0

package/dist/workflow/adapters/goap-adapter.d.ts

@@ -0,0 +1,196 @@
+/**
+ * GOAP Adapter
+ *
+ * Adapts the existing goal-planner agent for use with Workflow DevKit.
+ * Provides A* search-based planning with OODA loop integration.
+ *
+ * @module workflow/adapters/goap-adapter
+ */
+import type { WorldState, GOAPAction, GOAPGoal, GOAPPlan, PlanExecutionResult, ReadinessEvaluation } from '../types.js';
+/**
+ * GOAP Adapter configuration
+ */
+export interface GOAPAdapterConfig {
+    /** Maximum planning iterations */
+    maxIterations?: number;
+    /** Planning timeout in ms */
+    timeoutMs?: number;
+    /** Default action cost */
+    defaultCost?: number;
+    /** Enable plan caching */
+    enableCaching?: boolean;
+    /** Maximum plan length */
+    maxPlanLength?: number;
+    /** Custom actions to register */
+    actions?: GOAPAction[];
+    /** Custom heuristic function */
+    heuristic?: (state: WorldState, goal: Partial<WorldState>) => number;
+    /** Logger function */
+    logger?: (level: string, message: string, data?: Record<string, unknown>) => void;
+}
+/**
+ * Default GOAP actions for knowledge graph workflows
+ *
+ * These actions represent common development workflow operations
+ * and can be extended or replaced with custom actions.
+ */
+export declare const DEFAULT_GOAP_ACTIONS: GOAPAction[];
+/**
+ * GOAP Adapter class
+ *
+ * Implements Goal-Oriented Action Planning using A* search algorithm.
+ * Integrates with the existing goal-planner agent patterns.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new GOAPAdapter({
+ *   actions: DEFAULT_GOAP_ACTIONS,
+ *   maxIterations: 1000,
+ * });
+ *
+ * const plan = await adapter.createPlan(worldState, 'start-development');
+ * if (plan.achievable) {
+ *   const result = await adapter.executePlan(plan, worldState);
+ *   console.log('Execution result:', result);
+ * }
+ * ```
+ */
+export declare class GOAPAdapter {
+    private config;
+    private actions;
+    private goals;
+    private planCache;
+    private customHeuristic?;
+    constructor(config?: GOAPAdapterConfig);
+    /**
+     * Register default actions for documentation workflows
+     */
+    private registerDefaultActions;
+    /**
+     * Register default goals
+     */
+    private registerDefaultGoals;
+    /**
+     * Register an action
+     *
+     * @param action - Action definition to register
+     */
+    registerAction(action: GOAPAction): void;
+    /**
+     * Register a goal
+     *
+     * @param goal - Goal definition to register
+     */
+    registerGoal(goal: GOAPGoal): void;
+    /**
+     * Get a registered action by ID
+     *
+     * @param actionId - Action identifier
+     * @returns Action definition or undefined
+     */
+    getAction(actionId: string): GOAPAction | undefined;
+    /**
+     * Get a registered goal by ID
+     *
+     * @param goalId - Goal identifier
+     * @returns Goal definition or undefined
+     */
+    getGoal(goalId: string): GOAPGoal | undefined;
+    /**
+     * Get all registered actions
+     *
+     * @returns Array of action definitions
+     */
+    getActions(): GOAPAction[];
+    /**
+     * Get all registered goals
+     *
+     * @returns Array of goal definitions
+     */
+    getGoals(): GOAPGoal[];
+    /**
+     * Create a plan to achieve a goal from the current state
+     *
+     * @param currentState - Current world state
+     * @param goalId - Goal to achieve
+     * @returns Plan to achieve the goal
+     */
+    createPlan(currentState: WorldState, goalId: string): GOAPPlan;
+    /**
+     * A* search algorithm for plan finding
+     *
+     * Uses a binary heap priority queue for efficient O(log n) operations.
+     * Implements proper path reconstruction using parent node references.
+     */
+    private aStarSearch;
+    /**
+     * Reconstruct the plan from the goal node by following parent references
+     *
+     * @param goalNode - The node that reached the goal
+     * @param goal - The goal definition
+     * @returns Complete GOAP plan
+     */
+    private reconstructPlan;
+    /**
+     * Heuristic function for A* (estimates cost to goal)
+     *
+     * Uses Manhattan-like distance for numeric values and
+     * fixed penalties for boolean mismatches.
+     *
+     * @param state - Current world state
+     * @param goal - Goal to reach
+     * @returns Estimated cost to reach goal
+     */
+    private heuristic;
+    /**
+     * Check if a goal is satisfied by the current state
+     */
+    private isGoalSatisfied;
+    /**
+     * Check if an action can be applied to a state
+     */
+    private canApply;
+    /**
+     * Apply an action to a state and return the new state
+     */
+    private applyAction;
+    /**
+     * Convert state to a cache key string
+     */
+    private stateToKey;
+    /**
+     * Create cache key for a plan
+     */
+    private createCacheKey;
+    /**
+     * Cache a plan
+     */
+    private cachePlan;
+    /**
+     * Clear the plan cache
+     */
+    clearCache(): void;
+    /**
+     * Execute a plan
+     *
+     * @param plan - Plan to execute
+     * @param initialState - Initial world state
+     * @returns Execution result
+     */
+    executePlan(plan: GOAPPlan, initialState: WorldState): Promise<PlanExecutionResult>;
+    /**
+     * Evaluate readiness for development
+     *
+     * @param state - Current world state
+     * @returns Readiness evaluation
+     */
+    evaluateReadiness(state: WorldState): ReadinessEvaluation;
+}
+/**
+ * Create a GOAP adapter instance
+ *
+ * @param config - Adapter configuration
+ * @returns Configured GOAP adapter
+ */
+export declare function createGOAPAdapter(config?: GOAPAdapterConfig): GOAPAdapter;
+//# sourceMappingURL=goap-adapter.d.ts.map

package/dist/workflow/adapters/goap-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goap-adapter.d.ts","sourceRoot":"","sources":["../../../src/workflow/adapters/goap-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAuKrB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,gCAAgC;IAChC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,MAAM,CAAC;IACrE,sBAAsB;IACtB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACnF;AAMD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAAU,EA4E5C,CAAC;AAMF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAwE;IACtF,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,eAAe,CAAC,CAA2D;gBAEvE,MAAM,GAAE,iBAAsB;IAuB1C;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2F9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAsC5B;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAKxC;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAKlC;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAInD;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAI7C;;;;OAIG;IACH,UAAU,IAAI,UAAU,EAAE;IAI1B;;;;OAIG;IACH,QAAQ,IAAI,QAAQ,EAAE;IAItB;;;;;;OAMG;IACH,UAAU,CAAC,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ;IA2C9D;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IA6GnB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IA4BvB;;;;;;;;;OASG;IACH,OAAO,CAAC,SAAS;IAiCjB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAgBhB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,UAAU;IAMlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,SAAS;IAMjB;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;;;;;OAMG;IACG,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiFzF;;;;;OAKG;IACH,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB;CA6D1D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,WAAW,CAEzE"}