jishushell 0.6.5 → 0.7.3

package/dist/services/app-common/capability-service.js

@@ -0,0 +1,331 @@
+import { existsSync, readdirSync, lstatSync, } from "fs";
+import { join } from "path";
+import * as instanceServices from "../instances/manager.js";
+import { resolveExecutionOwner } from "./execution-owner.js";
+import * as capabilityRegistry from "../capabilities/registry.js";
+import { resolveCapabilityContract } from "../capabilities/contract.js";
+import { resolveProvideEndpoint } from "./provide-resolver.js";
+import { getIntegration } from "../integrations/index.js";
+import { getInstanceInstallRecord, listInstanceInstallRecords } from "./install-store.js";
+import { APPS_DIR } from "./app-shared.js";
+const _REGISTRY_PATH = join(APPS_DIR, "capability-registry.json");
+function getProvideUrl(provide) {
+    const raw = typeof provide.url === "string" ? provide.url.trim() : "";
+    if (!raw)
+        return null;
+    try {
+        const parsed = new URL(raw);
+        if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+            return null;
+        }
+        return parsed.toString();
+    }
+    catch {
+        return null;
+    }
+}
+function buildCapabilityAddress(port, path) {
+    const host = port > 0 ? instanceServices.getAdvertisedHostForPort(port) : "127.0.0.1";
+    if (!path) {
+        return `${host}:${port}`;
+    }
+    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+    return `${host}:${port}${normalizedPath}`;
+}
+// docker0 bridge gateway (host.docker.internal target). A port published only
+// on this address is reachable by peer containers but NOT by a remote browser,
+// so it must never be advertised as the host for an embedded UI iframe.
+function isDockerBridgeHost(host) {
+    return host === "172.17.0.1";
+}
+function normalizeProvideProtocol(protocol) {
+    const raw = typeof protocol === "string" ? protocol.trim().toLowerCase() : "";
+    return raw || "http";
+}
+function resolveProvideProtocol(provide) {
+    const url = getProvideUrl(provide);
+    if (url) {
+        try {
+            return new URL(url).protocol.replace(/:$/, "").toLowerCase();
+        }
+        catch {
+            return normalizeProvideProtocol(provide.protocol);
+        }
+    }
+    return normalizeProvideProtocol(provide.protocol);
+}
+function collectDeclaredPorts(spec) {
+    return spec.tasks.flatMap((task) => (task.ports ?? [])
+        .map((port) => port.host_port ?? port.port)
+        .filter((port) => Number.isInteger(port) && port > 0 && port <= 65535));
+}
+// `ensureRequiredCapabilitiesAvailable` was removed in PR 3 sub-step 3c.
+// install never blocks on missing required providers. Step 4 moved the old
+// single-provider convenience to install/create materialization: if Core can
+// make a safe exact choice, it writes `instance.connections`; otherwise the
+// slot remains unbound for the Connections UI instead of being guessed later
+// by runtime/status/proxy hot paths.
+// `listProvidedCapabilities()` does a full filesystem app scan (listInstanceInstallRecords →
+// readdir + per-app spec parse) plus a registry read. `augmentInstanceMetadata`
+// calls it ~2× per instance (getProvidedCapabilitiesForApp +
+// getEmbeddedUiHintForApp), so `GET /api/instances` over N instances did ~2N
+// full disk scans per request — the dashboard warm-path cost.
+//
+// Cache the result, but key validity on a CHEAP fingerprint of the
+// underlying state, not on time alone. A time-only TTL left a staleness
+// window where a freshly installed/uninstalled instance was missing from /
+// lingered in the list until the TTL expired, which broke the Connections
+// UI and the embedded-UI hint. The fingerprint (sorted dir entries of
+// APPS_DIR plus the registry file mtime) changes the instant the app set
+// or registry changes — including external mutations — so the cache
+// self-busts without having to hook every mutation site. It costs one
+// readdir + one stat, still vastly cheaper than re-parsing every app spec.
+// The short TTL stays only as a safety net for in-place spec edits that
+// don't change the dir set; the explicit register/unregister/markStopped
+// invalidations remain as a precise fast-path for sub-millisecond registry
+// writes that could share an mtime tick.
+const PROVIDED_CAPS_TTL_MS = 5_000;
+let _providedCapsEntry = null;
+function providedCapabilitiesFingerprint() {
+    const dirEntries = (dir) => {
+        try {
+            return existsSync(dir) ? readdirSync(dir).sort().join(",") : "";
+        }
+        catch {
+            return "";
+        }
+    };
+    let registryMtime = 0;
+    try {
+        registryMtime = lstatSync(_REGISTRY_PATH).mtimeMs;
+    }
+    catch {
+        /* registry file not written yet → 0 */
+    }
+    return `${dirEntries(APPS_DIR)}|${registryMtime}`;
+}
+export function invalidateProvidedCapabilitiesCache() {
+    _providedCapsEntry = null;
+}
+export function listProvidedCapabilities() {
+    const fp = providedCapabilitiesFingerprint();
+    const now = Date.now();
+    if (_providedCapsEntry &&
+        _providedCapsEntry.fp === fp &&
+        now - _providedCapsEntry.ts < PROVIDED_CAPS_TTL_MS) {
+        return _providedCapsEntry.data;
+    }
+    const data = computeProvidedCapabilities();
+    _providedCapsEntry = { data, fp, ts: now };
+    return data;
+}
+function computeProvidedCapabilities() {
+    const reg = capabilityRegistry.snapshot();
+    return listInstanceInstallRecords().flatMap((app) => (app.spec.provides ?? []).map((provide) => {
+        const contract = resolveCapabilityContract(provide);
+        const url = getProvideUrl(provide) ?? undefined;
+        // Report only the canonical runtime hostPort. AppSpec declared ports
+        // are template metadata; turning them into direct LAN URLs would route
+        // users to the wrong instance after allocator reallocation or leave
+        // legacy instances looking healthy instead of needing migration.
+        let port;
+        try {
+            port = resolveRuntimeCapabilityPort(app.manifest.instanceId, provide.capability) ?? undefined;
+        }
+        catch (error) {
+            if (!instanceServices.isCanonicalRuntimePortRequiredError(error))
+                throw error;
+            port = undefined;
+        }
+        const address = !url && typeof port === "number" ? buildCapabilityAddress(port, provide.path) : undefined;
+        const providers = reg.providersByCapability?.[provide.capability] ?? [];
+        const registered = providers.find((e) => e.instanceId === app.manifest.instanceId)
+            ?? providers.find((e) => e.status === "running")
+            ?? providers[0];
+        const protocol = resolveProvideProtocol(provide);
+        return {
+            instanceId: app.manifest.instanceId,
+            ...(provide.id ? { id: provide.id } : {}),
+            capability: provide.capability,
+            ...(contract ? { kind: contract.kind, interface: contract.interface } : {}),
+            ...(provide.endpoint ? { endpoint: provide.endpoint } : {}),
+            ...(typeof port === "number" ? { port } : {}),
+            ...(provide.path ? { path: provide.path } : {}),
+            ...(url ? { url } : {}),
+            protocol,
+            ...(provide.visibility ? { visibility: provide.visibility } : {}),
+            ...(provide.description ? { description: provide.description } : {}),
+            ...(provide.terminal ? { terminal: provide.terminal } : {}),
+            ...(provide.embedded ? { embedded: provide.embedded } : {}),
+            ...(address ? { address } : {}),
+            registered: Boolean(registered),
+            ...(registered?.address ? { registeredAddress: registered.address } : {}),
+            ...(registered?.instanceId ? { providerInstanceId: registered.instanceId } : {}),
+        };
+    }));
+}
+export function getProvidedCapabilitiesForApp(instanceId) {
+    return listProvidedCapabilities().filter((entry) => entry.instanceId === instanceId);
+}
+/**
+ * Resolve the runtime endpoint (host + port) for a given app's capability.
+ * Returns only the canonical runtime-resolved hostPort. AppSpec ports are
+ * template declarations and must not be used as runtime hostPort fallbacks;
+ * a missing canonical runtime port means the instance needs migration.
+ */
+export function resolveRuntimeCapabilityPort(instanceId, capabilityName) {
+    const app = getInstanceInstallRecord(instanceId);
+    if (!app)
+        return null;
+    const provide = (app.spec.provides ?? []).find((p) => p.capability === capabilityName);
+    if (!provide)
+        return null;
+    const resolved = resolveProvideEndpoint(instanceId, app.spec, provide);
+    return resolved?.hostPort ?? null;
+}
+export function getEmbeddedUiHintForApp(instanceId) {
+    const app = getInstanceInstallRecord(instanceId);
+    if (!app)
+        return null;
+    const owner = resolveExecutionOwner(instanceId);
+    if (owner?.type === "integration") {
+        const embeddedUiSurface = getIntegration(owner.integrationKind).manifest?.embeddedUiSurface ?? "generic";
+        if (embeddedUiSurface !== "generic")
+            return null;
+    }
+    const provides = getProvidedCapabilitiesForApp(instanceId);
+    if (!provides.length)
+        return null;
+    const isUiCapability = (provide) => provide.kind === "ui"
+        // Legacy display fallback only: old AppSpecs encoded Web UI intent in
+        // capability names. This does not participate in capability matching or
+        // hostPort resolution, both of which use structured contract/runtime data.
+        || provide.capability.endsWith("-ui")
+        || provide.capability.startsWith("web-")
+        || provide.capability.endsWith("-web");
+    // Selection priority for which provide becomes the embedded UI:
+    //   1. structured `kind: ui`, with legacy name fallback for older specs.
+    //      Apps like AnythingLLM provide both an API capability and a UI
+    //      capability; without this preference the first-iterated API provide
+    //      can win and the iframe lands on JSON instead of the intended Web UI.
+    //   2. fall back to natural order for legacy single-capability apps.
+    const uiPreferred = provides.find((provide) => isUiCapability(provide));
+    const preferred = uiPreferred ?? null;
+    const orderedProvides = preferred
+        ? [preferred, ...provides.filter((provide) => provide !== preferred)]
+        : provides;
+    for (const provide of orderedProvides) {
+        const protocol = normalizeProvideProtocol(provide.protocol);
+        if (provide.visibility === "internal")
+            continue;
+        if (protocol !== "http" && protocol !== "https")
+            continue;
+        if (typeof provide.url === "string" && provide.url.trim()) {
+            const url = provide.url.trim();
+            return {
+                capability: provide.capability,
+                protocol,
+                url,
+            };
+        }
+        // Embedded UI direct URLs must use the canonical runtime hostPort. If it
+        // is missing, the instance needs migration and we skip the direct hint
+        // rather than synthesizing one from AppSpec's template port.
+        let resolvedPort = null;
+        try {
+            resolvedPort = resolveRuntimeCapabilityPort(instanceId, provide.capability);
+        }
+        catch (error) {
+            if (!instanceServices.isCanonicalRuntimePortRequiredError(error))
+                throw error;
+            continue;
+        }
+        if (typeof resolvedPort !== "number" || resolvedPort < 1)
+            continue;
+        // Honor explicit `embedded` opt-in/out on the provide before the
+        // auto-detection logic runs. `"proxy"` short-circuits to the
+        // same-origin proxy path (needed when upstream is firewall-blocked,
+        // emits X-Frame-Options, or otherwise can't be reached by the
+        // browser directly). `"direct"` forces the direct URL even when
+        // listening only on loopback — caller asserts they know what
+        // they're doing.
+        const embeddedMode = provide.embedded ?? "auto";
+        // Prefer a direct upstream URL when the container port is published to
+        // a LAN-reachable address (Pi with host_network "external", etc.). The
+        // same-origin reverse-proxy path is necessary only when the container
+        // is bound to 127.0.0.1 (macOS+Colima, dev laptops without LAN
+        // exposure) — there it's the only way for a remote browser to reach
+        // the iframe content. Going through the proxy when the upstream is
+        // already public causes path-collision bugs for apps that fetch
+        // absolute URLs starting with `/api/...` (e.g. OpenWebUI), because
+        // those calls bypass `<base href>` and hit the core API instead.
+        const listeningHost = instanceServices.getListeningHostForPort(resolvedPort);
+        const isLoopback = listeningHost === "127.0.0.1" || listeningHost === "::1";
+        const directlyReachable = embeddedMode !== "proxy"
+            && listeningHost
+            && (!isLoopback || embeddedMode === "direct");
+        if (directlyReachable) {
+            // Advertise a browser-reachable host. getAdvertisedHostForPort already
+            // prefers the external/LAN address and only ever falls back to the
+            // primary IPv4 — but when the port is published on the docker_bridge
+            // (docker0 IP 172.17.0.1) it is internal-only and unreachable from a
+            // remote browser, so override it with the LAN address for the embedded
+            // UI slot.
+            const rawAdvertised = instanceServices.getAdvertisedHostForPort(resolvedPort);
+            const advertised = isDockerBridgeHost(rawAdvertised)
+                ? instanceServices.getPrimaryIpv4Address()
+                : rawAdvertised;
+            const directUrl = `${protocol}://${advertised}:${resolvedPort}${provide.path ?? ""}`;
+            return {
+                capability: provide.capability,
+                protocol,
+                port: resolvedPort,
+                url: directUrl,
+            };
+        }
+        // Use same-origin reverse-proxy path so the frontend iframe works for
+        // remote browsers and macOS+Colima environments where the container
+        // port is only published to 127.0.0.1.
+        // Root-path UIs (path omitted) still need a trailing slash so the
+        // browser treats the iframe src as a directory URL. Without it, some
+        // SPA runtimes compute relative URLs from `/.../provides/<capability>`
+        // as if `<capability>` were a file segment, which breaks boot under the
+        // proxy even when the HTML/base rewrite succeeded.
+        const normalizedProvidePath = typeof provide.path === "string" ? provide.path.trim() : "";
+        const needsTrailingSlash = !normalizedProvidePath || normalizedProvidePath.endsWith("/");
+        const proxyPath = `/api/instances/${encodeURIComponent(instanceId)}/provides/${encodeURIComponent(provide.capability)}${needsTrailingSlash ? "/" : ""}`;
+        return {
+            capability: provide.capability,
+            protocol,
+            port: resolvedPort,
+            url: proxyPath,
+        };
+    }
+    return null;
+}
+export async function syncCapabilitiesForApp(instanceId, options = {}) {
+    const { syncCapabilitiesForApp: sync } = await import("../capabilities/sync.js");
+    await sync(instanceId, options);
+}
+export async function refreshCapabilityRegistry(options = {}) {
+    const { refreshCapabilityRegistry: refresh } = await import("../capabilities/sync.js");
+    await refresh(options);
+}
+export function resolveRequires(spec) {
+    if (!spec.requires || spec.requires.length === 0)
+        return {};
+    const result = {};
+    for (const req of spec.requires) {
+        const entry = capabilityRegistry
+            .listProviders(req.capability)
+            .find((provider) => provider.status === "running");
+        if (entry) {
+            result[req.inject_as] = entry.address;
+        }
+        else if (req.required !== false) {
+            throw new Error(`Required capability '${req.capability}' is not registered`);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=capability-service.js.map

package/dist/services/app-common/capability-service.js.map

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

package/dist/services/app-common/catalog-service.d.ts

@@ -0,0 +1,59 @@
+import type { AppProvide } from "../../types.js";
+export interface BuiltinAppSpecTemplate {
+    id: string;
+    fileName: string;
+    name: string;
+    description: string;
+    serviceRuntime: string | null;
+    instanceCompatible: boolean;
+    suggestedAppType: "ollama" | "custom";
+    integrationKinds: string[];
+    yaml: string;
+}
+export interface AppCatalogField {
+    name: "id" | "name" | "description";
+    type: "id" | "text";
+    required: boolean;
+}
+export interface AppCatalogItem {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    category: string;
+    source: "builtin";
+    singleInstance: boolean;
+    integrationKinds: string[];
+    create: {
+        fields: AppCatalogField[];
+        defaultId: string;
+        idPolicy: "requested" | "requested-or-singleton";
+        supportsClone?: boolean;
+    };
+    install: {
+        requiresSudo: "never" | "maybe" | "always";
+        network: "none" | "pull-images" | "download-assets";
+        steps: string[];
+        warnings: string[];
+        reason?: string;
+    };
+    ui: {
+        icon: string;
+        defaultTab: "chat" | "web-ui" | "terminal";
+        sortGroup: "agents" | "models" | "apps";
+    };
+    providesPreview: Array<{
+        id?: string;
+        capability: string;
+        kind?: string;
+        interface?: string;
+        protocol?: string;
+        endpoint?: AppProvide["endpoint"];
+        path?: string;
+        port?: number;
+        description?: string;
+    }>;
+}
+export declare function listBuiltinAppSpecs(): BuiltinAppSpecTemplate[];
+export declare function listAppCatalog(): AppCatalogItem[];
+export declare function updateInstance(instanceId: string, name?: string, description?: string): Record<string, any> | null;