pulseed 0.2.0 → 0.4.0

package/dist/runtime/gateway/ingress-gateway.js.map

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

package/dist/runtime/gateway/slack-channel-adapter.d.ts

@@ -0,0 +1,45 @@
+import type { ChannelAdapter, EnvelopeHandler } from "./channel-adapter.js";
+export interface SlackChannelAdapterConfig {
+    signingSecret: string;
+    /** Optional: map Slack channel IDs to PulSeed goal IDs */
+    channelGoalMap?: Record<string, string>;
+}
+export interface SlackResponse {
+    status: number;
+    body: string;
+}
+/**
+ * SlackChannelAdapter receives events from the Slack Events API.
+ *
+ * This adapter is passive — it does NOT create its own HTTP server.
+ * Wire `handleRequest()` into your existing HTTP server's route handler.
+ *
+ * Outbound Slack notifications are handled by `src/runtime/channels/slack-channel.ts`.
+ */
+export declare class SlackChannelAdapter implements ChannelAdapter {
+    readonly name = "slack";
+    private handler;
+    private readonly config;
+    constructor(config: SlackChannelAdapterConfig);
+    onEnvelope(handler: EnvelopeHandler): void;
+    /** No-op: adapter is driven by external HTTP server */
+    start(): Promise<void>;
+    /** No-op: no resources to release */
+    stop(): Promise<void>;
+    /**
+     * Handle a raw Slack Events API HTTP request.
+     * Call this from your HTTP server's POST route handler.
+     *
+     * @param body - Raw request body string
+     * @param headers - Request headers (lowercase keys expected)
+     * @returns HTTP response to send back to Slack
+     */
+    handleRequest(body: string, headers: Record<string, string>): SlackResponse;
+    /**
+     * Verify Slack request signature.
+     * Returns a SlackResponse on failure, null on success.
+     */
+    private verifySignature;
+    private handleEventCallback;
+}
+//# sourceMappingURL=slack-channel-adapter.d.ts.map

package/dist/runtime/gateway/slack-channel-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-channel-adapter.d.ts","sourceRoot":"","sources":["../../../src/runtime/gateway/slack-channel-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5E,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAKD;;;;;;;GAOG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACxD,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBAEvC,MAAM,EAAE,yBAAyB;IAI7C,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI1C,uDAAuD;IACjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAE5B,qCAAqC;IAC/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3B;;;;;;;OAOG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa;IA+B3E;;;OAGG;IACH,OAAO,CAAC,eAAe;IAwCvB,OAAO,CAAC,mBAAmB;CAsC5B"}

package/dist/runtime/gateway/slack-channel-adapter.js

