daycare-cli 0.0.0-canary.017f2bd

package/dist/engine/signals/signalMessageBuild.js

@@ -0,0 +1,20 @@
+/**
+ * Builds a stable system message payload for signal delivery.
+ * Expects: signal.id and signal.type are non-empty.
+ */
+export function signalMessageBuild(signal) {
+    const source = signalSourceLabel(signal.source);
+    const data = signal.data === undefined ? "null" : JSON.stringify(signal.data);
+    return [
+        "[signal]",
+        `id: ${signal.id}`,
+        `type: ${signal.type}`,
+        `source: ${source}`,
+        `createdAt: ${signal.createdAt}`,
+        `data: ${data}`
+    ].join("\n");
+}
+function signalSourceLabel(source) {
+    return source.id ? `${source.type}:${source.id}` : source.type;
+}
+//# sourceMappingURL=signalMessageBuild.js.map

package/dist/engine/signals/signalMessageBuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signalMessageBuild.js","sourceRoot":"","sources":["../../../sources/engine/signals/signalMessageBuild.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC7C,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE9E,OAAO;QACH,UAAU;QACV,OAAO,MAAM,CAAC,EAAE,EAAE;QAClB,SAAS,MAAM,CAAC,IAAI,EAAE;QACtB,WAAW,MAAM,EAAE;QACnB,cAAc,MAAM,CAAC,SAAS,EAAE;QAChC,SAAS,IAAI,EAAE;KAClB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAqC;IAC5D,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;AACnE,CAAC"}

package/dist/engine/signals/signalTypeMatchesPattern.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Matches a signal type against a pattern using `*` as a segment wildcard.
+ * Expects: both values are non-empty strings; `:` separates segments.
+ */
+export declare function signalTypeMatchesPattern(signalType: string, pattern: string): boolean;
+//# sourceMappingURL=signalTypeMatchesPattern.d.ts.map

package/dist/engine/signals/signalTypeMatchesPattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signalTypeMatchesPattern.d.ts","sourceRoot":"","sources":["../../../sources/engine/signals/signalTypeMatchesPattern.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAyBrF"}

package/dist/engine/signals/signalTypeMatchesPattern.js

