@av-pi-studio/server 0.0.72 → 0.0.74

package/dist/extensions/sync-executor.d.ts

@@ -0,0 +1,55 @@
+import type { PersistedConfig } from "../config/daemon-config.js";
+import type { Logger } from "../logging/logger.js";
+import type { SyncPlan } from "./sync-planner.js";
+/**
+ * Runs a `SyncPlan` by spawning `pi install <spec>` per action, one package succeeding or failing
+ * never affecting another (swe/features/preinstalled-extensions.md § Executor — tenet 5). Every
+ * planned action is attempted regardless of how many earlier ones failed; state is committed after
+ * **each** action so a crash mid-sync loses neither the successes already achieved nor the failure
+ * diagnostics already gathered.
+ */
+export type ExtensionFailureReason = "not_found" | "unauthorized" | "network" | "timeout" | "install_failed" | "spawn_failed" | "unknown";
+export interface SyncReport {
+    at: string;
+    outcome: "ok" | "noop" | "partial" | "failed" | "skipped";
+    installed: string[];
+    failures: {
+        identity: string;
+        source: string;
+        pack: string;
+        reason: ExtensionFailureReason;
+        message: string;
+    }[];
+}
+/** Injectable process seam — tests pass a fake; production spawns the bundled pi. The seam owns
+ *  the per-package timeout and the process-tree kill; the executor only interprets the result. */
+export interface InstallSpawn {
+    (args: {
+        command: string[];
+        env: Record<string, string>;
+        timeoutMs: number;
+    }): Promise<{
+        exitCode: number | null;
+        stderr: string;
+        timedOut?: boolean;
+    }>;
+}
+/** The production seam: spawns `command`, captures stderr (unbounded here — the executor bounds
+ *  what it stores), and kills the whole process tree on timeout rather than just the direct child,
+ *  so a `pi install` that itself forked a build/postinstall step doesn't linger. */
+export declare const defaultInstallSpawn: InstallSpawn;
+/** Maps a spawn result (non-zero exit / timeout) or a caught throw to the reason taxonomy.
+ *  Best-effort and cosmetic — misclassification never affects whether the run continues, whether
+ *  other packages are attempted, or whether the entry is retried later (all three unconditional). */
+export declare function classify(input: unknown): ExtensionFailureReason;
+export declare function executePlan(plan: SyncPlan, deps: {
+    home: string;
+    /** State-file key for this pi-home (`effectivePiHomeKey(config)` — kept separate from the env
+     *  derivation below so a caller mistake in this value can never redirect installs). */
+    piHomeKey: string;
+    config: PersistedConfig;
+    spawn?: InstallSpawn;
+    logger: Logger;
+    now?: () => Date;
+}): Promise<SyncReport>;
+//# sourceMappingURL=sync-executor.d.ts.map

package/dist/extensions/sync-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-executor.d.ts","sourceRoot":"","sources":["../../src/extensions/sync-executor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAQnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;;;GAMG;AAEH,MAAM,MAAM,sBAAsB,GAC9B,WAAW,GACX,cAAc,GACd,SAAS,GACT,SAAS,GACT,gBAAgB,GAChB,cAAc,GACd,SAAS,CAAC;AAEd,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC1D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,sBAAsB,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC;KACjB,EAAE,CAAC;CACL;AAED;kGACkG;AAClG,MAAM,WAAW,YAAY;IAC3B,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QACrF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;CACJ;AAKD;;oFAEoF;AACpF,eAAO,MAAM,mBAAmB,EAAE,YAgC9B,CAAC;AAEL;;qGAEqG;AACrG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAW/D;AAoCD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE;IACJ,IAAI,EAAE,MAAM,CAAC;IACb;2FACuF;IACvF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB,GACA,OAAO,CAAC,UAAU,CAAC,CAqFrB"}

package/dist/extensions/sync-executor.js

