@ikarmic/forge-core 5.3.0 → 5.4.0

package/dist/github/pr.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Pull-request status and creation for a branch (F8), on the REST layer the `github_pr_*` tools use. The host supplies the
+ * token (an environment variable or VS Code's GitHub sign-in); it goes in the Authorization header and nowhere else, so
+ * no error text built here may contain it.
+ */
+import { type GitHubConfig, type RepoRef } from './github-tools.js';
+export interface PullRequestSummary {
+    number: number;
+    url: string;
+    state: 'open' | 'merged' | 'closed';
+    draft: boolean;
+    /** All checks passed, one failed, some still run, or there are none. */
+    checks: 'passing' | 'failing' | 'pending' | 'none';
+    /** The latest review of each reviewer decides: any "changes requested" wins over an approval. */
+    review: 'approved' | 'changes requested' | 'none';
+}
+/** The newest pull request from `branch` (any state), summarized, or null when there is none. */
+export declare function findPullRequest(cfg: GitHubConfig, repo: RepoRef, branch: string, signal?: AbortSignal): Promise<PullRequestSummary | null>;
+/** The repository's default branch, the usual base for a pull request. */
+export declare function defaultBranch(cfg: GitHubConfig, repo: RepoRef, signal?: AbortSignal): Promise<string>;
+export interface NewPullRequest {
+    title: string;
+    body: string;
+    /** The branch with the changes; it must already be pushed. */
+    head: string;
+    base: string;
+    /** Default true: nobody is asked to review until the author says so. */
+    draft?: boolean;
+}
+export declare function openPullRequest(cfg: GitHubConfig, repo: RepoRef, input: NewPullRequest, signal?: AbortSignal): Promise<{
+    number: number;
+    url: string;
+    draft: boolean;
+}>;

package/dist/github/pr.js

@@ -0,0 +1,70 @@
+/**
+ * Pull-request status and creation for a branch (F8), on the REST layer the `github_pr_*` tools use. The host supplies the
+ * token (an environment variable or VS Code's GitHub sign-in); it goes in the Authorization header and nowhere else, so
+ * no error text built here may contain it.
+ */
+import { githubApi } from './github-tools.js';
+const FAILED = new Set(['failure', 'timed_out', 'cancelled', 'action_required', 'startup_failure']);
+function checksOf(runs) {
+    if (runs.length === 0)
+        return 'none';
+    if (runs.some((r) => r.status !== 'completed'))
+        return runs.some((r) => FAILED.has(String(r.conclusion))) ? 'failing' : 'pending';
+    return runs.some((r) => FAILED.has(String(r.conclusion))) ? 'failing' : 'passing';
+}
+function reviewOf(reviews) {
+    const latest = new Map();
+    for (const r of reviews) {
+        const state = String(r.state);
+        // A comment does not replace an earlier verdict.
+        if (state !== 'APPROVED' && state !== 'CHANGES_REQUESTED')
+            continue;
+        latest.set(String(r.user?.login ?? 'unknown'), state);
+    }
+    const states = [...latest.values()];
+    if (states.includes('CHANGES_REQUESTED'))
+        return 'changes requested';
+    return states.includes('APPROVED') ? 'approved' : 'none';
+}
+/** The newest pull request from `branch` (any state), summarized, or null when there is none. */
+export async function findPullRequest(cfg, repo, branch, signal) {
+    const base = `/repos/${repo.owner}/${repo.repo}`;
+    const found = (await githubApi(cfg, repo, 'GET', `${base}/pulls?state=all&head=${encodeURIComponent(`${repo.owner}:${branch}`)}&per_page=1`, undefined, signal));
+    const pr = Array.isArray(found) ? found[0] : undefined;
+    if (!pr)
+        return null;
+    const number = pr.number;
+    const sha = pr.head?.sha;
+    const [runs, reviews] = await Promise.all([
+        sha ? githubApi(cfg, repo, 'GET', `${base}/commits/${sha}/check-runs?per_page=50`, undefined, signal).catch(() => ({ check_runs: [] })) : { check_runs: [] },
+        githubApi(cfg, repo, 'GET', `${base}/pulls/${number}/reviews?per_page=50`, undefined, signal).catch(() => []),
+    ]);
+    return {
+        number,
+        url: String(pr.html_url ?? ''),
+        state: pr.merged_at ? 'merged' : pr.state === 'closed' ? 'closed' : 'open',
+        draft: pr.draft === true,
+        checks: checksOf(runs.check_runs ?? []),
+        review: reviewOf(Array.isArray(reviews) ? reviews : []),
+    };
+}
+/** The repository's default branch, the usual base for a pull request. */
+export async function defaultBranch(cfg, repo, signal) {
+    const data = (await githubApi(cfg, repo, 'GET', `/repos/${repo.owner}/${repo.repo}`, undefined, signal));
+    return String(data.default_branch ?? 'main');
+}
+export async function openPullRequest(cfg, repo, input, signal) {
+    if (input.head === input.base)
+        throw new Error(`the head branch is the base branch (${input.head}); work on a separate branch`);
+    try {
+        const pr = (await githubApi(cfg, repo, 'POST', `/repos/${repo.owner}/${repo.repo}/pulls`, { title: input.title, body: input.body, head: input.head, base: input.base, draft: input.draft ?? true }, signal));
+        return { number: pr.number, url: String(pr.html_url), draft: pr.draft === true };
+    }
+    catch (err) {
+        const msg = err.message;
+        if (/HTTP 422/.test(msg) && /head|not.*found|No commits|invalid/i.test(msg)) {
+            throw new Error(`${msg}. Is ${input.head} pushed and ahead of ${input.base}? Push it with: git push -u origin ${input.head}`);
+        }
+        throw err;
+    }
+}

package/dist/human-text.d.ts

@@ -0,0 +1,6 @@
+/** `max_iterations`, `perChat` and `on-network` become "Max iterations", "Per chat" and "On network". */
+export declare function humanize(id: string): string;
+/** The name of a tool as a person would say it. */
+export declare function toolLabel(name: string): string;
+/** Why a run ended, for a line a person reads. */
+export declare function runReasonLabel(reason: string): string;

package/dist/human-text.js

@@ -0,0 +1,37 @@
+const ACRONYMS = { mcp: 'MCP', api: 'API', url: 'URL', lsp: 'LSP', ai: 'AI', pr: 'PR', os: 'OS' };
+/** `max_iterations`, `perChat` and `on-network` become "Max iterations", "Per chat" and "On network". */
+export function humanize(id) {
+    const words = id
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .split(/[\s_-]+/)
+        .filter(Boolean)
+        .map((w) => w.toLowerCase());
+    if (words.length === 0)
+        return id;
+    const first = words[0];
+    words[0] = ACRONYMS[first] ?? first.charAt(0).toUpperCase() + first.slice(1);
+    for (let i = 1; i < words.length; i++)
+        words[i] = ACRONYMS[words[i]] ?? words[i];
+    return words.join(' ');
+}
+/** The name of a tool as a person would say it. */
+export function toolLabel(name) {
+    return humanize(name);
+}
+// A Record over the reason type: a new way for a run to end is a compile error until it has words here.
+const RUN_REASONS = {
+    completed: 'Completed',
+    max_iterations: 'Step limit reached',
+    max_duration: 'Time limit reached',
+    budget_exceeded: 'Cost limit reached',
+    loop_detected: 'Stopped: repeating the same step',
+    aborted: 'Stopped',
+    error: 'Failed',
+    no_provider_key: 'No API key',
+    plan: 'Plan ready',
+    spec: 'Spec ready',
+};
+/** Why a run ended, for a line a person reads. */
+export function runReasonLabel(reason) {
+    return RUN_REASONS[reason] ?? humanize(reason);
+}

package/dist/index.d.ts

@@ -4,7 +4,8 @@ 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';
@@ -35,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, 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';
@@ -91,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';
@@ -104,10 +106,13 @@ 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

@@ -3,7 +3,8 @@ 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';
@@ -21,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';
@@ -71,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';
@@ -83,9 +85,11 @@ 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/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