@cortexkit/aft-bridge 0.59.0 → 0.61.0

package/dist/index.js

@@ -9,11 +9,10 @@
 // --- logger contract ---
 export { setActiveLogger } from "./active-logger.js";
 // --- bash output hints (shared by both plugin hosts) ---
-export { formatForegroundResult, formatSeconds, isTerminalStatus, monotonicNowMs, sleep, } from "./bash-format.js";
+export { formatForegroundResult, formatSeconds, isLiveBackgroundTaskReply, isTerminalStatus, monotonicNowMs, sleep, TERMINAL_BG_TASK_STATUSES, } from "./bash-format.js";
 export { abortableSleep, commandInvokesCodeSearch, DEFAULT_PRIMARY_WATCH_TIMEOUT_MS, DEFAULT_WORKER_WAIT_MAX_MS, formatWaitDuration, formatWatchWaited, interruptedWatchTail, LONGEST_TIMER_DELAY_MS, MAX_WATCH_TIMEOUT_MS, MIN_WORKER_WAIT_MAX_MS, maxWatchTimeoutMs, maybeAppendConflictsHint, maybeAppendGrepSearchHint, outputTail, resolveWatchTimeoutMs, runningTaskStatusHint, taskKillDeadlineText, taskKillDeadlineWithinHandoffMargin, WATCH_SYNC_DEFAULTS_DESCRIPTION, WATCH_TIMEOUT_PARAM_DESCRIPTION, WATCH_UNAVAILABLE_GIVE_UP_MS, WORKER_KEEP_WAITING, WORKER_WAIT_LIMIT_PHRASE, watchClock, watchPollDelayMs, watchTimeoutSteer, watchUnavailableSteer, workerBackgroundTaskNote, workerWatchStillRunning, } from "./bash-hints.js";
 export { BASH_HOST_FALLBACK_BANNER, BASH_HOST_FALLBACK_MAX_OUTPUT_BYTES, BASH_HOST_FALLBACK_MAX_TIMEOUT_MS, BASH_HOST_FALLBACK_REFUSAL, BASH_RUNON_DESCRIPTION, BASH_RUNON_GUIDANCE, bashHostFallbackAskPattern, runBashHostFallback, } from "./bash-host-fallback.js";
 export { __fileDigestWorkForTests, cachedFileSha256, cachedFileSha256Sync, checkBinaryIdentity, identitySidecarPath, isTrustedCachedBinary, readBinaryIdentity, writeStampedFileDigest, } from "./binary-identity.js";
-// --- transport ---
 export { BinaryBridge, BridgeTransportTimeoutError, BridgeTransportUnavailableError, BridgeTransportUnknownOutcomeError, compareSemver, isBridgeTransportTimeout, tagStderrLine, } from "./bridge.js";
 // --- cache paths and binary resolution ---
 export { getAftBinaryCacheDir, getAftCacheRoot, getAftLspBinariesDir, getAftLspPackagesDir, getOpenCodeCacheRoot, getOpenCodeConfigRoot, } from "./cache-paths.js";
