@skaft/hamr 0.4.1

package/dist/hamr/repair.js

@@ -0,0 +1,85 @@
+import { getAssistantText, getThinkingText, hasToolCalls, modelKey } from "./helpers.js";
+import { detectParserId } from "./providers/parsers/types.js";
+import { parseModelOutput } from "./providers/tool-calls.js";
+import { buildHamrProviderRegistrations } from "./startup-config.js";
+export const parserByModel = new Map();
+function parserFor(message, ctx) {
+    return (parserByModel.get(modelKey(message.provider, message.model)) ??
+        (ctx.model ? parserByModel.get(modelKey(ctx.model.provider, ctx.model.id)) : undefined) ??
+        detectParserId(message.model) ??
+        (ctx.model ? detectParserId(ctx.model.id) : undefined) ??
+        "generic");
+}
+export function repairLocalToolCalls(message, ctx) {
+    if (hasToolCalls(message))
+        return undefined;
+    const text = getAssistantText(message);
+    const thinking = getThinkingText(message);
+    if (!text.trim() && !thinking?.trim())
+        return undefined;
+    const parsed = parseModelOutput(text, parserFor(message, ctx), thinking);
+    if (parsed.toolCalls.length === 0)
+        return undefined;
+    const content = [];
+    if (parsed.reasoning) {
+        content.push({ type: "thinking", thinking: parsed.reasoning });
+    }
+    if (parsed.assistantText.trim()) {
+        content.push({ type: "text", text: parsed.assistantText.trim() });
+    }
+    for (const call of parsed.toolCalls) {
+        content.push({
+            type: "toolCall",
+            id: call.id,
+            name: call.name,
+            arguments: call.arguments,
+        });
+    }
+    return {
+        ...message,
+        content,
+        stopReason: "toolUse",
+        diagnostics: [
+            ...(message.diagnostics ?? []),
+            ...parsed.warnings.map((warning) => ({
+                type: "hamr.tool_call_repair",
+                timestamp: Date.now(),
+                details: {
+                    source: warning.source,
+                    message: warning.message,
+                },
+            })),
+        ],
+    };
+}
+export function hasSubstantialContent(event) {
+    switch (event.type) {
+        case "start":
+        case "done":
+        case "error":
+            return false;
+        case "text_delta":
+        case "thinking_delta":
+        case "toolcall_delta":
+            return event.delta.trim().length > 0;
+        case "text_start":
+        case "thinking_start":
+        case "toolcall_start":
+        case "text_end":
+        case "thinking_end":
+        case "toolcall_end":
+            return true;
+        default:
+            return false;
+    }
+}
+export async function registerHamrProviders(pi, config) {
+    const registrations = await buildHamrProviderRegistrations(config);
+    for (const registration of registrations) {
+        for (const [modelId, parserId] of registration.parserByModel) {
+            parserByModel.set(modelKey(registration.name, modelId), parserId);
+        }
+        pi.registerProvider(registration.name, registration.config);
+    }
+}
+//# sourceMappingURL=repair.js.map

package/dist/hamr/repair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.js","sourceRoot":"","sources":["../../src/hamr/repair.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AssistantMessage, AssistantMessageEvent, ToolCall } from \"@hamr/ai\";\nimport type { ExtensionContext, ExtensionFactory } from \"../core/extensions/types.ts\";\nimport { getAssistantText, getThinkingText, hasToolCalls, modelKey } from \"./helpers.ts\";\nimport { detectParserId } from \"./providers/parsers/types.ts\";\nimport { parseModelOutput } from \"./providers/tool-calls.ts\";\nimport type { HamrStartupConfig } from \"./startup-config.ts\";\nimport { buildHamrProviderRegistrations } from \"./startup-config.ts\";\n\nexport const parserByModel = new Map<string, string>();\n\nfunction parserFor(message: AssistantMessage, ctx: ExtensionContext): string {\n\treturn (\n\t\tparserByModel.get(modelKey(message.provider, message.model)) ??\n\t\t(ctx.model ? parserByModel.get(modelKey(ctx.model.provider, ctx.model.id)) : undefined) ??\n\t\tdetectParserId(message.model) ??\n\t\t(ctx.model ? detectParserId(ctx.model.id) : undefined) ??\n\t\t\"generic\"\n\t);\n}\n\nexport function repairLocalToolCalls(message: AssistantMessage, ctx: ExtensionContext): AssistantMessage | undefined {\n\tif (hasToolCalls(message)) return undefined;\n\tconst text = getAssistantText(message);\n\tconst thinking = getThinkingText(message);\n\tif (!text.trim() && !thinking?.trim()) return undefined;\n\n\tconst parsed = parseModelOutput(text, parserFor(message, ctx), thinking);\n\tif (parsed.toolCalls.length === 0) return undefined;\n\n\tconst content: AssistantMessage[\"content\"] = [];\n\tif (parsed.reasoning) {\n\t\tcontent.push({ type: \"thinking\", thinking: parsed.reasoning });\n\t}\n\tif (parsed.assistantText.trim()) {\n\t\tcontent.push({ type: \"text\", text: parsed.assistantText.trim() });\n\t}\n\tfor (const call of parsed.toolCalls) {\n\t\tcontent.push({\n\t\t\ttype: \"toolCall\",\n\t\t\tid: call.id,\n\t\t\tname: call.name,\n\t\t\targuments: call.arguments,\n\t\t} satisfies ToolCall);\n\t}\n\n\treturn {\n\t\t...message,\n\t\tcontent,\n\t\tstopReason: \"toolUse\",\n\t\tdiagnostics: [\n\t\t\t...(message.diagnostics ?? []),\n\t\t\t...parsed.warnings.map((warning) => ({\n\t\t\t\ttype: \"hamr.tool_call_repair\",\n\t\t\t\ttimestamp: Date.now(),\n\t\t\t\tdetails: {\n\t\t\t\t\tsource: warning.source,\n\t\t\t\t\tmessage: warning.message,\n\t\t\t\t},\n\t\t\t})),\n\t\t],\n\t};\n}\n\nexport function hasSubstantialContent(event: AssistantMessageEvent): boolean {\n\tswitch (event.type) {\n\t\tcase \"start\":\n\t\tcase \"done\":\n\t\tcase \"error\":\n\t\t\treturn false;\n\t\tcase \"text_delta\":\n\t\tcase \"thinking_delta\":\n\t\tcase \"toolcall_delta\":\n\t\t\treturn event.delta.trim().length > 0;\n\t\tcase \"text_start\":\n\t\tcase \"thinking_start\":\n\t\tcase \"toolcall_start\":\n\t\tcase \"text_end\":\n\t\tcase \"thinking_end\":\n\t\tcase \"toolcall_end\":\n\t\t\treturn true;\n\t\tdefault:\n\t\t\treturn false;\n\t}\n}\n\nexport async function registerHamrProviders(\n\tpi: Parameters<ExtensionFactory>[0],\n\tconfig: HamrStartupConfig,\n): Promise<void> {\n\tconst registrations = await buildHamrProviderRegistrations(config);\n\tfor (const registration of registrations) {\n\t\tfor (const [modelId, parserId] of registration.parserByModel) {\n\t\t\tparserByModel.set(modelKey(registration.name, modelId), parserId);\n\t\t}\n\t\tpi.registerProvider(registration.name, registration.config);\n\t}\n}\n"]}

