jishushell 0.4.17 → 0.4.24

package/dist/services/agent-apps/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Agent apps module — unified catalog + install dispatcher for user-
+ * installable software around the agent ecosystem (agent runtimes, agent
+ * support services, agent-related CLI tools).
+ *
+ * Public surface:
+ *   - `listAgentApps()` — card-shaped view backing `GET /api/agent-apps`
+ *   - `getAgentApp(id)` — single entry lookup
+ *   - `startAgentAppInstall(id)` — kicks off install/update, returns task id
+ */
+import type { AgentAppCardView, InstallStartResult } from "./types.js";
+export type { AgentAppCardView, AgentAppStatus, InstallStartResult } from "./types.js";
+export declare function listAgentApps(): Promise<AgentAppCardView[]>;
+export declare function getAgentApp(id: string): Promise<AgentAppCardView | null>;
+export declare function startAgentAppInstall(id: string, options?: Record<string, any>): Promise<InstallStartResult>;
+/**
+ * Backs `POST /api/agent-apps/check-updates`. Runs the update probe for
+ * every app across all installer kinds in parallel. Slow networks can take
+ * tens of seconds — the endpoint holds the connection until all probes
+ * complete or time out individually.
+ *
+ * - adapter kind: registry HTTPS digest comparison (cached)
+ * - shell-script kind: GitHub Releases API tag vs installed version (direct,
+ *   no cache yet; light-weight call so acceptable)
+ */
+export declare function checkAllAgentAppUpdates(): Promise<{
+    checkedAt: number;
+    results: Record<string, boolean | null>;
+}>;
+/**
+ * Newest "last checked" timestamp across all installer kinds. The UI
+ * ("上次检查更新：2 分钟前") reads this — it doesn't care which installer
+ * owned the probe, only when *any* probe last finished.
+ */
+export declare function getAgentAppUpdatesLastCheckedAt(): number | null;
+export declare function startAgentAppUninstall(id: string): Promise<InstallStartResult>;

package/dist/services/agent-apps/index.js

