agent-shim 8.9.0 → 8.10.0

package/dist/types/index.d.ts

@@ -76,6 +76,7 @@ declare const LaunchSchema: z.ZodObject<{
     provider: z.ZodOptional<z.ZodString>;
     headroom: z.ZodOptional<z.ZodBoolean>;
     trackUsage: z.ZodOptional<z.ZodBoolean>;
+    claudeVersion: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 type LaunchFlags = z.infer<typeof LaunchSchema>;
 /**
@@ -337,6 +338,7 @@ declare const ConfigProfileSchema: z.ZodObject<{
         provider: z.ZodOptional<z.ZodString>;
         headroom: z.ZodOptional<z.ZodBoolean>;
         trackUsage: z.ZodOptional<z.ZodBoolean>;
+        claudeVersion: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 type ConfigProfile = z.infer<typeof ConfigProfileSchema>;
@@ -380,6 +382,7 @@ declare const DirectoryRuleSchema: z.ZodObject<{
         provider: z.ZodOptional<z.ZodString>;
         headroom: z.ZodOptional<z.ZodBoolean>;
         trackUsage: z.ZodOptional<z.ZodBoolean>;
+        claudeVersion: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
     path: z.ZodString;
     configProfile: z.ZodOptional<z.ZodString>;
@@ -428,6 +431,7 @@ declare const DirectoryRulesSchema: z.ZodObject<{
             provider: z.ZodOptional<z.ZodString>;
             headroom: z.ZodOptional<z.ZodBoolean>;
             trackUsage: z.ZodOptional<z.ZodBoolean>;
+            claudeVersion: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
         path: z.ZodString;
         configProfile: z.ZodOptional<z.ZodString>;
@@ -477,6 +481,7 @@ declare const PortableConfigSchema: z.ZodObject<{
         provider: z.ZodOptional<z.ZodString>;
         headroom: z.ZodOptional<z.ZodBoolean>;
         trackUsage: z.ZodOptional<z.ZodBoolean>;
+        claudeVersion: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
     configProfile: z.ZodOptional<z.ZodString>;
     identity: z.ZodOptional<z.ZodString>;
@@ -545,6 +550,7 @@ declare const GlobalConfigSchema: z.ZodObject<{
         provider: z.ZodOptional<z.ZodString>;
         headroom: z.ZodOptional<z.ZodBoolean>;
         trackUsage: z.ZodOptional<z.ZodBoolean>;
+        claudeVersion: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
     headroom: z.ZodOptional<z.ZodObject<{
         source: z.ZodOptional<z.ZodString>;
@@ -3306,6 +3312,14 @@ declare function updateDirectoryRule(paths: LayoutPaths, rulePath: string, optio
 /** Removes the directory rule for `rulePath`. Throws `DirectoryRuleNotFoundError` when no rule matches that exact path. */
 declare function removeDirectoryRule(paths: LayoutPaths, rulePath: string): void;
 
+/** Where a pinned Claude Code version came from, strongest first: the launch's own flag, then the environment, then the cascade. */
+type ClaudeVersionSource = "flag" | "environment" | "cascade";
+/** The pinned version a launch runs, and which of the three forms named it. */
+interface PinnedClaudeVersion {
+    readonly version: string;
+    readonly source: ClaudeVersionSource;
+}
+
 /** Which precedence rule produced an identity decision. */
 type IdentityDecisionSource = 
 /** `CLAUDE_CONFIG_DIR` was already set: identity resolution is skipped entirely and the real binary uses whatever it already points to. */
@@ -3430,6 +3444,8 @@ interface RunCheckParams {
     readonly platform: string;
     /** The provider a launch here would route through (`launch.provider` in the cascade), when one is selected. */
     readonly provider?: CheckProviderInput;
+    /** The Claude Code versions installed here, oldest first. Omit to leave the Claude Code version out of the report; with it, `check` says which version a launch here runs and whether a pin is installed. */
+    readonly installedClaudeVersions?: readonly string[];
     /** Where cached credentials live. Omit to skip reporting a credential cache's age; with it, a block that caches reports whether it holds an entry, how old it is and whether it has expired, never the token. */
     readonly credentialCache?: CredentialCacheEnv;
 }
@@ -3447,6 +3463,16 @@ interface CheckReport {
     readonly keychain?: KeychainLookupResult;
     readonly settingsExposure: readonly SettingsExposureReport[];
     readonly credential: CredentialReport;
+    /** The Claude Code version a launch here would run, when the installed versions were given. */
+    readonly claudeVersion?: ClaudeVersionReport;
+}
+/** Which Claude Code version a launch would run: the pin and where it comes from, with whether it is installed, or the highest installed version when nothing pins one. */
+interface ClaudeVersionReport {
+    readonly pinned?: PinnedClaudeVersion & {
+        readonly installed: boolean;
+    };
+    readonly highestInstalled?: string;
+    readonly installed: readonly string[];
 }
 /**
  * Resolves the full cascade for one directory/identity and reports everything `agent-shim check` documents: every entry's resolved state and which layer/condition decided it, any ambiguous `history/projects/` encoding in scope, and the three always-on diagnostics (ambient-credential exposure, macOS Keychain service name, settings-secrets exposure).
@@ -3505,6 +3531,12 @@ interface DiscoveredClaudeBinary {
     /** The version string, when discovered via the versions directory. */
     version?: string;
 }