@@ -0,0 +1,158 @@
+import { spawn } from "node:child_process";
+import treeKill from "tree-kill";
+import { resolveBundledPiCli } from "../agent/providers/pi/rpc-transport.js";
+import { SERVER_VERSION } from "./curated-packs.js";
+import { effectivePiHomeKey, loadExtensionsState, saveExtensionsState, } from "./extensions-state.js";
+const INSTALL_TIMEOUT_MS = 180_000;
+const STDERR_TAIL_MAX = 2048;
+/** The production seam: spawns `command`, captures stderr (unbounded here — the executor bounds
+ *  what it stores), and kills the whole process tree on timeout rather than just the direct child,
+ *  so a `pi install` that itself forked a build/postinstall step doesn't linger. */
+export const defaultInstallSpawn = ({ command, env, timeoutMs }) => new Promise((resolve, reject) => {
+    const [bin, ...args] = command;
+    const child = spawn(bin, args, { env, stdio: ["ignore", "ignore", "pipe"] });
+    let stderr = "";
+    let timedOut = false;
+    let settled = false;
+    const timer = setTimeout(() => {
+        timedOut = true;
+        if (child.pid !== undefined)
+            treeKill(child.pid, "SIGKILL", () => undefined);
+        else
+            child.kill("SIGKILL");
+    }, timeoutMs);
+    child.stderr?.on("data", (chunk) => {
+        stderr += chunk.toString("utf8");
+    });
+    child.on("error", (err) => {
+        if (settled)
+            return;
+        settled = true;
+        clearTimeout(timer);
+        reject(err);
+    });
+    child.on("exit", (code) => {
+        if (settled)
+            return;
+        settled = true;
+        clearTimeout(timer);
+        resolve({ exitCode: code, stderr, timedOut });
+    });
+});
+/** Maps a spawn result (non-zero exit / timeout) or a caught throw to the reason taxonomy.
+ *  Best-effort and cosmetic — misclassification never affects whether the run continues, whether
+ *  other packages are attempted, or whether the entry is retried later (all three unconditional). */
+export function classify(input) {
+    if (input && typeof input === "object" && "exitCode" in input) {
+        if ("timedOut" in input && input.timedOut === true)
+            return "timeout";
+        const stderr = "stderr" in input && typeof input.stderr === "string" ? input.stderr : "";
+        if (/\b404\b|E404/.test(stderr))
+            return "not_found";
+        if (/\b40[13]\b|E40[13]/.test(stderr))
+            return "unauthorized";
+        if (/ENOTFOUND|ECONNREFUSED|ETIMEDOUT|EAI_AGAIN|\b5\d\d\b/.test(stderr))
+            return "network";
+        return "install_failed";
+    }
+    const message = input instanceof Error ? input.message : String(input);
+    return /ENOENT/.test(message) ? "spawn_failed" : "unknown";
+}
+function recordFailure(piHomeState, report, action, reason, message, at) {
+    const attempts = (piHomeState.failures[action.identity]?.attempts ?? 0) + 1;
+    piHomeState.failures[action.identity] = { source: action.source, reason, message, attempts, at };
+    report.failures.push({
+        identity: action.identity,
+        source: action.source,
+        pack: action.pack,
+        reason,
+        message,
+    });
+}
+function deriveOutcome(report) {
+    if (report.failures.length === 0)
+        return "ok";
+    return report.installed.length > 0 ? "partial" : "failed";
+}
+/** A `process.env` snapshot with `undefined` entries dropped, so callers get a plain
+ *  `Record<string, string>` without an unchecked cast. */
+function processEnvSnapshot() {
+    const env = {};
+    for (const [key, value] of Object.entries(process.env)) {
+        if (value !== undefined)
+            env[key] = value;
+    }
+    return env;
+}
+export async function executePlan(plan, deps) {
+    const now = deps.now ?? (() => new Date());
+    if (plan.actions.length === 0) {
+        return { at: now().toISOString(), outcome: "noop", installed: [], failures: [] };
+    }
+    const cli = resolveBundledPiCli();
+    if (!cli) {
+        deps.logger.warn("no bundled pi CLI resolvable — extensions sync skipped");
+        return { at: now().toISOString(), outcome: "skipped", installed: [], failures: [] };
+    }
+    const loaded = await loadExtensionsState(deps.home);
+    if (loaded === "unreadable") {
+        deps.logger.error("extensions-state.json is unreadable — extensions sync skipped");
+        return { at: now().toISOString(), outcome: "skipped", installed: [], failures: [] };
+    }
+    const state = loaded;
+    const piHomeState = state.piHomes[deps.piHomeKey] ?? { offered: {}, failures: {} };
+    state.piHomes[deps.piHomeKey] = piHomeState;
+    const spawnFn = deps.spawn ?? defaultInstallSpawn;
+    // SAME derivation as the state key and the spawn path (features/preinstalled-extensions.md §
+    // Public Contract — Effective pi-home key) — computed fresh from `config` rather than trusted
+    // from `piHomeKey`, so this env var can never diverge from what a live agent would receive.
+    const env = {
+        ...processEnvSnapshot(),
+        PI_CODING_AGENT_DIR: effectivePiHomeKey(deps.config),
+        GIT_TERMINAL_PROMPT: "0",
+        GIT_SSH_COMMAND: "ssh -oBatchMode=yes",
+        npm_config_yes: "true",
+    };
+    const report = { at: "", outcome: "ok", installed: [], failures: [] };
+    for (const action of plan.actions) {
+        const at = now().toISOString();
+        try {
+            const result = await spawnFn({
+                command: [process.execPath, cli, "install", action.source],
+                env,
+                timeoutMs: INSTALL_TIMEOUT_MS,
+            });
+            if (result.exitCode === 0) {
+                piHomeState.offered[action.identity] = {
+                    installedSpec: action.source,
+                    atVersion: SERVER_VERSION,
+                    at,
+                };
+                delete piHomeState.failures[action.identity];
+                report.installed.push(action.identity);
+                deps.logger.info({ identity: action.identity, source: action.source }, "installed recommended extension");
+            }
+            else {
+                const reason = classify(result);
+                const message = result.stderr.length > STDERR_TAIL_MAX
+                    ? result.stderr.slice(-STDERR_TAIL_MAX)
+                    : result.stderr;
+                recordFailure(piHomeState, report, action, reason, message, at);
+                deps.logger.warn({ identity: action.identity, source: action.source, reason }, "failed to install recommended extension");
+            }
+        }
+        catch (error) {
+            const reason = classify(error);
+            const message = error instanceof Error ? error.message : String(error);
+            recordFailure(piHomeState, report, action, reason, message, at);
+            deps.logger.warn({ identity: action.identity, source: action.source, reason }, "failed to install recommended extension");
+        }
+        finally {
+            await saveExtensionsState(deps.home, state);
+        }
+    }
+    report.at = now().toISOString();
+    report.outcome = deriveOutcome(report);
+    return report;
+}
+//# sourceMappingURL=sync-executor.js.map

