@kenkaiiii/ggcoder 5.74.2 → 5.75.0

package/dist/app-sidecar/autopilot-runner.js

@@ -0,0 +1,367 @@
+import fs from "node:fs/promises";
+import { buildKenAutopilotContext, buildKenAutopilotPlanContext } from "../core/ken-context.js";
+import { parseAutopilotVerdict } from "../core/autopilot-verdict.js";
+import { isWorkflowCommandText, countAssistantMessages, shouldStartAutopilotCycle, extractTurnToolCalls, isMechanicalOnlyTurn, } from "../core/autopilot-gate.js";
+import { driveAutopilotCycle, frameAutopilotInjection } from "../core/autopilot-cycle.js";
+import { autopilotMarkerCopySeed } from "../core/session-history.js";
+import { loadTasksSync, pruneDoneTasksSync, getNextPendingTask, markTaskInProgress, } from "../core/tasks-store.js";
+import { log } from "../core/logger.js";
+import { lastAssistantText } from "./ken-context.js";
+const AUTOMATION_PROVENANCE = {
+    source: "runtime",
+    kind: "automation",
+    visibility: "hidden",
+};
+export function createAutopilotRunner(ctx) {
+    // ── Autopilot orchestration ─────────────────────────────────
+    // One review = prompt the kenAuto session with the review digest, read its
+    // final assistant text, parse a verdict. Returns null on failure (surfaced as
+    // an autopilot_error frame) so the cycle stops rather than looping blind.
+    // `originalRequest` is the user prompt that started the turn under review —
+    // pinned in the digest so it can't scroll out during multi-round cycles.
+    async function runAutopilotReview(originalRequest) {
+        ctx.autopilotReviewing = true;
+        ctx.broadcast("autopilot_review_start", {});
+        try {
+            const ken = await ctx.ensureKenAutoSession();
+            const digest = buildKenAutopilotContext({
+                cwd: ctx.cwd,
+                gitBranch: ctx.gitBranch,
+                messages: ctx.session.getMessages(),
+                verificationEvidence: ctx.session.getVerificationEvidence(),
+                verificationProblem: ctx.session.getVerificationProblem(),
+                originalRequest,
+                injectedPrompts: [...ctx.injectedAutopilotPrompts],
+                workflowCommands: await ctx.loadWorkflowCommandSpecs(),
+            });
+            await ken.prompt(digest);
+            return parseAutopilotVerdict(lastAssistantText(ken.getMessages()));
+        }
+        catch (err) {
+            if (!ctx.autopilotCancelled)
+                ctx.broadcastError("autopilot_error", "autopilot review failed", err);
+            return null;
+        }
+        finally {
+            ctx.autopilotReviewing = false;
+            // Apply any model switch that landed mid-review.
+            const pending = ctx.pendingKenAutoModel;
+            ctx.pendingKenAutoModel = null;
+            if (pending)
+                await ctx.syncKenAutoModel(pending.provider, pending.model);
+        }
+    }
+    // One PLAN review: like runAutopilotReview but the digest carries the
+    // submitted plan's markdown (`## Plan under review`) and the plan-review
+    // instruction — Ken judges the plan itself, not finished work. Returns null
+    // on failure; a failure caused by the user's own action racing the review
+    // (cancel or a manual Accept/Reject that bumped planGeneration) stays
+    // SILENT — no autopilot_error — because the user's decision already won.
+    async function runAutopilotPlanReview(originalRequest) {
+        const planPath = ctx.pendingPlanPath;
+        if (planPath === null)
+            return null;
+        const genAtStart = ctx.planGeneration;
+        ctx.autopilotReviewing = true;
+        ctx.broadcast("autopilot_review_start", {});
+        try {
+            const ken = await ctx.ensureKenAutoSession();
+            // Re-read the plan file (the run may have revised it in place); fall
+            // back to the content captured at exit_plan time.
+            const planContent = await fs.readFile(planPath, "utf-8").catch(() => ctx.pendingPlanContent);
+            const digest = buildKenAutopilotPlanContext({
+                cwd: ctx.cwd,
+                gitBranch: ctx.gitBranch,
+                messages: ctx.session.getMessages(),
+                verificationEvidence: ctx.session.getVerificationEvidence(),
+                verificationProblem: ctx.session.getVerificationProblem(),
+                originalRequest,
+                injectedPrompts: [...ctx.injectedAutopilotPrompts],
+                workflowCommands: await ctx.loadWorkflowCommandSpecs(),
+                planContent,
+            });
+            await ken.prompt(digest);
+            if (ctx.autopilotCancelled || ctx.planGeneration !== genAtStart)
+                return null;
+            return parseAutopilotVerdict(lastAssistantText(ken.getMessages()));
+        }
+        catch (err) {
+            // User action mid-review (manual Accept aborts the kenAuto run): drop
+            // the review silently — the user's decision supersedes Ken's.
+            if (ctx.autopilotCancelled || ctx.planGeneration !== genAtStart)
+                return null;
+            ctx.broadcastError("autopilot_error", "autopilot plan review failed", err);
+            return null;
+        }
+        finally {
+            ctx.autopilotReviewing = false;
+            // Apply any model switch that landed mid-review.
+            const pending = ctx.pendingKenAutoModel;
+            ctx.pendingKenAutoModel = null;
+            if (pending)
+                await ctx.syncKenAutoModel(pending.provider, pending.model);
+        }
+    }
+    // Drive the review→prompt→review loop for one finished user turn. Only ever
+    // called after shouldStartAutopilotCycle approves the turn (POST /prompt or
+    // the stranded-queue drain) — never from the task runner, resume, /ken, or
+    // error paths, so there's no recursion and no guard tangle. The loop's
+    // control flow lives in driveAutopilotCycle (core/autopilot-cycle.ts) so
+    // every exit path is unit-tested; this only wires the real dependencies.
+    async function runAutopilotCycle(originalRequest) {
+        if (!ctx.autopilot || ctx.autopilotCancelled)
+            return;
+        // Unverified work skips a work review silently. A pending plan still enters
+        // the cycle so driveAutopilotCycle says WHY Ken stepped aside
+        // (autopilot_human) before the plan is handed to the user.
+        if (ctx.pendingPlanPath === null && ctx.session.getVerificationProblem())
+            return;
+        const generation = ctx.runLifecycle.begin(ctx.abortOwnedWork).generation;
+        ctx.pendingCancelDrain = null;
+        ctx.autopilotActive = true;
+        // Generation captured by the last plan review; acceptPlan re-checks it so
+        // a user Accept/Reject landing mid-review always wins.
+        let planGenAtReview = -1;
+        try {
+            await driveAutopilotCycle({
+                // A plan-pending cycle needs extra rounds: approve+implement and the
+                // post-implement work review each consume one, so +2 keeps a real fix
+                // round available.
+                maxRounds: ctx.pendingPlanPath !== null ? ctx.MAX_AUTOPILOT_ROUNDS + 2 : ctx.MAX_AUTOPILOT_ROUNDS,
+                isCancelled: () => ctx.autopilotCancelled,
+                verificationProblem: () => ctx.session.getVerificationProblem(),
+                // An injected run entering plan mode WITHOUT submitting (enter_plan,
+                // no exit_plan) halts the cycle — Ken never prompts into a read-only
+                // plan-mode session. A submitted plan takes the planPending branch.
+                isPlanMode: () => ctx.session.getPlanMode(),
+                planPending: () => ctx.pendingPlanPath !== null,
+                reviewPlan: async () => {
+                    planGenAtReview = ctx.planGeneration;
+                    return runAutopilotPlanReview(originalRequest);
+                },
+                // Auto-accept: the inlined POST /plan/accept body. Returns false when
+                // the plan generation moved since the review (user acted) — the cycle
+                // exits silently and the user's action stands.
+                acceptPlan: async (reason) => {
+                    if (ctx.pendingPlanPath === null || ctx.planGeneration !== planGenAtReview)
+                        return false;
+                    const planPath = ctx.pendingPlanPath;
+                    let planTotal;
+                    try {
+                        await ctx.session.newSession(true);
+                        ctx.injectedAutopilotPrompts = [];
+                        planTotal = await ctx.activateApprovedPlan(planPath);
+                    }
+                    catch (err) {
+                        ctx.broadcastError("autopilot_error", "autopilot plan accept failed", err);
+                        return false;
+                    }
+                    ctx.clearPendingPlan();
+                    // Keep the approval marker ahead of the reset, then seed the reset
+                    // with the sidecar's canonical count from the actual plan file.
+                    ctx.broadcast("autopilot_plan_accepted", reason ? { reason } : {});
+                    ctx.broadcast("session_reset", { planTotal });
+                    ctx.broadcast("plan_progress", ctx.planProgressPayload());
+                    // Persisted into the NEW session so a resume shows the marker.
+                    void ctx.session.persistAutopilotMarker("plan_approved", { reason });
+                    return true;
+                },
+                runImplement: () => {
+                    // Autopilot-injected run: frame it so GG Coder knows no human is
+                    // watching the implementation. Record the framed string so Ken's
+                    // digest labels it as injected, not as the user's ask. The run_start
+                    // label stays the clean prompt.
+                    const framed = frameAutopilotInjection(ctx.IMPLEMENT_PLAN_PROMPT);
+                    ctx.injectedAutopilotPrompts.push(framed);
+                    return ctx.runAgent(ctx.IMPLEMENT_PLAN_PROMPT, () => ctx.session.prompt(framed, AUTOMATION_PROVENANCE));
+                },
+                // Lean context per user turn: wipe prior review history so each new
+                // turn starts cheap, while within this cycle the few review messages
+                // persist so Ken remembers what he already asked GG Coder to fix.
+                resetReviewer: async () => {
+                    await ctx.kenAutoSession?.newSession().catch(() => { });
+                },
+                review: () => runAutopilotReview(originalRequest),
+                // prompt → record the injected body (so later digests label it as
+                // Ken's, not the user's), show a compact Ken-tinted marker (not the
+                // prompt body), then feed GG Coder bracketed by runAgent so the run
+                // streams normally; the shared finally never re-triggers autopilot,
+                // so this can't recurse.
+                onInjected: (body, round) => {
+                    // A revision injection supersedes the pending plan — if the run
+                    // resubmits via exit_plan, onExitPlan re-sets it (no-op for work-
+                    // branch injections, where nothing is pending).
+                    ctx.clearPendingPlan();
+                    // Record the FRAMED string (what actually lands in the build session,
+                    // see runPrompt) so Ken's digest matches and labels it as injected.
+                    // The webview marker + persisted body stay the CLEAN prompt so the UI
+                    // shows Ken's actual instruction, not the autopilot preamble.
+                    ctx.injectedAutopilotPrompts.push(frameAutopilotInjection(body));
+                    ctx.broadcast("autopilot_prompted", { round, body });
+                    void ctx.session.persistAutopilotMarker("prompted", { body });
+                },
+                // Autopilot-injected run: GG Coder receives the framed prompt (no human
+                // is watching this turn) while run_start keeps the clean label.
+                runPrompt: (body, opts) => ctx.runAgent(body, async () => {
+                    if (opts?.planRevision)
+                        await ctx.reenterPlanModeForRevision();
+                    await ctx.session.prompt(frameAutopilotInjection(body), AUTOMATION_PROVENANCE);
+                }),
+                emit: (event) => {
+                    // Persist the terminal verdict marker so a resumed session renders the
+                    // same Ken bubble the live run showed instead of dropping it or
+                    // falling back to the raw verdict text (e.g. ALL_CLEAR).
+                    if (event.type === "autopilot_done") {
+                        // Broadcast the SAME copySeed the persisted marker will produce on
+                        // resume, so the live all-clear wording matches the resumed one.
+                        // Must use the PERSISTED count — that's what persistAutopilotMarker
+                        // anchors against, and it trails the in-memory list after a run
+                        // whose messages never made it to disk.
+                        const seed = autopilotMarkerCopySeed({
+                            version: 1,
+                            phase: "done",
+                            afterMessageCount: ctx.session.getPersistedTranscriptCount(),
+                            ...event.data,
+                        });
+                        ctx.broadcast(event.type, { ...event.data, copySeed: seed });
+                        void ctx.session.persistAutopilotMarker("done", event.data);
+                        return;
+                    }
+                    ctx.broadcast(event.type, event.data);
+                    if (event.type === "autopilot_human") {
+                        void ctx.session.persistAutopilotMarker("human", { reason: event.data.reason });
+                    }
+                    else if (event.type === "autopilot_capped") {
+                        void ctx.session.persistAutopilotMarker("capped");
+                    }
+                    // autopilot_ignored renders nothing live, so nothing is persisted either.
+                },
+            });
+        }
+        finally {
+            ctx.autopilotActive = false;
+            ctx.finishOwnedGeneration(generation, true, ctx.session.getVerificationProblem() ? "unverified" : "completed");
+            queueMicrotask(() => void runStrandedQueue());
+        }
+    }
+    async function runStrandedQueue() {
+        if (ctx.drainingStrandedQueue)
+            return;
+        ctx.drainingStrandedQueue = true;
+        try {
+            for (;;) {
+                if (ctx.running || ctx.autopilotActive)
+                    return;
+                const next = ctx.session.takeNextQueuedMessage();
+                if (!next)
+                    return;
+                ctx.broadcast("queued", {
+                    count: ctx.session.getQueuedCount(),
+                    messages: ctx.session.listQueuedMessages(),
+                });
+                if (!next.text.trim() && next.attachments.length === 0)
+                    continue;
+                // A queued message draining as a fresh turn supersedes any pending
+                // plan and clears a stale Stop, exactly like a direct POST /prompt
+                // turn — otherwise an earlier Stop silently disables Ken for this turn.
+                ctx.clearPendingPlan();
+                ctx.autopilotCancelled = false;
+                const workflowCommand = next.attachments.length === 0 &&
+                    isWorkflowCommandText(next.text, await ctx.loadWorkflowCommandSpecs());
+                const assistantsBefore = countAssistantMessages(ctx.session.getMessages());
+                const messagesBefore = ctx.session.getMessages().length;
+                await ctx.runAgent(next.text, async () => {
+                    if (next.attachments.length > 0) {
+                        await ctx.session.promptWithAttachments(next.text, next.attachments);
+                    }
+                    else {
+                        await ctx.session.prompt(next.text);
+                    }
+                }, () => ctx.autopilot);
+                const decision = shouldStartAutopilotCycle({
+                    enabled: ctx.autopilot,
+                    cancelled: ctx.autopilotCancelled,
+                    planMode: ctx.session.getPlanMode(),
+                    // A submitted plan (exit_plan fired) routes into the PLAN review
+                    // branch — the cycle reviews the plan itself instead of skipping.
+                    planPending: ctx.pendingPlanPath !== null,
+                    workflowCommand,
+                    assistantMessagesAdded: countAssistantMessages(ctx.session.getMessages()) - assistantsBefore,
+                    // Skip the review API call outright for turns that only started a
+                    // background process (dev server/watcher), ran a read-only lookup, or
+                    // committed/pushed — Ken's autopilot contract already IGNOREs these,
+                    // so there's no reason to pay for that verdict.
+                    mechanicalOnly: isMechanicalOnlyTurn(extractTurnToolCalls(ctx.session.getMessages(), messagesBefore)),
+                });
+                if (decision.start) {
+                    log("INFO", "app-sidecar", "autopilot cycle starting (queued turn)", {
+                        kind: decision.kind,
+                    });
+                    await runAutopilotCycle(next.text);
+                }
+                else {
+                    ctx.broadcast("autopilot_ignored", { reason: decision.reason });
+                    log("INFO", "app-sidecar", "autopilot skipped (queued turn)", {
+                        reason: decision.reason,
+                    });
+                }
+            }
+        }
+        finally {
+            ctx.drainingStrandedQueue = false;
+            ctx.offerPendingPlan();
+        }
+    }
+    async function runTaskById(taskId) {
+        const task = loadTasksSync(ctx.cwd).find((t) => t.id === taskId || t.id.startsWith(taskId));
+        if (!task)
+            return false;
+        // Fresh session per task so one task's context never bleeds into the next.
+        await ctx.session.newSession();
+        ctx.deactivateApprovedPlan();
+        ctx.injectedAutopilotPrompts = [];
+        ctx.clearPendingPlan();
+        ctx.broadcast("session_reset", {});
+        markTaskInProgress(ctx.cwd, task.id);
+        ctx.broadcast("tasks_list", { tasks: loadTasksSync(ctx.cwd) });
+        ctx.broadcast("task_start", { id: task.id, title: task.title });
+        // Persist the task header so a resumed task session shows what ran.
+        void ctx.session.persistAppMarker("task", { title: task.title }).catch(() => { });
+        const shortId = task.id.slice(0, 8);
+        const completionHint = `\n\n---\nWhen you have fully completed this task, call the tasks tool to mark it done:\n` +
+            `tasks({ action: "done", id: "${shortId}" })`;
+        await ctx.runAgent(task.title, () => ctx.session.prompt(task.prompt + completionHint, AUTOMATION_PROVENANCE));
+        // The agent typically marks the task done via the tasks tool during the run;
+        // prune completed tasks and push the refreshed list so the modal drops them.
+        ctx.broadcast("tasks_list", { tasks: pruneDoneTasksSync(ctx.cwd) });
+        return true;
+    }
+    async function runTasks(startId, all) {
+        ctx.taskRunAll = all;
+        let currentId = startId ?? getNextPendingTask(ctx.cwd)?.id ?? null;
+        while (currentId) {
+            const ran = await runTaskById(currentId);
+            if (!ran || !ctx.taskRunAll)
+                break;
+            const next = getNextPendingTask(ctx.cwd);
+            currentId = next ? next.id : null;
+            // Brief pause between tasks (mirrors the CLI cadence).
+            if (currentId)
+                await new Promise((resolve) => setTimeout(resolve, 500));
+        }
+        ctx.taskRunAll = false;
+        ctx.broadcast("tasks_run_done", {});
+        // Task runs never start an autopilot cycle; a plan a task submitted goes
+        // straight to the user.
+        ctx.offerPendingPlan();
+    }
+    return {
+        runAutopilotReview,
+        runAutopilotPlanReview,
+        runAutopilotCycle,
+        runStrandedQueue,
+        runTaskById,
+        runTasks,
+    };
+}
+//# sourceMappingURL=autopilot-runner.js.map

