@arnilo/prism-coding-agent 0.0.96 → 0.1.0

package/dist/goal-verify.js

@@ -0,0 +1,280 @@
+import { defineWorkflow, functionNode, resumeWorkflow, runWorkflow, suspend, } from "@arnilo/prism-workflows";
+import { assertCodingResumeAllowed, buildCodingCheckpointMetadata, CODING_STATE_KEY, codingCheckpointStatePatch, codingPlanPathForTask, createCodingPlanMarkdown, fingerprintJson, parseCodingPlanTodos, readCodingCheckpointFromState, readCodingPlanFile, writeCodingPlanFile, } from "./coding-checkpoint.js";
+import { DEFAULT_MAX_CHECK_SUMMARY_BYTES, DEFAULT_MAX_PR_HANDOFF_BYTES } from "./limits.js";
+export const CODING_GOAL_VERIFY_WORKFLOW_ID = "coding-goal-verify";
+export const CODING_GOAL_VERIFY_REVISION = "1";
+export const CODING_GOAL_VERIFY_SUSPEND_REASON = "approve-coding-goal-verify";
+export class CodingGoalVerifyError extends Error {
+    code = "ERR_PRISM_CODING_GOAL_VERIFY";
+    constructor(message) {
+        super(message);
+        this.name = "CodingGoalVerifyError";
+    }
+}
+function requireCoding(state) {
+    const coding = readCodingCheckpointFromState(state);
+    if (!coding)
+        throw new CodingGoalVerifyError("missing state.coding");
+    return coding;
+}
+function clipSummary(summary) {
+    const max = DEFAULT_MAX_CHECK_SUMMARY_BYTES;
+    const bytes = Buffer.from(summary, "utf8");
+    if (bytes.length <= max)
+        return summary;
+    return bytes.subarray(0, max).toString("utf8");
+}
+function normalizeChecks(checks) {
+    return checks.map((check) => ({
+        name: check.name,
+        exitCode: check.exitCode,
+        summary: clipSummary(check.summary),
+    }));
+}
+function assertHandoffBounded(handoff) {
+    const encoded = Buffer.byteLength(JSON.stringify(handoff), "utf8");
+    if (encoded > DEFAULT_MAX_PR_HANDOFF_BYTES) {
+        throw new CodingGoalVerifyError(`handoff exceeds ${DEFAULT_MAX_PR_HANDOFF_BYTES} byte limit (${encoded} bytes)`);
+    }
+}
+function fingerprintsFor(checks) {
+    return {
+        workflowRevision: CODING_GOAL_VERIFY_REVISION,
+        toolFingerprint: fingerprintJson({ tools: ["coding_check", "git_pr_handoff"], checks }),
+        policyFingerprint: fingerprintJson({ requireApproval: [CODING_GOAL_VERIFY_SUSPEND_REASON] }),
+    };
+}
+function defaultTodos(checkNames) {
+    return [
+        { id: "plan", text: "Write goal plan Markdown", done: false },
+        ...checkNames.map((name) => ({ id: `check-${name}`, text: `Run named check ${name}`, done: false })),
+        { id: "handoff", text: "Emit bounded PR handoff", done: false },
+    ];
+}
+function markTodos(todos, doneIds) {
+    return todos.map((todo) => (doneIds.has(todo.id) ? { ...todo, done: true } : todo));
+}
+/** Build the durable DAG used by `runCodingGoalVerify` (exported for hosts that want the definition alone). */
+export function createCodingGoalVerifyWorkflow(options) {
+    const planPath = codingPlanPathForTask(options.taskId);
+    const fps = () => fingerprintsFor(options.checks);
+    const planNode = functionNode({
+        execute: async (ctx) => {
+            const todos = defaultTodos(options.checks);
+            const markdown = createCodingPlanMarkdown({
+                title: options.title,
+                taskId: options.taskId,
+                status: "planned",
+                todos,
+                notes: options.goal,
+            });
+            const plan = await writeCodingPlanFile({
+                workspaceRoot: options.cwd,
+                planPath,
+                markdown,
+            });
+            const metadata = buildCodingCheckpointMetadata({
+                taskId: options.taskId,
+                workspaceRoot: options.cwd,
+                baseBranch: options.baseBranch,
+                branch: options.branch,
+                planPath,
+                plan,
+                fingerprints: fps(),
+                todos: parseCodingPlanTodos(markdown),
+                status: "planned",
+            });
+            await ctx.updateState(codingCheckpointStatePatch(metadata), { mode: "merge" });
+            return { planPath, planSha256: plan.sha256 };
+        },
+    });
+    const verifyNode = functionNode({
+        execute: async (ctx) => {
+            const coding = requireCoding(ctx.state);
+            const checks = normalizeChecks(await Promise.all(options.checks.map((name) => options.runCheck(name))));
+            const failed = checks.some((check) => check.exitCode !== 0);
+            const done = new Set(["plan", ...options.checks.map((name) => `check-${name}`)]);
+            const todos = markTodos(coding.todos.length ? coding.todos : defaultTodos(options.checks), done);
+            const markdown = createCodingPlanMarkdown({
+                title: options.title,
+                taskId: options.taskId,
+                status: failed ? "awaiting_approval" : "ready_for_handoff",
+                todos,
+                notes: options.goal,
+            });
+            const plan = await writeCodingPlanFile({
+                workspaceRoot: options.cwd,
+                planPath,
+                markdown,
+            });
+            const next = buildCodingCheckpointMetadata({
+                ...coding,
+                plan,
+                checks,
+                todos: parseCodingPlanTodos(markdown),
+                status: failed ? "awaiting_approval" : "ready_for_handoff",
+                fingerprints: fps(),
+                updatedAt: new Date().toISOString(),
+            });
+            await ctx.updateState(codingCheckpointStatePatch(next), { mode: "merge" });
+            return { checks, failed };
+        },
+    });
+    const reviewNode = functionNode({
+        execute: async (ctx) => {
+            const coding = requireCoding(ctx.state);
+            const failed = coding.checks.some((check) => check.exitCode !== 0);
+            if (!failed)
+                return { approved: true, skipped: true };
+            if (!ctx.resume) {
+                return suspend({
+                    reason: options.suspendReason,
+                    data: {
+                        taskId: coding.taskId,
+                        branch: coding.branch,
+                        planSha256: coding.plan.sha256,
+                        checks: coding.checks,
+                    },
+                    resumeSchema: {
+                        type: "object",
+                        required: ["reviewer"],
+                        properties: { reviewer: { type: "string" } },
+                    },
+                });
+            }
+            const reviewer = ctx.resume.input?.reviewer ?? "unknown";
+            return { approved: true, reviewer, planSha256: coding.plan.sha256 };
+        },
+    });
+    const handoffNode = functionNode({
+        execute: async (ctx) => {
+            const coding = requireCoding(ctx.state);
+            const planFile = await readCodingPlanFile({
+                workspaceRoot: options.cwd,
+                planPath: coding.planPath,
+                expected: coding.plan,
+            });
+            assertCodingResumeAllowed({
+                metadata: coding,
+                expected: fps(),
+                expectedWorkspaceRoot: options.cwd,
+                expectedBaseBranch: options.baseBranch,
+                planBytes: Buffer.from(planFile.markdown, "utf8"),
+            });
+            const handoff = await options.buildHandoff({ coding, checks: coding.checks });
+            assertHandoffBounded(handoff);
+            const todos = markTodos(coding.todos.length ? coding.todos : defaultTodos(options.checks), new Set(["plan", "handoff", ...options.checks.map((name) => `check-${name}`)]));
+            const markdown = createCodingPlanMarkdown({
+                title: options.title,
+                taskId: options.taskId,
+                status: "completed",
+                todos,
+                notes: options.goal,
+            });
+            const plan = await writeCodingPlanFile({
+                workspaceRoot: options.cwd,
+                planPath,
+                markdown,
+            });
+            const next = buildCodingCheckpointMetadata({
+                ...coding,
+                plan,
+                handoff,
+                todos: parseCodingPlanTodos(markdown),
+                status: "completed",
+                fingerprints: fps(),
+                updatedAt: new Date().toISOString(),
+            });
+            await ctx.updateState(codingCheckpointStatePatch(next), { mode: "merge" });
+            return { handoff, codingStatus: next.status };
+        },
+    });
+    return defineWorkflow({
+        revision: CODING_GOAL_VERIFY_REVISION,
+        id: CODING_GOAL_VERIFY_WORKFLOW_ID,
+        nodes: {
+            plan: planNode,
+            verify: verifyNode,
+            review: reviewNode,
+            handoff: handoffNode,
+        },
+        edges: [
+            ["plan", "verify"],
+            ["verify", "review"],
+            ["review", "handoff"],
+        ],
+        limits: { maxConcurrency: 1, maxStateBytes: 64 * 1024 },
+    });
+}
+/**
+ * Run (or resume) a thin goal→verify coding composition.
+ * Fails closed when `approval` / `approval.validateResume` is missing.
+ */
+export async function runCodingGoalVerify(options) {
+    if (!options.approval?.validateResume) {
+        throw new CodingGoalVerifyError("approval.validateResume is required");
+    }
+    if (!Array.isArray(options.checks) || options.checks.length < 1) {
+        throw new CodingGoalVerifyError("checks must declare at least one named check");
+    }
+    for (const name of options.checks) {
+        if (typeof name !== "string" || !/^[A-Za-z][A-Za-z0-9_-]{0,63}$/.test(name)) {
+            throw new CodingGoalVerifyError(`invalid check name: ${String(name)}`);
+        }
+    }
+    if (typeof options.runCheck !== "function") {
+        throw new CodingGoalVerifyError("runCheck is required");
+    }
+    if (typeof options.buildHandoff !== "function") {
+        throw new CodingGoalVerifyError("buildHandoff is required");
+    }
+    if (typeof options.goal !== "string" || options.goal.trim().length < 1) {
+        throw new CodingGoalVerifyError("goal is required");
+    }
+    if (typeof options.cwd !== "string" || options.cwd.length < 1) {
+        throw new CodingGoalVerifyError("cwd is required");
+    }
+    const taskId = options.taskId ?? "goal";
+    const title = options.title ?? options.goal.slice(0, 120);
+    const baseBranch = options.baseBranch ?? "main";
+    const branch = options.branch ?? `codex/${taskId}`;
+    const suspendReason = options.approval.reason ?? CODING_GOAL_VERIFY_SUSPEND_REASON;
+    const workflow = createCodingGoalVerifyWorkflow({
+        goal: options.goal,
+        cwd: options.cwd,
+        taskId,
+        title,
+        baseBranch,
+        branch,
+        checks: options.checks,
+        runCheck: options.runCheck,
+        buildHandoff: options.buildHandoff,
+        suspendReason,
+    });
+    const validateState = async (input) => {
+        if (CODING_STATE_KEY in input.value) {
+            readCodingCheckpointFromState(input.value);
+        }
+    };
+    const shared = {
+        checkpoints: options.checkpoints,
+        redactor: options.redactor,
+        ownership: options.ownership,
+        validateState,
+        validateResume: options.approval.validateResume,
+        signal: options.signal,
+        onEvent: options.onEvent,
+    };
+    if (options.resume) {
+        return resumeWorkflow(workflow, { runId: options.resume.runId, workflowId: workflow.id }, {
+            ...shared,
+            resume: {
+                decision: options.resume.decision,
+                expectedVersion: options.resume.expectedVersion,
+                input: options.resume.input,
+            },
+        });
+    }
+    return runWorkflow(workflow, { goal: options.goal, baseBranch }, shared);
+}
+//# sourceMappingURL=goal-verify.js.map

