attocode 0.1.0

package/dist/src/first-run.js

@@ -0,0 +1,94 @@
+/**
+ * First-run detection and setup for attocode.
+ *
+ * Detects available API keys and guides users through initial setup.
+ */
+import { existsSync, writeFileSync } from 'fs';
+import { getConfigPath, ensureDirectories } from './paths.js';
+/**
+ * Detect available providers from environment variables.
+ */
+export function detectProviders() {
+    const providers = [];
+    if (process.env.ANTHROPIC_API_KEY) {
+        providers.push({ name: 'anthropic', source: 'env', hasKey: true });
+    }
+    if (process.env.OPENROUTER_API_KEY) {
+        providers.push({ name: 'openrouter', source: 'env', hasKey: true });
+    }
+    if (process.env.OPENAI_API_KEY) {
+        providers.push({ name: 'openai', source: 'env', hasKey: true });
+    }
+    return providers;
+}
+/**
+ * Check if this is the first run (no config exists).
+ */
+export function isFirstRun() {
+    return !existsSync(getConfigPath());
+}
+/**
+ * Check if we have any usable provider.
+ */
+export function hasUsableProvider() {
+    return detectProviders().length > 0;
+}
+/**
+ * Get the default provider based on available keys.
+ */
+export function getDefaultProvider() {
+    const providers = detectProviders();
+    // Prefer Anthropic > OpenRouter > OpenAI
+    return providers.find(p => p.name === 'anthropic')
+        || providers.find(p => p.name === 'openrouter')
+        || providers.find(p => p.name === 'openai')
+        || null;
+}
+/**
+ * Create initial config file with detected settings.
+ */
+export async function createInitialConfig() {
+    await ensureDirectories();
+    const config = {
+        "$schema": "https://attocode.dev/schema/config.json",
+        "version": 1,
+        "providers": {
+            "default": getDefaultProvider()?.name || "anthropic"
+        },
+        "model": "claude-sonnet-4-20250514",
+        "maxIterations": 50,
+        "timeout": 300000
+    };
+    writeFileSync(getConfigPath(), JSON.stringify(config, null, 2));
+}
+/**
+ * Show first-run message with setup instructions.
+ */
+export function getFirstRunMessage() {
+    const providers = detectProviders();
+    if (providers.length === 0) {
+        return `
+╔══════════════════════════════════════════════════════════════╗
+║                    Welcome to Attocode!                       ║
+╠══════════════════════════════════════════════════════════════╣
+║  No API key found. Set one of these environment variables:   ║
+║                                                              ║
+║    export ANTHROPIC_API_KEY="sk-ant-..."                     ║
+║    export OPENROUTER_API_KEY="sk-or-..."                     ║
+║    export OPENAI_API_KEY="sk-..."                            ║
+║                                                              ║
+║  Or run: attocode init                                       ║
+╚══════════════════════════════════════════════════════════════╝
+`.trim();
+    }
+    const provider = getDefaultProvider();
+    return `
+╔══════════════════════════════════════════════════════════════╗
+║                    Welcome to Attocode!                       ║
+╠══════════════════════════════════════════════════════════════╣
+║  ✓ Found ${provider.name.toUpperCase()} API key from environment             ║
+║  Ready to go! Type your request or use /help for commands.   ║
+╚══════════════════════════════════════════════════════════════╝
+`.trim();
+}
+//# sourceMappingURL=first-run.js.map

package/dist/src/first-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-run.js","sourceRoot":"","sources":["../../src/first-run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAQ9D;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,SAAS,GAAuB,EAAE,CAAC;IAEzC,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAClC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACnC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAC/B,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,eAAe,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IACpC,yCAAyC;IACzC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;WAC7C,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC;WAC5C,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;WACxC,IAAI,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,iBAAiB,EAAE,CAAC;IAE1B,MAAM,MAAM,GAAG;QACb,SAAS,EAAE,yCAAyC;QACpD,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE;YACX,SAAS,EAAE,kBAAkB,EAAE,EAAE,IAAI,IAAI,WAAW;SACrD;QACD,OAAO,EAAE,0BAA0B;QACnC,eAAe,EAAE,EAAE;QACnB,SAAS,EAAE,MAAM;KAClB,CAAC;IAEF,aAAa,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IAEpC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO;;;;;;;;;;;;CAYV,CAAC,IAAI,EAAE,CAAC;IACP,CAAC;IAED,MAAM,QAAQ,GAAG,kBAAkB,EAAG,CAAC;IACvC,OAAO;;;;aAII,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE;;;CAGvC,CAAC,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/src/hello.d.ts

@@ -0,0 +1,2 @@
+declare const message: string;
+//# sourceMappingURL=hello.d.ts.map

package/dist/src/hello.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hello.d.ts","sourceRoot":"","sources":["../../src/hello.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,OAAO,EAAE,MAAwB,CAAC"}

