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

package/dist/queries.d.ts

@@ -120,7 +120,25 @@ 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;

package/dist/queries.js

@@ -394,14 +394,34 @@ 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);

package/package.json

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