@ikarmic/forge-core 4.5.0 → 5.1.0

package/dist/import/claude-code.js

@@ -0,0 +1,254 @@
+/**
+ * Bring a Claude Code setup over to Forge: MCP servers, skill folders, sub-agents and slash commands.
+ * `planClaudeImport` only reads; `applyClaudeImport` writes into Forge's own locations and never replaces
+ * something that is already there. What Forge has no equivalent for (permissions, hooks) is listed in `notes`.
+ * A converted agent is never given more tools than the original: tools that map to nothing leave it read-only.
+ */
+import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { loadForgeConfigFile, saveForgeConfigFile } from '../config-file.js';
+import { parseFrontmatter } from '../skills/parser.js';
+const TOOL_MAP = {
+    Read: ['read_file'],
+    Grep: ['search_files'],
+    Glob: ['list_files'],
+    LS: ['list_files'],
+    Write: ['write_file'],
+    Edit: ['edit_file'],
+    MultiEdit: ['edit_file'],
+    NotebookEdit: ['edit_notebook'],
+    Bash: ['run_command'],
+    WebFetch: ['fetch_url'],
+    WebSearch: ['web_search'],
+    TodoWrite: ['todo_write', 'todo_read'],
+};
+const READ_ONLY_FALLBACK = ['read_file', 'list_files', 'search_files'];
+const COMMAND_NAME = /^[a-zA-Z][a-zA-Z0-9_-]*$/;
+/** A command body that runs a shell line (!`cmd`) or pulls in a file (@path.ext) in Claude Code. */
+const CLAUDE_INLINE = /(^|\s)!`|(^|\s)@\S+\.\w+/;
+const isObject = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
+async function readJson(file) {
+    try {
+        return JSON.parse(await readFile(file, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+async function isDir(dir) {
+    try {
+        await readdir(dir);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function mdFiles(dir) {
+    try {
+        return (await readdir(dir)).filter((n) => n.toLowerCase().endsWith('.md')).sort();
+    }
+    catch {
+        return [];
+    }
+}
+/** One Claude Code server entry as a Forge spec, or undefined when it has neither a command nor a URL. */
+function convertServer(raw) {
+    if (!isObject(raw))
+        return undefined;
+    const str = (v) => (typeof v === 'string' && v ? v : undefined);
+    const strList = (v) => (Array.isArray(v) ? v.filter((x) => typeof x === 'string') : undefined);
+    const strMap = (v) => isObject(v) ? Object.fromEntries(Object.entries(v).filter((e) => typeof e[1] === 'string')) : undefined;
+    const command = str(raw.command);
+    const url = str(raw.url);
+    if (!command && !url)
+        return undefined;
+    const type = raw.type === 'http' ? 'streamable-http' : raw.type === 'sse' ? 'sse' : raw.type === 'stdio' ? 'stdio' : undefined;
+    const args = strList(raw.args);
+    const env = strMap(raw.env);
+    const headers = strMap(raw.headers);
+    return {
+        ...(type ? { type } : {}),
+        ...(command ? { command } : {}),
+        ...(args ? { args } : {}),
+        ...(env && Object.keys(env).length ? { env } : {}),
+        ...(url ? { url } : {}),
+        ...(headers && Object.keys(headers).length ? { headers } : {}),
+    };
+}
+function collectServers(servers, scope, from, plan, seen) {
+    if (!isObject(servers))
+        return;
+    for (const [name, raw] of Object.entries(servers)) {
+        const key = `${scope}:${name}`;
+        if (seen.has(key))
+            continue;
+        const spec = convertServer(raw);
+        if (!spec) {
+            plan.notes.push(`${from}: MCP server "${name}" has no command or url; not imported`);
+            continue;
+        }
+        seen.add(key);
+        plan.mcp.push({ name, spec, scope, from });
+    }
+}
+const norm = (p) => p.replace(/\\/g, '/').replace(/\/$/, '').toLowerCase();
+function agentSlug(name) {
+    return name.toLowerCase().replace(/[^a-z0-9_-]+/g, '-').replace(/^[^a-z0-9]+|-+$/g, '').slice(0, 64);
+}
+function oneLine(s) {
+    return s.replace(/\\n/g, ' ').replace(/\s+/g, ' ').trim();
+}
+function convertAgent(file, text, notes) {
+    const { fields, body } = parseFrontmatter(text.replace(/\r\n/g, '\n'));
+    const label = path.basename(file);
+    const description = oneLine(fields.get('description') ?? '');
+    if (!description) {
+        notes.push(`${label}: no description; agent not imported`);
+        return undefined;
+    }
+    const name = agentSlug(fields.get('name') || label.replace(/\.md$/i, ''));
+    if (!name) {
+        notes.push(`${label}: no usable name; agent not imported`);
+        return undefined;
+    }
+    let tools;
+    const rawTools = fields.get('tools');
+    if (rawTools !== undefined && rawTools.trim()) {
+        const wanted = rawTools.split(',').map((s) => s.trim()).filter(Boolean);
+        const mapped = new Set();
+        for (const w of wanted) {
+            const base = w.replace(/\(.*$/, '');
+            if (base !== w)
+                notes.push(`${label}: "${w}" limited a tool by pattern in Claude Code; Forge permission rules decide that now`);
+            for (const t of TOOL_MAP[base] ?? [])
+                mapped.add(t);
+            if (!TOOL_MAP[base] && base !== 'Task')
+                notes.push(`${label}: tool "${base}" has no Forge equivalent; left out`);
+        }
+        tools = mapped.size > 0 ? [...mapped] : READ_ONLY_FALLBACK;
+        if (mapped.size === 0)
+            notes.push(`${label}: none of its tools map to Forge; imported as read-only`);
+    }
+    const front = ['---', `description: ${description}`, 'mode: subagent', ...(tools ? [`tools: ${tools.join(', ')}`] : []), '---'];
+    return { name, text: `${front.join('\n')}\n${body.trim()}\n` };
+}
+function convertCommand(file, text, notes) {
+    const label = path.basename(file);
+    const name = label.replace(/\.md$/i, '');
+    if (!COMMAND_NAME.test(name)) {
+        notes.push(`${label}: not a valid command name (letters, digits, - and _); not imported`);
+        return undefined;
+    }
+    const { fields, body } = parseFrontmatter(text.replace(/\r\n/g, '\n'));
+    const description = oneLine(fields.get('description') ?? '');
+    if (CLAUDE_INLINE.test(body))
+        notes.push(`${label}: runs a shell line or pulls in a file inside the prompt in Claude Code; Forge sends that text as it is`);
+    const head = description ? `---\ndescription: ${description}\n---\n` : '';
+    return { name, text: `${head}${body.replace(/\s+$/, '')}\n` };
+}
+export async function planClaudeImport(roots) {
+    const { home, cwd } = roots;
+    const plan = { mcp: [], skillPaths: [], agents: [], commands: [], notes: [] };
+    const seen = new Set();
+    const claudeJson = await readJson(path.join(home, '.claude.json'));
+    if (isObject(claudeJson)) {
+        collectServers(claudeJson.mcpServers, 'user', '~/.claude.json', plan, seen);
+        if (isObject(claudeJson.projects)) {
+            for (const [dir, value] of Object.entries(claudeJson.projects)) {
+                if (norm(dir) === norm(cwd) && isObject(value))
+                    collectServers(value.mcpServers, 'project', '~/.claude.json (this project)', plan, seen);
+            }
+        }
+    }
+    const projectMcp = await readJson(path.join(cwd, '.mcp.json'));
+    if (isObject(projectMcp))
+        collectServers(projectMcp.mcpServers, 'project', '.mcp.json', plan, seen);
+    if (await isDir(path.join(home, '.claude', 'skills')))
+        plan.skillPaths.push('~/.claude/skills');
+    if (await isDir(path.join(cwd, '.claude', 'skills')))
+        plan.skillPaths.push('.claude/skills');
+    const places = [
+        ['user', path.join(home, '.claude')],
+        ['project', path.join(cwd, '.claude')],
+    ];
+    for (const [scope, base] of places) {
+        for (const n of await mdFiles(path.join(base, 'agents'))) {
+            const file = path.join(base, 'agents', n);
+            const out = convertAgent(file, await readFile(file, 'utf8'), plan.notes);
+            if (out)
+                plan.agents.push({ ...out, scope, from: file });
+        }
+        for (const n of await mdFiles(path.join(base, 'commands'))) {
+            const file = path.join(base, 'commands', n);
+            const out = convertCommand(file, await readFile(file, 'utf8'), plan.notes);
+            if (out)
+                plan.commands.push({ ...out, scope, from: file });
+        }
+        const settings = await readJson(path.join(base, 'settings.json'));
+        if (isObject(settings)) {
+            const where = `${scope === 'user' ? '~' : '.'}/.claude/settings.json`;
+            if (settings.permissions !== undefined)
+                plan.notes.push(`${where}: permissions are not imported; set Forge permission rules instead`);
+            if (settings.hooks !== undefined)
+                plan.notes.push(`${where}: hooks are not imported`);
+        }
+    }
+    return plan;
+}
+async function writeNew(file, text, result) {
+    await mkdir(path.dirname(file), { recursive: true });
+    try {
+        await writeFile(file, text, { encoding: 'utf8', flag: 'wx' });
+        result.written.push(file);
+    }
+    catch (err) {
+        if (err.code === 'EEXIST')
+            result.skipped.push(`${file} already exists`);
+        else
+            throw err;
+    }
+}
+export async function applyClaudeImport(plan, opts) {
+    const { home, cwd } = opts;
+    const result = { written: [], skipped: [] };
+    const forgeDir = (scope) => path.join(scope === 'user' ? home : cwd, '.forge');
+    for (const scope of ['user', 'project']) {
+        const items = plan.mcp.filter((m) => m.scope === scope);
+        if (items.length === 0)
+            continue;
+        const file = path.join(forgeDir(scope), 'mcp.json');
+        const existing = await readJson(file);
+        const servers = isObject(existing) && isObject(existing.mcpServers) ? { ...existing.mcpServers } : {};
+        let added = 0;
+        for (const m of items) {
+            if (m.name in servers) {
+                result.skipped.push(`MCP server "${m.name}" already in ${file}`);
+            }
+            else {
+                servers[m.name] = m.spec;
+                added += 1;
+            }
+        }
+        if (added > 0) {
+            await mkdir(path.dirname(file), { recursive: true });
+            await writeFile(file, JSON.stringify({ ...(isObject(existing) ? existing : {}), mcpServers: servers }, null, 2) + '\n', 'utf8');
+            result.written.push(file);
+        }
+    }
+    for (const a of plan.agents)
+        await writeNew(path.join(forgeDir(a.scope), 'agents', `${a.name}.md`), a.text, result);
+    for (const c of plan.commands)
+        await writeNew(path.join(forgeDir(c.scope), 'commands', `${c.name}.md`), c.text, result);
+    if (plan.skillPaths.length > 0) {
+        const configPath = opts.configPath ?? path.join(home, '.forge', 'config.json');
+        const { config } = await loadForgeConfigFile(configPath);
+        const current = config.skillPaths ?? [];
+        const add = plan.skillPaths.filter((p) => !current.includes(p));
+        if (add.length > 0) {
+            await saveForgeConfigFile({ skillPaths: [...current, ...add] }, configPath);
+            result.written.push(configPath);
+        }
+    }
+    return result;
+}

package/dist/index.d.ts

@@ -1,4 +1,7 @@
 export { Agent, applySandbox } from './agent/agent.js';
+export { LoopGuard } from './agent/loop-guard.js';
+export { enhancePrompt } from './agent/enhance-prompt.js';
+export { stripThinkTags } from './agent/think-tags.js';
 export { createGitHubCreateTool, createGitHubReadTool, createGitHubTools, githubFromEnv, parseRemote, type GitHubConfig, type PullRequestReport, type RepoRef, } from './github/github-tools.js';
 export { createWebSearchTool, searchWeb, WEB_SEARCH_PROVIDERS, webSearchFromEnv, webSearchProblem, type WebSearchConfig, type WebSearchProvider, type WebSearchResult, } from './tools/web-search.js';
 export { attachmentKind, attachmentBytes, attachmentParts, attachmentProblem, describeAttachment, detectMediaType, loadAttachment, makeAttachment, mediaPartTokens, MAX_ATTACHMENT_BYTES, MAX_IMAGE_ATTACHMENT_BYTES, type Attachment, type AttachmentKind, } from './attachments.js';
@@ -33,17 +36,17 @@ export type { MemoryForgetResult, MemoryReadResult, MemoryWriteResult } from './
 export { buildLlmSummarizer, compactMessages, estimateMessageTokens, estimateTokens, getModelWindowTokens, shouldCompact, } from './context/compaction.js';
 export type { CompactionResult, Summarizer } from './context/compaction.js';
 export { defaultModelFor, detectProvider, envVarForProvider, fastDefaultFor, hasProviderKey, readModelConfigFromEnv, resolveApiKey, SUPPORTED_PROVIDERS, } from './config.js';
-export { loadMcpConfig, parseMcpConfig, connectAll, connectOne, closeAll, mcpResultToValue, jsonSchemaToZod, } from './mcp/index.js';
+export { loadMcpConfig, parseMcpConfig, connectAll, connectOne, closeAll, mcpResultToValue, mcpInstructionsBlock, createMcpResourceTools, jsonSchemaToZod, } from './mcp/index.js';
 export type { McpConfigFile, McpServerSpec, ConnectedMcpServer, } from './mcp/index.js';
 export { createLanguageModel, formatModelId, pickAvailableProvider, resolveModelFromEnv, resolveModelFromEnvAsync } from './providers.js';
-export { defaultSessionDir, generateSessionId, saveSession, loadSession, deleteSession, listSessions, findLatestSession, formatSessionMarkdown, formatSessionJson, appendedSince, summarizeMessage, watchSession, searchSessions, sessionText, } from './sessions/index.js';
-export type { Session, ListEntry, FormatOptions, SessionUpdate, WatchSessionOptions, SessionMatch, SearchSessionsOptions } from './sessions/index.js';
+export { defaultSessionDir, generateSessionId, saveSession, loadSession, deleteSession, listSessions, findLatestSession, formatSessionMarkdown, formatSessionJson, appendedSince, summarizeMessage, watchSession, searchSessions, sessionText, pruneSessions, pruneByRetention, } from './sessions/index.js';
+export type { Session, ListEntry, FormatOptions, SessionUpdate, WatchSessionOptions, SessionMatch, SearchSessionsOptions, SessionPruneOptions, SessionPruneResult } from './sessions/index.js';
 export { commandDirs, expandCustomCommand, formatCustomCommands, loadCustomCommands, parseCommandFile, type CustomCommand, } from './commands/custom-commands.js';
 export { BUILTIN_TOOLS, editFileTool, fetchUrlTool, findSymbolTool, listFilesTool, memoryReadTool, memoryForgetTool, memoryWriteTool, readFileTool, runCommandTool, searchFilesTool, subAgentTool, writeFileTool, checkPolicyViolation, globToRegex, mergeToolSandbox, normalizePathPattern, pathMatchesAny, redact, countRedactions, buildRules, ToolResultCache, buildCacheKey, cachedExecute, } from './tools/index.js';
-export type { AgentConfig, AgentEvent, AgentRunOptions, AgentRunReason, AgentRunResult, AnyLanguageModel, ApprovalDecision, CommandRunner, ModelRouter, VerifyConfig, ApprovalRequest, LanguageModelFactory, ModelConfig, PricePerMillionTokens, ProviderName, RedactOptions, ToolContext, ToolDefinition, ToolPolicy, ToolSandbox, } from './types.js';
+export type { AgentConfig, AgentEvent, AgentRunOptions, AgentRunReason, AgentRunResult, AnyLanguageModel, ApprovalDecision, CommandRunner, ModelRouter, VerifyConfig, ApprovalRequest, LanguageModelFactory, ModelConfig, PricePerMillionTokens, ProviderName, RedactOptions, TodoItem, ToolContext, UserQuestion, ToolDefinition, ToolPolicy, ToolSandbox, } from './types.js';
 export type { CacheKeyParts, CacheStats } from './tools/index.js';
 export type { RedactionRule, RedactionResult } from './tools/index.js';
-export { buildSkillsBlock, composeSkillsPrompt, discoverSkills, fetchSkillsCatalog, installSkillFromCatalog, loadSkillsRegistry, loadSkillsRegistryAsync, parseSkill, parseSkillsDir, resolveSkillRoots, scoreSkill, searchSkills, selectSkills, skillsRegistryFromList, DEFAULT_SKILL_CATALOG_URL, GLOBAL_SKILLS_DIR, LOCAL_SKILLS_DIR, PROJECT_SKILLS_DIR, SKILL_CATALOG_VERSION, } from './skills/index.js';
+export { buildSkillsBlock, builtinSkills, composeSkillsPrompt, discoverSkills, fetchSkillsCatalog, installSkillFromCatalog, loadSkillsRegistry, loadSkillsRegistryAsync, parseSkill, parseSkillsDir, resolveSkillRoots, scoreSkill, searchSkills, selectSkills, skillsRegistryFromList, DEFAULT_SKILL_CATALOG_URL, GLOBAL_SKILLS_DIR, LOCAL_SKILLS_DIR, PROJECT_SKILLS_DIR, SKILL_CATALOG_VERSION, } from './skills/index.js';
 export type { Skill, SkillCatalog, SkillCatalogEntry, SkillRegistry, SkillRoots, SkillSearchResult, SkillSource, } from './skills/index.js';
 export { cosine, embedderFromEnv, hashingEmbedder, openAiCompatibleEmbedder, } from './semantic/embedder.js';
 export type { Embedder, OpenAiCompatibleEmbedderOptions } from './semantic/embedder.js';
@@ -60,7 +63,13 @@ export { PolicyError, applyPolicy, assertProviderAllowed, filterMcpServers, getO
 export type { OrgPolicy } from './policy/policy.js';
 export { createFileAuditSink, defaultAuditFile, scrubArgs } from './policy/audit.js';
 export type { AuditEntry, AuditSink } from './policy/audit.js';
-export { hasProxy, installProxy, proxyFromEnv } from './policy/proxy.js';
+export { hasProxy, installProxy, installedFetch, proxyFromEnv } from './policy/proxy.js';
+export { readCaCertificates } from './policy/ca-certs.js';
+export { BackgroundAgents, MAX_RUNNING_BACKGROUND, backgroundResultsBlock } from './agent/background.js';
+export type { BackgroundAgent, BackgroundState } from './agent/background.js';
+export { applyClaudeImport, planClaudeImport } from './import/claude-code.js';
+export type { ApplyResult, ClaudeImportPlan } from './import/claude-code.js';
+export type { CaCertificates } from './policy/ca-certs.js';
 export type { ProxySettings } from './policy/proxy.js';
 export { AGENT_HOOK_TOOLS, createAgentHookRunner, DEFAULT_AGENT_HOOK_TIMEOUT_MS, DEFAULT_HOOK_TIMEOUT_MS, HooksBus, eventFilePath, eventToEnv, eventToolName, globalSettingsPath, hooksBusFromConfig, loadHooksConfig, matcherMatches, projectSettingsPath, runHook, validateHooksConfig, HOOK_EVENT_NAMES, shouldIgnoreWatchPath, FileChangeCoalescer, watchFilesystem, } from './hooks/index.js';
 export type { AgentHookConfig, AgentHookRunner, AgentHookRunnerOptions, ShellHookConfig, ForgeSettings, HookConfig, HookDispatchLog, HookEvent, HookEventName, FileChangeType, HookMatcherEntry, HookRunResult, HooksConfig, LoadHooksResult, } from './hooks/index.js';
@@ -84,6 +93,16 @@ export { branchChangedFiles, branchDiff, commitAllInWorktree, compareWorktreeCon
 export type { MergeResult, WorktreeCommit, CreateOptions, RemoveOptions, RemoveResult, WorktreeContextSnapshot, WorktreeInfo, WorktreeMismatchKind, WorktreeMismatchResult, } from './worktree/index.js';
 export { formatSteeringLine, isSafeSteeringName, loadSteering, overrideFilePath, parseSteering, pathMatchesGlob, readOverride, selectAtStart, selectOnToolTouch, setSteeringDisabled, stripSteering, wrapSteering, } from './steering/index.js';
 export type { StartSelection, SteeringConfig, SteeringDoc, SteeringInclusion, SteeringLoadResult, SteeringSkip, } from './steering/index.js';
+export { CONFIG_KEY_COVERAGE, FORGE_CONFIG_SCHEMA } from './config-schema.js';
+export { FILE_WRITE_TOOL_NAMES, filesTouchedBy } from './tools/write-tools.js';
+export { shellEnv } from './tools/shell-env.js';
+export { previewPatch } from './tools/apply-patch.js';
+export type { PatchPreview } from './tools/apply-patch.js';
+export { applyPatchTool, parsePatch, patchedPaths } from './tools/apply-patch.js';
+export { buildEmbedder, type EmbedderSpec } from './semantic/embedder.js';
+export { parseExtensions, type SemanticOptions } from './semantic/semantic-index.js';
+export { cleanDigest, generateSessionDigest, shouldDigest, type DigestItem } from './memory/session-digest.js';
+export { buildExtraInstructionsBlock } from './steering/extra-instructions.js';
 export { buildProjectInstructionsBlock, PROJECT_INSTRUCTION_FILES } from './steering/project-instructions.js';
 export { aiCommentTask, findAiComments, triggerOf } from './ai-comments/index.js';
 export type { AiComment, AiCommentAction, AiCommentFile } from './ai-comments/index.js';
@@ -95,8 +114,19 @@ export type { SyntaxProblem } from './code-index/parser.js';
 export * from './lsp/index.js';
 export * from './plugins/index.js';
 export { READ_ONLY_TOOLS, resolveAutoApprove } from './tools/read-only.js';
+export { compilePermissionRules, evaluatePermission, isSensitiveFile, permissionFor, splitShellCommands, touchesOutsideCwd } from './tools/permission-rules.js';
+export type { PermissionAction, PermissionConfig, PermissionRule } from './tools/permission-rules.js';
 export { autoRunCommands, autoRunFingerprint, detectProjectChecks, formatProjectCommandsBlock, projectScriptsFingerprint } from './verify/index.js';
 export { isAlwaysAllowable, isListedCommand, needsScriptFingerprint, normalizeCommand } from './tools/command-allow.js';
 export type { CheckKind, DetectedCheck, DetectedChecks } from './verify/index.js';
 export { IgnoreRules, IGNORE_FILE_NAMES, findGitRoot } from './tools/ignore-rules.js';
-//# sourceMappingURL=index.d.ts.map
+export { MAX_OBJECTIVE_CHARS, applyTurnOutcome, createGoalReportTool, goalPrompt, pauseGoal, resumeGoal, startGoal } from './agent/goal.js';
+export type { GoalReport, GoalState, GoalStatus, TurnOutcome } from './agent/goal.js';
+export { loadMergedForgeConfig, projectConfigPath } from './config-merge.js';
+export { PROVIDER_PRESETS, apiModelId, customProviderProblems, filterModels, knownProviderIds, modelFilterFor, registerCustomProviders, registerModelFilters, registeredCustomProviders, resolveProviderEndpoint, } from './custom-providers.js';
+export type { CustomModelConfig, CustomProviderConfig, EndpointApi, ProviderEndpoint, ProviderPreset } from './custom-providers.js';
+export { withTimeouts, type FetchTimeouts } from './timed-fetch.js';
+export { createEndpointModel } from './providers.js';
+export { agentToSpecialist, loadAgentFiles, parseAgentFile, registerAgentDefs, registeredAgent, registeredAgents, type AgentDef } from './agents/agent-files.js';
+export { applyResolved, type ResolvedModelRef } from './model-alias.js';
+export { getModelOverride, overridesFromProviders, registerModelOverrides, type ModelOverride, type ModelOverrides } from './model-overrides.js';

package/dist/index.js

@@ -1,4 +1,7 @@
 export { Agent, applySandbox } from './agent/agent.js';
+export { LoopGuard } from './agent/loop-guard.js';
+export { enhancePrompt } from './agent/enhance-prompt.js';
+export { stripThinkTags } from './agent/think-tags.js';
 export { createGitHubCreateTool, createGitHubReadTool, createGitHubTools, githubFromEnv, parseRemote, } from './github/github-tools.js';
 export { createWebSearchTool, searchWeb, WEB_SEARCH_PROVIDERS, webSearchFromEnv, webSearchProblem, } from './tools/web-search.js';
 export { attachmentKind, attachmentBytes, attachmentParts, attachmentProblem, describeAttachment, detectMediaType, loadAttachment, makeAttachment, mediaPartTokens, MAX_ATTACHMENT_BYTES, MAX_IMAGE_ATTACHMENT_BYTES, } from './attachments.js';
@@ -19,13 +22,13 @@ export { checkStale, staleKey } from './memory/stale.js';
 export { MAX_BODY_CHARS } from './tools/memory.js';
 export { buildLlmSummarizer, compactMessages, estimateMessageTokens, estimateTokens, getModelWindowTokens, shouldCompact, } from './context/compaction.js';
 export { defaultModelFor, detectProvider, envVarForProvider, fastDefaultFor, hasProviderKey, readModelConfigFromEnv, resolveApiKey, SUPPORTED_PROVIDERS, } from './config.js';
-export { loadMcpConfig, parseMcpConfig, connectAll, connectOne, closeAll, mcpResultToValue, jsonSchemaToZod, } from './mcp/index.js';
+export { loadMcpConfig, parseMcpConfig, connectAll, connectOne, closeAll, mcpResultToValue, mcpInstructionsBlock, createMcpResourceTools, jsonSchemaToZod, } from './mcp/index.js';
 export { createLanguageModel, formatModelId, pickAvailableProvider, resolveModelFromEnv, resolveModelFromEnvAsync } from './providers.js';
-export { defaultSessionDir, generateSessionId, saveSession, loadSession, deleteSession, listSessions, findLatestSession, formatSessionMarkdown, formatSessionJson, appendedSince, summarizeMessage, watchSession, searchSessions, sessionText, } from './sessions/index.js';
+export { defaultSessionDir, generateSessionId, saveSession, loadSession, deleteSession, listSessions, findLatestSession, formatSessionMarkdown, formatSessionJson, appendedSince, summarizeMessage, watchSession, searchSessions, sessionText, pruneSessions, pruneByRetention, } from './sessions/index.js';
 export { commandDirs, expandCustomCommand, formatCustomCommands, loadCustomCommands, parseCommandFile, } from './commands/custom-commands.js';
 export { BUILTIN_TOOLS, editFileTool, fetchUrlTool, findSymbolTool, listFilesTool, memoryReadTool, memoryForgetTool, memoryWriteTool, readFileTool, runCommandTool, searchFilesTool, subAgentTool, writeFileTool, checkPolicyViolation, globToRegex, mergeToolSandbox, normalizePathPattern, pathMatchesAny, redact, countRedactions, buildRules, ToolResultCache, buildCacheKey, cachedExecute, } from './tools/index.js';
 // Skills system
-export { buildSkillsBlock, composeSkillsPrompt, discoverSkills, fetchSkillsCatalog, installSkillFromCatalog, loadSkillsRegistry, loadSkillsRegistryAsync, parseSkill, parseSkillsDir, resolveSkillRoots, scoreSkill, searchSkills, selectSkills, skillsRegistryFromList, DEFAULT_SKILL_CATALOG_URL, GLOBAL_SKILLS_DIR, LOCAL_SKILLS_DIR, PROJECT_SKILLS_DIR, SKILL_CATALOG_VERSION, } from './skills/index.js';
+export { buildSkillsBlock, builtinSkills, composeSkillsPrompt, discoverSkills, fetchSkillsCatalog, installSkillFromCatalog, loadSkillsRegistry, loadSkillsRegistryAsync, parseSkill, parseSkillsDir, resolveSkillRoots, scoreSkill, searchSkills, selectSkills, skillsRegistryFromList, DEFAULT_SKILL_CATALOG_URL, GLOBAL_SKILLS_DIR, LOCAL_SKILLS_DIR, PROJECT_SKILLS_DIR, SKILL_CATALOG_VERSION, } from './skills/index.js';
 export { cosine, embedderFromEnv, hashingEmbedder, openAiCompatibleEmbedder, } from './semantic/embedder.js';
 export { ensureSemanticFresh, searchSemantic } from './semantic/semantic-index.js';
 export { createCodebaseSearchTool } from './tools/codebase-search.js';
@@ -37,7 +40,10 @@ export { applyCacheHints, supportsCacheHints } from './agent/cache-hints.js';
 // Organization policy, audit log, proxy
 export { PolicyError, applyPolicy, assertProviderAllowed, filterMcpServers, getOrgPolicy, loadOrgPolicy, managedPolicyPath, parsePolicy, resetOrgPolicyCache, } from './policy/policy.js';
 export { createFileAuditSink, defaultAuditFile, scrubArgs } from './policy/audit.js';
-export { hasProxy, installProxy, proxyFromEnv } from './policy/proxy.js';
+export { hasProxy, installProxy, installedFetch, proxyFromEnv } from './policy/proxy.js';
+export { readCaCertificates } from './policy/ca-certs.js';
+export { BackgroundAgents, MAX_RUNNING_BACKGROUND, backgroundResultsBlock } from './agent/background.js';
+export { applyClaudeImport, planClaudeImport } from './import/claude-code.js';
 // Hooks system
 export { AGENT_HOOK_TOOLS, createAgentHookRunner, DEFAULT_AGENT_HOOK_TIMEOUT_MS, DEFAULT_HOOK_TIMEOUT_MS, HooksBus, eventFilePath, eventToEnv, eventToolName, globalSettingsPath, hooksBusFromConfig, loadHooksConfig, matcherMatches, projectSettingsPath, runHook, validateHooksConfig, HOOK_EVENT_NAMES, shouldIgnoreWatchPath, FileChangeCoalescer, watchFilesystem, } from './hooks/index.js';
 // MCP marketplace
@@ -67,6 +73,15 @@ export { defaultRetryPrompt, formatZodError, isStructuredOutputError, loadSchema
 export { branchChangedFiles, branchDiff, commitAllInWorktree, compareWorktreeContexts, deleteBranch, mergeBranch, snapshotWorktreeContext, WorktreeError, WorktreeManager, } from './worktree/index.js';
 // Steering files (SP3a)
 export { formatSteeringLine, isSafeSteeringName, loadSteering, overrideFilePath, parseSteering, pathMatchesGlob, readOverride, selectAtStart, selectOnToolTouch, setSteeringDisabled, stripSteering, wrapSteering, } from './steering/index.js';
+export { CONFIG_KEY_COVERAGE, FORGE_CONFIG_SCHEMA } from './config-schema.js';
+export { FILE_WRITE_TOOL_NAMES, filesTouchedBy } from './tools/write-tools.js';
+export { shellEnv } from './tools/shell-env.js';
+export { previewPatch } from './tools/apply-patch.js';
+export { applyPatchTool, parsePatch, patchedPaths } from './tools/apply-patch.js';
+export { buildEmbedder } from './semantic/embedder.js';
+export { parseExtensions } from './semantic/semantic-index.js';
+export { cleanDigest, generateSessionDigest, shouldDigest } from './memory/session-digest.js';
+export { buildExtraInstructionsBlock } from './steering/extra-instructions.js';
 export { buildProjectInstructionsBlock, PROJECT_INSTRUCTION_FILES } from './steering/project-instructions.js';
 // AI comments (Aider parity E).
 export { aiCommentTask, findAiComments, triggerOf } from './ai-comments/index.js';
@@ -82,9 +97,17 @@ export * from './lsp/index.js';
 export * from './plugins/index.js';
 // Tools that are approved without a prompt by default (read-only).
 export { READ_ONLY_TOOLS, resolveAutoApprove } from './tools/read-only.js';
+export { compilePermissionRules, evaluatePermission, isSensitiveFile, permissionFor, splitShellCommands, touchesOutsideCwd } from './tools/permission-rules.js';
 // Project check detection (typecheck / lint / test commands) for verify-by-default.
 export { autoRunCommands, autoRunFingerprint, detectProjectChecks, formatProjectCommandsBlock, projectScriptsFingerprint } from './verify/index.js';
 export { isAlwaysAllowable, isListedCommand, needsScriptFingerprint, normalizeCommand } from './tools/command-allow.js';
 // Git-style ignore rules (.gitignore, .forgeignore) used by the file tools and indexes.
 export { IgnoreRules, IGNORE_FILE_NAMES, findGitRoot } from './tools/ignore-rules.js';
-//# sourceMappingURL=index.js.map
+export { MAX_OBJECTIVE_CHARS, applyTurnOutcome, createGoalReportTool, goalPrompt, pauseGoal, resumeGoal, startGoal } from './agent/goal.js';
+export { loadMergedForgeConfig, projectConfigPath } from './config-merge.js';
+export { PROVIDER_PRESETS, apiModelId, customProviderProblems, filterModels, knownProviderIds, modelFilterFor, registerCustomProviders, registerModelFilters, registeredCustomProviders, resolveProviderEndpoint, } from './custom-providers.js';
+export { withTimeouts } from './timed-fetch.js';
+export { createEndpointModel } from './providers.js';
+export { agentToSpecialist, loadAgentFiles, parseAgentFile, registerAgentDefs, registeredAgent, registeredAgents } from './agents/agent-files.js';
+export { applyResolved } from './model-alias.js';
+export { getModelOverride, overridesFromProviders, registerModelOverrides } from './model-overrides.js';

package/dist/lazy-model.d.ts

@@ -11,4 +11,3 @@ export declare function lazyLanguageModel(meta: {
     provider: string;
     modelId: string;
 }, load: () => Promise<LanguageModelV4>): LanguageModelV4;
-//# sourceMappingURL=lazy-model.d.ts.map

package/dist/lazy-model.js

@@ -13,4 +13,3 @@ export function lazyLanguageModel(meta, load) {
         doStream: (options) => get().then((m) => m.doStream(options)),
     };
 }
-//# sourceMappingURL=lazy-model.js.map

package/dist/lint/auto-lint.d.ts

@@ -23,4 +23,3 @@ export declare function commandFor(relPath: string, commands: Record<string, str
 export declare function lintFile(relPath: string, config: AutoLintConfig, ctx: ToolContext): Promise<LintReport>;
 /** The note appended to the tool result when lint found problems. */
 export declare function lintMessage(report: LintReport): string;
-//# sourceMappingURL=auto-lint.d.ts.map

package/dist/lint/auto-lint.js

@@ -58,4 +58,3 @@ export async function lintFile(relPath, config, ctx) {
 export function lintMessage(report) {
     return `[auto-lint] ${report.problems.length} problem${report.problems.length === 1 ? '' : 's'} in ${report.path}. Fix them:\n${report.problems.join('\n')}`;
 }
-//# sourceMappingURL=auto-lint.js.map

package/dist/lint/index.d.ts

@@ -1,3 +1,2 @@
 export { commandFor, lintFile, lintMessage, shellQuote } from './auto-lint.js';
 export type { AutoLintConfig, LintReport } from './auto-lint.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/lint/index.js

@@ -1,2 +1 @@
 export { commandFor, lintFile, lintMessage, shellQuote } from './auto-lint.js';
-//# sourceMappingURL=index.js.map

package/dist/lsp/client.d.ts

@@ -1,3 +1,8 @@
+/**
+ * The absolute path of `command` found on PATH (with PATHEXT on Windows), or undefined. Never the current directory.
+ * A command that already names a path is returned as it is.
+ */
+export declare function resolveOnPath(command: string, env: NodeJS.ProcessEnv, platform: NodeJS.Platform): string | undefined;
 export type LspSeverity = 'error' | 'warning' | 'info' | 'hint';
 export interface LspDiagnostic {
     /** 1-based. */
@@ -37,4 +42,3 @@ export declare class LspClient {
     private onData;
     private onMessage;
 }
-//# sourceMappingURL=client.d.ts.map

package/dist/lsp/client.js

@@ -4,6 +4,37 @@
  * JSON-RPC 2.0 with `Content-Length` framing is small enough to own.
  */
 import { spawn } from 'node:child_process';
+import { statSync } from 'node:fs';
+import path from 'node:path';
+/**
+ * The absolute path of `command` found on PATH (with PATHEXT on Windows), or undefined. Never the current directory.
+ * A command that already names a path is returned as it is.
+ */
+export function resolveOnPath(command, env, platform) {
+    if (/[\\/]/.test(command))
+        return command;
+    const isFile = (p) => {
+        try {
+            return statSync(p).isFile();
+        }
+        catch {
+            return false;
+        }
+    };
+    const win = platform === 'win32';
+    const dirs = (env.PATH ?? env.Path ?? '').split(win ? ';' : path.delimiter).filter(Boolean);
+    const exts = win ? ['', ...(env.PATHEXT ?? '.COM;.EXE;.BAT;.CMD').split(';').filter(Boolean).map((e) => e.toLowerCase())] : [''];
+    for (const dir of dirs) {
+        for (const ext of exts) {
+            if (win && ext === '' && !/\.[a-z0-9]+$/i.test(command))
+                continue; // Windows runs nothing without an extension
+            const candidate = path.join(dir, command + ext);
+            if (isFile(candidate))
+                return candidate;
+        }
+    }
+    return undefined;
+}
 import { fileURLToPath, pathToFileURL } from 'node:url';
 /**
  * Servers echo document URIs in their own spelling (`file:///c%3A/x` for the
