agent-afk 5.95.7 → 5.96.0

package/dist/cli/config/json-tier-parse.d.ts

@@ -0,0 +1,8 @@
+import { type ModelSlotBinding, type SlotName } from '../../agent/session/model-slots.js';
+import type { CliConfig } from './types.js';
+export interface ParsedJsonConfigFile {
+    readonly config: Partial<CliConfig>;
+    readonly modelsPartial: Partial<Record<SlotName, ModelSlotBinding>>;
+}
+export declare function parseJsonConfigFile(configPath: string): ParsedJsonConfigFile | undefined;
+export declare function validatedValueView(parsed: ParsedJsonConfigFile): Record<string, unknown>;

package/dist/cli/config/json-tier-paths.d.ts

@@ -0,0 +1,7 @@
+export type JsonConfigTier = 'project' | 'user' | 'legacy';
+export interface JsonConfigTierPath {
+    readonly tier: JsonConfigTier;
+    readonly path: string;
+}
+export declare const TIER_LABELS: Readonly<Record<JsonConfigTier, string>>;
+export declare function jsonConfigTierPaths(): readonly JsonConfigTierPath[];

package/dist/cli/config/json-tier.d.ts

@@ -1,4 +1,4 @@
-import { type ModelSlotBinding, type SlotName } from '../../agent/session/model-slots.js';
+import type { ModelSlotBinding, SlotName } from '../../agent/session/model-slots.js';
 import type { CliConfig } from './types.js';
 export declare function resetJsonConfigCache(): void;
 export declare function loadJsonConfig(): {

package/dist/cli/config/live-apply.d.ts

@@ -0,0 +1,15 @@
+export interface LiveApplyHandle {
+    setModel(id: string): Promise<void>;
+    noteModel?(id: string): void;
+    repaint?(): void;
+}
+export type LiveApplyOutcome = {
+    readonly applied: true;
+    readonly note: string;
+} | {
+    readonly applied: false;
+    readonly reason?: string;
+};
+export declare function isLiveAppliable(path: string): boolean;
+export declare function liveAppliableKeys(): readonly string[];
+export declare function applyConfigLive(path: string, rawValue: string, handle: LiveApplyHandle | undefined): Promise<LiveApplyOutcome>;

package/dist/cli/config/provenance-cache.d.ts

@@ -0,0 +1,8 @@
+type TierObject = Record<string, unknown> | undefined;
+export interface ProvenanceCache {
+    raw(file: string, compute: () => TierObject): TierObject;
+    validated(file: string, compute: () => TierObject): TierObject;
+}
+export declare function createProvenanceCache(): ProvenanceCache;
+export declare const NO_PROVENANCE_CACHE: ProvenanceCache;
+export {};

package/dist/cli/config/provenance.d.ts

@@ -0,0 +1,24 @@
+import { type JsonConfigTier } from './json-tier-paths.js';
+import { type ProvenanceCache } from './provenance-cache.js';
+export declare const CONFIG_ENV_SHADOWS: Readonly<Record<string, readonly string[]>>;
+export type ConfigSource = {
+    readonly kind: 'env';
+    readonly via: string;
+} | {
+    readonly kind: JsonConfigTier;
+    readonly path: string;
+} | {
+    readonly kind: 'default';
+};
+export interface ConfigProvenance {
+    readonly path: string;
+    readonly effective: unknown;
+    readonly source: ConfigSource;
+    readonly shadowedBy?: ConfigSource;
+    readonly userValue: unknown;
+}
+export declare function describeSource(src: ConfigSource): string;
+export declare function sourceSuffix(prov: ConfigProvenance): string | undefined;
+export declare function shadowNote(prov: ConfigProvenance): string | undefined;
+export declare function activeEnvShadow(path: string): string | undefined;
+export declare function resolveConfigProvenance(path: string, cache?: ProvenanceCache): ConfigProvenance;

package/dist/cli/input/input-surface.d.ts

@@ -18,6 +18,7 @@ export interface InputSurfaceReadOpts {
     onShiftTab?: () => void;
     initialBuffer?: string;
     compositor?: TerminalCompositor;
+    primePromptSuggestion?: boolean;
 }
 export interface InputSurfaceRefs {
     history?: IHistoryRing;

package/dist/cli/input/suggest-prompt-state.d.ts

@@ -0,0 +1,15 @@
+import type { CompleteFn, SuggestContext } from './suggest-types.js';
+export interface PromptSuggestionStateDeps {
+    pickModel(ctx: SuggestContext): string;
+    resolveComplete(model: string, ctx: SuggestContext): CompleteFn | null;
+    timeoutMs: number;
+    scrub(s: string): string;
+    onError?: (err: unknown) => void;
+}
+export interface PromptSuggestionState {
+    prime(ctx: SuggestContext): Promise<void>;
+    peek(): string | null;
+    clear(): void;
+    dispose(): void;
+}
+export declare function createPromptSuggestionState(deps: PromptSuggestionStateDeps): PromptSuggestionState;

package/dist/cli/input/suggest-prompt.d.ts

@@ -0,0 +1,16 @@
+import type { CompleteRequest, SuggestContext } from './suggest-types.js';
+export declare function buildPromptSuggestionSystem(): string;
+export declare function buildPromptSuggestionUser(ctx: SuggestContext): string;
+export declare function hasSuggestionGrounding(ctx: SuggestContext): boolean;
+export declare function isValidPromptSuggestion(reply: string): boolean;
+export declare function normalizePromptSuggestion(raw: string): string | null;
+export type PromptCompleteRequest = CompleteRequest;
+export interface PromptSuggestionDeps {
+    resolveComplete(model: string): ((req: PromptCompleteRequest) => Promise<string>) | null;
+    model: string;
+    timeoutMs: number;
+    scrub(s: string): string;
+    onController(c: AbortController | null): void;
+    onError?(err: unknown): void;
+}
+export declare function generatePromptSuggestion(ctx: SuggestContext, deps: PromptSuggestionDeps): Promise<string | null>;

package/dist/cli/input/suggest-provider.d.ts

@@ -0,0 +1,9 @@
+import { type ProviderRouteHints } from '../../agent/providers/index.js';
+import type { ModelProvider } from '../../agent/provider.js';
+import type { SuggestContext } from './suggest.js';
+export declare function pickModel(ctx: SuggestContext): string;
+export interface ProviderPool {
+    resolve(model: string | undefined, hints: ProviderRouteHints | undefined): ModelProvider;
+    closeAll(): void;
+}
+export declare function createProviderPool(resolveProviderFn?: (model: string | undefined, hints: ProviderRouteHints | undefined) => ModelProvider): ProviderPool;

package/dist/cli/input/suggest-sanitize.d.ts

@@ -0,0 +1 @@
+export declare function stripGhostControlChars(text: string): string;

package/dist/cli/input/suggest-tier1.d.ts

@@ -0,0 +1,2 @@
+import type { SuggestContext } from './suggest.js';
+export declare function getDeterministicGhost(buffer: string, ctx: SuggestContext): string | null;

package/dist/cli/input/suggest-tier2.d.ts

@@ -0,0 +1,19 @@
+import type { CompleteFn } from './suggest-types.js';
+import type { SuggestContext } from './suggest.js';
+export declare const MIN_LLM_CHARS = 3;
+export declare const DEBOUNCE_MS = 250;
+export declare const TIMEOUT_MS = 1500;
+export declare function buildSystem(): string;
+export declare function buildUser(buffer: string, ctx: SuggestContext): string;
+export interface Tier2Deps {
+    pickModel(ctx: SuggestContext): string;
+    resolveComplete(model: string, ctx: SuggestContext): CompleteFn | null;
+    debounceMs: number;
+    timeoutMs: number;
+    onError?: (err: unknown) => void;
+}
+export interface Tier2Runner {
+    request(buffer: string, ctx: SuggestContext): Promise<string | null>;
+    cancel(): void;
+}
+export declare function createTier2Runner(deps: Tier2Deps): Tier2Runner;

package/dist/cli/input/suggest-types.d.ts

@@ -0,0 +1,39 @@
+import type { ModelProvider } from '../../agent/provider.js';
+import type { ProviderRouteHints } from '../../agent/providers/index.js';
+export interface SuggestContext {
+    model: string;
+    apiKey?: string;
+    baseUrl?: string;
+    cwd: string;
+    getHistory(): string[];
+    getDropdownTopCandidate(buffer: string): string | null;
+    getTranscriptTail(): string;
+    getRecentCommands(): string[];
+    llmEnabled(): boolean;
+    promptSuggestEnabled?(): boolean;
+}
+export interface CompleteRequest {
+    system: string;
+    user: string;
+    model: string;
+    maxTokens: number;
+    signal: AbortSignal;
+    apiKey?: string;
+    baseUrl?: string;
+}
+export type CompleteFn = (req: CompleteRequest) => Promise<string>;
+export interface SuggestEngineOptions {
+    completeFn?: CompleteFn;
+    resolveProviderFn?: (model: string | undefined, hints: ProviderRouteHints | undefined) => ModelProvider;
+    debounceMs?: number;
+    timeoutMs?: number;
+    onError?: (err: unknown) => void;
+}
+export interface SuggestEngine {
+    getDeterministicGhost(buffer: string, ctx: SuggestContext): string | null;
+    getGhost(buffer: string, ctx: SuggestContext): Promise<string | null>;
+    primePromptSuggestion(ctx: SuggestContext): Promise<void>;
+    peekPromptSuggestion(): string | null;
+    clearPromptSuggestion(): void;
+    dispose(): void;
+}

package/dist/cli/input/suggest.d.ts

@@ -1,36 +1,6 @@
-import { type ProviderRouteHints } from '../../agent/providers/index.js';
-import type { ModelProvider } from '../../agent/provider.js';
-export interface SuggestContext {
-    model: string;
-    apiKey?: string;
-    baseUrl?: string;
-    cwd: string;
-    getHistory(): string[];
-    getDropdownTopCandidate(buffer: string): string | null;
-    getTranscriptTail(): string;
-    getRecentCommands(): string[];
-    llmEnabled(): boolean;
-}
-export declare function stripGhostControlChars(text: string): string;
-export interface SuggestEngineOptions {
-    completeFn?: (args: {
-        system: string;
-        user: string;
-        model: string;
-        maxTokens: number;
-        signal: AbortSignal;
-        apiKey?: string;
-        baseUrl?: string;
-    }) => Promise<string>;
-    resolveProviderFn?: (model: string | undefined, hints: ProviderRouteHints | undefined) => ModelProvider;
-    debounceMs?: number;
-    timeoutMs?: number;
-    onError?: (err: unknown) => void;
-}
-export interface SuggestEngine {
-    getDeterministicGhost(buffer: string, ctx: SuggestContext): string | null;
-    getGhost(buffer: string, ctx: SuggestContext): Promise<string | null>;
-    dispose(): void;
-}
+import type { SuggestEngine, SuggestEngineOptions } from './suggest-types.js';
+export type { CompleteFn, CompleteRequest, SuggestContext, SuggestEngine, SuggestEngineOptions, } from './suggest-types.js';
+export { stripGhostControlChars } from './suggest-sanitize.js';
+export { pickModel } from './suggest-provider.js';
+export { getDeterministicGhost } from './suggest-tier1.js';
 export declare function createSuggestEngine(opts?: SuggestEngineOptions): SuggestEngine;
-export declare function pickModel(ctx: SuggestContext): string;

package/dist/cli/render/config-menu-model.d.ts

@@ -0,0 +1,20 @@
+import { type ConfigKeySpec } from '../../config/settable-keys.js';
+export declare const CATEGORY_ORDER: readonly ["Model & routing", "Interactive", "Session", "Telegram", "Advanced"];
+export declare function categoryOf(path: string): (typeof CATEGORY_ORDER)[number];
+interface MenuCategory {
+    name: (typeof CATEGORY_ORDER)[number];
+    keys: readonly ConfigKeySpec[];
+}
+export declare function buildCategories(specs: readonly ConfigKeySpec[]): MenuCategory[];
+export declare function formatValue(v: unknown): string;
+export declare function keyRowLabel(spec: ConfigKeySpec, current: unknown, pad: number, suffix?: string): string;
+type EditorPlan = {
+    kind: 'pick';
+    options: string[];
+} | {
+    kind: 'text';
+    help: string;
+};
+export declare function editorFor(spec: ConfigKeySpec): EditorPlan;
+export declare function makeValidator(spec: ConfigKeySpec): (raw: string) => string | null;
+export {};

package/dist/cli/render/config-menu.d.ts

@@ -1,23 +1,8 @@
 import type { TerminalCompositor } from '../terminal-compositor.js';
 import { type ConfigKeySpec } from '../../config/settable-keys.js';
-export declare const CATEGORY_ORDER: readonly ["Model & routing", "Interactive", "Session", "Telegram", "Advanced"];
-export declare function categoryOf(path: string): (typeof CATEGORY_ORDER)[number];
-interface MenuCategory {
-    name: (typeof CATEGORY_ORDER)[number];
-    keys: readonly ConfigKeySpec[];
-}
-export declare function buildCategories(specs: readonly ConfigKeySpec[]): MenuCategory[];
-export declare function formatValue(v: unknown): string;
-export declare function keyRowLabel(spec: ConfigKeySpec, current: unknown, pad: number): string;
-type EditorPlan = {
-    kind: 'pick';
-    options: string[];
-} | {
-    kind: 'text';
-    help: string;
-};
-export declare function editorFor(spec: ConfigKeySpec): EditorPlan;
-export declare function makeValidator(spec: ConfigKeySpec): (raw: string) => string | null;
+import { type ConfigProvenance } from '../config/provenance.js';
+import { type ProvenanceCache } from '../config/provenance-cache.js';
+import { type LiveApplyHandle, type LiveApplyOutcome } from '../config/live-apply.js';
 export interface MenuOverlays {
     pick(header: readonly string[], options: readonly string[]): Promise<number | null>;
     editText(header: readonly string[], initial: string, help: string, validate: (v: string) => string | null): Promise<string | null>;
@@ -27,8 +12,9 @@ export interface MenuIo {
     specs(): readonly ConfigKeySpec[];
     current(path: string): unknown;
     write(path: string, rawValue: string, allowHuman: boolean): string;
+    provenance?(path: string, cache?: ProvenanceCache): ConfigProvenance;
+    applyLive?(path: string, rawValue: string): Promise<LiveApplyOutcome>;
 }
 export declare function runConfigMenu(ov: MenuOverlays, io: MenuIo): Promise<void>;
 export declare function overlaysFromCompositor(c: TerminalCompositor): MenuOverlays;
-export declare function defaultIo(): MenuIo;
-export {};
+export declare function defaultIo(handle?: LiveApplyHandle): MenuIo;

package/dist/cli/terminal-compositor.autocomplete.d.ts

@@ -13,6 +13,4 @@ export interface AutocompleteHost {
     repaint(): void;
 }
 export declare function updateAutocomplete(self: AutocompleteHost): void;
-export declare function updateGhost(self: AutocompleteHost): void;
 export declare function applyDropdownSelection(self: AutocompleteHost): boolean;
-export declare function applyGhostAccept(self: AutocompleteHost): boolean;

package/dist/cli/terminal-compositor.d.ts

@@ -120,6 +120,8 @@ export declare class TerminalCompositor {
     renderInputLine(): string;
     updateAutocomplete(): void;
     updateGhost(): void;
+    primePromptGhost(): void;
+    dismissPromptGhost(): boolean;
     renderDropdownRows(): string[];
     renderHintRow(): string | null;
     repaint(): void;

package/dist/cli/terminal-compositor.ghost.d.ts

@@ -0,0 +1,5 @@
+import { type AutocompleteHost } from './terminal-compositor.autocomplete.js';
+export declare function primePromptGhost(self: AutocompleteHost): void;
+export declare function dismissPromptGhost(self: AutocompleteHost): boolean;
+export declare function updateGhost(self: AutocompleteHost): void;
+export declare function applyGhostAccept(self: AutocompleteHost): boolean;

package/dist/cli/terminal-compositor.input-dispatch.d.ts

@@ -10,6 +10,7 @@ export interface KeyDispatchHost {
     applyEdit(next: InputCoreState): boolean;
     updateAutocomplete(): void;
     updateGhost(): void;
+    dismissPromptGhost(): boolean;
     applyDropdownSelection(): boolean;
     applyGhostAccept(): boolean;
     readonly armed: boolean;