jishushell 0.6.5 → 0.7.3

package/dist/services/integrations/index.js

@@ -0,0 +1,60 @@
+/**
+ * AppIntegration registry entrypoint.
+ *
+ * Importing this module registers all built-in AppIntegration modules via
+ * their import side-effects.
+ *
+ * Core files (instances/manager, runtime drivers, setup-manager, routes/*,
+ * server.ts, llm-proxy/index.ts) must import from "./integrations/index.js"
+ * or "./integrations/registry.js" - never directly from integration implementation
+ * modules.
+ */
+// Registration order: OpenClaw first so the registry is non-empty before any
+// framework code asks for `openclaw`.
+import "./openclaw/integration.js";
+import "./hermes/integration.js";
+import "./jishukb/integration.js";
+import "./anythingllm/integration.js";
+import "./immich/integration.js";
+// The custom integration remains as an unregistered placeholder for future
+// user-imported AppSpec YAML. Generic builtin apps run through
+// WorkloadCompiler/runtime/instance without `getIntegration("custom")`.
+/**
+ * Re-export a limited set of OpenClaw utilities that framework code still
+ * needs during backup import / scrub flows. This lets the core layer keep
+ * using these helpers without importing the integration file directly, which
+ * would trip the `check-integration-isolation.ts` enforcement. Each re-exported
+ * symbol should be generic enough to eventually live in a neutral
+ * `runtime/framework.ts` module.
+ */
+export { stripImBindings } from "./openclaw/integration.js";
+export { getIntegration, hasIntegration, listRegisteredIntegrations, registerIntegration } from "./registry.js";
+export { resolvePrimaryIntegrationKind } from "../runtime/instance.js";
+import { listRegisteredIntegrations } from "./registry.js";
+/**
+ * Let each Integration normalize only the Core-owned global configuration it
+ * understands. This is not an instance migration entrypoint: implementations
+ * must not inspect or mutate apps/<instanceId>, instance facts, user config, or
+ * runtime jobs. Those changes require the explicit upgrade-finalize,
+ * migration, or repair boundaries.
+ *
+ * Failures are logged and swallowed so one optional Integration cannot block
+ * Core/Panel readiness. Keeping this as the only framework entrypoint also
+ * prevents server.ts from importing Integration implementations directly.
+ */
+export function normalizeIntegrationCoreConfigOnStartup() {
+    for (const integration of listRegisteredIntegrations()) {
+        if (typeof integration.normalizeCoreConfigOnStartup !== "function")
+            continue;
+        try {
+            const result = integration.normalizeCoreConfigOnStartup();
+            if (result && typeof result.then === "function") {
+                result.catch((e) => console.warn(`[startup] ${integration.kind} Core config normalization skipped:`, e));
+            }
+        }
+        catch (e) {
+            console.warn(`[startup] ${integration.kind} Core config normalization skipped:`, e);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/services/integrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/integrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,6EAA6E;AAC7E,sCAAsC;AACtC,OAAO,2BAA2B,CAAC;AACnC,OAAO,yBAAyB,CAAC;AACjC,OAAO,0BAA0B,CAAC;AAClC,OAAO,8BAA8B,CAAC;AACtC,OAAO,yBAAyB,CAAC;AACjC,2EAA2E;AAC3E,+DAA+D;AAC/D,wEAAwE;AAExE;;;;;;;GAOG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAChH,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uCAAuC;IACrD,KAAK,MAAM,WAAW,IAAI,0BAA0B,EAAE,EAAE,CAAC;QACvD,IAAI,OAAO,WAAW,CAAC,4BAA4B,KAAK,UAAU;YAAE,SAAS;QAC7E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,WAAW,CAAC,4BAA4B,EAAE,CAAC;YAC1D,IAAI,MAAM,IAAI,OAAQ,MAAwB,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAClE,MAAwB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CACpC,OAAO,CAAC,IAAI,CAAC,aAAa,WAAW,CAAC,IAAI,qCAAqC,EAAE,CAAC,CAAC,CACpF,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,aAAa,WAAW,CAAC,IAAI,qCAAqC,EAAE,CAAC,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/services/integrations/installable/catalog.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Static catalog of runtime-integrated apps known to this build.
+ *
+ * Phase 1: integration-backed entries for Hermes + OpenClaw. Adding a new
+ * integration-backed app is one entry here plus the integration itself. Adding a
+ * non-integration app (ollama / opencode) will come in Phase 2 with dedicated
+ * installer entries.
+ *
+ * Keeping the catalog static (rather than scanning for integration manifests at
+ * runtime) means product-level metadata — marketing copy, icon, category —
+ * lives next to its install strategy instead of being scattered across
+ * integration files.
+ */
+import type { IntegrationAppCategory, IntegrationAppSource } from "./types.js";
+export interface CatalogEntry {
+    id: string;
+    name: string;
+    category: IntegrationAppCategory;
+    description: string;
+    icon?: string;
+    source: IntegrationAppSource;
+    required: boolean;
+    actions: {
+        install: boolean;
+        update: boolean;
+        uninstall: boolean;
+    };
+}
+export declare function buildOllamaShellScriptSource(platform?: NodeJS.Platform): Extract<IntegrationAppSource, {
+    kind: "shell-script";
+}>;
+export declare const INTEGRATION_APP_CATALOG: CatalogEntry[];
+export declare function getCatalogEntry(id: string): CatalogEntry | undefined;

package/dist/services/integrations/installable/catalog.js

@@ -0,0 +1,88 @@
+/**
+ * Static catalog of runtime-integrated apps known to this build.
+ *
+ * Phase 1: integration-backed entries for Hermes + OpenClaw. Adding a new
+ * integration-backed app is one entry here plus the integration itself. Adding a
+ * non-integration app (ollama / opencode) will come in Phase 2 with dedicated
+ * installer entries.
+ *
+ * Keeping the catalog static (rather than scanning for integration manifests at
+ * runtime) means product-level metadata — marketing copy, icon, category —
+ * lives next to its install strategy instead of being scattered across
+ * integration files.
+ */
+import { homedir } from "os";
+const OLLAMA_SCRIPT_URL = "https://ollama.com/install.sh";
+const OLLAMA_PROBE_COMMAND = {
+    cmd: "ollama",
+    args: ["--version"],
+};
+export function buildOllamaShellScriptSource(platform = process.platform) {
+    if (platform === "darwin") {
+        return {
+            kind: "shell-script",
+            // Ollama's officially recommended entry point. The script itself downloads the
+            // release binary from ollama.com; we don't pin the sha256 because the script
+            // changes with each Ollama release — pinning would block upgrades. The trust
+            // boundary is HTTPS + official domain + the script being human-readable.
+            scriptUrl: OLLAMA_SCRIPT_URL,
+            probeCommand: OLLAMA_PROBE_COMMAND,
+            githubRepo: "ollama/ollama",
+            processName: "Ollama",
+            binaryPath: "/usr/local/bin/ollama",
+            extraCleanup: [
+                "/Applications/Ollama.app",
+                `${homedir()}/Applications/Ollama.app`,
+            ],
+        };
+    }
+    return {
+        kind: "shell-script",
+        // Ollama's officially recommended entry point. The script itself downloads the
+        // release binary from ollama.com; we don't pin the sha256 because the script
+        // changes with each Ollama release — pinning would block upgrades. The trust
+        // boundary is HTTPS + official domain + the script being human-readable.
+        scriptUrl: OLLAMA_SCRIPT_URL,
+        probeCommand: OLLAMA_PROBE_COMMAND,
+        githubRepo: "ollama/ollama",
+        systemdUnit: "ollama",
+        binaryPath: "/usr/local/bin/ollama",
+        extraCleanup: ["/etc/systemd/system/ollama.service"],
+    };
+}
+export const INTEGRATION_APP_CATALOG = [
+    {
+        id: "openclaw",
+        name: "OpenClaw",
+        category: "agent-runtime",
+        description: "默认的 AI agent 运行时，提供 iframe 聊天面板与 IM 通道插件。首次安装会构建本地 Docker 镜像，后续只会在版本更新时重建。",
+        icon: "openclaw",
+        source: { kind: "integration", integrationKind: "openclaw" },
+        required: true,
+        actions: { install: true, update: true, uninstall: true },
+    },
+    {
+        id: "hermes",
+        name: "Hermes Agent",
+        category: "agent-runtime",
+        description: "NousResearch Hermes agent 运行时，内置 Chromium + Playwright，可用于浏览器自动化与长程推理任务。首次安装从 GHCR 拉取镜像。",
+        icon: "hermes",
+        source: { kind: "integration", integrationKind: "hermes" },
+        required: false,
+        actions: { install: true, update: true, uninstall: true },
+    },
+    {
+        id: "ollama",
+        name: "Ollama",
+        category: "system-service",
+        description: "本地大模型推理服务。装好后 agent 可以通过 http://localhost:11434 使用本地模型，适合隐私数据或离线场景。",
+        icon: "ollama",
+        source: buildOllamaShellScriptSource(),
+        required: false,
+        actions: { install: true, update: true, uninstall: true },
+    },
+];
+export function getCatalogEntry(id) {
+    return INTEGRATION_APP_CATALOG.find((e) => e.id === id);
+}
+//# sourceMappingURL=catalog.js.map

package/dist/services/integrations/installable/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../../src/services/integrations/installable/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAmB7B,MAAM,iBAAiB,GAAG,+BAA+B,CAAC;AAC1D,MAAM,oBAAoB,GAA4E;IACpG,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,CAAC,WAAW,CAAC;CACpB,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAC1C,WAA4B,OAAO,CAAC,QAAQ;IAE5C,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,+EAA+E;YAC/E,6EAA6E;YAC7E,6EAA6E;YAC7E,yEAAyE;YACzE,SAAS,EAAE,iBAAiB;YAC5B,YAAY,EAAE,oBAAoB;YAClC,UAAU,EAAE,eAAe;YAC3B,WAAW,EAAE,QAAQ;YACrB,UAAU,EAAE,uBAAuB;YACnC,YAAY,EAAE;gBACZ,0BAA0B;gBAC1B,GAAG,OAAO,EAAE,0BAA0B;aACvC;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,+EAA+E;QAC/E,6EAA6E;QAC7E,6EAA6E;QAC7E,yEAAyE;QACzE,SAAS,EAAE,iBAAiB;QAC5B,YAAY,EAAE,oBAAoB;QAClC,UAAU,EAAE,eAAe;QAC3B,WAAW,EAAE,QAAQ;QACrB,UAAU,EAAE,uBAAuB;QACnC,YAAY,EAAE,CAAC,oCAAoC,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD;QACE,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,eAAe;QACzB,WAAW,EACT,4EAA4E;QAC9E,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE;QAC5D,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;KAC1D;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,eAAe;QACzB,WAAW,EACT,0FAA0F;QAC5F,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE;QAC1D,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;KAC1D;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,gBAAgB;QAC1B,WAAW,EACT,qEAAqE;QACvE,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,4BAA4B,EAAE;QACtC,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;KAC1D;CACF,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1D,CAAC"}

package/dist/services/integrations/installable/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Installable integration apps module — unified catalog + install dispatcher
+ * for Core-native integrations and adjacent support tools.
+ *
+ * Current public surface:
+ *   - `listIntegrationApps()` — card-shaped view backing `GET /api/integrations/apps`
+ *   - `getIntegrationApp(id)` — single entry lookup
+ *   - `startIntegrationAppInstall(id)` — kicks off install/update, returns task id
+ */
+import type { IntegrationAppCardView, InstallStartResult } from "./types.js";
+export type { IntegrationAppCardView, IntegrationAppStatus, InstallStartResult } from "./types.js";
+export declare function listIntegrationApps(): Promise<IntegrationAppCardView[]>;
+export declare function getIntegrationApp(id: string): Promise<IntegrationAppCardView | null>;
+export declare function startIntegrationAppInstall(id: string, options?: Record<string, any>): Promise<InstallStartResult>;
+/**
+ * Backs `POST /api/integrations/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.
+ *
+ * - integration 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 checkAllIntegrationAppUpdates(): Promise<{
+    checkedAt: number;
+    results: Record<string, boolean | null>;
+}>;
+/**
+ * Newest "last checked" timestamp across all installer kinds. The UI
+ * (e.g. "Last checked: 2 minutes ago") reads this — it doesn't care which installer
+ * owned the probe, only when *any* probe last finished.
+ */
+export declare function getIntegrationAppUpdatesLastCheckedAt(): number | null;
+export declare function startIntegrationAppUninstall(id: string): Promise<InstallStartResult>;

package/dist/services/integrations/installable/index.js

@@ -0,0 +1,170 @@
+/**
+ * Installable integration apps module — unified catalog + install dispatcher
+ * for Core-native integrations and adjacent support tools.
+ *
+ * Current public surface:
+ *   - `listIntegrationApps()` — card-shaped view backing `GET /api/integrations/apps`
+ *   - `getIntegrationApp(id)` — single entry lookup
+ *   - `startIntegrationAppInstall(id)` — kicks off install/update, returns task id
+ */
+import { INTEGRATION_APP_CATALOG, getCatalogEntry } from "./catalog.js";
+import { countInstancesUsingIntegrationKind, findRunningIntegrationTask, forceRefreshAllIntegrationUpdates, getUpdateCacheLastCheckedAt, probeIntegrationImageSizeMB, probeIntegrationStatus, probeIntegrationUpdateAvailable, startIntegrationInstall, startIntegrationUninstall, } from "./installers/integration.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 === "integration") {
+        // 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([
+            probeIntegrationStatus(entry.source.integrationKind),
+            probeIntegrationImageSizeMB(entry.source.integrationKind),
+            probeIntegrationUpdateAvailable(entry.source.integrationKind),
+        ]);
+        if (probe) {
+            status.installed = probe.installed;
+            status.imageReady = probe.imageReady;
+            status.version = probe.version;
+            status.digest = probe.digest;
+        }
+        const running = findRunningIntegrationTask(entry.source.integrationKind);
+        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 `checkAllIntegrationAppUpdates`) — 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 listIntegrationApps() {
+    return Promise.all(INTEGRATION_APP_CATALOG.map(buildCardView));
+}
+export async function getIntegrationApp(id) {
+    const entry = getCatalogEntry(id);
+    if (!entry)
+        return null;
+    return buildCardView(entry);
+}
+export async function startIntegrationAppInstall(id, options = {}) {
+    const entry = getCatalogEntry(id);
+    if (!entry) {
+        return { ok: false, error: `Unknown integration app "${id}"` };
+    }
+    if (!entry.actions.install && !entry.actions.update) {
+        return { ok: false, error: `Integration app "${id}" does not support install/update` };
+    }
+    if (entry.source.kind === "integration") {
+        return startIntegrationInstall(entry.source.integrationKind, 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/integrations/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.
+ *
+ * - integration 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 checkAllIntegrationAppUpdates() {
+    const integrationKinds = [];
+    const shellScriptEntries = [];
+    for (const entry of INTEGRATION_APP_CATALOG) {
+        if (entry.source.kind === "integration")
+            integrationKinds.push(entry.source.integrationKind);
+        else if (entry.source.kind === "shell-script") {
+            shellScriptEntries.push({ id: entry.id, source: entry.source });
+        }
+    }
+    const [integrationResults, shellScriptResults] = await Promise.all([
+        forceRefreshAllIntegrationUpdates(integrationKinds),
+        Promise.all(shellScriptEntries.map(async ({ id, source }) => {
+            const value = await refreshShellScriptUpdateCache(id, source);
+            return [id, value];
+        })),
+    ]);
+    const results = { ...integrationResults };
+    for (const [id, value] of shellScriptResults)
+        results[id] = value;
+    return { checkedAt: Date.now(), results };
+}
+/**
+ * Newest "last checked" timestamp across all installer kinds. The UI
+ * (e.g. "Last checked: 2 minutes ago") reads this — it doesn't care which installer
+ * owned the probe, only when *any* probe last finished.
+ */
+export function getIntegrationAppUpdatesLastCheckedAt() {
+    const integrationAt = getUpdateCacheLastCheckedAt();
+    const shellScriptAt = getShellScriptUpdateCacheLastCheckedAt();
+    if (integrationAt == null)
+        return shellScriptAt;
+    if (shellScriptAt == null)
+        return integrationAt;
+    return Math.max(integrationAt, shellScriptAt);
+}
+export async function startIntegrationAppUninstall(id) {
+    const entry = getCatalogEntry(id);
+    if (!entry) {
+        return { ok: false, error: `Unknown integration app "${id}"` };
+    }
+    if (!entry.actions.uninstall) {
+        return { ok: false, error: `${entry.name} 不支持卸载` };
+    }
+    if (entry.source.kind === "integration") {
+        const depCount = countInstancesUsingIntegrationKind(entry.source.integrationKind);
+        if (depCount > 0) {
+            return {
+                ok: false,
+                error: `还有 ${depCount} 个实例使用 ${entry.name}，请先删除这些实例再卸载`,
+            };
+        }
+        return startIntegrationUninstall(entry.source.integrationKind);
+    }
+    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/integrations/installable/index.js.map

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

package/dist/services/integrations/installable/installers/integration-probes.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Probe functions used by `buildCardView` to populate an integration-backed
+ * `IntegrationAppCardView` — 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. `forceRefreshAllIntegrationUpdates` 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 integration's instances currently run on. Prefers
+ * the integration runtime record in core.json.runtime_catalog; falls back to
+ * the integration's declared default so update checks still work even when the
+ * runtime artifact has been uninstalled (or was never installed through the
+ * new flow).
+ */
+export declare function resolveIntegrationImage(integrationKind: string): string | null;
+export declare function probeIntegrationStatus(integrationKind: string): Promise<{
+    installed: boolean;
+    imageReady: boolean;
+    version?: string;
+    digest?: string;
+} | null>;
+/**
+ * Read the disk size (MB, decimal) of the integration'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 probeIntegrationImageSizeMB(integrationKind: 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 probeIntegrationUpdateAvailable(integrationKind: 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/integrations/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 forceRefreshAllIntegrationUpdates(integrationKinds: string[]): Promise<Record<string, boolean | null>>;