@lumenflow/packs-sidekick 3.6.6

package/README.md

@@ -0,0 +1,194 @@
+# Sidekick Pack
+
+Personal productivity pack for the LumenFlow kernel. Provides task management,
+workspace memory, communication channels, routines, and system administration
+tools -- all scoped to a local `.sidekick/` directory.
+
+## Status
+
+**Version**: 0.1.0 (pre-release)
+**License**: AGPL-3.0-only
+
+## Tool Groups
+
+| Group   | Tools                                                        | Description                                 |
+| ------- | ------------------------------------------------------------ | ------------------------------------------- |
+| Task    | `task:create`, `task:list`, `task:complete`, `task:schedule` | Create, query, complete, and schedule tasks |
+| Memory  | `memory:store`, `memory:recall`, `memory:forget`             | Persist and retrieve workspace knowledge    |
+| Channel | `channel:configure`, `channel:send`, `channel:receive`       | Named message channels                      |
+| Routine | `routine:create`, `routine:list`, `routine:run`              | Multi-step tool sequences (plan-only)       |
+| System  | `sidekick:init`, `sidekick:status`, `sidekick:export`        | Bootstrap, health check, data export        |
+
+**Total**: 16 tools
+
+## Key Design Decisions
+
+- **`.sidekick/` is workspace-local storage.** All data lives under the project
+  root in a `.sidekick/` directory managed by the `StoragePort` abstraction.
+- **`routine:run` returns a plan only.** It resolves the routine definition and
+  returns the ordered list of steps with their inputs. It does not execute them.
+- **`sidekick:export` is read-only.** It returns all stored data as a JSON
+  structure. It does not write files to disk.
+- **Every write tool supports `dry_run`.** When `dry_run: true`, the tool
+  validates input and returns what it would do, without persisting changes.
+- **Pack manifest is the contract.** There is no separate contract package. The
+  `manifest.yaml` file defines tool names, schemas, scopes, and policies.
+
+## Manual Smoke Flow
+
+Use this sequence to verify the pack end-to-end after installation or upgrade.
+
+### Prerequisites
+
+- LumenFlow kernel runtime with the sidekick pack registered
+- HTTP surface running (for HTTP dispatch tests)
+
+### Step 1: Initialize
+
+```bash
+# Via kernel tool dispatch (or HTTP POST /tools/sidekick:init)
+tool: sidekick:init
+input: {}
+```
+
+Expected: `{ "success": true, "data": { "initialized": true, "root_dir": ".sidekick" } }`
+
+### Step 2: Create a Task
+
+```bash
+tool: task:create
+input: { "title": "Review docs", "priority": "P1", "tags": ["docs"] }
+```
+
+Expected: `{ "success": true, "data": { "id": "<uuid>", "title": "Review docs", ... } }`
+
+### Step 3: List Tasks
+
+```bash
+tool: task:list
+input: { "status": "pending" }
+```
+
+Expected: Array containing the task from Step 2.
+
+### Step 4: Store a Memory
+
+```bash
+tool: memory:store
+input: { "type": "note", "content": "Sidekick pack validated", "tags": ["smoke-test"] }
+```
+
+Expected: `{ "success": true, "data": { "id": "<uuid>", ... } }`
+
+### Step 5: Recall Memory
+
+```bash
+tool: memory:recall
+input: { "query": "validated", "type": "note" }
+```
+
+Expected: Array containing the memory from Step 4.
+
+### Step 6: Create a Routine
+
+```bash
+tool: routine:create
+input: {
+  "name": "daily-review",
+  "steps": [
+    { "tool": "task:list", "input": { "status": "pending" } },
+    { "tool": "sidekick:status", "input": {} }
+  ]
+}
+```
+
+Expected: `{ "success": true, "data": { "id": "<uuid>", "name": "daily-review", ... } }`
+
+### Step 7: Run Routine (plan-only)
+
+```bash
+tool: routine:run
+input: { "id": "<routine-id-from-step-6>" }
+```
+
+Expected: A plan object listing the two steps with their resolved inputs. No
+side-effects -- the steps are NOT executed.
+
+### Step 8: Check Status
+
+```bash
+tool: sidekick:status
+input: {}
+```
+
+Expected: Summary showing `task_count >= 1`, `memory_entries >= 1`,
+`routines >= 1`.
+
+### Step 9: Export
+
+```bash
+tool: sidekick:export
+input: { "include_audit": true }
+```
+
+Expected: Full JSON dump of all stores including audit trail from prior steps.
+
+### Step 10: Complete the Task
+
+```bash
+tool: task:complete
+input: { "id": "<task-id-from-step-2>", "note": "Smoke test passed" }
+```
+
+Expected: `{ "success": true, "data": { "status": "done", ... } }`
+
+### Step 11: Verify via HTTP Surface
+
+```bash
+curl -X POST http://localhost:<port>/tools/sidekick:status \
+  -H "Content-Type: application/json" \
+  -d '{ "context": { "task_id": "smoke-test", "workspace_id": "test" } }'
+```
+
+Expected: HTTP 200 with the same status payload as Step 8.
+
+### Dry Run Verification
+
+Repeat Step 2 with `"dry_run": true` added to the input. Verify that the
+response includes `"dry_run": true` and that `task:list` does not return the
+dry-run task.
+
+## Validation
+
+```bash
+# Schema and integrity validation
+pnpm pack:validate --id sidekick
+
+# Unit tests (119 tests across 3 suites)
+npx vitest run packages/@lumenflow/packs/sidekick/__tests__/
+
+# HTTP surface tests (13 tests)
+npx vitest run packages/@lumenflow/surfaces/http/__tests__/tool-api.test.ts
+```
+
+## Storage Architecture
+
+The pack uses a `StoragePort` abstraction with a filesystem adapter
+(`FsStoragePort`). Each store (tasks, memories, channels, messages, routines)
+is a JSON array file under `.sidekick/`. An append-only `audit.jsonl` file
+records every tool invocation.
+
+```
+.sidekick/
+  tasks.json
+  memories.json
+  channels.json
+  messages.json
+  routines.json
+  audit.jsonl
+```
+
+## Contributing
+
+This pack follows the LumenFlow development workflow. See the root `CLAUDE.md`
+and `LUMENFLOW.md` for contribution guidelines.

