aura-code 0.3.0

package/dist/perception/types.d.ts

@@ -0,0 +1,103 @@
+/** Structural element in the project knowledge graph. */
+export interface ArchitectureNode {
+    /** Unique stable identifier for this node (e.g. "src/agent/context.ts"). */
+    id: string;
+    /** Coarse classification that drives how the node is visualised and queried. */
+    type: 'module' | 'file' | 'concept' | 'constraint' | 'decision' | 'trajectory';
+    /** Short human-readable label (shown in graph views and summaries). */
+    label: string;
+    /** Longer explanation of what this node represents or why it matters. */
+    description: string;
+    /** Arbitrary extra data — provider-specific or tool-specific fields live here. */
+    metadata: Record<string, unknown>;
+}
+/** Directed relationship between two nodes in the knowledge graph. */
+export interface ArchitectureEdge {
+    /** id of the source node. */
+    from: string;
+    /** id of the target node. */
+    to: string;
+    /**
+     * Semantic type of the relationship.
+     * - `depends_on`    — runtime or compile-time dependency
+     * - `implements`    — concrete realisation of an abstraction
+     * - `deprecated_by` — this edge marks a replacement path
+     * - `extends`       — inheritance or mixin
+     * - `violates`      — known constraint breach (used with riskAreas)
+     * - `aligns_with`   — supports or reinforces a constraint / decision
+     * - `owned_by`      — ownership / responsibility link
+     * - `tests`         — test file → production target
+     */
+    relationship: 'depends_on' | 'implements' | 'deprecated_by' | 'extends' | 'violates' | 'aligns_with' | 'owned_by' | 'tests';
+    /** Confidence / strength of the relationship in [0, 1]. */
+    weight: number;
+    /** Arbitrary extra data — tracing source, timestamps, tool annotations. */
+    metadata: Record<string, unknown>;
+}
+/** Full knowledge-graph snapshot for a single project root. */
+export interface ProjectPerception {
+    /** Absolute path to the project root this snapshot was built from. */
+    projectRoot: string;
+    /** All nodes in the architecture graph. */
+    nodes: ArchitectureNode[];
+    /** All directed edges in the architecture graph. */
+    edges: ArchitectureEdge[];
+    /** High-level trajectory: where the project came from and where it is going. */
+    trajectory: {
+        /** One-sentence statement of long-term project intent. */
+        vision: string;
+        /** Node ids (or labels) of things actively being removed or replaced. */
+        deprecated: string[];
+        /** Node ids (or labels) of work currently in flight. */
+        inProgress: string[];
+        /** Node ids (or labels) of work not yet started. */
+        planned: string[];
+    };
+    /** Structural constraints extracted from docs, ADRs, and conventions. */
+    constraints: {
+        /** Paths that must never be modified by automated agents. */
+        readOnly: string[];
+        /** Rules that must always hold (e.g. "no circular deps in core/"). */
+        strictRules: string[];
+        /** Areas with known fragility, high change frequency, or tech debt. */
+        riskAreas: string[];
+        /** Per-module test coverage classification. */
+        testCoverage: {
+            /** Module name or path prefix. */
+            module: string;
+            /** Rough coverage level; used to prioritise test generation. */
+            coverage: 'high' | 'medium' | 'low';
+        }[];
+    };
+    /** Unix timestamp (ms) when this snapshot was extracted. */
+    extractedAt: number;
+    /** Semver string of the perception schema used to produce this snapshot. */
+    version: string;
+}
+/** Parameters for a focused graph query. */
+export interface PerceptionQuery {
+    /**
+     * Kind of information being requested.
+     * - `dependencies` — what does `target` depend on (or what depends on it)?
+     * - `impact`       — which nodes are affected if `target` changes?
+     * - `constraints`  — which rules / risk areas apply to `target`?
+     * - `trajectory`   — is `target` deprecated, in-progress, or planned?
+     * - `risk`         — aggregated risk score and reasons for `target`
+     */
+    type: 'dependencies' | 'impact' | 'constraints' | 'trajectory' | 'risk' | 'related';
+    /** Node id or label to query against. */
+    target: string;
+    /** How many hops to traverse from `target` (defaults to 1 when omitted). */
+    depth?: number;
+}
+/** Result returned by a perception query. */
+export interface PerceptionQueryResult {
+    /** The original query that produced this result. */
+    query: PerceptionQuery;
+    /** Nodes included in the answer subgraph. */
+    nodes: ArchitectureNode[];
+    /** Edges included in the answer subgraph. */
+    edges: ArchitectureEdge[];
+    /** Human-readable explanation of the result, suitable for agent context. */
+    summary: string;
+}