package/dist/index.d.ts

@@ -1,37 +1,65 @@
-export { createShellTool, createLocalBashOperations, getShellConfig, killProcessTree, waitForChildProcess, } from "./shell.js";
-export type { ShellToolOptions, ShellConfig, BashOperations, BashExecOptions, BashSpawnContext, BashSpawnHook, } from "./shell.js";
-export { createReadTool, detectSupportedImageMimeType, detectSupportedImageMimeTypeFromFile, DEFAULT_MAX_IMAGE_BYTES, } from "./read.js";
-export type { ReadToolOptions, ReadOperations, ReadTextOptions, ReadTextResult, TransformImage, TransformImageInput, } from "./read.js";
-export { createWriteTool } from "./write.js";
-export type { WriteToolOptions, WriteOperations } from "./write.js";
+export { createDirectoryArtifactWriter, createTempArtifactWriter, sha256Hex } from "./artifacts.js";
+export type { AskUserDecisionAnswer, AskUserDecisionHandler, AskUserDecisionOption, AskUserDecisionRequest, AskUserDecisionSelectionMode, AskUserDecisionSuspendData, AskUserDecisionToolOptions, ResolvedAskUserDecisionAnswer, ResolvedAskUserDecisionLimits, SuspendAskUserDecisionOptions, } from "./ask-user-decision.js";
+export { ASK_USER_DECISION_RATIONALE_COUNT, ASK_USER_DECISION_SUSPEND_REASON, ASK_USER_DECISION_TOOL_NAME, askUserDecisionResumeSchema, createAskUserDecisionResumeValidator, createAskUserDecisionTool, DEFAULT_MAX_ASK_USER_DECISION_BULLET_BYTES, DEFAULT_MAX_ASK_USER_DECISION_CUSTOM_BYTES, DEFAULT_MAX_ASK_USER_DECISION_LABEL_BYTES, DEFAULT_MAX_ASK_USER_DECISION_OPTIONS, DEFAULT_MAX_ASK_USER_DECISION_QUESTION_BYTES, HARD_MAX_ASK_USER_DECISION_BULLET_BYTES, HARD_MAX_ASK_USER_DECISION_CUSTOM_BYTES, HARD_MAX_ASK_USER_DECISION_LABEL_BYTES, HARD_MAX_ASK_USER_DECISION_OPTIONS, HARD_MAX_ASK_USER_DECISION_QUESTION_BYTES, parseAskUserDecisionArgs, resolveAskUserDecisionAnswer, resolveAskUserDecisionLimits, suspendAskUserDecision, toAskUserDecisionSuspendData, validateAskUserDecisionAgentResume, validateAskUserDecisionResume, } from "./ask-user-decision.js";
+export type { CodingCheckToolOptions, NamedCheckDefinition } from "./checks.js";
+export { createCodingCheckTool } from "./checks.js";
+export type { DeleteOperations, DeleteToolOptions, MutationStat } from "./delete.js";
+export { createDeleteTool } from "./delete.js";
+export type { CodingLifecycleEvent, CodingLifecycleLimits, CodingLifecycleEmitter, CreateCodingLifecycleEmitterOptions, FileChangeOp, FileChangedEvent, WorktreeChangedEvent, PermissionDeniedEvent, ConfigurationChangedEvent, ResolvedCodingLifecycleLimits, } from "./lifecycle.js";
+export { createCodingLifecycleEmitter, CodingLifecycleError, resolveCodingLifecycleLimits, } from "./lifecycle.js";
+export type { CodingArtifactKind, CodingArtifactRef, CodingCheckpointLimitOptions, CodingCheckpointMetadata, CodingCheckSummary, CodingFingerprints, CodingHandoffSummary, CodingTaskStatus, CodingTodoItem, ResolvedCodingCheckpointLimits, } from "./coding-checkpoint.js";
+export { assertCodingResumeAllowed, buildCodingCheckpointMetadata, CODING_CHECKPOINT_SCHEMA_VERSION, CODING_STATE_KEY, CodingCheckpointError, codingCheckpointStatePatch, codingPlanPathForTask, createCodingArtifactRef, createCodingPlanMarkdown, fingerprintJson, parseCodingPlanTodos, readCodingCheckpointFromState, readCodingPlanFile, resolveCodingCheckpointLimits, validateCodingCheckpointMetadata, verifyCodingArtifactBytes, writeCodingPlanFile, } from "./coding-checkpoint.js";
+export type { Edit, EditOperations, EditToolDetails, EditToolOptions } from "./edit.js";
 export { createEditTool } from "./edit.js";
