@velum-labs/routekit-tool-claude 1.3.2 → 1.5.0

package/dist/index.d.ts

@@ -2,6 +2,6 @@ import type { ToolIntegration } from "@velum-labs/routekit-tools";
 export declare const claudeTool: ToolIntegration;
 export type { ClaudeDriverConfig, ClaudeDriverOptions, ClaudeQueryFn } from "./driver.js";
 export { claudeDriverConfigSchema, createClaudeDriver } from "./driver.js";
-export type { ClaudeInstallInput, ClaudeInstallOwner, ClaudeInstallResult } from "./install.js";
-export { claudeIntegrationConfigPath, installClaudeIntegration, uninstallClaudeIntegration } from "./install.js";
+export type { ClaudeConfigLockScope, ClaudeInstallInput, ClaudeInstallOwner, ClaudeInstallResult } from "./install.js";
+export { acquireClaudeConfigLock, claudeIntegrationConfigPath, installClaudeIntegration, uninstallClaudeIntegration } from "./install.js";
 export { claudeAgentsJson, claudeEnv, claudeLaunchArgs, launchClaude } from "./launch.js";

package/dist/index.js

@@ -30,5 +30,5 @@ export const claudeTool = {
     }
 };
 export { claudeDriverConfigSchema, createClaudeDriver } from "./driver.js";
-export { claudeIntegrationConfigPath, installClaudeIntegration, uninstallClaudeIntegration } from "./install.js";
+export { acquireClaudeConfigLock, claudeIntegrationConfigPath, installClaudeIntegration, uninstallClaudeIntegration } from "./install.js";
 export { claudeAgentsJson, claudeEnv, claudeLaunchArgs, launchClaude } from "./launch.js";

package/dist/install-codec.d.ts

@@ -1,3 +1,4 @@
+import { type ClaudeCatalogModel } from "./launch.js";
 export type ClaudeSettings = Record<string, unknown> & {
     env?: Record<string, unknown>;
 };
@@ -41,6 +42,11 @@ export type UninstallPendingManifest = {
 };
 export type ClaudeInstallManifest = InstalledManifest | InstallPendingManifest | UninstallPendingManifest;
 export declare const MANAGED_ENV_KEYS: readonly ["ANTHROPIC_BASE_URL", "CLAUDE_CODE_ALWAYS_ENABLE_EFFORT"];
+export declare const REPOSITORY_CONNECTION_HEADER = "X-RouteKit-Repository-Connection-Id";
+export declare const CLAUDE_CUSTOM_HEADERS_KEY = "ANTHROPIC_CUSTOM_HEADERS";
+export declare const CLAUDE_CUSTOM_MODEL_OPTION_KEY = "ANTHROPIC_CUSTOM_MODEL_OPTION";
+export declare const CLAUDE_AUTO_PICKER_MODEL_ID = "anthropic.routekit.auto";
+export declare const BOUND_MANAGED_ENV_KEYS: readonly ["ANTHROPIC_CUSTOM_HEADERS", "ANTHROPIC_CUSTOM_MODEL_OPTION"];
 export declare function hash(content: string): string;
 export declare function serialize(value: unknown): string;
 export declare function snapshot(content: string | null, mode: number | null): FileSnapshot;
@@ -49,9 +55,10 @@ export declare function unsupportedManifest(manifestPath: string): Error;
 export declare function parseManifest(content: string, manifestPath: string): ClaudeInstallManifest;
 export declare function managedEnv(input: {
     gatewayUrl: string;
+    repositoryConnectionId?: string;
 }): Record<string, string>;
 export declare function pickerModels(input: {
-    models: readonly string[];
+    models: readonly (string | ClaudeCatalogModel)[];
 }): string[];
 export declare function availableModels(settings: ClaudeSettings, configPath: string): string[] | undefined;
 export declare function enforceAvailableModels(settings: ClaudeSettings, configPath: string): boolean | undefined;

package/dist/install-codec.js

@@ -1,11 +1,19 @@
 import { createHash } from "node:crypto";
 import { gatewayOrigin } from "@velum-labs/routekit-runtime/network";
+import { claudeModelId } from "./launch.js";
 export const MANAGED_ENV_KEYS = ["ANTHROPIC_BASE_URL", "CLAUDE_CODE_ALWAYS_ENABLE_EFFORT"];