@@ -45,9 +76,14 @@ export class LspClient {
      * the spawn error (e.g. ENOENT) when the server binary is not installed.
      */
     static async start(spec, rootDir, timeoutMs) {
-        // Bare names on Windows are usually npm `.cmd` shims, which need a shell; explicit paths must not go through one.
-        const shell = process.platform === 'win32' && !/[\\/]/.test(spec.command);
-        const proc = spawn(spec.command, spec.args ?? [], { cwd: rootDir, stdio: ['pipe', 'pipe', 'pipe'], shell });
+        // The server runs in the workspace, and Windows looks in the current directory before PATH: a repository could
+        // ship its own `typescript-language-server.cmd`. So a bare name is resolved on PATH first, never in the workspace.
+        const command = resolveOnPath(spec.command, process.env, process.platform);
+        if (!command)
+            throw Object.assign(new Error(`${spec.command} is not installed (not found on PATH)`), { code: 'ENOENT' });
+        // npm `.cmd` shims need a shell on Windows; the path is quoted because it is now absolute and may contain spaces.
+        const shell = process.platform === 'win32' && /\.(cmd|bat)$/i.test(command);
+        const proc = spawn(shell ? `"${command}"` : command, spec.args ?? [], { cwd: rootDir, stdio: ['pipe', 'pipe', 'pipe'], shell });
         const spawned = new Promise((_, reject) => proc.once('error', reject));
         const client = new LspClient(proc);
         const rootUri = pathToFileURL(rootDir).href;
@@ -206,4 +242,3 @@ function toDiagnostic(d) {
         ...(d.code !== undefined ? { code: d.code } : {}),
     };
 }
-//# sourceMappingURL=client.js.map

package/dist/lsp/diagnostics.d.ts

@@ -19,4 +19,3 @@ export interface LspReport {
 export declare function collectErrors(files: string[], cwd: string, config?: LspConfig): Promise<LspReport>;
 /** Plain-text rendering fed to the model, in `file:line:col: message` form. */
 export declare function formatErrors(errors: FileDiagnostics[]): string;
-//# sourceMappingURL=diagnostics.d.ts.map

package/dist/lsp/diagnostics.js

@@ -79,4 +79,3 @@ export function formatErrors(errors) {
     })
         .join('\n');
 }