package/dist/hamr/shimmer.d.ts

@@ -0,0 +1,2 @@
+export declare const RAINBOW_WORD_FRAMES: string[];
+//# sourceMappingURL=shimmer.d.ts.map

package/dist/hamr/shimmer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shimmer.d.ts","sourceRoot":"","sources":["../../src/hamr/shimmer.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,EAAE,MAAM,EAOvC,CAAC"}

package/dist/hamr/shimmer.js

@@ -0,0 +1,9 @@
+export const RAINBOW_WORD_FRAMES = [
+    "\x1b[31m● thinking\x1b[0m",
+    "\x1b[33m● thinking\x1b[0m",
+    "\x1b[32m● thinking\x1b[0m",
+    "\x1b[36m● thinking\x1b[0m",
+    "\x1b[34m● thinking\x1b[0m",
+    "\x1b[35m● thinking\x1b[0m",
+];
+//# sourceMappingURL=shimmer.js.map

package/dist/hamr/shimmer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shimmer.js","sourceRoot":"","sources":["../../src/hamr/shimmer.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAa;IAC5C,2BAA2B;IAC3B,2BAA2B;IAC3B,2BAA2B;IAC3B,2BAA2B;IAC3B,2BAA2B;IAC3B,2BAA2B;CAC3B,CAAC","sourcesContent":["export const RAINBOW_WORD_FRAMES: string[] = [\n\t\"\\x1b[31m● thinking\\x1b[0m\",\n\t\"\\x1b[33m● thinking\\x1b[0m\",\n\t\"\\x1b[32m● thinking\\x1b[0m\",\n\t\"\\x1b[36m● thinking\\x1b[0m\",\n\t\"\\x1b[34m● thinking\\x1b[0m\",\n\t\"\\x1b[35m● thinking\\x1b[0m\",\n];\n"]}

package/dist/hamr/startup-config.d.ts

@@ -0,0 +1,78 @@
+import type { ThinkingLevel } from "@hamr/agent";
+import type { Model } from "@hamr/ai";
+import type { ProviderConfig } from "../core/extensions/types.ts";
+import type { ModelRegistry } from "../core/model-registry.ts";
+type HamrThinkingLevel = ThinkingLevel | "auto";
+interface HamrModelConfig {
+    id: string;
+    display_name?: string;
+    displayName?: string;
+    context_window?: number;
+    contextWindow?: number;
+    max_output_tokens?: number;
+    maxOutputTokens?: number;
+    supports_thinking?: boolean;
+    supportsThinking?: boolean;
+    supports_vision?: boolean;
+    supportsVision?: boolean;
+    thinking_levels?: HamrThinkingLevel[];
+    thinkingLevels?: HamrThinkingLevel[];
+    default_thinking?: HamrThinkingLevel;
+    defaultThinking?: HamrThinkingLevel;
+    tool_call_parser?: string;
+    toolCallParser?: string;
+}
+interface HamrProviderConfig {
+    enabled?: boolean;
+    name?: string;
+    compatibility?: "openai-compatible" | "anthropic-compatible";
+    base_url?: string;
+    baseUrl?: string;
+    api_key?: string;
+    apiKey?: string;
+    api_key_env?: string;
+    apiKeyEnv?: string;
+    headers?: Record<string, string>;
+    custom_headers?: Record<string, string>;
+    customHeaders?: Record<string, string>;
+    models?: HamrModelConfig[];
+    tool_call_parser?: string;
+    toolCallParser?: string;
+    /**
+     * Whether this provider is a cloud provider. Cloud models may dispatch
+     * parallel subagents; relay/local providers may not. Defaults to false for
+     * configured providers (which are local/relay by convention).
+     */
+    cloud?: boolean;
+}
+export interface HamrStartupConfig {
+    active?: {
+        provider?: string;
+        model?: string;
+        thinking?: HamrThinkingLevel;
+    };
+    providers: Record<string, HamrProviderConfig>;
+    sourcePaths: string[];
+}
+export interface HamrProviderRegistration {
+    name: string;
+    config: ProviderConfig;
+    parserByModel: Map<string, string>;
+}
+export declare function loadHamrStartupConfig(cwd?: string): HamrStartupConfig;
+/**
+ * Whether the given provider id should be treated as a cloud provider.
+ *
+ * Configured providers (relay, local LM endpoints) are local by convention and
+ * default to non-cloud unless they set `cloud: true`. Providers that are not in
+ * the hamr config at all are the built-in cloud providers (anthropic, openai,
+ * …), so they are treated as cloud. Used to gate parallel subagent dispatch.
+ */
+export declare function isCloudProvider(config: HamrStartupConfig, providerId: string): boolean;
+export declare function buildHamrProviderRegistrations(config: HamrStartupConfig): Promise<HamrProviderRegistration[]>;
+export declare function getHamrDefaultModel(config: HamrStartupConfig, modelRegistry: ModelRegistry): {
+    model: Model<any>;
+    thinkingLevel?: ThinkingLevel;
+} | undefined;
+export {};
+//# sourceMappingURL=startup-config.d.ts.map

package/dist/hamr/startup-config.d.ts.map

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

package/dist/hamr/startup-config.js