@@ -0,0 +1,28 @@
+/**
+ * Matches a signal type against a pattern using `*` as a segment wildcard.
+ * Expects: both values are non-empty strings; `:` separates segments.
+ */
+export function signalTypeMatchesPattern(signalType, pattern) {
+    const normalizedType = signalType.trim();
+    const normalizedPattern = pattern.trim();
+    if (!normalizedType || !normalizedPattern) {
+        return false;
+    }
+    const typeSegments = normalizedType.split(":");
+    const patternSegments = normalizedPattern.split(":");
+    if (typeSegments.length !== patternSegments.length) {
+        return false;
+    }
+    for (let i = 0; i < patternSegments.length; i += 1) {
+        const patternSegment = patternSegments[i];
+        const typeSegment = typeSegments[i];
+        if (patternSegment === "*") {
+            continue;
+        }
+        if (patternSegment !== typeSegment) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=signalTypeMatchesPattern.js.map

package/dist/engine/signals/signalTypeMatchesPattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signalTypeMatchesPattern.js","sourceRoot":"","sources":["../../../sources/engine/signals/signalTypeMatchesPattern.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,UAAkB,EAAE,OAAe;IACxE,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IACzC,MAAM,iBAAiB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IACzC,IAAI,CAAC,cAAc,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,eAAe,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,YAAY,CAAC,MAAM,KAAK,eAAe,CAAC,MAAM,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,cAAc,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,cAAc,KAAK,GAAG,EAAE,CAAC;YACzB,SAAS;QACb,CAAC;QACD,IAAI,cAAc,KAAK,WAAW,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/engine/signals/signalTypeMatchesPattern.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=signalTypeMatchesPattern.spec.d.ts.map

package/dist/engine/signals/signalTypeMatchesPattern.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signalTypeMatchesPattern.spec.d.ts","sourceRoot":"","sources":["../../../sources/engine/signals/signalTypeMatchesPattern.spec.ts"],"names":[],"mappings":""}

package/dist/engine/signals/signalTypeMatchesPattern.spec.js

@@ -0,0 +1,15 @@
+import { describe, expect, it } from "vitest";
+import { signalTypeMatchesPattern } from "./signalTypeMatchesPattern.js";
+describe("signalTypeMatchesPattern", () => {
+    it("matches star segments", () => {
+        expect(signalTypeMatchesPattern("asdasd:mid:asdasd", "asdasd:*:asdasd")).toBe(true);
+    });
+    it("requires same segment count", () => {
+        expect(signalTypeMatchesPattern("a:b:c", "a:*")).toBe(false);
+    });
+    it("matches literal segments exactly", () => {
+        expect(signalTypeMatchesPattern("build:done", "build:*")).toBe(true);
+        expect(signalTypeMatchesPattern("build:done", "build:failed")).toBe(false);
+    });
+});
+//# sourceMappingURL=signalTypeMatchesPattern.spec.js.map

package/dist/engine/signals/signalTypeMatchesPattern.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signalTypeMatchesPattern.spec.js","sourceRoot":"","sources":["../../../sources/engine/signals/signalTypeMatchesPattern.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,wBAAwB,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,wBAAwB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,CAAC,wBAAwB,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/engine/signals/signalTypes.d.ts

@@ -0,0 +1,67 @@
+import type { Context } from "../agents/context.js";
+export type SignalSource = {
+    type: "system";
+    userId: string;
+} | {
+    type: "agent";
+    id: string;
+    userId: string;
+} | {
+    type: "webhook";
+    id?: string;
+    userId: string;
+} | {
+    type: "process";
+    id?: string;
+    userId: string;
+};
+export type SignalGenerateInput = {
+    type: string;
+    source: SignalSource;
+    data?: unknown;
+};
+export type Signal = {
+    id: string;
+    type: string;
+    source: SignalSource;
+    data?: unknown;
+    createdAt: number;
+};
+export type SignalSubscription = {
+    ctx: Context;
+    pattern: string;
+    silent: boolean;
+    createdAt: number;
+    updatedAt: number;
+};
+export type SignalSubscribeInput = {
+    ctx: Context;
+    pattern: string;
+    silent?: boolean;
+};
+export type SignalUnsubscribeInput = {
+    ctx: Context;
+    pattern: string;
+};
+export type DelayedSignalScheduleInput = {
+    type: string;
+    deliverAt: number;
+    source: SignalSource;
+    data?: unknown;
+    repeatKey?: string;
+};
+export type DelayedSignalCancelRepeatKeyInput = {
+    type: string;
+    repeatKey: string;
+};
+export type DelayedSignal = {
+    id: string;
+    type: string;
+    deliverAt: number;
+    source: SignalSource;
+    data?: unknown;
+    repeatKey?: string;
+    createdAt: number;
+    updatedAt: number;
+};
+//# sourceMappingURL=signalTypes.d.ts.map

package/dist/engine/signals/signalTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signalTypes.d.ts","sourceRoot":"","sources":["../../../sources/engine/signals/signalTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,MAAM,YAAY,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACjC,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/dist/engine/signals/signalTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=signalTypes.js.map

package/dist/engine/signals/signalTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signalTypes.js","sourceRoot":"","sources":["../../../sources/engine/signals/signalTypes.ts"],"names":[],"mappings":""}

package/dist/engine/signals/signals.d.ts

@@ -0,0 +1,51 @@
+import type { SignalEventsRepository } from "../../storage/signalEventsRepository.js";
+import type { SignalSubscriptionsRepository } from "../../storage/signalSubscriptionsRepository.js";
+import type { EngineEventBus } from "../ipc/events.js";
+import type { Signal, SignalGenerateInput, SignalSubscribeInput, SignalSubscription, SignalUnsubscribeInput } from "./signalTypes.js";
+type SignalsRepositoryOptions = {
+    signalEvents: Pick<SignalEventsRepository, "create" | "findAll" | "findRecentAll">;
+    signalSubscriptions: Pick<SignalSubscriptionsRepository, "create" | "delete" | "findByUserAndAgent" | "findMany" | "findMatching">;
+};
+type SignalsLegacyOptions = {
+    configDir: string;
+};
+export type SignalsOptions = {
+    eventBus: EngineEventBus;
+    onDeliver?: (signal: Signal, subscriptions: SignalSubscription[]) => Promise<void> | void;
+} & (SignalsRepositoryOptions | SignalsLegacyOptions);
+export declare class Signals {
+    private readonly eventBus;
+    private readonly signalEvents;
+    private readonly signalSubscriptions;
+    private readonly onDeliver;
+    constructor(options: SignalsOptions);
+    ensureDir(): Promise<void>;
+    /**
+     * Generates a signal event and publishes it to the engine event bus.
+     * Expects: input.type is non-empty after trim.
+     */
+    generate(input: SignalGenerateInput): Promise<Signal>;
+    subscribe(input: SignalSubscribeInput): Promise<SignalSubscription>;
+    /**
+     * Returns a subscription for an exact agent + pattern pair when present.
+     * Returns: null when no subscription exists.
+     */
+    subscriptionGet(input: SignalUnsubscribeInput): Promise<SignalSubscription | null>;
+    /**
+     * Removes an existing signal subscription for agent + pattern.
+     * Returns: true when a subscription existed and was removed.
+     */
+    unsubscribe(input: SignalUnsubscribeInput): Promise<boolean>;
+    /**
+     * Returns all active signal subscriptions as a snapshot array.
+     */
+    listSubscriptions(): Promise<SignalSubscription[]>;
+    /**
+     * Returns all persisted signal events in append order.
+     */
+    listAll(): Promise<Signal[]>;
+    listRecent(limit?: number): Promise<Signal[]>;
+    private signalDeliver;
+}
+export {};
+//# sourceMappingURL=signals.d.ts.map

package/dist/engine/signals/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../../sources/engine/signals/signals.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gDAAgD,CAAC;AAEpG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EACR,MAAM,EACN,mBAAmB,EAEnB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACzB,MAAM,kBAAkB,CAAC;AAI1B,KAAK,wBAAwB,GAAG;IAC5B,YAAY,EAAE,IAAI,CAAC,sBAAsB,EAAE,QAAQ,GAAG,SAAS,GAAG,eAAe,CAAC,CAAC;IACnF,mBAAmB,EAAE,IAAI,CACrB,6BAA6B,EAC7B,QAAQ,GAAG,QAAQ,GAAG,oBAAoB,GAAG,UAAU,GAAG,cAAc,CAC3E,CAAC;CACL,CAAC;AAEF,KAAK,oBAAoB,GAAG;IACxB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,kBAAkB,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7F,GAAG,CAAC,wBAAwB,GAAG,oBAAoB,CAAC,CAAC;AAEtD,qBAAa,OAAO;IAChB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuE;IACpG,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAGlC;IACF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;gBAE5C,OAAO,EAAE,cAAc;IAa7B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;OAGG;IACG,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAqCrD,SAAS,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgCzE;;;OAGG;IACG,eAAe,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAMxF;;;OAGG;IACG,WAAW,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlE;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAKxD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAK5B,UAAU,CAAC,KAAK,SAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAKlC,aAAa;CAU9B"}

package/dist/engine/signals/signals.js

@@ -0,0 +1,230 @@
+import path from "node:path";
+import { createId } from "@paralleldrive/cuid2";
+import { getLogger } from "../../log.js";
+import { Storage } from "../../storage/storage.js";
+const logger = getLogger("signal.facade");
+export class Signals {
+    eventBus;
+    signalEvents;
+    signalSubscriptions;
+    onDeliver;
+    constructor(options) {
+        this.eventBus = options.eventBus;
+        if ("signalEvents" in options) {
+            this.signalEvents = options.signalEvents;
+            this.signalSubscriptions = options.signalSubscriptions;
+        }
+        else {
+            const storage = Storage.open(path.join(options.configDir, "daycare.db"));
+            this.signalEvents = storage.signalEvents;
+            this.signalSubscriptions = storage.signalSubscriptions;
+        }
+        this.onDeliver = options.onDeliver;
+    }
+    async ensureDir() {
+        return Promise.resolve();
+    }
+    /**
+     * Generates a signal event and publishes it to the engine event bus.
+     * Expects: input.type is non-empty after trim.
+     */
+    async generate(input) {
+        const type = input.type.trim();
+        if (!type) {
+            throw new Error("Signal type is required");
+        }
+        const source = signalSourceNormalize(input.source);
+        const signal = {
+            id: createId(),
+            type,
+            source,
+            data: input.data,
+            createdAt: Date.now()
+        };
+        await this.signalEvents.create(signalRecordBuild(signal, source.userId));
+        this.eventBus.emit("signal.generated", signal);
+        const subscriptions = (await this.signalSubscriptions.findMatching(contextFromUserId(signal.source.userId), signal.type)).map((record) => signalSubscriptionBuild(record));
+        if (subscriptions.length > 0) {
+            await this.signalDeliver(signal, subscriptions);
+        }
+        logger.info({
+            signalId: signal.id,
+            type: signal.type,
+            sourceType: signal.source.type,
+            sourceId: "id" in signal.source ? (signal.source.id ?? null) : null
+        }, "event: Signal generated");
+        return signal;
+    }
+    async subscribe(input) {
+        const { ctx, pattern } = signalSubscriptionInputNormalize(input);
+        const now = Date.now();
+        const existing = await this.signalSubscriptions.findByUserAndAgent(ctx, pattern);
+        const subscription = existing
+            ? {
+                ...signalSubscriptionBuild(existing),
+                silent: input.silent ?? existing.silent,
+                updatedAt: now
+            }
+            : {
+                ctx: {
+                    userId: ctx.userId,
+                    agentId: ctx.agentId
+                },
+                pattern,
+                silent: input.silent ?? true,
+                createdAt: now,
+                updatedAt: now
+            };
+        await this.signalSubscriptions.create({
+            id: existing?.id ?? createId(),
+            userId: subscription.ctx.userId,
+            agentId: subscription.ctx.agentId,
+            pattern: subscription.pattern,
+            silent: subscription.silent,
+            createdAt: subscription.createdAt,
+            updatedAt: subscription.updatedAt
+        });
+        return { ...subscription };
+    }
+    /**
+     * Returns a subscription for an exact agent + pattern pair when present.
+     * Returns: null when no subscription exists.
+     */
+    async subscriptionGet(input) {
+        const { ctx, pattern } = signalSubscriptionInputNormalize(input);
+        const subscription = await this.signalSubscriptions.findByUserAndAgent(ctx, pattern);
+        return subscription ? signalSubscriptionBuild(subscription) : null;
+    }
+    /**
+     * Removes an existing signal subscription for agent + pattern.
+     * Returns: true when a subscription existed and was removed.
+     */
+    async unsubscribe(input) {
+        const { ctx, pattern } = signalSubscriptionInputNormalize(input);
+        return this.signalSubscriptions.delete(ctx, pattern);
+    }
+    /**
+     * Returns all active signal subscriptions as a snapshot array.
+     */
+    async listSubscriptions() {
+        const subscriptions = await this.signalSubscriptions.findMany();
+        return subscriptions.map((subscription) => signalSubscriptionBuild(subscription));
+    }
+    /**
+     * Returns all persisted signal events in append order.
+     */
+    async listAll() {
+        const events = await this.signalEvents.findAll();
+        return events.map((event) => signalBuild(event));
+    }
+    async listRecent(limit = 200) {
+        const events = await this.signalEvents.findRecentAll(signalLimitNormalize(limit));
+        return events.map((event) => signalBuild(event));
+    }
+    async signalDeliver(signal, subscriptions) {
+        if (!this.onDeliver) {
+            return;
+        }
+        try {
+            await this.onDeliver(signal, subscriptions);
+        }
+        catch (error) {
+            logger.warn({ signalId: signal.id, error }, "error: Signal delivery failed");
+        }
+    }
+}
+function signalSourceNormalize(source) {
+    if (source.type === "system") {
+        return { type: "system", userId: signalSourceUserIdNormalize(source.userId) };
+    }
+    if (source.type === "agent") {
+        const id = source.id.trim();
+        if (!id) {
+            throw new Error("Agent signal source id is required");
+        }
+        return { type: "agent", id, userId: signalSourceUserIdNormalize(source.userId) };
+    }
+    if (source.type === "webhook") {
+        const userId = signalSourceUserIdNormalize(source.userId);
+        return {
+            type: "webhook",
+            userId,
+            id: typeof source.id === "string" && source.id.trim().length > 0 ? source.id.trim() : undefined
+        };
+    }
+    if (source.type === "process") {
+        const userId = signalSourceUserIdNormalize(source.userId);
+        return {
+            type: "process",
+            userId,
+            id: typeof source.id === "string" && source.id.trim().length > 0 ? source.id.trim() : undefined
+        };
+    }
+    throw new Error(`Unsupported signal source type: ${source.type}`);
+}
+function signalLimitNormalize(limit) {
+    if (!Number.isFinite(limit)) {
+        return 200;
+    }
+    return Math.min(1000, Math.max(1, Math.floor(limit)));
+}
+function signalBuild(record) {
+    return {
+        id: record.id,
+        type: record.type,
+        source: record.source,
+        ...(record.data === undefined ? {} : { data: record.data }),
+        createdAt: record.createdAt
+    };
+}
+function signalRecordBuild(signal, userId) {
+    return {
+        id: signal.id,
+        userId,
+        type: signal.type,
+        source: signal.source,
+        data: signal.data,
+        createdAt: signal.createdAt
+    };
+}
+function signalSubscriptionBuild(record) {
+    return {
+        ctx: {
+            userId: record.userId,
+            agentId: record.agentId
+        },
+        pattern: record.pattern,
+        silent: record.silent,
+        createdAt: record.createdAt,
+        updatedAt: record.updatedAt
+    };
+}
+function signalSubscriptionInputNormalize(input) {
+    const userId = (input.ctx.userId ?? "").trim();
+    if (!userId) {
+        throw new Error("Signal subscription userId is required");
+    }
+    const pattern = input.pattern.trim();
+    if (!pattern) {
+        throw new Error("Signal subscription pattern is required");
+    }
+    const agentId = (input.ctx.agentId ?? "").trim();
+    if (!agentId) {
+        throw new Error("Signal subscription agentId is required");
+    }
+    return { ctx: { userId, agentId }, pattern };
+}
+function signalSourceUserIdNormalize(userId) {
+    if (typeof userId !== "string") {
+        throw new Error("Signal source userId is required");
+    }
+    const normalized = userId.trim();
+    if (!normalized) {
+        throw new Error("Signal source userId is required");
+    }
+    return normalized;
+}
+function contextFromUserId(userId) {
+    return { agentId: "signal", userId: signalSourceUserIdNormalize(userId) };
+}
+//# sourceMappingURL=signals.js.map

package/dist/engine/signals/signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.js","sourceRoot":"","sources":["../../../sources/engine/signals/signals.ts"],"names":[],"mappings":"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"}

package/dist/engine/signals/signals.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=signals.spec.d.ts.map

package/dist/engine/signals/signals.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.spec.d.ts","sourceRoot":"","sources":["../../../sources/engine/signals/signals.spec.ts"],"names":[],"mappings":""}