+/** What a launch asks binary discovery for: nothing (the highest installed version) or an exact version. */
+interface ClaudeBinaryRequest {
+    readonly version?: string;
+}
+/** Discovers the real `claude` binary to spawn, for the version a launch asked for. Injected into the launcher so it never reads the filesystem or PATH itself. */
+type ClaudeBinaryResolver = (request?: Readonly<ClaudeBinaryRequest>) => DiscoveredClaudeBinary;
 
 type DoctorSeverity = "pass" | "warn" | "fail";
 type DoctorSection = "ambient-credential" | "binary-discovery" | "claude-shim" | "path-resolution" | "legacy-name" | "config-profile" | "identity" | "pool" | "provider" | "keychain" | "directory-rules" | "global-config" | "categories-local" | "active-identity" | "headroom";
@@ -3566,6 +3598,8 @@ interface DoctorPathResolution {
 /** Everything `runDoctor` needs, all of it already loaded/injected — nothing in `runDoctor` itself reads a file, shells out, or touches the farm. */
 interface RunDoctorParams {
     readonly env: Readonly<Record<string, string | undefined>>;
+    /** The Claude Code versions installed here, oldest first. Omit to skip checking that a pinned version (`launch.claudeVersion`) is installed; with it, a profile, directory rule or global config pinning a version that is not installed is a warning. */
+    readonly installedClaudeVersions?: readonly string[];
     /** Where cached credentials live. Omit to leave a credential cache's age out of the identity and provider findings; with it, a block that caches reports whether it holds an entry, how old it is and whether it has expired, never the token. */
     readonly credentialCache?: CredentialCacheEnv;
     readonly identities: readonly DoctorIdentityInput[];
@@ -3663,7 +3697,7 @@ interface PrepareLaunchParams {
     readonly proc: ProcPort;
     readonly log: LogPort;
     /** Discovers the real `claude` binary to spawn. Injected so `runLauncher` never depends on `src/versionDiscovery.ts`'s own filesystem/PATH inputs directly — the caller (`src/cli.ts`) wires the real discovery, tests wire a fake that returns a fixed path. */
-    readonly resolveClaudeBinary: () => DiscoveredClaudeBinary;
+    readonly resolveClaudeBinary: ClaudeBinaryResolver;
     /** An identity pinned to `$PWD` by a directory rule. Accepted as an already-resolved value — the rules-loading code that produces it lands in Phase 4/5. */
     readonly directoryPinnedIdentity?: string;
     /** A directory rule's `configProfile` selection for `$PWD`. Accepted as an already-resolved value for the same reason. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-shim",
-  "version": "8.9.0",
+  "version": "8.10.0",
   "description": "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
   "license": "MIT",
   "author": "Joseph Mearman <joseph@mearman.co.uk>",