@fabric-harness/sdk 1.3.0 → 1.4.0

package/dist/webhook-subscription.d.ts

@@ -0,0 +1,54 @@
+import type { JsonObject } from './types.js';
+/**
+ * Generic webhook subscription primitive — wakes an agent on inbound events
+ * from any external system (event bus, queue, scheduler, third-party SaaS
+ * webhook, your own application's domain events). fabric-harness consumes a
+ * JSON payload and dispatches to the user-provided handler. The host event
+ * system decides which payloads land here; fabric-harness has no opinion on
+ * event taxonomy or producer.
+ */
+export interface WebhookSubscriptionContext<TPayload> {
+    /** Validated payload (or raw, if no schema was supplied). */
+    payload: TPayload;
+    /** Inbound HTTP headers (lowercased keys). */
+    headers: Record<string, string>;
+    /** Aborts when the request is cancelled (client disconnect, timeout). */
+    signal: AbortSignal;
+    /** Echoed event-pattern hint when supplied by the producer. */
+    eventType?: string;
+    /** Optional idempotency key from the inbound request. */
+    idempotencyKey?: string;
+}
+export interface WebhookSubscriptionDefinition<TPayload> {
+    id: string;
+    events?: string[];
+    schema?: unknown;
+    description?: string;
+    handler: (ctx: WebhookSubscriptionContext<TPayload>) => Promise<unknown>;
+}
+/**
+ * Helper that returns the definition unchanged. Useful for type inference and
+ * to keep agent files declarative.
+ *
+ * ```ts
+ * import { agent, defineWebhookSubscription } from '@fabric-harness/sdk';
+ *
+ * export default agent({
+ *   name: 'data-validator',
+ *   triggers: { webhook: true },
+ *   subscriptions: [
+ *     defineWebhookSubscription<{ recordId: string }>({
+ *       id: 'on-record-created',
+ *       events: ['record.created'],
+ *       schema: { type: 'object', properties: { recordId: { type: 'string' } }, required: ['recordId'] },
+ *       handler: async ({ payload }) => {
+ *         // ...invoke whatever your host application exposes.
+ *       },
+ *     }),
+ *   ],
+ *   async run() { ... },
+ * });
+ * ```
+ */
+export declare function defineWebhookSubscription<TPayload = JsonObject>(definition: WebhookSubscriptionDefinition<TPayload>): WebhookSubscriptionDefinition<TPayload>;
+//# sourceMappingURL=webhook-subscription.d.ts.map

package/dist/webhook-subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-subscription.d.ts","sourceRoot":"","sources":["../src/webhook-subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;GAOG;AAEH,MAAM,WAAW,0BAA0B,CAAC,QAAQ;IAClD,6DAA6D;IAC7D,OAAO,EAAE,QAAQ,CAAC;IAClB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,yEAAyE;IACzE,MAAM,EAAE,WAAW,CAAC;IACpB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,6BAA6B,CAAC,QAAQ;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,CAAC,GAAG,EAAE,0BAA0B,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,GAAG,UAAU,EAC7D,UAAU,EAAE,6BAA6B,CAAC,QAAQ,CAAC,GAClD,6BAA6B,CAAC,QAAQ,CAAC,CAGzC"}

package/dist/webhook-subscription.js

@@ -0,0 +1,30 @@
+/**
+ * Helper that returns the definition unchanged. Useful for type inference and
+ * to keep agent files declarative.
+ *
+ * ```ts
+ * import { agent, defineWebhookSubscription } from '@fabric-harness/sdk';
+ *
+ * export default agent({
+ *   name: 'data-validator',
+ *   triggers: { webhook: true },
+ *   subscriptions: [
+ *     defineWebhookSubscription<{ recordId: string }>({
+ *       id: 'on-record-created',
+ *       events: ['record.created'],
+ *       schema: { type: 'object', properties: { recordId: { type: 'string' } }, required: ['recordId'] },
+ *       handler: async ({ payload }) => {
+ *         // ...invoke whatever your host application exposes.
+ *       },
+ *     }),
+ *   ],
+ *   async run() { ... },
+ * });
+ * ```
+ */
+export function defineWebhookSubscription(definition) {
+    if (!definition.id)
+        throw new Error('defineWebhookSubscription: id is required.');
+    return definition;
+}
+//# sourceMappingURL=webhook-subscription.js.map

package/dist/webhook-subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-subscription.js","sourceRoot":"","sources":["../src/webhook-subscription.ts"],"names":[],"mappings":"AAgCA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAAmD;IAEnD,IAAI,CAAC,UAAU,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAClF,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabric-harness/sdk",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Headless TypeScript framework for building durable, deployable autonomous agents — core SDK.",
   "license": "Apache-2.0",
   "author": "Fabric",