-export type { EditToolOptions, EditOperations, EditToolDetails, Edit } from "./edit.js";
-export { createRepoListTool } from "./list.js";
+export type { CodingEffectReconciliation, CodingEffectReconciliationInput } from "./effects.js";
+export { classifyGitApplyEffect, classifyGitBranchEffect, classifyGitWorktreeEffect, CODING_LOCAL_EFFECT, CODING_OBSERVATION_EFFECT, CODING_UNSUPPORTED_EFFECT, reconcileCodingToolEffect, } from "./effects.js";
+export type { ArtifactReference, ArtifactWriter, BoundGitRunner, CreateGitOperationsOptions, CreateGitRunnerOptions, GitExecRequest, GitExecResult, GitLimitOptions, GitOperations, GitRunner, GitStatusBranch, GitStatusEntry, GitStatusEntryKind, GitStatusResult, PrHandoff, ResolvedGitLimits, } from "./git.js";
+export { createBoundGitRunner, createGitOperations, GitError, parsePorcelainV2, resolveGitLimits, runGitCli, SAFE_GIT_CONFIG_ARGS, SAFE_GIT_ENV, } from "./git.js";
+export type { GitToolsOptions } from "./git-tools.js";
+export { createGitApplyTool, createGitBranchTool, createGitCommitTool, createGitDiffTool, createGitPrHandoffTool, createGitStatusTool, createGitTools, createGitWorktreeTool, } from "./git-tools.js";
+export type { CodingGoalVerifyApproval, RunCodingGoalVerifyOptions, } from "./goal-verify.js";
+export { CODING_GOAL_VERIFY_REVISION, CODING_GOAL_VERIFY_SUSPEND_REASON, CODING_GOAL_VERIFY_WORKFLOW_ID, CodingGoalVerifyError, createCodingGoalVerifyWorkflow, runCodingGoalVerify, } from "./goal-verify.js";
+export type { GlobToolOptions } from "./glob.js";
+export { createGlobTool } from "./glob.js";
+export { matchGlobPattern, validateGlobPattern } from "./glob-match.js";
 export type { ListToolOptions } from "./list.js";
-export { createRepoSearchTool } from "./search.js";
+export { createRepoListTool } from "./list.js";
+export type { MoveOperations, MoveToolOptions } from "./move.js";
+export { createMoveTool } from "./move.js";
+export type { ReadOperations, ReadTextOptions, ReadTextResult, ReadToolOptions, TransformImage, TransformImageInput, } from "./read.js";
+export { createReadTool, DEFAULT_MAX_IMAGE_BYTES, detectSupportedImageMimeType, detectSupportedImageMimeTypeFromFile, } from "./read.js";
+export type { ReadPathSet } from "./read-path-set.js";
+export { createReadPathSet } from "./read-path-set.js";
+export type { RepoEntryKind, RepoListEntry, RepositoryGlobRequest, RepositoryGlobResult, RepositoryLimitOptions, RepositoryListRequest, RepositoryListResult, RepositoryOperations, RepoSearchOutputMode, RepositorySearchMatch, RepositorySearchRequest, RepositorySearchResult, ResolvedRepositoryLimits, RepositoryWalk, RepositoryWalkEvent, RepositoryWalkLimits, } from "./repository.js";
+export { compileSearchPattern, createLocalRepositoryOperations, DEFAULT_REPO_EXCLUDE, isBinaryBuffer, RepositoryError, resolveRepoPath, resolveRepositoryLimits, toRepoRelative, } from "./repository.js";
+export type { GitAwareRepositoryOptions } from "./git-aware-repository.js";
+export { createGitAwareRepositoryOperations, parseGitLsFilesZ } from "./git-aware-repository.js";
+export type { CreateLanguageIntelligenceOptions, LanguageDiagnostic, LanguageIntelligence, LanguageIntelligenceLimits, LanguageLocation, LanguageServerSpec, LanguageSymbol, LanguageTextEdit, LanguageWorkspaceEdit, } from "./language/index.js";
+export { applyTextEdits, createLanguageIntelligence, encodeLspFrame, LanguageIntelligenceError, LspFrameError, LspFrameReader, resolveLanguageIntelligenceLimits, } from "./language/index.js";
+export type { CreateGitHubForgeOptions, ForgeCheck, ForgeCredential, ForgeCredentialResolver, ForgeCredentialResolverSource, ForgeErrorCode, ForgeHandoffReport, ForgeIssueContext, ForgeLimits, ForgeOperations, ForgePullRequest, ResolvedForgeLimits, } from "./forge/index.js";
+export { createGitHubForge, ForgeError, resolveForgeLimits } from "./forge/index.js";
+export type { CodingProcessEvent, CreateProcessSessionsOptions, ProcessExitResult, ProcessOutputChunk, ProcessSandboxBackend, ProcessSandboxHandle, ProcessSandboxStartRequest, ProcessSession, ProcessSessionLimits, ProcessSessionMetadata, ProcessSessions, ProcessSessionState, ProcessStartRequest, ResolvedProcessSessionLimits, } from "./process/index.js";
+export { createProcessSessions, ProcessSessionError, resolveProcessSessionLimits, } from "./process/index.js";
 export type { SearchToolOptions } from "./search.js";
-export { createLocalRepositoryOperations, resolveRepositoryLimits, compileSearchPattern, isBinaryBuffer, resolveRepoPath, toRepoRelative, RepositoryError, DEFAULT_REPO_EXCLUDE, } from "./repository.js";
-export type { RepoEntryKind, RepoListEntry, RepositoryListRequest, RepositoryListResult, RepositorySearchMatch, RepositorySearchRequest, RepositorySearchResult, RepositoryOperations, RepositoryLimitOptions, ResolvedRepositoryLimits, } from "./repository.js";
-export { createGitOperations, resolveGitLimits, parsePorcelainV2, GitError, SAFE_GIT_ENV, SAFE_GIT_CONFIG_ARGS, createBoundGitRunner, runGitCli, } from "./git.js";
-export type { GitOperations, GitLimitOptions, ResolvedGitLimits, ArtifactReference, ArtifactWriter, PrHandoff, CreateGitOperationsOptions, GitStatusResult, GitStatusEntry, GitStatusBranch, GitStatusEntryKind, GitRunner, GitExecRequest, GitExecResult, BoundGitRunner, CreateGitRunnerOptions, } from "./git.js";
-export { createGitTools, createGitStatusTool, createGitDiffTool, createGitBranchTool, createGitWorktreeTool, createGitApplyTool, createGitCommitTool, createGitPrHandoffTool, } from "./git-tools.js";
-export type { GitToolsOptions } from "./git-tools.js";
-export { createCodingCheckTool } from "./checks.js";
-export type { CodingCheckToolOptions, NamedCheckDefinition } from "./checks.js";
-export { createDirectoryArtifactWriter, createTempArtifactWriter, sha256Hex } from "./artifacts.js";
-export { CODING_CHECKPOINT_SCHEMA_VERSION, CODING_STATE_KEY, CodingCheckpointError, assertCodingResumeAllowed, buildCodingCheckpointMetadata, codingCheckpointStatePatch, codingPlanPathForTask, createCodingArtifactRef, createCodingPlanMarkdown, fingerprintJson, parseCodingPlanTodos, readCodingCheckpointFromState, readCodingPlanFile, resolveCodingCheckpointLimits, validateCodingCheckpointMetadata, verifyCodingArtifactBytes, writeCodingPlanFile, } from "./coding-checkpoint.js";
-export type { CodingArtifactKind, CodingArtifactRef, CodingCheckSummary, CodingCheckpointLimitOptions, CodingCheckpointMetadata, CodingFingerprints, CodingHandoffSummary, CodingTaskStatus, CodingTodoItem, ResolvedCodingCheckpointLimits, } from "./coding-checkpoint.js";
-export { withFileMutationQueue } from "./file-mutation-queue.js";
+export { createRepoSearchTool } from "./search.js";
+export type { BashExecOptions, BashOperations, BashSpawnContext, BashSpawnHook, ShellConfig, ShellToolOptions, } from "./shell.js";
+export { createLocalBashOperations, createShellTool, getShellConfig, killProcessTree, waitForChildProcess, } from "./shell.js";
+export type { WriteOperations, WriteToolOptions } from "./write.js";
+export { createWriteTool } from "./write.js";
 export { enforceExecutionPolicy } from "./execution-policy.js";