-//# sourceMappingURL=diagnostics.js.map

package/dist/lsp/index.d.ts

@@ -2,4 +2,3 @@ export { LspClient } from './client.js';
 export type { LspDiagnostic, LspServerSpec, LspSeverity } from './client.js';
 export { collectErrors, formatErrors } from './diagnostics.js';
 export type { FileDiagnostics, LspConfig, LspReport } from './diagnostics.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/lsp/index.js

@@ -1,3 +1,2 @@
 export { LspClient } from './client.js';
 export { collectErrors, formatErrors } from './diagnostics.js';
-//# sourceMappingURL=index.js.map

package/dist/mcp/catalog.d.ts

@@ -20,4 +20,3 @@ export declare function loadMcpCatalog(options?: {
     servers: MarketplaceEntry[];
     warning?: string;
 }>;
-//# sourceMappingURL=catalog.d.ts.map

package/dist/mcp/catalog.js

@@ -109,4 +109,3 @@ export async function loadMcpCatalog(options = {}) {
         return { servers: [...byName.values()], warning: `Could not load catalog ${url}: ${err.message}` };
     }
 }
-//# sourceMappingURL=catalog.js.map

package/dist/mcp/index.d.ts

@@ -1,7 +1,11 @@
 export { loadMcpConfig, parseMcpConfig } from './mcp-config.js';
 export type { McpConfigFile, McpServerSpec } from './mcp-config.js';
 export { jsonSchemaToZod } from './json-schema-to-zod.js';