@@ -0,0 +1,129 @@
+import { createHmac, timingSafeEqual } from "crypto";
+import { createEnvelope } from "../types/envelope.js";
+/** Maximum age of a Slack request timestamp (5 minutes in seconds) */
+const MAX_TIMESTAMP_AGE_SEC = 5 * 60;
+/**
+ * SlackChannelAdapter receives events from the Slack Events API.
+ *
+ * This adapter is passive — it does NOT create its own HTTP server.
+ * Wire `handleRequest()` into your existing HTTP server's route handler.
+ *
+ * Outbound Slack notifications are handled by `src/runtime/channels/slack-channel.ts`.
+ */
+export class SlackChannelAdapter {
+    name = "slack";
+    handler = null;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    onEnvelope(handler) {
+        this.handler = handler;
+    }
+    /** No-op: adapter is driven by external HTTP server */
+    async start() { }
+    /** No-op: no resources to release */
+    async stop() { }
+    /**
+     * Handle a raw Slack Events API HTTP request.
+     * Call this from your HTTP server's POST route handler.
+     *
+     * @param body - Raw request body string
+     * @param headers - Request headers (lowercase keys expected)
+     * @returns HTTP response to send back to Slack
+     */
+    handleRequest(body, headers) {
+        let parsed;
+        try {
+            parsed = JSON.parse(body);
+        }
+        catch {
+            return { status: 400, body: "invalid json" };
+        }
+        // Signature verification for ALL requests (including url_verification)
+        const sigResult = this.verifySignature(body, headers);
+        if (sigResult !== null) {
+            return sigResult;
+        }
+        // URL Verification Challenge
+        if (parsed["type"] === "url_verification") {
+            const challenge = parsed["challenge"];
+            return {
+                status: 200,
+                body: JSON.stringify({ challenge }),
+            };
+        }
+        // Event callback
+        if (parsed["type"] === "event_callback") {
+            return this.handleEventCallback(parsed);
+        }
+        return { status: 200, body: "ok" };
+    }
+    /**
+     * Verify Slack request signature.
+     * Returns a SlackResponse on failure, null on success.
+     */
+    verifySignature(body, headers) {
+        const timestamp = headers["x-slack-request-timestamp"];
+        const signature = headers["x-slack-signature"];
+        if (!timestamp || !signature) {
+            return { status: 401, body: "missing signature headers" };
+        }
+        // Replay attack prevention
+        const nowSec = Math.floor(Date.now() / 1000);
+        const requestSec = parseInt(timestamp, 10);
+        if (isNaN(requestSec) || Math.abs(nowSec - requestSec) > MAX_TIMESTAMP_AGE_SEC) {
+            return { status: 401, body: "stale timestamp" };
+        }
+        // Compute expected signature
+        const sigBase = `v0:${timestamp}:${body}`;
+        const mac = createHmac("sha256", this.config.signingSecret)
+            .update(sigBase)
+            .digest("hex");
+        const expected = `v0=${mac}`;
+        // Reject immediately if lengths differ (Slack signatures are always 67 bytes: "v0=" + 64 hex chars).
+        // Length check first means timingSafeEqual won't throw, and reveals no secret information
+        // because the expected length is fixed regardless of the signing secret.
+        if (signature.length !== expected.length) {
+            return { status: 401, body: "invalid signature" };
+        }
+        const expectedBuf = Buffer.from(expected, "utf8");
+        const actualBuf = Buffer.from(signature, "utf8");
+        if (!timingSafeEqual(expectedBuf, actualBuf)) {
+            return { status: 401, body: "invalid signature" };
+        }
+        return null;
+    }
+    handleEventCallback(parsed) {
+        const slackEvent = parsed["event"];
+        if (!slackEvent) {
+            return { status: 400, body: "missing event field" };
+        }
+        if (!this.handler) {
+            console.warn("SlackChannelAdapter: no handler registered, dropping event");
+            return { status: 200, body: "ok" };
+        }
+        const slackChannelId = slackEvent["channel"];
+        const goalId = slackChannelId
+            ? this.config.channelGoalMap?.[slackChannelId]
+            : undefined;
+        const eventType = String(slackEvent["type"] ?? "slack_event");
+        const envelope = createEnvelope({
+            type: "event",
+            name: eventType,
+            source: "slack",
+            goal_id: goalId,
+            priority: "normal",
+            payload: slackEvent,
+            dedupe_key: parsed["event_id"],
+        });
+        // Attach Slack-specific metadata via a plain property merge (envelope is a plain object)
+        envelope["metadata"] = {
+            slack_team_id: parsed["team_id"],
+            slack_event_id: parsed["event_id"],
+        };
+        this.handler(envelope);
+        return { status: 200, body: "ok" };
+    }
+}
+//# sourceMappingURL=slack-channel-adapter.js.map

package/dist/runtime/gateway/slack-channel-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-channel-adapter.js","sourceRoot":"","sources":["../../../src/runtime/gateway/slack-channel-adapter.ts"],"names":[],"mappings":"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"}

package/dist/runtime/gateway/ws-channel-adapter.d.ts

@@ -0,0 +1,34 @@
+import type { ChannelAdapter, EnvelopeHandler } from "./channel-adapter.js";
+/** Minimal interface for a WebSocket-like socket */
+export interface WsSocketLike {
+    on(event: "message", cb: (data: unknown) => void): void;
+    on(event: "close", cb: () => void): void;
+    on(event: "error", cb: (err: Error) => void): void;
+    send(data: string): void;
+    close(): void;
+}
+/** Minimal interface for a WebSocket-like server */
+export interface WsLike {
+    on(event: "connection", cb: (socket: WsSocketLike) => void): void;
+    on(event: "close", cb: () => void): void;
+    close(cb?: () => void): void;
+}
+/**
+ * WsChannelAdapter wraps a WebSocket server (WsLike) and converts
+ * incoming messages into Envelopes for the IngressGateway.
+ *
+ * The ws package (or any compatible WS server) can be injected;
+ * no direct dependency on "ws" is required.
+ */
+export declare class WsChannelAdapter implements ChannelAdapter {
+    readonly name = "websocket";
+    private handler;
+    private wss;
+    constructor(wss: WsLike);
+    onEnvelope(handler: EnvelopeHandler): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private handleConnection;
+    private handleMessage;
+}
+//# sourceMappingURL=ws-channel-adapter.d.ts.map