-export { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_MAX_TEXT_SCAN_BYTES, DEFAULT_MAX_WRITE_BYTES, DEFAULT_MAX_EDIT_FILE_BYTES, DEFAULT_MAX_EDIT_INPUT_BYTES, DEFAULT_MAX_EDITS, DEFAULT_SHELL_TIMEOUT_SECONDS, DEFAULT_MAX_TOTAL_OUTPUT_BYTES, DEFAULT_MAX_REPO_DEPTH, DEFAULT_MAX_REPO_ENTRIES, DEFAULT_MAX_REPO_FILES, DEFAULT_MAX_REPO_RESULTS, DEFAULT_MAX_REPO_CONCURRENCY, DEFAULT_MAX_SEARCH_SCAN_BYTES, DEFAULT_MAX_SEARCH_FILE_BYTES, DEFAULT_MAX_SEARCH_MATCHES, DEFAULT_MAX_SEARCH_PATTERN_BYTES, DEFAULT_MAX_SEARCH_LINE_BYTES, DEFAULT_MAX_SEARCH_CONTEXT_LINES, DEFAULT_MAX_SEARCH_TIME_MS, DEFAULT_MAX_GIT_PATHS, DEFAULT_MAX_GIT_REF_BYTES, DEFAULT_MAX_GIT_MESSAGE_BYTES, DEFAULT_MAX_GIT_OUTPUT_BYTES, DEFAULT_MAX_GIT_DIFF_LINES, DEFAULT_MAX_GIT_CHANGED_FILES, DEFAULT_MAX_GIT_PATCH_BYTES, DEFAULT_MAX_GIT_WORKTREES, DEFAULT_GIT_TIMEOUT_MS, DEFAULT_MAX_CHECK_NAMES, DEFAULT_MAX_CHECK_CONCURRENCY, DEFAULT_CHECK_TIMEOUT_MS, DEFAULT_MAX_CHECK_DIAGNOSTIC_LINES, DEFAULT_MAX_CHECK_OUTPUT_BYTES, DEFAULT_MAX_PR_HANDOFF_BYTES, DEFAULT_MAX_PR_COMMITS, DEFAULT_MAX_PLAN_BYTES, DEFAULT_MAX_TODOS, DEFAULT_MAX_TODO_TEXT_BYTES, DEFAULT_MAX_CODING_ARTIFACTS, DEFAULT_MAX_CODING_ARTIFACT_BYTES, DEFAULT_MAX_CHECK_SUMMARY_BYTES, DEFAULT_MAX_CODING_CHECKPOINT_BYTES, HARD_MAX_BYTES, HARD_MAX_LINES, HARD_MAX_TEXT_SCAN_BYTES, HARD_MAX_IMAGE_BYTES, HARD_MAX_WRITE_BYTES, HARD_MAX_EDIT_FILE_BYTES, HARD_MAX_EDIT_INPUT_BYTES, HARD_MAX_EDITS, HARD_SHELL_TIMEOUT_SECONDS, HARD_MAX_TOTAL_OUTPUT_BYTES, HARD_MAX_REPO_DEPTH, HARD_MAX_REPO_ENTRIES, HARD_MAX_REPO_FILES, HARD_MAX_REPO_RESULTS, HARD_MAX_REPO_CONCURRENCY, HARD_MAX_SEARCH_SCAN_BYTES, HARD_MAX_SEARCH_FILE_BYTES, HARD_MAX_SEARCH_MATCHES, HARD_MAX_SEARCH_PATTERN_BYTES, HARD_MAX_SEARCH_LINE_BYTES, HARD_MAX_SEARCH_CONTEXT_LINES, HARD_MAX_SEARCH_TIME_MS, HARD_MAX_GIT_PATHS, HARD_MAX_GIT_REF_BYTES, HARD_MAX_GIT_MESSAGE_BYTES, HARD_MAX_GIT_OUTPUT_BYTES, HARD_MAX_GIT_DIFF_LINES, HARD_MAX_GIT_CHANGED_FILES, HARD_MAX_GIT_PATCH_BYTES, HARD_MAX_GIT_WORKTREES, HARD_GIT_TIMEOUT_MS, HARD_MAX_CHECK_NAMES, HARD_MAX_CHECK_CONCURRENCY, HARD_CHECK_TIMEOUT_MS, HARD_MAX_CHECK_DIAGNOSTIC_LINES, HARD_MAX_CHECK_OUTPUT_BYTES, HARD_MAX_PR_HANDOFF_BYTES, HARD_MAX_PR_COMMITS, HARD_MAX_PLAN_BYTES, HARD_MAX_TODOS, HARD_MAX_TODO_TEXT_BYTES, HARD_MAX_CODING_ARTIFACTS, HARD_MAX_CODING_ARTIFACT_BYTES, HARD_MAX_CHECK_SUMMARY_BYTES, HARD_MAX_CODING_CHECKPOINT_BYTES, } from "./limits.js";
+export { withFileMutationQueue } from "./file-mutation-queue.js";
+export { DEFAULT_CHECK_TIMEOUT_MS, DEFAULT_GIT_TIMEOUT_MS, DEFAULT_MAX_BYTES, DEFAULT_MAX_CHECK_CONCURRENCY, DEFAULT_MAX_CHECK_DIAGNOSTIC_LINES, DEFAULT_MAX_CHECK_NAMES, DEFAULT_MAX_CHECK_OUTPUT_BYTES, DEFAULT_MAX_CHECK_SUMMARY_BYTES, DEFAULT_MAX_CODING_ARTIFACT_BYTES, DEFAULT_MAX_CODING_ARTIFACTS, DEFAULT_MAX_CODING_CHECKPOINT_BYTES, DEFAULT_MAX_EDIT_FILE_BYTES, DEFAULT_MAX_EDIT_INPUT_BYTES, DEFAULT_MAX_EDITS, DEFAULT_MAX_FORGE_COMMENTS_PER_REVIEW, DEFAULT_MAX_FORGE_PAGES_PER_OPERATION, DEFAULT_MAX_FORGE_PAYLOAD_BYTES, DEFAULT_MAX_FORGE_REQUEST_CONCURRENCY, DEFAULT_MAX_FORGE_REQUEST_TIMEOUT_MS, DEFAULT_MAX_GIT_CHANGED_FILES, DEFAULT_MAX_GIT_DIFF_LINES, DEFAULT_MAX_GIT_MESSAGE_BYTES, DEFAULT_MAX_GIT_OUTPUT_BYTES, DEFAULT_MAX_LS_FILES_OUTPUT_BYTES, DEFAULT_MAX_LSP_DIAGNOSTICS_PER_FILE, DEFAULT_MAX_LSP_MESSAGE_BYTES, DEFAULT_MAX_LSP_PENDING_REQUESTS, DEFAULT_MAX_LSP_RESULTS_PER_QUERY, DEFAULT_MAX_LSP_SERVERS, DEFAULT_MAX_LSP_TIMEOUT_MS, DEFAULT_MAX_GIT_PATCH_BYTES, DEFAULT_MAX_GIT_PATHS, DEFAULT_MAX_GIT_REF_BYTES, DEFAULT_MAX_GIT_WORKTREES, DEFAULT_MAX_LINES, DEFAULT_MAX_PLAN_BYTES, DEFAULT_MAX_PR_COMMITS, DEFAULT_MAX_PR_HANDOFF_BYTES, DEFAULT_MAX_PROCESS_INPUT_BYTES, DEFAULT_MAX_PROCESS_LIFETIME_MS, DEFAULT_MAX_PROCESS_OUTPUT_CHUNK_BYTES, DEFAULT_MAX_PROCESS_SESSIONS, DEFAULT_MAX_PROCESS_TOTAL_OUTPUT_BYTES, DEFAULT_MAX_REPO_CONCURRENCY, DEFAULT_MAX_REPO_DEPTH, DEFAULT_MAX_REPO_ENTRIES, DEFAULT_MAX_REPO_FILES, DEFAULT_MAX_REPO_RESULTS, DEFAULT_MAX_SEARCH_CONTEXT_LINES, DEFAULT_MAX_SEARCH_FILE_BYTES, DEFAULT_MAX_SEARCH_LINE_BYTES, DEFAULT_MAX_SEARCH_MATCHES, DEFAULT_MAX_SEARCH_PATTERN_BYTES, DEFAULT_MAX_SEARCH_SCAN_BYTES, DEFAULT_MAX_SEARCH_TIME_MS, DEFAULT_MAX_TEXT_SCAN_BYTES, DEFAULT_MAX_TODO_TEXT_BYTES, DEFAULT_MAX_TODOS, DEFAULT_MAX_TOTAL_OUTPUT_BYTES, DEFAULT_MAX_WRITE_BYTES, DEFAULT_SHELL_TIMEOUT_SECONDS, HARD_CHECK_TIMEOUT_MS, HARD_GIT_TIMEOUT_MS, HARD_MAX_BYTES, HARD_MAX_CHECK_CONCURRENCY, HARD_MAX_CHECK_DIAGNOSTIC_LINES, HARD_MAX_CHECK_NAMES, HARD_MAX_CHECK_OUTPUT_BYTES, HARD_MAX_CHECK_SUMMARY_BYTES, HARD_MAX_CODING_ARTIFACT_BYTES, HARD_MAX_CODING_ARTIFACTS, HARD_MAX_CODING_CHECKPOINT_BYTES, HARD_MAX_EDIT_FILE_BYTES, HARD_MAX_EDIT_INPUT_BYTES, HARD_MAX_EDITS, HARD_MAX_FORGE_COMMENTS_PER_REVIEW, HARD_MAX_FORGE_PAGES_PER_OPERATION, HARD_MAX_FORGE_PAYLOAD_BYTES, HARD_MAX_FORGE_REQUEST_CONCURRENCY, HARD_MAX_FORGE_REQUEST_TIMEOUT_MS, HARD_MAX_GIT_CHANGED_FILES, HARD_MAX_GIT_DIFF_LINES, HARD_MAX_GIT_MESSAGE_BYTES, HARD_MAX_GIT_OUTPUT_BYTES, HARD_MAX_LS_FILES_OUTPUT_BYTES, HARD_MAX_LSP_DIAGNOSTICS_PER_FILE, HARD_MAX_LSP_MESSAGE_BYTES, HARD_MAX_LSP_PENDING_REQUESTS, HARD_MAX_LSP_RESULTS_PER_QUERY, HARD_MAX_LSP_SERVERS, HARD_MAX_LSP_TIMEOUT_MS, HARD_MAX_GIT_PATCH_BYTES, HARD_MAX_GIT_PATHS, HARD_MAX_GIT_REF_BYTES, HARD_MAX_GIT_WORKTREES, HARD_MAX_IMAGE_BYTES, HARD_MAX_LINES, HARD_MAX_PLAN_BYTES, HARD_MAX_PR_COMMITS, HARD_MAX_PR_HANDOFF_BYTES, HARD_MAX_PROCESS_INPUT_BYTES, HARD_MAX_PROCESS_LIFETIME_MS, HARD_MAX_PROCESS_OUTPUT_CHUNK_BYTES, HARD_MAX_PROCESS_SESSIONS, HARD_MAX_PROCESS_TOTAL_OUTPUT_BYTES, HARD_MAX_REPO_CONCURRENCY, HARD_MAX_REPO_DEPTH, HARD_MAX_REPO_ENTRIES, HARD_MAX_REPO_FILES, HARD_MAX_REPO_RESULTS, HARD_MAX_SEARCH_CONTEXT_LINES, HARD_MAX_SEARCH_FILE_BYTES, HARD_MAX_SEARCH_LINE_BYTES, HARD_MAX_SEARCH_MATCHES, HARD_MAX_SEARCH_PATTERN_BYTES, HARD_MAX_SEARCH_SCAN_BYTES, HARD_MAX_SEARCH_TIME_MS, HARD_MAX_TEXT_SCAN_BYTES, HARD_MAX_TODO_TEXT_BYTES, HARD_MAX_TODOS, HARD_MAX_TOTAL_OUTPUT_BYTES, HARD_MAX_WRITE_BYTES, HARD_SHELL_TIMEOUT_SECONDS, LSP_RESTARTS_PER_SERVER, } from "./limits.js";
 import type { ExecutionPolicy, ToolDefinition } from "@arnilo/prism";