-export { connectAll, connectOne, closeAll, mcpResultToValue } from './mcp-client.js';
+export { connectAll, connectOne, closeAll, mcpInstructionsBlock, mcpResultToValue, McpAuthRequiredError } from './mcp-client.js';
+export type { ConnectOptions } from './mcp-client.js';
+export { forgetSavedAuth, defaultMcpAuthDir } from './oauth.js';
+export type { McpOAuthOptions } from './oauth.js';
+export { createMcpResourceTools } from './resource-tools.js';
 export { BUILTIN_MCP_CATALOG, loadMcpCatalog } from './catalog.js';
 export { McpManager, expandSpec } from './manager.js';
 export type { McpManagerOptions, McpServerState, McpServerStatus } from './manager.js';
@@ -10,4 +14,3 @@ export type { ConnectedMcpServer } from './mcp-client.js';
 export { defaultCacheRoot, defaultUserMcpPath, installMcpServer, installDirNameFor, listInstalledServers, normalizeGithubSource, probeRepoForServer, readUserMcpRegistry, uninstallMcpServer, writeUserMcpRegistry, } from './marketplace.js';
 export type { InstalledMcpServer, InstalledServerMetadata, MarketplaceCatalog, MarketplaceEntry, } from './marketplace-types.js';
 export { MARKETPLACE_CATALOG_VERSION } from './marketplace-types.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.js