package/dist/runtime/gateway/ws-channel-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-channel-adapter.d.ts","sourceRoot":"","sources":["../../../src/runtime/gateway/ws-channel-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAgB,MAAM,sBAAsB,CAAC;AAG1F,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACxD,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACzC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IACnD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,oDAAoD;AACpD,MAAM,WAAW,MAAM;IACrB,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAAC;IAClE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACzC,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,cAAc;IACrD,QAAQ,CAAC,IAAI,eAAe;IAC5B,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,EAAE,MAAM;IAIvB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAIpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,aAAa;CAuCtB"}

package/dist/runtime/gateway/ws-channel-adapter.js

@@ -0,0 +1,75 @@
+import { createEnvelope, EnvelopeTypeSchema, EnvelopePrioritySchema } from "../types/envelope.js";
+/**
+ * WsChannelAdapter wraps a WebSocket server (WsLike) and converts
+ * incoming messages into Envelopes for the IngressGateway.
+ *
+ * The ws package (or any compatible WS server) can be injected;
+ * no direct dependency on "ws" is required.
+ */
+export class WsChannelAdapter {
+    name = "websocket";
+    handler = null;
+    wss;
+    constructor(wss) {
+        this.wss = wss;
+    }
+    onEnvelope(handler) {
+        this.handler = handler;
+    }
+    async start() {
+        this.wss.on("connection", (socket) => {
+            this.handleConnection(socket);
+        });
+    }
+    async stop() {
+        return new Promise((resolve) => {
+            this.wss.close(() => resolve());
+        });
+    }
+    handleConnection(socket) {
+        socket.on("message", (data) => {
+            this.handleMessage(data, socket);
+        });
+        socket.on("close", () => {
+            // no-op: socket lifecycle is managed externally
+        });
+        socket.on("error", (err) => {
+            console.warn("WsChannelAdapter: socket error:", err.message);
+        });
+    }
+    handleMessage(data, socket) {
+        let parsed;
+        try {
+            const raw = typeof data === "string" ? data : String(data);
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            console.warn("WsChannelAdapter: failed to parse message, ignoring");
+            return;
+        }
+        if (!this.handler) {
+            console.warn("WsChannelAdapter: no handler registered, dropping message");
+            return;
+        }
+        const typeParsed = EnvelopeTypeSchema.safeParse(parsed["type"]);
+        const priorityParsed = EnvelopePrioritySchema.safeParse(parsed["priority"]);
+        const envelope = createEnvelope({
+            type: typeParsed.success ? typeParsed.data : "event",
+            name: String(parsed["name"] ?? "ws_message"),
+            source: "websocket",
+            goal_id: parsed["goal_id"],
+            priority: priorityParsed.success ? priorityParsed.data : "normal",
+            payload: parsed["payload"] ?? parsed,
+        });
+        const reply = {
+            send(responseData) {
+                socket.send(JSON.stringify(responseData));
+            },
+            close() {
+                socket.close();
+            },
+        };
+        void this.handler(envelope, reply);
+    }
+}
+//# sourceMappingURL=ws-channel-adapter.js.map

package/dist/runtime/gateway/ws-channel-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-channel-adapter.js","sourceRoot":"","sources":["../../../src/runtime/gateway/ws-channel-adapter.ts"],"names":[],"mappings":"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"}

package/dist/runtime/goal-lease-manager.d.ts