package/dist/src/hello.js

@@ -0,0 +1,4 @@
+"use strict";
+const message = "Hello, World!";
+console.log(message);
+//# sourceMappingURL=hello.js.map

package/dist/src/hello.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hello.js","sourceRoot":"","sources":["../../src/hello.ts"],"names":[],"mappings":";AAAA,MAAM,OAAO,GAAW,eAAe,CAAC;AAExC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC"}

package/dist/src/integrations/agent-registry.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Lesson 25: Extensible Agent Registry
+ *
+ * Allows users to define custom agents that can be spawned on demand.
+ * Supports:
+ * - Built-in agents (researcher, coder, reviewer, architect)
+ * - User-defined agents from .agents/ directory (YAML/JSON)
+ * - Hot-reload of agent definitions
+ * - NL-based agent selection
+ */
+import type { LLMProvider, ToolDefinition } from '../types.js';
+/**
+ * Agent definition - describes a spawnable agent.
+ */
+export interface AgentDefinition {
+    name: string;
+    description: string;
+    systemPrompt: string;
+    tools?: string[];
+    model?: 'fast' | 'balanced' | 'quality' | string;
+    maxTokenBudget?: number;
+    maxIterations?: number;
+    capabilities?: string[];
+    tags?: string[];
+}
+/**
+ * Loaded agent with source info.
+ */
+export interface LoadedAgent extends AgentDefinition {
+    source: 'builtin' | 'user';
+    filePath?: string;
+    loadedAt: Date;
+}
+/**
+ * Agent spawn options.
+ */
+export interface SpawnOptions {
+    task: string;
+    provider: LLMProvider;
+    tools: ToolDefinition[];
+    onProgress?: (message: string) => void;
+}
+/**
+ * Agent spawn result.
+ */
+export interface SpawnResult {
+    success: boolean;
+    output: string;
+    metrics: {
+        tokens: number;
+        duration: number;
+        toolCalls: number;
+    };
+}
+/**
+ * Registry events.
+ */
+export type RegistryEvent = {
+    type: 'agent.loaded';
+    name: string;
+    source: string;
+} | {
+    type: 'agent.reloaded';
+    name: string;
+} | {
+    type: 'agent.removed';
+    name: string;
+} | {
+    type: 'agent.error';
+    name: string;
+    error: string;
+} | {
+    type: 'agent.spawned';
+    name: string;
+    task: string;
+} | {
+    type: 'agent.completed';
+    name: string;
+    success: boolean;
+};
+export type RegistryEventListener = (event: RegistryEvent) => void;
+/**
+ * AgentRegistry manages agent definitions and spawning.
+ */
+export declare class AgentRegistry {
+    private agents;
+    private listeners;
+    private watchController?;
+    private baseDir;
+    constructor(baseDir?: string);
+    /**
+     * Load user-defined agents from .agents/ directory.
+     */
+    loadUserAgents(): Promise<void>;
+    /**
+     * Load an agent from a file.
+     */
+    private loadAgentFile;
+    /**
+     * Simple YAML parser for basic agent definitions.
+     */
+    private parseSimpleYaml;
+    /**
+     * Watch .agents/ directory for changes.
+     */
+    startWatching(): void;
+    /**
+     * Stop watching for changes.
+     */
+    stopWatching(): void;
+    /**
+     * Get an agent by name.
+     */
+    getAgent(name: string): LoadedAgent | undefined;
+    /**
+     * Get all agents.
+     */
+    getAllAgents(): LoadedAgent[];
+    /**
+     * Get agents by source.
+     */
+    getAgentsBySource(source: 'builtin' | 'user'): LoadedAgent[];
+    /**
+     * Find agents matching a query (for NL routing).
+     */
+    findMatchingAgents(query: string, limit?: number): LoadedAgent[];
+    /**
+     * Register a runtime agent.
+     */
+    registerAgent(definition: AgentDefinition): void;
+    /**
+     * Unregister an agent.
+     */
+    unregisterAgent(name: string): boolean;
+    /**
+     * Subscribe to events.
+     */
+    on(listener: RegistryEventListener): () => void;
+    /**
+     * Emit an event.
+     */
+    private emit;
+    /**
+     * Cleanup.
+     */
+    cleanup(): void;
+}
+/**
+ * Create an agent registry and load user agents.
+ */
+export declare function createAgentRegistry(baseDir?: string): Promise<AgentRegistry>;
+/**
+ * Filter tools based on agent's tool whitelist.
+ */
+export declare function filterToolsForAgent(agent: AgentDefinition, allTools: ToolDefinition[]): ToolDefinition[];
+/**
+ * Get a formatted list of agents for display.
+ */
+export declare function formatAgentList(agents: LoadedAgent[]): string;
+//# sourceMappingURL=agent-registry.d.ts.map

package/dist/src/integrations/agent-registry.d.ts.map

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