@agent-relay/wrapper 2.0.32 → 2.0.34

package/dist/wrapper-events.d.ts

@@ -0,0 +1,489 @@
+/**
+ * Typed Event Definitions for Agent Relay Wrapper
+ *
+ * Inspired by opencode's BusEvent pattern, this provides type-safe event
+ * definitions with Zod schema validation. Events can be used for:
+ * - Wrapper internal notifications
+ * - SDK client subscriptions
+ * - OpenAPI spec generation
+ *
+ * @example
+ * ```typescript
+ * import { RelayEvent, emitEvent, onEvent } from './wrapper-events.js';
+ *
+ * // Subscribe to events
+ * onEvent(RelayEvent.AgentConnected, (event) => {
+ *   console.log(`Agent ${event.properties.agentName} connected`);
+ * });
+ *
+ * // Emit events
+ * emitEvent(RelayEvent.AgentConnected, {
+ *   agentName: 'MyAgent',
+ *   connectionId: 'abc123',
+ * });
+ * ```
+ */
+import { z } from 'zod';
+import { EventEmitter } from 'node:events';
+/**
+ * Event definition with type and schema
+ */
+export interface EventDefinition<Type extends string = string, Schema extends z.ZodType = z.ZodType> {
+    type: Type;
+    schema: Schema;
+}
+/**
+ * Define a typed event with Zod schema validation
+ */
+export declare function defineEvent<Type extends string, Schema extends z.ZodType>(type: Type, schema: Schema): EventDefinition<Type, Schema>;
+/**
+ * Infer the properties type from an event definition
+ */
+export type EventProperties<E extends EventDefinition> = z.infer<E['schema']>;
+/**
+ * Event payload with type and properties
+ */
+export interface EventPayload<E extends EventDefinition = EventDefinition> {
+    type: E['type'];
+    properties: EventProperties<E>;
+    timestamp: number;
+}
+export declare namespace RelayEvent {
+    const AgentConnected: EventDefinition<"daemon.agent.connected", z.ZodObject<{
+        agentName: z.ZodString;
+        connectionId: z.ZodString;
+        cli: z.ZodOptional<z.ZodString>;
+        task: z.ZodOptional<z.ZodString>;
+        workingDirectory: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        agentName: string;
+        connectionId: string;
+        cli?: string | undefined;
+        task?: string | undefined;
+        workingDirectory?: string | undefined;
+    }, {
+        agentName: string;
+        connectionId: string;
+        cli?: string | undefined;
+        task?: string | undefined;
+        workingDirectory?: string | undefined;
+    }>>;
+    const AgentDisconnected: EventDefinition<"daemon.agent.disconnected", z.ZodObject<{
+        agentName: z.ZodString;
+        connectionId: z.ZodString;
+        reason: z.ZodOptional<z.ZodEnum<["clean", "error", "timeout", "replaced"]>>;
+    }, "strip", z.ZodTypeAny, {
+        agentName: string;
+        connectionId: string;
+        reason?: "error" | "timeout" | "clean" | "replaced" | undefined;
+    }, {
+        agentName: string;
+        connectionId: string;
+        reason?: "error" | "timeout" | "clean" | "replaced" | undefined;
+    }>>;
+    const AgentSpawned: EventDefinition<"daemon.agent.spawned", z.ZodObject<{
+        agentName: z.ZodString;
+        parentAgent: z.ZodString;
+        cli: z.ZodString;
+        task: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        agentName: string;
+        cli: string;
+        task: string;
+        parentAgent: string;
+    }, {
+        agentName: string;
+        cli: string;
+        task: string;
+        parentAgent: string;
+    }>>;
+    const AgentReleased: EventDefinition<"daemon.agent.released", z.ZodObject<{
+        agentName: z.ZodString;
+        releasedBy: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        agentName: string;
+        releasedBy: string;
+    }, {
+        agentName: string;
+        releasedBy: string;
+    }>>;
+    const MessageRouted: EventDefinition<"daemon.message.routed", z.ZodObject<{
+        messageId: z.ZodString;
+        from: z.ZodString;
+        to: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        bodyPreview: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        to: string;
+        from: string;
+        messageId: string;
+        kind?: string | undefined;
+        bodyPreview?: string | undefined;
+    }, {
+        to: string;
+        from: string;
+        messageId: string;
+        kind?: string | undefined;
+        bodyPreview?: string | undefined;
+    }>>;
+    const MessageDelivered: EventDefinition<"daemon.message.delivered", z.ZodObject<{
+        messageId: z.ZodString;
+        to: z.ZodString;
+        deliverySeq: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        to: string;
+        messageId: string;
+        deliverySeq: number;
+    }, {
+        to: string;
+        messageId: string;
+        deliverySeq: number;
+    }>>;
+    const MessageFailed: EventDefinition<"daemon.message.failed", z.ZodObject<{
+        messageId: z.ZodString;
+        to: z.ZodString;
+        error: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        error: string;
+        to: string;
+        messageId: string;
+    }, {
+        error: string;
+        to: string;
+        messageId: string;
+    }>>;
+    const ChannelJoined: EventDefinition<"daemon.channel.joined", z.ZodObject<{
+        channel: z.ZodString;
+        member: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        channel: string;
+        member: string;
+    }, {
+        channel: string;
+        member: string;
+    }>>;
+    const ChannelLeft: EventDefinition<"daemon.channel.left", z.ZodObject<{
+        channel: z.ZodString;
+        member: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        channel: string;
+        member: string;
+    }, {
+        channel: string;
+        member: string;
+    }>>;
+    const ChannelMessage: EventDefinition<"daemon.channel.message", z.ZodObject<{
+        channel: z.ZodString;
+        from: z.ZodString;
+        bodyPreview: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        channel: string;
+        bodyPreview?: string | undefined;
+    }, {
+        from: string;
+        channel: string;
+        bodyPreview?: string | undefined;
+    }>>;
+    const AgentProcessingStarted: EventDefinition<"daemon.agent.processing.started", z.ZodObject<{
+        agentName: z.ZodString;
+        messageId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        agentName: string;
+        messageId: string;
+    }, {
+        agentName: string;
+        messageId: string;
+    }>>;
+    const AgentProcessingEnded: EventDefinition<"daemon.agent.processing.ended", z.ZodObject<{
+        agentName: z.ZodString;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        agentName: string;
+        durationMs?: number | undefined;
+    }, {
+        agentName: string;
+        durationMs?: number | undefined;
+    }>>;
+    const ShadowBound: EventDefinition<"daemon.shadow.bound", z.ZodObject<{
+        shadowAgent: z.ZodString;
+        primaryAgent: z.ZodString;
+        speakOn: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        shadowAgent: string;
+        primaryAgent: string;
+        speakOn: string[];
+    }, {
+        shadowAgent: string;
+        primaryAgent: string;
+        speakOn: string[];
+    }>>;
+    const ShadowUnbound: EventDefinition<"daemon.shadow.unbound", z.ZodObject<{
+        shadowAgent: z.ZodString;
+        primaryAgent: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        shadowAgent: string;
+        primaryAgent: string;
+    }, {
+        shadowAgent: string;
+        primaryAgent: string;
+    }>>;
+    const DaemonStarted: EventDefinition<"daemon.system.started", z.ZodObject<{
+        socketPath: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        socketPath: string;
+        version?: string | undefined;
+    }, {
+        socketPath: string;
+        version?: string | undefined;
+    }>>;
+    const DaemonStopped: EventDefinition<"daemon.system.stopped", z.ZodObject<{
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        reason?: string | undefined;
+    }, {
+        reason?: string | undefined;
+    }>>;
+    const RateLimitExceeded: EventDefinition<"daemon.system.rate_limit_exceeded", z.ZodObject<{
+        agentName: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        agentName: string;
+    }, {
+        agentName: string;
+    }>>;
+    const all: readonly [EventDefinition<"daemon.agent.connected", z.ZodObject<{
+        agentName: z.ZodString;
+        connectionId: z.ZodString;
+        cli: z.ZodOptional<z.ZodString>;
+        task: z.ZodOptional<z.ZodString>;
+        workingDirectory: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        agentName: string;
+        connectionId: string;
+        cli?: string | undefined;
+        task?: string | undefined;
+        workingDirectory?: string | undefined;
+    }, {
+        agentName: string;
+        connectionId: string;
+        cli?: string | undefined;
+        task?: string | undefined;
+        workingDirectory?: string | undefined;
+    }>>, EventDefinition<"daemon.agent.disconnected", z.ZodObject<{
+        agentName: z.ZodString;
+        connectionId: z.ZodString;
+        reason: z.ZodOptional<z.ZodEnum<["clean", "error", "timeout", "replaced"]>>;
+    }, "strip", z.ZodTypeAny, {
+        agentName: string;
+        connectionId: string;
+        reason?: "error" | "timeout" | "clean" | "replaced" | undefined;
+    }, {
+        agentName: string;
+        connectionId: string;
+        reason?: "error" | "timeout" | "clean" | "replaced" | undefined;
+    }>>, EventDefinition<"daemon.agent.spawned", z.ZodObject<{
+        agentName: z.ZodString;
+        parentAgent: z.ZodString;
+        cli: z.ZodString;
+        task: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        agentName: string;
+        cli: string;
+        task: string;
+        parentAgent: string;
+    }, {
+        agentName: string;
+        cli: string;
+        task: string;
+        parentAgent: string;
+    }>>, EventDefinition<"daemon.agent.released", z.ZodObject<{
+        agentName: z.ZodString;
+        releasedBy: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        agentName: string;
+        releasedBy: string;
+    }, {
+        agentName: string;
+        releasedBy: string;
+    }>>, EventDefinition<"daemon.message.routed", z.ZodObject<{
+        messageId: z.ZodString;
+        from: z.ZodString;
+        to: z.ZodString;
+        kind: z.ZodOptional<z.ZodString>;
+        bodyPreview: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        to: string;
+        from: string;
+        messageId: string;
+        kind?: string | undefined;
+        bodyPreview?: string | undefined;
+    }, {
+        to: string;
+        from: string;
+        messageId: string;
+        kind?: string | undefined;
+        bodyPreview?: string | undefined;
+    }>>, EventDefinition<"daemon.message.delivered", z.ZodObject<{
+        messageId: z.ZodString;
+        to: z.ZodString;
+        deliverySeq: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        to: string;
+        messageId: string;
+        deliverySeq: number;
+    }, {
+        to: string;
+        messageId: string;
+        deliverySeq: number;
+    }>>, EventDefinition<"daemon.message.failed", z.ZodObject<{
+        messageId: z.ZodString;
+        to: z.ZodString;
+        error: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        error: string;
+        to: string;
+        messageId: string;
+    }, {
+        error: string;
+        to: string;
+        messageId: string;
+    }>>, EventDefinition<"daemon.channel.joined", z.ZodObject<{
+        channel: z.ZodString;
+        member: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        channel: string;
+        member: string;
+    }, {
+        channel: string;
+        member: string;
+    }>>, EventDefinition<"daemon.channel.left", z.ZodObject<{
+        channel: z.ZodString;
+        member: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        channel: string;
+        member: string;
+    }, {
+        channel: string;
+        member: string;
+    }>>, EventDefinition<"daemon.channel.message", z.ZodObject<{
+        channel: z.ZodString;
+        from: z.ZodString;
+        bodyPreview: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        channel: string;
+        bodyPreview?: string | undefined;
+    }, {
+        from: string;
+        channel: string;
+        bodyPreview?: string | undefined;
+    }>>, EventDefinition<"daemon.agent.processing.started", z.ZodObject<{
+        agentName: z.ZodString;
+        messageId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        agentName: string;
+        messageId: string;
+    }, {
+        agentName: string;
+        messageId: string;
+    }>>, EventDefinition<"daemon.agent.processing.ended", z.ZodObject<{
+        agentName: z.ZodString;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        agentName: string;
+        durationMs?: number | undefined;
+    }, {
+        agentName: string;
+        durationMs?: number | undefined;
+    }>>, EventDefinition<"daemon.shadow.bound", z.ZodObject<{
+        shadowAgent: z.ZodString;
+        primaryAgent: z.ZodString;
+        speakOn: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        shadowAgent: string;
+        primaryAgent: string;
+        speakOn: string[];
+    }, {
+        shadowAgent: string;
+        primaryAgent: string;
+        speakOn: string[];
+    }>>, EventDefinition<"daemon.shadow.unbound", z.ZodObject<{
+        shadowAgent: z.ZodString;
+        primaryAgent: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        shadowAgent: string;
+        primaryAgent: string;
+    }, {
+        shadowAgent: string;
+        primaryAgent: string;
+    }>>, EventDefinition<"daemon.system.started", z.ZodObject<{
+        socketPath: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        socketPath: string;
+        version?: string | undefined;
+    }, {
+        socketPath: string;
+        version?: string | undefined;
+    }>>, EventDefinition<"daemon.system.stopped", z.ZodObject<{
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        reason?: string | undefined;
+    }, {
+        reason?: string | undefined;
+    }>>, EventDefinition<"daemon.system.rate_limit_exceeded", z.ZodObject<{
+        agentName: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        agentName: string;
+    }, {
+        agentName: string;
+    }>>];
+}
+/**
+ * Type-safe event bus for daemon events
+ */
+declare class RelayEventBus extends EventEmitter {
+    private static instance;
+    private constructor();
+    static getInstance(): RelayEventBus;
+    /**
+     * Emit a typed event
+     */
+    emitEvent<E extends EventDefinition>(definition: E, properties: EventProperties<E>): void;
+    /**
+     * Subscribe to a typed event
+     */
+    onEvent<E extends EventDefinition>(definition: E, callback: (event: EventPayload<E>) => void): () => void;
+    /**
+     * Subscribe to all events (wildcard)
+     */
+    onAnyEvent(callback: (event: EventPayload) => void): () => void;
+    /**
+     * Subscribe to an event once
+     */
+    onceEvent<E extends EventDefinition>(definition: E, callback: (event: EventPayload<E>) => void): void;
+}
+/**
+ * Global daemon event bus instance
+ */
+export declare const relayEventBus: RelayEventBus;
+/**
+ * Emit a daemon event
+ */
+export declare function emitEvent<E extends EventDefinition>(definition: E, properties: EventProperties<E>): void;
+/**
+ * Subscribe to a daemon event
+ */
+export declare function onEvent<E extends EventDefinition>(definition: E, callback: (event: EventPayload<E>) => void): () => void;
+/**
+ * Subscribe to all daemon events
+ */
+export declare function onAnyEvent(callback: (event: EventPayload) => void): () => void;
+/**
+ * Generate OpenAPI-compatible schema for all daemon events
+ * This can be used to auto-generate SDK types
+ */
+export declare function generateEventSchemas(): Record<string, unknown>;
+export {};
+//# sourceMappingURL=wrapper-events.d.ts.map

