@lumenflow/packs-sidekick 3.6.6

package/dist/manifest.js

@@ -0,0 +1,297 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { SIDEKICK_PACK_ID, SIDEKICK_PACK_VERSION, SIDEKICK_POLICY_ID_PREFIX } from './constants.js';
+import { MANIFEST_POLICY_DECISIONS, MANIFEST_POLICY_TRIGGERS, SidekickManifestSchema, } from './manifest-schema.js';
+import { TOOL_PERMISSIONS, TOOL_SCOPE_ACCESS, TOOL_SCOPE_TYPES, } from './tools/types.js';
+// ---------------------------------------------------------------------------
+// Scope constants
+// ---------------------------------------------------------------------------
+const SIDEKICK_SCOPE_READ = {
+    type: TOOL_SCOPE_TYPES.PATH,
+    pattern: '.sidekick/**',
+    access: TOOL_SCOPE_ACCESS.READ,
+};
+const SIDEKICK_SCOPE_WRITE = {
+    type: TOOL_SCOPE_TYPES.PATH,
+    pattern: '.sidekick/**',
+    access: TOOL_SCOPE_ACCESS.WRITE,
+};
+// ---------------------------------------------------------------------------
+// 16-tool contract (per strategy: 5 groups)
+// ---------------------------------------------------------------------------
+const TOOL_PERMISSIONS_MAP = {
+    // Task tools (4)
+    'task:create': TOOL_PERMISSIONS.WRITE,
+    'task:list': TOOL_PERMISSIONS.READ,
+    'task:complete': TOOL_PERMISSIONS.WRITE,
+    'task:schedule': TOOL_PERMISSIONS.WRITE,
+    // Memory tools (3)
+    'memory:store': TOOL_PERMISSIONS.WRITE,
+    'memory:recall': TOOL_PERMISSIONS.READ,
+    'memory:forget': TOOL_PERMISSIONS.WRITE,
+    // Channel tools (3)
+    'channel:configure': TOOL_PERMISSIONS.WRITE,
+    'channel:send': TOOL_PERMISSIONS.WRITE,
+    'channel:receive': TOOL_PERMISSIONS.READ,
+    // Routine tools (3)
+    'routine:create': TOOL_PERMISSIONS.WRITE,
+    'routine:list': TOOL_PERMISSIONS.READ,
+    'routine:run': TOOL_PERMISSIONS.READ, // plan-only, no execution
+    // System tools (3)
+    'sidekick:init': TOOL_PERMISSIONS.WRITE,
+    'sidekick:status': TOOL_PERMISSIONS.READ,
+    'sidekick:export': TOOL_PERMISSIONS.READ, // returns data, no file write
+};
+const TASK_TOOLS_ENTRY = 'tool-impl/task-tools.ts';
+const MEMORY_TOOLS_ENTRY = 'tool-impl/memory-tools.ts';
+const CHANNEL_TOOLS_ENTRY = 'tool-impl/channel-tools.ts';
+const ROUTINE_TOOLS_ENTRY = 'tool-impl/routine-tools.ts';
+const SYSTEM_TOOLS_ENTRY = 'tool-impl/system-tools.ts';
+const TOOL_ENTRIES = {
+    'task:create': TASK_TOOLS_ENTRY,
+    'task:list': TASK_TOOLS_ENTRY,
+    'task:complete': TASK_TOOLS_ENTRY,
+    'task:schedule': TASK_TOOLS_ENTRY,
+    'memory:store': MEMORY_TOOLS_ENTRY,
+    'memory:recall': MEMORY_TOOLS_ENTRY,
+    'memory:forget': MEMORY_TOOLS_ENTRY,
+    'channel:configure': CHANNEL_TOOLS_ENTRY,
+    'channel:send': CHANNEL_TOOLS_ENTRY,
+    'channel:receive': CHANNEL_TOOLS_ENTRY,
+    'routine:create': ROUTINE_TOOLS_ENTRY,
+    'routine:list': ROUTINE_TOOLS_ENTRY,
+    'routine:run': ROUTINE_TOOLS_ENTRY,
+    'sidekick:init': SYSTEM_TOOLS_ENTRY,
+    'sidekick:status': SYSTEM_TOOLS_ENTRY,
+    'sidekick:export': SYSTEM_TOOLS_ENTRY,
+};
+// ---------------------------------------------------------------------------
+// Input schemas (JSON Schema objects)
+// ---------------------------------------------------------------------------
+const TOOL_INPUT_SCHEMAS = {
+    'task:create': {
+        type: 'object',
+        properties: {
+            title: { type: 'string', minLength: 1 },
+            description: { type: 'string' },
+            priority: { type: 'string', enum: ['P0', 'P1', 'P2', 'P3'] },
+            due_at: { type: 'string' },
+            tags: { type: 'array', items: { type: 'string' } },
+            dry_run: { type: 'boolean' },
+        },
+        required: ['title'],
+        additionalProperties: false,
+    },
+    'task:list': {
+        type: 'object',
+        properties: {
+            status: { type: 'string', enum: ['pending', 'done'] },
+            priority: { type: 'string', enum: ['P0', 'P1', 'P2', 'P3'] },
+            tags: { type: 'array', items: { type: 'string' } },
+            search: { type: 'string' },
+            due_before: { type: 'string' },
+            limit: { type: 'integer', minimum: 1 },
+        },
+        additionalProperties: false,
+    },
+    'task:complete': {
+        type: 'object',
+        properties: {
+            id: { type: 'string', minLength: 1 },
+            note: { type: 'string' },
+            dry_run: { type: 'boolean' },
+        },
+        required: ['id'],
+        additionalProperties: false,
+    },
+    'task:schedule': {
+        type: 'object',
+        properties: {
+            id: { type: 'string', minLength: 1 },
+            due_at: { type: 'string' },
+            cron: { type: 'string' },
+            dry_run: { type: 'boolean' },
+        },
+        required: ['id'],
+        additionalProperties: false,
+    },
+    'memory:store': {
+        type: 'object',
+        properties: {
+            type: { type: 'string', enum: ['fact', 'preference', 'note', 'snippet'] },
+            content: { type: 'string', minLength: 1 },
+            tags: { type: 'array', items: { type: 'string' } },
+            dry_run: { type: 'boolean' },
+        },
+        required: ['type', 'content'],
+        additionalProperties: false,
+    },
+    'memory:recall': {
+        type: 'object',
+        properties: {
+            query: { type: 'string' },
+            type: { type: 'string', enum: ['fact', 'preference', 'note', 'snippet'] },
+            tags: { type: 'array', items: { type: 'string' } },
+            limit: { type: 'integer', minimum: 1 },
+        },
+        additionalProperties: false,
+    },
+    'memory:forget': {
+        type: 'object',
+        properties: {
+            id: { type: 'string', minLength: 1 },
+            dry_run: { type: 'boolean' },
+        },
+        required: ['id'],
+        additionalProperties: false,
+    },
+    'channel:configure': {
+        type: 'object',
+        properties: {
+            name: { type: 'string', minLength: 1 },
+            type: { type: 'string', enum: ['terminal'] },
+            dry_run: { type: 'boolean' },
+        },
+        required: ['name'],
+        additionalProperties: false,
+    },
+    'channel:send': {
+        type: 'object',
+        properties: {
+            channel: { type: 'string' },
+            content: { type: 'string', minLength: 1 },
+            sender: { type: 'string' },
+            dry_run: { type: 'boolean' },
+        },
+        required: ['content'],
+        additionalProperties: false,
+    },
+    'channel:receive': {
+        type: 'object',
+        properties: {
+            channel: { type: 'string' },
+            limit: { type: 'integer', minimum: 1 },
+            since: { type: 'string' },
+        },
+        additionalProperties: false,
+    },
+    'routine:create': {
+        type: 'object',
+        properties: {
+            name: { type: 'string', minLength: 1 },
+            steps: {
+                type: 'array',
+                minItems: 1,
+                items: {
+                    type: 'object',
+                    properties: {
+                        tool: { type: 'string', minLength: 1 },
+                        input: { type: 'object', additionalProperties: true },
+                    },
+                    required: ['tool'],
+                    additionalProperties: false,
+                },
+            },
+            cron: { type: 'string' },
+            enabled: { type: 'boolean' },
+            dry_run: { type: 'boolean' },
+        },
+        required: ['name', 'steps'],
+        additionalProperties: false,
+    },
+    'routine:list': {
+        type: 'object',
+        properties: {
+            enabled_only: { type: 'boolean' },
+            limit: { type: 'integer', minimum: 1 },
+        },
+        additionalProperties: false,
+    },
+    'routine:run': {
+        type: 'object',
+        properties: {
+            id: { type: 'string', minLength: 1 },
+        },
+        required: ['id'],
+        additionalProperties: false,
+    },
+    'sidekick:init': {
+        type: 'object',
+        properties: {},
+        additionalProperties: false,
+    },
+    'sidekick:status': {
+        type: 'object',
+        properties: {},
+        additionalProperties: false,
+    },
+    'sidekick:export': {
+        type: 'object',
+        properties: {
+            include_audit: { type: 'boolean' },
+        },
+        additionalProperties: false,
+    },
+};
+// ---------------------------------------------------------------------------
+// Generic output schema
+// ---------------------------------------------------------------------------
+const GENERIC_OUTPUT_SCHEMA = {
+    type: 'object',
+    properties: {
+        success: { type: 'boolean' },
+        data: { type: 'object', additionalProperties: true },
+        error: { type: 'object', additionalProperties: true },
+    },
+    additionalProperties: true,
+};
+// ---------------------------------------------------------------------------
+// Builder helpers
+// ---------------------------------------------------------------------------
+function resolveRequiredScopes(permission) {
+    if (permission === TOOL_PERMISSIONS.READ) {
+        return [SIDEKICK_SCOPE_READ];
+    }
+    return [SIDEKICK_SCOPE_READ, SIDEKICK_SCOPE_WRITE];
+}
+function buildTool(name) {
+    const permission = TOOL_PERMISSIONS_MAP[name];
+    return {
+        name,
+        entry: TOOL_ENTRIES[name],
+        permission,
+        required_scopes: resolveRequiredScopes(permission),
+        input_schema: TOOL_INPUT_SCHEMAS[name],
+        output_schema: GENERIC_OUTPUT_SCHEMA,
+    };
+}
+// ---------------------------------------------------------------------------
+// Exported manifest
+// ---------------------------------------------------------------------------
+export const SIDEKICK_TOOL_NAMES = Object.keys(TOOL_PERMISSIONS_MAP);
+const SIDEKICK_MANIFEST_TEMPLATE = {
+    id: SIDEKICK_PACK_ID,
+    version: SIDEKICK_PACK_VERSION,
+    config_key: SIDEKICK_PACK_ID,
+    task_types: ['sidekick'],
+    tools: SIDEKICK_TOOL_NAMES.map((name) => buildTool(name)),
+    policies: [
+        {
+            id: `${SIDEKICK_POLICY_ID_PREFIX}.default`,
+            trigger: MANIFEST_POLICY_TRIGGERS.ON_TOOL_REQUEST,
+            decision: MANIFEST_POLICY_DECISIONS.ALLOW,
+            reason: 'Default sidekick policy permits declared tools within scoped access.',
+        },
+    ],
+    evidence_types: ['sidekick.audited.tool-call'],
+    state_aliases: {},
+    lane_templates: [],
+};
+export const SIDEKICK_MANIFEST = SidekickManifestSchema.parse(SIDEKICK_MANIFEST_TEMPLATE);
+export function getSidekickManifestToolByName(name) {
+    return SIDEKICK_MANIFEST.tools.find((tool) => tool.name === name);
+}
+export function getSidekickToolCount() {
+    return SIDEKICK_MANIFEST.tools.length;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/pack-registration.d.ts

@@ -0,0 +1,14 @@
+import type { SidekickPackManifest } from './manifest-schema.js';
+export declare function computeSidekickPackIntegrity(packRoot?: string, exclusions?: readonly string[]): Promise<`sha256:${string}`>;
+export declare function loadSidekickManifest(packRoot?: string): Promise<SidekickPackManifest>;
+export interface RegisteredSidekickPack {
+    manifest: SidekickPackManifest;
+    packRoot: string;
+    manifestPath: string;
+    integrity: `sha256:${string}`;
+}
+export declare function registerSidekickPack(options?: {
+    packRoot?: string;
+    exclusions?: readonly string[];
+}): Promise<RegisteredSidekickPack>;
+//# sourceMappingURL=pack-registration.d.ts.map

package/dist/pack-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-registration.d.ts","sourceRoot":"","sources":["../pack-registration.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AA8CjE,wBAAsB,4BAA4B,CAChD,QAAQ,SAAuB,EAC/B,UAAU,GAAE,SAAS,MAAM,EAAuB,GACjD,OAAO,CAAC,UAAU,MAAM,EAAE,CAAC,CAmB7B;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,SAAuB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAI/B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,UAAU,MAAM,EAAE,CAAC;CAC/B;AAED,wBAAsB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAYlC"}

package/dist/pack-registration.js

@@ -0,0 +1,79 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { createHash } from 'node:crypto';
+import { readdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { SHA256_ALGORITHM, SIDEKICK_MANIFEST_FILE_NAME, UTF8_ENCODING } from './constants.js';
+import { SIDEKICK_MANIFEST } from './manifest.js';
+const NULL_BYTE_BUFFER = Buffer.from([0]);
+const DEFAULT_EXCLUSIONS = ['node_modules/', '.git/', 'dist/', '.DS_Store'];
+function getDefaultPackRoot() {
+    return path.dirname(fileURLToPath(import.meta.url));
+}
+function normalizeRelativePath(root, absolutePath) {
+    return path.relative(root, absolutePath).split(path.sep).join('/');
+}
+function shouldExclude(relativePath, exclusions) {
+    return exclusions.some((excluded) => {
+        if (excluded.endsWith('/')) {
+            return relativePath.startsWith(excluded);
+        }
+        return relativePath === excluded || relativePath.endsWith(`/${excluded}`);
+    });
+}
+async function collectFilesRecursive(root, directory) {
+    const entries = await readdir(directory, { withFileTypes: true });
+    const sortedEntries = [...entries].sort((left, right) => left.name.localeCompare(right.name));
+    const files = [];
+    for (const entry of sortedEntries) {
+        const absolutePath = path.join(directory, entry.name);
+        const relativePath = normalizeRelativePath(root, absolutePath);
+        if (entry.isDirectory()) {
+            files.push(...(await collectFilesRecursive(root, absolutePath)));
+            continue;
+        }
+        files.push(relativePath);
+    }
+    return files;
+}
+async function listPackFiles(packRoot, exclusions) {
+    const absoluteRoot = path.resolve(packRoot);
+    const allFiles = await collectFilesRecursive(absoluteRoot, absoluteRoot);
+    return allFiles.filter((relativePath) => !shouldExclude(relativePath, exclusions)).sort();
+}
+export async function computeSidekickPackIntegrity(packRoot = getDefaultPackRoot(), exclusions = DEFAULT_EXCLUSIONS) {
+    const absoluteRoot = path.resolve(packRoot);
+    const files = await listPackFiles(absoluteRoot, exclusions);
+    const digestChunks = [];
+    for (const relativePath of files) {
+        const fileContents = await readFile(path.join(absoluteRoot, relativePath));
+        const fileHash = createHash(SHA256_ALGORITHM).update(fileContents).digest('hex');
+        digestChunks.push(Buffer.from(relativePath, UTF8_ENCODING));
+        digestChunks.push(NULL_BYTE_BUFFER);
+        digestChunks.push(Buffer.from(fileHash, UTF8_ENCODING));
+        digestChunks.push(NULL_BYTE_BUFFER);
+    }
+    const combinedDigest = createHash(SHA256_ALGORITHM)
+        .update(digestChunks.length === 0 ? Buffer.alloc(0) : Buffer.concat(digestChunks))
+        .digest('hex');
+    return `sha256:${combinedDigest}`;
+}
+export async function loadSidekickManifest(packRoot = getDefaultPackRoot()) {
+    const manifestPath = path.join(path.resolve(packRoot), SIDEKICK_MANIFEST_FILE_NAME);
+    await readFile(manifestPath, UTF8_ENCODING);
+    return structuredClone(SIDEKICK_MANIFEST);
+}
+export async function registerSidekickPack(options) {
+    const packRoot = path.resolve(options?.packRoot ?? getDefaultPackRoot());
+    const exclusions = options?.exclusions ?? DEFAULT_EXCLUSIONS;
+    const manifest = await loadSidekickManifest(packRoot);
+    const integrity = await computeSidekickPackIntegrity(packRoot, exclusions);
+    return {
+        manifest,
+        packRoot,
+        manifestPath: path.join(packRoot, SIDEKICK_MANIFEST_FILE_NAME),
+        integrity,
+    };
+}
+//# sourceMappingURL=pack-registration.js.map

package/dist/pack-registration.js.map

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

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

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

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

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

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

@@ -0,0 +1,169 @@
+// 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 = {
+    CONFIGURE: 'channel:configure',
+    SEND: 'channel:send',
+    RECEIVE: 'channel:receive',
+};
+const OUTBOX_CAP = 100;
+const DEFAULT_CHANNEL_NAME = 'default';
+// ---------------------------------------------------------------------------
+// channel:configure
+// ---------------------------------------------------------------------------
+async function channelConfigureTool(input, context) {
+    const parsed = toRecord(input);
+    const name = asNonEmptyString(parsed.name);
+    if (!name) {
+        return failure('INVALID_INPUT', 'name is required.');
+    }
+    const now = nowIso();
+    const channel = {
+        id: createId('chan'),
+        name,
+        created_at: now,
+        updated_at: now,
+    };
+    if (isDryRun(parsed)) {
+        return success({
+            dry_run: true,
+            channel: channel,
+        });
+    }
+    const storage = getStoragePort();
+    let resolvedChannel = channel;
+    await storage.withLock(async () => {
+        const channels = await storage.readStore('channels');
+        const existing = channels.find((c) => c.name === name);
+        if (existing) {
+            resolvedChannel = { ...existing, updated_at: now };
+            const updated = channels.map((c) => (c.id === existing.id ? resolvedChannel : c));
+            await storage.writeStore('channels', updated);
+            await storage.appendAudit(buildAuditEvent({
+                tool: TOOL_NAMES.CONFIGURE,
+                op: 'update',
+                context,
+                ids: [existing.id],
+            }));
+        }
+        else {
+            channels.push(channel);
+            await storage.writeStore('channels', channels);
+            await storage.appendAudit(buildAuditEvent({
+                tool: TOOL_NAMES.CONFIGURE,
+                op: 'create',
+                context,
+                ids: [channel.id],
+            }));
+        }
+    });
+    return success({ channel: resolvedChannel });
+}
+// ---------------------------------------------------------------------------
+// channel:send
+// ---------------------------------------------------------------------------
+async function channelSendTool(input, context) {
+    const parsed = toRecord(input);
+    const content = asNonEmptyString(parsed.content);
+    if (!content) {
+        return failure('INVALID_INPUT', 'content is required.');
+    }
+    const channelName = asNonEmptyString(parsed.channel) ?? DEFAULT_CHANNEL_NAME;
+    const sender = asNonEmptyString(parsed.sender) ?? 'assistant';
+    const now = nowIso();
+    const message = {
+        id: createId('msg'),
+        channel_id: '', // resolved below
+        sender,
+        content,
+        created_at: now,
+    };
+    if (isDryRun(parsed)) {
+        return success({
+            dry_run: true,
+            message: { ...message, channel_id: 'dry-run' },
+        });
+    }
+    const storage = getStoragePort();
+    let resolvedMessage = message;
+    await storage.withLock(async () => {
+        const channels = await storage.readStore('channels');
+        const found = channels.find((c) => c.name === channelName);
+        let channelId;
+        if (!found) {
+            channelId = createId('chan');
+            channels.push({
+                id: channelId,
+                name: channelName,
+                created_at: now,
+                updated_at: now,
+            });
+            await storage.writeStore('channels', channels);
+        }
+        else {
+            channelId = found.id;
+            const updated = channels.map((c) => (c.id === channelId ? { ...c, updated_at: now } : c));
+            await storage.writeStore('channels', updated);
+        }
+        resolvedMessage = { ...message, channel_id: channelId };
+        const messages = await storage.readStore('messages');
+        messages.push(resolvedMessage);
+        // Cap outbox at OUTBOX_CAP
+        const capped = messages.length > OUTBOX_CAP ? messages.slice(-OUTBOX_CAP) : messages;
+        await storage.writeStore('messages', capped);
+        await storage.appendAudit(buildAuditEvent({
+            tool: TOOL_NAMES.SEND,
+            op: 'create',
+            context,
+            ids: [channelId, resolvedMessage.id],
+        }));
+    });
+    return success({ message: resolvedMessage });
+}
+// ---------------------------------------------------------------------------
+// channel:receive
+// ---------------------------------------------------------------------------
+async function channelReceiveTool(input, _context) {
+    const parsed = toRecord(input);
+    const channelName = asNonEmptyString(parsed.channel);
+    const limit = asInteger(parsed.limit);
+    const storage = getStoragePort();
+    const messages = await storage.readStore('messages');
+    const channels = await storage.readStore('channels');
+    let filtered = messages;
+    if (channelName) {
+        const channel = channels.find((c) => c.name === channelName);
+        if (channel) {
+            filtered = messages.filter((m) => m.channel_id === channel.id);
+        }
+        else {
+            filtered = [];
+        }
+    }
+    const sorted = filtered.toSorted((a, b) => Date.parse(a.created_at) - Date.parse(b.created_at));
+    const items = limit && limit > 0 ? sorted.slice(-limit) : sorted;
+    return success({
+        items: items,
+        count: items.length,
+    });
+}
+// ---------------------------------------------------------------------------
+// Router (default export)
+// ---------------------------------------------------------------------------
+export default async function channelTools(input, context) {
+    switch (context?.tool_name) {
+        case TOOL_NAMES.CONFIGURE:
+            return channelConfigureTool(input, context);
+        case TOOL_NAMES.SEND:
+            return channelSendTool(input, context);
+        case TOOL_NAMES.RECEIVE:
+            return channelReceiveTool(input, context);
+        default:
+            return failure('UNKNOWN_TOOL', `Unknown channel tool: ${context?.tool_name ?? 'unknown'}`);
+    }
+}
+//# sourceMappingURL=channel-tools.js.map

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

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

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

@@ -0,0 +1,2 @@
+export { type AuditEvent, type ChannelMessageRecord, type ChannelRecord, type MemoryRecord, type MemoryType, type RoutineRecord, type RoutineStepRecord, type SidekickStores, type StoragePort, type StoreName, type TaskPriority, type TaskRecord, type TaskStatus, FsStoragePort, getStoragePort, runWithStoragePort, setDefaultStoragePort, } from './storage.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../tool-impl/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,cAAc,CAAC"}

package/dist/tool-impl/index.js

@@ -0,0 +1,4 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+export { FsStoragePort, getStoragePort, runWithStoragePort, setDefaultStoragePort, } from './storage.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../tool-impl/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,OAAO,EAcL,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,cAAc,CAAC"}

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

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

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

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