package/dist/constants.d.ts

@@ -0,0 +1,8 @@
+export declare const SIDEKICK_PACK_ID: "sidekick";
+export declare const SIDEKICK_PACK_VERSION: "0.1.0";
+export declare const SIDEKICK_DOMAIN: "sidekick";
+export declare const SIDEKICK_POLICY_ID_PREFIX: "sidekick.policy";
+export declare const SIDEKICK_MANIFEST_FILE_NAME: "manifest.yaml";
+export declare const SHA256_ALGORITHM: "sha256";
+export declare const UTF8_ENCODING: "utf8";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,EAAG,UAAmB,CAAC;AACpD,eAAO,MAAM,qBAAqB,EAAG,OAAgB,CAAC;AACtD,eAAO,MAAM,eAAe,YAAmB,CAAC;AAChD,eAAO,MAAM,yBAAyB,mBAAwC,CAAC;AAC/E,eAAO,MAAM,2BAA2B,EAAG,eAAwB,CAAC;AACpE,eAAO,MAAM,gBAAgB,EAAG,QAAiB,CAAC;AAClD,eAAO,MAAM,aAAa,EAAG,MAAe,CAAC"}

package/dist/constants.js

@@ -0,0 +1,10 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+export const SIDEKICK_PACK_ID = 'sidekick';
+export const SIDEKICK_PACK_VERSION = '0.1.0';
+export const SIDEKICK_DOMAIN = SIDEKICK_PACK_ID;
+export const SIDEKICK_POLICY_ID_PREFIX = `${SIDEKICK_PACK_ID}.policy`;
+export const SIDEKICK_MANIFEST_FILE_NAME = 'manifest.yaml';
+export const SHA256_ALGORITHM = 'sha256';
+export const UTF8_ENCODING = 'utf8';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../constants.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAmB,CAAC;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAgB,CAAC;AACtD,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAChD,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,gBAAgB,SAAkB,CAAC;AAC/E,MAAM,CAAC,MAAM,2BAA2B,GAAG,eAAwB,CAAC;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAiB,CAAC;AAClD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAe,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './constants.js';
+export * from './manifest.js';
+export * from './manifest-schema.js';
+export * from './pack-registration.js';
+export * from './tools/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAGA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+export * from './constants.js';
+export * from './manifest.js';
+export * from './manifest-schema.js';
+export * from './pack-registration.js';
+export * from './tools/types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC"}

