@arnilo/prism-coding-agent 0.0.25 → 0.0.27

package/dist/forge/types.d.ts

@@ -0,0 +1,150 @@
+import type { AgentIdentity, ExecutionPolicy, OwnershipScope, ToolEffectStore } from "@arnilo/prism";
+import type { BoundGitRunner, CreateGitRunnerOptions } from "../git-exec.js";
+/** Read-only context for one GitHub issue, bounded by payload caps. */
+export interface ForgeIssueContext {
+    readonly number: number;
+    readonly title: string;
+    readonly state: "open" | "closed";
+    readonly body: string;
+    readonly labels: readonly string[];
+    readonly author: string;
+    readonly updatedAt: string;
+    readonly url: string;
+}
+/** Pull-request state as seen through the forge. */
+export interface ForgePullRequest {
+    readonly number: number;
+    readonly state: "open" | "closed";
+    readonly merged: boolean;
+    readonly head: string;
+    readonly base: string;
+    readonly title: string;
+    readonly body: string;
+    readonly url: string;
+}
+/** One check run or commit status, normalized. */
+export interface ForgeCheck {
+    readonly name: string;
+    readonly status: "queued" | "in_progress" | "completed";
+    readonly conclusion?: string;
+    readonly detailsUrl?: string;
+}
+/** Bounded handoff reconciliation: push/PR/check state, never auto-merged. */
+export interface ForgeHandoffReport {
+    readonly base: string;
+    readonly head: string;
+    /** Whether the head ref exists on the remote. */
+    readonly pushed: boolean;
+    readonly aheadBy: number;
+    readonly behindBy: number;
+    /** No commits ahead and no divergence: nothing to push. */
+    readonly alreadyUpToDate: boolean;
+    readonly alreadyMerged: boolean;
+    readonly pullRequest?: ForgePullRequest;
+    readonly checks: readonly ForgeCheck[];
+    /** Bounded commit list (sha + subject), present only when pushed. */
+    readonly commits: readonly {
+        sha: string;
+        subject: string;
+    }[];
+    /** Bounded changed paths, present only when pushed. */
+    readonly changedPaths: readonly string[];
+    readonly diffstat: string;
+    readonly warnings: readonly string[];
+}
+export type ForgeErrorCode = "ERR_PRISM_FORGE_AUTH" | "ERR_PRISM_FORGE_API" | "ERR_PRISM_FORGE_STALE" | "ERR_PRISM_FORGE_RATE_LIMIT" | "ERR_PRISM_FORGE_LIMIT" | "ERR_PRISM_FORGE_OWNERSHIP";
+export declare class ForgeError extends Error {
+    readonly code: ForgeErrorCode;
+    constructor(code: ForgeErrorCode, message: string);
+}
+export interface ForgeLimits {
+    readonly pagesPerOperation?: number;
+    readonly payloadBytes?: number;
+    readonly commentsPerReview?: number;
+    readonly requestConcurrency?: number;
+    readonly requestTimeoutMs?: number;
+}
+export interface ResolvedForgeLimits {
+    readonly pagesPerOperation: number;
+    readonly payloadBytes: number;
+    readonly commentsPerReview: number;
+    readonly requestConcurrency: number;
+    readonly requestTimeoutMs: number;
+}
+export declare function resolveForgeLimits(options?: ForgeLimits): ResolvedForgeLimits;
+export interface ForgeOperations {
+    issueContext(input: {
+        number: number;
+    }): Promise<ForgeIssueContext>;
+    push(input: {
+        refspec?: string;
+    }): Promise<{
+        remoteRef: string;
+    }>;
+    createPullRequest(input: {
+        head: string;
+        base: string;
+        title: string;
+        body: string;
+    }): Promise<ForgePullRequest>;
+    updatePullRequest(input: {
+        number: number;
+        title?: string;
+        body?: string;
+        state?: "open" | "closed";
+    }): Promise<ForgePullRequest>;
+    createReviewComment(input: {
+        number: number;
+        path: string;
+        line: number;
+        body: string;
+    }): Promise<{
+        id: number;
+    }>;
+    checks(input: {
+        ref: string;
+    }): Promise<readonly ForgeCheck[]>;
+    reconcileHandoff(input: {
+        base: string;
+        head: string;
+    }): Promise<ForgeHandoffReport>;
+}
+/** Structural mirror of the core `CredentialResolverSource` (not barrel-exported). */
+export interface ForgeCredential {
+    readonly type: "bearer" | "api_key" | "basic" | "custom";
+    readonly value: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ForgeCredentialResolver {
+    resolve(request: {
+        readonly name: string;
+        readonly provider?: string;
+        readonly metadata?: Readonly<Record<string, unknown>>;
+    }): Promise<ForgeCredential | undefined> | ForgeCredential | undefined;
+}
+export interface ForgeCredentialResolverSource {
+    readonly name: string;
+    readonly resolver: ForgeCredentialResolver;
+}
+export interface CreateGitHubForgeOptions {
+    /** Credential resolver — resolved with provider "github" per call. */
+    readonly credentials: ForgeCredentialResolverSource;
+    /** "owner/repo", bound per instance. */
+    readonly repository: string;
+    /** Local checkout the adapter pushes from. */
+    readonly cwd: string;
+    /** Git runner reused for authenticated push. */
+    readonly git: CreateGitRunnerOptions | BoundGitRunner;
+    /** Mutations are gated through this policy before any request. */
+    readonly policy?: ExecutionPolicy;
+    /** REQUIRED: idempotency + unknown-outcome recovery for mutations. */
+    readonly effectStore: ToolEffectStore;
+    /** Durable context for effect keys; required for mutations. */
+    readonly identity?: AgentIdentity;
+    readonly ownership?: OwnershipScope;
+    readonly sessionId?: string;
+    readonly runId?: string;
+    readonly limits?: ForgeLimits;
+    /** Host-injectable fetch (e.g. routed through an egress proxy); defaults to globalThis.fetch. */
+    readonly fetch?: typeof fetch;
+}

package/dist/forge/types.js

@@ -0,0 +1,19 @@
+import { 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, 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, validateCodingLimit, } from "../limits.js";
+export class ForgeError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "ForgeError";
+        this.code = code;
+    }
+}
+export function resolveForgeLimits(options) {
+    return {
+        pagesPerOperation: validateCodingLimit("forge.pagesPerOperation", options?.pagesPerOperation ?? DEFAULT_MAX_FORGE_PAGES_PER_OPERATION, HARD_MAX_FORGE_PAGES_PER_OPERATION),
+        payloadBytes: validateCodingLimit("forge.payloadBytes", options?.payloadBytes ?? DEFAULT_MAX_FORGE_PAYLOAD_BYTES, HARD_MAX_FORGE_PAYLOAD_BYTES),
+        commentsPerReview: validateCodingLimit("forge.commentsPerReview", options?.commentsPerReview ?? DEFAULT_MAX_FORGE_COMMENTS_PER_REVIEW, HARD_MAX_FORGE_COMMENTS_PER_REVIEW),
+        requestConcurrency: validateCodingLimit("forge.requestConcurrency", options?.requestConcurrency ?? DEFAULT_MAX_FORGE_REQUEST_CONCURRENCY, HARD_MAX_FORGE_REQUEST_CONCURRENCY),
+        requestTimeoutMs: validateCodingLimit("forge.requestTimeoutMs", options?.requestTimeoutMs ?? DEFAULT_MAX_FORGE_REQUEST_TIMEOUT_MS, HARD_MAX_FORGE_REQUEST_TIMEOUT_MS),
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/git-aware-repository.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Git-aware repository enumeration over `git ls-files`.
+ *
+ * Detection: `git rev-parse --is-inside-work-tree` (cached per instance).
+ * Non-Git / detection failure → native fallback. Post-detection Git failure → fail closed.
+ * No hand-rolled `.gitignore` parser; argv is fixed host-side only.
+ */
+import { type BoundGitRunner, type CreateGitRunnerOptions } from "./git-exec.js";
+import { type RepositoryLimitOptions, type RepositoryOperations } from "./repository.js";
+export interface GitAwareRepositoryOptions {
+    readonly git?: CreateGitRunnerOptions | BoundGitRunner;
+    readonly fallback?: RepositoryOperations;
+    /** Host-config only, never model-settable. Default false: ignored paths stay excluded. */
+    readonly includeIgnored?: boolean;
+    readonly limits?: RepositoryLimitOptions;
+    /** Override freeze default/hard `ls-files` stdout cap. */
+    readonly maxLsFilesOutputBytes?: number;
+}
+/** Parse NUL-delimited `git ls-files -z` stdout. */
+export declare function parseGitLsFilesZ(buffer: Buffer): string[];
+/**
+ * Repository operations that prefer Git tracked/unignored enumeration.
+ * Outside a Git work tree (or when detection fails), delegates to `fallback`.
+ */
+export declare function createGitAwareRepositoryOperations(cwd: string, options?: GitAwareRepositoryOptions): RepositoryOperations;

package/dist/git-aware-repository.js

@@ -0,0 +1,268 @@
+/**
+ * Git-aware repository enumeration over `git ls-files`.
+ *
+ * Detection: `git rev-parse --is-inside-work-tree` (cached per instance).
+ * Non-Git / detection failure → native fallback. Post-detection Git failure → fail closed.
+ * No hand-rolled `.gitignore` parser; argv is fixed host-side only.
+ */
+import { lstat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { createBoundGitRunner, gitText, GitError } from "./git-exec.js";
+import { DEFAULT_MAX_LS_FILES_OUTPUT_BYTES, HARD_MAX_LS_FILES_OUTPUT_BYTES, validateCodingLimit } from "./limits.js";
+import { createLocalRepositoryOperations, RepositoryError, toRepoRelative, } from "./repository.js";
+function isBoundGitRunner(value) {
+    return typeof value.exec === "function" && typeof value.gitPath === "string";
+}
+function shouldSkipName(name, includeHidden, exclude) {
+    if (name === "." || name === "..")
+        return true;
+    if (exclude.has(name))
+        return true;
+    if (!includeHidden && name.startsWith("."))
+        return true;
+    return false;
+}
+function pathHasSkippedComponent(relativePath, includeHidden, exclude) {
+    for (const part of relativePath.split("/")) {
+        if (shouldSkipName(part, includeHidden, exclude))
+            return true;
+    }
+    return false;
+}
+/** Parse NUL-delimited `git ls-files -z` stdout. */
+export function parseGitLsFilesZ(buffer) {
+    const out = [];
+    let start = 0;
+    for (let i = 0; i < buffer.length; i++) {
+        if (buffer[i] === 0) {
+            if (i > start)
+                out.push(buffer.subarray(start, i).toString("utf8"));
+            start = i + 1;
+        }
+    }
+    if (start < buffer.length)
+        out.push(buffer.subarray(start).toString("utf8"));
+    return out;
+}
+function depthFromStart(relativePath, startRel) {
+    const rel = startRel === "."
+        ? relativePath
+        : relativePath === startRel
+            ? ""
+            : relativePath.startsWith(`${startRel}/`)
+                ? relativePath.slice(startRel.length + 1)
+                : relativePath;
+    if (rel === "" || rel === ".")
+        return 0;
+    return rel.split("/").length - 1;
+}
+function isUnderStart(relativePath, startRel) {
+    if (startRel === "." || startRel === "")
+        return true;
+    return relativePath === startRel || relativePath.startsWith(`${startRel}/`);
+}
+async function* walkGitFiles(rootReal, startAbsolute, limits, files) {
+    const startRel = toRepoRelative(rootReal, startAbsolute);
+    const dirSeen = new Set();
+    const planned = [];
+    for (const relativePath of files) {
+        if (limits.signal?.aborted)
+            throw new RepositoryError("Operation aborted");
+        if (limits.deadlineAt !== undefined && Date.now() >= limits.deadlineAt) {
+            throw new RepositoryError("Repository operation exceeded time limit");
+        }
+        if (!relativePath || relativePath.includes("\0"))
+            continue;
+        if (relativePath === ".git" || relativePath.startsWith(".git/"))
+            continue;
+        if (!isUnderStart(relativePath, startRel))
+            continue;
+        if (pathHasSkippedComponent(relativePath, limits.includeHidden, limits.exclude))
+            continue;
+        const fileDepth = depthFromStart(relativePath, startRel);
+        if (fileDepth > limits.maxDepth)
+            continue;
+        // Synthesize parent directories within the start scope (native walker emits dirs too).
+        const parts = relativePath.split("/");
+        let acc = "";
+        for (let i = 0; i < parts.length - 1; i++) {
+            acc = acc ? `${acc}/${parts[i]}` : parts[i];
+            if (!isUnderStart(acc, startRel))
+                continue;
+            if (pathHasSkippedComponent(acc, limits.includeHidden, limits.exclude))
+                break;
+            const dirDepth = depthFromStart(acc, startRel);
+            if (dirDepth > limits.maxDepth)
+                break;
+            if (!dirSeen.has(acc)) {
+                dirSeen.add(acc);
+                planned.push({ path: acc, kind: "directory", depth: dirDepth });
+            }
+        }
+        planned.push({ path: relativePath, kind: "file", depth: fileDepth });
+    }
+    planned.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+    let scannedEntries = 0;
+    let scannedFiles = 0;
+    for (const item of planned) {
+        if (limits.signal?.aborted)
+            throw new RepositoryError("Operation aborted");
+        if (limits.deadlineAt !== undefined && Date.now() >= limits.deadlineAt) {
+            throw new RepositoryError("Repository operation exceeded time limit");
+        }
+        if (scannedEntries >= limits.maxEntries) {
+            yield { type: "limit", truncatedBy: "entries" };
+            return;
+        }
+        const absolutePath = join(rootReal, item.path);
+        const rootResolved = resolve(rootReal);
+        const absResolved = resolve(absolutePath);
+        if (absResolved !== rootResolved && !absResolved.startsWith(rootResolved + "/"))
+            continue;
+        let kind = item.kind;
+        let size;
+        try {
+            const st = await lstat(absolutePath);
+            if (st.isSymbolicLink())
+                kind = "symlink";
+            else if (st.isDirectory())
+                kind = "directory";
+            else if (st.isFile()) {
+                kind = "file";
+                size = st.size;
+            }
+            else
+                kind = "other";
+        }
+        catch {
+            // Missing after ls-files (race) — skip.
+            continue;
+        }
+        if (kind === "file") {
+            if (scannedFiles >= limits.maxFiles) {
+                yield { type: "limit", truncatedBy: "files" };
+                return;
+            }
+            scannedFiles++;
+        }
+        scannedEntries++;
+        const entry = size === undefined ? { path: item.path, kind } : { path: item.path, kind, size };
+        yield { type: "entry", entry, absolutePath, depth: item.depth };
+    }
+}
+/**
+ * Repository operations that prefer Git tracked/unignored enumeration.
+ * Outside a Git work tree (or when detection fails), delegates to `fallback`.
+ */
+export function createGitAwareRepositoryOperations(cwd, options) {
+    const fallback = options?.fallback ?? createLocalRepositoryOperations(options?.limits);
+    const includeIgnored = options?.includeIgnored === true;
+    const maxLsBytes = validateCodingLimit("maxLsFilesOutputBytes", options?.maxLsFilesOutputBytes ?? DEFAULT_MAX_LS_FILES_OUTPUT_BYTES, HARD_MAX_LS_FILES_OUTPUT_BYTES);
+    let detected;
+    let runnerPromise;
+    let gitOps;
+    function getRunner() {
+        if (!runnerPromise) {
+            const git = options?.git;
+            runnerPromise =
+                git && isBoundGitRunner(git)
+                    ? Promise.resolve(git)
+                    : createBoundGitRunner({
+                        ...git,
+                        maxOutputBytes: maxLsBytes,
+                    });
+        }
+        return runnerPromise;
+    }
+    async function detect(signal) {
+        if (detected !== undefined)
+            return detected;
+        try {
+            const result = await (await getRunner()).exec({
+                args: ["rev-parse", "--is-inside-work-tree"],
+                cwd,
+                signal,
+                maxOutputBytes: 64,
+            });
+            detected = result.exitCode === 0 && gitText(result).trim() === "true";
+        }
+        catch {
+            detected = false;
+        }
+        return detected;
+    }
+    async function listGitPaths(signal) {
+        const runner = await getRunner();
+        // Fixed argv only — never model-supplied flags (Task 0 freeze).
+        const primary = await runner.exec({
+            args: ["ls-files", "--cached", "--others", "--exclude-standard", "-z"],
+            cwd,
+            signal,
+            maxOutputBytes: maxLsBytes,
+        });
+        if (primary.timedOut)
+            throw new RepositoryError("Repository operation exceeded time limit");
+        if (primary.aborted)
+            throw new RepositoryError("Operation aborted");
+        if (primary.exitCode !== 0) {
+            throw new RepositoryError(`git ls-files failed (exit ${primary.exitCode})`);
+        }
+        const paths = new Set(parseGitLsFilesZ(primary.stdout));
+        if (includeIgnored) {
+            // Second invocation only when host opts into ignored paths (≤ 2 total per freeze).
+            const ignored = await runner.exec({
+                args: ["ls-files", "-o", "-i", "--exclude-standard", "-z"],
+                cwd,
+                signal,
+                maxOutputBytes: maxLsBytes,
+            });
+            if (ignored.timedOut)
+                throw new RepositoryError("Repository operation exceeded time limit");
+            if (ignored.aborted)
+                throw new RepositoryError("Operation aborted");
+            if (ignored.exitCode !== 0) {
+                throw new RepositoryError(`git ls-files (ignored) failed (exit ${ignored.exitCode})`);
+            }
+            for (const p of parseGitLsFilesZ(ignored.stdout))
+                paths.add(p);
+        }
+        return [...paths].sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
+    }
+    function getGitOps() {
+        if (!gitOps) {
+            const walk = async function* (rootReal, startAbsolute, limits) {
+                let files;
+                try {
+                    files = await listGitPaths(limits.signal);
+                }
+                catch (error) {
+                    if (error instanceof RepositoryError)
+                        throw error;
+                    if (error instanceof GitError) {
+                        if (/abort/i.test(error.message))
+                            throw new RepositoryError("Operation aborted");
+                        if (/time|exceeded/i.test(error.message)) {
+                            throw new RepositoryError("Repository operation exceeded time limit");
+                        }
+                        throw new RepositoryError(error.message);
+                    }
+                    throw new RepositoryError(error instanceof Error ? error.message : String(error));
+                }
+                yield* walkGitFiles(rootReal, startAbsolute, limits, files);
+            };
+            gitOps = createLocalRepositoryOperations(options?.limits, walk);
+        }
+        return gitOps;
+    }
+    async function route(signal, gitCall, nativeCall) {
+        if (!(await detect(signal)))
+            return nativeCall();
+        return gitCall();
+    }
+    return {
+        list: (request) => route(request.signal, () => getGitOps().list(request), () => fallback.list(request)),
+        search: (request) => route(request.signal, () => getGitOps().search(request), () => fallback.search(request)),
+        glob: (request) => route(request.signal, () => getGitOps().glob(request), () => fallback.glob(request)),
+    };
+}
+//# sourceMappingURL=git-aware-repository.js.map

package/dist/git-tools.d.ts

@@ -6,6 +6,7 @@
  */
 import type { ExecutionPolicy, ToolDefinition } from "@arnilo/prism";
 import { type CodingCheckToolOptions, type NamedCheckDefinition } from "./checks.js";
+import type { CodingLifecycleEvent } from "./lifecycle.js";
 import { type ArtifactWriter, type CreateGitOperationsOptions, type GitOperations } from "./git.js";
 export interface GitToolsOptions {
     readonly executionPolicy?: ExecutionPolicy;
@@ -19,6 +20,8 @@ export interface GitToolsOptions {
     /** Optional named checks included by `createGitTools` when provided. */
     readonly checks?: Readonly<Record<string, NamedCheckDefinition>>;
     readonly checkOptions?: Omit<CodingCheckToolOptions, "checks" | "executionPolicy">;
+    /** Optional consumer-gated lifecycle listener (worktree_changed / permission_denied). */
+    readonly onEvent?: (event: CodingLifecycleEvent) => void;
 }
 export declare function createGitStatusTool(cwd: string, options?: GitToolsOptions): ToolDefinition;
 export declare function createGitDiffTool(cwd: string, options?: GitToolsOptions): ToolDefinition;

package/dist/git-tools.js

@@ -243,7 +243,7 @@ export function createGitWorktreeTool(cwd, options) {
                 paths: path ? [path] : [cwd],
                 risk: action === "list" ? "low" : "high",
                 metadata: { branch, force, sessionId: context.sessionId, runId: context.runId },
-            }, toolCallId, "git_worktree");
+            }, toolCallId, "git_worktree", (denied) => options?.onEvent?.({ type: "permission_denied", ...denied }));
             if (!policy.allowed)
                 return policy.result;
             try {
@@ -254,6 +254,9 @@ export function createGitWorktreeTool(cwd, options) {
                     force,
                     signal: context.signal,
                 });
+                if (action !== "list") {
+                    options?.onEvent?.({ type: "worktree_changed", action, path: result.path ?? path ?? "", toolCallId });
+                }
                 const text = action === "list"
                     ? result.worktrees.map((w) => `${w.path}\t${w.branch ?? ""}\t${w.head ?? ""}`).join("\n") || "(no worktrees)"
                     : `ok action=${action} path=${result.path ?? ""}`;

package/dist/index.d.ts

@@ -5,6 +5,8 @@ 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";
@@ -28,8 +30,16 @@ export type { ReadOperations, ReadTextOptions, ReadTextResult, ReadToolOptions,
 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, } from "./repository.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 { createRepoSearchTool } from "./search.js";
 export type { BashExecOptions, BashOperations, BashSpawnContext, BashSpawnHook, ShellConfig, ShellToolOptions, } from "./shell.js";
@@ -38,7 +48,7 @@ export type { WriteOperations, WriteToolOptions } from "./write.js";
 export { createWriteTool } from "./write.js";
 export { enforceExecutionPolicy } from "./execution-policy.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_GIT_CHANGED_FILES, DEFAULT_MAX_GIT_DIFF_LINES, DEFAULT_MAX_GIT_MESSAGE_BYTES, DEFAULT_MAX_GIT_OUTPUT_BYTES, 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_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_GIT_CHANGED_FILES, HARD_MAX_GIT_DIFF_LINES, HARD_MAX_GIT_MESSAGE_BYTES, HARD_MAX_GIT_OUTPUT_BYTES, 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_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, } from "./limits.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 { DeleteToolOptions } from "./delete.js";
 import type { EditToolOptions } from "./edit.js";

package/dist/index.js

@@ -8,6 +8,7 @@ export { createDirectoryArtifactWriter, createTempArtifactWriter, sha256Hex } fr
 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";
@@ -21,13 +22,17 @@ 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 { createLocalBashOperations, createShellTool, getShellConfig, killProcessTree, waitForChildProcess, } from "./shell.js";
 export { createWriteTool } from "./write.js";
 // --- generic primitives (re-exported for hosts that want them) ---
 export { enforceExecutionPolicy } from "./execution-policy.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_GIT_CHANGED_FILES, DEFAULT_MAX_GIT_DIFF_LINES, DEFAULT_MAX_GIT_MESSAGE_BYTES, DEFAULT_MAX_GIT_OUTPUT_BYTES, 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_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_GIT_CHANGED_FILES, HARD_MAX_GIT_DIFF_LINES, HARD_MAX_GIT_MESSAGE_BYTES, HARD_MAX_GIT_OUTPUT_BYTES, 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_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, } from "./limits.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";

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;
+}