hankweave 0.6.2 → 0.7.1

package/dist/claude-agent-sdk-manager.d.ts

@@ -9,6 +9,17 @@ import type { Logger } from "./utils.js";
 export declare class ClaudeExecutableNotFoundError extends Error {
     constructor(message: string);
 }
+/**
+ * Whether lenient ("legacy") Claude auth is enabled via HW_INTERNAL_CLAUDE_LEGACY_AUTH.
+ *
+ * When enabled, the pre-flight self-test does NOT hard-require ANTHROPIC_API_KEY and instead
+ * trusts the Agent SDK to resolve credentials itself — including the SDK's fallback to a local
+ * Claude Code login (macOS Keychain `Claude Code-credentials` / `~/.claude/.credentials.json`).
+ *
+ * Intended for local/dev use on a machine already logged in via `claude login`. CI and
+ * production should still set ANTHROPIC_API_KEY (the supported, ToS-compliant path).
+ */
+export declare function isLegacyClaudeAuthEnabled(): boolean;
 /**
  * Detect an installed Claude executable.
  * Checks common installation locations and falls back to `which claude`.

package/dist/claude-runtime-extractor.d.ts

@@ -1,73 +1,63 @@
 /**
  * Claude Runtime Extractor
  *
- * This module handles the extraction of bundled Claude Agent SDK files
- * at runtime for standalone executables. When compiled with Bun, the CLI
- * files are embedded in the executable and need to be extracted to disk
- * before they can be spawned as subprocesses.
+ * Handles locating/extracting the Claude Agent SDK's native CLI binary.
  *
- * The extraction is done to a versioned directory to avoid re-extraction
- * on every run and to handle SDK updates cleanly.
+ * As of @anthropic-ai/claude-agent-sdk 0.3.x, the agent runtime ships as a native,
+ * per-platform compiled binary delivered through optionalDependencies
+ * (`@anthropic-ai/claude-agent-sdk-<platform>-<arch>/claude[.exe]`) — there is no longer a
+ * bundled `cli.js` + wasm + ripgrep vendor tree.
  *
- * Build Process:
- * The build script (scripts/build-executable.ts) embeds the SDK files using:
- *   bun build --compile --embed node_modules/@anthropic-ai/claude-agent-sdk/cli.js ...
+ * Execution contexts:
+ * 1. Source / npm / npx mode: the SDK resolves the native binary itself via the optional
+ *    dependency, so no extraction is needed (ensureSdkAvailable returns null).
+ * 2. Compiled executable (`bun build --compile`): the native binary is embedded at build
+ *    time (scripts/build-executable.ts) and extracted to disk here on first run, because the
+ *    SDK's own `require.resolve` cannot reach into Bun's `$bunfs` virtual filesystem.
  *
- * At runtime, these embedded files are accessible via Bun.file() using their
- * original paths.
+ * Extraction targets a versioned directory to avoid re-extraction and to handle SDK updates.
  */
-export declare const CLAUDE_SDK_VERSION = "0.1.70";
+export declare const CLAUDE_SDK_VERSION = "0.3.156";
 /**
- * Get the extraction directory path.
- * Uses ~/.hankweave/claude-sdk/<version>/ by default.
+ * Resolve the platform/arch suffix used by the SDK's native binary packages,
+ * e.g. "darwin-arm64", "linux-x64", "win32-x64".
+ *
+ * @param target - Optional build target ("linux-x64", "darwin-arm64", "windows-x64", …).
+ *                 When omitted, uses the current platform.
  */
-export declare function getExtractionDir(): string;
+export declare function getClaudePlatformSuffix(target?: string): string;
 /**
- * Get the path to the extracted cli.js file.
+ * The native CLI binary filename for the given target (or current platform).
  */
-export declare function getExtractedCliPath(): string;
+export declare function getClaudeBinaryName(target?: string): string;
 /**
- * Check if embedded files are available (async check).
- * This actually tries to access an embedded file to verify.
+ * The node_modules directory of the platform-specific binary package, e.g.
+ * `node_modules/@anthropic-ai/claude-agent-sdk-darwin-arm64`.
+ *
+ * On Linux the package may be the glibc (`-x64`) or musl (`-x64-musl`) variant; callers that
+ * need the on-disk path (the build script) should fall back to the `-musl` suffix when the
+ * primary directory is absent.
  */
-export declare function hasEmbeddedFiles(): Promise<boolean>;
+export declare function getClaudePackageDir(target?: string): string;
 /**
- * Check if extraction is needed.
- * Returns true if the files don't exist or are outdated.
+ * Get the extraction directory (e.g. ~/.hankweave/claude-sdk/<version>/).
  */
