@shuyhere/takotako 0.0.1

package/dist/agents/model-catalog.js

@@ -0,0 +1,79 @@
+/**
+ * Per-agent model catalog — cache available models with metadata.
+ *
+ * Stored at: ~/.tako/agents/<id>/agent/models.json
+ *
+ * Populated during onboard or when the agent first queries models.
+ * Used by Model Picker and /models command.
+ * Refresh on demand via `tako models --refresh`.
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+// ─── Paths ──────────────────────────────────────────────────────────
+function getCatalogPath(agentId) {
+    return join(homedir(), '.tako', 'agents', agentId, 'agent', 'models.json');
+}
+// ─── Read / Write ───────────────────────────────────────────────────
+export async function loadModelCatalog(agentId) {
+    const filePath = getCatalogPath(agentId);
+    if (!existsSync(filePath)) {
+        return { providers: {} };
+    }
+    try {
+        const raw = await readFile(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return { providers: {} };
+    }
+}
+export async function saveModelCatalog(agentId, catalog) {
+    const filePath = getCatalogPath(agentId);
+    const dir = join(filePath, '..');
+    await mkdir(dir, { recursive: true });
+    await writeFile(filePath, JSON.stringify(catalog, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Update a single provider's model list in the catalog.
+ */
+export async function updateProviderModels(agentId, provider, models) {
+    const catalog = await loadModelCatalog(agentId);
+    catalog.providers[provider] = {
+        models,
+        lastRefreshed: new Date().toISOString(),
+    };
+    await saveModelCatalog(agentId, catalog);
+}
+/**
+ * Get all models across all providers for an agent.
+ */
+export async function getAllModels(agentId) {
+    const catalog = await loadModelCatalog(agentId);
+    const result = [];
+    for (const [provider, data] of Object.entries(catalog.providers)) {
+        for (const model of data.models) {
+            result.push({ provider, model });
+        }
+    }
+    return result;
+}
+/**
+ * Find a specific model by ID across all providers.
+ */
+export async function findModel(agentId, modelId) {
+    const all = await getAllModels(agentId);
+    return all.find((m) => m.model.id === modelId) ?? null;
+}
+/**
+ * Seed the catalog with well-known Anthropic models.
+ */
+export function getDefaultAnthropicModels() {
+    return [
+        { id: 'claude-sonnet-4-6', contextWindow: 200000, maxTokens: 8192, reasoning: false, input: ['text', 'image'] },
+        { id: 'claude-haiku-4-5-20251001', contextWindow: 200000, maxTokens: 8192, reasoning: false, input: ['text', 'image'] },
+        { id: 'claude-opus-4-6', contextWindow: 200000, maxTokens: 8192, reasoning: false, input: ['text', 'image'] },
+    ];
+}
+//# sourceMappingURL=model-catalog.js.map

package/dist/agents/model-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.js","sourceRoot":"","sources":["../../src/agents/model-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAuBrC,uEAAuE;AAEvE,SAAS,cAAc,CAAC,OAAe;IACrC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;AAC7E,CAAC;AAED,uEAAuE;AAEvE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAe;IACpD,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAe,EAAE,OAAqB;IAC3E,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAe,EACf,QAAgB,EAChB,MAAoB;IAEpB,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAChD,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG;QAC5B,MAAM;QACN,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACxC,CAAC;IACF,MAAM,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe;IAChD,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,MAAM,GAA8C,EAAE,CAAC;IAC7D,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACjE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAAe,EACf,OAAe;IAEf,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,IAAI,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,EAAE,EAAE,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;QAC/G,EAAE,EAAE,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;QACvH,EAAE,EAAE,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;KAC9G,CAAC;AACJ,CAAC"}