@@ -1,10 +1,11 @@
 export { loadMcpConfig, parseMcpConfig } from './mcp-config.js';
 export { jsonSchemaToZod } from './json-schema-to-zod.js';
-export { connectAll, connectOne, closeAll, mcpResultToValue } from './mcp-client.js';
+export { connectAll, connectOne, closeAll, mcpInstructionsBlock, mcpResultToValue, McpAuthRequiredError } from './mcp-client.js';
+export { forgetSavedAuth, defaultMcpAuthDir } from './oauth.js';
+export { createMcpResourceTools } from './resource-tools.js';
 export { BUILTIN_MCP_CATALOG, loadMcpCatalog } from './catalog.js';
 export { McpManager, expandSpec } from './manager.js';
 export { assertValidServerName, registerMcpServer, setMcpServerDisabled } from './registry.js';
 // MCP marketplace
 export { defaultCacheRoot, defaultUserMcpPath, installMcpServer, installDirNameFor, listInstalledServers, normalizeGithubSource, probeRepoForServer, readUserMcpRegistry, uninstallMcpServer, writeUserMcpRegistry, } from './marketplace.js';
 export { MARKETPLACE_CATALOG_VERSION } from './marketplace-types.js';
-//# sourceMappingURL=index.js.map

package/dist/mcp/json-schema-to-zod.d.ts

@@ -10,4 +10,3 @@ import { z } from 'zod';
  * generation hint rather than a security boundary.
  */
 export declare function jsonSchemaToZod(schema: unknown): z.ZodTypeAny;
-//# sourceMappingURL=json-schema-to-zod.d.ts.map

package/dist/mcp/json-schema-to-zod.js

@@ -89,4 +89,3 @@ function combineOneOf(branches) {
 function isNullSchema(node) {
     return typeof node === 'object' && node !== null && node.type === 'null';
 }
-//# sourceMappingURL=json-schema-to-zod.js.map