@lumenflow/packs-sidekick 3.6.6

package/dist/tool-impl/memory-tools.js

@@ -0,0 +1,137 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { getStoragePort } from './storage.js';
+import { asInteger, asNonEmptyString, asStringArray, buildAuditEvent, createId, failure, includesText, isDryRun, matchesTags, nowIso, success, toRecord, } from './shared.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const TOOL_NAMES = {
+    STORE: 'memory:store',
+    RECALL: 'memory:recall',
+    FORGET: 'memory:forget',
+};
+const VALID_MEMORY_TYPES = ['fact', 'preference', 'note'];
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function asMemoryType(value) {
+    return VALID_MEMORY_TYPES.includes(value) ? value : null;
+}
+// ---------------------------------------------------------------------------
+// memory:store
+// ---------------------------------------------------------------------------
+async function memoryStoreTool(input, context) {
+    const parsed = toRecord(input);
+    const type = asMemoryType(parsed.type);
+    const content = asNonEmptyString(parsed.content);
+    if (!type) {
+        return failure('INVALID_INPUT', 'type must be one of fact, preference, note.');
+    }
+    if (!content) {
+        return failure('INVALID_INPUT', 'content is required.');
+    }
+    const memory = {
+        id: createId('mem'),
+        type,
+        content,
+        tags: asStringArray(parsed.tags),
+        created_at: nowIso(),
+        updated_at: nowIso(),
+    };
+    if (isDryRun(parsed)) {
+        return success({
+            dry_run: true,
+            memory: memory,
+        });
+    }
+    const storage = getStoragePort();
+    await storage.withLock(async () => {
+        const memories = await storage.readStore('memories');
+        memories.push(memory);
+        await storage.writeStore('memories', memories);
+        await storage.appendAudit(buildAuditEvent({
+            tool: TOOL_NAMES.STORE,
+            op: 'create',
+            context,
+            ids: [memory.id],
+        }));
+    });
+    return success({ memory: memory });
+}
+// ---------------------------------------------------------------------------
+// memory:recall
+// ---------------------------------------------------------------------------
+async function memoryRecallTool(input, _context) {
+    const parsed = toRecord(input);
+    const query = asNonEmptyString(parsed.query);
+    const type = asMemoryType(parsed.type);
+    const tags = asStringArray(parsed.tags);
+    const limit = asInteger(parsed.limit);
+    const storage = getStoragePort();
+    const memories = await storage.readStore('memories');
+    const filtered = memories.filter((memory) => {
+        if (type && memory.type !== type) {
+            return false;
+        }
+        if (!matchesTags(tags, memory.tags)) {
+            return false;
+        }
+        if (!includesText(memory.content, query)) {
+            return false;
+        }
+        return true;
+    });
+    const sorted = filtered.toSorted((a, b) => Date.parse(b.updated_at) - Date.parse(a.updated_at));
+    const items = limit && limit > 0 ? sorted.slice(0, limit) : sorted;
+    return success({
+        items: items,
+        count: items.length,
+    });
+}
+// ---------------------------------------------------------------------------
+// memory:forget
+// ---------------------------------------------------------------------------
+async function memoryForgetTool(input, context) {
+    const parsed = toRecord(input);
+    const id = asNonEmptyString(parsed.id);
+    if (!id) {
+        return failure('INVALID_INPUT', 'id is required.');
+    }
+    const storage = getStoragePort();
+    const memories = await storage.readStore('memories');
+    const exists = memories.some((memory) => memory.id === id);
+    if (!exists) {
+        return failure('NOT_FOUND', `memory ${id} was not found.`);
+    }
+    if (isDryRun(parsed)) {
+        return success({ dry_run: true, deleted_id: id });
+    }
+    await storage.withLock(async () => {
+        const latest = await storage.readStore('memories');
+        const remaining = latest.filter((memory) => memory.id !== id);
+        await storage.writeStore('memories', remaining);
+        await storage.appendAudit(buildAuditEvent({
+            tool: TOOL_NAMES.FORGET,
+            op: 'delete',
+            context,
+            ids: [id],
+        }));
+    });
+    return success({ deleted_id: id });
+}
+// ---------------------------------------------------------------------------
+// Router (default export)
+// ---------------------------------------------------------------------------
+export default async function memoryTools(input, context) {
+    switch (context?.tool_name) {
+        case TOOL_NAMES.STORE:
+            return memoryStoreTool(input, context);
+        case TOOL_NAMES.RECALL:
+            return memoryRecallTool(input, context);
+        case TOOL_NAMES.FORGET:
+            return memoryForgetTool(input, context);
+        default:
+            return failure('UNKNOWN_TOOL', `Unknown memory tool: ${context?.tool_name ?? 'unknown'}`);
+    }
+}
+//# sourceMappingURL=memory-tools.js.map