@@ -32,14 +31,19 @@ export { downloadBinary, ensureBinary, getBinaryName, getCacheDir, getCachedBina
 export { DEFAULT_LOG_BYTES, DEFAULT_LOG_GENERATIONS, RotatingLogSink, } from "./durable-log.js";
 export { formatEditSummary } from "./edit-summary.js";
 // --- host-neutral agent tool errors ---
-export { AftToolError, adaptToolError, BASH_TRANSPORT_DISPOSITION, BRIDGE_TRANSPORT_UNKNOWN_OUTCOME_DISPOSITION, classifyBashHostFallbackError, isBashTransportDeadError, SUBC_ROUTE_CLOSED_MID_CALL_DISPOSITION, toolErrorFromResponse, } from "./error-contract.js";
+export { AftToolError, adaptToolError, BASH_FRAME_READ_TIMEOUT_DISPOSITION, BASH_TRANSPORT_DISPOSITION, BRIDGE_TRANSPORT_UNKNOWN_OUTCOME_DISPOSITION, classifyBashHostFallbackError, isBashTransportDeadError, SHELL_TIMEOUT_UNKNOWN_DISPOSITION, SUBC_FRAME_READ_TIMEOUT_DISPOSITION, SUBC_ROUTE_CLOSED_MID_CALL_DISPOSITION, shellTimeoutNotStartedDisposition, shellTimeoutTaskDisposition, toolErrorFromResponse, } from "./error-contract.js";
 // --- feature-based configuration policy (shared with crates/aft feature_config.rs) ---
 export * from "./feature-config.js";
 // --- compact UI formatting ---
 export { compressionSavingsPercent, formatTokenCount } from "./format.js";
 // --- jsonc helpers ---
 export { stripJsoncSymbols } from "./jsonc.js";
+// --- transport ---
+export { asCanonicalRootPath } from "./lifecycle-registry.js";
 export { acquireBridge, getBridgeLifecycleTopology, releaseBridge, sampleBridgeLifecycleCensus, } from "./location-lifecycle.js";
+export { createGithubInstaller, } from "./lsp-github-install.js";
+export { assertSafeVersion, isSafeVersion, pickEligibleRelease, probeGithubReleases, stripTagV, } from "./lsp-github-probe.js";
+export { detectHostPlatform, findGithubServerById, GITHUB_LSP_TABLE, } from "./lsp-github-table.js";
 // --- which incoming messages interrupt a blocking bash wait ---
 export { BASH_WAIT_DETACH_MAGIC_KEYWORD, containsStandaloneDetachKeyword, detachStripEdits, shouldInterruptWaitsForMessage, standaloneDetachKeywordRanges, stripDetachKeywordsAndTidyGap, stripStandaloneDetachKeywords, } from "./message-detach.js";
 // --- storage migration ---
@@ -53,7 +57,7 @@ export { InvalidRequestError, isWellFormedUnicodeString, prepareCanonicalEditArg
 export { relativePathEscapesRoot, shortenHomePath } from "./path-display.js";
 export { withPathPrepended } from "./path-env.js";
 export { findExecutableOnPath, findExecutablesOnPath, } from "./path-lookup.js";
-export { decodeFileUrl, markAnnouncementSeen, repairRootScopedStorageFile, resolveCortexKitConfigPaths, resolveCortexKitProjectConfigPath, resolveCortexKitUserConfigPath, resolveHarnessStoragePath, resolveLegacyAftConfigSources, shouldShowAnnouncement, } from "./paths.js";
+export { decodeFileUrl, legacyProjectConfigLocationNotice, markAnnouncementSeen, repairRootScopedStorageFile, resolveCortexKitConfigPaths, resolveCortexKitProjectConfigPath, resolveCortexKitUserConfigPath, resolveHarnessStoragePath, resolveLegacyAftConfigSources, resolveProjectConfigReadPath, shouldShowAnnouncement, } from "./paths.js";
 // --- platform helpers ---
 export { PLATFORM_ARCH_MAP, PLATFORM_ASSET_MAP } from "./platform.js";
 export { BridgePool, HomeProjectRootError, isHomeDirectoryRoot } from "./pool.js";
@@ -63,10 +67,10 @@ export { findBinary, findBinarySync, isNativeExecutable, platformKey } from "./r
 export { RevivableTransportPool } from "./revivable-transport.js";
 export { formatSemanticIndexStatus, semanticIndexStatusKind } from "./semantic-status.js";
 export { isTestEnvironment, resolveAftLogPath, resolveAftStorageRoot, resolveDataHome, resolvePluginLogPath, resolveStoragePath, } from "./storage-paths.js";
-export { resolveBridgeForNudge, SubcRouteClosedMidCallError, SubcTransportPool, SubcTransportShuttingDownError, } from "./subc-transport.js";
+export { isSubcFrameReadTimeoutError, resolveBridgeForNudge, SubcFrameReadTimeoutError, SubcRouteClosedMidCallError, SubcTransportPool, SubcTransportShuttingDownError, } from "./subc-transport.js";
 export { execTarExtractionSync, windowsTarExecutable } from "./tar-executable.js";
 export { formatBridgeErrorMessage, formatReadFooter } from "./tool-format.js";
-export { callPresetFor, observeFreshSessionStart, PRESET_FIELD, WORKER_SESSION_FIELD, } from "./transport.js";
+export { callPresetFor, HOST_TOOL_NAMES_FIELD, observeFreshSessionStart, PRESET_FIELD, WORKER_SESSION_FIELD, } from "./transport.js";
 export { createAftTransportPool, subcConnectionFileError, } from "./transport-factory.js";
 export { readBinaryVersionOffThread } from "./version-probe.js";
 export { formatZoomMultiTargetResult, formatZoomText, isRustZoomBatchEnvelope, unwrapRustZoomBatchEnvelope, } from "./zoom-format.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lsp-github-install.d.ts

@@ -0,0 +1,104 @@
+/**
+ * GitHub-release auto-installer for LSP servers (Pattern C).
+ *
+ * Cache layout under `<aft-cache-root>/lsp-binaries/`:
+ *
+ *   <id>/
+ *     bin/<binary>                  ← standalone binary only
+ *     extracted/                    ← intact distribution and runtime resources
+ *     .aft-version-check            ← JSON: { last_checked, latest_eligible }
+ *     .aft-installing               ← lockfile while a download/extract runs
+ *
+ * `lsp_paths_extra` receives the executable's real directory: `bin/` for
+ * standalone servers, or the in-tree binary directory for distributions.
+ *
+ * Extraction containment:
+ *   1. Download to `<id>/<asset-name>` with a hard size cap.
+ *   2. Extract into a staging dir `<id>/extracted.staging-<rand>/`.
+ *   3. Walk the staging tree and reject any entry that is a symlink, hardlink,
+ *      or whose canonical path escapes the staging root.
+ *   4. Check the staged executable and runtime, then rename the old extraction
+ *      aside and swap the staged tree in, restoring the old tree if the swap fails.
+ *   5. Stage dir is always cleaned up — success or failure.
+ *
+ * GitHub pin resolution:
+ *   When `lsp.versions: { "owner/repo": "X" }` is set, we use GitHub's
+ *   `/releases/tags/<tag>` endpoint directly (with `v`-prefix tolerance)
+ *   instead of relying on the broader `/releases?per_page=30` probe. The
+ *   probe is for "what is the latest eligible version" — not "is this
+ *   specific pinned tag valid".
+ */
+import { type GithubServerSpec, type Platform } from "./lsp-github-table.js";
+export interface GithubInstallConfig {
+    autoInstall: boolean;
+    graceDays: number;
+    /** Per-package version pin map; key is `owner/repo`. Bypasses grace. */
+    versions: Readonly<Record<string, string>>;
+    disabled: ReadonlySet<string>;
+}
+export interface GithubAutoInstallResult {
+    /** Verified caches are available immediately; newly validated directories arrive in the background. */
+    cachedBinDirs: string[];
+    installsStarted: number;
+    /** Binary names whose installs are actively in flight at return time. */
+    installingBinaries: string[];
+    skipped: Array<{
+        id: string;
+        reason: string;
+    }>;
+    /**
+     * Promise that resolves when cached validation and backgrounded installs settle.
+     * Each install holds its per-package install lock for its full duration.
+     * Hosts continue startup immediately and await this in their background path refresh.
+     */
+    installsComplete: Promise<void>;
+    /** Re-scan the cache after background installs settle. */
+    getCachedBinDirs: () => Promise<string[]>;
+}
+export interface GithubAutoInstallOptions {
+    /** Refresh host configuration when one server's cached path becomes ready. */
+    onCachedBinDirsChanged?: (directory?: string) => void;
+    /** Shorter lock waits let shared tests cover timeout behavior without waiting minutes. */
+    __lockWaitTimeoutMsForTests?: number;
+    __lockPollIntervalMsForTests?: number;
+}
+export interface GithubInstallerHost {
+    log(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    readVersionCheck(repo: string): {
+        last_checked: string;
+        latest_eligible: string | null;
+    } | null;
+    writeVersionCheck(repo: string, latest: string | null): void;
+    shouldRecheckVersion(record: {
+        last_checked: string;
+        latest_eligible: string | null;
+    } | null, intervalMs: number): boolean;
+    withInstallLock<T>(repo: string, action: () => Promise<T>): Promise<T | null>;
+    /** Non-blocking acquisition of the same lease used by withInstallLock. */
+    acquireInstallLock(repo: string): {
+        release(): void;
+    } | null;
+    hasRootMarker(root: string, markers: readonly string[] | undefined): boolean;
+    relevantExtensionsInProject(root: string, extensions: Readonly<Record<string, unknown>>): Set<string>;
+    /** OpenCode suppresses missing-binary notices while its background installs settle. */
+    reportInstallingBinaries: boolean;
+}
+/** Bind host logging, shared-cache leases and project scanning without forking installation policy. */
+export declare function createGithubInstaller(services: GithubInstallerHost): {
+    ghBinaryPath: (spec: GithubServerSpec, platform: Platform) => string;
+    isGithubInstalled: (spec: GithubServerSpec, platform: Platform) => boolean;
+    __githubBinaryHashCountForTests: () => number;
+    validateExtraction: (stagingRoot: string) => void;
+    precheckArchiveContents: (archivePath: string, archiveType: string, zipListingMode?: "platform" | "tar") => Promise<void>;
+    abortInFlightGithubInstalls: () => Promise<void>;
+    runGithubAutoInstall: (relevantServers: ReadonlySet<string>, config: GithubInstallConfig, fetchImpl?: typeof fetch, options?: GithubAutoInstallOptions) => GithubAutoInstallResult;
+    discoverRelevantGithubServers: (projectRoot: string) => Set<string>;
+    _assertAllowedDownloadUrlForTesting: (rawUrl: string) => URL;
+    _downloadFileForTesting: (url: string, destPath: string, fetchImpl: typeof fetch, assetSize?: number, signal?: AbortSignal) => Promise<void>;
+    _extractArchiveSafelyForTesting: (archivePath: string, destDir: string, archiveType: string, validateStaged?: (stagingDir: string) => Promise<void>) => Promise<void>;
+    _precheckArchiveSizeForTesting: (archivePath: string, archiveType: string, zipListingMode?: "platform" | "tar") => Promise<void>;
+    _runArchiveToolForTesting: (command: string, args: string[], timeout: number) => Promise<string>;
+};
+//# sourceMappingURL=lsp-github-install.d.ts.map

package/dist/lsp-github-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-github-install.d.ts","sourceRoot":"","sources":["../src/lsp-github-install.ts"],"names":[],"mappings":"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"}