@@ -0,0 +1,344 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { parse as parseToml } from "toml";
+import { detectParserId } from "./providers/parsers/types.js";
+import { discoverRelayModels as discoverRelayEndpointModels } from "./providers/relay-provider.js";
+const DEFAULT_RELAY_BASE_URL = "http://127.0.0.1:1234/v1";
+const LOCAL_API_KEY = "not-needed";
+/** Env override for the relay endpoint base URL (matches synax's HAMR_ prefix convention). */
+const RELAY_BASE_URL_ENV = "HAMR_RELAY_BASE_URL";
+/** When set to "1", skip network model discovery (mirrors synax's test gate). */
+const SKIP_NETWORK_ENV = "HAMR_TEST_SKIP_NETWORK";
+/**
+ * Expand ${VAR} and $VAR references in a config string from process.env,
+ * matching synax's config interpolation. Unset vars expand to "".
+ */
+function expandEnv(value) {
+    if (value === undefined)
+        return undefined;
+    return value
+        .replace(/\$\{(\w+)\}/g, (_, name) => process.env[name] ?? "")
+        .replace(/\$(\w+)/g, (_, name) => process.env[name] ?? "");
+}
+/** Resolve the effective relay base URL: env override > config > default. */
+function resolveRelayBaseUrl(provider) {
+    const fromEnv = process.env[RELAY_BASE_URL_ENV]?.trim();
+    if (fromEnv)
+        return fromEnv;
+    return providerBaseUrl(provider) ?? DEFAULT_RELAY_BASE_URL;
+}
+function globalHamrConfigPath() {
+    const home = process.env.HOME || process.env.USERPROFILE;
+    return home ? join(home, ".config", "hamr", "config.toml") : "";
+}
+function discoverLocalConfigPath(baseDir) {
+    const candidate = join(baseDir, ".hamr.toml");
+    if (existsSync(candidate))
+        return candidate;
+    const parent = dirname(baseDir);
+    if (parent === baseDir)
+        return undefined;
+    return discoverLocalConfigPath(parent);
+}
+function parseConfigFile(path) {
+    if (!path || !existsSync(path))
+        return undefined;
+    const parsed = parseToml(readFileSync(path, "utf8"));
+    return {
+        active: typeof parsed.active === "object" && parsed.active ? parsed.active : undefined,
+        providers: typeof parsed.providers === "object" && parsed.providers
+            ? parsed.providers
+            : undefined,
+    };
+}
+function mergeConfig(base, next, sourcePath) {
+    return {
+        active: { ...(base.active ?? {}), ...(next.active ?? {}) },
+        providers: {
+            ...base.providers,
+            ...(next.providers ?? {}),
+        },
+        sourcePaths: [...base.sourcePaths, sourcePath],
+    };
+}
+export function loadHamrStartupConfig(cwd = process.cwd()) {
+    let config = {
+        active: {
+            provider: "relay",
+            thinking: "off",
+        },
+        providers: {
+            relay: {
+                enabled: true,
+                name: "Relay",
+                compatibility: "openai-compatible",
+                base_url: DEFAULT_RELAY_BASE_URL,
+            },
+        },
+        sourcePaths: [],
+    };
+    const globalPath = globalHamrConfigPath();
+    const globalConfig = parseConfigFile(globalPath);
+    if (globalConfig)
+        config = mergeConfig(config, globalConfig, globalPath);
+    const localPath = discoverLocalConfigPath(cwd);
+    const localConfig = localPath ? parseConfigFile(localPath) : undefined;
+    if (localPath && localConfig)
+        config = mergeConfig(config, localConfig, localPath);
+    return config;
+}
+function envReference(name) {
+    if (!name)
+        return undefined;
+    return `$${name}`;
+}
+function providerBaseUrl(provider) {
+    return provider.base_url ?? provider.baseUrl;
+}
+function providerHeaders(provider) {
+    const headers = provider.headers ?? provider.custom_headers ?? provider.customHeaders;
+    if (!headers || Object.keys(headers).length === 0)
+        return undefined;
+    // Expand ${VAR}/$VAR references so custom auth headers work for discovery.
+    const expanded = {};
+    for (const [key, value] of Object.entries(headers)) {
+        expanded[key] = expandEnv(value) ?? value;
+    }
+    return expanded;
+}
+/**
+ * Resolve a concrete API key for talking to the endpoint (model discovery).
+ * Unlike the registration apiKey (which pi resolves itself), this returns the
+ * actual value: a literal, env interpolation, or the named env var. Local
+ * relays usually need no key, so this may legitimately be undefined.
+ */
+function resolveProviderApiKey(provider) {
+    const literal = expandEnv(provider.api_key ?? provider.apiKey)?.trim();
+    if (literal)
+        return literal;
+    const envName = provider.api_key_env ?? provider.apiKeyEnv;
+    const fromEnv = envName ? process.env[envName]?.trim() : undefined;
+    return fromEnv || undefined;
+}
+function normalizeThinking(level) {
+    if (!level || level === "auto")
+        return undefined;
+    return level;
+}
+/**
+ * Auto-detect models served by an OpenAI-compatible relay endpoint and map
+ * them into Hamr's model-config shape. The endpoint complexity is masked: the
+ * user just sees whatever models the relay is currently serving. Returns an
+ * empty list when the endpoint is unreachable (no crash, falls back to config).
+ */
+async function discoverRelayModels(baseUrl, apiKey, headers) {
+    if (process.env[SKIP_NETWORK_ENV] === "1")
+        return [];
+    const discovered = await discoverRelayEndpointModels(baseUrl, apiKey, headers);
+    return discovered.map((model) => ({
+        id: model.id,
+        display_name: model.displayName,
+        context_window: model.contextWindow,
+        max_output_tokens: model.maxOutputTokens,
+        supports_thinking: model.supportsThinking,
+        thinking_levels: model.thinkingLevels,
+        // Pass supportsVision through unmodified so that modelToProviderModel's
+        // `?? true` default applies consistently: undefined → vision-capable.
+        // Relays that explicitly advertise "text-only" get supportsVision=false.
+        supports_vision: model.supportsVision,
+    }));
+}
+function modelContextWindow(model) {
+    return model.context_window ?? model.contextWindow;
+}
+function modelMaxOutputTokens(model) {
+    return model.max_output_tokens ?? model.maxOutputTokens;
+}
+function modelSupportsVision(model) {
+    return model.supports_vision ?? model.supportsVision;
+}
+function mergeDiscoveredModel(configured, discovered) {
+    return {
+        ...discovered,
+        ...configured,
+        display_name: configured.display_name ?? configured.displayName ?? discovered.display_name ?? discovered.displayName,
+        context_window: modelContextWindow(discovered) ?? modelContextWindow(configured),
+        max_output_tokens: modelMaxOutputTokens(discovered) ?? modelMaxOutputTokens(configured),
+        supports_vision: modelSupportsVision(configured) ?? modelSupportsVision(discovered),
+        supports_thinking: configured.supports_thinking ??
+            configured.supportsThinking ??
+            discovered.supports_thinking ??
+            discovered.supportsThinking,
+        thinking_levels: configured.thinking_levels ??
+            configured.thinkingLevels ??
+            discovered.thinking_levels ??
+            discovered.thinkingLevels,
+        default_thinking: configured.default_thinking ?? configured.defaultThinking ?? discovered.default_thinking,
+        tool_call_parser: configured.tool_call_parser ??
+            configured.toolCallParser ??
+            discovered.tool_call_parser ??
+            discovered.toolCallParser,
+    };
+}
+function mergeProviderModels(configured, discovered) {
+    if (configured.length === 0)
+        return discovered;
+    if (discovered.length === 0)
+        return configured;
+    const discoveredById = new Map(discovered.map((model) => [model.id.toLowerCase(), model]));
+    const configuredIds = new Set(configured.map((model) => model.id.toLowerCase()));
+    return [
+        ...configured.map((model) => {
+            const discoveredModel = discoveredById.get(model.id.toLowerCase());
+            return discoveredModel ? mergeDiscoveredModel(model, discoveredModel) : model;
+        }),
+        ...discovered.filter((model) => !configuredIds.has(model.id.toLowerCase())),
+    ];
+}
+/**
+ * Resolve the model list for a provider. Explicit config models define local
+ * intent, but OpenAI-compatible providers are still probed so live endpoint
+ * facts (especially context length) can override stale or incomplete config.
+ */
+async function resolveProviderModels(providerId, provider) {
+    const configured = provider.models ?? [];
+    const compatibility = provider.compatibility ?? "openai-compatible";
+    if (compatibility !== "openai-compatible")
+        return configured;
+    const baseUrl = providerId === "relay" ? resolveRelayBaseUrl(provider) : providerBaseUrl(provider);
+    if (!baseUrl)
+        return configured;
+    const discovered = await discoverRelayModels(baseUrl, resolveProviderApiKey(provider), providerHeaders(provider));
+    return mergeProviderModels(configured, discovered);
+}
+function detectThinkingFormat(modelId) {
+    const lower = modelId.toLowerCase();
+    if (/deepseek-?r1/.test(lower))
+        return "deepseek";
+    if (/\bqwen3\b/.test(lower) || /\bqwen3[.-]/.test(lower))
+        return "qwen";
+    return undefined;
+}
+function modelToProviderModel(model, provider) {
+    const thinking = model.supports_thinking ?? model.supportsThinking ?? false;
+    const supportsVision = model.supports_vision ?? model.supportsVision ?? true;
+    const contextWindow = modelContextWindow(model) ?? 0;
+    const compatibility = provider.compatibility ?? "openai-compatible";
+    const thinkingFormat = detectThinkingFormat(model.id);
+    // Derive thinkingLevelMap from the actual levels advertised by the relay.
+    //
+    // Semantics of thinkingLevelMap (see packages/ai/src/types.ts): a *missing*
+    // key means the level is supported and uses the provider default; an explicit
+    // `null` marks the level as unsupported. So we translate the relay's flat list
+    // of supported levels into "leave advertised levels missing, null out the rest"
+    // rather than the other way around.
+    const CANONICAL_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh"];
+    const rawLevels = model.thinking_levels ?? (thinking ? ["off", "on"] : []);
+    // Relay vocabulary uses "on" (no "minimal"); pi uses "minimal" (no "on").
+    // "off" is always offered when thinking is supported, and a bare "on"
+    // (supports_thinking with no explicit levels) is treated as max thinking.
+    const advertised = new Set(thinking ? ["off"] : []);
+    for (const level of rawLevels) {
+        advertised.add(level === "on" ? "high" : level);
+    }
+    const thinkingLevelMap = {};
+    for (const level of CANONICAL_LEVELS) {
+        if (!advertised.has(level)) {
+            thinkingLevelMap[level] = null; // unsupported
+        }
+        else if (level === "xhigh") {
+            // xhigh is excluded unless it maps to a defined value.
+            thinkingLevelMap.xhigh = "xhigh";
+        }
+        // Advertised non-xhigh levels are left missing → supported, provider default.
+    }
+    return {
+        id: model.id,
+        name: model.display_name ?? model.displayName ?? model.id,
+        reasoning: thinking,
+        thinkingLevelMap,
+        input: supportsVision ? ["text", "image"] : ["text"],
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+        contextWindow,
+        maxTokens: modelMaxOutputTokens(model) ?? (contextWindow > 0 ? Math.min(16384, contextWindow) : 16384),
+        compat: compatibility === "openai-compatible"
+            ? {
+                supportsDeveloperRole: false,
+                supportsUsageInStreaming: false,
+                supportsStrictMode: false,
+                maxTokensField: "max_tokens",
+                ...(thinkingFormat !== undefined ? { thinkingFormat } : {}),
+            }
+            : undefined,
+    };
+}
+/**
+ * Whether the given provider id should be treated as a cloud provider.
+ *
+ * Configured providers (relay, local LM endpoints) are local by convention and
+ * default to non-cloud unless they set `cloud: true`. Providers that are not in
+ * the hamr config at all are the built-in cloud providers (anthropic, openai,
+ * …), so they are treated as cloud. Used to gate parallel subagent dispatch.
+ */
+export function isCloudProvider(config, providerId) {
+    const provider = config.providers[providerId];
+    if (!provider)
+        return true;
+    return provider.cloud === true;
+}
+export async function buildHamrProviderRegistrations(config) {
+    const registrations = [];
+    for (const [providerId, provider] of Object.entries(config.providers)) {
+        if (provider.enabled === false)
+            continue;
+        const compatibility = provider.compatibility ?? "openai-compatible";
+        // The relay's base URL falls back to the env override / default; other
+        // providers must declare one explicitly.
+        const resolvedBaseUrl = providerId === "relay" ? resolveRelayBaseUrl(provider) : providerBaseUrl(provider);
+        const baseUrl = expandEnv(resolvedBaseUrl);
+        if (!baseUrl)
+            continue;
+        const models = await resolveProviderModels(providerId, provider);
+        if (models.length === 0)
+            continue;
+        // Per-model tool-call parser: explicit config override wins, otherwise
+        // auto-detect from the model id (same conservative matching synax uses).
+        // This is baked into the registration so the model picks up the right
+        // local-model parser the moment it is discovered.
+        const parserByModel = new Map();
+        for (const model of models) {
+            const explicit = model.tool_call_parser ?? model.toolCallParser ?? provider.tool_call_parser ?? provider.toolCallParser;
+            const parser = explicit ?? detectParserId(model.id);
+            if (parser)
+                parserByModel.set(model.id, parser);
+        }
+        registrations.push({
+            name: providerId,
+            parserByModel,
+            config: {
+                name: provider.name ?? providerId,
+                baseUrl,
+                api: compatibility === "anthropic-compatible" ? "anthropic-messages" : "openai-completions",
+                apiKey: provider.api_key ??
+                    provider.apiKey ??
+                    envReference(provider.api_key_env ?? provider.apiKeyEnv) ??
+                    LOCAL_API_KEY,
+                authHeader: false,
+                headers: providerHeaders(provider),
+                models: models.map((model) => modelToProviderModel(model, provider)),
+            },
+        });
+    }
+    return registrations;
+}
+export function getHamrDefaultModel(config, modelRegistry) {
+    const provider = config.active?.provider ?? "relay";
+    const modelId = config.active?.model;
+    const model = modelId
+        ? modelRegistry.find(provider, modelId)
+        : modelRegistry.getAll().find((candidate) => candidate.provider === provider);
+    if (!model || !modelRegistry.hasConfiguredAuth(model))
+        return undefined;
+    return { model, thinkingLevel: normalizeThinking(config.active?.thinking) };
+}
+//# sourceMappingURL=startup-config.js.map