-import type { ShellToolOptions } from "./shell.js";
-import type { ReadToolOptions } from "./read.js";
-import type { WriteToolOptions } from "./write.js";
+import type { DeleteToolOptions } from "./delete.js";
 import type { EditToolOptions } from "./edit.js";
+import type { GlobToolOptions } from "./glob.js";
 import type { ListToolOptions } from "./list.js";
-import type { SearchToolOptions } from "./search.js";
+import type { MoveToolOptions } from "./move.js";
+import type { ReadToolOptions } from "./read.js";
 import type { RepositoryLimitOptions, RepositoryOperations } from "./repository.js";
+import type { SearchToolOptions } from "./search.js";
+import type { ShellToolOptions } from "./shell.js";
+import type { WriteToolOptions } from "./write.js";
 /** Per-tool options combined for the aggregator factories. */
 export interface ToolsOptions {
     /** Shared execution policy applied to every coding tool unless overridden per tool. */
@@ -40,22 +68,27 @@ export interface ToolsOptions {
     read?: ReadToolOptions;
     write?: WriteToolOptions;
     edit?: EditToolOptions;
+    delete?: DeleteToolOptions;
+    move?: MoveToolOptions;
     list?: ListToolOptions;
     search?: SearchToolOptions;
+    glob?: GlobToolOptions;
     /**
-     * Shared repository limits/backends for `repo_list` / `repo_search`.
-     * Per-tool `list` / `search` options override these when both are set.
+     * Shared repository limits/backends for `repo_list` / `repo_search` / `glob`.
+     * Per-tool `list` / `search` / `glob` options override these when both are set.
      */
     repository?: RepositoryLimitOptions & {
         operations?: RepositoryOperations;
     };
 }
 /**
- * Full coding tool set: `shell`, `read`, `write`, `edit`, `repo_list`, `repo_search`.
+ * Full coding tool set: `shell`, `read`, `write`, `edit`, `repo_list`, `repo_search`, `glob`, `delete`, `move`.
+ * Opt-in tools (`createGitTools`, `createAskUserDecisionTool`, `createCodingCheckTool`)
+ * stay out — hosts register them explicitly.
  */
 export declare function createCodingTools(cwd: string, options?: ToolsOptions): readonly ToolDefinition[];
 /**
- * Read-only subset: `read`, `repo_list`, `repo_search`.
+ * Read-only subset: `read`, `repo_list`, `repo_search`, `glob`.
  * Deliberate 0.0.9 expansion from the previous `read`-only set.
  */
 export declare function createReadOnlyTools(cwd: string, options?: ToolsOptions): readonly ToolDefinition[];

package/dist/index.js

@@ -4,28 +4,44 @@
 // `ToolDefinition`s that hosts register into a `ToolRegistry` (e.g.
 // `createToolRegistry(createCodingTools(cwd))`). No tools are auto-registered — import what you need.
 // --- per-tool factories & types ---
-export { createShellTool, createLocalBashOperations, getShellConfig, killProcessTree, waitForChildProcess, } from "./shell.js";
-export { createReadTool, detectSupportedImageMimeType, detectSupportedImageMimeTypeFromFile, DEFAULT_MAX_IMAGE_BYTES, } from "./read.js";
-export { createWriteTool } from "./write.js";
+export { createDirectoryArtifactWriter, createTempArtifactWriter, sha256Hex } from "./artifacts.js";
+export { ASK_USER_DECISION_RATIONALE_COUNT, ASK_USER_DECISION_SUSPEND_REASON, ASK_USER_DECISION_TOOL_NAME, askUserDecisionResumeSchema, createAskUserDecisionResumeValidator, createAskUserDecisionTool, DEFAULT_MAX_ASK_USER_DECISION_BULLET_BYTES, DEFAULT_MAX_ASK_USER_DECISION_CUSTOM_BYTES, DEFAULT_MAX_ASK_USER_DECISION_LABEL_BYTES, DEFAULT_MAX_ASK_USER_DECISION_OPTIONS, DEFAULT_MAX_ASK_USER_DECISION_QUESTION_BYTES, HARD_MAX_ASK_USER_DECISION_BULLET_BYTES, HARD_MAX_ASK_USER_DECISION_CUSTOM_BYTES, HARD_MAX_ASK_USER_DECISION_LABEL_BYTES, HARD_MAX_ASK_USER_DECISION_OPTIONS, HARD_MAX_ASK_USER_DECISION_QUESTION_BYTES, parseAskUserDecisionArgs, resolveAskUserDecisionAnswer, resolveAskUserDecisionLimits, suspendAskUserDecision, toAskUserDecisionSuspendData, validateAskUserDecisionAgentResume, validateAskUserDecisionResume, } from "./ask-user-decision.js";
+export { createCodingCheckTool } from "./checks.js";
+export { createDeleteTool } from "./delete.js";
+export { createCodingLifecycleEmitter, CodingLifecycleError, resolveCodingLifecycleLimits, } from "./lifecycle.js";
+export { assertCodingResumeAllowed, buildCodingCheckpointMetadata, CODING_CHECKPOINT_SCHEMA_VERSION, CODING_STATE_KEY, CodingCheckpointError, codingCheckpointStatePatch, codingPlanPathForTask, createCodingArtifactRef, createCodingPlanMarkdown, fingerprintJson, parseCodingPlanTodos, readCodingCheckpointFromState, readCodingPlanFile, resolveCodingCheckpointLimits, validateCodingCheckpointMetadata, verifyCodingArtifactBytes, writeCodingPlanFile, } from "./coding-checkpoint.js";
 export { createEditTool } from "./edit.js";
+export { classifyGitApplyEffect, classifyGitBranchEffect, classifyGitWorktreeEffect, CODING_LOCAL_EFFECT, CODING_OBSERVATION_EFFECT, CODING_UNSUPPORTED_EFFECT, reconcileCodingToolEffect, } from "./effects.js";
+export { createBoundGitRunner, createGitOperations, GitError, parsePorcelainV2, resolveGitLimits, runGitCli, SAFE_GIT_CONFIG_ARGS, SAFE_GIT_ENV, } from "./git.js";
+export { createGitApplyTool, createGitBranchTool, createGitCommitTool, createGitDiffTool, createGitPrHandoffTool, createGitStatusTool, createGitTools, createGitWorktreeTool, } from "./git-tools.js";
+export { CODING_GOAL_VERIFY_REVISION, CODING_GOAL_VERIFY_SUSPEND_REASON, CODING_GOAL_VERIFY_WORKFLOW_ID, CodingGoalVerifyError, createCodingGoalVerifyWorkflow, runCodingGoalVerify, } from "./goal-verify.js";
+export { createGlobTool } from "./glob.js";
+export { matchGlobPattern, validateGlobPattern } from "./glob-match.js";
 export { createRepoListTool } from "./list.js";
+export { createMoveTool } from "./move.js";
+export { createReadTool, DEFAULT_MAX_IMAGE_BYTES, detectSupportedImageMimeType, detectSupportedImageMimeTypeFromFile, } from "./read.js";
+export { createReadPathSet } from "./read-path-set.js";
+export { compileSearchPattern, createLocalRepositoryOperations, DEFAULT_REPO_EXCLUDE, isBinaryBuffer, RepositoryError, resolveRepoPath, resolveRepositoryLimits, toRepoRelative, } from "./repository.js";
+export { createGitAwareRepositoryOperations, parseGitLsFilesZ } from "./git-aware-repository.js";
+export { applyTextEdits, createLanguageIntelligence, encodeLspFrame, LanguageIntelligenceError, LspFrameError, LspFrameReader, resolveLanguageIntelligenceLimits, } from "./language/index.js";
+export { createGitHubForge, ForgeError, resolveForgeLimits } from "./forge/index.js";
+export { createProcessSessions, ProcessSessionError, resolveProcessSessionLimits, } from "./process/index.js";
 export { createRepoSearchTool } from "./search.js";
-export { createLocalRepositoryOperations, resolveRepositoryLimits, compileSearchPattern, isBinaryBuffer, resolveRepoPath, toRepoRelative, RepositoryError, DEFAULT_REPO_EXCLUDE, } from "./repository.js";
-export { createGitOperations, resolveGitLimits, parsePorcelainV2, GitError, SAFE_GIT_ENV, SAFE_GIT_CONFIG_ARGS, createBoundGitRunner, runGitCli, } from "./git.js";
-export { createGitTools, createGitStatusTool, createGitDiffTool, createGitBranchTool, createGitWorktreeTool, createGitApplyTool, createGitCommitTool, createGitPrHandoffTool, } from "./git-tools.js";
-export { createCodingCheckTool } from "./checks.js";
-export { createDirectoryArtifactWriter, createTempArtifactWriter, sha256Hex } from "./artifacts.js";
-export { CODING_CHECKPOINT_SCHEMA_VERSION, CODING_STATE_KEY, CodingCheckpointError, assertCodingResumeAllowed, buildCodingCheckpointMetadata, codingCheckpointStatePatch, codingPlanPathForTask, createCodingArtifactRef, createCodingPlanMarkdown, fingerprintJson, parseCodingPlanTodos, readCodingCheckpointFromState, readCodingPlanFile, resolveCodingCheckpointLimits, validateCodingCheckpointMetadata, verifyCodingArtifactBytes, writeCodingPlanFile, } from "./coding-checkpoint.js";
+export { createLocalBashOperations, createShellTool, getShellConfig, killProcessTree, waitForChildProcess, } from "./shell.js";
+export { createWriteTool } from "./write.js";
 // --- generic primitives (re-exported for hosts that want them) ---
-export { withFileMutationQueue } from "./file-mutation-queue.js";
 export { enforceExecutionPolicy } from "./execution-policy.js";
-export { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_MAX_TEXT_SCAN_BYTES, DEFAULT_MAX_WRITE_BYTES, DEFAULT_MAX_EDIT_FILE_BYTES, DEFAULT_MAX_EDIT_INPUT_BYTES, DEFAULT_MAX_EDITS, DEFAULT_SHELL_TIMEOUT_SECONDS, DEFAULT_MAX_TOTAL_OUTPUT_BYTES, DEFAULT_MAX_REPO_DEPTH, DEFAULT_MAX_REPO_ENTRIES, DEFAULT_MAX_REPO_FILES, DEFAULT_MAX_REPO_RESULTS, DEFAULT_MAX_REPO_CONCURRENCY, DEFAULT_MAX_SEARCH_SCAN_BYTES, DEFAULT_MAX_SEARCH_FILE_BYTES, DEFAULT_MAX_SEARCH_MATCHES, DEFAULT_MAX_SEARCH_PATTERN_BYTES, DEFAULT_MAX_SEARCH_LINE_BYTES, DEFAULT_MAX_SEARCH_CONTEXT_LINES, DEFAULT_MAX_SEARCH_TIME_MS, DEFAULT_MAX_GIT_PATHS, DEFAULT_MAX_GIT_REF_BYTES, DEFAULT_MAX_GIT_MESSAGE_BYTES, DEFAULT_MAX_GIT_OUTPUT_BYTES, DEFAULT_MAX_GIT_DIFF_LINES, DEFAULT_MAX_GIT_CHANGED_FILES, DEFAULT_MAX_GIT_PATCH_BYTES, DEFAULT_MAX_GIT_WORKTREES, DEFAULT_GIT_TIMEOUT_MS, DEFAULT_MAX_CHECK_NAMES, DEFAULT_MAX_CHECK_CONCURRENCY, DEFAULT_CHECK_TIMEOUT_MS, DEFAULT_MAX_CHECK_DIAGNOSTIC_LINES, DEFAULT_MAX_CHECK_OUTPUT_BYTES, DEFAULT_MAX_PR_HANDOFF_BYTES, DEFAULT_MAX_PR_COMMITS, DEFAULT_MAX_PLAN_BYTES, DEFAULT_MAX_TODOS, DEFAULT_MAX_TODO_TEXT_BYTES, DEFAULT_MAX_CODING_ARTIFACTS, DEFAULT_MAX_CODING_ARTIFACT_BYTES, DEFAULT_MAX_CHECK_SUMMARY_BYTES, DEFAULT_MAX_CODING_CHECKPOINT_BYTES, HARD_MAX_BYTES, HARD_MAX_LINES, HARD_MAX_TEXT_SCAN_BYTES, HARD_MAX_IMAGE_BYTES, HARD_MAX_WRITE_BYTES, HARD_MAX_EDIT_FILE_BYTES, HARD_MAX_EDIT_INPUT_BYTES, HARD_MAX_EDITS, HARD_SHELL_TIMEOUT_SECONDS, HARD_MAX_TOTAL_OUTPUT_BYTES, HARD_MAX_REPO_DEPTH, HARD_MAX_REPO_ENTRIES, HARD_MAX_REPO_FILES, HARD_MAX_REPO_RESULTS, HARD_MAX_REPO_CONCURRENCY, HARD_MAX_SEARCH_SCAN_BYTES, HARD_MAX_SEARCH_FILE_BYTES, HARD_MAX_SEARCH_MATCHES, HARD_MAX_SEARCH_PATTERN_BYTES, HARD_MAX_SEARCH_LINE_BYTES, HARD_MAX_SEARCH_CONTEXT_LINES, HARD_MAX_SEARCH_TIME_MS, HARD_MAX_GIT_PATHS, HARD_MAX_GIT_REF_BYTES, HARD_MAX_GIT_MESSAGE_BYTES, HARD_MAX_GIT_OUTPUT_BYTES, HARD_MAX_GIT_DIFF_LINES, HARD_MAX_GIT_CHANGED_FILES, HARD_MAX_GIT_PATCH_BYTES, HARD_MAX_GIT_WORKTREES, HARD_GIT_TIMEOUT_MS, HARD_MAX_CHECK_NAMES, HARD_MAX_CHECK_CONCURRENCY, HARD_CHECK_TIMEOUT_MS, HARD_MAX_CHECK_DIAGNOSTIC_LINES, HARD_MAX_CHECK_OUTPUT_BYTES, HARD_MAX_PR_HANDOFF_BYTES, HARD_MAX_PR_COMMITS, HARD_MAX_PLAN_BYTES, HARD_MAX_TODOS, HARD_MAX_TODO_TEXT_BYTES, HARD_MAX_CODING_ARTIFACTS, HARD_MAX_CODING_ARTIFACT_BYTES, HARD_MAX_CHECK_SUMMARY_BYTES, HARD_MAX_CODING_CHECKPOINT_BYTES, } from "./limits.js";
-import { createShellTool } from "./shell.js";
-import { createReadTool } from "./read.js";
-import { createWriteTool } from "./write.js";
+export { withFileMutationQueue } from "./file-mutation-queue.js";
+export { DEFAULT_CHECK_TIMEOUT_MS, DEFAULT_GIT_TIMEOUT_MS, DEFAULT_MAX_BYTES, DEFAULT_MAX_CHECK_CONCURRENCY, DEFAULT_MAX_CHECK_DIAGNOSTIC_LINES, DEFAULT_MAX_CHECK_NAMES, DEFAULT_MAX_CHECK_OUTPUT_BYTES, DEFAULT_MAX_CHECK_SUMMARY_BYTES, DEFAULT_MAX_CODING_ARTIFACT_BYTES, DEFAULT_MAX_CODING_ARTIFACTS, DEFAULT_MAX_CODING_CHECKPOINT_BYTES, DEFAULT_MAX_EDIT_FILE_BYTES, DEFAULT_MAX_EDIT_INPUT_BYTES, DEFAULT_MAX_EDITS, DEFAULT_MAX_FORGE_COMMENTS_PER_REVIEW, DEFAULT_MAX_FORGE_PAGES_PER_OPERATION, DEFAULT_MAX_FORGE_PAYLOAD_BYTES, DEFAULT_MAX_FORGE_REQUEST_CONCURRENCY, DEFAULT_MAX_FORGE_REQUEST_TIMEOUT_MS, DEFAULT_MAX_GIT_CHANGED_FILES, DEFAULT_MAX_GIT_DIFF_LINES, DEFAULT_MAX_GIT_MESSAGE_BYTES, DEFAULT_MAX_GIT_OUTPUT_BYTES, DEFAULT_MAX_LS_FILES_OUTPUT_BYTES, DEFAULT_MAX_LSP_DIAGNOSTICS_PER_FILE, DEFAULT_MAX_LSP_MESSAGE_BYTES, DEFAULT_MAX_LSP_PENDING_REQUESTS, DEFAULT_MAX_LSP_RESULTS_PER_QUERY, DEFAULT_MAX_LSP_SERVERS, DEFAULT_MAX_LSP_TIMEOUT_MS, DEFAULT_MAX_GIT_PATCH_BYTES, DEFAULT_MAX_GIT_PATHS, DEFAULT_MAX_GIT_REF_BYTES, DEFAULT_MAX_GIT_WORKTREES, DEFAULT_MAX_LINES, DEFAULT_MAX_PLAN_BYTES, DEFAULT_MAX_PR_COMMITS, DEFAULT_MAX_PR_HANDOFF_BYTES, DEFAULT_MAX_PROCESS_INPUT_BYTES, DEFAULT_MAX_PROCESS_LIFETIME_MS, DEFAULT_MAX_PROCESS_OUTPUT_CHUNK_BYTES, DEFAULT_MAX_PROCESS_SESSIONS, DEFAULT_MAX_PROCESS_TOTAL_OUTPUT_BYTES, DEFAULT_MAX_REPO_CONCURRENCY, DEFAULT_MAX_REPO_DEPTH, DEFAULT_MAX_REPO_ENTRIES, DEFAULT_MAX_REPO_FILES, DEFAULT_MAX_REPO_RESULTS, DEFAULT_MAX_SEARCH_CONTEXT_LINES, DEFAULT_MAX_SEARCH_FILE_BYTES, DEFAULT_MAX_SEARCH_LINE_BYTES, DEFAULT_MAX_SEARCH_MATCHES, DEFAULT_MAX_SEARCH_PATTERN_BYTES, DEFAULT_MAX_SEARCH_SCAN_BYTES, DEFAULT_MAX_SEARCH_TIME_MS, DEFAULT_MAX_TEXT_SCAN_BYTES, DEFAULT_MAX_TODO_TEXT_BYTES, DEFAULT_MAX_TODOS, DEFAULT_MAX_TOTAL_OUTPUT_BYTES, DEFAULT_MAX_WRITE_BYTES, DEFAULT_SHELL_TIMEOUT_SECONDS, HARD_CHECK_TIMEOUT_MS, HARD_GIT_TIMEOUT_MS, HARD_MAX_BYTES, HARD_MAX_CHECK_CONCURRENCY, HARD_MAX_CHECK_DIAGNOSTIC_LINES, HARD_MAX_CHECK_NAMES, HARD_MAX_CHECK_OUTPUT_BYTES, HARD_MAX_CHECK_SUMMARY_BYTES, HARD_MAX_CODING_ARTIFACT_BYTES, HARD_MAX_CODING_ARTIFACTS, HARD_MAX_CODING_CHECKPOINT_BYTES, HARD_MAX_EDIT_FILE_BYTES, HARD_MAX_EDIT_INPUT_BYTES, HARD_MAX_EDITS, HARD_MAX_FORGE_COMMENTS_PER_REVIEW, HARD_MAX_FORGE_PAGES_PER_OPERATION, HARD_MAX_FORGE_PAYLOAD_BYTES, HARD_MAX_FORGE_REQUEST_CONCURRENCY, HARD_MAX_FORGE_REQUEST_TIMEOUT_MS, HARD_MAX_GIT_CHANGED_FILES, HARD_MAX_GIT_DIFF_LINES, HARD_MAX_GIT_MESSAGE_BYTES, HARD_MAX_GIT_OUTPUT_BYTES, HARD_MAX_LS_FILES_OUTPUT_BYTES, HARD_MAX_LSP_DIAGNOSTICS_PER_FILE, HARD_MAX_LSP_MESSAGE_BYTES, HARD_MAX_LSP_PENDING_REQUESTS, HARD_MAX_LSP_RESULTS_PER_QUERY, HARD_MAX_LSP_SERVERS, HARD_MAX_LSP_TIMEOUT_MS, HARD_MAX_GIT_PATCH_BYTES, HARD_MAX_GIT_PATHS, HARD_MAX_GIT_REF_BYTES, HARD_MAX_GIT_WORKTREES, HARD_MAX_IMAGE_BYTES, HARD_MAX_LINES, HARD_MAX_PLAN_BYTES, HARD_MAX_PR_COMMITS, HARD_MAX_PR_HANDOFF_BYTES, HARD_MAX_PROCESS_INPUT_BYTES, HARD_MAX_PROCESS_LIFETIME_MS, HARD_MAX_PROCESS_OUTPUT_CHUNK_BYTES, HARD_MAX_PROCESS_SESSIONS, HARD_MAX_PROCESS_TOTAL_OUTPUT_BYTES, HARD_MAX_REPO_CONCURRENCY, HARD_MAX_REPO_DEPTH, HARD_MAX_REPO_ENTRIES, HARD_MAX_REPO_FILES, HARD_MAX_REPO_RESULTS, HARD_MAX_SEARCH_CONTEXT_LINES, HARD_MAX_SEARCH_FILE_BYTES, HARD_MAX_SEARCH_LINE_BYTES, HARD_MAX_SEARCH_MATCHES, HARD_MAX_SEARCH_PATTERN_BYTES, HARD_MAX_SEARCH_SCAN_BYTES, HARD_MAX_SEARCH_TIME_MS, HARD_MAX_TEXT_SCAN_BYTES, HARD_MAX_TODO_TEXT_BYTES, HARD_MAX_TODOS, HARD_MAX_TOTAL_OUTPUT_BYTES, HARD_MAX_WRITE_BYTES, HARD_SHELL_TIMEOUT_SECONDS, LSP_RESTARTS_PER_SERVER, } from "./limits.js";
+import { createDeleteTool } from "./delete.js";
 import { createEditTool } from "./edit.js";
+import { createGlobTool } from "./glob.js";
 import { createRepoListTool } from "./list.js";
+import { createMoveTool } from "./move.js";
+import { createReadTool } from "./read.js";
 import { createRepoSearchTool } from "./search.js";
+import { createShellTool } from "./shell.js";
+import { createWriteTool } from "./write.js";
 function withSharedExecutionPolicy(toolOptions, shared) {
     if (!shared)
         return (toolOptions ?? {});
@@ -42,12 +58,15 @@ function withRepositoryDefaults(toolOptions, shared) {
     };
 }
 /**
- * Full coding tool set: `shell`, `read`, `write`, `edit`, `repo_list`, `repo_search`.
+ * Full coding tool set: `shell`, `read`, `write`, `edit`, `repo_list`, `repo_search`, `glob`, `delete`, `move`.
+ * Opt-in tools (`createGitTools`, `createAskUserDecisionTool`, `createCodingCheckTool`)
+ * stay out — hosts register them explicitly.
  */
 export function createCodingTools(cwd, options) {
     const policy = options?.executionPolicy;
     const listOpts = withRepositoryDefaults(options?.list, options?.repository);
     const searchOpts = withRepositoryDefaults(options?.search, options?.repository);
+    const globOpts = withRepositoryDefaults(options?.glob, options?.repository);
     return [
         createShellTool(cwd, withSharedExecutionPolicy(options?.shell, policy)),
         createReadTool(cwd, withSharedExecutionPolicy(options?.read, policy)),
@@ -55,20 +74,25 @@ export function createCodingTools(cwd, options) {
         createEditTool(cwd, withSharedExecutionPolicy(options?.edit, policy)),
         createRepoListTool(cwd, withSharedExecutionPolicy(listOpts, policy)),
         createRepoSearchTool(cwd, withSharedExecutionPolicy(searchOpts, policy)),
+        createGlobTool(cwd, withSharedExecutionPolicy(globOpts, policy)),
+        createDeleteTool(cwd, withSharedExecutionPolicy(options?.delete, policy)),
+        createMoveTool(cwd, withSharedExecutionPolicy(options?.move, policy)),
     ];
 }
 /**
- * Read-only subset: `read`, `repo_list`, `repo_search`.
+ * Read-only subset: `read`, `repo_list`, `repo_search`, `glob`.
  * Deliberate 0.0.9 expansion from the previous `read`-only set.
  */
 export function createReadOnlyTools(cwd, options) {
     const policy = options?.executionPolicy;
     const listOpts = withRepositoryDefaults(options?.list, options?.repository);
     const searchOpts = withRepositoryDefaults(options?.search, options?.repository);
+    const globOpts = withRepositoryDefaults(options?.glob, options?.repository);
     return [
         createReadTool(cwd, withSharedExecutionPolicy(options?.read, policy)),
         createRepoListTool(cwd, withSharedExecutionPolicy(listOpts, policy)),
         createRepoSearchTool(cwd, withSharedExecutionPolicy(searchOpts, policy)),
+        createGlobTool(cwd, withSharedExecutionPolicy(globOpts, policy)),
     ];
 }
 /** Every tool this package provides — identical to {@link createCodingTools}. */

package/dist/language/client.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Minimal JSON-RPC LSP client over child stdio (LSP 3.17 framing).
+ * Lazy start; bounded pending requests, message bytes, timeout, restart budget.
+ */
+import { type ResolvedLanguageIntelligenceLimits } from "./types.js";
+export interface LspServerSpec {
+    readonly name: string;
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly env?: Readonly<Record<string, string>>;
+    readonly cwd: string;
+    readonly rootUri: string;
+}
+export declare class LspClient {
+    readonly spec: LspServerSpec;
+    private readonly limits;
+    private child;
+    private reader;
+    private nextId;
+    private pending;
+    private startPromise;
+    private disposed;
+    private shuttingDown;
+    private capabilities;
+    /** file URI → latest diagnostics payload from publishDiagnostics */
+    readonly diagnosticsByUri: Map<string, unknown>;
+    private readonly onUnexpectedExit;
+    constructor(spec: LspServerSpec, limits: ResolvedLanguageIntelligenceLimits, hooks?: {
+        onUnexpectedExit?: () => void;
+    });
+    get started(): boolean;
+    ensureStarted(signal?: AbortSignal): Promise<void>;
+    request(method: string, params: unknown, signal?: AbortSignal): Promise<unknown>;
+    notify(method: string, params: unknown): void;
+    hasCapability(key: string): boolean;
+    dispose(): Promise<void>;
+    private write;
+    private spawnAndInitialize;
+    /** Internal request used during initialize before ensureStarted recursion. */
+    private requestUnlocked;
+    private onMessage;
+    private failTransport;
+    private rejectAll;
+}