@esankhan3/anvil-agent-core 0.1.0

package/dist/adk-adapter.js

@@ -0,0 +1,403 @@
+/**
+ * Google ADK adapter — agentic, provider-agnostic.
+ *
+ * Drives `@google/adk` (≥ 1.1.0) end-to-end:
+ *   1. Builds an `LlmAgent` with the requested model.
+ *   2. Wraps `BuiltinToolExecutor`'s schemas as ADK `FunctionTool`s.
+ *   3. Runs the agent through ADK's `Runner` + `InMemorySessionService`.
+ *   4. Translates each emitted ADK `Event` into Anvil Stream Format
+ *      lines (text → emitContent, FunctionCall → emitToolUse,
+ *      FunctionResponse → emitToolResult).
+ *
+ * Provider routing:
+ *   - Model ids prefixed `adk:` (e.g. `adk:claude-sonnet-4-6`,
+ *     `adk:gemini-2.5-flash`) route to this adapter via the
+ *     `default-adapter-factory` resolver. Claude models go through the
+ *     custom `AnthropicLlm` (registered idempotently here); Gemini
+ *     models flow through ADK's built-in `Gemini` Llm.
+ *   - The prefix is stripped before being handed to ADK's
+ *     `LLMRegistry`, which matches against the model id directly
+ *     (e.g. `^claude-/`).
+ *
+ * Capabilities are `tier: 'agentic'` because the Runner drives a real
+ * tool loop. Per-call `AbortController` + buffered emitContent match
+ * the patterns in `OllamaAdapter` / `OpenRouterAdapter` so concurrent
+ * spawns (per-repo backend + frontend) don't trample each other.
+ *
+ * Auth: `ANTHROPIC_API_KEY` for Claude models, `GOOGLE_API_KEY` /
+ * `GEMINI_API_KEY` for Gemini.
+ */
+import { randomUUID } from 'node:crypto';
+import { emitContent as emitContentRaw, emitResult, emitToolResult, emitToolUse, } from './stream-format.js';
+import { registerAnthropicLlm } from './adk-anthropic-llm.js';
+import { UpstreamError, bodyLooksRetryable } from './upstream-error.js';
+const PREFIX = 'adk:';
+/**
+ * Defuse ADK's prompt template engine for source code we inject.
+ *
+ * ADK (`@google/adk`'s `instructions.js`) scans the prompt with
+ * `/\{+[^{}]*\}+/g`, strips ALL leading `{` and trailing `}`, trims,
+ * then if the residue matches `^[a-zA-Z_][a-zA-Z0-9_]*$` (a valid
+ * identifier) it tries to resolve it against the session state — and
+ * throws `Context variable not found: \`<name>\`` if it isn't there.
+ *
+ * Doubling braces does NOT help — `{{modalOpen}}` → strip `{+` / `}+`
+ * → `modalOpen` → still throws. Anvil doesn't use ADK's templating;
+ * we substitute our own `{{...}}` in `prompt-builders.ts:injectTemplateVars`
+ * before this call. By the time content lands here, every remaining
+ * `{name}` comes from KB-injected source code (TypeScript template
+ * literals, JSX expressions, Go struct literals).
+ *
+ * Insert a zero-width space (U+200B) right after every `{`. ADK still
+ * matches the regex but the resulting key starts with ZWSP, which
+ * fails the identifier check, so ADK returns `match[0]` unchanged
+ * instead of looking up state. ZWSP is invisible to the model — the
+ * source code reads identically.
+ *
+ * Provider-local: only ADK has this templating layer. Other adapters
+ * receive the raw prompt unchanged.
+ */
+function escapeAdkBraces(text) {
+    return text.replace(/\{/g, '{\u200B');
+}
+const ADK_PRICING = {
+    // Claude (Anthropic API)
+    'claude-haiku-4-5': [1.0, 5.0],
+    'claude-sonnet-4-6': [3.0, 15.0],
+    'claude-sonnet-4-7': [3.0, 15.0],
+    'claude-opus-4-7': [15.0, 75.0],
+    // Gemini
+    'gemini-2.5-flash': [0.075, 0.30],
+    'gemini-2.5-pro': [1.25, 5.00],
+};
+export class AdkAdapter {
+    provider = 'adk';
+    capabilities = {
+        tier: 'agentic',
+        streaming: true,
+        toolUse: true,
+        fileSystem: true,
+        shellExecution: true,
+        sessionResume: false,
+        cache: 'explicit',
+        cacheTtlSeconds: 300,
+        structuredOutput: 'tool-shim',
+        maxOutputTokens: true,
+    };
+    abortControllers = new Set();
+    supportsModel(modelId) {
+        return modelId.startsWith(PREFIX);
+    }
+    getModelPricing(modelId) {
+        const stripped = modelId.startsWith(PREFIX) ? modelId.slice(PREFIX.length) : modelId;
+        return ADK_PRICING[stripped] ?? null;
+    }
+    async checkAvailability() {
+        try {
+            const adk = await loadAdk();
+            const hasAnthropic = !!process.env.ANTHROPIC_API_KEY;
+            const hasGemini = !!(process.env.GOOGLE_API_KEY || process.env.GEMINI_API_KEY || process.env.GOOGLE_GENAI_API_KEY);
+            if (!hasAnthropic && !hasGemini) {
+                return {
+                    available: false,
+                    error: 'Set ANTHROPIC_API_KEY (for adk:claude-*) or GOOGLE_API_KEY / GEMINI_API_KEY (for adk:gemini-*).',
+                };
+            }
+            // Touch the registry so we can confirm the package's surface is wired.
+            // Throws cleanly if the install is broken.
+            void adk.LLMRegistry;
+            return { available: true, version: '@google/adk' };
+        }
+        catch (err) {
+            return {
+                available: false,
+                error: `@google/adk is not installed or failed to load: ${err.message}`,
+            };
+        }
+    }
+    async run(config, output) {
+        const startedAt = Date.now();
+        const upstreamModel = config.model.startsWith(PREFIX) ? config.model.slice(PREFIX.length) : config.model;
+        const adk = await loadAdk();
+        // Register Anthropic Llm exactly once per process — idempotent.
+        registerAnthropicLlm();
+        // Bridge `GOOGLE_API_KEY` → `GEMINI_API_KEY` for users who set the
+        // generic Google key. ADK's Gemini class only reads
+        // `GEMINI_API_KEY` / `GOOGLE_GENAI_API_KEY`. Don't overwrite if
+        // already set.
+        if (upstreamModel.startsWith('gemini-') &&
+            !process.env.GEMINI_API_KEY &&
+            !process.env.GOOGLE_GENAI_API_KEY &&
+            process.env.GOOGLE_API_KEY) {
+            process.env.GEMINI_API_KEY = process.env.GOOGLE_API_KEY;
+        }
+        // Per-call AbortController so concurrent spawns can't trample each other.
+        const ac = new AbortController();
+        this.abortControllers.add(ac);
+        const buffered = makeBufferedEmitter(output);
+        let totalInputTokens = 0;
+        let totalOutputTokens = 0;
+        let cacheReadTokens = 0;
+        let cacheWriteTokens = 0;
+        let toolCallCount = 0;
+        let stopReason = 'end_turn';
+        let finalText = '';
+        try {
+            const tools = buildAdkTools(adk, config.toolExecutor, {
+                workingDir: config.workingDir,
+                abortSignal: ac.signal,
+            });
+            const agent = new adk.LlmAgent({
+                name: 'anvil_adk_agent',
+                description: `Anvil agent (${config.persona ?? 'engineer'} stage=${config.stage ?? 'unknown'})`,
+                model: upstreamModel,
+                // ADK's prompt template engine treats `{varname}` as a context
+                // variable lookup and 500s on unresolved vars. Real source code
+                // injected via the KB / file reads naturally contains `{...}`
+                // (TypeScript template literals like `${adoptionId}`, JSON object
+                // literals, JSX expressions). We don't use ADK's templating —
+                // our own `injectTemplateVars` already substitutes `{{...}}`
+                // before this call. So escape every brace by doubling it; ADK
+                // unescapes `{{` → `{` and `}}` → `}` when rendering. Provider-
+                // local because no other adapter parses braces this way.
+                instruction: escapeAdkBraces(config.projectPrompt ?? ''),
+                tools,
+            });
+            const sessionService = new adk.InMemorySessionService();
+            const runner = new adk.Runner({
+                appName: 'anvil',
+                agent,
+                sessionService,
+            });
+            const userId = config.sessionId ?? `anvil-${randomUUID()}`;
+            const events = runner.runEphemeral({
+                userId,
+                newMessage: { role: 'user', parts: [{ text: escapeAdkBraces(config.userPrompt) }] },
+            });
+            // Wrap the iteration so plain Errors thrown by the underlying
+            // LLM (ADK's stock Gemini class throws plain Error on 429 /
+            // quota; our AnthropicLlm already throws UpstreamError directly)
+            // can be classified for the dashboard's chain-fallback duck-type
+            // check after the loop exits.
+            let iterError = null;
+            const wrapped = wrapIteratorErrors(events, (e) => { iterError = e; });
+            for await (const evt of wrapped) {
+                if (ac.signal.aborted)
+                    break;
+                const usage = evt.usageMetadata;
+                if (usage) {
+                    totalInputTokens += usage.promptTokenCount ?? 0;
+                    totalOutputTokens += usage.candidatesTokenCount ?? 0;
+                    if (typeof usage.cachedContentTokenCount === 'number') {
+                        cacheReadTokens += usage.cachedContentTokenCount;
+                    }
+                }
+                if (evt.finishReason)
+                    stopReason = String(evt.finishReason).toLowerCase();
+                // Translate parts → Anvil Stream Format. ADK fires content,
+                // function_call, and function_response in separate events so
+                // the partitioning is easy.
+                const parts = evt.content?.parts ?? [];
+                for (const part of parts) {
+                    if (typeof part.text === 'string' && part.text.length > 0) {
+                        buffered.push(part.text);
+                        // Track for the final result line — last text wins as the
+                        // canonical "answer".
+                        finalText = part.text;
+                    }
+                    else if (part.functionCall) {
+                        buffered.flush();
+                        const id = part.functionCall.id ?? randomUUID();
+                        emitToolUse(output, part.functionCall.name ?? '', (part.functionCall.args ?? {}), id);
+                        toolCallCount += 1;
+                    }
+                    else if (part.functionResponse) {
+                        buffered.flush();
+                        const resp = part.functionResponse.response ?? {};
+                        emitToolResult(output, {
+                            toolUseId: part.functionResponse.id ?? '',
+                            content: typeof resp === 'string' ? resp : JSON.stringify(resp),
+                            isError: typeof resp === 'object' && resp != null && 'error' in resp,
+                        });
+                    }
+                }
+                if (evt.errorMessage) {
+                    // Classify the in-band error so the dashboard's chain-fallback
+                    // can hop to another provider when an LLM hits quota/rate
+                    // limit but ADK chose to surface it via `errorMessage`
+                    // instead of throwing.
+                    const retryable = bodyLooksRetryable(evt.errorMessage);
+                    throw new UpstreamError(retryable ? 503 : 500, evt.errorMessage, {
+                        provider: upstreamModel.startsWith('claude-') ? 'anthropic' : 'gemini',
+                        retryable,
+                    });
+                }
+            }
+            // Surface any error the AsyncGenerator threw mid-stream. If the
+            // underlying LLM was our AnthropicLlm, it's already an UpstreamError
+            // (with `retryable` set correctly). For ADK's stock Gemini path
+            // we get a plain Error — classify by message body so we don't
+            // lose chain-fallback on 429/quota.
+            if (iterError) {
+                if (iterError instanceof UpstreamError)
+                    throw iterError;
+                const e = iterError;
+                const msg = e?.message ?? String(iterError);
+                const retryable = bodyLooksRetryable(msg);
+                throw new UpstreamError(retryable ? 429 : 500, msg, {
+                    provider: upstreamModel.startsWith('claude-') ? 'anthropic' : 'gemini',
+                    retryable,
+                });
+            }
+            buffered.flush();
+            const pricing = this.getModelPricing(config.model);
+            const costUsd = pricing
+                ? (totalInputTokens * pricing[0] + totalOutputTokens * pricing[1]) / 1_000_000
+                : 0;
+            emitResult(output, {
+                text: finalText,
+                costUsd,
+                inputTokens: totalInputTokens,
+                outputTokens: totalOutputTokens,
+                durationMs: Date.now() - startedAt,
+                sessionId: userId,
+                cacheReadTokens,
+                cacheWriteTokens,
+            });
+            return {
+                output: finalText,
+                inputTokens: totalInputTokens,
+                outputTokens: totalOutputTokens,
+                costUsd,
+                durationMs: Date.now() - startedAt,
+                sessionId: userId,
+                provider: this.provider,
+                model: config.model,
+                cacheReadTokens,
+                cacheWriteTokens,
+                toolCallCount,
+                stopReason,
+            };
+        }
+        finally {
+            this.abortControllers.delete(ac);
+        }
+    }
+    kill() {
+        for (const ac of this.abortControllers) {
+            try {
+                ac.abort();
+            }
+            catch { /* ignore */ }
+        }
+        this.abortControllers.clear();
+    }
+}
+// ───────────────────────────────────────────────────────────────────────
+// AsyncGenerator error capture
+// ───────────────────────────────────────────────────────────────────────
+/**
+ * Iterates an async iterable and captures any thrown error in `onError`
+ * instead of re-throwing it through the loop. The wrapped generator
+ * stops yielding on the first throw; the caller checks `iterError`
+ * after the for-await exits and re-throws (with classification) so
+ * the dashboard's chain-fallback duck-type check sees an UpstreamError.
+ */
+async function* wrapIteratorErrors(src, onError) {
+    try {
+        for await (const v of src)
+            yield v;
+    }
+    catch (e) {
+        onError(e);
+    }
+}
+let cachedAdk = null;
+async function loadAdk() {
+    if (cachedAdk)
+        return cachedAdk;
+    // Variable-form import so a TS environment without the package can
+    // still type-check this file (the static `import type` above is
+    // erased; this dynamic import resolves at runtime).
+    const pkg = '@google/adk';
+    const mod = (await import(pkg));
+    // Silence ADK's default INFO-level logger — it dumps every Runner
+    // event (including the full request prompt) to stderr, which floods
+    // the dashboard's terminal once ADK is in the chain. Drop to ERROR
+    // so genuine failures still surface. Set `ANVIL_ADK_LOG=info|debug`
+    // to opt back in when debugging the adapter itself.
+    try {
+        const m = mod;
+        const wantedRaw = (process.env.ANVIL_ADK_LOG ?? 'error').toLowerCase();
+        const wanted = wantedRaw === 'debug' ? m.LogLevel?.DEBUG
+            : wantedRaw === 'info' ? m.LogLevel?.INFO
+                : wantedRaw === 'warn' ? m.LogLevel?.WARN
+                    : m.LogLevel?.ERROR;
+        if (typeof wanted === 'number' && typeof m.setLogLevel === 'function') {
+            m.setLogLevel(wanted);
+        }
+    }
+    catch { /* non-fatal — just keeps ADK noisy */ }
+    cachedAdk = mod;
+    return mod;
+}
+// ───────────────────────────────────────────────────────────────────────
+// Tool translation: BuiltinToolExecutor schemas → ADK FunctionTool[]
+// ───────────────────────────────────────────────────────────────────────
+function buildAdkTools(adk, executor, ctx) {
+    if (!executor)
+        return [];
+    const out = [];
+    for (const schema of executor.listSchemas()) {
+        out.push(new adk.FunctionTool({
+            name: schema.name,
+            description: schema.description,
+            // ADK's FunctionTool accepts a JSON Schema in `parameters`; ADK
+            // forwards it as `parametersJsonSchema` to the underlying LLM
+            // (so AnthropicLlm picks it up via collectTools).
+            parameters: schema.inputSchema,
+            execute: async (input) => {
+                const args = (input ?? {});
+                const result = await executor.execute({ id: randomUUID(), name: schema.name, arguments: args }, { workingDir: ctx.workingDir, abortSignal: ctx.abortSignal });
+                // Anthropic's FunctionResponse expects a JSON-serializable
+                // object. We package error / output uniformly so AnthropicLlm
+                // can detect failures via the `error` key.
+                if (result.isError) {
+                    return { error: result.content };
+                }
+                return { output: result.content };
+            },
+        }));
+    }
+    return out;
+}
+// ───────────────────────────────────────────────────────────────────────
+// Buffered emitContent — flush on '\n' OR ~80 chars so the dashboard
+// activity log reads as prose, not vertical tokens. Same convention as
+// OpenRouter / Ollama adapters.
+// ───────────────────────────────────────────────────────────────────────
+function makeBufferedEmitter(output) {
+    let buf = '';
+    const FLUSH_AT = 80;
+    function flushNow() {
+        if (buf.length === 0)
+            return;
+        emitContentRaw(output, buf);
+        buf = '';
+    }
+    return {
+        push(s) {
+            buf += s;
+            let nl;
+            while ((nl = buf.indexOf('\n')) !== -1) {
+                const line = buf.slice(0, nl + 1);
+                emitContentRaw(output, line);
+                buf = buf.slice(nl + 1);
+            }
+            if (buf.length >= FLUSH_AT)
+                flushNow();
+        },
+        flush: flushNow,
+    };
+}
+//# sourceMappingURL=adk-adapter.js.map

package/dist/adk-adapter.js.map

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

package/dist/adk-anthropic-llm.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Anthropic-backed `BaseLlm` for Google ADK (`@google/adk` ≥ 1.1.0).
+ *
+ * ADK's TypeScript SDK ships only Gemini / Apigee adapters out of the
+ * box; Python/Java ADK have native multi-provider support. This file
+ * plugs Anthropic into ADK's `LLMRegistry` so
+ *   `new LlmAgent({ model: 'claude-sonnet-4-6', ... })`
+ * works inside an ADK `Runner`.
+ *
+ * Translation map (ADK / @google/genai shape  ↔  Anthropic Messages API):
+ *
+ *   Content[] (role='user'|'model')          ↔  messages[] (role='user'|'assistant')
+ *   Part.text                                ↔  text content block
+ *   Part.functionCall {id,name,args}         ↔  tool_use {id,name,input}
+ *   Part.functionResponse {id,name,response} ↔  tool_result {tool_use_id,content}
+ *   FunctionDeclaration                       ↔  tools[].input_schema
+ *
+ * Streaming uses Anthropic's SSE event format (`message_start` →
+ * `content_block_start/_delta/_stop` → `message_delta` → `message_stop`).
+ * We yield one `LlmResponse` per turn-completed assistant message —
+ * ADK's `Runner` then dispatches any tool_use parts to the registered
+ * `FunctionTool` instances and re-invokes us with the function
+ * responses appended.
+ *
+ * Registration is idempotent — `registerAnthropicLlm()` no-ops on
+ * subsequent calls. Call it once before constructing an `LlmAgent`
+ * with a `claude-*` model id.
+ */
+import { BaseLlm } from '@google/adk';
+import type { LlmRequest, LlmResponse, BaseLlmConnection } from '@google/adk';
+export declare class AnthropicLlm extends BaseLlm {
+    /**
+     * Patterns that route to this Llm via `LLMRegistry.resolve(model)`.
+     * Matches `claude-sonnet-4-6`, `claude-opus-4-7`, `claude-haiku-4-5`,
+     * `claude-3-5-haiku-latest`, etc. Does NOT match OpenRouter slugs
+     * (`anthropic/claude-...`) — those go through `OpenRouterAdapter`.
+     *
+     * Typed as the (mutable) array shape ADK's `LLMRegistry.register`
+     * expects — the registry uses `Array<string | RegExp>` for its key,
+     * so a `ReadonlyArray` here is rejected at the static side.
+     *
+     * NOTE: ADK's registry wraps each pattern with `^...$` at resolve
+     * time. Our regex MUST cover the full id (no `^` anchor of our own,
+     * and a trailing `.*` so the wrapped regex stays well-formed). The
+     * source pattern is `claude-` followed by `.*`.
+     */
+    static readonly supportedModels: Array<string | RegExp>;
+    constructor(params: {
+        model: string;
+    });
+    generateContentAsync(llmRequest: LlmRequest, stream?: boolean, abortSignal?: AbortSignal): AsyncGenerator<LlmResponse, void>;
+    connect(_llmRequest: LlmRequest): Promise<BaseLlmConnection>;
+}
+/**
+ * Register `AnthropicLlm` with ADK's `LLMRegistry`. Safe to call
+ * multiple times — only the first call registers.
+ */
+export declare function registerAnthropicLlm(): void;
+//# sourceMappingURL=adk-anthropic-llm.d.ts.map

package/dist/adk-anthropic-llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adk-anthropic-llm.d.ts","sourceRoot":"","sources":["../src/adk-anthropic-llm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAE,OAAO,EAAe,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAwE9E,qBAAa,YAAa,SAAQ,OAAO;IACvC;;;;;;;;;;;;;;OAcG;IACH,gBAAyB,eAAe,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAiB;gBAErE,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;IAIrB,oBAAoB,CAClC,UAAU,EAAE,UAAU,EACtB,MAAM,CAAC,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,WAAW,GACxB,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC;IA+CrB,OAAO,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAK5E;AAQD;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C"}