@shuyhere/takotako 0.0.1

package/CONTRIBUTING.md

@@ -0,0 +1,84 @@
+# Contributing to Tako
+
+Thanks for contributing.
+
+## Before you start
+
+- Read `README.md`
+- Read `docs/DEVELOPMENT.md`
+- Run the project locally once
+
+## Local setup
+
+```bash
+git clone https://github.com/shuyhere/tako.git
+cd tako
+npm install
+```
+
+## Development workflow
+
+1. Create a branch
+2. Make focused changes
+3. Add/update tests when behavior changes
+4. Run checks
+5. Open PR with clear summary
+
+## Required checks
+
+```bash
+npm run typecheck
+npm test
+npm run build
+```
+
+Or all-in-one:
+
+```bash
+npm run check
+```
+
+## Coding standards
+
+- TypeScript strict mode
+- ESM modules
+- Keep diffs small and reversible
+- Prefer reuse over duplicate abstractions
+- Update docs for user-visible behavior changes
+
+## Docs standards
+
+If you change install/run/developer behavior, update:
+
+- `README.md`
+- `docs/INSTALL.md`
+- `docs/USAGE.md`
+- `docs/DEVELOPMENT.md`
+
+## PR expectations
+
+Use descriptive PR titles and include:
+
+- problem statement
+- solution summary
+- test evidence
+- risks and rollback notes
+
+Use the PR template in `.github/PULL_REQUEST_TEMPLATE.md`.
+
+## Security
+
+- Do not commit secrets/tokens
+- Do not weaken safety defaults without explicit discussion
+- Call out security-impacting changes clearly in PR
+
+## Suggested commit style
+
+Conventional prefixes:
+
+- `feat:`
+- `fix:`
+- `refactor:`
+- `docs:`
+- `test:`
+- `chore:`

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shuyhere
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,171 @@
+# Tako 🐙
+
+**Agent-as-CPU OS** — minimal core runtime + pluggable skill arms.
+
+Tako is a multi-channel AI agent runtime you can run locally or on a server. It supports CLI, Discord, Telegram, tool execution, memory, sessions, and hot-reloadable skills.
+
+---
+
+## What you get
+
+- Minimal kernel with clear interfaces (provider/channel/tools/memory/hooks)
+- Pluggable skills (`SKILL.md` + optional `tools/*`)
+- Multi-channel operation from one runtime (CLI + Discord + Telegram)
+- Session persistence + compaction
+- Tool profiles (`minimal`, `coding`, `full`)
+- Daemon mode with status/restart/tui attach
+
+---
+
+## Install
+
+### Option A — npm
+
+```bash
+npm install -g @shuyhere/takotako
+```
+
+Or with Bun:
+
+```bash
+bun add -g @shuyhere/takotako
+```
+
+Then run:
+
+```bash
+tako onboard
+tako start -d   ## preferred: run in background after onboard
+```
+
+### Option B — install from GitHub source
+
+```bash
+npm install -g github:shuyhere/tako
+```
+
+### Option C — from source
+
+```bash
+git clone https://github.com/shuyhere/tako.git
+cd tako
+npm install
+npm run build
+npm link
+
+tako onboard
+tako start -d   ## preferred: run in background after onboard
+```
+
+For detailed setup and platform notes, see **[docs/INSTALL.md](docs/INSTALL.md)**.
+
+---
+
+## Quick usage
+
+```bash
+tako start            # foreground
+tako start -d         # daemon
+tako status           # health + runtime info
+tako tui              # attach TUI to daemon
+tako stop             # stop daemon
+tako restart          # restart daemon
+
+tako doctor           # health diagnostics
+tako models list      # list models
+tako models auth login --provider anthropic
+```
+
+Inside chat/CLI, built-in commands include:
+
+- `/help`
+- `/status`
+- `/model`
+- `/agents`
+- `/queue`
+- `/usage`
+
+See **[docs/USAGE.md](docs/USAGE.md)** for full command and workflow docs.
+
+---
+
+## Recommended setup
+
+For the best day-to-day control surface, use Discord and invite your bot to a server.
+Then run Tako in daemon mode and manage it with slash commands as your live dashboard (`/status`, `/models`, `/agents`, `/queue`, `/usage`).
+
+```bash
+tako onboard
+tako start -d
+```
+
+---
+
+## Configuration
+
+Main config path:
+
+- `~/.tako/tako.json`
+
+You can bootstrap config via:
+
+```bash
+tako onboard
+```
+
+Template example:
+
+- `tako.example.json`
+
+Reference docs:
+
+- **[docs/configuration.md](docs/configuration.md)**
+
+---
+
+## Skills
+
+Skill directory structure:
+
+```text
+skills/my-skill/
+├── SKILL.md
+└── tools/
+    └── my-tool.mjs
+```
+
+- `SKILL.md` frontmatter controls metadata, triggers, and command dispatch
+- tools are loaded dynamically
+
+See:
+
+- **[docs/skills.md](docs/skills.md)**
+
+---
+
+## Developer guide
+
+If you want to contribute or run Tako in dev mode:
+
+- **[docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)**
+- **[CONTRIBUTING.md](CONTRIBUTING.md)**
+
+---
+
+## Security notes
+
+- Keep `~/.tako/tako.json` and tokens private
+- Use restrictive tool profile in production (`minimal`/`coding` where possible)
+- Restrict Discord/Telegram bot scopes and allowed users/channels
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+---
+
+## Thanks
+
+Tako is informed by the broader agent tooling ecosystem. Special thanks to projects and communities that explored these patterns early, including OpenClaw and ZeroClaw.