package/dist/extensions/sync-executor.js.map

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

package/dist/extensions/sync-planner.d.ts

@@ -0,0 +1,62 @@
+import type { CuratedPackCatalog } from "./curated-packs.js";
+import type { PiHomeState } from "./extensions-state.js";
+/**
+ * The pure sync planner: a single three-way merge over the manifest, the state file, and pi's live
+ * `settings.json` (swe/features/preinstalled-extensions.md § Planner). No filesystem, no process,
+ * no clock — this is the one code path behind both "what sync would do" (task 005's executor) and
+ * "what we report" (a future `extensions list`, run in dry-run mode), so the two can never drift.
+ *
+ * The load-bearing rule (tenet 1): sync's only action is installing an identity it has never
+ * successfully installed before **and** that isn't already present in `settings.json` under any
+ * form — the latter matters because pi's own `pi install` matches an existing entry by
+ * version-insensitive identity and rewrites it in place (see `findByIdentity` below), so
+ * installing over an entry the user already added themselves — pinned, filtered, or otherwise —
+ * would silently destroy it. Once an identity enters `offered`, or is found already present before
+ * ever being offered, no future plan ever contains an action for it again — `user_removed`/
+ * `user_modified` are terminal, reporting-only statuses.
+ */
+export type EntryStatus = "installed" | "pending" | "failed" | "user_removed" | "user_modified" | "deprecated";
+export interface PlannedEntry {
+    identity: string;
+    pack: string;
+    source: string;
+    addedIn: string;
+    deprecated?: boolean;
+    status: EntryStatus;
+}
+export interface SyncPlan {
+    /** Installs, in manifest order. */
+    actions: {
+        identity: string;
+        pack: string;
+        source: string;
+    }[];
+    /** Every selected entry, including no-action ones. */
+    entries: PlannedEntry[];
+}
+/** A `PlannedEntry` with its last recorded failure attached, when one exists — shared by
+ *  `ExtensionsService.describe()` (the daemon path) and the CLI's `extensions list --local`
+ *  (sprint-057/task-005), so the two report identical data from the same state, never a
+ *  hand-rolled second derivation. */
+export interface DescribedEntry extends PlannedEntry {
+    lastError?: {
+        at: string;
+        attempts: number;
+        reason: string;
+        message: string;
+    };
+}
+/** Attaches each entry's `state.failures[identity]`, when present, as `lastError` — one snapshot,
+ *  one shape, never a second `loadExtensionsState` read by a caller (that would risk interleaving
+ *  with the mutex-guarded sync writing the same file on the daemon path). */
+export declare function attachLastErrors(entries: readonly PlannedEntry[], state: PiHomeState | "unreadable"): DescribedEntry[];
+export declare function planSync(input: {
+    catalog: CuratedPackCatalog;
+    /** Selected slugs; `core` is implicit (added by `selectEntries`). */
+    packs: readonly string[];
+    /** Per-pi-home slice, or the corrupt-state fail-safe sentinel. */
+    state: PiHomeState | "unreadable";
+    /** Pi's live `settings.json` `packages` array — string or object entries. */
+    settingsPackages: readonly unknown[];
+}): SyncPlan;
+//# sourceMappingURL=sync-planner.d.ts.map

