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

package/dist/queries.d.ts

@@ -1,4 +1,4 @@
-import type { ActionDef, AnyNode, ApplicationGraph, ConstraintDef, EdgeKind, Expression, ExpressionDef, FieldId, FormNode, GraphEdge, Location, NodeId, StateDef, TransitionConstraintDef, UINode, ViewNode } from '@cynodia/axiom-core';
+import type { ActionDef, AnyNode, ApplicationGraph, ConstraintDef, EdgeKind, EventDef, Expression, ExpressionDef, FieldId, FormNode, GraphEdge, IntegrationDef, IntegrationOperationDef, Location, NodeId, StateDef, TransitionConstraintDef, TriggerDef, UINode, ViewNode } from '@cynodia/axiom-core';
 export interface SubgraphRequest {
     root: NodeId;
     depth?: number;
@@ -100,6 +100,36 @@ export declare class GraphQueries {
     private derivedStatesFrom;
     private nodesWithFieldEdge;
     protected ancestors(id: NodeId): UINode[];
+    /** Every external capability domain the application declares. */
+    listIntegrations(): IntegrationDef[];
+    /** The typed operations an integration exposes, or every operation of every integration. */
+    listIntegrationOperations(integrationId?: NodeId): IntegrationOperationDef[];
+    getIntegrationOperation(id: NodeId): IntegrationOperationDef | undefined;
+    /** Actions that call an operation of this integration, directly. */
+    getActionsUsingIntegration(integrationId: NodeId): ActionDef[];
+    /** The effect-mode operations an action calls — what it can do to an external system. */
+    getEffectsForAction(actionId: NodeId): IntegrationOperationDef[];
+    /** Triggers that invoke this action. */
+    getTriggersForAction(actionId: NodeId): TriggerDef[];
+    /** The actions an event, once dispatched, invokes — following every trigger bound to it. */
+    getActionsTriggeredByEvent(eventId: NodeId): ActionDef[];
+    /** Every external capability this application can reach, and what it can do with each. */
+    getExternalDependencies(): {
+        integrations: IntegrationDef[];
+        operations: IntegrationOperationDef[];
+    };
+    /** Triggers that fire on a schedule rather than on an event or a lifecycle moment. */
+    getTimedTriggers(): TriggerDef[];
+    /** Events at least one trigger reacts to — the external/internal facts this application listens for. */
+    getWebhookEvents(): EventDef[];
+    /** Whether an ordinary client `InvokeRequest` may name this action at all. */
+    isClientInvocable(actionId: NodeId): boolean;
+    /** Whether this action accepts only trigger-, event- or effect-outcome-originated calls. */
+    isSystemOnly(actionId: NodeId): boolean;
+    /** Every action reachable only through a trigger, event or effect outcome — never a client. */
+    getSystemOnlyActions(): ActionDef[];
+    /** Triggers whose target action cannot accept the `'system'`-sourced invocation the trigger always makes. */
+    getTriggersTargetingClientOnlyActions(): TriggerDef[];
     protected enclosingViews(id: NodeId): ViewNode[];
     private resolve;
 }

package/dist/queries.js

@@ -1,4 +1,4 @@
-import { isUINode, locationFieldIds, locationRootStateId, locationSelectorFieldIds, referencedIds, } from '@cynodia/axiom-core';
+import { allowedInvocationSources, isClientInvocable as actionIsClientInvocable, isSystemOnlyAction, isUINode, locationFieldIds, locationRootStateId, locationSelectorFieldIds, referencedIds, } from '@cynodia/axiom-core';
 const READ_KINDS = ['reads', 'binds', 'derives-from'];
 const WRITE_KINDS = ['writes'];
 const CONTAINMENT_KINDS = ['contains', 'renders'];
@@ -345,6 +345,84 @@ export class GraphQueries {
         }
         return found;
     }