package/dist/hamr/startup-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-config.js","sourceRoot":"","sources":["../../src/hamr/startup-config.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport type { ThinkingLevel } from \"@hamr/agent\";\nimport type { Model } from \"@hamr/ai\";\nimport { parse as parseToml } from \"toml\";\nimport type { ProviderConfig } from \"../core/extensions/types.ts\";\nimport type { ModelRegistry } from \"../core/model-registry.ts\";\nimport { detectParserId } from \"./providers/parsers/types.ts\";\nimport { discoverRelayModels as discoverRelayEndpointModels } from \"./providers/relay-provider.ts\";\n\ntype HamrThinkingLevel = ThinkingLevel | \"auto\";\n\ninterface HamrModelConfig {\n\tid: string;\n\tdisplay_name?: string;\n\tdisplayName?: string;\n\tcontext_window?: number;\n\tcontextWindow?: number;\n\tmax_output_tokens?: number;\n\tmaxOutputTokens?: number;\n\tsupports_thinking?: boolean;\n\tsupportsThinking?: boolean;\n\tsupports_vision?: boolean;\n\tsupportsVision?: boolean;\n\tthinking_levels?: HamrThinkingLevel[];\n\tthinkingLevels?: HamrThinkingLevel[];\n\tdefault_thinking?: HamrThinkingLevel;\n\tdefaultThinking?: HamrThinkingLevel;\n\ttool_call_parser?: string;\n\ttoolCallParser?: string;\n}\n\ninterface HamrProviderConfig {\n\tenabled?: boolean;\n\tname?: string;\n\tcompatibility?: \"openai-compatible\" | \"anthropic-compatible\";\n\tbase_url?: string;\n\tbaseUrl?: string;\n\tapi_key?: string;\n\tapiKey?: string;\n\tapi_key_env?: string;\n\tapiKeyEnv?: string;\n\theaders?: Record<string, string>;\n\tcustom_headers?: Record<string, string>;\n\tcustomHeaders?: Record<string, string>;\n\tmodels?: HamrModelConfig[];\n\ttool_call_parser?: string;\n\ttoolCallParser?: string;\n\t/**\n\t * Whether this provider is a cloud provider. Cloud models may dispatch\n\t * parallel subagents; relay/local providers may not. Defaults to false for\n\t * configured providers (which are local/relay by convention).\n\t */\n\tcloud?: boolean;\n}\n\nexport interface HamrStartupConfig {\n\tactive?: {\n\t\tprovider?: string;\n\t\tmodel?: string;\n\t\tthinking?: HamrThinkingLevel;\n\t};\n\tproviders: Record<string, HamrProviderConfig>;\n\tsourcePaths: string[];\n}\n\nexport interface HamrProviderRegistration {\n\tname: string;\n\tconfig: ProviderConfig;\n\tparserByModel: Map<string, string>;\n}\n\nconst DEFAULT_RELAY_BASE_URL = \"http://127.0.0.1:1234/v1\";\nconst LOCAL_API_KEY = \"not-needed\";\n/** Env override for the relay endpoint base URL (matches synax's HAMR_ prefix convention). */\nconst RELAY_BASE_URL_ENV = \"HAMR_RELAY_BASE_URL\";\n/** When set to \"1\", skip network model discovery (mirrors synax's test gate). */\nconst SKIP_NETWORK_ENV = \"HAMR_TEST_SKIP_NETWORK\";\n\n/**\n * Expand ${VAR} and $VAR references in a config string from process.env,\n * matching synax's config interpolation. Unset vars expand to \"\".\n */\nfunction expandEnv(value: string | undefined): string | undefined {\n\tif (value === undefined) return undefined;\n\treturn value\n\t\t.replace(/\\$\\{(\\w+)\\}/g, (_, name: string) => process.env[name] ?? \"\")\n\t\t.replace(/\\$(\\w+)/g, (_, name: string) => process.env[name] ?? \"\");\n}\n\n/** Resolve the effective relay base URL: env override > config > default. */\nfunction resolveRelayBaseUrl(provider: HamrProviderConfig): string {\n\tconst fromEnv = process.env[RELAY_BASE_URL_ENV]?.trim();\n\tif (fromEnv) return fromEnv;\n\treturn providerBaseUrl(provider) ?? DEFAULT_RELAY_BASE_URL;\n}\n\nfunction globalHamrConfigPath(): string {\n\tconst home = process.env.HOME || process.env.USERPROFILE;\n\treturn home ? join(home, \".config\", \"hamr\", \"config.toml\") : \"\";\n}\n\nfunction discoverLocalConfigPath(baseDir: string): string | undefined {\n\tconst candidate = join(baseDir, \".hamr.toml\");\n\tif (existsSync(candidate)) return candidate;\n\tconst parent = dirname(baseDir);\n\tif (parent === baseDir) return undefined;\n\treturn discoverLocalConfigPath(parent);\n}\n\nfunction parseConfigFile(path: string): Partial<HamrStartupConfig> | undefined {\n\tif (!path || !existsSync(path)) return undefined;\n\tconst parsed = parseToml(readFileSync(path, \"utf8\")) as Record<string, unknown>;\n\treturn {\n\t\tactive:\n\t\t\ttypeof parsed.active === \"object\" && parsed.active ? (parsed.active as HamrStartupConfig[\"active\"]) : undefined,\n\t\tproviders:\n\t\t\ttypeof parsed.providers === \"object\" && parsed.providers\n\t\t\t\t? (parsed.providers as Record<string, HamrProviderConfig>)\n\t\t\t\t: undefined,\n\t};\n}\n\nfunction mergeConfig(base: HamrStartupConfig, next: Partial<HamrStartupConfig>, sourcePath: string): HamrStartupConfig {\n\treturn {\n\t\tactive: { ...(base.active ?? {}), ...(next.active ?? {}) },\n\t\tproviders: {\n\t\t\t...base.providers,\n\t\t\t...(next.providers ?? {}),\n\t\t},\n\t\tsourcePaths: [...base.sourcePaths, sourcePath],\n\t};\n}\n\nexport function loadHamrStartupConfig(cwd: string = process.cwd()): HamrStartupConfig {\n\tlet config: HamrStartupConfig = {\n\t\tactive: {\n\t\t\tprovider: \"relay\",\n\t\t\tthinking: \"off\",\n\t\t},\n\t\tproviders: {\n\t\t\trelay: {\n\t\t\t\tenabled: true,\n\t\t\t\tname: \"Relay\",\n\t\t\t\tcompatibility: \"openai-compatible\",\n\t\t\t\tbase_url: DEFAULT_RELAY_BASE_URL,\n\t\t\t},\n\t\t},\n\t\tsourcePaths: [],\n\t};\n\n\tconst globalPath = globalHamrConfigPath();\n\tconst globalConfig = parseConfigFile(globalPath);\n\tif (globalConfig) config = mergeConfig(config, globalConfig, globalPath);\n\n\tconst localPath = discoverLocalConfigPath(cwd);\n\tconst localConfig = localPath ? parseConfigFile(localPath) : undefined;\n\tif (localPath && localConfig) config = mergeConfig(config, localConfig, localPath);\n\n\treturn config;\n}\n\nfunction envReference(name?: string): string | undefined {\n\tif (!name) return undefined;\n\treturn `$${name}`;\n}\n\nfunction providerBaseUrl(provider: HamrProviderConfig): string | undefined {\n\treturn provider.base_url ?? provider.baseUrl;\n}\n\nfunction providerHeaders(provider: HamrProviderConfig): Record<string, string> | undefined {\n\tconst headers = provider.headers ?? provider.custom_headers ?? provider.customHeaders;\n\tif (!headers || Object.keys(headers).length === 0) return undefined;\n\t// Expand ${VAR}/$VAR references so custom auth headers work for discovery.\n\tconst expanded: Record<string, string> = {};\n\tfor (const [key, value] of Object.entries(headers)) {\n\t\texpanded[key] = expandEnv(value) ?? value;\n\t}\n\treturn expanded;\n}\n\n/**\n * Resolve a concrete API key for talking to the endpoint (model discovery).\n * Unlike the registration apiKey (which pi resolves itself), this returns the\n * actual value: a literal, env interpolation, or the named env var. Local\n * relays usually need no key, so this may legitimately be undefined.\n */\nfunction resolveProviderApiKey(provider: HamrProviderConfig): string | undefined {\n\tconst literal = expandEnv(provider.api_key ?? provider.apiKey)?.trim();\n\tif (literal) return literal;\n\tconst envName = provider.api_key_env ?? provider.apiKeyEnv;\n\tconst fromEnv = envName ? process.env[envName]?.trim() : undefined;\n\treturn fromEnv || undefined;\n}\n\nfunction normalizeThinking(level: HamrThinkingLevel | undefined): ThinkingLevel | undefined {\n\tif (!level || level === \"auto\") return undefined;\n\treturn level;\n}\n\n/**\n * Auto-detect models served by an OpenAI-compatible relay endpoint and map\n * them into Hamr's model-config shape. The endpoint complexity is masked: the\n * user just sees whatever models the relay is currently serving. Returns an\n * empty list when the endpoint is unreachable (no crash, falls back to config).\n */\nasync function discoverRelayModels(\n\tbaseUrl: string,\n\tapiKey: string | undefined,\n\theaders: Record<string, string> | undefined,\n): Promise<HamrModelConfig[]> {\n\tif (process.env[SKIP_NETWORK_ENV] === \"1\") return [];\n\tconst discovered = await discoverRelayEndpointModels(baseUrl, apiKey, headers);\n\treturn discovered.map((model) => ({\n\t\tid: model.id,\n\t\tdisplay_name: model.displayName,\n\t\tcontext_window: model.contextWindow,\n\t\tmax_output_tokens: model.maxOutputTokens,\n\t\tsupports_thinking: model.supportsThinking,\n\t\tthinking_levels: model.thinkingLevels as HamrThinkingLevel[],\n\t\t// Pass supportsVision through unmodified so that modelToProviderModel's\n\t\t// `?? true` default applies consistently: undefined → vision-capable.\n\t\t// Relays that explicitly advertise \"text-only\" get supportsVision=false.\n\t\tsupports_vision: model.supportsVision,\n\t}));\n}\n\nfunction modelContextWindow(model: HamrModelConfig): number | undefined {\n\treturn model.context_window ?? model.contextWindow;\n}\n\nfunction modelMaxOutputTokens(model: HamrModelConfig): number | undefined {\n\treturn model.max_output_tokens ?? model.maxOutputTokens;\n}\n\nfunction modelSupportsVision(model: HamrModelConfig): boolean | undefined {\n\treturn model.supports_vision ?? model.supportsVision;\n}\n\nfunction mergeDiscoveredModel(configured: HamrModelConfig, discovered: HamrModelConfig): HamrModelConfig {\n\treturn {\n\t\t...discovered,\n\t\t...configured,\n\t\tdisplay_name:\n\t\t\tconfigured.display_name ?? configured.displayName ?? discovered.display_name ?? discovered.displayName,\n\t\tcontext_window: modelContextWindow(discovered) ?? modelContextWindow(configured),\n\t\tmax_output_tokens: modelMaxOutputTokens(discovered) ?? modelMaxOutputTokens(configured),\n\t\tsupports_vision: modelSupportsVision(configured) ?? modelSupportsVision(discovered),\n\t\tsupports_thinking:\n\t\t\tconfigured.supports_thinking ??\n\t\t\tconfigured.supportsThinking ??\n\t\t\tdiscovered.supports_thinking ??\n\t\t\tdiscovered.supportsThinking,\n\t\tthinking_levels:\n\t\t\tconfigured.thinking_levels ??\n\t\t\tconfigured.thinkingLevels ??\n\t\t\tdiscovered.thinking_levels ??\n\t\t\tdiscovered.thinkingLevels,\n\t\tdefault_thinking: configured.default_thinking ?? configured.defaultThinking ?? discovered.default_thinking,\n\t\ttool_call_parser:\n\t\t\tconfigured.tool_call_parser ??\n\t\t\tconfigured.toolCallParser ??\n\t\t\tdiscovered.tool_call_parser ??\n\t\t\tdiscovered.toolCallParser,\n\t};\n}\n\nfunction mergeProviderModels(configured: HamrModelConfig[], discovered: HamrModelConfig[]): HamrModelConfig[] {\n\tif (configured.length === 0) return discovered;\n\tif (discovered.length === 0) return configured;\n\n\tconst discoveredById = new Map(discovered.map((model) => [model.id.toLowerCase(), model]));\n\tconst configuredIds = new Set(configured.map((model) => model.id.toLowerCase()));\n\treturn [\n\t\t...configured.map((model) => {\n\t\t\tconst discoveredModel = discoveredById.get(model.id.toLowerCase());\n\t\t\treturn discoveredModel ? mergeDiscoveredModel(model, discoveredModel) : model;\n\t\t}),\n\t\t...discovered.filter((model) => !configuredIds.has(model.id.toLowerCase())),\n\t];\n}\n\n/**\n * Resolve the model list for a provider. Explicit config models define local\n * intent, but OpenAI-compatible providers are still probed so live endpoint\n * facts (especially context length) can override stale or incomplete config.\n */\nasync function resolveProviderModels(providerId: string, provider: HamrProviderConfig): Promise<HamrModelConfig[]> {\n\tconst configured = provider.models ?? [];\n\tconst compatibility = provider.compatibility ?? \"openai-compatible\";\n\tif (compatibility !== \"openai-compatible\") return configured;\n\tconst baseUrl = providerId === \"relay\" ? resolveRelayBaseUrl(provider) : providerBaseUrl(provider);\n\tif (!baseUrl) return configured;\n\tconst discovered = await discoverRelayModels(baseUrl, resolveProviderApiKey(provider), providerHeaders(provider));\n\treturn mergeProviderModels(configured, discovered);\n}\n\nfunction detectThinkingFormat(modelId: string): string | undefined {\n\tconst lower = modelId.toLowerCase();\n\tif (/deepseek-?r1/.test(lower)) return \"deepseek\";\n\tif (/\\bqwen3\\b/.test(lower) || /\\bqwen3[.-]/.test(lower)) return \"qwen\";\n\treturn undefined;\n}\n\nfunction modelToProviderModel(\n\tmodel: HamrModelConfig,\n\tprovider: HamrProviderConfig,\n): NonNullable<ProviderConfig[\"models\"]>[number] {\n\tconst thinking = model.supports_thinking ?? model.supportsThinking ?? false;\n\tconst supportsVision = model.supports_vision ?? model.supportsVision ?? true;\n\tconst contextWindow = modelContextWindow(model) ?? 0;\n\tconst compatibility = provider.compatibility ?? \"openai-compatible\";\n\tconst thinkingFormat = detectThinkingFormat(model.id);\n\t// Derive thinkingLevelMap from the actual levels advertised by the relay.\n\t//\n\t// Semantics of thinkingLevelMap (see packages/ai/src/types.ts): a *missing*\n\t// key means the level is supported and uses the provider default; an explicit\n\t// `null` marks the level as unsupported. So we translate the relay's flat list\n\t// of supported levels into \"leave advertised levels missing, null out the rest\"\n\t// rather than the other way around.\n\tconst CANONICAL_LEVELS = [\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\"] as const;\n\tconst rawLevels = model.thinking_levels ?? (thinking ? [\"off\", \"on\"] : []);\n\t// Relay vocabulary uses \"on\" (no \"minimal\"); pi uses \"minimal\" (no \"on\").\n\t// \"off\" is always offered when thinking is supported, and a bare \"on\"\n\t// (supports_thinking with no explicit levels) is treated as max thinking.\n\tconst advertised = new Set<string>(thinking ? [\"off\"] : []);\n\tfor (const level of rawLevels) {\n\t\tadvertised.add(level === \"on\" ? \"high\" : level);\n\t}\n\tconst thinkingLevelMap: Record<string, string | null> = {};\n\tfor (const level of CANONICAL_LEVELS) {\n\t\tif (!advertised.has(level)) {\n\t\t\tthinkingLevelMap[level] = null; // unsupported\n\t\t} else if (level === \"xhigh\") {\n\t\t\t// xhigh is excluded unless it maps to a defined value.\n\t\t\tthinkingLevelMap.xhigh = \"xhigh\";\n\t\t}\n\t\t// Advertised non-xhigh levels are left missing → supported, provider default.\n\t}\n\treturn {\n\t\tid: model.id,\n\t\tname: model.display_name ?? model.displayName ?? model.id,\n\t\treasoning: thinking,\n\t\tthinkingLevelMap,\n\t\tinput: supportsVision ? [\"text\", \"image\"] : [\"text\"],\n\t\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },\n\t\tcontextWindow,\n\t\tmaxTokens: modelMaxOutputTokens(model) ?? (contextWindow > 0 ? Math.min(16384, contextWindow) : 16384),\n\t\tcompat:\n\t\t\tcompatibility === \"openai-compatible\"\n\t\t\t\t? {\n\t\t\t\t\t\tsupportsDeveloperRole: false,\n\t\t\t\t\t\tsupportsUsageInStreaming: false,\n\t\t\t\t\t\tsupportsStrictMode: false,\n\t\t\t\t\t\tmaxTokensField: \"max_tokens\",\n\t\t\t\t\t\t...(thinkingFormat !== undefined ? { thinkingFormat } : {}),\n\t\t\t\t\t}\n\t\t\t\t: undefined,\n\t};\n}\n\n/**\n * Whether the given provider id should be treated as a cloud provider.\n *\n * Configured providers (relay, local LM endpoints) are local by convention and\n * default to non-cloud unless they set `cloud: true`. Providers that are not in\n * the hamr config at all are the built-in cloud providers (anthropic, openai,\n * …), so they are treated as cloud. Used to gate parallel subagent dispatch.\n */\nexport function isCloudProvider(config: HamrStartupConfig, providerId: string): boolean {\n\tconst provider = config.providers[providerId];\n\tif (!provider) return true;\n\treturn provider.cloud === true;\n}\n\nexport async function buildHamrProviderRegistrations(config: HamrStartupConfig): Promise<HamrProviderRegistration[]> {\n\tconst registrations: HamrProviderRegistration[] = [];\n\tfor (const [providerId, provider] of Object.entries(config.providers)) {\n\t\tif (provider.enabled === false) continue;\n\t\tconst compatibility = provider.compatibility ?? \"openai-compatible\";\n\t\t// The relay's base URL falls back to the env override / default; other\n\t\t// providers must declare one explicitly.\n\t\tconst resolvedBaseUrl = providerId === \"relay\" ? resolveRelayBaseUrl(provider) : providerBaseUrl(provider);\n\t\tconst baseUrl = expandEnv(resolvedBaseUrl);\n\t\tif (!baseUrl) continue;\n\t\tconst models = await resolveProviderModels(providerId, provider);\n\t\tif (models.length === 0) continue;\n\n\t\t// Per-model tool-call parser: explicit config override wins, otherwise\n\t\t// auto-detect from the model id (same conservative matching synax uses).\n\t\t// This is baked into the registration so the model picks up the right\n\t\t// local-model parser the moment it is discovered.\n\t\tconst parserByModel = new Map<string, string>();\n\t\tfor (const model of models) {\n\t\t\tconst explicit =\n\t\t\t\tmodel.tool_call_parser ?? model.toolCallParser ?? provider.tool_call_parser ?? provider.toolCallParser;\n\t\t\tconst parser = explicit ?? detectParserId(model.id);\n\t\t\tif (parser) parserByModel.set(model.id, parser);\n\t\t}\n\n\t\tregistrations.push({\n\t\t\tname: providerId,\n\t\t\tparserByModel,\n\t\t\tconfig: {\n\t\t\t\tname: provider.name ?? providerId,\n\t\t\t\tbaseUrl,\n\t\t\t\tapi: compatibility === \"anthropic-compatible\" ? \"anthropic-messages\" : \"openai-completions\",\n\t\t\t\tapiKey:\n\t\t\t\t\tprovider.api_key ??\n\t\t\t\t\tprovider.apiKey ??\n\t\t\t\t\tenvReference(provider.api_key_env ?? provider.apiKeyEnv) ??\n\t\t\t\t\tLOCAL_API_KEY,\n\t\t\t\tauthHeader: false,\n\t\t\t\theaders: providerHeaders(provider),\n\t\t\t\tmodels: models.map((model) => modelToProviderModel(model, provider)),\n\t\t\t},\n\t\t});\n\t}\n\treturn registrations;\n}\n\nexport function getHamrDefaultModel(\n\tconfig: HamrStartupConfig,\n\tmodelRegistry: ModelRegistry,\n): { model: Model<any>; thinkingLevel?: ThinkingLevel } | undefined {\n\tconst provider = config.active?.provider ?? \"relay\";\n\tconst modelId = config.active?.model;\n\tconst model = modelId\n\t\t? modelRegistry.find(provider, modelId)\n\t\t: modelRegistry.getAll().find((candidate) => candidate.provider === provider);\n\tif (!model || !modelRegistry.hasConfiguredAuth(model)) return undefined;\n\treturn { model, thinkingLevel: normalizeThinking(config.active?.thinking) };\n}\n"]}