package/dist/agents/communication.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Agent-to-Agent Communication — message passing between agents.
+ *
+ * Supports:
+ * - Direct send: agent A → agent B (message processed as new user message)
+ * - Broadcast: agent A → all agents
+ * - History: stored in ~/.tako/agents/comms/<from>-<to>.jsonl
+ */
+export interface AgentMessage {
+    id: string;
+    from: string;
+    to: string;
+    content: string;
+    timestamp: number;
+    replyTo?: string;
+}
+export interface CommsConfig {
+    /** Enable agent communication (default: true). */
+    enabled: boolean;
+    /** Which agents can talk to whom. Empty = unrestricted. */
+    allowList?: Record<string, string[]>;
+}
+export type MessageHandler = (toAgent: string, message: AgentMessage) => Promise<string>;
+export declare class AgentComms {
+    private config;
+    private commsDir;
+    private handler;
+    constructor(config: CommsConfig, commsDir?: string);
+    /** Wire the message handler (called when a message needs to be processed by the receiving agent). */
+    setHandler(handler: MessageHandler): void;
+    /**
+     * Send a message from one agent to another.
+     * Returns the receiving agent's response.
+     */
+    send(fromAgent: string, toAgent: string, content: string, replyTo?: string): Promise<string>;
+    /**
+     * Broadcast a message from one agent to all agents.
+     * Returns a map of agentId → response.
+     */
+    broadcast(fromAgent: string, content: string, agentIds: string[]): Promise<Map<string, string>>;
+    /**
+     * Get message history between two agents.
+     */
+    getHistory(agentA: string, agentB: string, limit?: number): Promise<AgentMessage[]>;
+    private persistMessage;
+    private getHistoryPath;
+}
+//# sourceMappingURL=communication.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"communication.d.ts","sourceRoot":"","sources":["../../src/agents/communication.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACtC;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAIzF,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAA+B;gBAElC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM;IAKlD,qGAAqG;IACrG,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIzC;;;OAGG;IACG,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;IA8ClB;;;OAGG;IACG,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAgB/B;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YA2BvE,cAAc;IAM5B,OAAO,CAAC,cAAc;CAGvB"}

