feat: recognize claude-code llm backend

packages/context/package.json

@@ -129,6 +129,7 @@
     "type-check": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "0.3.142",
     "@ktx/llm": "workspace:*",
     "@looker/sdk": "^26.8.0",
     "@looker/sdk-node": "^26.8.0",

packages/context/src/project/config.test.ts

@@ -180,6 +180,31 @@ llm:
     });
   });
 
+  it('parses Claude Code as a first-class LLM backend', () => {
+    const config = parseKtxProjectConfig(`
+llm:
+  provider:
+    backend: claude-code
+  models:
+    default: sonnet
+    triage: haiku
+    candidateExtraction: sonnet
+    curator: sonnet
+    reconcile: sonnet
+    repair: opus
+`);
+
+    expect(config.llm.provider.backend).toBe('claude-code');
+    expect(config.llm.models).toEqual({
+      default: 'sonnet',
+      triage: 'haiku',
+      candidateExtraction: 'sonnet',
+      curator: 'sonnet',
+      reconcile: 'sonnet',
+      repair: 'opus',
+    });
+  });
+
   it('parses gateway LLM, OpenAI scan embeddings, and sentence-transformers ingest embeddings', () => {
     const config = parseKtxProjectConfig(`
 llm:
@@ -497,7 +522,7 @@ describe('generateKtxProjectConfigJsonSchema', () => {
     const llm = (schema.properties as Record<string, { properties?: Record<string, unknown> }>).llm;
     const provider = llm?.properties?.provider as { properties?: Record<string, unknown> };
     const backend = provider?.properties?.backend as { enum?: readonly string[] };
-    expect(backend?.enum).toEqual(['none', 'anthropic', 'vertex', 'gateway']);
+    expect(backend?.enum).toEqual(['none', 'anthropic', 'vertex', 'gateway', 'claude-code']);
 
     const storage = (schema.properties as Record<string, { properties?: Record<string, unknown> }>).storage;
     const state = storage?.properties?.state as { enum?: readonly string[] };

packages/context/src/project/config.ts

@@ -3,7 +3,7 @@ import YAML from 'yaml';
 import * as z from 'zod';
 import { connectionConfigSchema } from './driver-schemas.js';
 
-const KTX_LLM_BACKENDS = ['none', 'anthropic', 'vertex', 'gateway'] as const;
+const KTX_LLM_BACKENDS = ['none', 'anthropic', 'vertex', 'gateway', 'claude-code'] as const;
 const KTX_EMBEDDING_BACKENDS = ['none', 'deterministic', 'openai', 'sentence-transformers'] as const;
 const KTX_PROMPT_CACHE_TTLS = ['5m', '1h'] as const;
 const KTX_ENRICHMENT_MODES = ['none', 'deterministic', 'llm'] as const;
@@ -46,7 +46,9 @@ const llmProviderSchema = z
     backend: z
       .enum(KTX_LLM_BACKENDS)
       .default('none')
-      .describe('LLM provider backend. "none" disables LLM features; "anthropic" / "vertex" / "gateway" require the matching nested credentials block.'),
+      .describe(
+        'LLM provider backend. "none" disables LLM features; "anthropic" / "vertex" / "gateway" require the matching nested credentials block; "claude-code" uses the local Claude Code session.',
+      ),
     vertex: vertexProviderSchema.optional().describe('Vertex AI credentials, used when backend is "vertex".'),
     anthropic: apiCredentialsSchema.optional().describe('Anthropic API credentials, used when backend is "anthropic".'),
     gateway: apiCredentialsSchema.optional().describe('AI Gateway credentials, used when backend is "gateway".'),

packages/llm/src/model-health.test.ts

@@ -61,4 +61,17 @@ describe('KTX LLM health check', () => {
       message: '401 invalid x-api-key [redacted]',
     });
   });
+
+  it('reports claude-code as unsupported by the AI SDK health check', async () => {
+    const result = await runKtxLlmHealthCheck({
+      backend: 'claude-code',
+      modelSlots: { default: 'sonnet' },
+      promptCaching: { enabled: false },
+    });
+
+    expect(result).toEqual({
+      ok: false,
+      message: expect.stringContaining('claude-code is not an AI SDK LanguageModel backend'),
+    });
+  });
 });

packages/llm/src/model-provider.test.ts

@@ -302,4 +302,14 @@ describe('createKtxLlmProvider', () => {
     expect(provider.promptCachingConfig().enabled).toBe(false);
     expect(provider.cacheMarker('1h', 'claude-sonnet-4-6')).toBeUndefined();
   });
+
+  it('throws instead of falling through when an unsupported LLM backend is passed to the AI SDK provider factory', () => {
+    expect(() =>
+      createKtxLlmProvider({
+        backend: 'claude-code',
+        modelSlots: { default: 'sonnet' },
+        promptCaching: { enabled: false },
+      }),
+    ).toThrow('claude-code is not an AI SDK LanguageModel backend');
+  });
 });

packages/llm/src/model-provider.ts

@@ -175,14 +175,18 @@ class DefaultKtxLlmProvider implements KtxLlmProvider {
       return (modelId) => vertex(modelId);
     }
 
-    const gateway = (deps.createGateway ?? createGateway)({
-      ...(config.gateway?.apiKey ? { apiKey: config.gateway.apiKey } : {}),
-      ...(config.gateway?.baseURL ? { baseURL: config.gateway.baseURL } : {}),
-      headers: {
-        'anthropic-beta': ANTHROPIC_BETA_HEADER,
-      },
-    });
-    return (modelId) => gateway(modelId);
+    if (config.backend === 'gateway') {
+      const gateway = (deps.createGateway ?? createGateway)({
+        ...(config.gateway?.apiKey ? { apiKey: config.gateway.apiKey } : {}),
+        ...(config.gateway?.baseURL ? { baseURL: config.gateway.baseURL } : {}),
+        headers: {
+          'anthropic-beta': ANTHROPIC_BETA_HEADER,
+        },
+      });
+      return (modelId) => gateway(modelId);
+    }
+
+    throw new Error(`${config.backend} is not an AI SDK LanguageModel backend; use KtxLlmRuntimePort`);
   }
 }
 

packages/llm/src/types.ts

@@ -3,7 +3,7 @@ import type { LanguageModel, TelemetrySettings, ToolCallRepairFunction, ToolSet
 export const KTX_MODEL_ROLES = ['default', 'triage', 'candidateExtraction', 'curator', 'reconcile', 'repair'] as const;
 
 export type KtxModelRole = (typeof KTX_MODEL_ROLES)[number];
-export type KtxLlmBackend = 'anthropic' | 'vertex' | 'gateway';
+export type KtxLlmBackend = 'anthropic' | 'vertex' | 'gateway' | 'claude-code';
 export type KtxPromptCacheTtl = '5m' | '1h';
 
 export type KtxJsonValue =