package/dist/extensions/sync-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-planner.d.ts","sourceRoot":"","sources":["../../src/extensions/sync-planner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,eAAe,GACf,YAAY,CAAC;AAEjB,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,mCAAmC;IACnC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9D,sDAAsD;IACtD,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;;qCAGqC;AACrC,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,SAAS,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/E;AAED;;6EAE6E;AAC7E,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,KAAK,EAAE,WAAW,GAAG,YAAY,GAChC,cAAc,EAAE,CAgBlB;AAiCD,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAC9B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,qEAAqE;IACrE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,kEAAkE;IAClE,KAAK,EAAE,WAAW,GAAG,YAAY,CAAC;IAClC,6EAA6E;IAC7E,gBAAgB,EAAE,SAAS,OAAO,EAAE,CAAC;CACtC,GAAG,QAAQ,CAwDX"}

package/dist/extensions/sync-planner.js

@@ -0,0 +1,103 @@
+import { identityOf, selectEntries } from "./curated-packs.js";
+/** Attaches each entry's `state.failures[identity]`, when present, as `lastError` — one snapshot,
+ *  one shape, never a second `loadExtensionsState` read by a caller (that would risk interleaving
+ *  with the mutex-guarded sync writing the same file on the daemon path). */
+export function attachLastErrors(entries, state) {
+    const failures = state === "unreadable" ? {} : state.failures;
+    return entries.map((entry) => {
+        const failure = failures[entry.identity];
+        return failure
+            ? {
+                ...entry,
+                lastError: {
+                    at: failure.at,
+                    attempts: failure.attempts,
+                    reason: failure.reason,
+                    message: failure.message,
+                },
+            }
+            : entry;
+    });
+}
+/** Pi's own rule (`getPackageSourceString`, package-manager.js): a settings package entry is
+ *  either the source string itself, or an object carrying it under `.source` (the user's own
+ *  per-package filter form). */
+function packageSourceString(entry) {
+    if (typeof entry === "string")
+        return entry;
+    if (entry && typeof entry === "object" && "source" in entry && typeof entry.source === "string") {
+        return entry.source;
+    }
+    return undefined;
+}
+/** Find the settings entry matching `identity`, string or object form, without ever touching
+ *  entries that don't belong to us (unparseable/local-path entries are simply skipped). */
+function findByIdentity(settingsPackages, identity) {
+    for (const raw of settingsPackages) {
+        const sourceString = packageSourceString(raw);
+        if (sourceString === undefined)
+            continue;
+        try {
+            if (identityOf(sourceString) === identity) {
+                return { isObjectForm: typeof raw !== "string", sourceString };
+            }
+        }
+        catch {
+            continue; // Not an npm:/git: spec we understand — not one of ours, never examined.
+        }
+    }
+    return undefined;
+}
+export function planSync(input) {
+    const { catalog, packs, state, settingsPackages } = input;
+    const { entries: selected } = selectEntries(catalog, packs);
+    const actions = [];
+    const entries = [];
+    for (const { pack, entry } of selected) {
+        const identity = identityOf(entry.source);
+        const base = { identity, pack, source: entry.source, addedIn: entry.addedIn };
+        if (entry.deprecated) {
+            entries.push({ ...base, deprecated: true, status: "deprecated" });
+            continue; // Tombstone: no action, ever — checked first, ahead of any offered/failure lookup.
+        }
+        if (state === "unreadable") {
+            // Fail-safe: plan zero actions. Statuses are unreliable in this mode by design — report as
+            // if everything were already offered (wrong-and-quiet), never as "pending" (which would
+            // wrongly imply the next sync retries it).
+            entries.push({ ...base, status: "installed" });
+            continue;
+        }
+        const offered = state.offered[identity];
+        if (!offered) {
+            // Never install over an entry the user already has, even one Pi-Studio never offered: pi's
+            // own `addSourceToSettings` matches by version-insensitive identity and rewrites an existing
+            // entry in place (package-manager.js's `packageSourcesMatch`/`getSourceMatchKeyForSettings`),
+            // so `pi install npm:<name>` against a user's own `npm:<name>@1.2.3` would silently destroy
+            // their pin. Adopt it as theirs instead of installing over it — tenet 1, no exceptions for
+            // "we never touched this one yet".
+            const preexisting = findByIdentity(settingsPackages, identity);
+            if (preexisting) {
+                entries.push({ ...base, status: "user_modified" });
+                continue;
+            }
+            actions.push({ identity, pack, source: entry.source });
+            const failed = Boolean(state.failures[identity]);
+            entries.push({ ...base, status: failed ? "failed" : "pending" });
+            continue;
+        }
+        const match = findByIdentity(settingsPackages, identity);
+        let status;
+        if (!match) {
+            status = "user_removed"; // Offered, absent from settings — a `pi remove` sticks forever.
+        }
+        else if (match.isObjectForm || match.sourceString !== offered.installedSpec) {
+            status = "user_modified"; // Any edit — repin, object-filter form — permanently theirs.
+        }
+        else {
+            status = "installed";
+        }
+        entries.push({ ...base, status });
+    }
+    return { actions, entries };
+}
+//# sourceMappingURL=sync-planner.js.map

