@lumenflow/packs-sidekick 4.23.0 → 5.0.0

package/dist/sidekick-events.js

@@ -0,0 +1,288 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { createHash, randomUUID } from 'node:crypto';
+import { appendFile, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { getSidekickRuntimeContext } from './tool-impl/runtime-context.js';
+import { getStoragePort, } from './tool-impl/storage.js';
+const SCHEMA_VERSION_V2 = 2;
+const CONTENT_HASH_ALGORITHM = 'sha256';
+const CONTENT_HASH_ENCODING = 'hex';
+const CONTENT_HASH_PREFIX_LENGTH = 32;
+const OUTBOX_RELATIVE_PATH = path.join('.lumenflow', 'state', 'conductor', 'outbox', 'sidekick-events.jsonl');
+export const SIDEKICK_CHANNEL_ID = 'sidekick';
+export const SIDEKICK_EVENT_KINDS = {
+    TASK_CREATED: 'sidekick:task_created',
+    TASK_COMPLETED: 'sidekick:task_completed',
+    TASK_SCHEDULED: 'sidekick:task_scheduled',
+    TASK_SNOOZED: 'sidekick:task_snoozed',
+    MEMORY_STORED: 'sidekick:memory_stored',
+    MEMORY_RECALLED: 'sidekick:memory_recalled',
+    MEMORY_FORGOTTEN: 'sidekick:memory_forgotten',
+    CHANNEL_MESSAGE_SENT: 'sidekick:channel_message_sent',
+    CHANNEL_MESSAGE_RECEIVED: 'sidekick:channel_message_received',
+    CHANNEL_BRIDGE_CONNECTED: 'sidekick:channel_bridge_connected',
+    CHANNEL_BRIDGE_DISCONNECTED: 'sidekick:channel_bridge_disconnected',
+    ROUTINE_PLANNED: 'sidekick:routine_planned',
+    ROUTINE_COMMITTED: 'sidekick:routine_committed',
+    ROUTINE_EXECUTED: 'sidekick:routine_executed',
+    ROUTINE_STEP_FAILED: 'sidekick:routine_step_failed',
+    STATE_REHYDRATED: 'sidekick:state_rehydrated',
+};
+export const SIDEKICK_EVENT_KIND_VALUES = [
+    SIDEKICK_EVENT_KINDS.TASK_CREATED,
+    SIDEKICK_EVENT_KINDS.TASK_COMPLETED,
+    SIDEKICK_EVENT_KINDS.TASK_SCHEDULED,
+    SIDEKICK_EVENT_KINDS.TASK_SNOOZED,
+    SIDEKICK_EVENT_KINDS.MEMORY_STORED,
+    SIDEKICK_EVENT_KINDS.MEMORY_RECALLED,
+    SIDEKICK_EVENT_KINDS.MEMORY_FORGOTTEN,
+    SIDEKICK_EVENT_KINDS.CHANNEL_MESSAGE_SENT,
+    SIDEKICK_EVENT_KINDS.CHANNEL_MESSAGE_RECEIVED,
+    SIDEKICK_EVENT_KINDS.CHANNEL_BRIDGE_CONNECTED,
+    SIDEKICK_EVENT_KINDS.CHANNEL_BRIDGE_DISCONNECTED,
+    SIDEKICK_EVENT_KINDS.ROUTINE_PLANNED,
+    SIDEKICK_EVENT_KINDS.ROUTINE_COMMITTED,
+    SIDEKICK_EVENT_KINDS.ROUTINE_EXECUTED,
+    SIDEKICK_EVENT_KINDS.ROUTINE_STEP_FAILED,
+    SIDEKICK_EVENT_KINDS.STATE_REHYDRATED,
+];
+const QUEUE_WITH_REPLAY = 'queue-with-replay';
+const EPHEMERAL = 'ephemeral';
+export const SIDEKICK_EVENT_BACKPRESSURE_POLICY = {
+    [SIDEKICK_EVENT_KINDS.TASK_CREATED]: QUEUE_WITH_REPLAY,
+    [SIDEKICK_EVENT_KINDS.TASK_COMPLETED]: QUEUE_WITH_REPLAY,
+    [SIDEKICK_EVENT_KINDS.TASK_SCHEDULED]: QUEUE_WITH_REPLAY,
+    [SIDEKICK_EVENT_KINDS.TASK_SNOOZED]: QUEUE_WITH_REPLAY,
+    [SIDEKICK_EVENT_KINDS.MEMORY_STORED]: EPHEMERAL,
+    [SIDEKICK_EVENT_KINDS.MEMORY_RECALLED]: EPHEMERAL,
+    [SIDEKICK_EVENT_KINDS.MEMORY_FORGOTTEN]: EPHEMERAL,
+    [SIDEKICK_EVENT_KINDS.CHANNEL_MESSAGE_SENT]: EPHEMERAL,
+    [SIDEKICK_EVENT_KINDS.CHANNEL_MESSAGE_RECEIVED]: EPHEMERAL,
+    [SIDEKICK_EVENT_KINDS.CHANNEL_BRIDGE_CONNECTED]: EPHEMERAL,
+    [SIDEKICK_EVENT_KINDS.CHANNEL_BRIDGE_DISCONNECTED]: EPHEMERAL,
+    [SIDEKICK_EVENT_KINDS.ROUTINE_PLANNED]: QUEUE_WITH_REPLAY,
+    [SIDEKICK_EVENT_KINDS.ROUTINE_COMMITTED]: QUEUE_WITH_REPLAY,
+    [SIDEKICK_EVENT_KINDS.ROUTINE_EXECUTED]: QUEUE_WITH_REPLAY,
+    [SIDEKICK_EVENT_KINDS.ROUTINE_STEP_FAILED]: QUEUE_WITH_REPLAY,
+    [SIDEKICK_EVENT_KINDS.STATE_REHYDRATED]: QUEUE_WITH_REPLAY,
+};
+const channelSeqCounters = new Map();
+function nextSeq(channelId) {
+    const current = channelSeqCounters.get(channelId) ?? 0;
+    const next = current + 1;
+    channelSeqCounters.set(channelId, next);
+    return next;
+}
+function resolveTimestamp(timestamp) {
+    return timestamp ?? new Date().toISOString();
+}
+function resolveEventId(kind, payload, timestamp, idempotencyKey) {
+    if (!idempotencyKey) {
+        return randomUUID();
+    }
+    return createHash(CONTENT_HASH_ALGORITHM)
+        .update(JSON.stringify({
+        kind,
+        payload,
+        timestamp,
+        idempotencyKey,
+    }))
+        .digest(CONTENT_HASH_ENCODING)
+        .slice(0, CONTENT_HASH_PREFIX_LENGTH);
+}
+function stampSidekickEvent(payload, options) {
+    const timestamp = resolveTimestamp(options?.timestamp);
+    const event_id = resolveEventId(payload.kind, payload, timestamp, options?.idempotencyKey);
+    return {
+        ...payload,
+        schema_version: SCHEMA_VERSION_V2,
+        timestamp,
+        event_id,
+        channel_id: SIDEKICK_CHANNEL_ID,
+        seq: nextSeq(SIDEKICK_CHANNEL_ID),
+    };
+}
+async function queueEvent(event, workspaceRoot) {
+    const outboxPath = path.join(workspaceRoot, OUTBOX_RELATIVE_PATH);
+    await mkdir(path.dirname(outboxPath), { recursive: true });
+    await appendFile(outboxPath, `${JSON.stringify(event)}\n`, 'utf8');
+}
+export function resetSidekickSeqCounter() {
+    channelSeqCounters.clear();
+}
+export function readSidekickOrgId(config) {
+    if (!config || typeof config !== 'object') {
+        return undefined;
+    }
+    const controlPlane = config.control_plane;
+    if (!controlPlane || typeof controlPlane !== 'object') {
+        return undefined;
+    }
+    const raw = controlPlane.org_id;
+    if (typeof raw !== 'string') {
+        return undefined;
+    }
+    const trimmed = raw.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+export async function emitSidekickEvent(event) {
+    const runtimeContext = getSidekickRuntimeContext();
+    const policy = SIDEKICK_EVENT_BACKPRESSURE_POLICY[event.kind];
+    const orgId = readSidekickOrgId(runtimeContext?.workspaceConfig);
+    const sink = runtimeContext?.eventSink;
+    if (policy === 'ephemeral') {
+        if (!orgId || !sink) {
+            return event;
+        }
+        try {
+            await sink(event);
+        }
+        catch {
+            // Ephemeral events fail silent when the control plane is unavailable.
+        }
+        return event;
+    }
+    if (orgId && sink) {
+        try {
+            await sink(event);
+            return event;
+        }
+        catch {
+            // Fall through to queued replay on transport failure.
+        }
+    }
+    await queueEvent(event, runtimeContext?.workspaceRoot ?? process.cwd());
+    return event;
+}
+export async function snapshotSidekickState() {
+    const storage = getStoragePort();
+    const [tasks, memories, channels, messages, routines] = await Promise.all([
+        storage.readStore('tasks'),
+        storage.readStore('memories'),
+        storage.readStore('channels'),
+        storage.readStore('messages'),
+        storage.readStore('routines'),
+    ]);
+    return { tasks, memories, channels, messages, routines };
+}
+export function buildTaskCreatedEvent(task) {
+    return stampSidekickEvent({
+        kind: SIDEKICK_EVENT_KINDS.TASK_CREATED,
+        task,
+    });
+}
+export function buildTaskCompletedEvent(task) {
+    return stampSidekickEvent({
+        kind: SIDEKICK_EVENT_KINDS.TASK_COMPLETED,
+        task,
+    });
+}
+export function buildTaskScheduledEvent(task) {
+    return stampSidekickEvent({
+        kind: SIDEKICK_EVENT_KINDS.TASK_SCHEDULED,
+        task,
+    });
+}
+export function buildTaskSnoozedEvent(input) {
+    return stampSidekickEvent({
+        kind: SIDEKICK_EVENT_KINDS.TASK_SNOOZED,
+        ...input,
+    });
+}
+export function buildMemoryStoredEvent(memory) {
+    return stampSidekickEvent({
+        kind: SIDEKICK_EVENT_KINDS.MEMORY_STORED,
+        memory,
+    });
+}
+export function buildMemoryRecalledEvent(input) {
+    return stampSidekickEvent({
+        kind: SIDEKICK_EVENT_KINDS.MEMORY_RECALLED,
+        query: input.query,
+        count: input.memories.length,
+        memory_ids: input.memories.map((memory) => memory.id),
+    });
+}
+export function buildMemoryForgottenEvent(memory_id) {
+    return stampSidekickEvent({
+        kind: SIDEKICK_EVENT_KINDS.MEMORY_FORGOTTEN,
+        memory_id,
+    });
+}
+export function buildChannelMessageSentEvent(message) {
+    return stampSidekickEvent({
+        kind: SIDEKICK_EVENT_KINDS.CHANNEL_MESSAGE_SENT,
+        message,
+    });
+}
+export function buildChannelMessageReceivedEvent(input) {
+    return stampSidekickEvent({
+        kind: SIDEKICK_EVENT_KINDS.CHANNEL_MESSAGE_RECEIVED,
+        channel: input.channel,
+        count: input.count,
+        ...(input.provider ? { provider: input.provider } : {}),
+    });
+}
+export function buildChannelBridgeConnectedEvent(channel) {
+    return stampSidekickEvent({
+        kind: SIDEKICK_EVENT_KINDS.CHANNEL_BRIDGE_CONNECTED,
+        channel,
+    });
+}
+export function buildChannelBridgeDisconnectedEvent(input) {
+    return stampSidekickEvent({
+        kind: SIDEKICK_EVENT_KINDS.CHANNEL_BRIDGE_DISCONNECTED,
+        ...input,
+    });
+}
+export function buildRoutinePlannedEvent(routine) {
+    return stampSidekickEvent({
+        kind: SIDEKICK_EVENT_KINDS.ROUTINE_PLANNED,
+        routine,
+    });
+}
+export function buildRoutineCommittedEvent(routine, options) {
+    return stampSidekickEvent({
+        kind: SIDEKICK_EVENT_KINDS.ROUTINE_COMMITTED,
+        routine,
+        ...(options?.envelope_content_hash
+            ? { envelope_content_hash: options.envelope_content_hash }
+            : {}),
+    });
+}
+export function buildRoutineExecutedEvent(input) {
+    return stampSidekickEvent({
+        kind: SIDEKICK_EVENT_KINDS.ROUTINE_EXECUTED,
+        routine_id: input.routine_id,
+        name: input.name,
+        step_count: input.step_count,
+        plan_only: true,
+    });
+}
+export function buildRoutineStepFailedEvent(input) {
+    return stampSidekickEvent({
+        kind: SIDEKICK_EVENT_KINDS.ROUTINE_STEP_FAILED,
+        step_index: input.step_index,
+        reason: input.reason,
+        ...(input.routine_id ? { routine_id: input.routine_id } : {}),
+        ...(input.routine_name ? { routine_name: input.routine_name } : {}),
+    });
+}
+export function buildStateRehydratedEvent(snapshot) {
+    return stampSidekickEvent({
+        kind: SIDEKICK_EVENT_KINDS.STATE_REHYDRATED,
+        snapshot,
+    });
+}
+export function serializeLocalChannelMessage(message, channelName) {
+    return {
+        id: message.id,
+        channel_id: message.channel_id,
+        ...(channelName ? { channel: channelName } : {}),
+        sender: message.sender,
+        content: message.content,
+        created_at: message.created_at,
+    };
+}
+//# sourceMappingURL=sidekick-events.js.map

package/dist/sidekick-events.js.map

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

package/dist/src/adapters/cloud-queue.d.ts

@@ -0,0 +1,20 @@
+import type { ChannelEnvelope } from '../domain/channel.types.js';
+export interface OutboxRecord {
+    channel_id: string;
+    envelope: ChannelEnvelope;
+    /** Internal filename so the adapter can remove the entry after a successful replay. */
+    _filename: string;
+}
+export declare class CloudOutbox {
+    private readonly outboxDir;
+    constructor(outboxDir: string);
+    enqueue(channelId: string, envelope: ChannelEnvelope): Promise<void>;
+    /**
+     * Lists outbox records in FIFO order. The returned filename is opaque; pass
+     * it back to `remove()` after a successful replay.
+     */
+    list(): Promise<OutboxRecord[]>;
+    remove(filename: string): Promise<void>;
+    isEmpty(): Promise<boolean>;
+}
+//# sourceMappingURL=cloud-queue.d.ts.map

package/dist/src/adapters/cloud-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-queue.d.ts","sourceRoot":"","sources":["../../../src/adapters/cloud-queue.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,eAAe,CAAC;IAC1B,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC;CACnB;AAcD,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAExC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAW1E;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IA8B/B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAIlC"}

package/dist/src/adapters/cloud-queue.js

@@ -0,0 +1,90 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU-2737 (INIT-060 WU-7b, ADR-013 §ChannelBridge):
+ * Local outbox for queue-kind envelopes when the cloud is unreachable.
+ *
+ * Backing layout:
+ *   <outboxDir>/<channel-id>/<timestamp>-<envelope-id>.json
+ *
+ * Each file is a JSON blob `{ channel_id, envelope }` matching the request
+ * body shape published in `channel-bridge-cloud-stub.md`. FIFO ordering comes
+ * from the sorted filename (lexicographic on timestamp + envelope id).
+ *
+ * The outbox is intentionally dumb: no retry state, no backoff, no watcher.
+ * The adapter drives drains explicitly via `flush()` or reactively on the
+ * next successful POST; ADR-013 §4 treats the outbox as a passive spool.
+ */
+import { mkdir, readdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+/**
+ * Seconds-precision epoch plus a short random suffix keeps filenames sortable
+ * FIFO while avoiding collisions when two envelopes enqueue in the same
+ * millisecond.
+ */
+function mintFilename(envelopeId) {
+    const ts = new Date().toISOString().replace(/[:.]/g, '-');
+    const safeId = envelopeId.replace(/[^a-zA-Z0-9_-]/g, '_');
+    const suffix = Math.random().toString(36).slice(2, 8);
+    return `${ts}-${safeId}-${suffix}.json`;
+}
+export class CloudOutbox {
+    outboxDir;
+    constructor(outboxDir) {
+        this.outboxDir = outboxDir;
+    }
+    async enqueue(channelId, envelope) {
+        const dir = path.resolve(this.outboxDir);
+        await mkdir(dir, { recursive: true });
+        const filename = mintFilename(envelope.id);
+        const tmpPath = path.join(dir, `.tmp-${process.pid}-${filename}`);
+        const finalPath = path.join(dir, filename);
+        const payload = JSON.stringify({ channel_id: channelId, envelope });
+        await writeFile(tmpPath, payload, 'utf8');
+        await rename(tmpPath, finalPath);
+    }
+    /**
+     * Lists outbox records in FIFO order. The returned filename is opaque; pass
+     * it back to `remove()` after a successful replay.
+     */
+    async list() {
+        const dir = path.resolve(this.outboxDir);
+        let entries;
+        try {
+            entries = await readdir(dir);
+        }
+        catch (error) {
+            const err = error;
+            if (err.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
+        }
+        const records = [];
+        const sortedEntries = entries
+            .filter((e) => e.endsWith('.json') && !e.startsWith('.tmp-'))
+            .sort();
+        for (const name of sortedEntries) {
+            const full = path.join(dir, name);
+            try {
+                const raw = await readFile(full, 'utf8');
+                const parsed = JSON.parse(raw);
+                records.push({ ...parsed, _filename: name });
+            }
+            catch {
+                // Corrupt or partial file — skip (will not block FIFO drain).
+                continue;
+            }
+        }
+        return records;
+    }
+    async remove(filename) {
+        const full = path.join(path.resolve(this.outboxDir), filename);
+        await rm(full, { force: true });
+    }
+    async isEmpty() {
+        const records = await this.list();
+        return records.length === 0;
+    }
+}
+//# sourceMappingURL=cloud-queue.js.map

package/dist/src/adapters/cloud-queue.js.map

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

package/dist/src/adapters/control-plane-bridge.adapter.d.ts

@@ -0,0 +1,31 @@
+import type { ChannelBridge } from '../ports/channel-bridge.port.js';
+export interface ControlPlaneChannelBridgeOptions {
+    /** Cloud API base URL, e.g. `https://app.lumenflow.dev` (no trailing slash). */
+    baseUrl: string;
+    /** Workspace id — path parameter on the POST route. */
+    workspaceId: string;
+    /**
+     * Returns the current enrollment token. Called on every request so token
+     * rotation (re-auth) is transparent to callers.
+     */
+    tokenProvider: () => Promise<string>;
+    /** Local outbox root for queue-kind envelopes. */
+    outboxDir: string;
+    /** Polling interval for `receive()`. Defaults to 1000ms. */
+    pollIntervalMs?: number;
+    /**
+     * Optional override for `fetch`. Primarily a test seam; production wiring
+     * uses the platform global `fetch`.
+     */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * `ChannelBridge` extended with `flush()` so operators (and the disconnect
+ * path) can explicitly drain the outbox. The port contract itself does NOT
+ * require `flush`; it's an adapter affordance.
+ */
+export interface ControlPlaneChannelBridge extends ChannelBridge {
+    flush(): Promise<void>;
+}
+export declare function createControlPlaneChannelBridge(options: ControlPlaneChannelBridgeOptions): ControlPlaneChannelBridge;
+//# sourceMappingURL=control-plane-bridge.adapter.d.ts.map

package/dist/src/adapters/control-plane-bridge.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane-bridge.adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/control-plane-bridge.adapter.ts"],"names":[],"mappings":"AA0CA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAQrE,MAAM,WAAW,gCAAgC;IAC/C,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,aAAa;IAC9D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAsDD,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,GACxC,yBAAyB,CAmP3B"}