jishushell 0.6.5 → 0.6.18

package/dist/services/capabilities/registry.js

@@ -0,0 +1,222 @@
+/**
+ * Capability registry — a persisted derived index for instance providers.
+ *
+ * The registry is not a source of truth. It is rebuilt from:
+ * canonical instances + AppSpec provides + observed runtime status.
+ */
+import { join } from "path";
+import { homedir } from "os";
+import * as config from "../../config.js";
+import { safeReadJson, safeWriteJson } from "../../utils/safe-json.js";
+import { chownToServiceUser } from "../instances/manager.js";
+import { isCapabilityInterfaceForKind, isCapabilityKind } from "./contract.js";
+function getAppsDir() {
+    const value = "APPS_DIR" in config
+        ? config.APPS_DIR
+        : undefined;
+    if (typeof value === "string" && value.trim())
+        return value;
+    const home = "JISHUSHELL_HOME" in config
+        ? config.JISHUSHELL_HOME
+        : undefined;
+    if (typeof home === "string" && home.trim())
+        return join(home, "apps");
+    return join(process.env.HOME ?? homedir(), ".jishushell", "apps");
+}
+function getRegistryPath() {
+    return join(getAppsDir(), "capability-registry.json");
+}
+function emptyRegistry() {
+    return { version: 2, providersByCapability: {} };
+}
+function normalizeStatus(status) {
+    if (status === "running" || status === "stopped" || status === "unknown") {
+        return status;
+    }
+    return "unknown";
+}
+function normalizeEntry(entry, capability) {
+    if (!entry || typeof entry !== "object")
+        return null;
+    const raw = entry;
+    const instanceId = typeof raw.instanceId === "string" ? raw.instanceId : "";
+    const hostPort = typeof raw.hostPort === "number" ? raw.hostPort : NaN;
+    const address = typeof raw.address === "string" ? raw.address : "";
+    if (!instanceId || !Number.isFinite(hostPort) || hostPort <= 0 || !address) {
+        return null;
+    }
+    const registeredAt = typeof raw.registeredAt === "string"
+        ? raw.registeredAt
+        : new Date().toISOString();
+    const host = typeof raw.host === "string" && raw.host
+        ? raw.host
+        : address.split("/")[0]?.replace(/:\d+$/, "") || "127.0.0.1";
+    const protocol = typeof raw.protocol === "string" && raw.protocol
+        ? raw.protocol
+        : "http";
+    return {
+        instanceId,
+        ...(typeof raw.name === "string" && raw.name ? { name: raw.name } : {}),
+        ...(typeof raw.capabilityId === "string" && raw.capabilityId ? { capabilityId: raw.capabilityId } : {}),
+        capability: typeof raw.capability === "string" && raw.capability ? raw.capability : capability,
+        ...(isCapabilityKind(raw.kind) ? { kind: raw.kind } : {}),
+        ...(isCapabilityKind(raw.kind) && isCapabilityInterfaceForKind(raw.kind, raw.interface)
+            ? { interface: raw.interface }
+            : {}),
+        ...(typeof raw.providerKind === "string" && raw.providerKind ? { providerKind: raw.providerKind } : {}),
+        host,
+        hostPort,
+        ...(typeof raw.path === "string" && raw.path ? { path: raw.path } : {}),
+        address,
+        protocol,
+        ...(typeof raw.visibility === "string" && raw.visibility ? { visibility: raw.visibility } : {}),
+        status: normalizeStatus(raw.status),
+        ...(typeof raw.lastSeenRunningAt === "string" && raw.lastSeenRunningAt ? { lastSeenRunningAt: raw.lastSeenRunningAt } : {}),
+        registeredAt,
+        ...(typeof raw.updatedAt === "string" && raw.updatedAt ? { updatedAt: raw.updatedAt } : {}),
+        ...(raw.toolSchema ? { toolSchema: raw.toolSchema } : {}),
+        ...(raw.auth ? { auth: raw.auth } : {}),
+    };
+}
+function compareEntryFreshness(a, b) {
+    const aTs = a.updatedAt ?? a.registeredAt ?? "";
+    const bTs = b.updatedAt ?? b.registeredAt ?? "";
+    return aTs.localeCompare(bTs);
+}
+function dedupeProviderList(list) {
+    const byInstance = new Map();
+    for (const entry of list) {
+        const prev = byInstance.get(entry.instanceId);
+        if (!prev || compareEntryFreshness(prev, entry) <= 0) {
+            byInstance.set(entry.instanceId, entry);
+        }
+    }
+    return Array.from(byInstance.values())
+        .sort((a, b) => a.instanceId.localeCompare(b.instanceId));
+}
+function normalizeProviders(input) {
+    if (!input || typeof input !== "object")
+        return {};
+    const result = {};
+    for (const [capability, rawList] of Object.entries(input)) {
+        if (!Array.isArray(rawList))
+            continue;
+        const list = rawList
+            .map((entry) => normalizeEntry(entry, capability))
+            .filter((entry) => Boolean(entry));
+        const deduped = dedupeProviderList(list);
+        if (deduped.length > 0)
+            result[capability] = deduped;
+    }
+    return result;
+}
+function readRegistryFile() {
+    const raw = safeReadJson(getRegistryPath(), "capability-registry");
+    if (!raw)
+        return emptyRegistry();
+    return {
+        version: 2,
+        ...(typeof raw.generatedAt === "string" && raw.generatedAt ? { generatedAt: raw.generatedAt } : {}),
+        providersByCapability: normalizeProviders(raw.providersByCapability),
+    };
+}
+function writeRegistryFile(reg) {
+    const path = getRegistryPath();
+    safeWriteJson(path, {
+        version: 2,
+        generatedAt: reg.generatedAt ?? new Date().toISOString(),
+        providersByCapability: normalizeProviders(reg.providersByCapability),
+    }, true);
+    chownToServiceUser(path);
+}
+function providerStateSignature(providers) {
+    const normalized = normalizeProviders(providers);
+    const stable = Object.keys(normalized).sort().map((capability) => [
+        capability,
+        normalized[capability].map((entry) => {
+            const { registeredAt: _registeredAt, updatedAt: _updatedAt, lastSeenRunningAt: _lastSeenRunningAt, ...state } = entry;
+            return state;
+        }),
+    ]);
+    return JSON.stringify(stable);
+}
+function providerStateChanged(current, next) {
+    return providerStateSignature(current) !== providerStateSignature(next);
+}
+export function readRegistry() {
+    return readRegistryFile();
+}
+export function listProviders(capability) {
+    const reg = readRegistry();
+    return reg.providersByCapability[capability] ?? [];
+}
+export function getProviderEntry(instanceId, capability) {
+    return listProviders(capability).find((entry) => entry.instanceId === instanceId);
+}
+/**
+ * Return every capability entry currently registered for an instance.
+ *
+ * Used by the lifecycle status observer (Step 4) to find a running route
+ * candidate before it performs the real Core proxy HTTP probe. Registry
+ * presence means "routable"; it is not the final proof of `ready`.
+ *
+ * Read-only and side-effect free.
+ */
+export function listProvidersForInstance(instanceId) {
+    const reg = readRegistry();
+    const result = [];
+    for (const list of Object.values(reg.providersByCapability)) {
+        for (const entry of list) {
+            if (entry.instanceId === instanceId)
+                result.push(entry);
+        }
+    }
+    return result;
+}
+function withoutInstance(providers, instanceId) {
+    const next = {};
+    for (const [capability, list] of Object.entries(providers)) {
+        const filtered = list.filter((entry) => entry.instanceId !== instanceId);
+        if (filtered.length > 0)
+            next[capability] = filtered;
+    }
+    return next;
+}
+function addEntries(providers, entries) {
+    const next = { ...providers };
+    for (const entry of entries) {
+        const list = next[entry.capability] ?? [];
+        next[entry.capability] = dedupeProviderList([...list, entry]);
+    }
+    return next;
+}
+export function replaceProvidersForApp(instanceId, entries) {
+    const reg = readRegistry();
+    const providers = addEntries(withoutInstance(reg.providersByCapability, instanceId), entries);
+    if (!providerStateChanged(reg.providersByCapability, providers))
+        return;
+    writeRegistryFile({
+        version: 2,
+        generatedAt: new Date().toISOString(),
+        providersByCapability: providers,
+    });
+}
+export function replaceAllProviders(providersByCapability) {
+    const current = readRegistry();
+    if (!providerStateChanged(current.providersByCapability, providersByCapability))
+        return;
+    writeRegistryFile({
+        version: 2,
+        generatedAt: new Date().toISOString(),
+        providersByCapability,
+    });
+}
+export function snapshot() {
+    const reg = readRegistry();
+    return {
+        version: 2,
+        ...(reg.generatedAt ? { generatedAt: reg.generatedAt } : {}),
+        providersByCapability: normalizeProviders(reg.providersByCapability),
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/services/capabilities/registry.js.map

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

package/dist/services/capabilities/sync.d.ts

@@ -0,0 +1,7 @@
+import type { CapabilityStatus } from "./registry.js";
+export declare function syncCapabilitiesForApp(instanceId: string, options?: {
+    runtimeStatus?: CapabilityStatus;
+}): Promise<void>;
+export declare function refreshCapabilityRegistry(options?: {
+    force?: boolean;
+}): Promise<void>;

package/dist/services/capabilities/sync.js

@@ -0,0 +1,223 @@
+import { resolveProvideEndpoint } from "../app-common/provide-resolver.js";
+import { isCanonicalRuntimePortRequiredError } from "../instances/manager.js";
+import * as capabilityRegistry from "./registry.js";
+import { knownProviderKindFromCapabilityName, resolveCapabilityContract, } from "./contract.js";
+import { detectSystemOllama } from "../system/system-ollama-provider.js";
+const REFRESH_TTL_MS = 5_000;
+let lastRefreshAt = 0;
+let mutationQueue = Promise.resolve();
+let refreshInFlight = null;
+let refreshInFlightForce = false;
+function enqueueMutation(task) {
+    const run = mutationQueue.then(task, task);
+    mutationQueue = run.then(() => undefined, () => undefined);
+    return run;
+}
+function normalizeProvideProtocol(protocol) {
+    const raw = typeof protocol === "string" ? protocol.trim().toLowerCase() : "";
+    return raw || "http";
+}
+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 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 buildCapabilityAddress(host, port, path) {
+    if (!path)
+        return `${host}:${port}`;
+    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+    return `${host}:${port}${normalizedPath}`;
+}
+function mapRuntimeStatus(status) {
+    if (status === "running")
+        return "running";
+    if (status === "stopped")
+        return "stopped";
+    return "unknown";
+}
+async function readRuntimeStatus(instanceId) {
+    try {
+        const { getInstanceInstallRecordRuntimeStatus } = await import("../app-common/service.js");
+        const status = await getInstanceInstallRecordRuntimeStatus(instanceId);
+        return mapRuntimeStatus(status.status);
+    }
+    catch (e) {
+        console.warn(`[capability-sync] Failed to read runtime status for '${instanceId}': ${e?.message ?? e}`);
+        return "unknown";
+    }
+}
+function existingByCapability(existing, instanceId) {
+    const result = new Map();
+    for (const [capability, list] of Object.entries(existing.providersByCapability)) {
+        const entry = list.find((item) => item.instanceId === instanceId);
+        if (entry)
+            result.set(capability, entry);
+    }
+    return result;
+}
+function buildProviderEntries(instanceId, spec, status, existing) {
+    const provides = spec.provides ?? [];
+    if (provides.length === 0)
+        return [];
+    const now = new Date().toISOString();
+    const appName = spec.name ?? spec.id;
+    const previous = existingByCapability(existing, instanceId);
+    const entries = [];
+    for (const provide of provides) {
+        if (getProvideUrl(provide))
+            continue;
+        const resolved = resolveProvideEndpoint(instanceId, spec, provide);
+        if (!resolved)
+            continue;
+        const host = resolved.host;
+        const hostPort = resolved.hostPort;
+        const contract = resolveCapabilityContract(provide);
+        // capabilityId is provider-local metadata (for display/debug). It must not
+        // influence matching and must not become providerKind; an app may expose
+        // `id: openclaw` for its own capability while still not being an LLM engine
+        // provider kind understood by the embedded proxy.
+        const capabilityId = typeof provide.id === "string" && provide.id.trim()
+            ? provide.id.trim()
+            : undefined;
+        // providerKind is a narrow LLM-proxy provider hint. Only an explicit
+        // AppSpec field or known legacy LLM capability names may set it.
+        const providerKind = typeof provide.providerKind === "string" && provide.providerKind.trim()
+            ? provide.providerKind.trim()
+            : knownProviderKindFromCapabilityName(provide.capability);
+        const oldEntry = previous.get(provide.capability);
+        const lastSeenRunningAt = status === "running"
+            ? now
+            : oldEntry?.lastSeenRunningAt;
+        const registeredAt = oldEntry?.registeredAt ?? now;
+        entries.push({
+            instanceId: instanceId,
+            name: appName,
+            ...(capabilityId ? { capabilityId } : {}),
+            capability: provide.capability,
+            ...(contract ? { kind: contract.kind, interface: contract.interface } : {}),
+            ...(providerKind ? { providerKind } : {}),
+            host,
+            hostPort,
+            ...(resolved.path ? { path: resolved.path } : {}),
+            address: buildCapabilityAddress(host, hostPort, resolved.path),
+            protocol: resolveProvideProtocol(provide),
+            ...(provide.visibility ? { visibility: String(provide.visibility) } : {}),
+            status,
+            ...(lastSeenRunningAt ? { lastSeenRunningAt } : {}),
+            registeredAt,
+            updatedAt: now,
+            ...(provide.tool_schema ? { toolSchema: provide.tool_schema } : {}),
+            ...(provide.auth ? { auth: provide.auth } : {}),
+        });
+    }
+    return entries;
+}
+function addEntries(providers, entries) {
+    for (const entry of entries) {
+        const list = providers[entry.capability] ?? [];
+        const withoutSameApp = list.filter((item) => item.instanceId !== entry.instanceId);
+        providers[entry.capability] = [...withoutSameApp, entry];
+    }
+}
+async function invalidateProvidedCapabilitiesCache() {
+    const { invalidateProvidedCapabilitiesCache: invalidate } = await import("../app-common/service.js");
+    invalidate();
+}
+export async function syncCapabilitiesForApp(instanceId, options = {}) {
+    await enqueueMutation(async () => {
+        const { getInstanceInstallRecord } = await import("../app-common/service.js");
+        const existing = capabilityRegistry.snapshot();
+        const appData = getInstanceInstallRecord(instanceId);
+        if (!appData || !appData.spec.provides?.length) {
+            capabilityRegistry.replaceProvidersForApp(instanceId, []);
+            await invalidateProvidedCapabilitiesCache();
+            return;
+        }
+        const status = options.runtimeStatus ?? await readRuntimeStatus(instanceId);
+        const entries = buildProviderEntries(instanceId, appData.spec, status, existing);
+        capabilityRegistry.replaceProvidersForApp(instanceId, entries);
+        await invalidateProvidedCapabilitiesCache();
+    });
+}
+function appProviders(providers, appData, status, existing) {
+    if (!appData.spec.provides?.length)
+        return;
+    try {
+        addEntries(providers, buildProviderEntries(appData.manifest.instanceId, appData.spec, status, existing));
+    }
+    catch (error) {
+        if (!isCanonicalRuntimePortRequiredError(error))
+            throw error;
+        // Boot rebuild is a boundary projection, not a migrator. If a provider
+        // instance lacks canonical runtime.ports[].hostPort, skip its derived
+        // registry entries here; the next per-instance status refresh will mark
+        // that instance as INSTANCE_NEEDS_MIGRATION instead of guessing AppSpec
+        // ports.
+        console.warn(`[capability-sync] ${appData.manifest.instanceId} needs migration: ${error.message}`);
+    }
+}
+async function refreshNow() {
+    const { listInstanceInstallRecords } = await import("../app-common/service.js");
+    const existing = capabilityRegistry.snapshot();
+    const providers = {};
+    for (const appData of listInstanceInstallRecords()) {
+        const status = await readRuntimeStatus(appData.manifest.instanceId);
+        appProviders(providers, appData, status, existing);
+    }
+    const systemOllama = await detectSystemOllama();
+    if (systemOllama) {
+        addEntries(providers, [systemOllama.provider]);
+    }
+    capabilityRegistry.replaceAllProviders(providers);
+    lastRefreshAt = Date.now();
+    await invalidateProvidedCapabilitiesCache();
+}
+export async function refreshCapabilityRegistry(options = {}) {
+    const force = options.force === true;
+    const now = Date.now();
+    if (!force && now - lastRefreshAt < REFRESH_TTL_MS)
+        return;
+    if (refreshInFlight) {
+        if (force && !refreshInFlightForce) {
+            await refreshInFlight;
+            await refreshCapabilityRegistry({ force: true });
+            return;
+        }
+        await refreshInFlight;
+        return;
+    }
+    refreshInFlightForce = force;
+    refreshInFlight = enqueueMutation(async () => {
+        const queuedAt = Date.now();
+        if (!force && queuedAt - lastRefreshAt < REFRESH_TTL_MS)
+            return;
+        await refreshNow();
+    }).finally(() => {
+        refreshInFlight = null;
+        refreshInFlightForce = false;
+    });
+    await refreshInFlight;
+}
+//# sourceMappingURL=sync.js.map

package/dist/services/capabilities/sync.js.map

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

package/dist/services/capability-proxy/html-rewriters/browserless.d.ts

@@ -0,0 +1 @@
+export declare function buildBrowserlessHeadHtml(_instanceId: string): string;

package/dist/services/capability-proxy/html-rewriters/browserless.js

@@ -0,0 +1,83 @@
+export function buildBrowserlessHeadHtml(_instanceId) {
+    const escapedWorkerPrelude = JSON.stringify([
+        "(function(){",
+        "function p(p0){",
+        "var s=String(p0||'').replace(/\\/+$/,'');",
+        "return /\\/browserless-debugger$/.test(s)?s.replace(/\\/browserless-debugger$/,'/browserless-api'):s;",
+        "}",
+        "var P=p(self.location&&self.location.pathname);",
+        "var _WS=self.WebSocket;",
+        "if(typeof _WS!=='function')return;",
+        "self.WebSocket=function(url,protocols){",
+        "try{var p=new URL(url,self.location.origin);",
+        "if(p.host===self.location.host&&!p.pathname.startsWith(P)){",
+        "var s=self.location.protocol==='https:'?'wss:':'ws:';",
+        "url=s+'//'+self.location.host+P+p.pathname+p.search;",
+        "}}catch(_e){}",
+        "return protocols!==undefined?new _WS(url,protocols):new _WS(url);",
+        "};",
+        "self.WebSocket.prototype=_WS.prototype;",
+        "self.WebSocket.CONNECTING=_WS.CONNECTING;",
+        "self.WebSocket.OPEN=_WS.OPEN;",
+        "self.WebSocket.CLOSING=_WS.CLOSING;",
+        "self.WebSocket.CLOSED=_WS.CLOSED;",
+        "})();",
+    ].join(""));
+    return [
+        "<script>(function(){",
+        "function gp(p0){",
+        "var s=String(p0||'').replace(/\\/+$/,'');",
+        "return /\\/browserless-debugger$/.test(s)?s.replace(/\\/browserless-debugger$/,'/browserless-api'):s;",
+        "}",
+        "try{var key='browserless-debugger:'+window.location.origin+window.location.pathname;",
+        "var raw=window.localStorage.getItem(key)||'{}';",
+        "var state={};try{state=JSON.parse(raw)||{}}catch(_e){}",
+        "var base=new URL(gp(window.location.pathname)+'/',window.location.origin);",
+        "var token=new URL(window.location.href).searchParams.get('token');",
+        "if(token)base.searchParams.set('token',token);",
+        "var settings=(state&&typeof state.apiSettings==='object'&&state.apiSettings)?state.apiSettings:{};",
+        "settings.baseURL=base.href;",
+        "state.apiSettings=settings;",
+        "window.localStorage.setItem(key,JSON.stringify(state));",
+        "}catch(_e){}",
+        "var _WS=window.WebSocket;",
+        "var _base=gp(window.location.pathname);",
+        "window.WebSocket=function(url,protocols){",
+        "try{var p=new URL(url,window.location.origin);",
+        "if(p.host===window.location.host&&!p.pathname.startsWith(_base)){",
+        "var s=window.location.protocol==='https:'?'wss:':'ws:';",
+        "url=s+'//'+window.location.host+_base+p.pathname+p.search;",
+        "}}catch(_e){}",
+        "return protocols!==undefined?new _WS(url,protocols):new _WS(url);",
+        "};",
+        "window.WebSocket.prototype=_WS.prototype;",
+        "window.WebSocket.CONNECTING=_WS.CONNECTING;",
+        "window.WebSocket.OPEN=_WS.OPEN;",
+        "window.WebSocket.CLOSING=_WS.CLOSING;",
+        "window.WebSocket.CLOSED=_WS.CLOSED;",
+        "var _Worker=window.Worker;",
+        `var _workerPrelude=${escapedWorkerPrelude};`,
+        "function shouldWrapWorker(url){",
+        "try{var p=new URL(String(url),window.location.href);",
+        "return p.protocol==='blob:'||p.protocol==='data:'||p.origin===window.location.origin;",
+        "}catch(_e){return false;}",
+        "}",
+        "function wrapWorker(url,options){",
+        "if(typeof _Worker!=='function'||!shouldWrapWorker(url))return url;",
+        "try{var resolved=new URL(String(url),window.location.href).href;",
+        "var isModule=!!(options&&options.type==='module');",
+        "var source=isModule?_workerPrelude+'\\nimport '+JSON.stringify(resolved)+';':_workerPrelude+'\\nimportScripts('+JSON.stringify(resolved)+');';",
+        "return URL.createObjectURL(new Blob([source],{type:'text/javascript'}));",
+        "}catch(_e){return url;}",
+        "}",
+        "if(typeof _Worker==='function'){",
+        "window.Worker=function(url,options){",
+        "var wrapped=wrapWorker(url,options);",
+        "return options!==undefined?new _Worker(wrapped,options):new _Worker(wrapped);",
+        "};",
+        "window.Worker.prototype=_Worker.prototype;",
+        "}",
+        "})();</script>",
+    ].join("");
+}
+//# sourceMappingURL=browserless.js.map

package/dist/services/capability-proxy/html-rewriters/browserless.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserless.js","sourceRoot":"","sources":["../../../../src/services/capability-proxy/html-rewriters/browserless.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,MAAM,oBAAoB,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1C,cAAc;QACd,iBAAiB;QACjB,2CAA2C;QAC3C,uGAAuG;QACvG,GAAG;QACH,iDAAiD;QACjD,yBAAyB;QACzB,oCAAoC;QACpC,yCAAyC;QACzC,8CAA8C;QAC9C,6DAA6D;QAC7D,uDAAuD;QACvD,sDAAsD;QACtD,eAAe;QACf,mEAAmE;QACnE,IAAI;QACJ,yCAAyC;QACzC,2CAA2C;QAC3C,+BAA+B;QAC/B,qCAAqC;QACrC,mCAAmC;QACnC,OAAO;KACR,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAEZ,OAAO;QACL,sBAAsB;QACtB,kBAAkB;QAClB,2CAA2C;QAC3C,uGAAuG;QACvG,GAAG;QACH,sFAAsF;QACtF,iDAAiD;QACjD,wDAAwD;QACxD,4EAA4E;QAC5E,oEAAoE;QACpE,gDAAgD;QAChD,oGAAoG;QACpG,6BAA6B;QAC7B,6BAA6B;QAC7B,yDAAyD;QACzD,cAAc;QACd,2BAA2B;QAC3B,yCAAyC;QACzC,2CAA2C;QAC3C,gDAAgD;QAChD,mEAAmE;QACnE,yDAAyD;QACzD,4DAA4D;QAC5D,eAAe;QACf,mEAAmE;QACnE,IAAI;QACJ,2CAA2C;QAC3C,6CAA6C;QAC7C,iCAAiC;QACjC,uCAAuC;QACvC,qCAAqC;QACrC,4BAA4B;QAC5B,sBAAsB,oBAAoB,GAAG;QAC7C,iCAAiC;QACjC,sDAAsD;QACtD,uFAAuF;QACvF,2BAA2B;QAC3B,GAAG;QACH,mCAAmC;QACnC,oEAAoE;QACpE,kEAAkE;QAClE,oDAAoD;QACpD,gJAAgJ;QAChJ,0EAA0E;QAC1E,yBAAyB;QACzB,GAAG;QACH,kCAAkC;QAClC,sCAAsC;QACtC,sCAAsC;QACtC,+EAA+E;QAC/E,IAAI;QACJ,4CAA4C;QAC5C,GAAG;QACH,gBAAgB;KACjB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACb,CAAC"}

package/dist/services/capability-proxy/html-rewriters/index.d.ts

@@ -0,0 +1,12 @@
+import type { AppProvidedCapabilitySummary } from "../../app-common/capability-service.js";
+export interface CapabilityHtmlRewriterContext {
+    instanceId: string;
+    capability: AppProvidedCapabilitySummary;
+    upstreamOrigin: string;
+    signal: AbortSignal;
+    willInjectHtml: boolean;
+}
+export interface CapabilityHtmlRewriter {
+    buildHeadHtml(ctx: CapabilityHtmlRewriterContext): Promise<string> | string;
+}
+export declare function getCapabilityHtmlRewriter(capability: Pick<AppProvidedCapabilitySummary, "capability"> | null | undefined): CapabilityHtmlRewriter | null;

package/dist/services/capability-proxy/html-rewriters/index.js

@@ -0,0 +1,25 @@
+import { buildBrowserlessHeadHtml } from "./browserless.js";
+import { buildJishuKbHeadHtml } from "./jishukb.js";
+const browserlessRewriter = {
+    buildHeadHtml(ctx) {
+        return buildBrowserlessHeadHtml(ctx.instanceId);
+    },
+};
+const jishuKbRewriter = {
+    buildHeadHtml(ctx) {
+        if (!ctx.willInjectHtml)
+            return "";
+        return buildJishuKbHeadHtml(ctx.upstreamOrigin, ctx.signal);
+    },
+};
+export function getCapabilityHtmlRewriter(capability) {
+    switch (capability?.capability) {
+        case "browserless-debugger":
+            return browserlessRewriter;
+        case "web-jishukb":
+            return jishuKbRewriter;
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/services/capability-proxy/html-rewriters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/capability-proxy/html-rewriters/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAcpD,MAAM,mBAAmB,GAA2B;IAClD,aAAa,CAAC,GAAG;QACf,OAAO,wBAAwB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;CACF,CAAC;AAEF,MAAM,eAAe,GAA2B;IAC9C,aAAa,CAAC,GAAG;QACf,IAAI,CAAC,GAAG,CAAC,cAAc;YAAE,OAAO,EAAE,CAAC;QACnC,OAAO,oBAAoB,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;CACF,CAAC;AAEF,MAAM,UAAU,yBAAyB,CACvC,UAA+E;IAE/E,QAAQ,UAAU,EAAE,UAAU,EAAE,CAAC;QAC/B,KAAK,sBAAsB;YACzB,OAAO,mBAAmB,CAAC;QAC7B,KAAK,aAAa;YAChB,OAAO,eAAe,CAAC;QACzB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/services/capability-proxy/html-rewriters/jishukb.d.ts

@@ -0,0 +1 @@
+export declare function buildJishuKbHeadHtml(upstreamOrigin: string, signal: AbortSignal): Promise<string>;