package/dist/perception/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────────────────────
+// Architecture graph nodes
+// ─────────────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/perception/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/perception/types.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF"}

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,11 @@
+import type { LLMProvider, ProviderConfig, ToolDefinition, HistoryMessage, LLMResponse, StreamChunk } from './types.js';
+export declare class AnthropicProvider implements LLMProvider {
+    name: string;
+    supportsTools: boolean;
+    model: string;
+    private client;
+    private maxTokens;
+    constructor(config: ProviderConfig);
+    complete(system: string, history: HistoryMessage[], tools: ToolDefinition[]): Promise<LLMResponse>;
+    stream(system: string, history: HistoryMessage[], tools: ToolDefinition[]): AsyncGenerator<StreamChunk>;
+}

package/dist/providers/anthropic.js

@@ -0,0 +1,172 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnthropicProvider = void 0;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const env_js_1 = require("../util/env.js");
+class AnthropicProvider {
+    name = 'Anthropic';
+    supportsTools = true;
+    model;
+    client;
+    maxTokens;
+    constructor(config) {
+        this.model = config.model;
+        this.maxTokens = config.maxTokens ?? 8096;
+        this.client = new sdk_1.default({
+            apiKey: config.apiKey ?? (0, env_js_1.getApiKey)('ANTHROPIC_API_KEY'),
+        });
+    }
+    async complete(system, history, tools) {
+        const messages = toAnthropicMessages(history);
+        const response = await this.client.messages.create({
+            model: this.model,
+            max_tokens: this.maxTokens,
+            system,
+            tools: tools.map(toAnthropicTool),
+            messages,
+        });
+        return fromAnthropicResponse(response);
+    }
+    async *stream(system, history, tools) {
+        const messages = toAnthropicMessages(history);
+        const stream = this.client.messages.stream({
+            model: this.model,
+            max_tokens: this.maxTokens,
+            system,
+            tools: tools.map(toAnthropicTool),
+            messages,
+        });
+        const pending = [];
+        const completed = [];
+        let currentToolId = null;
+        let textBuffer = '';
+        let stopReason = 'done';
+        let inputTokens = 0;
+        let outputTokens = 0;
+        for await (const event of stream) {
+            if (event.type === 'content_block_start') {
+                if (event.content_block.type === 'tool_use') {
+                    const { id, name } = event.content_block;
+                    currentToolId = id;
+                    pending.push({ id, name, inputBuffer: '', input: {}, parsed: false });
+                    yield { type: 'tool_start', id, name };
+                }
+            }
+            else if (event.type === 'content_block_delta') {
+                const delta = event.delta;
+                if (delta.type === 'text_delta') {
+                    textBuffer += delta.text;
+                    yield { type: 'text', text: delta.text };
+                }
+                else if (delta.type === 'input_json_delta' && currentToolId) {
+                    const tool = pending.find(t => t.id === currentToolId);
+                    if (tool)
+                        tool.inputBuffer += delta.partial_json;
+                    yield { type: 'tool_input', id: currentToolId, partial: delta.partial_json };
+                }
+            }
+            else if (event.type === 'content_block_stop') {
+                if (currentToolId) {
+                    const tool = pending.find(t => t.id === currentToolId);
+                    if (tool && !tool.parsed) {
+                        try {
+                            tool.input = JSON.parse(tool.inputBuffer);
+                        }
+                        catch {
+                            tool.input = { _raw: tool.inputBuffer };
+                        }
+                        tool.parsed = true;
+                        const call = { id: tool.id, name: tool.name, input: tool.input };
+                        completed.push(call);
+                        yield { type: 'tool_end', call };
+                    }
+                    currentToolId = null;
+                }
+            }
+            else if (event.type === 'message_delta') {
+                if (event.delta.stop_reason === 'max_tokens')
+                    stopReason = 'limit';
+                else if (event.delta.stop_reason === 'tool_use')
+                    stopReason = 'tools';
+                if (event.usage?.output_tokens !== undefined)
+                    outputTokens = event.usage.output_tokens;
+            }
+            else if (event.type === 'message_start') {
+                if (event.message?.usage?.input_tokens !== undefined)
+                    inputTokens = event.message.usage.input_tokens;
+            }
+        }
+        yield {
+            type: 'done',
+            response: {
+                text: textBuffer,
+                toolCalls: completed,
+                stopReason,
+                usage: { inputTokens, outputTokens },
+            },
+        };
+    }
+}
+exports.AnthropicProvider = AnthropicProvider;
+// ── Conversion helpers ──────────────────────────────────────────────────────
+function toAnthropicTool(t) {
+    return {
+        name: t.name,
+        description: t.description,
+        input_schema: t.parameters,
+    };
+}
+function toAnthropicMessages(history) {
+    const out = [];
+    for (const msg of history) {
+        if (msg.role === 'user') {
+            out.push({ role: 'user', content: msg.content });
+        }
+        else if (msg.role === 'assistant') {
+            const content = [];
+            if (msg.content) {
+                content.push({ type: 'text', text: msg.content });
+            }
+            for (const tc of msg.toolCalls ?? []) {
+                content.push({ type: 'tool_use', id: tc.id, name: tc.name, input: tc.input });
+            }
+            out.push({ role: 'assistant', content });
+        }
+        else if (msg.role === 'tool_result') {
+            out.push({
+                role: 'user',
+                content: msg.results.map(r => ({
+                    type: 'tool_result',
+                    tool_use_id: r.id,
+                    content: r.content,
+                    is_error: r.isError,
+                })),
+            });
+        }
+    }
+    return out;
+}
+function fromAnthropicResponse(response) {
+    let text = '';
+    const toolCalls = [];
+    for (const block of response.content) {
+        if (block.type === 'text')
+            text += block.text;
+        if (block.type === 'tool_use') {
+            toolCalls.push({ id: block.id, name: block.name, input: block.input });
+        }
+    }
+    const stopReason = response.stop_reason === 'tool_use' ? 'tools' :
+        response.stop_reason === 'max_tokens' ? 'limit' : 'done';
+    return {
+        text, toolCalls, stopReason,
+        usage: {
+            inputTokens: response.usage.input_tokens,
+            outputTokens: response.usage.output_tokens,
+        },
+    };
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/providers/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":";;;;;;AAAA,4DAA0C;AAC1C,2CAA2C;AAM3C,MAAa,iBAAiB;IAC5B,IAAI,GAAG,WAAW,CAAC;IACnB,aAAa,GAAG,IAAI,CAAC;IACrB,KAAK,CAAS;IAEN,MAAM,CAAY;IAClB,SAAS,CAAS;IAE1B,YAAY,MAAsB;QAChC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,aAAS,CAAC;YAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAA,kBAAS,EAAC,mBAAmB,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,MAAc,EACd,OAAyB,EACzB,KAAuB;QAEvB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YACjD,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,MAAM;YACN,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC;YACjC,QAAQ;SACT,CAAC,CAAC;QACH,OAAO,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CACX,MAAc,EACd,OAAyB,EACzB,KAAuB;QAEvB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YACzC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,MAAM;YACN,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC;YACjC,QAAQ;SACT,CAAC,CAAC;QASH,MAAM,OAAO,GAAkB,EAAE,CAAC;QAClC,MAAM,SAAS,GAAe,EAAE,CAAC;QACjC,IAAI,aAAa,GAAkB,IAAI,CAAC;QACxC,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,IAAI,UAAU,GAA+B,MAAM,CAAC;QACpD,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBACzC,IAAI,KAAK,CAAC,aAAa,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBAC5C,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,aAAa,CAAC;oBACzC,aAAa,GAAG,EAAE,CAAC;oBACnB,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;oBACtE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;gBACzC,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBAChD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;gBAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBAChC,UAAU,IAAI,KAAK,CAAC,IAAI,CAAC;oBACzB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC3C,CAAC;qBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,IAAI,aAAa,EAAE,CAAC;oBAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,aAAa,CAAC,CAAC;oBACvD,IAAI,IAAI;wBAAE,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,YAAY,CAAC;oBACjD,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC;gBAC/E,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;gBAC/C,IAAI,aAAa,EAAE,CAAC;oBAClB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,aAAa,CAAC,CAAC;oBACvD,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;wBACzB,IAAI,CAAC;4BAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;wBAAC,CAAC;wBAClD,MAAM,CAAC;4BAAC,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;wBAAC,CAAC;wBAClD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;wBACnB,MAAM,IAAI,GAAa,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;wBAC3E,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBACrB,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;oBACnC,CAAC;oBACD,aAAa,GAAG,IAAI,CAAC;gBACvB,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBAC1C,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,KAAK,YAAY;oBAAE,UAAU,GAAG,OAAO,CAAC;qBAC9D,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,KAAK,UAAU;oBAAE,UAAU,GAAG,OAAO,CAAC;gBACtE,IAAI,KAAK,CAAC,KAAK,EAAE,aAAa,KAAK,SAAS;oBAAE,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC;YACzF,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBAC1C,IAAI,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,KAAK,SAAS;oBAAE,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;YACvG,CAAC;QACH,CAAC;QAED,MAAM;YACJ,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE;gBACR,IAAI,EAAE,UAAU;gBAChB,SAAS,EAAE,SAAS;gBACpB,UAAU;gBACV,KAAK,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE;aACrC;SACF,CAAC;IACJ,CAAC;CACF;AA/GD,8CA+GC;AAED,+EAA+E;AAE/E,SAAS,eAAe,CAAC,CAAiB;IACxC,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,YAAY,EAAE,CAAC,CAAC,UAAwC;KACzD,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAyB;IACpD,MAAM,GAAG,GAA6B,EAAE,CAAC;IAEzC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACxB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACnD,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACpC,MAAM,OAAO,GAA6B,EAAE,CAAC;YAC7C,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,CAAC;YACD,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;gBACrC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;YAChF,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACtC,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBAC7B,IAAI,EAAE,aAAsB;oBAC5B,WAAW,EAAE,CAAC,CAAC,EAAE;oBACjB,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,QAAQ,EAAE,CAAC,CAAC,OAAO;iBACpB,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,qBAAqB,CAAC,QAA2B;IACxD,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,MAAM,SAAS,GAAe,EAAE,CAAC;IAEjC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;QAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC9B,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAgC,EAAE,CAAC,CAAC;QACpG,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GACd,QAAQ,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC/C,QAAQ,CAAC,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAE3D,OAAO;QACL,IAAI,EAAE,SAAS,EAAE,UAAU;QAC3B,KAAK,EAAE;YACL,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,YAAY;YACxC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;SAC3C;KACF,CAAC;AACJ,CAAC"}

package/dist/providers/factory.d.ts

@@ -0,0 +1,58 @@
+import type { LLMProvider, ProviderConfig } from './types.js';
+import type { ProviderDef } from '../config/project-config.js';
+/**
+ * Register custom providers from .aura.json or any other source.
+ * These are checked before built-in routing in createProvider().
+ */
+export declare function registerCustomProviders(providers: ProviderDef[]): void;
+/** Get currently registered custom providers. */
+export declare function getCustomProviders(): ProviderDef[];
+/**
+ * Detect which provider class would handle a given model name.
+ * Exported so the resilience layer can pre-build the right class.
+ */
+export declare function detectProviderKind(model: string): 'anthropic' | 'google' | 'openai-compatible';
+/**
+ * Auto-detect the right provider from the model name, then instantiate it.
+ *
+ * Model naming conventions:
+ *   claude-*             → Anthropic
+ *   gpt-*, o1-*, o3-*   → OpenAI
+ *   gemini-*             → Google
+ *   grok-*               → xAI (OpenAI-compatible at api.x.ai)
+ *   openrouter/*         → OpenRouter (OpenAI-compatible)
+ *   ollama/*             → Ollama (OpenAI-compatible at localhost:11434)
+ *   local/*              → Local OpenAI-compatible (localhost:1234)
+ *   anything else        → OpenAI-compatible (uses baseUrl from config)
+ */
+export declare function createProvider(config: ProviderConfig): LLMProvider;
+/**
+ * List of well-known model shortcuts for quick selection.
+ * Used by `:models` in the REPL and by `--models` on the CLI.
+ */
+export declare const KNOWN_MODELS: {
+    id: string;
+    name: string;
+    provider: string;
+    speed: string;
+}[];
+/**
+ * Get all available models — built-in + custom providers from .aura.json.
+ */
+export declare function getAllModels(): {
+    id: string;
+    name: string;
+    provider: string;
+    speed: string;
+}[];
+export declare const CONTEXT_WINDOWS: Record<string, number>;
+/**
+ * Look up the context window for a model id.
+ * Returns undefined for unknown models (caller should suppress the bar).
+ */
+export declare function getContextWindow(modelId: string): number | undefined;
+/**
+ * Check if Ollama is reachable at the given base URL.
+ * Returns true if the server responds, false otherwise.
+ */
+export declare function checkOllamaHealth(baseUrl?: string): Promise<boolean>;