package/dist/wrapper-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper-events.d.ts","sourceRoot":"","sources":["../src/wrapper-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C;;GAEG;AACH,MAAM,WAAW,eAAe,CAC9B,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,MAAM,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAEpC,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,SAAS,CAAC,CAAC,OAAO,EACvE,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,GACb,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAE/B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe;IACvE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAChB,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,yBAAiB,UAAU,CAAC;IAGnB,MAAM,cAAc;;;;;;;;;;;;;;;;;;OAS1B,CAAC;IAEK,MAAM,iBAAiB;;;;;;;;;;;;OAO7B,CAAC;IAEK,MAAM,YAAY;;;;;;;;;;;;;;;OAQxB,CAAC;IAEK,MAAM,aAAa;;;;;;;;;OAMzB,CAAC;IAIK,MAAM,aAAa;;;;;;;;;;;;;;;;;;OASzB,CAAC;IAEK,MAAM,gBAAgB;;;;;;;;;;;;OAO5B,CAAC;IAEK,MAAM,aAAa;;;;;;;;;;;;OAOzB,CAAC;IAIK,MAAM,aAAa;;;;;;;;;OAMzB,CAAC;IAEK,MAAM,WAAW;;;;;;;;;OAMvB,CAAC;IAEK,MAAM,cAAc;;;;;;;;;;;;OAO1B,CAAC;IAIK,MAAM,sBAAsB;;;;;;;;;OAMlC,CAAC;IAEK,MAAM,oBAAoB;;;;;;;;;OAMhC,CAAC;IAIK,MAAM,WAAW;;;;;;;;;;;;OAOvB,CAAC;IAEK,MAAM,aAAa;;;;;;;;;OAMzB,CAAC;IAIK,MAAM,aAAa;;;;;;;;;OAMzB,CAAC;IAEK,MAAM,aAAa;;;;;;OAKzB,CAAC;IAEK,MAAM,iBAAiB;;;;;;OAK7B,CAAC;IAIK,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAkBN,CAAC;CACZ;AAMD;;GAEG;AACH,cAAM,aAAc,SAAQ,YAAY;IACtC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IAEvC,OAAO;IAKP,MAAM,CAAC,WAAW,IAAI,aAAa;IAOnC;;OAEG;IACH,SAAS,CAAC,CAAC,SAAS,eAAe,EACjC,UAAU,EAAE,CAAC,EACb,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,GAC7B,IAAI;IAmBP;;OAEG;IACH,OAAO,CAAC,CAAC,SAAS,eAAe,EAC/B,UAAU,EAAE,CAAC,EACb,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GACzC,MAAM,IAAI;IAKb;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI;IAK/D;;OAEG;IACH,SAAS,CAAC,CAAC,SAAS,eAAe,EACjC,UAAU,EAAE,CAAC,EACb,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GACzC,IAAI;CAGR;AAMD;;GAEG;AACH,eAAO,MAAM,aAAa,eAA8B,CAAC;AAEzD;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,eAAe,EACjD,UAAU,EAAE,CAAC,EACb,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,GAC7B,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,eAAe,EAC/C,UAAU,EAAE,CAAC,EACb,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GACzC,MAAM,IAAI,CAEZ;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAE9E;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkB9D"}