package/dist/agents/registry.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Agent registry — manages multiple isolated agent brains.
+ *
+ * Each agent has its own workspace, state directory, session store,
+ * and config overrides. The "main" agent always exists.
+ */
+import type { AgentsConfig, AgentEntry } from '../config/schema.js';
+import type { AgentDescriptor } from './config.js';
+export declare class AgentRegistry {
+    private agents;
+    private baseDir;
+    private defaultModel;
+    private defaultWorkspace;
+    constructor(config: AgentsConfig, defaultModel: string);
+    /** Discover agents on disk that aren't in the config. */
+    private scanDiskAgents;
+    /** Build a resolved AgentDescriptor from a config entry. */
+    private buildDescriptor;
+    /** Initialize directories for all agents. */
+    initialize(): Promise<void>;
+    /**
+     * Bootstrap a full agent workspace with rich templates.
+     * Creates workspace directory, memory subdirectory, sessions directory,
+     * and writes all template files (AGENTS.md, SOUL.md, IDENTITY.md,
+     * USER.md, TOOLS.md, HEARTBEAT.md, BOOTSTRAP.md, memory/MEMORY.md).
+     * Never overwrites existing files.
+     */
+    private ensureWorkspaceAndSessions;
+    /** Get an agent descriptor by ID. */
+    get(id: string): AgentDescriptor | undefined;
+    /** Get the main agent. */
+    getMain(): AgentDescriptor;
+    /** List all registered agents. */
+    list(): AgentDescriptor[];
+    /** Check if an agent exists. */
+    has(id: string): boolean;
+    /**
+     * Add a new agent at runtime.
+     * Creates workspace and state directories.
+     */
+    add(entry: AgentEntry): Promise<AgentDescriptor>;
+    /**
+     * Remove an agent.
+     * Removes state directory but preserves workspace (user data).
+     */
+    remove(id: string): Promise<boolean>;
+    /**
+     * Change an agent's role at runtime.
+     * Persists the change to agent.json.
+     */
+    setRole(id: string, role: string): Promise<void>;
+    /** Get agent info as a summary object. */
+    info(id: string): Record<string, unknown> | undefined;
+    /**
+     * Load dynamically-added agents from the state directory.
+     * Agents added via `add()` persist an agent.json file.
+     */
+    loadDynamic(): Promise<void>;
+    /**
+     * Save channel configuration for an agent.
+     * Stored in ~/.tako/agents/<id>/channels.json with restricted permissions (0600).
+     * Merges with existing config so multiple channel types can coexist.
+     */
+    saveChannelConfig(agentId: string, channelType: string, config: Record<string, unknown>): Promise<void>;
+    /**
+     * Load channel configuration for an agent.
+     * Returns the parsed channels.json or null if not found.
+     */
+    loadChannelConfig(agentId: string): Promise<Record<string, unknown> | null>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/agents/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/agents/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAWnD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM;IAuBtD,yDAAyD;IACzD,OAAO,CAAC,cAAc;IAiBtB,4DAA4D;IAC5D,OAAO,CAAC,eAAe;IAoBvB,6CAA6C;IACvC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAcjC;;;;;;OAMG;YACW,0BAA0B;IA8BxC,qCAAqC;IACrC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI5C,0BAA0B;IAC1B,OAAO,IAAI,eAAe;IAI1B,kCAAkC;IAClC,IAAI,IAAI,eAAe,EAAE;IAIzB,gCAAgC;IAChC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;;OAGG;IACG,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC;IAyBtD;;;OAGG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB1C;;;OAGG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBtD,0CAA0C;IAC1C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAiBrD;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BlC;;;;OAIG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC;IAuBhB;;;OAGG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAclF"}

package/dist/agents/registry.js

@@ -0,0 +1,297 @@
+/**
+ * Agent registry — manages multiple isolated agent brains.
+ *
+ * Each agent has its own workspace, state directory, session store,
+ * and config overrides. The "main" agent always exists.
+ */
+import { mkdir, rm, readdir, writeFile, readFile, chmod } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { generateWorkspaceTemplates } from './templates.js';
+/** Expand ~ to home directory. */
+function expandHome(p) {
+    if (p.startsWith('~/') || p === '~') {
+        return join(homedir(), p.slice(1));
+    }
+    return p;
+}
+export class AgentRegistry {
+    agents = new Map();
+    baseDir;
+    defaultModel;
+    defaultWorkspace;
+    constructor(config, defaultModel) {
+        this.baseDir = expandHome('~/.tako/agents');
+        this.defaultModel = defaultModel;
+        this.defaultWorkspace = expandHome(config.defaults.workspace);
+        // Always register the "main" agent
+        this.agents.set('main', this.buildDescriptor({
+            id: 'main',
+            workspace: config.defaults.workspace,
+            model: config.defaults.model,
+            description: 'Primary Tako agent',
+        }, true));
+        // Register agents from config
+        for (const entry of config.list) {
+            if (entry.id === 'main')
+                continue; // Don't override main
+            this.agents.set(entry.id, this.buildDescriptor(entry, false));
+        }
+        // Scan ~/.tako/agents/ for agents created at runtime but not in config
+        this.scanDiskAgents();
+    }
+    /** Discover agents on disk that aren't in the config. */
+    scanDiskAgents() {
+        try {
+            const { readdirSync, readFileSync } = require('fs');
+            const entries = readdirSync(this.baseDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory() || entry.name === 'main' || this.agents.has(entry.name))
+                    continue;
+                const agentJsonPath = join(this.baseDir, entry.name, 'agent.json');
+                try {
+                    const raw = readFileSync(agentJsonPath, 'utf-8');
+                    const agentData = JSON.parse(raw);
+                    agentData.id = agentData.id || entry.name;
+                    this.agents.set(agentData.id, this.buildDescriptor(agentData, false));
+                }
+                catch { /* no agent.json or malformed */ }
+            }
+        }
+        catch { /* baseDir doesn't exist yet */ }
+    }
+    /** Build a resolved AgentDescriptor from a config entry. */
+    buildDescriptor(entry, isMain) {
+        const workspace = expandHome(entry.workspace ?? this.defaultWorkspace);
+        const stateDir = join(this.baseDir, entry.id);
+        const sessionDir = join(stateDir, 'sessions');
+        return {
+            id: entry.id,
+            workspace: isMain ? this.defaultWorkspace : workspace,
+            stateDir,
+            sessionDir,
+            model: entry.model?.primary ?? this.defaultModel,
+            bindings: entry.bindings ?? {},
+            canSpawn: entry.canSpawn ?? [],
+            description: entry.description ?? '',
+            isMain,
+            role: isMain ? 'admin' : (entry.role ?? 'standard'),
+            skills: entry.skills,
+        };
+    }
+    /** Initialize directories for all agents. */
+    async initialize() {
+        await mkdir(this.baseDir, { recursive: true });
+        for (const agent of this.agents.values()) {
+            await mkdir(agent.stateDir, { recursive: true });
+            await mkdir(agent.sessionDir, { recursive: true });
+            // Bootstrap workspace for non-main agents
+            if (!agent.isMain) {
+                await this.ensureWorkspaceAndSessions(agent);
+            }
+        }
+    }
+    /**
+     * Bootstrap a full agent workspace with rich templates.
+     * Creates workspace directory, memory subdirectory, sessions directory,
+     * and writes all template files (AGENTS.md, SOUL.md, IDENTITY.md,
+     * USER.md, TOOLS.md, HEARTBEAT.md, BOOTSTRAP.md, memory/MEMORY.md).
+     * Never overwrites existing files.
+     */
+    async ensureWorkspaceAndSessions(agent) {
+        // Create workspace + memory + sessions dirs
+        await mkdir(agent.workspace, { recursive: true });
+        await mkdir(join(agent.workspace, 'memory'), { recursive: true });
+        await mkdir(agent.sessionDir, { recursive: true });
+        // Generate workspace templates for the new agent
+        const templates = generateWorkspaceTemplates({
+            agentId: agent.id,
+            description: agent.description || undefined,
+            model: agent.model,
+            role: agent.role,
+        });
+        // Write each template file (never overwrite existing)
+        for (const [relativePath, content] of Object.entries(templates)) {
+            const filePath = join(agent.workspace, relativePath);
+            if (!existsSync(filePath)) {
+                await writeFile(filePath, content, 'utf-8');
+            }
+        }
+        // Create today's daily log
+        const today = new Date().toISOString().slice(0, 10);
+        const dailyPath = join(agent.workspace, 'memory', `${today}.md`);
+        if (!existsSync(dailyPath)) {
+            await writeFile(dailyPath, `# Daily Log — ${today}\n\nAgent: ${agent.id}\n\n`, 'utf-8');
+        }
+    }
+    /** Get an agent descriptor by ID. */
+    get(id) {
+        return this.agents.get(id);
+    }
+    /** Get the main agent. */
+    getMain() {
+        return this.agents.get('main');
+    }
+    /** List all registered agents. */
+    list() {
+        return Array.from(this.agents.values());
+    }
+    /** Check if an agent exists. */
+    has(id) {
+        return this.agents.has(id);
+    }
+    /**
+     * Add a new agent at runtime.
+     * Creates workspace and state directories.
+     */
+    async add(entry) {
+        if (this.agents.has(entry.id)) {
+            throw new Error(`Agent already exists: ${entry.id}`);
+        }
+        if (entry.id === 'main') {
+            throw new Error('Cannot create an agent with reserved ID "main"');
+        }
+        const descriptor = this.buildDescriptor(entry, false);
+        // Create state directory + full workspace with rich templates
+        await mkdir(descriptor.stateDir, { recursive: true });
+        await this.ensureWorkspaceAndSessions(descriptor);
+        // Persist agent entry to state dir
+        await writeFile(join(descriptor.stateDir, 'agent.json'), JSON.stringify(entry, null, 2), 'utf-8');
+        this.agents.set(entry.id, descriptor);
+        return descriptor;
+    }
+    /**
+     * Remove an agent.
+     * Removes state directory but preserves workspace (user data).
+     */
+    async remove(id) {
+        if (id === 'main') {
+            throw new Error('Cannot remove the main agent');
+        }
+        const agent = this.agents.get(id);
+        if (!agent)
+            return false;
+        // Remove state directory (sessions, config)
+        if (existsSync(agent.stateDir)) {
+            await rm(agent.stateDir, { recursive: true, force: true });
+        }
+        this.agents.delete(id);
+        return true;
+    }
+    /**
+     * Change an agent's role at runtime.
+     * Persists the change to agent.json.
+     */
+    async setRole(id, role) {
+        if (id === 'main') {
+            throw new Error('Cannot change the main agent\'s role');
+        }
+        const agent = this.agents.get(id);
+        if (!agent) {
+            throw new Error(`Agent not found: ${id}`);
+        }
+        agent.role = role;
+        // Persist to agent.json
+        const agentJsonPath = join(agent.stateDir, 'agent.json');
+        if (existsSync(agentJsonPath)) {
+            const raw = await readFile(agentJsonPath, 'utf-8');
+            const entry = JSON.parse(raw);
+            entry.role = role;
+            await writeFile(agentJsonPath, JSON.stringify(entry, null, 2), 'utf-8');
+        }
+    }
+    /** Get agent info as a summary object. */
+    info(id) {
+        const agent = this.agents.get(id);
+        if (!agent)
+            return undefined;
+        return {
+            id: agent.id,
+            workspace: agent.workspace,
+            stateDir: agent.stateDir,
+            sessionDir: agent.sessionDir,
+            model: agent.model,
+            bindings: agent.bindings,
+            canSpawn: agent.canSpawn,
+            description: agent.description,
+            isMain: agent.isMain,
+        };
+    }
+    /**
+     * Load dynamically-added agents from the state directory.
+     * Agents added via `add()` persist an agent.json file.
+     */
+    async loadDynamic() {
+        if (!existsSync(this.baseDir))
+            return;
+        let dirs;
+        try {
+            dirs = await readdir(this.baseDir);
+        }
+        catch {
+            return;
+        }
+        for (const dir of dirs) {
+            if (this.agents.has(dir))
+                continue;
+            if (dir === 'main')
+                continue;
+            const agentJsonPath = join(this.baseDir, dir, 'agent.json');
+            if (!existsSync(agentJsonPath))
+                continue;
+            try {
+                const raw = await readFile(agentJsonPath, 'utf-8');
+                const entry = JSON.parse(raw);
+                this.agents.set(entry.id, this.buildDescriptor(entry, false));
+            }
+            catch {
+                // Corrupt agent.json — skip
+            }
+        }
+    }
+    /**
+     * Save channel configuration for an agent.
+     * Stored in ~/.tako/agents/<id>/channels.json with restricted permissions (0600).
+     * Merges with existing config so multiple channel types can coexist.
+     */
+    async saveChannelConfig(agentId, channelType, config) {
+        const agent = this.agents.get(agentId);
+        if (!agent) {
+            throw new Error(`Agent not found: ${agentId}`);
+        }
+        const channelsPath = join(agent.stateDir, 'channels.json');
+        // Load existing config or start fresh
+        let existing = {};
+        if (existsSync(channelsPath)) {
+            try {
+                const raw = await readFile(channelsPath, 'utf-8');
+                existing = JSON.parse(raw);
+            }
+            catch { /* start fresh */ }
+        }
+        existing[channelType] = config;
+        await writeFile(channelsPath, JSON.stringify(existing, null, 2), 'utf-8');
+        await chmod(channelsPath, 0o600);
+    }
+    /**
+     * Load channel configuration for an agent.
+     * Returns the parsed channels.json or null if not found.
+     */
+    async loadChannelConfig(agentId) {
+        const agent = this.agents.get(agentId);
+        if (!agent)
+            return null;
+        const channelsPath = join(agent.stateDir, 'channels.json');
+        if (!existsSync(channelsPath))
+            return null;
+        try {
+            const raw = await readFile(channelsPath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/agents/registry.js.map

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

package/dist/agents/roles.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Agent permission roles for Tako.
+ *
+ * The root agent (created at first onboarding) has admin permissions.
+ * Sub-agents are created with a specific role that limits what they can do.
+ *
+ * Predefined roles:
+ *   admin      — full control: create/delete agents, manage roles, all tools, config
+ *   operator   — manage agents and run all tools, but can't change roles or config
+ *   editor     — read/write files, safe commands, no exec or config changes
+ *   standard   — use all tools, can spawn sub-agents from its allowlist
+ *   viewer     — read-only access, search and memory tools
+ *   restricted — limited tools (no exec, no file write outside workspace)
+ *   readonly   — can only read files and respond, no side effects
+ *
+ * Per-user role overrides: map platform user IDs to specific roles.
+ * Config: agents.list[].roles: { default: RoleName; users?: Record<string, RoleName> }
+ *
+ * Custom roles can be created by the root agent at runtime.
+ */
+export type RoleName = 'admin' | 'operator' | 'editor' | 'standard' | 'viewer' | 'restricted' | 'readonly';
+export interface AgentRole {
+    /** Role identifier. */
+    name: string;
+    /** Human-readable description. */
+    description: string;
+    /** Tool allowlist (empty = all tools). Checked at execution time. */
+    allowTools: string[];
+    /** Tool denylist (takes priority over allow). */
+    denyTools: string[];
+    /** Can this agent create other agents? */
+    canCreateAgents: boolean;
+    /** Can this agent delete other agents? */
+    canDeleteAgents: boolean;
+    /** Can this agent change roles of other agents? */
+    canManageRoles: boolean;
+    /** Can this agent modify Tako config? */
+    canEditConfig: boolean;
+    /** Can this agent use exec/shell tools? */
+    canExec: boolean;
+    /** Can this agent write files outside its workspace? */
+    canWriteGlobal: boolean;
+    /** Can this agent connect to channels? */
+    canBindChannels: boolean;
+}
+/** Per-agent role configuration with per-user overrides. */
+export interface AgentRoleConfig {
+    /** Default role for this agent. */
+    default: RoleName;
+    /** Per-user role overrides (keyed by platform user ID, e.g. Discord or Telegram ID). */
+    users?: Record<string, RoleName>;
+}
+/** Predefined roles. */
+export declare const PREDEFINED_ROLES: Record<string, AgentRole>;
+/** Check if a tool call is allowed for a given role. */
+export declare function isToolAllowed(role: AgentRole, toolName: string): boolean;
+/** Get a role by name (predefined or custom). */
+export declare function getRole(name: string, customRoles?: Record<string, AgentRole>): AgentRole | null;
+/** List all available role names. */
+export declare function listRoles(customRoles?: Record<string, AgentRole>): string[];
+/**
+ * Resolve the effective role for a user interacting with an agent.
+ *
+ * Resolution order:
+ * 1. Per-user override in AgentRoleConfig.users
+ * 2. Agent's default role (AgentRoleConfig.default)
+ * 3. Fallback to 'standard'
+ */
+export declare function resolveUserRole(roleConfig: AgentRoleConfig | undefined, userId?: string, customRoles?: Record<string, AgentRole>): AgentRole;
+/**
+ * Check if a tool call is allowed for a specific user on a specific agent.
+ * Convenience function that resolves the role and checks in one call.
+ */
+export declare function checkToolPermission(toolName: string, roleConfig: AgentRoleConfig | undefined, userId?: string, customRoles?: Record<string, AgentRole>): {
+    allowed: boolean;
+    role: AgentRole;
+    reason?: string;
+};
+//# sourceMappingURL=roles.d.ts.map

package/dist/agents/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../src/agents/roles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;AAE3G,MAAM,WAAW,SAAS;IACxB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iDAAiD;IACjD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0CAA0C;IAC1C,eAAe,EAAE,OAAO,CAAC;IACzB,0CAA0C;IAC1C,eAAe,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,cAAc,EAAE,OAAO,CAAC;IACxB,yCAAyC;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,cAAc,EAAE,OAAO,CAAC;IACxB,0CAA0C;IAC1C,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,OAAO,EAAE,QAAQ,CAAC;IAClB,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CAClC;AAED,wBAAwB;AACxB,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CA+FtD,CAAC;AAEF,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOxE;AAED,iDAAiD;AACjD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,GAAG,IAAI,CAE/F;AAED,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,EAAE,CAE3E;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,eAAe,GAAG,SAAS,EACvC,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACtC,SAAS,CAcX;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,eAAe,GAAG,SAAS,EACvC,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACtC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAYxD"}