@ikarmic/forge-core 5.2.0 → 5.4.0

package/dist/index.d.ts

@@ -1,8 +1,11 @@
 export { Agent, applySandbox } from './agent/agent.js';
 export { LoopGuard } from './agent/loop-guard.js';
 export { enhancePrompt } from './agent/enhance-prompt.js';
+export { generateShellCommand, shellKindOf, commandRisk } from './agent/shell-command.js';
+export type { ShellKind } from './agent/shell-command.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 { createGitHubCreateTool, createGitHubReadTool, createGitHubTools, githubFromEnv, parseRemote, type GitHubConfig, type PullRequestReport, repoFor, type RepoRef, } from './github/github-tools.js';
+export { defaultBranch, findPullRequest, openPullRequest, type NewPullRequest, type PullRequestSummary } from './github/pr.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';
 export type { CredentialStore } from './credentials/types.js';
@@ -33,17 +36,18 @@ export type { StaleOptions } from './memory/stale.js';
 export type { LoadedMemory, InjectOptions, MemoryInjection, MemorySection, MemorySource, MemoryType, SectionMeta, } from './memory/memory-store.js';
 export { MAX_BODY_CHARS } from './tools/memory.js';
 export type { MemoryForgetResult, MemoryReadResult, MemoryWriteResult } from './tools/memory.js';
-export { buildLlmSummarizer, compactMessages, estimateMessageTokens, estimateTokens, getModelWindowTokens, shouldCompact, } from './context/compaction.js';
+export { buildLlmSummarizer, COMPACTION_SUMMARY_PREFIX, compactMessages, estimateMessageTokens, isCompactionSummary, estimateTokens, getModelWindowTokens, windowIsGuess, 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, mcpInstructionsBlock, createMcpResourceTools, jsonSchemaToZod, } from './mcp/index.js';
+export { loadMcpConfig, parseMcpConfig, connectAll, connectOne, closeAll, mcpResultToValue, mcpInstructionsBlock, mcpToolName, mcpToolPrefix, 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, pruneSessions, pruneByRetention, } from './sessions/index.js';
-export type { Session, ListEntry, FormatOptions, SessionUpdate, WatchSessionOptions, SessionMatch, SearchSessionsOptions, SessionPruneOptions, SessionPruneResult } from './sessions/index.js';
+export { defaultSessionDir, generateSessionId, saveSession, loadSession, deleteSession, displayMessages, listSessions, findLatestSession, formatSessionMarkdown, formatSessionJson, appendedSince, summarizeMessage, watchSession, searchSessions, sessionText, pruneSessions, pruneByRetention, } from './sessions/index.js';
+export type { Session, ListEntry, MessageFeedback, 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, gitDiffTool, dependencyAuditTool, 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, TodoItem, ToolContext, UserQuestion, ToolDefinition, ToolPolicy, ToolSandbox, } from './types.js';
+export type { AgentConfig, AgentEvent, ApprovalSource, AgentRunOptions, AgentRunReason, AgentRunResult, AnyLanguageModel, ApprovalDecision, CommandRunner, ModelRouter, VerifyConfig, ApprovalRequest, LanguageModelFactory, ModelConfig, PricePerMillionTokens, ProviderName, RedactOptions, TodoItem, ToolContext, UserQuestion, ToolDefinition, ToolPolicy, ToolSandbox, } from './types.js';
+export { humanize, runReasonLabel, toolLabel } from './human-text.js';
 export type { CacheKeyParts, CacheStats } from './tools/index.js';
 export type { RedactionRule, RedactionResult } from './tools/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';