@@ -0,0 +1,171 @@
+/**
+ * Agent apps module — unified catalog + install dispatcher for user-
+ * installable software around the agent ecosystem (agent runtimes, agent
+ * support services, agent-related CLI tools).
+ *
+ * Public surface:
+ *   - `listAgentApps()` — card-shaped view backing `GET /api/agent-apps`
+ *   - `getAgentApp(id)` — single entry lookup
+ *   - `startAgentAppInstall(id)` — kicks off install/update, returns task id
+ */
+import { AGENT_APP_CATALOG, getCatalogEntry } from "./catalog.js";
+import { countInstancesUsingAgentType, findRunningAdapterTask, forceRefreshAllAdapterUpdates, getUpdateCacheLastCheckedAt, probeAdapterImageSizeMB, probeAdapterStatus, probeAdapterUpdateAvailable, startAdapterInstall, startAdapterUninstall, } from "./installers/adapter.js";
+import { findRunningShellScriptTask, getShellScriptUpdateCacheLastCheckedAt, probeShellScriptSizeMB, probeShellScriptStatus, readShellScriptUpdateAvailable, refreshShellScriptUpdateCache, startShellScriptInstall, startShellScriptUninstall, } from "./installers/shell-script.js";
+async function buildCardView(entry) {
+    const status = { installed: false };
+    let diskSpaceMB = null;
+    if (entry.source.kind === "adapter") {
+        // Probe status + size + update-availability in parallel. Each docker
+        // shell call has its own short timeout so a slow daemon degrades to
+        // "unknown" fields rather than hanging the whole catalog response.
+        const [probe, sizeMB, updateAvailable] = await Promise.all([
+            probeAdapterStatus(entry.source.agentType),
+            probeAdapterImageSizeMB(entry.source.agentType),
+            probeAdapterUpdateAvailable(entry.source.agentType),
+        ]);
+        if (probe) {
+            status.installed = probe.installed;
+            status.imageReady = probe.imageReady;
+            status.version = probe.version;
+            status.digest = probe.digest;
+        }
+        const running = findRunningAdapterTask(entry.source.agentType);
+        status.currentTaskId = running?.id;
+        status.currentTaskKind = running?.kind;
+        status.updateAvailable = status.installed ? updateAvailable : null;
+        diskSpaceMB = sizeMB;
+    }
+    else if (entry.source.kind === "shell-script") {
+        // Hot-path probes only. Update availability is a cached read (written
+        // by `checkAllAgentAppUpdates`) — this branch never makes an outbound
+        // HTTP call to GitHub so the 5 s catalog poll can't trip rate limits
+        // or stall on slow WAN.
+        const [probe, sizeMB] = await Promise.all([
+            probeShellScriptStatus(entry.source),
+            probeShellScriptSizeMB(entry.source),
+        ]);
+        if (probe) {
+            status.installed = probe.installed;
+            status.imageReady = probe.installed; // shell tools are binary-or-not; treat installed == imageReady
+            status.version = probe.version;
+        }
+        const running = findRunningShellScriptTask(entry.id);
+        status.currentTaskId = running?.id;
+        status.currentTaskKind = running?.kind;
+        status.updateAvailable = status.installed ? readShellScriptUpdateAvailable(entry.id) : null;
+        diskSpaceMB = sizeMB;
+    }
+    return {
+        id: entry.id,
+        name: entry.name,
+        category: entry.category,
+        description: entry.description,
+        icon: entry.icon,
+        diskSpaceMB,
+        source: entry.source,
+        status,
+        actions: entry.actions,
+        required: entry.required,
+    };
+}
+export async function listAgentApps() {
+    return Promise.all(AGENT_APP_CATALOG.map(buildCardView));
+}
+export async function getAgentApp(id) {
+    const entry = getCatalogEntry(id);
+    if (!entry)
+        return null;
+    return buildCardView(entry);
+}
+export async function startAgentAppInstall(id, options = {}) {
+    const entry = getCatalogEntry(id);
+    if (!entry) {
+        return { ok: false, error: `Unknown agent app "${id}"` };
+    }
+    if (!entry.actions.install && !entry.actions.update) {
+        return { ok: false, error: `Agent app "${id}" does not support install/update` };
+    }
+    if (entry.source.kind === "adapter") {
+        return startAdapterInstall(entry.source.agentType, options);
+    }
+    if (entry.source.kind === "shell-script") {
+        return startShellScriptInstall(entry.id, entry.source);
+    }
+    return {
+        ok: false,
+        error: `Installer for source kind "${entry.source.kind}" is not implemented yet`,
+    };
+}
+/**
+ * Backs `POST /api/agent-apps/check-updates`. Runs the update probe for
+ * every app across all installer kinds in parallel. Slow networks can take
+ * tens of seconds — the endpoint holds the connection until all probes
+ * complete or time out individually.
+ *
+ * - adapter kind: registry HTTPS digest comparison (cached)
+ * - shell-script kind: GitHub Releases API tag vs installed version (direct,
+ *   no cache yet; light-weight call so acceptable)
+ */
+export async function checkAllAgentAppUpdates() {
+    const adapterAgents = [];
+    const shellScriptEntries = [];
+    for (const entry of AGENT_APP_CATALOG) {
+        if (entry.source.kind === "adapter")
+            adapterAgents.push(entry.source.agentType);
+        else if (entry.source.kind === "shell-script") {
+            shellScriptEntries.push({ id: entry.id, source: entry.source });
+        }
+    }
+    const [adapterResults, shellScriptResults] = await Promise.all([
+        forceRefreshAllAdapterUpdates(adapterAgents),
+        Promise.all(shellScriptEntries.map(async ({ id, source }) => {
+            const value = await refreshShellScriptUpdateCache(id, source);
+            return [id, value];
+        })),
+    ]);
+    const results = { ...adapterResults };
+    for (const [id, value] of shellScriptResults)
+        results[id] = value;
+    return { checkedAt: Date.now(), results };
+}
+/**
+ * Newest "last checked" timestamp across all installer kinds. The UI
+ * ("上次检查更新：2 分钟前") reads this — it doesn't care which installer
+ * owned the probe, only when *any* probe last finished.
+ */
+export function getAgentAppUpdatesLastCheckedAt() {
+    const adapterAt = getUpdateCacheLastCheckedAt();
+    const shellScriptAt = getShellScriptUpdateCacheLastCheckedAt();
+    if (adapterAt == null)
+        return shellScriptAt;
+    if (shellScriptAt == null)
+        return adapterAt;
+    return Math.max(adapterAt, shellScriptAt);
+}
+export async function startAgentAppUninstall(id) {
+    const entry = getCatalogEntry(id);
+    if (!entry) {
+        return { ok: false, error: `Unknown agent app "${id}"` };
+    }
+    if (!entry.actions.uninstall) {
+        return { ok: false, error: `${entry.name} 不支持卸载` };
+    }
+    if (entry.source.kind === "adapter") {
+        const depCount = countInstancesUsingAgentType(entry.source.agentType);
+        if (depCount > 0) {
+            return {
+                ok: false,
+                error: `还有 ${depCount} 个实例使用 ${entry.name}，请先删除这些实例再卸载`,
+            };
+        }
+        return startAdapterUninstall(entry.source.agentType);
+    }
+    if (entry.source.kind === "shell-script") {
+        return startShellScriptUninstall(entry.id, entry.source);
+    }
+    return {
+        ok: false,
+        error: `Uninstaller for source kind "${entry.source.kind}" is not implemented yet`,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/services/agent-apps/index.js.map

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

package/dist/services/agent-apps/installers/adapter-probes.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Probe functions used by `buildCardView` to populate an adapter-backed
+ * `AgentAppCardView` — install status, disk size, and update availability.
+ *
+ * The update probe is the expensive one (needs to reach the upstream
+ * registry) so it runs behind a stale-while-revalidate cache: callers see
+ * whatever is cached immediately, and a background refresh kicks off when
+ * the cache is stale. `forceRefreshAllAdapterUpdates` is the explicit
+ * "check updates now" path used by the UI button; it awaits in-flight
+ * refreshes instead of skipping them so the button's result reflects the
+ * newest state, not the value that was cached at click time.
+ */
+/**
+ * Resolve the docker image an adapter's instances currently run on. Prefers
+ * the installed record in panel.json.runtime_catalog; falls back to the
+ * adapter's declared default so update checks still work even when the app
+ * has been uninstalled (or was never installed through the new flow).
+ */
+export declare function resolveAdapterImage(agentType: string): string | null;
+export declare function probeAdapterStatus(agentType: string): Promise<{
+    installed: boolean;
+    imageReady: boolean;
+    version?: string;
+    digest?: string;
+} | null>;
+/**
+ * Read the disk size (MB, decimal) of the adapter's current docker image.
+ * Uses `docker image ls --format {{.Size}}` (same cumulative-layer total
+ * admins see in `docker images`) instead of `docker image inspect .Size`
+ * which reports dedup'd unique bytes and doesn't match operator
+ * expectation.
+ */
+export declare function probeAdapterImageSizeMB(agentType: string): Promise<number | null>;
+/**
+ * Lazy background probe: returns whatever is currently cached, and kicks
+ * off a refresh in the background if the cache is stale. First cold call
+ * returns `null`; the next catalog poll after the refresh lands will flip
+ * to the real value.
+ */
+export declare function probeAdapterUpdateAvailable(agentType: string): Promise<boolean | null>;
+/** Timestamp (ms since epoch) when the freshest cached probe completed. */
+export declare function getUpdateCacheLastCheckedAt(): number | null;
+/**
+ * Explicit "check updates now" path — backs `POST /api/agent-apps/check-
+ * updates`. Bypasses the TTL entirely: if a refresh is already running it
+ * awaits it instead of skipping (so the response carries the newest value,
+ * not a stale cached null). Runs all targets in parallel.
+ */
+export declare function forceRefreshAllAdapterUpdates(agentTypes: string[]): Promise<Record<string, boolean | null>>;

package/dist/services/agent-apps/installers/adapter-probes.js

@@ -0,0 +1,223 @@
+/**
+ * Probe functions used by `buildCardView` to populate an adapter-backed
+ * `AgentAppCardView` — install status, disk size, and update availability.
+ *
+ * The update probe is the expensive one (needs to reach the upstream
+ * registry) so it runs behind a stale-while-revalidate cache: callers see
+ * whatever is cached immediately, and a background refresh kicks off when
+ * the cache is stale. `forceRefreshAllAdapterUpdates` is the explicit
+ * "check updates now" path used by the UI button; it awaits in-flight
+ * refreshes instead of skipping them so the button's result reflects the
+ * newest state, not the value that was cached at click time.
+ */
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { HERMES_DEFAULT_IMAGE, getOpenclawDockerImage, getRuntimeCatalogEntry, } from "../../../config.js";
+import { getAdapter, hasAdapter } from "../../runtime/index.js";
+import { fetchRemoteDigest, parseImageRef } from "./registry-probe.js";
+const execFileAsync = promisify(execFile);
+// ── Image resolution ────────────────────────────────────────────────────
+/**
+ * Resolve the docker image an adapter's instances currently run on. Prefers
+ * the installed record in panel.json.runtime_catalog; falls back to the
+ * adapter's declared default so update checks still work even when the app
+ * has been uninstalled (or was never installed through the new flow).
+ */
+export function resolveAdapterImage(agentType) {
+    if (agentType === "openclaw")
+        return getOpenclawDockerImage();
+    const entry = getRuntimeCatalogEntry(agentType);
+    const fromCatalog = entry?.defaultImage;
+    if (typeof fromCatalog === "string" && fromCatalog.trim())
+        return fromCatalog;
+    // Fallback: hardcoded defaults per adapter. Adapters that want to
+    // participate in update checks without a runtime_catalog entry (yet)
+    // advertise their default here.
+    if (agentType === "hermes")
+        return HERMES_DEFAULT_IMAGE;
+    return null;
+}
+// ── Status probe ────────────────────────────────────────────────────────
+export async function probeAdapterStatus(agentType) {
+    if (!hasAdapter(agentType))
+        return null;
+    const adapter = getAdapter(agentType);
+    if (!adapter.getInstallStatus)
+        return null;
+    try {
+        return (await Promise.race([
+            Promise.resolve(adapter.getInstallStatus()),
+            new Promise((_, reject) => setTimeout(() => reject(new Error("install-status probe timed out")), 2500)),
+        ]));
+    }
+    catch {
+        return null;
+    }
+}
+// ── Image size probe ────────────────────────────────────────────────────
+/**
+ * Read the disk size (MB, decimal) of the adapter's current docker image.
+ * Uses `docker image ls --format {{.Size}}` (same cumulative-layer total
+ * admins see in `docker images`) instead of `docker image inspect .Size`
+ * which reports dedup'd unique bytes and doesn't match operator
+ * expectation.
+ */
+export async function probeAdapterImageSizeMB(agentType) {
+    const image = resolveAdapterImage(agentType);
+    if (!image)
+        return null;
+    try {
+        const { stdout } = await execFileAsync("docker", ["image", "ls", "--format", "{{.Size}}", image], { timeout: 2500, encoding: "utf-8" });
+        const firstLine = stdout.split("\n")[0]?.trim();
+        if (!firstLine)
+            return null;
+        return parseDockerSizeToMB(firstLine);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse docker's human-readable size strings ("2.26GB", "593MB", "12.5kB")
+ * into megabytes. Docker uses decimal (SI) units for these displays.
+ */
+function parseDockerSizeToMB(raw) {
+    const m = raw.trim().match(/^(\d+(?:\.\d+)?)\s*(B|kB|MB|GB|TB)$/i);
+    if (!m)
+        return null;
+    const value = parseFloat(m[1]);
+    if (!Number.isFinite(value))
+        return null;
+    const unit = m[2].toLowerCase();
+    const mb = unit === "b" ? value / 1_000_000 :
+        unit === "kb" ? value / 1_000 :
+            unit === "mb" ? value :
+                unit === "gb" ? value * 1_000 :
+                    unit === "tb" ? value * 1_000_000 : NaN;
+    return Number.isFinite(mb) ? Math.round(mb) : null;
+}
+const updateCache = new Map();
+const UPDATE_CACHE_TTL_OK_MS = 10 * 60 * 1000;
+const UPDATE_CACHE_TTL_NULL_MS = 60 * 1000;
+/**
+ * Read the local RepoDigest sha for the given image — this is what docker
+ * recorded when it pulled the tag (the manifest-list's digest for
+ * multi-arch images), so it lines up with what the registry HEAD returns.
+ */
+async function readLocalDigest(image) {
+    try {
+        const { stdout } = await execFileAsync("docker", ["image", "inspect", "--format", "{{range .RepoDigests}}{{.}}{{println}}{{end}}", image], { timeout: 5_000, encoding: "utf-8" });
+        const line = stdout.split("\n").find((l) => l.includes("@sha256:"));
+        const m = line?.match(/@sha256:([a-f0-9]{64})/);
+        return m ? m[1] : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function readRemoteDigest(image) {
+    const ref = parseImageRef(image);
+    if (!ref)
+        return null;
+    return fetchRemoteDigest(ref);
+}
+/**
+ * Refresh the update-cache entry for one agentType. Safe to call while a
+ * refresh is already in flight — the second caller awaits the same
+ * promise instead of starting a duplicate probe.
+ */
+function refreshUpdateCache(agentType, image) {
+    const cached = updateCache.get(agentType);
+    if (cached?.inflight)
+        return cached.inflight;
+    const t0 = Date.now();
+    console.log(`[agent-apps] ${agentType}: probing digest for ${image}`);
+    const inflight = (async () => {
+        try {
+            const [local, remote] = await Promise.all([
+                readLocalDigest(image),
+                readRemoteDigest(image),
+            ]);
+            const value = !local || !remote ? null : local !== remote;
+            console.log(`[agent-apps] ${agentType}: local=${local?.slice(0, 12) ?? "null"} ` +
+                `remote=${remote?.slice(0, 12) ?? "null"} result=${value} (+${Date.now() - t0}ms)`);
+            updateCache.set(agentType, { value, at: Date.now() });
+        }
+        catch (e) {
+            console.log(`[agent-apps] ${agentType}: probe error ${e?.message || e} (+${Date.now() - t0}ms)`);
+            updateCache.set(agentType, { value: null, at: Date.now() });
+        }
+    })();
+    updateCache.set(agentType, {
+        value: cached?.value ?? null,
+        at: cached?.at ?? 0,
+        inflight,
+    });
+    // When the async IIFE above writes the final value, the new entry will
+    // not carry `inflight`, so subsequent calls will see the fresh state.
+    inflight.finally(() => {
+        const final = updateCache.get(agentType);
+        if (final?.inflight === inflight) {
+            updateCache.set(agentType, { value: final.value, at: final.at });
+        }
+    });
+    return inflight;
+}
+/**
+ * Lazy background probe: returns whatever is currently cached, and kicks
+ * off a refresh in the background if the cache is stale. First cold call
+ * returns `null`; the next catalog poll after the refresh lands will flip
+ * to the real value.
+ */
+export async function probeAdapterUpdateAvailable(agentType) {
+    const image = resolveAdapterImage(agentType);
+    if (!image)
+        return null;
+    const cached = updateCache.get(agentType);
+    const now = Date.now();
+    const ttl = cached?.value == null ? UPDATE_CACHE_TTL_NULL_MS : UPDATE_CACHE_TTL_OK_MS;
+    const stale = !cached || now - cached.at > ttl;
+    if (stale && !cached?.inflight) {
+        refreshUpdateCache(agentType, image).catch(() => {
+            // swallowed — refreshUpdateCache writes a null entry on its own
+        });
+    }
+    return cached?.value ?? null;
+}
+/** Timestamp (ms since epoch) when the freshest cached probe completed. */
+export function getUpdateCacheLastCheckedAt() {
+    let latest = 0;
+    for (const entry of updateCache.values()) {
+        if (entry.at > latest)
+            latest = entry.at;
+    }
+    return latest > 0 ? latest : null;
+}
+/**
+ * Explicit "check updates now" path — backs `POST /api/agent-apps/check-
+ * updates`. Bypasses the TTL entirely: if a refresh is already running it
+ * awaits it instead of skipping (so the response carries the newest value,
+ * not a stale cached null). Runs all targets in parallel.
+ */
+export async function forceRefreshAllAdapterUpdates(agentTypes) {
+    const targets = [];
+    for (const agentType of agentTypes) {
+        const image = resolveAdapterImage(agentType);
+        if (image)
+            targets.push({ agentType, image });
+    }
+    await Promise.all(targets.map(({ agentType, image }) => {
+        const cached = updateCache.get(agentType);
+        // Already refreshing → wait for it. Otherwise start a fresh probe
+        // even if the TTL hasn't expired (user explicitly asked for a check).
+        if (cached?.inflight)
+            return cached.inflight;
+        return refreshUpdateCache(agentType, image);
+    }));
+    const out = {};
+    for (const { agentType } of targets) {
+        out[agentType] = updateCache.get(agentType)?.value ?? null;
+    }
+    return out;
+}
+//# sourceMappingURL=adapter-probes.js.map

package/dist/services/agent-apps/installers/adapter-probes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-probes.js","sourceRoot":"","sources":["../../../../src/services/agent-apps/installers/adapter-probes.ts"],"names":[],"mappings":"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"}

package/dist/services/agent-apps/installers/adapter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Installer strategy for adapter-backed agent apps (hermes, openclaw).
+ *
+ * Delegates install to `adapter.startBuildRuntimeImage` (preferred when
+ * present — openclaw builds its image locally) or
+ * `adapter.startInstallRuntime` (hermes pulls from GHCR). Uninstall runs
+ * locally here (docker image rm + clear runtime_catalog + drop shim).
+ *
+ * Probe + cache logic lives in `adapter-probes.ts`; this file re-exports
+ * the probes so callers import one entry point.
+ */
+import type { InstallStartResult } from "../types.js";
+export { forceRefreshAllAdapterUpdates, getUpdateCacheLastCheckedAt, probeAdapterImageSizeMB, probeAdapterStatus, probeAdapterUpdateAvailable, resolveAdapterImage, } from "./adapter-probes.js";
+export declare function startAdapterInstall(agentType: string, options?: Record<string, any>): Promise<InstallStartResult>;
+export declare function startAdapterUninstall(agentType: string): InstallStartResult;
+/**
+ * Current running task for this agentType. Returns both the id and the
+ * kind so the UI can render "安装中" vs "卸载中" from one field instead
+ * of having to guess from task name shape.
+ *
+ * Install tasks match by prefix (`openclaw`, `openclaw-docker-pull`,
+ * `hermes`). Uninstall tasks use the disjoint `uninstall-${agentType}`
+ * name so no prefix collision is possible.
+ */
+export declare function findRunningAdapterTask(agentType: string): {
+    id: string;
+    kind: "install" | "uninstall";
+} | undefined;
+/** Count live instances bound to this agentType — used to block uninstall. */
+export declare function countInstancesUsingAgentType(agentType: string): number;