package/dist/manifest-schema.d.ts

@@ -0,0 +1,48 @@
+import { type PathScope, type ToolPermission } from './tools/types.js';
+interface Parser<T> {
+    parse(input: unknown): T;
+}
+export declare const MANIFEST_POLICY_TRIGGERS: {
+    readonly ON_TOOL_REQUEST: "on_tool_request";
+    readonly ON_CLAIM: "on_claim";
+    readonly ON_COMPLETION: "on_completion";
+    readonly ON_EVIDENCE_ADDED: "on_evidence_added";
+};
+export type ManifestPolicyTrigger = (typeof MANIFEST_POLICY_TRIGGERS)[keyof typeof MANIFEST_POLICY_TRIGGERS];
+export declare const MANIFEST_POLICY_DECISIONS: {
+    readonly ALLOW: "allow";
+    readonly DENY: "deny";
+};
+export type ManifestPolicyDecision = (typeof MANIFEST_POLICY_DECISIONS)[keyof typeof MANIFEST_POLICY_DECISIONS];
+export interface SidekickManifestTool {
+    name: string;
+    entry: string;
+    permission: ToolPermission;
+    required_scopes: PathScope[];
+    input_schema?: Record<string, unknown>;
+    output_schema?: Record<string, unknown>;
+    internal_only?: boolean;
+}
+export interface SidekickManifestPolicy {
+    id: string;
+    trigger: ManifestPolicyTrigger;
+    decision: ManifestPolicyDecision;
+    reason?: string;
+}
+export interface SidekickPackManifest {
+    id: string;
+    version: string;
+    config_key?: string;
+    config_schema?: string;
+    task_types: string[];
+    tools: SidekickManifestTool[];
+    policies: SidekickManifestPolicy[];
+    evidence_types: string[];
+    state_aliases: Record<string, string>;
+    lane_templates: Array<{
+        id: string;
+    }>;
+}
+export declare const SidekickManifestSchema: Parser<SidekickPackManifest>;
+export {};
+//# sourceMappingURL=manifest-schema.d.ts.map

package/dist/manifest-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.d.ts","sourceRoot":"","sources":["../manifest-schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAE1B,UAAU,MAAM,CAAC,CAAC;IAChB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;CAC1B;AAED,eAAO,MAAM,wBAAwB;;;;;CAK3B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC/B,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAE3E,eAAO,MAAM,yBAAyB;;;CAG5B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAChC,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,OAAO,yBAAyB,CAAC,CAAC;AAE7E,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,cAAc,CAAC;IAC3B,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,sBAAsB,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IACnC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,cAAc,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvC;AAwJD,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,oBAAoB,CAgD/D,CAAC"}

package/dist/manifest-schema.js