package/dist/agents/communication.js

@@ -0,0 +1,123 @@
+/**
+ * Agent-to-Agent Communication — message passing between agents.
+ *
+ * Supports:
+ * - Direct send: agent A → agent B (message processed as new user message)
+ * - Broadcast: agent A → all agents
+ * - History: stored in ~/.tako/agents/comms/<from>-<to>.jsonl
+ */
+import { appendFile, mkdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+// ─── Agent Communication Hub ────────────────────────────────────────
+export class AgentComms {
+    config;
+    commsDir;
+    handler = null;
+    constructor(config, commsDir) {
+        this.config = config;
+        this.commsDir = commsDir ?? join(homedir(), '.tako', 'agents', 'comms');
+    }
+    /** Wire the message handler (called when a message needs to be processed by the receiving agent). */
+    setHandler(handler) {
+        this.handler = handler;
+    }
+    /**
+     * Send a message from one agent to another.
+     * Returns the receiving agent's response.
+     */
+    async send(fromAgent, toAgent, content, replyTo) {
+        if (!this.config.enabled) {
+            throw new Error('Agent communication is disabled');
+        }
+        // Check allow list
+        if (this.config.allowList) {
+            const allowed = this.config.allowList[fromAgent];
+            if (allowed && !allowed.includes(toAgent)) {
+                throw new Error(`Agent ${fromAgent} is not allowed to message ${toAgent}`);
+            }
+        }
+        const message = {
+            id: crypto.randomUUID(),
+            from: fromAgent,
+            to: toAgent,
+            content,
+            timestamp: Date.now(),
+            replyTo,
+        };
+        // Persist to history
+        await this.persistMessage(message);
+        // Deliver to handler
+        if (!this.handler) {
+            throw new Error('No message handler configured — agent loop not started');
+        }
+        const response = await this.handler(toAgent, message);
+        // Persist the response as a reply
+        const reply = {
+            id: crypto.randomUUID(),
+            from: toAgent,
+            to: fromAgent,
+            content: response,
+            timestamp: Date.now(),
+            replyTo: message.id,
+        };
+        await this.persistMessage(reply);
+        return response;
+    }
+    /**
+     * Broadcast a message from one agent to all agents.
+     * Returns a map of agentId → response.
+     */
+    async broadcast(fromAgent, content, agentIds) {
+        const results = new Map();
+        for (const agentId of agentIds) {
+            if (agentId === fromAgent)
+                continue;
+            try {
+                const response = await this.send(fromAgent, agentId, content);
+                results.set(agentId, response);
+            }
+            catch (err) {
+                results.set(agentId, `[error: ${err instanceof Error ? err.message : String(err)}]`);
+            }
+        }
+        return results;
+    }
+    /**
+     * Get message history between two agents.
+     */
+    async getHistory(agentA, agentB, limit = 50) {
+        const messages = [];
+        // Check both directions
+        for (const [from, to] of [[agentA, agentB], [agentB, agentA]]) {
+            const filePath = this.getHistoryPath(from, to);
+            try {
+                const raw = await readFile(filePath, 'utf-8');
+                for (const line of raw.trim().split('\n').filter(Boolean)) {
+                    try {
+                        messages.push(JSON.parse(line));
+                    }
+                    catch {
+                        // skip corrupt lines
+                    }
+                }
+            }
+            catch {
+                // No history file
+            }
+        }
+        // Sort by timestamp and return last N
+        messages.sort((a, b) => a.timestamp - b.timestamp);
+        return messages.slice(-limit);
+    }
+    // ─── Private ────────────────────────────────────────────────────
+    async persistMessage(msg) {
+        const filePath = this.getHistoryPath(msg.from, msg.to);
+        await mkdir(join(filePath, '..'), { recursive: true });
+        await appendFile(filePath, JSON.stringify(msg) + '\n', 'utf-8');
+    }
+    getHistoryPath(from, to) {
+        return join(this.commsDir, `${from}-${to}.jsonl`);
+    }
+}
+//# sourceMappingURL=communication.js.map

package/dist/agents/communication.js.map

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

package/dist/agents/config.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Agent config — per-agent configuration, channel bindings, spawn allowlists.
+ *
+ * Each agent is an isolated brain with its own workspace, model preferences,
+ * and channel routing rules.
+ */
+import type { AgentBindings } from '../config/schema.js';
+/** Runtime agent descriptor (resolved from config + defaults). */
+export interface AgentDescriptor {
+    /** Unique agent ID. */
+    id: string;
+    /** Resolved workspace path (absolute). */
+    workspace: string;
+    /** State directory for agent-specific data. */
+    stateDir: string;
+    /** Session persistence directory. */
+    sessionDir: string;
+    /** Primary model ID (e.g. 'anthropic/claude-sonnet-4-6'). */
+    model: string;
+    /** Channel bindings. */
+    bindings: AgentBindings;
+    /** Which agent IDs this agent can spawn as sub-agents. */
+    canSpawn: string[];
+    /** Agent description. */
+    description: string;
+    /** Whether this is the default "main" agent. */
+    isMain: boolean;
+    /** Permission role name (admin, operator, standard, restricted, readonly). */
+    role: string;
+    /** Per-agent skill directories (appended to global dirs at runtime). */
+    skills?: {
+        dirs: string[];
+    };
+}
+/**
+ * Resolve a channel message to the correct agent ID based on bindings.
+ *
+ * @param agents - List of agent descriptors
+ * @param channelType - Channel type ('discord', 'telegram', 'cli')
+ * @param channelTarget - Channel-specific target (channel name, user ID, etc.)
+ * @returns The matching agent ID, or 'main' if no binding matches
+ */
+export declare function resolveAgentForChannel(agents: AgentDescriptor[], channelType: string, channelTarget: string, guildId?: string): string;
+/**
+ * Check if an agent is allowed to spawn a sub-agent.
+ *
+ * @param parent - Parent agent descriptor
+ * @param targetAgentId - ID of the agent to spawn
+ * @returns true if spawning is allowed
+ */
+export declare function canAgentSpawn(parent: AgentDescriptor, targetAgentId: string): boolean;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/agents/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAErE,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,QAAQ,EAAE,aAAa,CAAC;IACxB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,MAAM,EAAE,OAAO,CAAC;IAChB,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,EAAE,EACzB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAoCR;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAMrF"}

package/dist/agents/config.js

@@ -0,0 +1,65 @@
+/**
+ * Agent config — per-agent configuration, channel bindings, spawn allowlists.
+ *
+ * Each agent is an isolated brain with its own workspace, model preferences,
+ * and channel routing rules.
+ */
+/**
+ * Resolve a channel message to the correct agent ID based on bindings.
+ *
+ * @param agents - List of agent descriptors
+ * @param channelType - Channel type ('discord', 'telegram', 'cli')
+ * @param channelTarget - Channel-specific target (channel name, user ID, etc.)
+ * @returns The matching agent ID, or 'main' if no binding matches
+ */
+export function resolveAgentForChannel(agents, channelType, channelTarget, guildId) {
+    // Pass 1: exact channel/user/group binding
+    for (const agent of agents) {
+        if (!agent.bindings)
+            continue;
+        if (channelType === 'discord' && agent.bindings.discord) {
+            if (agent.bindings.discord.channels.includes(channelTarget)) {
+                return agent.id;
+            }
+        }
+        if (channelType === 'telegram' && agent.bindings.telegram) {
+            if (agent.bindings.telegram.users?.includes(channelTarget)) {
+                return agent.id;
+            }
+            if (agent.bindings.telegram.groups?.includes(channelTarget)) {
+                return agent.id;
+            }
+        }
+        if (channelType === 'cli' && agent.bindings.cli) {
+            return agent.id;
+        }
+    }
+    // Pass 2: guild-level binding (Discord only)
+    if (channelType === 'discord' && guildId) {
+        for (const agent of agents) {
+            if (!agent.bindings?.discord)
+                continue;
+            if (agent.bindings.discord.channels.includes(guildId)) {
+                return agent.id;
+            }
+        }
+    }
+    return 'main';
+}
+/**
+ * Check if an agent is allowed to spawn a sub-agent.
+ *
+ * @param parent - Parent agent descriptor
+ * @param targetAgentId - ID of the agent to spawn
+ * @returns true if spawning is allowed
+ */
+export function canAgentSpawn(parent, targetAgentId) {
+    // Main agent can spawn anything
+    if (parent.isMain)
+        return true;
+    // Empty allowlist means can spawn anything
+    if (parent.canSpawn.length === 0)
+        return true;
+    return parent.canSpawn.includes(targetAgentId);
+}
+//# sourceMappingURL=config.js.map

package/dist/agents/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/agents/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8BH;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAyB,EACzB,WAAmB,EACnB,aAAqB,EACrB,OAAgB;IAEhB,2CAA2C;IAC3C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,QAAQ;YAAE,SAAS;QAE9B,IAAI,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACxD,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC5D,OAAO,KAAK,CAAC,EAAE,CAAC;YAClB,CAAC;QACH,CAAC;QAED,IAAI,WAAW,KAAK,UAAU,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC1D,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC3D,OAAO,KAAK,CAAC,EAAE,CAAC;YAClB,CAAC;YACD,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC5D,OAAO,KAAK,CAAC,EAAE,CAAC;YAClB,CAAC;QACH,CAAC;QAED,IAAI,WAAW,KAAK,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YAChD,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED,6CAA6C;IAC7C,IAAI,WAAW,KAAK,SAAS,IAAI,OAAO,EAAE,CAAC;QACzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO;gBAAE,SAAS;YACvC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtD,OAAO,KAAK,CAAC,EAAE,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAuB,EAAE,aAAqB;IAC1E,gCAAgC;IAChC,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC/B,2CAA2C;IAC3C,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;AACjD,CAAC"}

package/dist/agents/model-catalog.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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`.
+ */
+export type InputModality = 'text' | 'image' | 'audio' | 'video';
+export interface ModelEntry {
+    id: string;
+    contextWindow?: number;
+    maxTokens?: number;
+    reasoning?: boolean;
+    input?: InputModality[];
+}
+export interface ProviderModels {
+    models: ModelEntry[];
+    lastRefreshed?: string;
+}
+export interface ModelCatalog {
+    providers: Record<string, ProviderModels>;
+}
+export declare function loadModelCatalog(agentId: string): Promise<ModelCatalog>;
+export declare function saveModelCatalog(agentId: string, catalog: ModelCatalog): Promise<void>;
+/**
+ * Update a single provider's model list in the catalog.
+ */
+export declare function updateProviderModels(agentId: string, provider: string, models: ModelEntry[]): Promise<void>;
+/**
+ * Get all models across all providers for an agent.
+ */
+export declare function getAllModels(agentId: string): Promise<{
+    provider: string;
+    model: ModelEntry;
+}[]>;
+/**
+ * Find a specific model by ID across all providers.
+ */
+export declare function findModel(agentId: string, modelId: string): Promise<{
+    provider: string;
+    model: ModelEntry;
+} | null>;
+/**
+ * Seed the catalog with well-known Anthropic models.
+ */
+export declare function getDefaultAnthropicModels(): ModelEntry[];
+//# sourceMappingURL=model-catalog.d.ts.map

package/dist/agents/model-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../../src/agents/model-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC3C;AAUD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAW7E;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAK5F;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,EAAE,CAAC,CAStG;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAAC,CAGzD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,UAAU,EAAE,CAMxD"}