@@ -89,8 +93,8 @@ export { computeUnifiedDiff, computeDiffSummary, type DiffOptions, type DiffResu
 export { defaultRetryPrompt, formatZodError, isStructuredOutputError, loadSchemaFile, runStructuredAgent, StructuredOutputError, validateFinalText, } from './structured/index.js';
 export type { StructuredRunOptions, StructuredRunResult } from './structured/index.js';
 export type { ZodTypeAny } from './structured/index.js';
-export { branchChangedFiles, branchDiff, commitAllInWorktree, compareWorktreeContexts, deleteBranch, mergeBranch, snapshotWorktreeContext, WorktreeError, WorktreeManager, } from './worktree/index.js';
-export type { MergeResult, WorktreeCommit, CreateOptions, RemoveOptions, RemoveResult, WorktreeContextSnapshot, WorktreeInfo, WorktreeMismatchKind, WorktreeMismatchResult, } from './worktree/index.js';
+export { branchChangedFiles, branchDiff, commitAllInWorktree, compareWorktreeContexts, copyIntoWorktree, deleteBranch, doctorWorktrees, inspectWorktrees, mergeBranch, pruneMissingWorktrees, removeStrayFolder, runSetupScript, setupWorktree, snapshotWorktreeContext, worktreeStats, WorktreeError, WorktreeManager, } from './worktree/index.js';
+export type { MergeResult, WorktreeCommit, CreateOptions, RemoveOptions, RemoveResult, WorktreeContextSnapshot, WorktreeInfo, WorktreeMismatchKind, WorktreeMismatchResult, HealthFinding, ListedWorktree, WorktreeInspection, WorktreeStats, CopyOptions, CopyResult, ScriptOptions, ScriptResult, SetupOptions, SetupOutcome, } 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';
@@ -100,9 +104,15 @@ export { detectStackFacts, stackBlock, MAX_STACK_LIBRARIES, type StackFacts } fr
 export { pickAuditors, type AuditFinding, type AuditorPlan } from './tools/dependency-audit.js';
 export { shellEnv } from './tools/shell-env.js';
 export { previewPatch } from './tools/apply-patch.js';
+export { applyTextEdit } from './tools/edit-file.js';
+export { catalogEntry, loadModelCatalog, type CatalogEntry, type CatalogSource } from './catalog/models-dev.js';
+export { MAX_HORIZON_MS, MAX_PER_SESSION as MAX_WAKEUPS, MIN_DELAY_MS as MIN_WAKEUP_DELAY_MS, WakeupScheduler, resolveWakeupTime, wakeupMessage } from './wakeup/wakeup.js';
+export type { Wakeup, WakeupSchedulerOptions, WakeupStore } from './wakeup/wakeup.js';
+export { isContextOverflowError, retryDecision, withModelRetry } from './agent/retry.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 { buildEmbedder, embedderDestination, type EmbedderSpec } from './semantic/embedder.js';
+export { deleteSemanticIndex, SemanticConsentError, type SemanticStatus } from './semantic/semantic-index.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';

package/dist/index.js

@@ -1,8 +1,10 @@
 export { Agent, applySandbox } from './agent/agent.js';
 export { LoopGuard } from './agent/loop-guard.js';
 export { enhancePrompt } from './agent/enhance-prompt.js';
+export { generateShellCommand, shellKindOf, commandRisk } from './agent/shell-command.js';
 export { stripThinkTags } from './agent/think-tags.js';
-export { createGitHubCreateTool, createGitHubReadTool, createGitHubTools, githubFromEnv, parseRemote, } from './github/github-tools.js';
+export { createGitHubCreateTool, createGitHubReadTool, createGitHubTools, githubFromEnv, parseRemote, repoFor, } from './github/github-tools.js';
+export { defaultBranch, findPullRequest, openPullRequest } from './github/pr.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';
 export { CREDENTIAL_SERVICE_NAME, credentialAccountKey } from './credentials/index.js';
@@ -20,13 +22,14 @@ export { buildMemoryBlock, composeSectionUpdate, findProjectMemoryRoot, globalMe
 export { scoreSections, tokenize } from './memory/rank.js';
 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 { buildLlmSummarizer, COMPACTION_SUMMARY_PREFIX, compactMessages, estimateMessageTokens, isCompactionSummary, estimateTokens, getModelWindowTokens, windowIsGuess, 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, mcpInstructionsBlock, createMcpResourceTools, jsonSchemaToZod, } from './mcp/index.js';
+export { loadMcpConfig, parseMcpConfig, connectAll, connectOne, closeAll, mcpResultToValue, mcpInstructionsBlock, mcpToolName, mcpToolPrefix, 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, pruneSessions, pruneByRetention, } from './sessions/index.js';
+export { defaultSessionDir, generateSessionId, saveSession, loadSession, deleteSession, displayMessages, 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, gitDiffTool, dependencyAuditTool, 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 { humanize, runReasonLabel, toolLabel } from './human-text.js';
 // Skills system
 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';
@@ -70,7 +73,7 @@ export { defaultRetryPrompt, formatZodError, isStructuredOutputError, loadSchema
 // Lets child agents work in isolated git worktrees so parallel work
 // doesn't clobber the main checkout. Lifecycle: create → use → remove.
 // `pruneStale()` cleans up worktrees left behind by crashed sessions.
-export { branchChangedFiles, branchDiff, commitAllInWorktree, compareWorktreeContexts, deleteBranch, mergeBranch, snapshotWorktreeContext, WorktreeError, WorktreeManager, } from './worktree/index.js';
+export { branchChangedFiles, branchDiff, commitAllInWorktree, compareWorktreeContexts, copyIntoWorktree, deleteBranch, doctorWorktrees, inspectWorktrees, mergeBranch, pruneMissingWorktrees, removeStrayFolder, runSetupScript, setupWorktree, snapshotWorktreeContext, worktreeStats, 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';
@@ -80,8 +83,13 @@ export { detectStackFacts, stackBlock, MAX_STACK_LIBRARIES } from './agent/stack
 export { pickAuditors } from './tools/dependency-audit.js';
 export { shellEnv } from './tools/shell-env.js';
 export { previewPatch } from './tools/apply-patch.js';
+export { applyTextEdit } from './tools/edit-file.js';
+export { catalogEntry, loadModelCatalog } from './catalog/models-dev.js';
+export { MAX_HORIZON_MS, MAX_PER_SESSION as MAX_WAKEUPS, MIN_DELAY_MS as MIN_WAKEUP_DELAY_MS, WakeupScheduler, resolveWakeupTime, wakeupMessage } from './wakeup/wakeup.js';
+export { isContextOverflowError, retryDecision, withModelRetry } from './agent/retry.js';
 export { applyPatchTool, parsePatch, patchedPaths } from './tools/apply-patch.js';
-export { buildEmbedder } from './semantic/embedder.js';
+export { buildEmbedder, embedderDestination } from './semantic/embedder.js';
+export { deleteSemanticIndex, SemanticConsentError } from './semantic/semantic-index.js';
 export { parseExtensions } from './semantic/semantic-index.js';
 export { cleanDigest, generateSessionDigest, shouldDigest } from './memory/session-digest.js';
 export { buildExtraInstructionsBlock } from './steering/extra-instructions.js';

package/dist/journey/answers-block.d.ts

@@ -8,10 +8,8 @@
  * model scaffolds MySQL with invoicing. In the system message it cannot be
  * forgotten.
  *
- * Why the interview must finish before the first agent run:
- * `buildInitialMessages` assembles the blocks only when no history is passed
- * (`agent.ts:231`), so this block enters the prompt once, on a session's first
- * turn, and rides inside `history[0]` from then on.
+ * The system message is rebuilt on every turn (`buildSystemContent`, RB-57), so this block always carries the
+ * answers given so far.
  */
 import type { Answer } from './types.js';
 export declare function renderAnswersBlock(answers: readonly Answer[]): string;

package/dist/lsp/diagnostics.d.ts

@@ -4,6 +4,8 @@ export interface LspConfig {
     servers?: Record<string, LspServerSpec>;
     /** How long to wait for a server to report on a file. Default 10s. */
     waitMs?: number;
+    /** Also report warnings, not only errors (the verify loop wants errors only). */
+    includeWarnings?: boolean;
 }
 export interface FileDiagnostics {
     file: string;
@@ -15,6 +17,8 @@ export interface LspReport {
     /** Extensions whose server could not be started (not installed, crashed). */
     skipped: string[];
 }
+/** Whether a file's type has a language server configured (built-in table or an override). */
+export declare function hasServerFor(file: string, config?: LspConfig): boolean;
 /** Runs the matching language server over `files` (paths relative to `cwd` or absolute). */
 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. */

package/dist/lsp/diagnostics.js

@@ -23,6 +23,11 @@ const DEFAULT_LANGUAGES = {
 const DEFAULT_WAIT_MS = 10_000;
 const START_TIMEOUT_MS = 15_000;
 const MAX_PER_FILE = 20;
+/** Whether a file's type has a language server configured (built-in table or an override). */
+export function hasServerFor(file, config = {}) {
+    const ext = path.extname(file).toLowerCase();
+    return Boolean(config.servers?.[ext] ?? DEFAULT_LANGUAGES[ext]);
+}
 /** Runs the matching language server over `files` (paths relative to `cwd` or absolute). */
 export async function collectErrors(files, cwd, config = {}) {
     const waitMs = config.waitMs ?? DEFAULT_WAIT_MS;
@@ -54,7 +59,7 @@ export async function collectErrors(files, cwd, config = {}) {
                 const text = await readFile(f.abs, 'utf8').catch(() => null);
                 if (text === null)
                     continue;
-                const diagnostics = (await client.diagnose(pathToFileURL(f.abs).href, f.languageId, text, waitMs)).filter((d) => d.severity === 'error');
+                const diagnostics = (await client.diagnose(pathToFileURL(f.abs).href, f.languageId, text, waitMs)).filter((d) => d.severity === 'error' || (config.includeWarnings === true && d.severity === 'warning'));
                 if (diagnostics.length > 0)
                     report.errors.push({ file: path.relative(cwd, f.abs) || f.abs, diagnostics });
             }
@@ -71,7 +76,8 @@ export function formatErrors(errors) {
         .map(({ file, diagnostics }) => {
         const lines = diagnostics.slice(0, MAX_PER_FILE).map((d) => {
             const tag = [d.source, d.code].filter((x) => x !== undefined && x !== '').join(' ');
-            return `${file}:${d.line}:${d.column}: ${d.message}${tag ? ` (${tag})` : ''}`;
+            const level = d.severity === 'error' ? '' : `${d.severity}: `;
+            return `${file}:${d.line}:${d.column}: ${level}${d.message}${tag ? ` (${tag})` : ''}`;
         });
         if (diagnostics.length > MAX_PER_FILE)
             lines.push(`... ${diagnostics.length - MAX_PER_FILE} more in ${file}`);

package/dist/lsp/index.d.ts

@@ -1,4 +1,4 @@
 export { LspClient } from './client.js';
 export type { LspDiagnostic, LspServerSpec, LspSeverity } from './client.js';
-export { collectErrors, formatErrors } from './diagnostics.js';
+export { collectErrors, formatErrors, hasServerFor } from './diagnostics.js';
 export type { FileDiagnostics, LspConfig, LspReport } from './diagnostics.js';

package/dist/lsp/index.js

@@ -1,2 +1,2 @@
 export { LspClient } from './client.js';
-export { collectErrors, formatErrors } from './diagnostics.js';
+export { collectErrors, formatErrors, hasServerFor } from './diagnostics.js';

package/dist/mcp/index.d.ts

@@ -1,7 +1,7 @@
 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, mcpInstructionsBlock, mcpResultToValue, McpAuthRequiredError } from './mcp-client.js';
+export { connectAll, connectOne, closeAll, mcpInstructionsBlock, mcpResultToValue, mcpToolName, mcpToolPrefix, McpAuthRequiredError } from './mcp-client.js';
 export type { ConnectOptions } from './mcp-client.js';
 export { forgetSavedAuth, defaultMcpAuthDir } from './oauth.js';
 export type { McpOAuthOptions } from './oauth.js';

package/dist/mcp/index.js

@@ -1,6 +1,6 @@
 export { loadMcpConfig, parseMcpConfig } from './mcp-config.js';
 export { jsonSchemaToZod } from './json-schema-to-zod.js';
-export { connectAll, connectOne, closeAll, mcpInstructionsBlock, mcpResultToValue, McpAuthRequiredError } from './mcp-client.js';
+export { connectAll, connectOne, closeAll, mcpInstructionsBlock, mcpResultToValue, mcpToolName, mcpToolPrefix, 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';

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

@@ -68,11 +68,9 @@ export function jsonSchemaToZod(schema) {
                             .pipe(objectZod)
                         : objectZod;
             }
-            else if (s.additionalProperties === true) {
-                inner = z.record(z.string(), z.any());
-            }
             else {
-                inner = z.record(z.string(), z.any());
+                // Any object. Not z.record(): its JSON Schema carries `propertyNames`, a keyword Gemini's schema input does not list.
+                inner = z.looseObject({});
             }
             break;
         }

package/dist/mcp/mcp-client.d.ts

@@ -26,6 +26,20 @@ export declare function connectOne(name: string, spec: McpServerSpec, options?:
 export declare function mcpInstructionsBlock(servers: readonly ConnectedMcpServer[]): string;
 /** Close all clients and their underlying transports. */
 export declare function closeAll(servers: ConnectedMcpServer[]): Promise<void>;
+/** The start of every tool name of one server. Names a provider accepts only: letters, digits, `_` and `-`. */
+export declare function mcpToolPrefix(serverName: string): string;
+/**
+ * The name the model sees for a server's tool. OpenAI and Anthropic refuse a tool name with any other character or
+ * over 64 characters, and one refused name fails the whole request. A name that needed cleaning or cutting gets a
+ * short hash of the original pair so two different tools never become one; the call itself still uses the server's
+ * own tool name.
+ */
+export declare function mcpToolName(serverName: string, toolName: string): string;
+export declare function mcpToolToForgeTool(serverName: string, mcpTool: {
+    name: string;
+    description?: string;
+    inputSchema?: unknown;
+}, getClient: () => Client, timeout?: number, reconnect?: () => Promise<Client>): ToolDefinition;
 /**
  * Reduce an MCP `CallToolResult` to a model-friendly value.
  *

package/dist/mcp/mcp-client.js

@@ -21,6 +21,7 @@
  *  - **streamable-http**: `url` + optional `headers`. The 2025-03-26 modern
  *    transport. Uses the SDK's `StreamableHTTPClientTransport`.
  */
+import { createHash } from 'node:crypto';
 import { readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -32,6 +33,7 @@ import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/
 import { filterMcpServers, getOrgPolicy } from '../policy/policy.js';
 import { jsonSchemaToZod } from './json-schema-to-zod.js';
 import { ForgeOAuthProvider, McpAuthRequiredError, defaultMcpAuthDir, readSavedAuth } from './oauth.js';
+import { clampOutput } from '../tools/run-command.js';
 /**
  * Self-identifying info we send to every MCP server during the `initialize`
  * handshake. Version is read from our own package.json so it stays in sync
@@ -90,6 +92,32 @@ function isUnauthorized(err) {
 }
 /** Connect to a single server and pull its tools. */
 export async function connectOne(name, spec, options = {}) {
+    let current = await openClient(name, spec, options);
+    // One restart at a time: calls that find the server gone together share one new process (G7).
+    let restarting;
+    const reconnect = () => {
+        restarting ??= (async () => {
+            await current.close().catch(() => undefined);
+            current = await openClient(name, spec, options);
+            return current;
+        })().finally(() => {
+            restarting = undefined;
+        });
+        return restarting;
+    };
+    const { tools: mcpTools } = await current.listTools(undefined, spec.timeout ? { timeout: spec.timeout } : undefined);
+    const tools = mcpTools.map((t) => mcpToolToForgeTool(name, t, () => current, spec.timeout, reconnect));
+    return {
+        name,
+        get client() {
+            return current;
+        },
+        tools,
+        instructions: current.getInstructions()?.trim() || undefined,
+    };
+}
+/** Start the transport, run the handshake (and the sign-in when the server wants one) and return the live client. */
+async function openClient(name, spec, options) {
     const timeout = spec.timeout ? { timeout: spec.timeout } : undefined;
     let client = new Client(CLIENT_INFO, { capabilities: {} });
     const oauth = options.oauth;
@@ -134,9 +162,12 @@ export async function connectOne(name, spec, options = {}) {
             await client.connect(transport, timeout);
         }
     }
-    const { tools: mcpTools } = await client.listTools(undefined, spec.timeout ? { timeout: spec.timeout } : undefined);
-    const tools = mcpTools.map((t) => mcpToolToForgeTool(name, t, client, spec.timeout));
-    return { name, client, tools, instructions: client.getInstructions()?.trim() || undefined };
+    return client;
+}
+/** A call that failed because the server's process or connection is gone, not because the call itself was bad. */
+function isConnectionLost(err) {
+    const e = err;
+    return e?.code === -32000 || (typeof e?.message === 'string' && /connection closed|not connected/i.test(e.message));
 }
 /**
  * Pick the right SDK transport for the server spec. The transport type is
@@ -193,8 +224,36 @@ export async function closeAll(servers) {
  * namespace of the built-in tools and tells the model which server a tool
  * came from at a glance.
  */
-function mcpToolToForgeTool(serverName, mcpTool, client, timeout) {
-    const fullName = `mcp__${serverName}__${mcpTool.name}`;
+const MAX_TOOL_NAME = 64;
+const MAX_SERVER_PART = 30;
+function cleanNamePart(s) {
+    return s.replace(/[^a-zA-Z0-9_-]/g, '_');
+}
+function shortHash(s) {
+    return createHash('sha256').update(s).digest('hex').slice(0, 8);
+}
+/** The start of every tool name of one server. Names a provider accepts only: letters, digits, `_` and `-`. */
+export function mcpToolPrefix(serverName) {
+    return `mcp__${cleanNamePart(serverName).slice(0, MAX_SERVER_PART)}__`;
+}
+/**
+ * The name the model sees for a server's tool. OpenAI and Anthropic refuse a tool name with any other character or
+ * over 64 characters, and one refused name fails the whole request. A name that needed cleaning or cutting gets a
+ * short hash of the original pair so two different tools never become one; the call itself still uses the server's
+ * own tool name.
+ */
+export function mcpToolName(serverName, toolName) {
+    const prefix = mcpToolPrefix(serverName);
+    const body = cleanNamePart(toolName);
+    const name = prefix + body;
+    const untouched = prefix === `mcp__${serverName}__` && body === toolName && name.length <= MAX_TOOL_NAME;
+    if (untouched)
+        return name;
+    const hash = shortHash(`${serverName}\u0000${toolName}`);
+    return `${name.slice(0, MAX_TOOL_NAME - hash.length - 1)}_${hash}`;
+}
+export function mcpToolToForgeTool(serverName, mcpTool, getClient, timeout, reconnect) {
+    const fullName = mcpToolName(serverName, mcpTool.name);
     const description = [
         mcpTool.description ?? '',
         `(MCP server: ${serverName})`,
@@ -210,8 +269,24 @@ function mcpToolToForgeTool(serverName, mcpTool, client, timeout) {
         // destructive so the user gets a confirmation prompt unless --auto.
         destructive: true,
         execute: async (args) => {
-            const result = await client.callTool({ name: mcpTool.name, arguments: args }, undefined, timeout ? { timeout } : undefined);
-            return mcpResultToValue(result);
+            const call = (client) => client.callTool({ name: mcpTool.name, arguments: args }, undefined, timeout ? { timeout } : undefined);
+            let result;
+            try {
+                result = await call(getClient());
+            }
+            catch (err) {
+                // A server that exited is started again for this call, once; any other failure goes to the caller as it is.
+                if (!reconnect || !isConnectionLost(err))
+                    throw err;
+                result = await call(await reconnect());
+            }
+            const value = mcpResultToValue(result);
+            // An MCP server reports a failed call as a normal result with isError set: the model must see a failure.
+            if (result?.isError === true) {
+                const said = typeof value === 'string' ? value : value?.text;
+                throw new Error(said?.trim() || `MCP server "${serverName}" reported an error for ${mcpTool.name}.`);
+            }
+            return value;
         },
     };
 }
@@ -229,16 +304,25 @@ export function mcpResultToValue(result) {
     if (!Array.isArray(r.content)) {
         return { ...r };
     }
-    const text = r.content
-        .filter((c) => typeof c === 'object' && c !== null && c.type === 'text')
-        .map((c) => c.text)
-        .join('\n');
-    const other = r.content.filter((c) => {
-        const t = typeof c === 'object' && c !== null ? c.type : undefined;
-        return t !== 'text';
-    });
-    if (other.length === 0) {
-        return text;
+    const texts = [];
+    let image;
+    let omitted = 0;
+    for (const c of r.content) {
+        const b = (typeof c === 'object' && c !== null ? c : {});
+        if (b.type === 'text' && typeof b.text === 'string')
+            texts.push(b.text);
+        else if (b.type === 'resource' && typeof b.resource?.text === 'string')
+            texts.push(b.resource.text);
+        // The first image goes to the model as media (like `read_image`); more images, audio and binary resources do not.
+        else if (b.type === 'image' && !image && typeof b.data === 'string' && b.mimeType?.startsWith('image/'))
+            image = { data: b.data, mime: b.mimeType };
+        else
+            omitted++;
     }
-    return { text, content: r.content, isError: r.isError };
+    if (omitted > 0)
+        texts.push(`[${omitted} non-text ${omitted === 1 ? 'item' : 'items'} omitted]`);
+    const text = clampOutput(texts.join('\n'));
+    if (!image)
+        return text;
+    return { text, dataUrl: `data:${image.mime};base64,${image.data}`, mime: image.mime, bytes: Math.floor((image.data.length * 3) / 4), path: 'MCP tool result' };
 }

package/dist/memory/session-digest.js

@@ -1,4 +1,5 @@
 import { generateText } from 'ai';
+import { withModelRetry } from '../agent/retry.js';
 import { stripThinkTags } from '../agent/think-tags.js';
 import { createLanguageModel } from '../providers.js';
 const MAX_DIGEST_CHARS = 600;
@@ -38,7 +39,7 @@ export async function generateSessionDigest(items, model, modelFactory = createL
     if (!model || !shouldDigest(items))
         return undefined;
     try {
-        const result = await generateText({ model: modelFactory(model), prompt: `${INSTRUCTION}\n\nConversation:\n${transcript(items)}` });
+        const result = await withModelRetry(() => generateText({ model: modelFactory(model), prompt: `${INSTRUCTION}\n\nConversation:\n${transcript(items)}`, maxRetries: 0 }));
         return cleanDigest(result.text);
     }
     catch {

package/dist/orchestrator/specialists-registry.js

@@ -134,6 +134,9 @@ export function loadSpecialistsFromConfig(configPath, options = {}) {
             out.warnings.push({ message: 'Skipped non-object entry' });
             continue;
         }
+        // A word-for-word copy would shadow the built-in and keep it at the version that was copied (RB-54).
+        if (isBuiltinCopy(entry))
+            continue;
         try {
             registerSpecialist(entry, { override: options.override ?? true, configDir });
             out.registered.push(entry.id);
@@ -166,9 +169,19 @@ export async function saveSpecialistsToConfig(entries, configPath) {
     for (const entry of entries) {
         validateSpecialistConfig(entry, configDir);
     }
-    const file = { version: 1, specialists: entries };
+    // A word-for-word copy of a built-in would shadow it and freeze it at this version (RB-54). Drop it, and say
+    // where the call came from: nothing in Forge is meant to write one, so the stack names whoever does.
+    const copies = entries.filter(isBuiltinCopy);
+    if (copies.length > 0) {
+        console.warn(`forge: not saving ${copies.map((c) => c.id).join(', ')}: word-for-word copies of built-in agents.\n${new Error().stack ?? ''}`);
+    }
+    const file = { version: 1, specialists: entries.filter((e) => !isBuiltinCopy(e)) };
     await updateJsonFile(path, () => file);
 }
+/** Same id and same prompt as a built-in: a copy, not the person's own agent. */
+function isBuiltinCopy(entry) {
+    return BUILTIN_SPECIALISTS.some((b) => b.id === entry.id && b.systemPrompt === entry.systemPrompt);
+}
 /**
  * Pure validator: returns a normalized {@link SpecialistConfig}.
  * Throws on any rule violation with a descriptive message. Library

package/dist/orchestrator/specialists.js

@@ -49,7 +49,7 @@ Stop when: you have read enough to name every file and function in the plan. Do
 
 Never: write or edit files, run commands, or plan around code you have not read. If the request is unclear and the answer would change the plan, put it under Questions instead of guessing.`,
         allowedTools: ['read_file', 'list_files', 'search_files', 'find_symbol', 'find_references', 'list_symbols', 'git_diff', 'memory_read', 'todo_write'],
-        forbiddenTools: ['write_file', 'edit_file', 'apply_patch', 'edit_notebook', 'run_command', 'sub_agent'],
+        forbiddenTools: ['write_file', 'edit_file', 'apply_patch', 'edit_notebook', 'run_command', 'bg_start', 'repo_clone', 'suggest_plan', 'sub_agent'],
         maxIterations: 25,
         auto: false,
     },
@@ -129,7 +129,7 @@ Output:
 
 Never: change files, run commands, or state something about this code that you did not read.`,
         allowedTools: ['read_file', 'list_files', 'search_files', 'find_symbol', 'find_references', 'list_symbols', 'fetch_url', 'memory_read'],
-        forbiddenTools: ['write_file', 'edit_file', 'apply_patch', 'edit_notebook', 'run_command', 'sub_agent'],
+        forbiddenTools: ['write_file', 'edit_file', 'apply_patch', 'edit_notebook', 'run_command', 'bg_start', 'repo_clone', 'suggest_plan', 'sub_agent'],
         maxIterations: 15,
         auto: false,
     },
@@ -156,7 +156,7 @@ Report at most ten findings. End with one line: how many hunks you reviewed and
 
 Never: change files, run commands, or report something you did not confirm in the code.`,
         allowedTools: ['read_file', 'list_files', 'search_files', 'find_symbol', 'find_references', 'list_symbols', 'git_diff', 'memory_read'],
-        forbiddenTools: ['write_file', 'edit_file', 'apply_patch', 'edit_notebook', 'run_command', 'sub_agent'],
+        forbiddenTools: ['write_file', 'edit_file', 'apply_patch', 'edit_notebook', 'run_command', 'bg_start', 'repo_clone', 'suggest_plan', 'sub_agent'],
         maxIterations: 20,
         auto: false,
     },

package/dist/pricing.js

@@ -1,3 +1,4 @@
+import { catalogEntry } from './catalog/models-dev.js';
 import { overrideCost } from './model-overrides.js';
 /**
  * Pricing table. Keys are matched with case-insensitive substring matching
@@ -120,6 +121,17 @@ export function lookupPricing(model, override) {
         return { ...cache, ...configured, known: true };
     if (typeof model !== 'string' && LOCAL_PROVIDERS.has(model.provider))
         return { input: 0, output: 0, known: true };
+    const listed = typeof model === 'string' ? undefined : catalogEntry(model)?.cost;
+    if (listed && listed.input > 0) {
+        return {
+            ...cache,
+            input: listed.input,
+            output: listed.output,
+            ...(listed.cacheRead !== undefined ? { cacheReadMultiplier: listed.cacheRead / listed.input } : {}),
+            ...(listed.cacheWrite !== undefined ? { cacheWriteMultiplier: listed.cacheWrite / listed.input } : {}),
+            known: true,
+        };
+    }
     const id = (typeof model === 'string' ? model : model.model).toLowerCase();
     // Strip only the OpenRouter-style 'models/' prefix so 'models/gemini-1.5-pro'
     // resolves the same way as 'gemini-1.5-pro'. We do NOT strip provider prefixes

package/dist/semantic/embedder.d.ts

@@ -12,7 +12,18 @@ export interface Embedder {
     /** Stable identity. Vectors from different ids are never compared; a change rebuilds the index. */
     id: string;
     embed(texts: string[]): Promise<number[][]>;
+    /** Where the text goes, when it leaves this process: absent for the offline embedder. */
+    remote?: {
+        host: string;
+        model: string;
+        local: boolean;
+    };
 }
+/** The host and model that would receive chunks of code, or undefined when nothing leaves this machine (F12). */
+export declare function embedderDestination(e: Embedder): {
+    host: string;
+    model: string;
+} | undefined;
 export declare function cosine(a: number[], b: number[]): number;
 /** Lowercased sub-tokens: splits camelCase, snake_case, digits and punctuation. */
 export declare function tokenize(text: string): string[];

package/dist/semantic/embedder.js

@@ -8,6 +8,21 @@
  *   `/v1`, LM Studio, vLLM...). Opt-in via `embedderFromEnv`; chunk text is sent
  *   to that endpoint (after secret redaction).
  */
+/** The host and model that would receive chunks of code, or undefined when nothing leaves this machine (F12). */
+export function embedderDestination(e) {
+    return e.remote && !e.remote.local ? { host: e.remote.host, model: e.remote.model } : undefined;
+}
+function remoteOf(baseUrl, model) {
+    let host = baseUrl;
+    try {
+        host = new URL(baseUrl).hostname.replace(/^\[|\]$/g, '');
+    }
+    catch {
+        // an address that is not a URL: report it as written, and treat it as remote
+    }
+    const local = host === 'localhost' || host === '::1' || /^127\./.test(host);
+    return { host, model, local };
+}
 export function cosine(a, b) {
     let dot = 0;
     let na = 0;
@@ -62,6 +77,7 @@ export function openAiCompatibleEmbedder(options) {
     const batch = options.batchSize ?? 64;
     return {
         id: `openai-compat:${base}:${options.model}`,
+        remote: remoteOf(base, options.model),
         async embed(texts) {
             const out = [];
             for (let i = 0; i < texts.length; i += batch) {