@@ -0,0 +1,177 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { TOOL_PERMISSIONS, TOOL_SCOPE_ACCESS, TOOL_SCOPE_TYPES, } from './tools/types.js';
+export const MANIFEST_POLICY_TRIGGERS = {
+    ON_TOOL_REQUEST: 'on_tool_request',
+    ON_CLAIM: 'on_claim',
+    ON_COMPLETION: 'on_completion',
+    ON_EVIDENCE_ADDED: 'on_evidence_added',
+};
+export const MANIFEST_POLICY_DECISIONS = {
+    ALLOW: 'allow',
+    DENY: 'deny',
+};
+function asRecord(input, label) {
+    if (!input || typeof input !== 'object' || Array.isArray(input)) {
+        throw new Error(`${label} must be an object.`);
+    }
+    return input;
+}
+function parseNonEmptyString(value, label) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new Error(`${label} must be a non-empty string.`);
+    }
+    return value;
+}
+function parseStringArray(value, label) {
+    if (!Array.isArray(value)) {
+        throw new Error(`${label} must be an array.`);
+    }
+    return value.map((entry, index) => parseNonEmptyString(entry, `${label}[${index}]`));
+}
+function parseJsonSchemaObject(value, label) {
+    return asRecord(value, label);
+}
+function isSemver(value) {
+    let core = value;
+    const prereleaseIndex = core.indexOf('-');
+    if (prereleaseIndex >= 0) {
+        core = core.slice(0, prereleaseIndex);
+    }
+    const metadataIndex = core.indexOf('+');
+    if (metadataIndex >= 0) {
+        core = core.slice(0, metadataIndex);
+    }
+    const parts = core.split('.');
+    if (parts.length !== 3) {
+        return false;
+    }
+    return parts.every((part) => part.length > 0 && [...part].every((char) => char >= '0' && char <= '9'));
+}
+const ALLOWED_POLICY_TRIGGERS = new Set(Object.values(MANIFEST_POLICY_TRIGGERS));
+const ALLOWED_POLICY_DECISIONS = new Set(Object.values(MANIFEST_POLICY_DECISIONS));
+const ALLOWED_TOOL_PERMISSIONS = new Set(Object.values(TOOL_PERMISSIONS));
+function parsePathScope(input, label) {
+    const scope = asRecord(input, label);
+    const type = parseNonEmptyString(scope.type, `${label}.type`);
+    const pattern = parseNonEmptyString(scope.pattern, `${label}.pattern`);
+    const access = parseNonEmptyString(scope.access, `${label}.access`);
+    if (type !== TOOL_SCOPE_TYPES.PATH) {
+        throw new Error(`${label}.type must be "${TOOL_SCOPE_TYPES.PATH}".`);
+    }
+    if (access !== TOOL_SCOPE_ACCESS.READ && access !== TOOL_SCOPE_ACCESS.WRITE) {
+        throw new Error(`${label}.access must be "${TOOL_SCOPE_ACCESS.READ}" or "${TOOL_SCOPE_ACCESS.WRITE}".`);
+    }
+    return {
+        type: TOOL_SCOPE_TYPES.PATH,
+        pattern,
+        access,
+    };
+}
+function parseRequiredScopes(value, label) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new Error(`${label} must be a non-empty array.`);
+    }
+    return value.map((entry, index) => parsePathScope(entry, `${label}[${index}]`));
+}
+function parsePolicy(input, index) {
+    const policy = asRecord(input, `policies[${index}]`);
+    const trigger = parseNonEmptyString(policy.trigger, `policies[${index}].trigger`);
+    const decision = parseNonEmptyString(policy.decision, `policies[${index}].decision`);
+    if (!ALLOWED_POLICY_TRIGGERS.has(trigger)) {
+        throw new Error(`policies[${index}].trigger is invalid.`);
+    }
+    if (!ALLOWED_POLICY_DECISIONS.has(decision)) {
+        throw new Error(`policies[${index}].decision is invalid.`);
+    }
+    return {
+        id: parseNonEmptyString(policy.id, `policies[${index}].id`),
+        trigger: trigger,
+        decision: decision,
+        reason: policy.reason === undefined
+            ? undefined
+            : parseNonEmptyString(policy.reason, `policies[${index}].reason`),
+    };
+}
+function parseTool(input, index) {
+    const tool = asRecord(input, `tools[${index}]`);
+    const permission = tool.permission === undefined
+        ? TOOL_PERMISSIONS.READ
+        : parseNonEmptyString(tool.permission, `tools[${index}].permission`);
+    if (!ALLOWED_TOOL_PERMISSIONS.has(permission)) {
+        throw new Error(`tools[${index}].permission is invalid.`);
+    }
+    return {
+        name: parseNonEmptyString(tool.name, `tools[${index}].name`),
+        entry: parseNonEmptyString(tool.entry, `tools[${index}].entry`),
+        permission: permission,
+        required_scopes: parseRequiredScopes(tool.required_scopes, `tools[${index}].required_scopes`),
+        input_schema: tool.input_schema === undefined
+            ? undefined
+            : parseJsonSchemaObject(tool.input_schema, `tools[${index}].input_schema`),
+        output_schema: tool.output_schema === undefined
+            ? undefined
+            : parseJsonSchemaObject(tool.output_schema, `tools[${index}].output_schema`),
+        internal_only: tool.internal_only === undefined
+            ? undefined
+            : (() => {
+                if (typeof tool.internal_only !== 'boolean') {
+                    throw new Error(`tools[${index}].internal_only must be boolean.`);
+                }
+                return tool.internal_only;
+            })(),
+    };
+}
+function parseStateAliases(input) {
+    const aliases = asRecord(input ?? {}, 'state_aliases');
+    const parsed = {};
+    for (const [key, value] of Object.entries(aliases)) {
+        parsed[parseNonEmptyString(key, 'state_aliases key')] = parseNonEmptyString(value, `state_aliases.${key}`);
+    }
+    return parsed;
+}
+export const SidekickManifestSchema = {
+    parse(input) {
+        const manifest = asRecord(input, 'manifest');
+        const version = parseNonEmptyString(manifest.version, 'version');
+        if (!isSemver(version)) {
+            throw new Error('version must be semver.');
+        }
+        const taskTypes = parseStringArray(manifest.task_types, 'task_types');
+        if (taskTypes.length === 0) {
+            throw new Error('task_types must include at least one item.');
+        }
+        const toolsValue = manifest.tools ?? [];
+        if (!Array.isArray(toolsValue)) {
+            throw new Error('tools must be an array.');
+        }
+        const policiesValue = manifest.policies ?? [];
+        if (!Array.isArray(policiesValue)) {
+            throw new Error('policies must be an array.');
+        }
+        const laneTemplatesValue = manifest.lane_templates ?? [];
+        if (!Array.isArray(laneTemplatesValue)) {
+            throw new Error('lane_templates must be an array.');
+        }
+        return {
+            id: parseNonEmptyString(manifest.id, 'id'),
+            version,
+            config_key: manifest.config_key === undefined
+                ? undefined
+                : parseNonEmptyString(manifest.config_key, 'config_key'),
+            config_schema: manifest.config_schema === undefined
+                ? undefined
+                : parseNonEmptyString(manifest.config_schema, 'config_schema'),
+            task_types: taskTypes,
+            tools: toolsValue.map((tool, index) => parseTool(tool, index)),
+            policies: policiesValue.map((policy, index) => parsePolicy(policy, index)),
+            evidence_types: parseStringArray(manifest.evidence_types ?? [], 'evidence_types'),
+            state_aliases: parseStateAliases(manifest.state_aliases),
+            lane_templates: laneTemplatesValue.map((laneTemplate, index) => {
+                const entry = asRecord(laneTemplate, `lane_templates[${index}]`);
+                return { id: parseNonEmptyString(entry.id, `lane_templates[${index}].id`) };
+            }),
+        };
+    },
+};
+//# sourceMappingURL=manifest-schema.js.map