@@ -0,0 +1,35 @@
+export interface GoalLeaseRecord {
+    goal_id: string;
+    owner_token: string;
+    attempt_id: string;
+    worker_id: string;
+    lease_until: number;
+    acquired_at: number;
+    last_renewed_at: number;
+}
+export interface GoalLeaseAcquireOptions {
+    workerId: string;
+    ownerToken?: string;
+    attemptId?: string;
+    leaseMs?: number;
+    now?: number;
+}
+export interface GoalLeaseRenewOptions {
+    leaseMs?: number;
+    now?: number;
+}
+export declare class GoalLeaseManager {
+    private readonly leasesDir;
+    private readonly defaultLeaseMs;
+    constructor(runtimeRoot: string, defaultLeaseMs?: number);
+    private recordPath;
+    private mutexPath;
+    private buildRecord;
+    private readRaw;
+    acquire(goalId: string, opts: GoalLeaseAcquireOptions): Promise<GoalLeaseRecord | null>;
+    renew(goalId: string, ownerToken: string, opts?: GoalLeaseRenewOptions): Promise<GoalLeaseRecord | null>;
+    release(goalId: string, ownerToken: string): Promise<boolean>;
+    read(goalId: string): Promise<GoalLeaseRecord | null>;
+    reapStale(now?: number): Promise<GoalLeaseRecord[]>;
+}
+//# sourceMappingURL=goal-lease-manager.d.ts.map

package/dist/runtime/goal-lease-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-lease-manager.d.ts","sourceRoot":"","sources":["../../src/runtime/goal-lease-manager.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAgGD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,WAAW,EAAE,MAAM,EAAE,cAAc,SAAmB;IAMlE,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;YAaL,OAAO;IAKf,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAevF,KAAK,CACT,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAoB5B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY7D,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAIrD,SAAS,CAAC,GAAG,SAAa,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAgC9D"}

package/dist/runtime/goal-lease-manager.js

