@cortexkit/aft-pi 0.57.2 → 0.58.1

package/README.md

@@ -22,7 +22,7 @@ pi install npm:@cortexkit/aft-pi@0.13.1
 
 ### Hoisted built-in overrides
 
-Pi's default `read`, `write`, `edit`, and `grep` are replaced with AFT-backed versions by default. Set `hoist_builtin_tools: false` to keep Pi's native tools and use `aft_read`, `aft_write`, `aft_edit`, `aft_grep`, and `aft_bash` for AFT instead; AFT background-bash companions remain `bash_status`, `bash_watch`, `bash_write`, and `bash_kill`.
+Pi's default `read`, `write`, `edit`, `grep`, and `bash` are replaced with AFT-backed versions. List a name in `disabled_tools` (for example `["grep"]`) to keep Pi's native tool for that slot. The AFT background-bash companions `bash_status`, `bash_watch`, `bash_write`, and `bash_kill` register independently of `bash`.
 
 | Tool    | Pi built-in              | AFT replacement                                                                              |
 | ------- | ------------------------ | -------------------------------------------------------------------------------------------- |
@@ -65,13 +65,6 @@ All keys are optional. Example:
 
 ```jsonc
 {
-  // "minimal" | "recommended" (default) | "all"
-  "tool_surface": "recommended",
-
-  // Default true replaces Pi's native file and bash tools.
-  // Set false to retain Pi's tools and use aft_read/aft_write/aft_edit/aft_bash for AFT.
-  "hoist_builtin_tools": false,
-
   // Auto-format on write/edit using project formatter config.
   "format_on_edit": true,
 
@@ -82,14 +75,12 @@ All keys are optional. Example:
   // Defaults to false to match Pi's built-in behavior.
   "restrict_to_project_root": false,
 
-  // Enable the trigram-indexed grep/glob (hoists them when true).
-  "experimental_search_index": true,
-
-  // Enable semantic search (aft_search). Requires ONNX runtime for local
-  // embeddings; downloaded automatically on supported platforms.
-  "experimental_semantic_search": true,
+  // Background indexes, all on by default. The local semantic backend may
+  // download an ONNX runtime and model and use CPU.
+  "indexes": { "trigram": true, "semantic": true, "callgraph": true },
 
-  // Disable specific tool names (applied after tool_surface selection).
+  // Tools that are not registered. Absent => ["aft_move", "aft_delete"];
+  // an explicit list replaces that default ([] enables every tool).
   "disabled_tools": ["aft_move"],
 
   // Pi / OMP harness options:
@@ -112,7 +103,7 @@ All keys are optional. Example:
   // Missing formatter/checker/LSP warnings after configure: "toast" (default), "log", or "chat".
   "configure_warnings_delivery": "toast",
 
-  // Semantic backend (when experimental_semantic_search=true).
+  // Semantic backend for the semantic index.
   // "fastembed" (default, local ONNX) | "openai_compatible" | "ollama"
   "semantic": {
     "backend": "fastembed",
@@ -125,13 +116,15 @@ All keys are optional. Example:
 
 Sensitive semantic backend fields (`backend`, `base_url`, `api_key_env`) are only read from **user-level** config. Project configs that try to set them are ignored with a warning to prevent credential-exfiltration via malicious repos.
 
-### Tool surface tiers
+### Registered tools
 
-| Tier              | Tools                                                                                                                   |
-| ----------------- | ----------------------------------------------------------------------------------------------------------------------- |
-| `minimal`         | `aft_outline`, `aft_zoom`, `aft_safety`                                                                                 |
-| `recommended` (default) | `minimal` + `read`/`write`/`edit` (or `aft_` alternatives when hoisting is disabled) + `aft_import` + `ast_grep_*` + `lsp_diagnostics` + `aft_conflicts` + (optional) `grep`/`aft_grep` + (optional) `aft_search` |
-| `all`             | `recommended` + `aft_callgraph` + `aft_delete` + `aft_move`                                             |
+Every AFT tool registers unless listed in `disabled_tools`: `read`, `write`, `edit`, `grep`,
+`bash` and its companions, `aft_outline`, `aft_zoom`, `aft_search`, `aft_callgraph`,
+`aft_inspect`, `aft_import`, `aft_safety`, `aft_conflicts`, `ast_grep_search`,
+`ast_grep_replace`, `aft_delete` and `aft_move` (the last two are in the default disabled
+list). Pi has no AFT `apply_patch` or `glob` tool. Index state and runtime settings never
+remove a registration. `tool_surface`, `hoist_builtin_tools` and the `search_index` /
+`semantic_search` keys are translated during v0.58 and rejected from v0.59.
 
 ## Architecture
 

package/dist/bash-wait-detach.d.ts

@@ -1,11 +1,26 @@
-import type { AftTransportPool } from "@cortexkit/aft-bridge";
+import { type AftTransportPool } from "@cortexkit/aft-bridge";
 import type { AftConfig } from "./config.js";
 type ActiveBridgePool = Pick<AftTransportPool, "getActiveBridgeForRoot">;
-export declare const BASH_WAIT_DETACH_MAGIC_KEYWORD = "&detach";
+export { BASH_WAIT_DETACH_MAGIC_KEYWORD } from "@cortexkit/aft-bridge";
 /** Strip the `&detach` control token before Pi's input transform delivers the user message to the model. */
 export declare function stripUserMessageDetachKeyword(messageText: string): string;
-/** Decide whether a user message should signal an active wait:true bash call. */
+/**
+ * Decide whether a message should detach an active wait:true bash call and
+ * abort a sync bash_watch. `messageText` is read before the keyword is
+ * stripped from it.
+ */
 export declare function shouldDetachBashWaitOnUserMessage(config: AftConfig, messageText: string): boolean;
+/** The fields of Pi's `input` event this module reads. */
+export interface PiInputEvent {
+    text: string;
+}
+/**
+ * Handle Pi's `input` event for the session's blocking waits: decide before
+ * the `&detach` token is stripped, then (only when the decision says so) abort
+ * any sync bash_watch and detach any wait:true bash. Both waits follow the same
+ * decision, so `bash.detach_on_user_message: false` protects a sync bash_watch
+ * as well. Returns the text to deliver to the model.
+ */
+export declare function interruptBashWaitsForInput(pool: ActiveBridgePool, config: AftConfig, projectRoot: string, sessionID: string | undefined, event: PiInputEvent): string;
 export declare function signalBashWaitDetachForProject(pool: ActiveBridgePool, projectRoot: string, sessionID: string | undefined): Promise<void>;
-export {};
 //# sourceMappingURL=bash-wait-detach.d.ts.map

package/dist/bash-wait-detach.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bash-wait-detach.d.ts","sourceRoot":"","sources":["../src/bash-wait-detach.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAuB,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAM7C,KAAK,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,EAAE,wBAAwB,CAAC,CAAC;AAEzE,eAAO,MAAM,8BAA8B,YAAY,CAAC;AAcxD,4GAA4G;AAC5G,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED,iFAAiF;AACjF,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAIjG;AAaD,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC,IAAI,CAAC,CAWf"}
+{"version":3,"file":"bash-wait-detach.d.ts","sourceRoot":"","sources":["../src/bash-wait-detach.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EAItB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO7C,KAAK,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,EAAE,wBAAwB,CAAC,CAAC;AAEzE,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAIvE,4GAA4G;AAC5G,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAKjG;AAED,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE,YAAY,GAClB,MAAM,CAMR;AAaD,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/config-error-state.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The Pi side of the config error state (see `config-error.ts` in
+ * `@cortexkit/aft-bridge`). An unusable configuration used to make the
+ * extension register nothing, or throw from its factory, which Pi records
+ * only in its own log. Instead the extension registers AFT's tool surface and
+ * every call fails with the error and its fix; no binary is resolved and no
+ * bridge is started.
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { type AftConfig, type ConfigLoadError } from "./config.js";
+/** Status-bar key the config error is shown under. */
+export declare const CONFIG_ERROR_STATUS_KEY = "aft";
+export type PiBootstrapConfig = {
+    ok: true;
+    config: AftConfig;
+    /** The config files this load read; a live config reload starts from them. */
+    sources?: readonly string[];
+    /** The text of each file this load read, keyed by path. */
+    sourceTexts?: Readonly<Record<string, string>>;
+} | {
+    ok: false;
+    /** The error, its fix, and the note that a restart is needed. */
+    message: string;
+    /** Config whose tool surface is registered: the loaded one when usable, else the default. */
+    config: AftConfig;
+};
+/** Side effects of the config load, replaceable in tests. */
+export interface PiBootstrapDependencies {
+    loadConfig(directory: string): AftConfig;
+    configLoadErrors(): readonly ConfigLoadError[];
+    /** The config files the most recent `loadConfig` call read. */
+    configLoadSources?(): readonly string[];
+    /** The text of each file the most recent `loadConfig` call read. */
+    configLoadTexts?(): ReadonlyMap<string, string>;
+    /** Moves legacy config files into the CortexKit layout; returns user-facing warnings. */
+    migrateConfigLocations(directory: string): string[];
+    subcConnectionFileError(subcConnectionFile: string | undefined): Promise<string | null>;
+}
+/**
+ * Load the config for `directory`, migrating legacy config file locations in
+ * between two loads (migration may move the file the first read came from).
+ * A rejected configuration, a file that does not parse, any other load
+ * failure, or a configured subc connection file that does not exist yields
+ * the config error state. Migration is skipped when the first load fails.
+ */
+export declare function resolvePiBootstrapConfig(directory: string, notify: (message: string) => void, dependencies?: PiBootstrapDependencies): Promise<PiBootstrapConfig>;
+/**
+ * Register the config error state: the tool surface `config` selects with
+ * every call failing, and the error on one line in Pi's status bar. Commands
+ * and lifecycle hooks are not registered; there is no bridge for them.
+ */
+export declare function registerPiConfigErrorState(pi: ExtensionAPI, config: AftConfig, message: string): void;
+//# sourceMappingURL=config-error-state.d.ts.map

package/dist/config-error-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-error-state.d.ts","sourceRoot":"","sources":["../src/config-error-state.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,EACL,KAAK,SAAS,EACd,KAAK,eAAe,EAMrB,MAAM,aAAa,CAAC;AAKrB,sDAAsD;AACtD,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GACzB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,SAAS,CAAC;IAClB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChD,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,6FAA6F;IAC7F,MAAM,EAAE,SAAS,CAAC;CACnB,CAAC;AAEN,6DAA6D;AAC7D,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,gBAAgB,IAAI,SAAS,eAAe,EAAE,CAAC;IAC/C,+DAA+D;IAC/D,iBAAiB,CAAC,IAAI,SAAS,MAAM,EAAE,CAAC;IACxC,oEAAoE;IACpE,eAAe,CAAC,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,yFAAyF;IACzF,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACpD,uBAAuB,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACzF;AAiCD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EACjC,YAAY,GAAE,uBAA6C,GAC1D,OAAO,CAAC,iBAAiB,CAAC,CAqB5B;AAwBD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,GACd,IAAI,CAsBN"}

package/dist/config-live-reload.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Live reload of the plugin's own copy of the AFT config (`ctx.config`) when
+ * `~/.config/cortexkit/aft.jsonc` or `<project>/.cortexkit/aft.jsonc` changes.
+ * Used by the Pi extension. The engine applies its own keys from the same
+ * files separately.
+ */
+import { type LiveConfigLoad, type LiveConfigReload } from "@cortexkit/aft-bridge";
+import { type AftConfig } from "./config.js";
+/** The live keys, read through this host's bash resolution. */
+export declare const PI_LIVE_CONFIG_KEYS: import("@cortexkit/aft-bridge").LiveConfigKey<AftConfig>[];
+export declare function loadPiConfigForLiveReload(directory: string): LiveConfigLoad<AftConfig>;
+export interface PiLiveConfigReloadOptions {
+    /** The directory whose project config applies. */
+    directory: string;
+    /** The config files the startup load read (the bootstrap result's `sources`). */
+    initialSources: readonly string[];
+    /** Their texts (the bootstrap result's `sourceTexts`). */
+    initialSourceTexts?: Readonly<Record<string, string>>;
+    getConfig(): AftConfig;
+    setConfig(config: AftConfig): void;
+    /** Show a config error to the user. */
+    notify(message: string): void;
+    /** Tests drive `reload()` directly instead of watching. */
+    watch?: boolean;
+}
+/** Keep `ctx.config` current for the live keys while the host runs. */
+export declare function startPiLiveConfigReload(options: PiLiveConfigReloadOptions): LiveConfigReload;
+//# sourceMappingURL=config-live-reload.d.ts.map

package/dist/config-live-reload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-live-reload.d.ts","sourceRoot":"","sources":["../src/config-live-reload.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAGtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,KAAK,SAAS,EAOf,MAAM,aAAa,CAAC;AAGrB,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,4DAG/B,CAAC;AAaF,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,CAwBtF;AAED,MAAM,WAAW,yBAAyB;IACxC,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,SAAS,IAAI,SAAS,CAAC;IACvB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACnC,uCAAuC;IACvC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,uEAAuE;AACvE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,yBAAyB,GAAG,gBAAgB,CAmB5F"}