@electric-ax/agents-server 0.4.7 → 0.4.11

package/dist/index.d.cts

@@ -187,7 +187,7 @@ import * as drizzle_orm_pg_core238 from "drizzle-orm/pg-core";
 import * as drizzle_orm_pg_core239 from "drizzle-orm/pg-core";
 import * as drizzle_orm73 from "drizzle-orm";
 import * as drizzle_orm74 from "drizzle-orm";
-import { EntityTags, WebhookNotification, WebhookSignatureVerifierConfig } from "@electric-ax/agents-runtime";
+import { EntityTags, EventSourceBucket, EventSourceContract, EventSourceContract as EventSourceContract$1, EventSourceFilter, EventSourceSubscription, EventSourceSubscription as EventSourceSubscription$1, EventSourceSubscriptionInput, SubscriptionLifetime, WebhookNotification, WebhookSignatureVerifierConfig } from "@electric-ax/agents-runtime";
 import "@sinclair/typebox";
 import { MaybePromise } from "@durable-streams/client";
 import { AutoRouterType, IRequest } from "itty-router";
@@ -3441,6 +3441,7 @@ interface TypedSpawnRequest {
     debounceMs?: number;
     timeoutMs?: number;
     includeResponse?: boolean;
+    manifestKey?: string;
   };
 }
 interface SendRequest {
@@ -4157,7 +4158,7 @@ declare class EntityManager {
   private syncManifestFutureSendSchedule;
   private parseEntityUrl;
   /**
-   * Deliver a message to an entity's main stream, with optional input schema
+   * Deliver a message to an entity's main stream, with optional inbox schema
    * validation.
    */
   send(entityUrl: string, req: SendRequest, opts?: {
@@ -4171,8 +4172,8 @@ declare class EntityManager {
   }): Promise<void>;
   deleteInboxMessage(entityUrl: string, key: string): Promise<void>;
   setTag(entityUrl: string, key: string, req: SetTagRequest, token: string): Promise<ElectricAgentsEntity>;
-  removeTag(entityUrl: string, key: string, token: string): Promise<ElectricAgentsEntity>;
-  registerEntitiesSource(tags: Record<string, string>): Promise<{
+  deleteTag(entityUrl: string, key: string, token: string): Promise<ElectricAgentsEntity>;
+  ensureEntitiesMembershipStream(tags: Record<string, string>): Promise<{
     sourceRef: string;
     streamUrl: string;
   }>;
@@ -4205,6 +4206,18 @@ declare class EntityManager {
   }): Promise<{
     txid: string;
   }>;
+  upsertEventSourceSubscription(entityUrl: string, req: {
+    subscription: EventSourceSubscription$1;
+    manifest: Record<string, unknown>;
+  }): Promise<{
+    txid: string;
+    subscription: EventSourceSubscription$1;
+  }>;
+  deleteEventSourceSubscription(entityUrl: string, req: {
+    id: string;
+  }): Promise<{
+    txid: string;
+  }>;
   /**
    * Register a wake subscription from a subscriber to a source entity.
    */
@@ -4250,7 +4263,7 @@ declare class EntityManager {
     status: number;
   } | null>;
   /**
-   * Add new input/output schema keys to an entity type directly in Postgres.
+   * Add new inbox/state schema keys to an entity type directly in Postgres.
    */
   amendSchemas(typeName: string, schemas: {
     inbox_schemas?: Record<string, Record<string, unknown>>;
@@ -4258,7 +4271,7 @@ declare class EntityManager {
   }): Promise<ElectricAgentsEntityType>;
   /**
    * Enrich webhook payload with entity context.
-   * Called by ElectricAgentsServer during webhook forwarding to inject entity context.
+   * Called by ElectricAgentsServer during subscription webhook dispatch to inject entity context.
    */
   enrichPayload(payload: Record<string, unknown>, consumer: {
     primary_stream: string;
@@ -4454,6 +4467,10 @@ declare function webhookSigningMetadata(signer: WebhookSigner, streamRootUrl: st
 
 //#endregion
 //#region src/routing/context.d.ts
+interface EventSourceCatalog {
+  listEventSources: () => Array<EventSourceContract$1> | Promise<Array<EventSourceContract$1>>;
+  getEventSource: (sourceKey: string) => EventSourceContract$1 | undefined | Promise<EventSourceContract$1 | undefined>;
+}
 /**
  * Per-request tenant context passed through every router and handler.
  *
@@ -4480,6 +4497,8 @@ interface TenantContext {
   streamClient: StreamClient;
   runtime: ElectricAgentsTenantRuntime;
   entityBridgeManager: EntityBridgeCoordinator;
+  eventSources?: EventSourceCatalog;
+  ensureEventSourceWakeSource?: (sourceUrl: string) => Promise<void> | void;
   isShuttingDown: () => boolean;
 }
 
@@ -4499,4 +4518,4 @@ declare class UnregisteredTenantError extends Error {
 declare function isUnregisteredTenantError(error: unknown): error is UnregisteredTenantError;
 
 //#endregion
-export { AgentsHost, AgentsHostOptions, AgentsHostTenantConfig, AgentsHostTenantRuntime, AuthenticateRequest, ConsumerClaim, DEFAULT_TENANT_ID, DispatchPolicy, DispatchTarget, DrizzleDB, DurableStreamsBearerProvider, DurableStreamsRoutingAdapter, DurableStreamsRoutingInput, Ed25519WebhookSignerOptions, ElectricAgentsEntity, ElectricAgentsEntityRow, ElectricAgentsEntityType, ElectricAgentsRunner, ElectricAgentsUser, EntityBridgeCoordinator, EntityDispatchState, EntityListFilter, EntitySignal, EntityStatus, GlobalRoutes, PgClient, Principal, PrincipalKind, PublicElectricAgentsEntity, PublicWakeNotification, RegisterEntityTypeRequest, RegisterRunnerRequest, RequestPrincipal, RunnerAdminStatus, RunnerHeartbeatRequest, RunnerKind, RunnerLiveness, SendRequest, SignalRequest, SignalResponse, SourceStreamOffset, StreamClient, StreamClientOptions, SubscriptionClaimResponse, SubscriptionCreateInput, SubscriptionResponse, SubscriptionStreamInfo, TenantContext, TypedSpawnRequest, UnregisteredTenantError, WakeNotificationRow, WebhookJwks, WebhookPublicJwk, WebhookSigner, WebhookSigningKeyInput, WebhookSigningMetadata, assertEntitySignal, assertEntityStatus, createDb, createEd25519WebhookSigner, expectedSignalStatus, getDefaultWebhookSigner, globalRouter, isTerminalEntityStatus, isUnregisteredTenantError, pathPrefixedSingleTenantDurableStreamsRoutingAdapter, rejectsNormalWrites, runMigrations, streamRootDurableStreamsRoutingAdapter, tenantRootDurableStreamsRoutingAdapter, toPublicEntity, webhookSigningMetadata };
+export { AgentsHost, AgentsHostOptions, AgentsHostTenantConfig, AgentsHostTenantRuntime, AuthenticateRequest, ConsumerClaim, DEFAULT_TENANT_ID, DispatchPolicy, DispatchTarget, DrizzleDB, DurableStreamsBearerProvider, DurableStreamsRoutingAdapter, DurableStreamsRoutingInput, Ed25519WebhookSignerOptions, ElectricAgentsEntity, ElectricAgentsEntityRow, ElectricAgentsEntityType, ElectricAgentsRunner, ElectricAgentsUser, EntityBridgeCoordinator, EntityDispatchState, EntityListFilter, EntitySignal, EntityStatus, EventSourceBucket, EventSourceCatalog, EventSourceContract, EventSourceFilter, EventSourceSubscription, EventSourceSubscriptionInput, GlobalRoutes, PgClient, Principal, PrincipalKind, PublicElectricAgentsEntity, PublicWakeNotification, RegisterEntityTypeRequest, RegisterRunnerRequest, RequestPrincipal, RunnerAdminStatus, RunnerHeartbeatRequest, RunnerKind, RunnerLiveness, SendRequest, SignalRequest, SignalResponse, SourceStreamOffset, StreamClient, StreamClientOptions, SubscriptionClaimResponse, SubscriptionCreateInput, SubscriptionLifetime, SubscriptionResponse, SubscriptionStreamInfo, TenantContext, TypedSpawnRequest, UnregisteredTenantError, WakeNotificationRow, WebhookJwks, WebhookPublicJwk, WebhookSigner, WebhookSigningKeyInput, WebhookSigningMetadata, assertEntitySignal, assertEntityStatus, createDb, createEd25519WebhookSigner, expectedSignalStatus, getDefaultWebhookSigner, globalRouter, isTerminalEntityStatus, isUnregisteredTenantError, pathPrefixedSingleTenantDurableStreamsRoutingAdapter, rejectsNormalWrites, runMigrations, streamRootDurableStreamsRoutingAdapter, tenantRootDurableStreamsRoutingAdapter, toPublicEntity, webhookSigningMetadata };

package/dist/index.d.ts

@@ -189,7 +189,7 @@ import * as drizzle_orm_pg_core237 from "drizzle-orm/pg-core";
 import * as drizzle_orm_pg_core238 from "drizzle-orm/pg-core";
 import * as drizzle_orm_pg_core239 from "drizzle-orm/pg-core";
 import { JsonWebKey, KeyObject } from "node:crypto";
-import { EntityTags, WebhookNotification, WebhookSignatureVerifierConfig } from "@electric-ax/agents-runtime";
+import { EntityTags, EventSourceBucket, EventSourceContract, EventSourceContract as EventSourceContract$1, EventSourceFilter, EventSourceSubscription, EventSourceSubscription as EventSourceSubscription$1, EventSourceSubscriptionInput, SubscriptionLifetime, WebhookNotification, WebhookSignatureVerifierConfig } from "@electric-ax/agents-runtime";
 import { MaybePromise } from "@durable-streams/client";
 import "@sinclair/typebox";
 import { AutoRouterType, IRequest } from "itty-router";
@@ -3442,6 +3442,7 @@ interface TypedSpawnRequest {
     debounceMs?: number;
     timeoutMs?: number;
     includeResponse?: boolean;
+    manifestKey?: string;
   };
 }
 interface SendRequest {
@@ -4158,7 +4159,7 @@ declare class EntityManager {
   private syncManifestFutureSendSchedule;
   private parseEntityUrl;
   /**
-   * Deliver a message to an entity's main stream, with optional input schema
+   * Deliver a message to an entity's main stream, with optional inbox schema
    * validation.
    */
   send(entityUrl: string, req: SendRequest, opts?: {
@@ -4172,8 +4173,8 @@ declare class EntityManager {
   }): Promise<void>;
   deleteInboxMessage(entityUrl: string, key: string): Promise<void>;
   setTag(entityUrl: string, key: string, req: SetTagRequest, token: string): Promise<ElectricAgentsEntity>;
-  removeTag(entityUrl: string, key: string, token: string): Promise<ElectricAgentsEntity>;
-  registerEntitiesSource(tags: Record<string, string>): Promise<{
+  deleteTag(entityUrl: string, key: string, token: string): Promise<ElectricAgentsEntity>;
+  ensureEntitiesMembershipStream(tags: Record<string, string>): Promise<{
     sourceRef: string;
     streamUrl: string;
   }>;
@@ -4206,6 +4207,18 @@ declare class EntityManager {
   }): Promise<{
     txid: string;
   }>;
+  upsertEventSourceSubscription(entityUrl: string, req: {
+    subscription: EventSourceSubscription$1;
+    manifest: Record<string, unknown>;
+  }): Promise<{
+    txid: string;
+    subscription: EventSourceSubscription$1;
+  }>;
+  deleteEventSourceSubscription(entityUrl: string, req: {
+    id: string;
+  }): Promise<{
+    txid: string;
+  }>;
   /**
    * Register a wake subscription from a subscriber to a source entity.
    */
@@ -4251,7 +4264,7 @@ declare class EntityManager {
     status: number;
   } | null>;
   /**
-   * Add new input/output schema keys to an entity type directly in Postgres.
+   * Add new inbox/state schema keys to an entity type directly in Postgres.
    */
   amendSchemas(typeName: string, schemas: {
     inbox_schemas?: Record<string, Record<string, unknown>>;
@@ -4259,7 +4272,7 @@ declare class EntityManager {
   }): Promise<ElectricAgentsEntityType>;
   /**
    * Enrich webhook payload with entity context.
-   * Called by ElectricAgentsServer during webhook forwarding to inject entity context.
+   * Called by ElectricAgentsServer during subscription webhook dispatch to inject entity context.
    */
   enrichPayload(payload: Record<string, unknown>, consumer: {
     primary_stream: string;
@@ -4455,6 +4468,10 @@ declare function webhookSigningMetadata(signer: WebhookSigner, streamRootUrl: st
 
 //#endregion
 //#region src/routing/context.d.ts
+interface EventSourceCatalog {
+  listEventSources: () => Array<EventSourceContract$1> | Promise<Array<EventSourceContract$1>>;
+  getEventSource: (sourceKey: string) => EventSourceContract$1 | undefined | Promise<EventSourceContract$1 | undefined>;
+}
 /**
  * Per-request tenant context passed through every router and handler.
  *
@@ -4481,6 +4498,8 @@ interface TenantContext {
   streamClient: StreamClient;
   runtime: ElectricAgentsTenantRuntime;
   entityBridgeManager: EntityBridgeCoordinator;
+  eventSources?: EventSourceCatalog;
+  ensureEventSourceWakeSource?: (sourceUrl: string) => Promise<void> | void;
   isShuttingDown: () => boolean;
 }
 
@@ -4500,4 +4519,4 @@ declare class UnregisteredTenantError extends Error {
 declare function isUnregisteredTenantError(error: unknown): error is UnregisteredTenantError;
 
 //#endregion
-export { AgentsHost, AgentsHostOptions, AgentsHostTenantConfig, AgentsHostTenantRuntime, AuthenticateRequest, ConsumerClaim, DEFAULT_TENANT_ID, DispatchPolicy, DispatchTarget, DrizzleDB, DurableStreamsBearerProvider, DurableStreamsRoutingAdapter, DurableStreamsRoutingInput, Ed25519WebhookSignerOptions, ElectricAgentsEntity, ElectricAgentsEntityRow, ElectricAgentsEntityType, ElectricAgentsRunner, ElectricAgentsUser, EntityBridgeCoordinator, EntityDispatchState, EntityListFilter, EntitySignal, EntityStatus, GlobalRoutes, PgClient, Principal, PrincipalKind, PublicElectricAgentsEntity, PublicWakeNotification, RegisterEntityTypeRequest, RegisterRunnerRequest, RequestPrincipal, RunnerAdminStatus, RunnerHeartbeatRequest, RunnerKind, RunnerLiveness, SendRequest, SignalRequest, SignalResponse, SourceStreamOffset, StreamClient, StreamClientOptions, SubscriptionClaimResponse, SubscriptionCreateInput, SubscriptionResponse, SubscriptionStreamInfo, TenantContext, TypedSpawnRequest, UnregisteredTenantError, WakeNotificationRow, WebhookJwks, WebhookPublicJwk, WebhookSigner, WebhookSigningKeyInput, WebhookSigningMetadata, assertEntitySignal, assertEntityStatus, createDb, createEd25519WebhookSigner, expectedSignalStatus, getDefaultWebhookSigner, globalRouter, isTerminalEntityStatus, isUnregisteredTenantError, pathPrefixedSingleTenantDurableStreamsRoutingAdapter, rejectsNormalWrites, runMigrations, streamRootDurableStreamsRoutingAdapter, tenantRootDurableStreamsRoutingAdapter, toPublicEntity, webhookSigningMetadata };
+export { AgentsHost, AgentsHostOptions, AgentsHostTenantConfig, AgentsHostTenantRuntime, AuthenticateRequest, ConsumerClaim, DEFAULT_TENANT_ID, DispatchPolicy, DispatchTarget, DrizzleDB, DurableStreamsBearerProvider, DurableStreamsRoutingAdapter, DurableStreamsRoutingInput, Ed25519WebhookSignerOptions, ElectricAgentsEntity, ElectricAgentsEntityRow, ElectricAgentsEntityType, ElectricAgentsRunner, ElectricAgentsUser, EntityBridgeCoordinator, EntityDispatchState, EntityListFilter, EntitySignal, EntityStatus, EventSourceBucket, EventSourceCatalog, EventSourceContract, EventSourceFilter, EventSourceSubscription, EventSourceSubscriptionInput, GlobalRoutes, PgClient, Principal, PrincipalKind, PublicElectricAgentsEntity, PublicWakeNotification, RegisterEntityTypeRequest, RegisterRunnerRequest, RequestPrincipal, RunnerAdminStatus, RunnerHeartbeatRequest, RunnerKind, RunnerLiveness, SendRequest, SignalRequest, SignalResponse, SourceStreamOffset, StreamClient, StreamClientOptions, SubscriptionClaimResponse, SubscriptionCreateInput, SubscriptionLifetime, SubscriptionResponse, SubscriptionStreamInfo, TenantContext, TypedSpawnRequest, UnregisteredTenantError, WakeNotificationRow, WebhookJwks, WebhookPublicJwk, WebhookSigner, WebhookSigningKeyInput, WebhookSigningMetadata, assertEntitySignal, assertEntityStatus, createDb, createEd25519WebhookSigner, expectedSignalStatus, getDefaultWebhookSigner, globalRouter, isTerminalEntityStatus, isUnregisteredTenantError, pathPrefixedSingleTenantDurableStreamsRoutingAdapter, rejectsNormalWrites, runMigrations, streamRootDurableStreamsRoutingAdapter, tenantRootDurableStreamsRoutingAdapter, toPublicEntity, webhookSigningMetadata };