@cynodia/axiom-agent-api 0.6.2-alpha.1 → 0.7.0-alpha.1

package/dist/queries.d.ts

@@ -1,4 +1,4 @@
-import type { ActionDef, AnyNode, ApplicationGraph, ConstraintDef, EdgeKind, Expression, FieldId, FormNode, GraphEdge, Location, NodeId, StateDef, TransitionConstraintDef, UINode, ViewNode } from '@cynodia/axiom-core';
+import type { ActionDef, AnyNode, ApplicationGraph, ConstraintDef, EdgeKind, Expression, ExpressionDef, FieldId, FormNode, GraphEdge, Location, NodeId, StateDef, TransitionConstraintDef, UINode, ViewNode } from '@cynodia/axiom-core';
 export interface SubgraphRequest {
     root: NodeId;
     depth?: number;
@@ -67,8 +67,25 @@ export declare class GraphQueries {
      * This is the query an agent uses instead of reading files.
      */
     getSubgraph(request: SubgraphRequest): Subgraph;
-    /** Ids a node's expressions reference, for dependency reporting. */
+    /**
+     * Ids a node's expressions reference, for dependency reporting.
+     *
+     * Named expressions are followed, so an answer does not change because a calculation was
+     * given a name instead of being written out.
+     */
     referencedBy(expression: Expression): NodeId[];
+    /** Every named, reusable expression in the graph. */
+    listExpressionDefinitions(): ExpressionDef[];
+    getExpressionDefinition(id: NodeId): ExpressionDef | undefined;
+    /**
+     * What uses a named expression — the question a reuse mechanism exists to make answerable.
+     *
+     * A definition with no consumers is dead weight, and one with many is a place where an
+     * edit reaches further than it looks.
+     */
+    getExpressionConsumers(id: NodeId): AnyNode[];
+    /** The states a named expression reads, its own and those of the definitions it uses. */
+    getExpressionDependencies(id: NodeId): StateDef[];
     /** Nodes that read a specific field, from the field metadata on their read edges. */
     getFieldReaders(fieldId: FieldId): AnyNode[];
     /** Nodes that write a specific field — actions and the inputs bound to it. */

package/dist/queries.js

@@ -163,9 +163,41 @@ export class GraphQueries {
         }
         return { nodes: this.resolve([...visited]), edges: [...edges.values()] };
     }
-    /** Ids a node's expressions reference, for dependency reporting. */
+    /**
+     * Ids a node's expressions reference, for dependency reporting.
+     *
+     * Named expressions are followed, so an answer does not change because a calculation was
+     * given a name instead of being written out.
+     */
     referencedBy(expression) {
-        return referencedIds(expression);
+        return referencedIds(expression, (id) => this.getExpressionDefinition(id));
+    }
+    /** Every named, reusable expression in the graph. */
+    listExpressionDefinitions() {
+        return this.graph.getNodesByKind('expression');
+    }
+    getExpressionDefinition(id) {
+        const node = this.graph.getNode(id);
+        return node?.kind === 'expression' ? node : undefined;
+    }
+    /**
+     * What uses a named expression — the question a reuse mechanism exists to make answerable.
+     *
+     * A definition with no consumers is dead weight, and one with many is a place where an
+     * edit reaches further than it looks.
+     */
+    getExpressionConsumers(id) {
+        return this.resolve(this.graph
+            .getIncomingEdges(id, { kinds: ['references'] })
+            .map((edge) => edge.from)).filter((node) => node.id !== id);
+    }
+    /** The states a named expression reads, its own and those of the definitions it uses. */
+    getExpressionDependencies(id) {
+        const definition = this.getExpressionDefinition(id);
+        if (!definition) {
+            return [];
+        }
+        return this.getDependencies(id, READ_KINDS).filter((node) => node.kind === 'state');
     }
     /** Nodes that read a specific field, from the field metadata on their read edges. */
     getFieldReaders(fieldId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cynodia/axiom-agent-api",
-  "version": "0.6.2-alpha.1",
+  "version": "0.7.0-alpha.1",
   "description": "Semantic queries and transactional graph transformations for AI agents.",
   "license": "MIT",
   "author": "AskTech AS",
@@ -31,7 +31,7 @@
     }
   },
   "dependencies": {
-    "@cynodia/axiom-core": "0.6.2-alpha.1"
+    "@cynodia/axiom-core": "0.7.0-alpha.1"
   },
   "scripts": {
     "build": "tsc -b tsconfig.json tsconfig.test.json",