package/dist/extensions/sync-planner.js.map

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

package/dist/extensions/wire.d.ts

@@ -0,0 +1,7 @@
+import type { ExtensionPackInfo } from "@av-pi-studio/protocol";
+import type { CuratedPackCatalog } from "./curated-packs.js";
+import type { DescribedEntry } from "./sync-planner.js";
+/** Groups the planner's flat `entries` by pack, in manifest order, and attaches each pack's
+ *  `title`/`description` from the catalog — the wire shape groups by pack, the planner doesn't. */
+export declare function toExtensionPackInfoList(catalog: CuratedPackCatalog, entries: readonly DescribedEntry[]): ExtensionPackInfo[];
+//# sourceMappingURL=wire.d.ts.map

package/dist/extensions/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/extensions/wire.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAqC,MAAM,mBAAmB,CAAC;AAmC3F;mGACmG;AACnG,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,SAAS,cAAc,EAAE,GACjC,iBAAiB,EAAE,CAerB"}

package/dist/extensions/wire.js

@@ -0,0 +1,51 @@
+/**
+ * Maps `DescribedEntry[]` (the planner's own output, `lastError`-attached) to the wire's
+ * `ExtensionPackInfo[]` shape (task-001) — the ONE implementation, shared by the daemon's
+ * `extension_packs_list_request`/`_set_request` handlers (`extensions-rpc.ts`) and the CLI's
+ * `extensions list --local` (sprint-057/task-005), so the two can never render different data for
+ * the same state.
+ */
+/**
+ * Total mapping from the planner's `EntryStatus` to the wire's (plain-string) status. A `Record`
+ * keyed by the imported planner type means a build error, not a silent runtime gap, the moment
+ * either side gains a value the other doesn't handle.
+ */
+const ENTRY_STATUS_TO_WIRE = {
+    installed: "installed",
+    pending: "pending",
+    failed: "failed",
+    user_removed: "user_removed",
+    user_modified: "user_modified",
+    deprecated: "deprecated",
+};
+function toWireEntry(entry) {
+    return {
+        source: entry.source,
+        identity: entry.identity,
+        addedIn: entry.addedIn,
+        ...(entry.deprecated !== undefined ? { deprecated: entry.deprecated } : {}),
+        status: ENTRY_STATUS_TO_WIRE[entry.status],
+        ...(entry.lastError ? { lastError: entry.lastError } : {}),
+    };
+}
+/** Groups the planner's flat `entries` by pack, in manifest order, and attaches each pack's
+ *  `title`/`description` from the catalog — the wire shape groups by pack, the planner doesn't. */
+export function toExtensionPackInfoList(catalog, entries) {
+    const byPack = new Map();
+    for (const entry of entries) {
+        const list = byPack.get(entry.pack);
+        if (list)
+            list.push(entry);
+        else
+            byPack.set(entry.pack, [entry]);
+    }
+    return Object.entries(catalog)
+        .filter(([slug]) => byPack.has(slug))
+        .map(([slug, pack]) => ({
+        id: slug,
+        title: pack.title,
+        description: pack.description,
+        packages: (byPack.get(slug) ?? []).map(toWireEntry),
+    }));
+}
+//# sourceMappingURL=wire.js.map

