@ikarmic/forge-core 4.5.0 → 5.1.0

package/dist/custom-providers.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Named providers beyond the built-in eleven: a table of well-known OpenAI-compatible services plus whatever the
+ * user defines under `customProviders` in `~/.forge/config.json`. A model on one of them is written `id:model`
+ * (e.g. `groq:llama-3.3-70b-versatile`) and resolves to an endpoint (base URL, key, headers) that
+ * `createLanguageModel` calls with the OpenAI chat or Anthropic message style. Pure; nothing here reads files.
+ */
+export type EndpointApi = 'openai-compatible' | 'anthropic';
+export interface CustomModelConfig {
+    /** The id sent to the API when the key used in Forge differs from it. */
+    id?: string;
+    name?: string;
+    limit?: {
+        context?: number;
+        output?: number;
+    };
+    cost?: {
+        input?: number;
+        output?: number;
+    };
+    toolCall?: boolean;
+    reasoning?: boolean;
+    modalities?: {
+        input: string[];
+        output: string[];
+    };
+}
+export interface CustomProviderConfig {
+    name?: string;
+    baseUrl?: string;
+    /** Stored as plain text in the config file; prefer `apiKeyEnv`. */
+    apiKey?: string;
+    /** Name of the environment variable that holds the key. */
+    apiKeyEnv?: string;
+    headers?: Record<string, string>;
+    api?: EndpointApi;
+    /** Give up on a request that has not answered after this many milliseconds. */
+    timeoutMs?: number;
+    /** Abort a streamed answer that stays silent this long. */
+    chunkTimeoutMs?: number;
+    models?: Record<string, CustomModelConfig>;
+    whitelist?: string[];
+    blacklist?: string[];
+}
+/** Where a call goes: the resolved form of a provider, carried on `ModelConfig.endpoint`. */
+export interface ProviderEndpoint {
+    id: string;
+    name: string;
+    baseUrl: string;
+    apiKey?: string;
+    headers?: Record<string, string>;
+    api: EndpointApi;
+    timeoutMs?: number;
+    chunkTimeoutMs?: number;
+}
+export interface ProviderPreset {
+    name: string;
+    baseUrl: string;
+    apiKeyEnv: string;
+    api?: EndpointApi;
+}
+/** Defaults for services that speak the OpenAI chat protocol. Any field can be overridden under `customProviders`. */
+export declare const PROVIDER_PRESETS: Readonly<Record<string, ProviderPreset>>;
+/** Why an entry of `customProviders` cannot be used, one problem per bad entry. A preset id may omit its URL. */
+export declare function customProviderProblems(custom: Record<string, CustomProviderConfig> | undefined): Array<{
+    id: string;
+    message: string;
+}>;
+/**
+ * The `customProviders` of the running host, so every place that turns a model name into a model (aliases,
+ * the cheap model, sub-agents, the picker) sees them without each call site passing the config along.
+ * Hosts register at the start of every run; tests reset with `undefined`.
+ */
+export declare function registerCustomProviders(custom: Record<string, CustomProviderConfig> | undefined): void;
+export declare function registeredCustomProviders(): Record<string, CustomProviderConfig> | undefined;
+export interface ModelFilter {
+    whitelist?: string[];
+    blacklist?: string[];
+}
+/** `modelFilters` of the running host (per provider id), read by the model pickers. */
+export declare function registerModelFilters(filters: Record<string, ModelFilter> | undefined): void;
+/** The filter for a provider id: the registered `modelFilters` entry, else the whitelist/blacklist on its custom provider. */
+export declare function modelFilterFor(providerId: string): ModelFilter | undefined;
+/** Preset ids and custom ids, once each; a built-in id never appears. */
+export declare function knownProviderIds(custom: Record<string, CustomProviderConfig> | undefined): string[];
+/** The endpoint for a provider id, or undefined when the id is built-in, unknown, or has no usable URL. */
+export declare function resolveProviderEndpoint(id: string, custom: Record<string, CustomProviderConfig> | undefined, env?: NodeJS.ProcessEnv): ProviderEndpoint | undefined;
+/** The id the API expects for a model key (`models.<key>.id`), or the key itself. */
+export declare function apiModelId(providerId: string, modelKey: string, custom: Record<string, CustomProviderConfig> | undefined): string;
+/** Apply a provider's `whitelist` (only these) then `blacklist` (not these) to a model list. */
+export declare function filterModels<T extends {
+    id: string;
+}>(entries: readonly T[], filter: {
+    whitelist?: string[];
+    blacklist?: string[];
+} | undefined): T[];