package/dist/app-sidecar/autopilot-runner.js.map

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

package/dist/app-sidecar/file-search.d.ts

@@ -0,0 +1,15 @@
+export interface FileHit {
+    /** Project-relative POSIX path, e.g. "src/App.tsx". */
+    path: string;
+    /** File name only, e.g. "App.tsx". */
+    name: string;
+}
+export declare const FILE_SEARCH_LIMIT = 20;
+export declare const FILE_SEARCH_SCAN_CAP = 50000;
+/** Score a candidate path against a lowercased query. Higher is better; a
+ *  negative score means "no match". Basename hits beat path hits; prefix beats
+ *  substring; shorter paths break ties. */
+export declare function scoreFile(relPath: string, name: string, query: string): number;
+/** True when every char of `needle` appears in `haystack` in order (fuzzy). */
+export declare function subsequenceMatch(haystack: string, needle: string): boolean;
+export declare function searchProjectFiles(cwd: string, rawQuery: string): Promise<FileHit[]>;

package/dist/app-sidecar/file-search.js

@@ -0,0 +1,103 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { log } from "../core/logger.js";
+export const FILE_SEARCH_LIMIT = 20;
+// Upper bound on files walked per search (baseline #8 memory cap). Far above the
+// 20-result output limit, so relevance/recency ranking is unaffected in practice.
+export const FILE_SEARCH_SCAN_CAP = 50_000;
+/** Score a candidate path against a lowercased query. Higher is better; a
+ *  negative score means "no match". Basename hits beat path hits; prefix beats
+ *  substring; shorter paths break ties. */
+export function scoreFile(relPath, name, query) {
+    const lcPath = relPath.toLowerCase();
+    const lcName = name.toLowerCase();
+    let score = -1;
+    if (lcName === query)
+        score = 1000;
+    else if (lcName.startsWith(query))
+        score = 800;
+    else if (lcName.includes(query))
+        score = 600;
+    else if (lcPath.startsWith(query))
+        score = 400;
+    else if (lcPath.includes(query))
+        score = 200;
+    else if (subsequenceMatch(lcPath, query))
+        score = 100;
+    if (score < 0)
+        return -1;
+    // Prefer shorter paths (closer to root, less nesting) on equal match class.
+    return score - relPath.length * 0.1;
+}
+/** True when every char of `needle` appears in `haystack` in order (fuzzy). */
+export function subsequenceMatch(haystack, needle) {
+    let i = 0;
+    for (const ch of haystack) {
+        if (ch === needle[i])
+            i++;
+        if (i === needle.length)
+            return true;
+    }
+    return needle.length === 0;
+}
+export async function searchProjectFiles(cwd, rawQuery) {
+    const fg = await import("fast-glob");
+    const ignore = await import("ignore");
+    const query = rawQuery.trim().toLowerCase();
+    let gitignore = [];
+    try {
+        const content = await fs.readFile(path.join(cwd, ".gitignore"), "utf-8");
+        gitignore = content
+            .split("\n")
+            .map((l) => l.trim())
+            .filter((l) => l && !l.startsWith("#"));
+    }
+    catch {
+        // No .gitignore — nothing extra to ignore.
+    }
+    const ig = ignore.default().add(gitignore);
+    // `stats: true` gives mtime without a second stat pass, so the empty-query
+    // "recent files" path is a single walk. Stream + hard scan cap (baseline #8):
+    // collecting the full result array retained ~0.9 MB per 1k files (18.5 MB at
+    // 20k), unbounded. Bail after FILE_SEARCH_SCAN_CAP entries so a giant repo
+    // can't balloon RSS; the newest/most-relevant matches still surface because
+    // the cap is far above the 20-result output limit.
+    const entries = [];
+    const scanStream = fg.default.stream("**/*", {
+        cwd,
+        dot: false,
+        onlyFiles: true,
+        ignore: ["**/node_modules/**", "**/.git/**", "**/.gg/**"],
+        suppressErrors: true,
+        followSymbolicLinks: false,
+        stats: true,
+    });
+    for await (const entry of scanStream) {
+        entries.push(entry);
+        if (entries.length >= FILE_SEARCH_SCAN_CAP) {
+            scanStream.destroy();
+            log("DEBUG", "app-sidecar", "file search scan cap hit", {
+                cap: String(FILE_SEARCH_SCAN_CAP),
+                cwd,
+            });
+            break;
+        }
+    }
+    const files = entries.filter((e) => !ig.ignores(e.path));
+    if (!query) {
+        return files
+            .sort((a, b) => (b.stats?.mtimeMs ?? 0) - (a.stats?.mtimeMs ?? 0))
+            .slice(0, FILE_SEARCH_LIMIT)
+            .map((e) => ({ path: e.path, name: path.posix.basename(e.path) }));
+    }
+    const scored = [];
+    for (const e of files) {
+        const name = path.posix.basename(e.path);
+        const score = scoreFile(e.path, name, query);
+        if (score >= 0)
+            scored.push({ hit: { path: e.path, name }, score });
+    }
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, FILE_SEARCH_LIMIT).map((s) => s.hit);
+}
+//# sourceMappingURL=file-search.js.map

package/dist/app-sidecar/file-search.js.map

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

package/dist/app-sidecar/hf-pull-manager.d.ts

@@ -0,0 +1,20 @@
+import type { AppPaths, LocalEndpointProbe } from "@kenkaiiii/gg-core";
+import { type HfSearchRow } from "../hf-pull.js";
+import type { HfPullState } from "./session-types.js";
+export interface HfPullManager {
+    /** Current/last pull (terminal state kept until the next pull). */
+    hfPull: HfPullState | null;
+    hfPullPayload: (s: HfPullState) => Record<string, unknown>;
+    hfSearch: (query: string) => Promise<HfSearchRow[]>;
+    startHfPull: (repo: string) => Promise<Record<string, unknown>>;
+    cancelHfPull: () => boolean;
+}
+/** Per-session Hugging Face → Ollama pull state + Hub search (moved verbatim
+ *  out of `createSession`). */
+export declare function createHfPullManager(deps: {
+    paths: AppPaths;
+    broadcast: (type: string, data: unknown) => void;
+    broadcastAll: (type: string, data: unknown) => void;
+    scanLocalModels: (force: boolean) => Promise<LocalEndpointProbe[]>;
+    localStatePayload: () => unknown;
+}): HfPullManager;