package/dist/tool-impl/memory-tools.js.map

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

package/dist/tool-impl/routine-tools.d.ts

@@ -0,0 +1,3 @@
+import { type ToolContextLike, type ToolOutput } from './shared.js';
+export default function routineTools(input: unknown, context?: ToolContextLike): Promise<ToolOutput>;
+//# sourceMappingURL=routine-tools.d.ts.map

package/dist/tool-impl/routine-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routine-tools.d.ts","sourceRoot":"","sources":["../../tool-impl/routine-tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAUL,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AAmKrB,wBAA8B,YAAY,CACxC,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,UAAU,CAAC,CAWrB"}

package/dist/tool-impl/routine-tools.js

@@ -0,0 +1,145 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { getStoragePort } from './storage.js';
+import { asInteger, asNonEmptyString, buildAuditEvent, createId, failure, isDryRun, nowIso, success, toRecord, } from './shared.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const TOOL_NAMES = {
+    CREATE: 'routine:create',
+    LIST: 'routine:list',
+    RUN: 'routine:run',
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function normalizeSteps(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    const steps = [];
+    for (const candidate of value) {
+        if (!candidate || typeof candidate !== 'object' || Array.isArray(candidate)) {
+            continue;
+        }
+        const record = candidate;
+        const tool = asNonEmptyString(record.tool);
+        if (!tool) {
+            continue;
+        }
+        const input = record.input && typeof record.input === 'object' && !Array.isArray(record.input)
+            ? record.input
+            : {};
+        steps.push({ tool, input });
+    }
+    return steps;
+}
+// ---------------------------------------------------------------------------
+// routine:create
+// ---------------------------------------------------------------------------
+async function routineCreateTool(input, context) {
+    const parsed = toRecord(input);
+    const name = asNonEmptyString(parsed.name);
+    const steps = normalizeSteps(parsed.steps);
+    if (!name) {
+        return failure('INVALID_INPUT', 'name is required.');
+    }
+    if (steps.length === 0) {
+        return failure('INVALID_INPUT', 'steps must include at least one tool step.');
+    }
+    const now = nowIso();
+    const routine = {
+        id: createId('routine'),
+        name,
+        steps,
+        created_at: now,
+        updated_at: now,
+    };
+    if (isDryRun(parsed)) {
+        return success({
+            dry_run: true,
+            routine: routine,
+        });
+    }
+    const storage = getStoragePort();
+    await storage.withLock(async () => {
+        const routines = await storage.readStore('routines');
+        routines.push(routine);
+        await storage.writeStore('routines', routines);
+        await storage.appendAudit(buildAuditEvent({
+            tool: TOOL_NAMES.CREATE,
+            op: 'create',
+            context,
+            ids: [routine.id],
+        }));
+    });
+    return success({ routine: routine });
+}
+// ---------------------------------------------------------------------------
+// routine:list
+// ---------------------------------------------------------------------------
+async function routineListTool(input, _context) {
+    const parsed = toRecord(input);
+    const limit = asInteger(parsed.limit);
+    const storage = getStoragePort();
+    const routines = await storage.readStore('routines');
+    const sorted = routines.toSorted((a, b) => Date.parse(b.updated_at) - Date.parse(a.updated_at));
+    const items = limit && limit > 0 ? sorted.slice(0, limit) : sorted;
+    return success({
+        items: items,
+        count: items.length,
+    });
+}
+// ---------------------------------------------------------------------------
+// routine:run (PLAN-ONLY -- does NOT execute tool steps)
+// ---------------------------------------------------------------------------
+async function routineRunTool(input, context) {
+    const parsed = toRecord(input);
+    const id = asNonEmptyString(parsed.id);
+    if (!id) {
+        return failure('INVALID_INPUT', 'id is required.');
+    }
+    const storage = getStoragePort();
+    const routines = await storage.readStore('routines');
+    const routine = routines.find((r) => r.id === id);
+    if (!routine) {
+        return failure('NOT_FOUND', `routine ${id} was not found.`);
+    }
+    await storage.appendAudit(buildAuditEvent({
+        tool: TOOL_NAMES.RUN,
+        op: 'execute',
+        context,
+        ids: [id],
+        details: { plan_only: true },
+    }));
+    return success({
+        routine_id: routine.id,
+        name: routine.name,
+        plan_only: true,
+        plan: routine.steps.map((step, index) => ({
+            index,
+            tool: step.tool,
+            input: step.input,
+        })),
+        governance: {
+            dispatch_required: true,
+            execution: 'No tool steps were executed by routine:run. This endpoint only returns a plan.',
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// Router (default export)
+// ---------------------------------------------------------------------------
+export default async function routineTools(input, context) {
+    switch (context?.tool_name) {
+        case TOOL_NAMES.CREATE:
+            return routineCreateTool(input, context);
+        case TOOL_NAMES.LIST:
+            return routineListTool(input, context);
+        case TOOL_NAMES.RUN:
+            return routineRunTool(input, context);
+        default:
+            return failure('UNKNOWN_TOOL', `Unknown routine tool: ${context?.tool_name ?? 'unknown'}`);
+    }
+}
+//# sourceMappingURL=routine-tools.js.map

package/dist/tool-impl/routine-tools.js.map

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

package/dist/tool-impl/shared.d.ts

@@ -0,0 +1,34 @@
+import type { AuditEvent } from './storage.js';
+export interface ToolContextLike {
+    tool_name?: string;
+    receipt_id?: string;
+}
+export interface ToolOutput {
+    success: boolean;
+    data?: Record<string, unknown>;
+    error?: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+    metadata?: Record<string, unknown>;
+}
+export declare function toRecord(input: unknown): Record<string, unknown>;
+export declare function asNonEmptyString(value: unknown): string | null;
+export declare function asStringArray(value: unknown): string[];
+export declare function asInteger(value: unknown): number | null;
+export declare function isDryRun(input: Record<string, unknown>): boolean;
+export declare function nowIso(): string;
+export declare function createId(prefix: string): string;
+export declare function failure(code: string, message: string, details?: Record<string, unknown>): ToolOutput;
+export declare function success(data: Record<string, unknown>): ToolOutput;
+export declare function matchesTags(requiredTags: string[], candidateTags: string[]): boolean;
+export declare function includesText(haystack: string, needle: string | null): boolean;
+export declare function buildAuditEvent(input: {
+    tool: string;
+    op: AuditEvent['op'];
+    context?: ToolContextLike;
+    ids?: string[];
+    details?: Record<string, unknown>;
+}): AuditEvent;
+//# sourceMappingURL=shared.d.ts.map

package/dist/tool-impl/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../tool-impl/shared.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKhE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAM9D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAYtD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CASvD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAEhE;AAED,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,UAAU,CASZ;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAKjE;AAED,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAMpF;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAK7E;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GAAG,UAAU,CAUb"}

package/dist/tool-impl/shared.js

@@ -0,0 +1,89 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { randomBytes } from 'node:crypto';
+export function toRecord(input) {
+    if (input && typeof input === 'object' && !Array.isArray(input)) {
+        return input;
+    }
+    return {};
+}
+export function asNonEmptyString(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+export function asStringArray(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    const items = [];
+    for (const entry of value) {
+        const normalized = asNonEmptyString(entry);
+        if (normalized) {
+            items.push(normalized);
+        }
+    }
+    return [...new Set(items)];
+}
+export function asInteger(value) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return Math.trunc(value);
+    }
+    if (typeof value === 'string') {
+        const parsed = Number.parseInt(value, 10);
+        return Number.isFinite(parsed) ? parsed : null;
+    }
+    return null;
+}
+export function isDryRun(input) {
+    return input.dry_run === true;
+}
+export function nowIso() {
+    return new Date().toISOString();
+}
+export function createId(prefix) {
+    return `${prefix}-${randomBytes(4).toString('hex')}`;
+}
+export function failure(code, message, details) {
+    return {
+        success: false,
+        error: {
+            code,
+            message,
+            ...(details ? { details } : {}),
+        },
+    };
+}
+export function success(data) {
+    return {
+        success: true,
+        data,
+    };
+}
+export function matchesTags(requiredTags, candidateTags) {
+    if (requiredTags.length === 0) {
+        return true;
+    }
+    const candidateSet = new Set(candidateTags.map((tag) => tag.toLowerCase()));
+    return requiredTags.every((tag) => candidateSet.has(tag.toLowerCase()));
+}
+export function includesText(haystack, needle) {
+    if (!needle) {
+        return true;
+    }
+    return haystack.toLowerCase().includes(needle.toLowerCase());
+}
+export function buildAuditEvent(input) {
+    return {
+        id: createId('evt'),
+        ts: nowIso(),
+        tool: input.tool,
+        op: input.op,
+        actor: input.context?.receipt_id,
+        ids: input.ids,
+        details: input.details,
+    };
+}
+//# sourceMappingURL=shared.js.map

package/dist/tool-impl/shared.js.map

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

package/dist/tool-impl/storage.d.ts

@@ -0,0 +1,87 @@
+export type TaskPriority = 'P0' | 'P1' | 'P2' | 'P3';
+export type TaskStatus = 'pending' | 'done';
+export type MemoryType = 'fact' | 'preference' | 'note';
+export interface TaskRecord {
+    id: string;
+    title: string;
+    description?: string;
+    priority: TaskPriority;
+    status: TaskStatus;
+    tags: string[];
+    due_at?: string;
+    note?: string;
+    created_at: string;
+    updated_at: string;
+    completed_at?: string;
+}
+export interface MemoryRecord {
+    id: string;
+    type: MemoryType;
+    content: string;
+    tags: string[];
+    created_at: string;
+    updated_at: string;
+}
+export interface ChannelRecord {
+    id: string;
+    name: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface ChannelMessageRecord {
+    id: string;
+    channel_id: string;
+    sender: string;
+    content: string;
+    created_at: string;
+}
+export interface RoutineStepRecord {
+    tool: string;
+    input: Record<string, unknown>;
+}
+export interface RoutineRecord {
+    id: string;
+    name: string;
+    steps: RoutineStepRecord[];
+    created_at: string;
+    updated_at: string;
+}
+export interface SidekickStores {
+    tasks: TaskRecord[];
+    memories: MemoryRecord[];
+    channels: ChannelRecord[];
+    messages: ChannelMessageRecord[];
+    routines: RoutineRecord[];
+}
+export type StoreName = keyof SidekickStores;
+export interface AuditEvent {
+    id: string;
+    ts: string;
+    tool: string;
+    op: 'create' | 'read' | 'update' | 'delete' | 'execute' | 'export';
+    actor?: string;
+    ids?: string[];
+    details?: Record<string, unknown>;
+}
+export interface StoragePort {
+    getRootDir(): string;
+    withLock<T>(fn: () => Promise<T>): Promise<T>;
+    readStore<K extends StoreName>(store: K): Promise<SidekickStores[K]>;
+    writeStore<K extends StoreName>(store: K, data: SidekickStores[K]): Promise<void>;
+    appendAudit(event: AuditEvent): Promise<void>;
+    readAuditEvents(): Promise<AuditEvent[]>;
+}
+export declare class FsStoragePort implements StoragePort {
+    private readonly rootDir;
+    constructor(rootDir?: string);
+    getRootDir(): string;
+    withLock<T>(fn: () => Promise<T>): Promise<T>;
+    readStore<K extends StoreName>(store: K): Promise<SidekickStores[K]>;
+    writeStore<K extends StoreName>(store: K, data: SidekickStores[K]): Promise<void>;
+    appendAudit(event: AuditEvent): Promise<void>;
+    readAuditEvents(): Promise<AuditEvent[]>;
+}
+export declare function setDefaultStoragePort(port: StoragePort): void;
+export declare function getStoragePort(): StoragePort;
+export declare function runWithStoragePort<T>(port: StoragePort, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/tool-impl/storage.d.ts.map

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