package/dist/hamr/store/sqlite-loader.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Lazy loader for better-sqlite3 — a native C++ addon.
+ *
+ * better-sqlite3 ships prebuilds for common platforms (macOS, Linux, Windows
+ * on x64/arm64). On unusual platforms it falls back to node-gyp compilation.
+ *
+ * If compilation fails or better-sqlite3 is unavailable, Hamr continues
+ * without SQLite persistence (memory, event store, FTS5 are no-ops).
+ *
+ * Uses a synchronous dynamic require() inside try/catch so that the
+ * rest of the module graph loads fine regardless.
+ */
+import type Database from "better-sqlite3";
+/**
+ * Synchronously load better-sqlite3.
+ *
+ * Uses a cached dynamic require() — tried exactly once per process.
+ * Returns the Database constructor on success, null on failure.
+ */
+export declare function loadBetterSqlite3(): typeof Database | null;
+/**
+ * Re-export the Database type for use in type annotations.
+ * This is a type-only re-export — it doesn't trigger a runtime import.
+ */
+export type { Database };
+//# sourceMappingURL=sqlite-loader.d.ts.map

package/dist/hamr/store/sqlite-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-loader.d.ts","sourceRoot":"","sources":["../../../src/hamr/store/sqlite-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,QAAQ,GAAG,IAAI,CAY1D;AAED;;;GAGG;AACH,YAAY,EAAE,QAAQ,EAAE,CAAC"}