-export declare function needsExtraction(): boolean;
+export declare function getClaudeExtractionDir(): string;
 /**
- * Extract embedded Claude SDK files to disk.
- *
- * This function reads files that were embedded during compilation using Bun's
- * --embed flag, then extracts them to a versioned directory on first run.
- *
- * The embedded files are accessed using their original paths that were
- * specified during build (e.g., "node_modules/@anthropic-ai/claude-agent-sdk/cli.js").
- *
- * Files extracted:
- * - cli.js - The main Claude Code CLI
- * - resvg.wasm - SVG rendering WASM module
- * - tree-sitter.wasm - Syntax parsing WASM module
- * - tree-sitter-bash.wasm - Bash syntax WASM module
- * - vendor/ripgrep/<platform>/ - Platform-specific ripgrep binaries
+ * Path to the extracted native CLI binary. Named `getExtractedCliPath` for backward
+ * compatibility with ClaudeAgentSDKManager.ensureSdkAvailable().
  */
-export declare function extractClaudeSdkFiles(): Promise<string>;
+export declare function getExtractedCliPath(): string;
 /**
- * Ensure Claude SDK files are available, extracting if necessary.
- *
- * @deprecated Use ClaudeAgentSDKManager.ensureSdkAvailable() instead.
- * This function is kept for backward compatibility.
- *
- * @returns SDK info object with path, version, and cached status
- * @throws Error if extraction fails or extracted file doesn't exist
+ * Whether the embedded binary still needs to be extracted (missing or outdated cache).
  */
-export declare function ensureClaudeSdkAvailable(): Promise<{
-    path: string | null;
-    version: string;
-    cached: boolean;
-}>;
+export declare function needsExtraction(): boolean;
 /**
- * Validate the extracted cli.js works by running a simple command.
+ * Extract the embedded native CLI binary to disk.
+ *
+ * Reads the binary embedded at build time via Bun's --embed flag and writes it to the
+ * versioned extraction directory, marking it executable.
+ *
+ * @returns Path to the extracted binary.
  */
-export declare function validateExtractedCli(cliPath: string): Promise<boolean>;
+export declare function extractClaudeSdkFiles(): Promise<string>;

package/dist/codex-runtime-extractor.d.ts

@@ -12,7 +12,7 @@
  * The extraction is done to a versioned directory to avoid re-extraction
  * on every run and to handle SDK updates cleanly.
  */
-export declare const CODEX_SDK_VERSION = "0.104.0";
+export declare const CODEX_SDK_VERSION = "0.135.0";
 /**
  * Platform identifier matching @openai/codex-sdk vendor directory structure
  */

package/dist/config.d.ts

@@ -2,7 +2,7 @@ import { z } from "zod";
 import type { ModelInfo } from "./llm/models-dev-schema.js";
 import { type TelemetryConfig } from "./telemetry/telemetry-types.js";
 import type { AllocationMode, OnExceededPolicy } from "./types/budget-types.js";
-import type { ModelName, ShimSelfTestResult } from "./types/types.js";
+import type { ModelName, SelfTestFailureCategory, ShimSelfTestResult } from "./types/types.js";
 import { type Logger } from "./utils.js";
 export declare const TIMEOUTS: {
     readonly RESULT_MESSAGE_MS: 30000;
@@ -40774,6 +40774,8 @@ export interface ValidationResult {
         provider: string;
         passed: boolean;
         result: ShimSelfTestResult;
+        /** Failure classification, present when `passed` is false. Routes guidance. */
+        category?: SelfTestFailureCategory;
     }>;
     /** Hank-level budget config for display in the budget resolution table */
     hankBudget?: {
@@ -40793,6 +40795,33 @@ export declare function validateRequiredEnv(requiredEnv: string[] | undefined):
     valid: boolean;
     missing: string[];
 };
+/**
+ * Classify an in-band (harness ran and returned a result) self-test failure so
+ * the final error can route the user to the right fix instead of always blaming
+ * API keys. Launch failures are classified separately at the throw site.
+ */
+export declare function classifyInBandSelfTest(result: ShimSelfTestResult): SelfTestFailureCategory;
+/**
+ * Build the guidance line(s) appended to the self-test failure error, tailored
+ * to the set of failure categories actually present. A launch/runtime crash must
+ * never be reported as an API-key problem.
+ */
+export declare function buildSelfTestGuidance(categories: Set<SelfTestFailureCategory>): string;
+/**
+ * Render a failed self-test as a per-model bullet for the aggregate error.
+ *
+ * The header is the model identity + the shim's `overall.message`. For in-band
+ * failures that message is generic ("One or more checks failed"), so we append
+ * each FAILED check's specific message (e.g. the `agent_found` check that names
+ * where the binary was searched). Launch failures carry no checks — their
+ * `overall.message` already holds the actionable detail — so only the header shows.
+ */
+export declare function formatFailedSelfTest(test: {
+    modelName: string;
+    provider: string;
+    modelId: string;
+    result: ShimSelfTestResult;
+}): string;
 /**
  * Validate hank configuration with enhanced checks.
  *