+export const REPOSITORY_CONNECTION_HEADER = "X-RouteKit-Repository-Connection-Id";
+export const CLAUDE_CUSTOM_HEADERS_KEY = "ANTHROPIC_CUSTOM_HEADERS";
+export const CLAUDE_CUSTOM_MODEL_OPTION_KEY = "ANTHROPIC_CUSTOM_MODEL_OPTION";
+export const CLAUDE_AUTO_PICKER_MODEL_ID = "anthropic.routekit.auto";
+export const BOUND_MANAGED_ENV_KEYS = [
+    CLAUDE_CUSTOM_HEADERS_KEY,
+    CLAUDE_CUSTOM_MODEL_OPTION_KEY
+];
 const RETIRED_MANAGED_ENV_KEYS = [
     "ANTHROPIC_AUTH_TOKEN",
     "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY"
 ];
-const CLAUDE_PICKER_PREFIX = "anthropic.routekit.";
 export function hash(content) {
     return createHash("sha256").update(content).digest("hex");
 }
@@ -117,18 +125,29 @@ export function parseManifest(content, manifestPath) {
     throw unsupportedManifest(manifestPath);
 }
 export function managedEnv(input) {
+    if (input.repositoryConnectionId !== undefined &&
+        !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(input.repositoryConnectionId)) {
+        throw new Error("RouteKit's Claude repository connection id must be a UUID");
+    }
     return {
         ANTHROPIC_BASE_URL: gatewayOrigin(input.gatewayUrl),
-        CLAUDE_CODE_ALWAYS_ENABLE_EFFORT: "1"
+        CLAUDE_CODE_ALWAYS_ENABLE_EFFORT: "1",
+        ...(input.repositoryConnectionId !== undefined
+            ? {
+                [CLAUDE_CUSTOM_HEADERS_KEY]: `${REPOSITORY_CONNECTION_HEADER}: ${input.repositoryConnectionId.toLowerCase()}`,
+                [CLAUDE_CUSTOM_MODEL_OPTION_KEY]: CLAUDE_AUTO_PICKER_MODEL_ID
+            }
+            : {})
     };
 }
 export function pickerModels(input) {
     const models = new Set();
     for (const model of input.models) {
-        if (typeof model !== "string" || model.length === 0) {
+        const id = typeof model === "string" ? model : model.id;
+        if (typeof id !== "string" || id.length === 0) {
             throw new Error("RouteKit's Claude picker catalog contains an invalid model id");
         }
-        models.add(`${CLAUDE_PICKER_PREFIX}${model}`);
+        models.add(claudeModelId(id, input.models));
     }
     return [...models];
 }

package/dist/install.d.ts

@@ -1,3 +1,5 @@
+import { type ClaudeSettings } from "./install-codec.js";
+import type { ClaudeCatalogModel } from "./launch.js";
 export type ClaudeInstallOwner = {
     id: string;
     displayName: string;
@@ -7,8 +9,10 @@ export type ClaudeInstallOwner = {
 };
 export type ClaudeInstallInput = {
     gatewayUrl: string;
-    /** Canonical RouteKit catalog ids permitted by the current model policy. */
-    models: readonly string[];
+    /** Explicit Cloud repository context. This is not a credential. */
+    repositoryConnectionId?: string;
+    /** Canonical RouteKit catalog routes permitted by the current model policy. */
+    models: readonly (string | ClaudeCatalogModel)[];
     /**
      * Command Claude Code invokes when it needs the gateway bearer token. The
      * helper output is never persisted in settings.json.
@@ -23,6 +27,29 @@ export type ClaudeInstallResult = {
     managedKeys: string[];
 };
 export declare function claudeIntegrationConfigPath(claudeConfigDir?: string): string;
+export type ClaudeConfigLockScope = Readonly<{
+    install(input: ClaudeInstallInput, options?: {
+        validateSettings?: (settings: Readonly<ClaudeSettings>) => void;
+    }): ClaudeInstallResult;
+    uninstall(input: {
+        ownerId: string;
+        claudeConfigDir?: string;
+    }): {
+        configPath: string;
+        removed: boolean;
+    };
+    recover(ownerId: string): {
+        configPath: string;
+        recovered: boolean;
+    };
+    release(): void;
+}>;
+/**
+ * Hold Claude's owner-neutral config lock across an async caller transaction.
+ * A validator can inspect the parsed settings inside the lock before install
+ * writes any ownership metadata or settings changes.
+ */
+export declare function acquireClaudeConfigLock(claudeConfigDir?: string): Promise<ClaudeConfigLockScope>;
 export declare function installClaudeIntegration(input: ClaudeInstallInput): Promise<ClaudeInstallResult>;
 export declare function uninstallClaudeIntegration(input: {
     ownerId: string;