package/dist/extensions/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../../src/extensions/wire.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,oBAAoB,GAAuC;IAC/D,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;IAC9B,UAAU,EAAE,YAAY;CACzB,CAAC;AAEF,SAAS,WAAW,CAAC,KAAqB;IACxC,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,MAAM,EAAE,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC;QAC1C,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC;AACJ,CAAC;AAED;mGACmG;AACnG,MAAM,UAAU,uBAAuB,CACrC,OAA2B,EAC3B,OAAkC;IAElC,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;IACnD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;YACtB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;SAC3B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;SACpC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACtB,EAAE,EAAE,IAAI;QACR,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC;KACpD,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/index.d.ts

@@ -15,4 +15,5 @@ export * from "./files/index.js";
 export * from "./orchestration/index.js";
 export * from "./logging/index.js";
 export * from "./util/index.js";
+export * from "./extensions/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc,EAAG,sBAA+B,CAAC;AAE9D,4EAA4E;AAC5E,eAAO,MAAM,WAAW,gEAAiD,CAAC;AAG1E,cAAc,wBAAwB,CAAC;AAGvC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,eAAe,CAAC;AAG9B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc,EAAG,sBAA+B,CAAC;AAE9D,4EAA4E;AAC5E,eAAO,MAAM,WAAW,gEAAiD,CAAC;AAG1E,cAAc,wBAAwB,CAAC;AAGvC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,eAAe,CAAC;AAG9B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,iBAAiB,CAAC;AAIhC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -32,4 +32,7 @@ export * from "./orchestration/index.js";
 export * from "./logging/index.js";
 // Shared utilities (bounded-concurrency helpers).
 export * from "./util/index.js";