@@ -0,0 +1,191 @@
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { randomUUID } from "node:crypto";
+import { writeJsonFileAtomic, readJsonFileOrNull } from "../base/utils/json-io.js";
+const DEFAULT_LEASE_MS = 30_000;
+const MUTEX_RETRY_DELAY_MS = 10;
+const MUTEX_MAX_ATTEMPTS = 50;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function ensureDir(dirPath) {
+    await fsp.mkdir(dirPath, { recursive: true });
+}
+async function writeMutexPid(mutexDir) {
+    await fsp.writeFile(path.join(mutexDir, "pid"), String(process.pid), "utf-8");
+}
+async function clearStaleMutex(mutexDir) {
+    try {
+        const pidText = await fsp.readFile(path.join(mutexDir, "pid"), "utf-8");
+        const pid = Number.parseInt(pidText.trim(), 10);
+        if (!Number.isFinite(pid) || !(await isProcessAlive(pid))) {
+            await fsp.rm(mutexDir, { recursive: true, force: true });
+            return true;
+        }
+    }
+    catch {
+        await fsp.rm(mutexDir, { recursive: true, force: true });
+        return true;
+    }
+    return false;
+}
+async function acquireMutex(mutexDir) {
+    await ensureDir(path.dirname(mutexDir));
+    for (let attempt = 0; attempt < MUTEX_MAX_ATTEMPTS; attempt++) {
+        try {
+            await fsp.mkdir(mutexDir);
+            await writeMutexPid(mutexDir);
+            return;
+        }
+        catch (err) {
+            if (err.code !== "EEXIST") {
+                throw err;
+            }
+            if (!(await clearStaleMutex(mutexDir))) {
+                await sleep(MUTEX_RETRY_DELAY_MS);
+            }
+        }
+    }
+    throw new Error(`Timed out waiting for mutex: ${mutexDir}`);
+}
+async function releaseMutex(mutexDir) {
+    await fsp.rm(mutexDir, { recursive: true, force: true });
+}
+async function withMutex(mutexDir, fn) {
+    await acquireMutex(mutexDir);
+    try {
+        return await fn();
+    }
+    finally {
+        await releaseMutex(mutexDir);
+    }
+}
+function safeGoalId(goalId) {
+    return encodeURIComponent(goalId);
+}
+function isGoalLeaseRecord(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const record = value;
+    return (typeof record.goal_id === "string" &&
+        typeof record.owner_token === "string" &&
+        typeof record.attempt_id === "string" &&
+        typeof record.worker_id === "string" &&
+        typeof record.lease_until === "number" &&
+        typeof record.acquired_at === "number" &&
+        typeof record.last_renewed_at === "number");
+}
+export class GoalLeaseManager {
+    leasesDir;
+    defaultLeaseMs;
+    constructor(runtimeRoot, defaultLeaseMs = DEFAULT_LEASE_MS) {
+        runtimeRoot = path.resolve(runtimeRoot);
+        this.leasesDir = path.join(runtimeRoot, "leases", "goal");
+        this.defaultLeaseMs = defaultLeaseMs;
+    }
+    recordPath(goalId) {
+        return path.join(this.leasesDir, `${safeGoalId(goalId)}.json`);
+    }
+    mutexPath(goalId) {
+        return `${this.recordPath(goalId)}.lock`;
+    }
+    buildRecord(goalId, opts, now) {
+        const leaseMs = opts.leaseMs ?? this.defaultLeaseMs;
+        return {
+            goal_id: goalId,
+            owner_token: opts.ownerToken ?? randomUUID(),
+            attempt_id: opts.attemptId ?? randomUUID(),
+            worker_id: opts.workerId,
+            lease_until: now + leaseMs,
+            acquired_at: now,
+            last_renewed_at: now,
+        };
+    }
+    async readRaw(goalId) {
+        const raw = await readJsonFileOrNull(this.recordPath(goalId));
+        return isGoalLeaseRecord(raw) ? raw : null;
+    }
+    async acquire(goalId, opts) {
+        const now = opts.now ?? Date.now();
+        return withMutex(this.mutexPath(goalId), async () => {
+            const current = await this.readRaw(goalId);
+            if (current && current.lease_until > now) {
+                return null;
+            }
+            const record = this.buildRecord(goalId, opts, now);
+            await writeJsonFileAtomic(this.recordPath(goalId), record);
+            return record;
+        });
+    }
+    async renew(goalId, ownerToken, opts = {}) {
+        const now = opts.now ?? Date.now();
+        const leaseMs = opts.leaseMs ?? this.defaultLeaseMs;
+        return withMutex(this.mutexPath(goalId), async () => {
+            const current = await this.readRaw(goalId);
+            if (!current || current.owner_token !== ownerToken || current.lease_until <= now) {
+                return null;
+            }
+            const renewed = {
+                ...current,
+                lease_until: now + leaseMs,
+                last_renewed_at: now,
+            };
+            await writeJsonFileAtomic(this.recordPath(goalId), renewed);
+            return renewed;
+        });
+    }
+    async release(goalId, ownerToken) {
+        return withMutex(this.mutexPath(goalId), async () => {
+            const current = await this.readRaw(goalId);
+            if (!current || current.owner_token !== ownerToken) {
+                return false;
+            }
+            await fsp.rm(this.recordPath(goalId), { force: true });
+            return true;
+        });
+    }
+    async read(goalId) {
+        return this.readRaw(goalId);
+    }
+    async reapStale(now = Date.now()) {
+        await ensureDir(this.leasesDir);
+        let entries = [];
+        try {
+            entries = await fsp.readdir(this.leasesDir);
+        }
+        catch {
+            return [];
+        }
+        const removed = [];
+        for (const entry of entries) {
+            if (!entry.endsWith(".json"))
+                continue;
+            let goalId;
+            try {
+                goalId = decodeURIComponent(entry.slice(0, -5));
+            }
+            catch {
+                continue;
+            }
+            await withMutex(this.mutexPath(goalId), async () => {
+                const current = await this.readRaw(goalId);
+                if (!current || current.lease_until > now) {
+                    return;
+                }
+                removed.push(current);
+                await fsp.rm(this.recordPath(goalId), { force: true });
+            });
+        }
+        return removed;
+    }
+}
+//# sourceMappingURL=goal-lease-manager.js.map

package/dist/runtime/goal-lease-manager.js.map

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

package/dist/runtime/hook-manager.d.ts

@@ -1,5 +1,6 @@
 import type { Logger } from "./logger.js";
 import { type HookConfig, type HookEventType, type HookPayload } from "../base/types/hook.js";