package/dist/manifest-schema.js.map

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

package/dist/manifest.d.ts

@@ -0,0 +1,26 @@
+import { type SidekickManifestTool, type SidekickPackManifest } from './manifest-schema.js';
+declare const TOOL_PERMISSIONS_MAP: {
+    readonly 'task:create': "write";
+    readonly 'task:list': "read";
+    readonly 'task:complete': "write";
+    readonly 'task:schedule': "write";
+    readonly 'memory:store': "write";
+    readonly 'memory:recall': "read";
+    readonly 'memory:forget': "write";
+    readonly 'channel:configure': "write";
+    readonly 'channel:send': "write";
+    readonly 'channel:receive': "read";
+    readonly 'routine:create': "write";
+    readonly 'routine:list': "read";
+    readonly 'routine:run': "read";
+    readonly 'sidekick:init': "write";
+    readonly 'sidekick:status': "read";
+    readonly 'sidekick:export': "read";
+};
+type SidekickToolName = keyof typeof TOOL_PERMISSIONS_MAP;
+export declare const SIDEKICK_TOOL_NAMES: SidekickToolName[];
+export declare const SIDEKICK_MANIFEST: SidekickPackManifest;
+export declare function getSidekickManifestToolByName(name: string): SidekickManifestTool | undefined;
+export declare function getSidekickToolCount(): number;
+export {};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../manifest.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AA6B9B,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;CAsByB,CAAC;AAEpD,KAAK,gBAAgB,GAAG,MAAM,OAAO,oBAAoB,CAAC;AA8O1D,eAAO,MAAM,mBAAmB,EAAwC,gBAAgB,EAAE,CAAC;AAqB3F,eAAO,MAAM,iBAAiB,EAAE,oBAE/B,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAE5F;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}