package/dist/custom-providers.js

@@ -0,0 +1,120 @@
+/**
+ * Named providers beyond the built-in eleven: a table of well-known OpenAI-compatible services plus whatever the
+ * user defines under `customProviders` in `~/.forge/config.json`. A model on one of them is written `id:model`
+ * (e.g. `groq:llama-3.3-70b-versatile`) and resolves to an endpoint (base URL, key, headers) that
+ * `createLanguageModel` calls with the OpenAI chat or Anthropic message style. Pure; nothing here reads files.
+ */
+/** Defaults for services that speak the OpenAI chat protocol. Any field can be overridden under `customProviders`. */
+export const PROVIDER_PRESETS = {
+    groq: { name: 'Groq', baseUrl: 'https://api.groq.com/openai/v1', apiKeyEnv: 'GROQ_API_KEY' },
+    deepseek: { name: 'DeepSeek', baseUrl: 'https://api.deepseek.com/v1', apiKeyEnv: 'DEEPSEEK_API_KEY' },
+    mistral: { name: 'Mistral', baseUrl: 'https://api.mistral.ai/v1', apiKeyEnv: 'MISTRAL_API_KEY' },
+    xai: { name: 'xAI', baseUrl: 'https://api.x.ai/v1', apiKeyEnv: 'XAI_API_KEY' },
+    cerebras: { name: 'Cerebras', baseUrl: 'https://api.cerebras.ai/v1', apiKeyEnv: 'CEREBRAS_API_KEY' },
+    fireworks: { name: 'Fireworks', baseUrl: 'https://api.fireworks.ai/inference/v1', apiKeyEnv: 'FIREWORKS_API_KEY' },
+    together: { name: 'Together AI', baseUrl: 'https://api.together.xyz/v1', apiKeyEnv: 'TOGETHER_API_KEY' },
+    moonshot: { name: 'Moonshot', baseUrl: 'https://api.moonshot.ai/v1', apiKeyEnv: 'MOONSHOT_API_KEY' },
+    nebius: { name: 'Nebius', baseUrl: 'https://api.studio.nebius.com/v1', apiKeyEnv: 'NEBIUS_API_KEY' },
+    vercel: { name: 'Vercel AI Gateway', baseUrl: 'https://ai-gateway.vercel.sh/v1', apiKeyEnv: 'AI_GATEWAY_API_KEY' },
+    perplexity: { name: 'Perplexity', baseUrl: 'https://api.perplexity.ai', apiKeyEnv: 'PERPLEXITY_API_KEY' },
+    deepinfra: { name: 'DeepInfra', baseUrl: 'https://api.deepinfra.com/v1/openai', apiKeyEnv: 'DEEPINFRA_API_KEY' },
+    sambanova: { name: 'SambaNova', baseUrl: 'https://api.sambanova.ai/v1', apiKeyEnv: 'SAMBANOVA_API_KEY' },
+    hyperbolic: { name: 'Hyperbolic', baseUrl: 'https://api.hyperbolic.xyz/v1', apiKeyEnv: 'HYPERBOLIC_API_KEY' },
+    huggingface: { name: 'Hugging Face', baseUrl: 'https://router.huggingface.co/v1', apiKeyEnv: 'HF_TOKEN' },
+    alibaba: { name: 'Alibaba Qwen', baseUrl: 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1', apiKeyEnv: 'DASHSCOPE_API_KEY' },
+    venice: { name: 'Venice', baseUrl: 'https://api.venice.ai/api/v1', apiKeyEnv: 'VENICE_API_KEY' },
+    requesty: { name: 'Requesty', baseUrl: 'https://router.requesty.ai/v1', apiKeyEnv: 'REQUESTY_API_KEY' },
+    poolside: { name: 'Poolside', baseUrl: 'https://inference.poolside.ai/v1', apiKeyEnv: 'POOLSIDE_API_KEY' },
+    zenmux: { name: 'ZenMux', baseUrl: 'https://zenmux.ai/api/v1', apiKeyEnv: 'ZENMUX_API_KEY' },
+};
+const BUILTIN_IDS = new Set(['openai', 'anthropic', 'google', 'ollama', 'openrouter', 'minimax', 'bedrock', 'vertex', 'azure', 'lmstudio', 'openai-compatible', 'auto']);
+const ID = /^[a-z0-9][a-z0-9_-]*$/;
+const trimSlash = (url) => url.replace(/\/+$/, '');
+const positive = (n) => typeof n === 'number' && Number.isFinite(n) && n > 0;
+/** Why an entry of `customProviders` cannot be used, one problem per bad entry. A preset id may omit its URL. */
+export function customProviderProblems(custom) {
+    const out = [];
+    for (const [id, c] of Object.entries(custom ?? {})) {
+        if (BUILTIN_IDS.has(id))
+            out.push({ id, message: `"${id}" is a built-in provider name; pick another id.` });
+        else if (!ID.test(id))
+            out.push({ id, message: `"${id}" is not a valid id: use lowercase letters, digits, - and _.` });
+        else if (!c || typeof c !== 'object')
+            out.push({ id, message: `"${id}" must be an object.` });
+        else {
+            const url = c.baseUrl ?? PROVIDER_PRESETS[id]?.baseUrl;
+            if (!url)
+                out.push({ id, message: `"${id}" needs a baseUrl.` });
+            else if (!/^https?:\/\//i.test(url))
+                out.push({ id, message: `"${id}" baseUrl must start with http:// or https://.` });
+            else if (c.timeoutMs !== undefined && !positive(c.timeoutMs))
+                out.push({ id, message: `"${id}" timeoutMs must be a positive number.` });
+            else if (c.chunkTimeoutMs !== undefined && !positive(c.chunkTimeoutMs))
+                out.push({ id, message: `"${id}" chunkTimeoutMs must be a positive number.` });
+        }
+    }
+    return out;
+}
+let registered;
+/**
+ * The `customProviders` of the running host, so every place that turns a model name into a model (aliases,
+ * the cheap model, sub-agents, the picker) sees them without each call site passing the config along.
+ * Hosts register at the start of every run; tests reset with `undefined`.
+ */
+export function registerCustomProviders(custom) {
+    registered = custom;
+}
+export function registeredCustomProviders() {
+    return registered;
+}
+let registeredFilters;
+/** `modelFilters` of the running host (per provider id), read by the model pickers. */
+export function registerModelFilters(filters) {
+    registeredFilters = filters;
+}
+/** The filter for a provider id: the registered `modelFilters` entry, else the whitelist/blacklist on its custom provider. */
+export function modelFilterFor(providerId) {
+    return registeredFilters?.[providerId] ?? (registered?.[providerId]?.whitelist || registered?.[providerId]?.blacklist
+        ? { ...(registered[providerId].whitelist ? { whitelist: registered[providerId].whitelist } : {}), ...(registered[providerId].blacklist ? { blacklist: registered[providerId].blacklist } : {}) }
+        : undefined);
+}
+/** Preset ids and custom ids, once each; a built-in id never appears. */
+export function knownProviderIds(custom) {
+    const ids = new Set(Object.keys(PROVIDER_PRESETS));
+    for (const id of Object.keys(custom ?? {}))
+        if (!BUILTIN_IDS.has(id))
+            ids.add(id);
+    return [...ids];
+}
+/** The endpoint for a provider id, or undefined when the id is built-in, unknown, or has no usable URL. */
+export function resolveProviderEndpoint(id, custom, env = process.env) {
+    if (BUILTIN_IDS.has(id))
+        return undefined;
+    const preset = PROVIDER_PRESETS[id];
+    const c = custom?.[id];
+    const baseUrl = c?.baseUrl ?? preset?.baseUrl;
+    if (!baseUrl || (!c && !preset))
+        return undefined;
+    const keyEnv = c?.apiKeyEnv ?? preset?.apiKeyEnv;
+    const apiKey = c?.apiKey ?? (keyEnv ? env[keyEnv] : undefined);
+    return {
+        id,
+        name: c?.name ?? preset?.name ?? id,
+        baseUrl: trimSlash(baseUrl),
+        ...(apiKey ? { apiKey } : {}),
+        ...(c?.headers ? { headers: c.headers } : {}),
+        api: c?.api ?? preset?.api ?? 'openai-compatible',
+        ...(c?.timeoutMs ? { timeoutMs: c.timeoutMs } : {}),
+        ...(c?.chunkTimeoutMs ? { chunkTimeoutMs: c.chunkTimeoutMs } : {}),
+    };
+}
+/** The id the API expects for a model key (`models.<key>.id`), or the key itself. */
+export function apiModelId(providerId, modelKey, custom) {
+    return custom?.[providerId]?.models?.[modelKey]?.id ?? modelKey;
+}
+/** Apply a provider's `whitelist` (only these) then `blacklist` (not these) to a model list. */
+export function filterModels(entries, filter) {
+    const allow = filter?.whitelist?.length ? new Set(filter.whitelist) : undefined;
+    const block = filter?.blacklist?.length ? new Set(filter.blacklist) : undefined;
+    return entries.filter((e) => (!allow || allow.has(e.id)) && (!block || !block.has(e.id)));
+}

package/dist/diff/index.d.ts

@@ -5,4 +5,3 @@
  * extension's pending-changes review UI. No I/O, no platform deps.
  */
 export { computeUnifiedDiff, computeDiffSummary, type DiffOptions, type DiffResult, type DiffSummary, } from './unified-diff.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/diff/index.js

@@ -5,4 +5,3 @@
  * extension's pending-changes review UI. No I/O, no platform deps.
  */
 export { computeUnifiedDiff, computeDiffSummary, } from './unified-diff.js';
-//# sourceMappingURL=index.js.map

package/dist/diff/unified-diff.d.ts

@@ -69,4 +69,3 @@ export interface DiffSummary {
     summary: string;
 }
 export declare function computeDiffSummary(before: string, after: string, options?: DiffOptions): DiffSummary;
-//# sourceMappingURL=unified-diff.d.ts.map

package/dist/diff/unified-diff.js

@@ -381,4 +381,3 @@ function formatFullDelete(oldLines, oldLabel, newLabel, filePath) {
     void filePath;
     return header + hunk + body;
 }
-//# sourceMappingURL=unified-diff.js.map

package/dist/git/auto-commit.d.ts

@@ -27,11 +27,11 @@ export declare function commitDirty(cwd: string, options?: GitCommitOptions): Pr
 export declare function diffForFiles(cwd: string, files: string[]): Promise<string>;
 /** Deterministic message used when no model is available or it fails. */
 export declare function fallbackCommitMessage(files: string[]): string;
-export declare function commitMessagePrompt(diff: string, task?: string): string;
-/** Strip fences/quotes a model may wrap around the message. */
+export declare function commitMessagePrompt(diff: string, task?: string, instruction?: string): string;
+/** Strip an inline `<think>` block (MiniMax and other reasoning models) and the fences/quotes a model may wrap around the message. */
 export declare function cleanCommitMessage(text: string): string;
 /** Draft a commit message with `model` (typically the cheap model); never throws. */
-export declare function generateCommitMessage(diff: string, files: string[], model: ModelConfig | undefined, task?: string, modelFactory?: (cfg: ModelConfig) => LanguageModel): Promise<string>;
+export declare function generateCommitMessage(diff: string, files: string[], model: ModelConfig | undefined, task?: string, modelFactory?: (cfg: ModelConfig) => LanguageModel, instruction?: string): Promise<string>;
 export type UndoResult = {
     ok: true;
     commit: string;
@@ -61,4 +61,3 @@ export declare function afterRun(cwd: string, state: {
     task?: string;
     modelFactory?: (cfg: ModelConfig) => LanguageModel;
 }): Promise<ForgeCommit | null>;
-//# sourceMappingURL=auto-commit.d.ts.map

package/dist/git/auto-commit.js

@@ -6,6 +6,7 @@
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
 import { generateText } from 'ai';
+import { stripThinkTags } from '../agent/think-tags.js';
 import { createLanguageModel } from '../providers.js';
 const execFileAsync = promisify(execFile);
 async function git(cwd, args) {
@@ -111,24 +112,25 @@ export function fallbackCommitMessage(files) {
     return `forge: update ${shown}${more}`;
 }
 const MAX_DIFF_CHARS = 12_000;
-export function commitMessagePrompt(diff, task) {
+export function commitMessagePrompt(diff, task, instruction) {
     const clipped = diff.length > MAX_DIFF_CHARS ? `${diff.slice(0, MAX_DIFF_CHARS)}\n[diff truncated]` : diff;
-    return `Write a git commit message for this diff in conventional-commit style (type(scope): subject, imperative mood, under 72 characters). Add a short body only if the change needs explaining. Reply with the message only, no quotes or code fences.${task ? `\n\nThe change was made for this request: ${task}` : ''}\n\n${clipped}`;
+    const lead = instruction?.trim() || 'Write a git commit message for this diff in conventional-commit style (type(scope): subject, imperative mood, under 72 characters). Add a short body only if the change needs explaining. Reply with the message only, no quotes or code fences.';
+    return `${lead}${task ? `\n\nThe change was made for this request: ${task}` : ''}\n\n${clipped}`;
 }
-/** Strip fences/quotes a model may wrap around the message. */
+/** Strip an inline `<think>` block (MiniMax and other reasoning models) and the fences/quotes a model may wrap around the message. */
 export function cleanCommitMessage(text) {
-    return text
+    return stripThinkTags(text)
         .replace(/^```[a-z]*\n?|\n?```$/gi, '')
         .trim()
         .replace(/^["'`]+|["'`]+$/g, '')
         .trim();
 }
 /** Draft a commit message with `model` (typically the cheap model); never throws. */
-export async function generateCommitMessage(diff, files, model, task, modelFactory = createLanguageModel) {
+export async function generateCommitMessage(diff, files, model, task, modelFactory = createLanguageModel, instruction) {
     if (!model || !diff.trim())
         return fallbackCommitMessage(files);
     try {
-        const result = await generateText({ model: modelFactory(model), prompt: commitMessagePrompt(diff, task) });
+        const result = await generateText({ model: modelFactory(model), prompt: commitMessagePrompt(diff, task, instruction) });
         const message = cleanCommitMessage(result.text);
         return message || fallbackCommitMessage(files);
     }
@@ -182,4 +184,3 @@ export async function afterRun(cwd, state, options) {
     const message = await generateCommitMessage(diff, files, options.model, options.task, options.modelFactory);
     return commitFiles(cwd, files, message, options);
 }
-//# sourceMappingURL=auto-commit.js.map

package/dist/git/index.d.ts

@@ -1,3 +1,2 @@
 export { FORGE_TRAILER, afterRun, beforeRun, changedFiles, cleanCommitMessage, commitDirty, commitFiles, commitMessagePrompt, diffForFiles, fallbackCommitMessage, generateCommitMessage, isGitRepo, undoLastForgeCommit, } from './auto-commit.js';
 export type { ForgeCommit, GitCommitOptions, UndoResult } from './auto-commit.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/git/index.js

@@ -1,2 +1 @@
 export { FORGE_TRAILER, afterRun, beforeRun, changedFiles, cleanCommitMessage, commitDirty, commitFiles, commitMessagePrompt, diffForFiles, fallbackCommitMessage, generateCommitMessage, isGitRepo, undoLastForgeCommit, } from './auto-commit.js';
-//# sourceMappingURL=index.js.map

package/dist/github/github-tools.d.ts

@@ -62,14 +62,14 @@ declare const createParams: z.ZodObject<{
     head: z.ZodOptional<z.ZodString>;
     draft: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    title: string;
     body: string;
+    title: string;
     draft?: boolean | undefined;
     base?: string | undefined;
     head?: string | undefined;
 }, {
-    title: string;
     body: string;
+    title: string;
     draft?: boolean | undefined;
     base?: string | undefined;
     head?: string | undefined;
@@ -81,4 +81,3 @@ export declare function createGitHubCreateTool(cfg: GitHubConfig): ToolDefinitio
 }>;
 export declare function createGitHubTools(cfg: GitHubConfig): ToolDefinition[];
 export {};
-//# sourceMappingURL=github-tools.d.ts.map

package/dist/github/github-tools.js

@@ -173,4 +173,3 @@ export function createGitHubCreateTool(cfg) {
 export function createGitHubTools(cfg) {
     return [createGitHubReadTool(cfg), createGitHubCreateTool(cfg)];
 }
-//# sourceMappingURL=github-tools.js.map

package/dist/hooks/agent-runner.d.ts

@@ -14,4 +14,3 @@ export interface AgentHookRunnerOptions {
     maxIterations?: number;
 }
 export declare function createAgentHookRunner(options: AgentHookRunnerOptions): AgentHookRunner;
-//# sourceMappingURL=agent-runner.d.ts.map

package/dist/hooks/agent-runner.js

@@ -42,4 +42,3 @@ export function createAgentHookRunner(options) {
         }
     };
 }
-//# sourceMappingURL=agent-runner.js.map

package/dist/hooks/bus.d.ts

@@ -93,4 +93,3 @@ export declare class HooksBus {
     /** Filter matcher entries down to those that apply to this event. */
     private filterByMatcher;
 }
-//# sourceMappingURL=bus.d.ts.map

package/dist/hooks/bus.js

@@ -157,4 +157,3 @@ function expandPrompt(prompt, event) {
     };
     return prompt.replace(/\{\{(\w+)\}\}/g, (_m, key) => values[key] ?? '');
 }
-//# sourceMappingURL=bus.js.map

package/dist/hooks/config.d.ts

@@ -111,4 +111,3 @@ export declare function validateToolSandboxConfig(raw: unknown): string[];
  * matches everything.
  */
 export declare function matcherMatches(matcher: string, toolName: string): boolean;
-//# sourceMappingURL=config.d.ts.map

package/dist/hooks/config.js

@@ -187,4 +187,3 @@ export function matcherMatches(matcher, toolName) {
     }
     return false;
 }
-//# sourceMappingURL=config.js.map

package/dist/hooks/events.d.ts

@@ -87,4 +87,3 @@ export declare function eventToolName(event: HookEvent): string | undefined;
  * glob" for this one event. Returns undefined for every other event.
  */
 export declare function eventFilePath(event: HookEvent): string | undefined;
-//# sourceMappingURL=events.d.ts.map

package/dist/hooks/events.js

@@ -42,4 +42,3 @@ export function eventFilePath(event) {
         return event.path;
     return undefined;
 }
-//# sourceMappingURL=events.js.map

package/dist/hooks/index.d.ts

@@ -18,4 +18,3 @@ export { AGENT_HOOK_TOOLS, createAgentHookRunner, type AgentHookRunnerOptions }
 export { shouldIgnoreWatchPath } from './watch-ignore.js';
 export { FileChangeCoalescer, type FileChangeType } from './watch-coalescer.js';
 export { watchFilesystem } from './watcher.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.js

@@ -13,4 +13,3 @@ export { AGENT_HOOK_TOOLS, createAgentHookRunner } from './agent-runner.js';
 export { shouldIgnoreWatchPath } from './watch-ignore.js';
 export { FileChangeCoalescer } from './watch-coalescer.js';
 export { watchFilesystem } from './watcher.js';
-//# sourceMappingURL=index.js.map

package/dist/hooks/loader.d.ts

@@ -50,4 +50,3 @@ export declare function readSettings(filePath: string): Promise<{
  * tolerated; the loader returns an empty config instead of throwing.
  */
 export declare function loadHooksConfig(cwd: string): Promise<LoadHooksResult>;
-//# sourceMappingURL=loader.d.ts.map

package/dist/hooks/loader.js

@@ -138,4 +138,3 @@ export async function loadHooksConfig(cwd) {
         sources,
     };
 }
-//# sourceMappingURL=loader.js.map

package/dist/hooks/runner.d.ts

@@ -40,4 +40,3 @@ export declare function eventToEnv(event: HookEvent): Record<string, string>;
  * log, or swallow.
  */
 export declare function runHook(event: HookEvent, config: ShellHookConfig): Promise<HookRunResult>;
-//# sourceMappingURL=runner.d.ts.map

package/dist/hooks/runner.js

@@ -15,6 +15,7 @@
 import { spawn } from 'node:child_process';
 import { execFileSync } from 'node:child_process';
 import { redact } from '../tools/redact.js';
+import { shellEnv } from '../tools/shell-env.js';
 /** Compute the env-var map for an event. */
 export function eventToEnv(event) {
     const env = {
@@ -98,11 +99,11 @@ export function runHook(event, config) {
             proc = spawn(config.command, [], {
                 shell: true,
                 detached: process.platform !== 'win32',
-                env: {
+                env: shellEnv({
                     ...process.env,
                     ...(config.env ?? {}),
                     ...eventToEnv(event),
-                },
+                }),
                 stdio: ['ignore', 'pipe', 'pipe'],
                 windowsHide: true,
             });
@@ -182,4 +183,3 @@ export function runHook(event, config) {
         });
     });
 }
-//# sourceMappingURL=runner.js.map

package/dist/hooks/watch-coalescer.d.ts

@@ -20,4 +20,3 @@ export declare class FileChangeCoalescer {
     /** Cancel every pending timer without dispatching. Call on watcher shutdown. */
     dispose(): void;
 }
-//# sourceMappingURL=watch-coalescer.d.ts.map

package/dist/hooks/watch-coalescer.js

@@ -24,4 +24,3 @@ export class FileChangeCoalescer {
         this.timers.clear();
     }
 }
-//# sourceMappingURL=watch-coalescer.js.map

package/dist/hooks/watch-ignore.d.ts

@@ -6,4 +6,3 @@
  * in v1: same as checkpoint capture's own ignore list.
  */
 export declare function shouldIgnoreWatchPath(relPath: string): boolean;
-//# sourceMappingURL=watch-ignore.d.ts.map

package/dist/hooks/watch-ignore.js

@@ -9,4 +9,3 @@ export function shouldIgnoreWatchPath(relPath) {
     const segments = relPath.split(/[\\/]/);
     return segments.some((seg) => seg === 'node_modules' || seg.startsWith('.'));
 }
-//# sourceMappingURL=watch-ignore.js.map

package/dist/hooks/watcher.d.ts

@@ -35,4 +35,3 @@ import type { FileChangeType } from './watch-coalescer.js';
 export declare function watchFilesystem(cwd: string, onChange: (relPath: string, changeType: FileChangeType) => void): {
     close(): Promise<void>;
 };
-//# sourceMappingURL=watcher.d.ts.map

package/dist/hooks/watcher.js

@@ -61,4 +61,3 @@ export function watchFilesystem(cwd, onChange) {
         },
     };
 }
-//# sourceMappingURL=watcher.js.map

package/dist/import/claude-code.d.ts

@@ -0,0 +1,39 @@
+import type { McpServerSpec } from '../mcp/mcp-config.js';
+export type ImportScope = 'user' | 'project';
+export interface ClaudeImportPlan {
+    mcp: Array<{
+        name: string;
+        spec: McpServerSpec;
+        scope: ImportScope;
+        from: string;
+    }>;
+    /** Folders to add to `skillPaths` (`~/...` or relative to the workspace). */
+    skillPaths: string[];
+    agents: Array<{
+        name: string;
+        scope: ImportScope;
+        text: string;
+        from: string;
+    }>;
+    commands: Array<{
+        name: string;
+        scope: ImportScope;
+        text: string;
+        from: string;
+    }>;
+    notes: string[];
+}
+export interface ImportRoots {
+    home: string;
+    cwd: string;
+}
+export declare function planClaudeImport(roots: ImportRoots): Promise<ClaudeImportPlan>;
+export interface ApplyOptions extends ImportRoots {
+    /** Defaults to `<home>/.forge/config.json`. */
+    configPath?: string;
+}
+export interface ApplyResult {
+    written: string[];
+    skipped: string[];
+}
+export declare function applyClaudeImport(plan: ClaudeImportPlan, opts: ApplyOptions): Promise<ApplyResult>;