+import { DreamLogCollector } from "../platform/dream/dream-log-collector.js";
 /**
  * HookManager loads hook definitions from {baseDir}/hooks.json and fires them
  * asynchronously when events are emitted. Hooks never block the caller —
@@ -9,7 +10,10 @@ export declare class HookManager {
     private readonly baseDir;
     private hooks;
     private readonly logger?;
+    private readonly dreamCollector;
     constructor(baseDir: string, logger?: Logger);
+    getDreamCollector(): DreamLogCollector;
+    private loadDreamCollectorConfig;
     /**
      * Load hook definitions from {baseDir}/hooks.json.
      * If the file does not exist, hooks = [] (no error).

package/dist/runtime/hook-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook-manager.d.ts","sourceRoot":"","sources":["../../src/runtime/hook-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAI/B;;;;GAIG;AACH,qBAAa,WAAW;IAIV,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAEJ,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAI7D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBhC;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;YAiChE,QAAQ;IAQtB;;;OAGG;YACW,aAAa;IAiD3B;;;;OAIG;YACW,eAAe;IA4B7B,+CAA+C;IAC/C,YAAY,IAAI,MAAM;IAItB,0DAA0D;IAC1D,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,EAAE;CAGrD"}
+{"version":3,"file":"hook-manager.d.ts","sourceRoot":"","sources":["../../src/runtime/hook-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAM7E;;;;GAIG;AACH,qBAAa,WAAW;IAKV,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;gBAEtB,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAK7D,iBAAiB,IAAI,iBAAiB;IAItC,OAAO,CAAC,wBAAwB;IAUhC;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBhC;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;YAkDhE,QAAQ;IAQtB;;;OAGG;YACW,aAAa;IAiD3B;;;;OAIG;YACW,eAAe;IA4B7B,+CAA+C;IAC/C,YAAY,IAAI,MAAM;IAItB,0DAA0D;IAC1D,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,EAAE;CAGrD"}

package/dist/runtime/hook-manager.js

@@ -1,7 +1,10 @@
+import * as fs from "node:fs";
 import * as fsp from "node:fs/promises";
 import * as path from "node:path";
 import { spawn } from "node:child_process";
 import { HooksConfigSchema, } from "../base/types/hook.js";
+import { DreamLogCollector } from "../platform/dream/dream-log-collector.js";
+import { DreamLogConfigSchema } from "../platform/dream/dream-types.js";
 // ─── HookManager ───
 /**
  * HookManager loads hook definitions from {baseDir}/hooks.json and fires them
@@ -12,9 +15,24 @@ export class HookManager {
     baseDir;
     hooks = [];
     logger;
+    dreamCollector;
     constructor(baseDir, logger) {
         this.baseDir = baseDir;
         this.logger = logger;
+        this.dreamCollector = new DreamLogCollector(baseDir, logger, this.loadDreamCollectorConfig());
+    }
+    getDreamCollector() {
+        return this.dreamCollector;
+    }
+    loadDreamCollectorConfig() {
+        const configPath = path.join(this.baseDir, "dream", "config.json");
+        try {
+            const raw = JSON.parse(fs.readFileSync(configPath, "utf8"));
+            return DreamLogConfigSchema.parse(raw).logCollection;
+        }
+        catch {
+            return {};
+        }
     }
     /**
      * Load hook definitions from {baseDir}/hooks.json.
@@ -46,6 +64,21 @@ export class HookManager {
      * Never throws — errors are logged only.
      */
     async emit(event, partial) {
+        const goalId = partial.goal_id ?? "global";
+        const taskId = typeof partial.data?.["task_id"] === "string"
+            ? String(partial.data["task_id"])
+            : typeof partial.data?.["taskId"] === "string"
+                ? String(partial.data["taskId"])
+                : undefined;
+        void this.dreamCollector.appendEventLog({
+            timestamp: new Date().toISOString(),
+            eventType: event,
+            goalId,
+            ...(taskId ? { taskId } : {}),
+            data: partial.data ?? {},
+        }).catch((err) => {
+            this.logger?.warn(`[HookManager] Failed to persist dream event ${event}: ${err instanceof Error ? err.message : String(err)}`);
+        });
         const matching = this.hooks.filter((h) => {
             if (!h.enabled)
                 return false;