+// Preinstalled-extensions sync engine: pure planning surface only (manifest, planner, state
+// reader) — see extensions/index.ts for why the orchestration/executor modules are excluded.
+export * from "./extensions/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,CAAC,MAAM,cAAc,GAAG,sBAA+B,CAAC;AAE9D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,gBAAgB,EAAE,iBAAiB,CAAU,CAAC;AAE1E,wEAAwE;AACxE,cAAc,wBAAwB,CAAC;AAEvC,mEAAmE;AACnE,cAAc,mBAAmB,CAAC;AAElC,+BAA+B;AAC/B,cAAc,mBAAmB,CAAC;AAElC,6DAA6D;AAC7D,cAAc,iBAAiB,CAAC;AAEhC,6DAA6D;AAC7D,cAAc,iBAAiB,CAAC;AAEhC,yEAAyE;AACzE,cAAc,eAAe,CAAC;AAE9B,8DAA8D;AAC9D,cAAc,kBAAkB,CAAC;AAEjC,kEAAkE;AAClE,cAAc,qBAAqB,CAAC;AAEpC,wCAAwC;AACxC,cAAc,qBAAqB,CAAC;AAEpC,sDAAsD;AACtD,cAAc,kBAAkB,CAAC;AAEjC,wCAAwC;AACxC,cAAc,kBAAkB,CAAC;AAEjC,0DAA0D;AAC1D,cAAc,0BAA0B,CAAC;AAEzC,8CAA8C;AAC9C,cAAc,oBAAoB,CAAC;AAEnC,kDAAkD;AAClD,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,CAAC,MAAM,cAAc,GAAG,sBAA+B,CAAC;AAE9D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,gBAAgB,EAAE,iBAAiB,CAAU,CAAC;AAE1E,wEAAwE;AACxE,cAAc,wBAAwB,CAAC;AAEvC,mEAAmE;AACnE,cAAc,mBAAmB,CAAC;AAElC,+BAA+B;AAC/B,cAAc,mBAAmB,CAAC;AAElC,6DAA6D;AAC7D,cAAc,iBAAiB,CAAC;AAEhC,6DAA6D;AAC7D,cAAc,iBAAiB,CAAC;AAEhC,yEAAyE;AACzE,cAAc,eAAe,CAAC;AAE9B,8DAA8D;AAC9D,cAAc,kBAAkB,CAAC;AAEjC,kEAAkE;AAClE,cAAc,qBAAqB,CAAC;AAEpC,wCAAwC;AACxC,cAAc,qBAAqB,CAAC;AAEpC,sDAAsD;AACtD,cAAc,kBAAkB,CAAC;AAEjC,wCAAwC;AACxC,cAAc,kBAAkB,CAAC;AAEjC,0DAA0D;AAC1D,cAAc,0BAA0B,CAAC;AAEzC,8CAA8C;AAC9C,cAAc,oBAAoB,CAAC;AAEnC,kDAAkD;AAClD,cAAc,iBAAiB,CAAC;AAEhC,4FAA4F;AAC5F,6FAA6F;AAC7F,cAAc,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@av-pi-studio/server",
-  "version": "0.0.72",
+  "version": "0.0.74",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -22,9 +22,9 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@av-pi-studio/highlight": "^0.0.72",
-    "@av-pi-studio/protocol": "^0.0.72",
-    "@av-pi-studio/relay": "^0.0.72",
+    "@av-pi-studio/highlight": "^0.0.74",
+    "@av-pi-studio/protocol": "^0.0.74",
+    "@av-pi-studio/relay": "^0.0.74",
     "@earendil-works/pi-coding-agent": "^0.84.1",
     "@xterm/headless": "^6.0.0",
     "bcryptjs": "^3.0.3",