@lumenflow/packs-sidekick 3.6.6

package/dist/tool-impl/storage.js

@@ -0,0 +1,191 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { randomBytes } from 'node:crypto';
+import { appendFile, mkdir, open, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const UTF8_ENCODING = 'utf8';
+const DEFAULT_LOCK_TIMEOUT_MS = 10_000;
+const LOCK_RETRY_INTERVAL_MS = 25;
+const STALE_LOCK_MS = 30_000;
+const RANDOM_BYTES_LENGTH = 4;
+// ---------------------------------------------------------------------------
+// File-path mapping
+// ---------------------------------------------------------------------------
+const STORE_FILE_PATHS = {
+    tasks: 'tasks/tasks.json',
+    memories: 'memory/memories.json',
+    channels: 'channels/channels.json',
+    messages: 'channels/messages.json',
+    routines: 'routines/routines.json',
+};
+const STORE_DEFAULTS = {
+    tasks: [],
+    memories: [],
+    channels: [],
+    messages: [],
+    routines: [],
+};
+const AUDIT_FILE_PATH = 'audit/events.jsonl';
+const LOCK_FILE_PATH = '.lock';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function cloneStore(store, value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => ({ ...entry }));
+    }
+    return structuredClone(value);
+}
+function randomToken() {
+    return randomBytes(RANDOM_BYTES_LENGTH).toString('hex');
+}
+function nowMs() {
+    return Date.now();
+}
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+async function ensureParentDir(filePath) {
+    await mkdir(path.dirname(filePath), { recursive: true });
+}
+async function writeJsonAtomic(filePath, data) {
+    await ensureParentDir(filePath);
+    const tmpPath = `${filePath}.tmp-${process.pid}-${randomToken()}`;
+    await writeFile(tmpPath, `${JSON.stringify(data, null, 2)}\n`, UTF8_ENCODING);
+    await rename(tmpPath, filePath);
+}
+async function readJsonFile(filePath, fallback) {
+    try {
+        const raw = await readFile(filePath, UTF8_ENCODING);
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        const nodeError = error;
+        if (nodeError.code === 'ENOENT') {
+            await writeJsonAtomic(filePath, fallback);
+            return fallback;
+        }
+        throw error;
+    }
+}
+async function maybeRemoveStaleLock(lockPath) {
+    try {
+        const metadata = await stat(lockPath);
+        const ageMs = nowMs() - metadata.mtimeMs;
+        if (ageMs > STALE_LOCK_MS) {
+            await rm(lockPath, { force: true });
+        }
+    }
+    catch {
+        // Ignore races for lock cleanup.
+    }
+}
+async function withFileLock(lockPath, fn) {
+    const deadline = nowMs() + DEFAULT_LOCK_TIMEOUT_MS;
+    let handle = null;
+    while (nowMs() < deadline) {
+        try {
+            await ensureParentDir(lockPath);
+            handle = await open(lockPath, 'wx');
+            await handle.writeFile(`${process.pid}:${nowMs()}`, UTF8_ENCODING);
+            break;
+        }
+        catch (error) {
+            const nodeError = error;
+            if (nodeError.code !== 'EEXIST') {
+                throw error;
+            }
+            await maybeRemoveStaleLock(lockPath);
+            await sleep(LOCK_RETRY_INTERVAL_MS);
+        }
+    }
+    if (!handle) {
+        throw new Error(`Timed out waiting for sidekick storage lock at ${lockPath}.`);
+    }
+    try {
+        return await fn();
+    }
+    finally {
+        await handle.close();
+        await rm(lockPath, { force: true });
+    }
+}
+// ---------------------------------------------------------------------------
+// FsStoragePort (filesystem adapter)
+// ---------------------------------------------------------------------------
+export class FsStoragePort {
+    rootDir;
+    constructor(rootDir = path.resolve(process.cwd(), '.sidekick')) {
+        this.rootDir = rootDir;
+    }
+    getRootDir() {
+        return this.rootDir;
+    }
+    async withLock(fn) {
+        return withFileLock(path.join(this.rootDir, LOCK_FILE_PATH), fn);
+    }
+    async readStore(store) {
+        const storePath = path.join(this.rootDir, STORE_FILE_PATHS[store]);
+        const fallback = cloneStore(store, STORE_DEFAULTS[store]);
+        const data = await readJsonFile(storePath, fallback);
+        return cloneStore(store, data);
+    }
+    async writeStore(store, data) {
+        const storePath = path.join(this.rootDir, STORE_FILE_PATHS[store]);
+        await writeJsonAtomic(storePath, data);
+    }
+    async appendAudit(event) {
+        const auditPath = path.join(this.rootDir, AUDIT_FILE_PATH);
+        await ensureParentDir(auditPath);
+        await appendFile(auditPath, `${JSON.stringify(event)}\n`, UTF8_ENCODING);
+    }
+    async readAuditEvents() {
+        const auditPath = path.join(this.rootDir, AUDIT_FILE_PATH);
+        let raw;
+        try {
+            raw = await readFile(auditPath, UTF8_ENCODING);
+        }
+        catch (error) {
+            const nodeError = error;
+            if (nodeError.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
+        }
+        const events = [];
+        for (const line of raw.split('\n')) {
+            const trimmed = line.trim();
+            if (trimmed.length === 0) {
+                continue;
+            }
+            try {
+                events.push(JSON.parse(trimmed));
+            }
+            catch {
+                // Skip malformed audit lines and keep the stream readable.
+            }
+        }
+        return events;
+    }
+}
+// ---------------------------------------------------------------------------
+// Injection helpers (AsyncLocalStorage-based)
+// ---------------------------------------------------------------------------
+const storageContext = new AsyncLocalStorage();
+let defaultStoragePort = new FsStoragePort();
+export function setDefaultStoragePort(port) {
+    defaultStoragePort = port;
+}
+export function getStoragePort() {
+    return storageContext.getStore() ?? defaultStoragePort;
+}
+export async function runWithStoragePort(port, fn) {
+    return storageContext.run(port, fn);
+}
+//# sourceMappingURL=storage.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"system-tools.d.ts","sourceRoot":"","sources":["../../tool-impl/system-tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAOL,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AA6HrB,wBAA8B,WAAW,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,UAAU,CAAC,CAarB"}

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

@@ -0,0 +1,116 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { getStoragePort } from './storage.js';
+import { asNonEmptyString, buildAuditEvent, failure, nowIso, success, toRecord, } from './shared.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const TOOL_NAMES = {
+    INIT: 'sidekick:init',
+    STATUS: 'sidekick:status',
+    EXPORT: 'sidekick:export',
+};
+const STORE_NAMES = ['tasks', 'memories', 'channels', 'messages', 'routines'];
+// ---------------------------------------------------------------------------
+// sidekick:init (idempotent)
+// ---------------------------------------------------------------------------
+async function initTool(context) {
+    const storage = getStoragePort();
+    // Touch every store to ensure directories and files are created
+    for (const store of STORE_NAMES) {
+        await storage.readStore(store);
+    }
+    await storage.appendAudit(buildAuditEvent({
+        tool: TOOL_NAMES.INIT,
+        op: 'create',
+        context,
+        details: { root_dir: storage.getRootDir() },
+    }));
+    return success({
+        initialized: true,
+        root_dir: storage.getRootDir(),
+    });
+}
+// ---------------------------------------------------------------------------
+// sidekick:status
+// ---------------------------------------------------------------------------
+async function statusTool(context) {
+    const storage = getStoragePort();
+    const [tasks, memories, channels, messages, routines, audit] = await Promise.all([
+        storage.readStore('tasks'),
+        storage.readStore('memories'),
+        storage.readStore('channels'),
+        storage.readStore('messages'),
+        storage.readStore('routines'),
+        storage.readAuditEvents(),
+    ]);
+    const pendingTasks = tasks.filter((task) => task.status === 'pending').length;
+    const completedTasks = tasks.filter((task) => task.status === 'done').length;
+    await storage.appendAudit(buildAuditEvent({
+        tool: TOOL_NAMES.STATUS,
+        op: 'read',
+        context,
+        details: { task_count: tasks.length },
+    }));
+    return success({
+        task_count: tasks.length,
+        pending_tasks: pendingTasks,
+        completed_tasks: completedTasks,
+        memory_entries: memories.length,
+        channels: channels.length,
+        messages: messages.length,
+        routines: routines.length,
+        audit_events: audit.length,
+    });
+}
+// ---------------------------------------------------------------------------
+// sidekick:export (READ-ONLY -- returns data, no file write)
+// ---------------------------------------------------------------------------
+async function exportTool(input, context) {
+    const parsed = toRecord(input);
+    const includeAudit = parsed.include_audit !== false;
+    const storage = getStoragePort();
+    const [tasks, memories, channels, messages, routines, audit] = await Promise.all([
+        storage.readStore('tasks'),
+        storage.readStore('memories'),
+        storage.readStore('channels'),
+        storage.readStore('messages'),
+        storage.readStore('routines'),
+        storage.readAuditEvents(),
+    ]);
+    await storage.appendAudit(buildAuditEvent({
+        tool: TOOL_NAMES.EXPORT,
+        op: 'export',
+        context,
+        details: { include_audit: includeAudit },
+    }));
+    return success({
+        exported_at: nowIso(),
+        version: '0.1.0',
+        data: {
+            tasks,
+            memories,
+            channels,
+            messages,
+            routines,
+            ...(includeAudit ? { audit } : {}),
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// Router (default export)
+// ---------------------------------------------------------------------------
+export default async function systemTools(input, context) {
+    const toolName = asNonEmptyString(context?.tool_name) ?? '';
+    switch (toolName) {
+        case TOOL_NAMES.INIT:
+            return initTool(context);
+        case TOOL_NAMES.STATUS:
+            return statusTool(context);
+        case TOOL_NAMES.EXPORT:
+            return exportTool(input, context);
+        default:
+            return failure('UNKNOWN_TOOL', `Unknown system tool: ${toolName || 'unknown'}`);
+    }
+}
+//# sourceMappingURL=system-tools.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-tools.d.ts","sourceRoot":"","sources":["../../tool-impl/task-tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAYL,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AAmPrB,wBAA8B,SAAS,CACrC,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,UAAU,CAAC,CAarB"}

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

@@ -0,0 +1,215 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { getStoragePort } from './storage.js';
+import { asInteger, asNonEmptyString, asStringArray, buildAuditEvent, createId, failure, isDryRun, matchesTags, nowIso, success, toRecord, } from './shared.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const TOOL_NAMES = {
+    CREATE: 'task:create',
+    LIST: 'task:list',
+    COMPLETE: 'task:complete',
+    SCHEDULE: 'task:schedule',
+};
+const VALID_PRIORITIES = ['P0', 'P1', 'P2', 'P3'];
+const DEFAULT_PRIORITY = 'P2';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function asPriority(value) {
+    return VALID_PRIORITIES.includes(value)
+        ? value
+        : DEFAULT_PRIORITY;
+}
+// ---------------------------------------------------------------------------
+// task:create
+// ---------------------------------------------------------------------------
+async function taskCreateTool(input, context) {
+    const parsed = toRecord(input);
+    const title = asNonEmptyString(parsed.title);
+    if (!title) {
+        return failure('INVALID_INPUT', 'title is required.');
+    }
+    const task = {
+        id: createId('task'),
+        title,
+        description: asNonEmptyString(parsed.description) ?? undefined,
+        priority: asPriority(parsed.priority),
+        status: 'pending',
+        tags: asStringArray(parsed.tags),
+        due_at: asNonEmptyString(parsed.due_at) ?? undefined,
+        created_at: nowIso(),
+        updated_at: nowIso(),
+    };
+    if (isDryRun(parsed)) {
+        return success({ dry_run: true, task: task });
+    }
+    const storage = getStoragePort();
+    await storage.withLock(async () => {
+        const tasks = await storage.readStore('tasks');
+        tasks.push(task);
+        await storage.writeStore('tasks', tasks);
+        await storage.appendAudit(buildAuditEvent({
+            tool: TOOL_NAMES.CREATE,
+            op: 'create',
+            context,
+            ids: [task.id],
+        }));
+    });
+    return success({ task: task });
+}
+// ---------------------------------------------------------------------------
+// task:list
+// ---------------------------------------------------------------------------
+async function taskListTool(input, _context) {
+    const parsed = toRecord(input);
+    const statusFilter = asNonEmptyString(parsed.status);
+    const priorityFilter = asNonEmptyString(parsed.priority);
+    const tags = asStringArray(parsed.tags);
+    const dueBefore = asNonEmptyString(parsed.due_before);
+    const limit = asInteger(parsed.limit);
+    const storage = getStoragePort();
+    const tasks = await storage.readStore('tasks');
+    const filtered = tasks.filter((task) => {
+        if (statusFilter && task.status !== statusFilter) {
+            return false;
+        }
+        if (priorityFilter && task.priority !== priorityFilter) {
+            return false;
+        }
+        if (!matchesTags(tags, task.tags)) {
+            return false;
+        }
+        if (dueBefore && task.due_at) {
+            if (Date.parse(task.due_at) >= Date.parse(dueBefore)) {
+                return false;
+            }
+        }
+        if (dueBefore && !task.due_at) {
+            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,
+    });
+}
+// ---------------------------------------------------------------------------
+// task:complete
+// ---------------------------------------------------------------------------
+async function taskCompleteTool(input, context) {
+    const parsed = toRecord(input);
+    const id = asNonEmptyString(parsed.id);
+    if (!id) {
+        return failure('INVALID_INPUT', 'id is required.');
+    }
+    const storage = getStoragePort();
+    const tasks = await storage.readStore('tasks');
+    const task = tasks.find((t) => t.id === id);
+    if (!task) {
+        return failure('NOT_FOUND', `task ${id} was not found.`);
+    }
+    if (isDryRun(parsed)) {
+        const preview = { ...task, status: 'done', completed_at: nowIso() };
+        return success({
+            dry_run: true,
+            task: preview,
+        });
+    }
+    await storage.withLock(async () => {
+        const latest = await storage.readStore('tasks');
+        const target = latest.find((t) => t.id === id);
+        if (target) {
+            target.status = 'done';
+            target.completed_at = nowIso();
+            target.updated_at = nowIso();
+            if (parsed.note) {
+                target.note = asNonEmptyString(parsed.note) ?? undefined;
+            }
+            await storage.writeStore('tasks', latest);
+            await storage.appendAudit(buildAuditEvent({
+                tool: TOOL_NAMES.COMPLETE,
+                op: 'update',
+                context,
+                ids: [id],
+            }));
+        }
+    });
+    const updated = await storage.readStore('tasks');
+    const completedTask = updated.find((t) => t.id === id);
+    return success({ task: completedTask });
+}
+// ---------------------------------------------------------------------------
+// task:schedule
+// ---------------------------------------------------------------------------
+async function taskScheduleTool(input, context) {
+    const parsed = toRecord(input);
+    const id = asNonEmptyString(parsed.id);
+    if (!id) {
+        return failure('INVALID_INPUT', 'id is required.');
+    }
+    const storage = getStoragePort();
+    const tasks = await storage.readStore('tasks');
+    const task = tasks.find((t) => t.id === id);
+    if (!task) {
+        return failure('NOT_FOUND', `task ${id} was not found.`);
+    }
+    const dueAt = asNonEmptyString(parsed.due_at);
+    const cron = asNonEmptyString(parsed.cron);
+    if (isDryRun(parsed)) {
+        const preview = {
+            ...task,
+            ...(dueAt ? { due_at: dueAt } : {}),
+            ...(cron ? { cron } : {}),
+        };
+        return success({
+            dry_run: true,
+            task: preview,
+        });
+    }
+    await storage.withLock(async () => {
+        const latest = await storage.readStore('tasks');
+        const target = latest.find((t) => t.id === id);
+        if (target) {
+            if (dueAt) {
+                target.due_at = dueAt;
+            }
+            // cron is stored but TaskRecord doesn't have it yet -- extend inline
+            if (cron) {
+                target.cron = cron;
+            }
+            target.updated_at = nowIso();
+            await storage.writeStore('tasks', latest);
+            await storage.appendAudit(buildAuditEvent({
+                tool: TOOL_NAMES.SCHEDULE,
+                op: 'update',
+                context,
+                ids: [id],
+            }));
+        }
+    });
+    const updated = await storage.readStore('tasks');
+    const scheduledTask = updated.find((t) => t.id === id);
+    return success({ task: scheduledTask });
+}
+// ---------------------------------------------------------------------------
+// Router (default export)
+// ---------------------------------------------------------------------------
+export default async function taskTools(input, context) {
+    switch (context?.tool_name) {
+        case TOOL_NAMES.CREATE:
+            return taskCreateTool(input, context);
+        case TOOL_NAMES.LIST:
+            return taskListTool(input, context);
+        case TOOL_NAMES.COMPLETE:
+            return taskCompleteTool(input, context);
+        case TOOL_NAMES.SCHEDULE:
+            return taskScheduleTool(input, context);
+        default:
+            return failure('UNKNOWN_TOOL', `Unknown task tool: ${context?.tool_name ?? 'unknown'}`);
+    }
+}
+//# sourceMappingURL=task-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-tools.js","sourceRoot":"","sources":["../../tool-impl/task-tools.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,OAAO,EAAE,cAAc,EAAsC,MAAM,cAAc,CAAC;AAClF,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,WAAW,EACX,MAAM,EACN,OAAO,EACP,QAAQ,GAGT,MAAM,aAAa,CAAC;AAErB,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,UAAU,GAAG;IACjB,MAAM,EAAE,aAAa;IACrB,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,eAAe;CACjB,CAAC;AAEX,MAAM,gBAAgB,GAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAClE,MAAM,gBAAgB,GAAiB,IAAI,CAAC;AAE5C,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,gBAAgB,CAAC,QAAQ,CAAC,KAAqB,CAAC;QACrD,CAAC,CAAE,KAAsB;QACzB,CAAC,CAAC,gBAAgB,CAAC;AACvB,CAAC;AAED,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,KAAK,UAAU,cAAc,CAAC,KAAc,EAAE,OAAyB;IACrE,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,OAAO,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,IAAI,GAAe;QACvB,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC;QACpB,KAAK;QACL,WAAW,EAAE,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,SAAS;QAC9D,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC;QACrC,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC;QAChC,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,SAAS;QACpD,UAAU,EAAE,MAAM,EAAE;QACpB,UAAU,EAAE,MAAM,EAAE;KACrB,CAAC;IAEF,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,OAAO,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAA0C,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;QAChC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,OAAO,CAAC,WAAW,CACvB,eAAe,CAAC;YACd,IAAI,EAAE,UAAU,CAAC,MAAM;YACvB,EAAE,EAAE,QAAQ;YACZ,OAAO;YACP,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;SACf,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,EAAE,IAAI,EAAE,IAA0C,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,KAAK,UAAU,YAAY,CAAC,KAAc,EAAE,QAA0B;IACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEtC,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAE/C,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACrC,IAAI,YAAY,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,cAAc,IAAI,IAAI,CAAC,QAAQ,KAAK,cAAc,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBACrD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,IAAI,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAEhG,MAAM,KAAK,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAEnE,OAAO,OAAO,CAAC;QACb,KAAK,EAAE,KAA2C;QAClD,KAAK,EAAE,KAAK,CAAC,MAAM;KACpB,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,KAAK,UAAU,gBAAgB,CAAC,KAAc,EAAE,OAAyB;IACvE,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAEvC,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,OAAO,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAE5C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,MAAe,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,CAAC;QAC7E,OAAO,OAAO,CAAC;YACb,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,OAA6C;SACpD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;QAChC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;YACvB,MAAM,CAAC,YAAY,GAAG,MAAM,EAAE,CAAC;YAC/B,MAAM,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;YAC3D,CAAC;YACD,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC1C,MAAM,OAAO,CAAC,WAAW,CACvB,eAAe,CAAC;gBACd,IAAI,EAAE,UAAU,CAAC,QAAQ;gBACzB,EAAE,EAAE,QAAQ;gBACZ,OAAO;gBACP,GAAG,EAAE,CAAC,EAAE,CAAC;aACV,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAEvD,OAAO,OAAO,CAAC,EAAE,IAAI,EAAE,aAAmD,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,KAAK,UAAU,gBAAgB,CAAC,KAAc,EAAE,OAAyB;IACvE,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAEvC,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,OAAO,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAE5C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE3C,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG;YACd,GAAG,IAAI;YACP,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1B,CAAC;QACF,OAAO,OAAO,CAAC;YACb,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,OAA6C;SACpD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;QAChC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/C,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;YACxB,CAAC;YACD,qEAAqE;YACrE,IAAI,IAAI,EAAE,CAAC;gBACR,MAA6C,CAAC,IAAI,GAAG,IAAI,CAAC;YAC7D,CAAC;YACD,MAAM,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC;YAC7B,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC1C,MAAM,OAAO,CAAC,WAAW,CACvB,eAAe,CAAC;gBACd,IAAI,EAAE,UAAU,CAAC,QAAQ;gBACzB,EAAE,EAAE,QAAQ;gBACZ,OAAO;gBACP,GAAG,EAAE,CAAC,EAAE,CAAC;aACV,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAEvD,OAAO,OAAO,CAAC,EAAE,IAAI,EAAE,aAAmD,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,SAAS,CACrC,KAAc,EACd,OAAyB;IAEzB,QAAQ,OAAO,EAAE,SAAS,EAAE,CAAC;QAC3B,KAAK,UAAU,CAAC,MAAM;YACpB,OAAO,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACxC,KAAK,UAAU,CAAC,IAAI;YAClB,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACtC,KAAK,UAAU,CAAC,QAAQ;YACtB,OAAO,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1C,KAAK,UAAU,CAAC,QAAQ;YACtB,OAAO,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1C;YACE,OAAO,OAAO,CAAC,cAAc,EAAE,sBAAsB,OAAO,EAAE,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC"}

package/dist/tools/channel-tools.d.ts

@@ -0,0 +1,4 @@
+export declare const channelConfigureDescriptor: import("./types.js").ToolDescriptor;
+export declare const channelSendDescriptor: import("./types.js").ToolDescriptor;
+export declare const channelReceiveDescriptor: import("./types.js").ToolDescriptor;
+//# sourceMappingURL=channel-tools.d.ts.map

package/dist/tools/channel-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-tools.d.ts","sourceRoot":"","sources":["../../tools/channel-tools.ts"],"names":[],"mappings":"AA8BA,eAAO,MAAM,0BAA0B,qCAMrC,CAAC;AAEH,eAAO,MAAM,qBAAqB,qCAMhC,CAAC;AAEH,eAAO,MAAM,wBAAwB,qCAMnC,CAAC"}

package/dist/tools/channel-tools.js

@@ -0,0 +1,41 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { TOOL_PERMISSIONS, TOOL_SCOPE_ACCESS, TOOL_SCOPE_TYPES, createToolDescriptor, } from './types.js';
+const CHANNEL_READ_SCOPE = {
+    type: TOOL_SCOPE_TYPES.PATH,
+    pattern: '.sidekick/channels/**',
+    access: TOOL_SCOPE_ACCESS.READ,
+};
+const CHANNEL_WRITE_SCOPE = {
+    type: TOOL_SCOPE_TYPES.PATH,
+    pattern: '.sidekick/channels/**',
+    access: TOOL_SCOPE_ACCESS.WRITE,
+};
+const AUDIT_WRITE_SCOPE = {
+    type: TOOL_SCOPE_TYPES.PATH,
+    pattern: '.sidekick/audit/**',
+    access: TOOL_SCOPE_ACCESS.WRITE,
+};
+const CHANNEL_TOOLS_ENTRY = 'tool-impl/channel-tools.ts';
+export const channelConfigureDescriptor = createToolDescriptor({
+    name: 'channel:configure',
+    permission: TOOL_PERMISSIONS.WRITE,
+    required_scopes: [CHANNEL_READ_SCOPE, CHANNEL_WRITE_SCOPE, AUDIT_WRITE_SCOPE],
+    entry: CHANNEL_TOOLS_ENTRY,
+    description: 'Configure a messaging channel (terminal-only in v0.1).',
+});
+export const channelSendDescriptor = createToolDescriptor({
+    name: 'channel:send',
+    permission: TOOL_PERMISSIONS.WRITE,
+    required_scopes: [CHANNEL_READ_SCOPE, CHANNEL_WRITE_SCOPE, AUDIT_WRITE_SCOPE],
+    entry: CHANNEL_TOOLS_ENTRY,
+    description: 'Send a message to a channel. Supports dry_run.',
+});
+export const channelReceiveDescriptor = createToolDescriptor({
+    name: 'channel:receive',
+    permission: TOOL_PERMISSIONS.READ,
+    required_scopes: [CHANNEL_READ_SCOPE],
+    entry: CHANNEL_TOOLS_ENTRY,
+    description: 'Receive messages from a channel with optional limit and since filter.',
+});
+//# sourceMappingURL=channel-tools.js.map

package/dist/tools/channel-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-tools.js","sourceRoot":"","sources":["../../tools/channel-tools.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,MAAM,kBAAkB,GAAG;IACzB,IAAI,EAAE,gBAAgB,CAAC,IAAI;IAC3B,OAAO,EAAE,uBAAuB;IAChC,MAAM,EAAE,iBAAiB,CAAC,IAAI;CACtB,CAAC;AAEX,MAAM,mBAAmB,GAAG;IAC1B,IAAI,EAAE,gBAAgB,CAAC,IAAI;IAC3B,OAAO,EAAE,uBAAuB;IAChC,MAAM,EAAE,iBAAiB,CAAC,KAAK;CACvB,CAAC;AAEX,MAAM,iBAAiB,GAAG;IACxB,IAAI,EAAE,gBAAgB,CAAC,IAAI;IAC3B,OAAO,EAAE,oBAAoB;IAC7B,MAAM,EAAE,iBAAiB,CAAC,KAAK;CACvB,CAAC;AAEX,MAAM,mBAAmB,GAAG,4BAA4B,CAAC;AAEzD,MAAM,CAAC,MAAM,0BAA0B,GAAG,oBAAoB,CAAC;IAC7D,IAAI,EAAE,mBAAmB;IACzB,UAAU,EAAE,gBAAgB,CAAC,KAAK;IAClC,eAAe,EAAE,CAAC,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,CAAC;IAC7E,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,wDAAwD;CACtE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;IACxD,IAAI,EAAE,cAAc;IACpB,UAAU,EAAE,gBAAgB,CAAC,KAAK;IAClC,eAAe,EAAE,CAAC,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,CAAC;IAC7E,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,gDAAgD;CAC9D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,oBAAoB,CAAC;IAC3D,IAAI,EAAE,iBAAiB;IACvB,UAAU,EAAE,gBAAgB,CAAC,IAAI;IACjC,eAAe,EAAE,CAAC,kBAAkB,CAAC;IACrC,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,uEAAuE;CACrF,CAAC,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './task-tools.js';
+export * from './memory-tools.js';
+export * from './channel-tools.js';
+export * from './routine-tools.js';
+export * from './system-tools.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../tools/index.ts"],"names":[],"mappings":"AAGA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,9 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+export * from './types.js';
+export * from './task-tools.js';
+export * from './memory-tools.js';
+export * from './channel-tools.js';
+export * from './routine-tools.js';
+export * from './system-tools.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../tools/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}