@cynodia/axiom-agent-api 0.8.0-alpha.1 → 0.8.2-alpha.1

package/dist/queries.d.ts

@@ -120,8 +120,34 @@ export declare class GraphQueries {
     };
     /** 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. */
+    /**
+     * Events at least one trigger reacts to — the internal/external facts this application
+     * listens for.
+     *
+     * This is a **graph-static** query: it answers "which `EventDef`s have a `TriggerDef`
+     * bound to them", not "which webhook deliveries has this server received". An event
+     * returned here may be dispatched by a verified external webhook, by an effect's
+     * `succeededEventId`/`failedEventId`, or by any other internal source — "webhook-ness" is
+     * not a property the graph records, so a name implying it overstates what this answers
+     * (spec 8.2 §34-35).
+     */
+    getTriggeredEvents(): EventDef[];
+    /**
+     * @deprecated Renamed to {@link getTriggeredEvents} (spec 8.2 §34-36): this answers
+     * "which events have a trigger bound to them", not "which webhook deliveries were
+     * received" — the two are not the same, since the same query covers effect-outcome
+     * events too. Kept as an alias for backward compatibility; new code should call
+     * `getTriggeredEvents()` directly.
+     */
     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'];
@@ -394,14 +394,55 @@ export class GraphQueries {
             .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() {
+    /**
+     * Events at least one trigger reacts to — the internal/external facts this application
+     * listens for.
+     *
+     * This is a **graph-static** query: it answers "which `EventDef`s have a `TriggerDef`
+     * bound to them", not "which webhook deliveries has this server received". An event
+     * returned here may be dispatched by a verified external webhook, by an effect's
+     * `succeededEventId`/`failedEventId`, or by any other internal source — "webhook-ness" is
+     * not a property the graph records, so a name implying it overstates what this answers
+     * (spec 8.2 §34-35).
+     */
+    getTriggeredEvents() {
         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));
     }
+    /**
+     * @deprecated Renamed to {@link getTriggeredEvents} (spec 8.2 §34-36): this answers
+     * "which events have a trigger bound to them", not "which webhook deliveries were
+     * received" — the two are not the same, since the same query covers effect-outcome
+     * events too. Kept as an alias for backward compatibility; new code should call
+     * `getTriggeredEvents()` directly.
+     */
+    getWebhookEvents() {
+        return this.getTriggeredEvents();
+    }
+    /** 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.8.0-alpha.1",
+  "version": "0.8.2-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.8.0-alpha.1"
+    "@cynodia/axiom-core": "0.8.2-alpha.1"
   },
   "scripts": {
     "build": "tsc -b tsconfig.json tsconfig.test.json",