+    // ------------------------------------------- integrations, effects, triggers, events
+    /** Every external capability domain the application declares. */
+    listIntegrations() {
+        return this.graph.getNodesByKind('integration');
+    }
+    /** The typed operations an integration exposes, or every operation of every integration. */
+    listIntegrationOperations(integrationId) {
+        const all = this.graph.getNodesByKind('integration-operation');
+        return integrationId ? all.filter((operation) => operation.integrationId === integrationId) : all;
+    }
+    getIntegrationOperation(id) {
+        const node = this.graph.getNode(id);
+        return node?.kind === 'integration-operation' ? node : undefined;
+    }
+    /** Actions that call an operation of this integration, directly. */
+    getActionsUsingIntegration(integrationId) {
+        const operationIds = new Set(this.listIntegrationOperations(integrationId).map((operation) => operation.id));
+        return this.graph
+            .getNodesByKind('action')
+            .filter((action) => this.graph.getOutgoingEdges(action.id, { kinds: ['references'] }).some((edge) => operationIds.has(edge.to)));
+    }
+    /** The effect-mode operations an action calls — what it can do to an external system. */
+    getEffectsForAction(actionId) {
+        return this.graph
+            .getOutgoingEdges(actionId, { kinds: ['references'] })
+            .map((edge) => this.getIntegrationOperation(edge.to))
+            .filter((operation) => operation?.mode === 'effect');
+    }
+    /** Triggers that invoke this action. */
+    getTriggersForAction(actionId) {
+        return this.graph.getNodesByKind('trigger').filter((trigger) => trigger.actionId === actionId);
+    }
+    /** The actions an event, once dispatched, invokes — following every trigger bound to it. */
+    getActionsTriggeredByEvent(eventId) {
+        const triggers = this.graph
+            .getNodesByKind('trigger')
+            .filter((trigger) => trigger.when.kind === 'event' && trigger.when.eventId === eventId);
+        return this.resolve(triggers.map((trigger) => trigger.actionId)).filter((node) => node.kind === 'action');
+    }
+    /** Every external capability this application can reach, and what it can do with each. */
+    getExternalDependencies() {
+        return { integrations: this.listIntegrations(), operations: this.graph.getNodesByKind('integration-operation') };
+    }
+    /** Triggers that fire on a schedule rather than on an event or a lifecycle moment. */
+    getTimedTriggers() {
+        return this.graph
+            .getNodesByKind('trigger')
+            .filter((trigger) => trigger.when.kind === 'interval' || trigger.when.kind === 'delay');
+    }
+    /** Events at least one trigger reacts to — the external/internal facts this application listens for. */
+    getWebhookEvents() {
+        const referenced = new Set(this.graph
+            .getNodesByKind('trigger')
+            .filter((trigger) => trigger.when.kind === 'event')
+            .map((trigger) => trigger.when.eventId));
+        return this.graph.getNodesByKind('event').filter((event) => referenced.has(event.id));
+    }
+    /** Whether an ordinary client `InvokeRequest` may name this action at all. */
+    isClientInvocable(actionId) {
+        const action = this.graph.getNode(actionId);
+        return action?.kind === 'action' ? actionIsClientInvocable(action) : false;
+    }
+    /** Whether this action accepts only trigger-, event- or effect-outcome-originated calls. */
+    isSystemOnly(actionId) {
+        const action = this.graph.getNode(actionId);
+        return action?.kind === 'action' ? isSystemOnlyAction(action) : false;
+    }
+    /** Every action reachable only through a trigger, event or effect outcome — never a client. */
+    getSystemOnlyActions() {
+        return this.graph.getNodesByKind('action').filter((action) => isSystemOnlyAction(action));
+    }
+    /** Triggers whose target action cannot accept the `'system'`-sourced invocation the trigger always makes. */
+    getTriggersTargetingClientOnlyActions() {
+        return this.graph.getNodesByKind('trigger').filter((trigger) => {
+            const action = this.graph.getNode(trigger.actionId);
+            return action?.kind === 'action' && !allowedInvocationSources(action).includes('system');
+        });
+    }
     enclosingViews(id) {
         const node = this.graph.getNode(id);
         const self = node && node.kind === 'view' ? [node] : [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cynodia/axiom-agent-api",
-  "version": "0.7.0-alpha.2",
+  "version": "0.8.1-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.7.0-alpha.2"
+    "@cynodia/axiom-core": "0.8.1-alpha.1"
   },
   "scripts": {
     "build": "tsc -b tsconfig.json tsconfig.test.json",