jishushell 0.4.24 → 0.4.30

package/dist/services/connection-resolver.js

@@ -0,0 +1,281 @@
+/**
+ * Layer 2 — resolveConnections (§6.3 of the app interconnection design).
+ *
+ * Drop-in replacement for the legacy `app-manager.resolveRequires(spec)`.
+ * The new function takes both the consumer spec and the consumer instance
+ * (so it can read `instance.connections` UI bindings), and runs in one of
+ * two modes:
+ *
+ *   - "preCreate": install / create-instance path. The consumer instance
+ *     does not yet have UI-driven bindings. Only legacy single-candidate
+ *     fallback resolves; everything else is collected into `pending` and
+ *     never throws — install completes even if optional providers are
+ *     missing.
+ *   - "runtime": startApp path. UI bindings are honored; missing required
+ *     bindings throw `MISSING_REQUIRED_CONNECTION (412)`; multi-candidate
+ *     unbound prefix requires throw `AMBIGUOUS_CONNECTION (409)`; mismatched
+ *     bindings throw `INVALID_BINDING (400)`.
+ *
+ * The return shape `{ resolved, pending }` lets each caller decide what to
+ * do (write env, throw, write to task event for UI display).
+ */
+import * as capabilityRegistry from "./capability-registry.js";
+// ── Category whitelist (§4.1) ────────────────────────────────────────────
+const CAPABILITY_CATEGORIES = new Set(["llm", "search", "browser", "mcp"]);
+export function isCategoryToken(s) {
+    return CAPABILITY_CATEGORIES.has(s);
+}
+/**
+ * Extract the category of a provide-side capability name. Returns the
+ * category token ("llm" / "search" / "browser" / "mcp") when the name is
+ * `<token>-something`; null for legacy exact names like `ollama-api`.
+ */
+export function categoryFromProviderCapability(cap) {
+    const dash = cap.indexOf("-");
+    if (dash <= 0)
+        return null;
+    const head = cap.slice(0, dash);
+    return CAPABILITY_CATEGORIES.has(head) ? head : null;
+}
+/**
+ * For LLM `proxy-upstream` mode: convert a provide capability like
+ * `llm-ollama` to the providerKind token (`ollama` / `vllm` / `sglang` /
+ * `custom`) the embedded llm-proxy expects on `x-jishushell.proxy.upstream.providerId`.
+ */
+export function providerKindFromCapability(cap) {
+    const m = cap.match(/^llm-(ollama|vllm|sglang)$/);
+    if (m)
+        return m[1];
+    return "custom";
+}
+// ── Errors with stable code field ────────────────────────────────────────
+export class ConnectionError extends Error {
+    code;
+    statusCode;
+    details;
+    constructor(code, statusCode, message, details) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        if (details)
+            this.details = details;
+    }
+}
+// ── validateBoundEntries (§6.3) ──────────────────────────────────────────
+function reqMatchesEntry(req, entry) {
+    if (isCategoryToken(req.capability)) {
+        // Prefix-match: `llm` matches `llm-ollama` / `llm-vllm` etc.
+        return entry.capability === req.capability ||
+            entry.capability.startsWith(req.capability + "-");
+    }
+    // Exact match for legacy bindable names.
+    return entry.capability === req.capability;
+}
+function validateBoundEntries(req, entries) {
+    const cardinality = req.cardinality ?? "one";
+    for (const entry of entries) {
+        if (!reqMatchesEntry(req, entry)) {
+            throw new ConnectionError("INVALID_BINDING", 400, `Slot '${req.inject_as}' bound to provider '${entry.instanceId}' with capability '${entry.capability}', which does not match require '${req.capability}'`, { slot: req.inject_as, expected: req.capability, got: entry.capability });
+        }
+    }
+    if (cardinality === "one" && entries.length !== 1) {
+        throw new ConnectionError("INVALID_BINDING", 400, `Slot '${req.inject_as}' has cardinality:one but ${entries.length} providers bound`, { slot: req.inject_as, count: entries.length });
+    }
+    if (cardinality === "many" && entries.length === 0) {
+        throw new ConnectionError("INVALID_BINDING", 400, `Slot '${req.inject_as}' has cardinality:many but no providers bound`, { slot: req.inject_as });
+    }
+}
+// ── Helpers for category derivation ─────────────────────────────────────
+function categoryFor(req, entries) {
+    if (isCategoryToken(req.capability))
+        return req.capability;
+    // Legacy exact require: derive from first entry's provide capability.
+    for (const e of entries) {
+        const cat = categoryFromProviderCapability(e.capability);
+        if (cat)
+            return cat;
+    }
+    return "default";
+}
+// ── Main API ─────────────────────────────────────────────────────────────
+/**
+ * Resolve all `requires` on `spec` against the registry + the instance's
+ * persisted bindings.
+ *
+ * @param spec     Consumer app spec (`requires[]` is the input)
+ * @param instance Consumer app instance shape — may be a stub
+ *                 `{ connections: {} }` during create-instance / install
+ *                 (preCreate mode) or the live instance.json (runtime).
+ * @param mode     Affects error semantics: preCreate never throws on
+ *                 missing/ambiguous; runtime throws.
+ */
+export function resolveConnections(spec, instance, mode) {
+    const resolved = [];
+    const pending = [];
+    if (!spec.requires || spec.requires.length === 0) {
+        return { resolved, pending };
+    }
+    const connectionsMap = instance.connections ?? {};
+    for (const req of spec.requires) {
+        const isRequired = req.required !== false;
+        const cardinality = req.cardinality ?? "one";
+        const persisted = connectionsMap[req.inject_as];
+        // ── User explicit disconnect ───────────────────────────────────────
+        if (persisted === null) {
+            if (isRequired && mode === "runtime") {
+                throw new ConnectionError("MISSING_REQUIRED_CONNECTION", 412, `Required connection '${req.inject_as}' (${req.capability}) is explicitly disconnected`, { slot: req.inject_as, capability: req.capability });
+            }
+            pending.push({
+                slot: req.inject_as,
+                capability: req.capability,
+                required: isRequired,
+                reason: "user-disconnected",
+            });
+            continue;
+        }
+        // ── User-driven binding (UI) ───────────────────────────────────────
+        if (persisted) {
+            const entries = collectEntriesFromBinding(persisted);
+            validateBoundEntries(req, entries);
+            // Status check (running) — preCreate skips since instance not yet
+            // alive, runtime requires running provider.
+            if (mode === "runtime") {
+                for (const entry of entries) {
+                    if (entry.status !== "running") {
+                        throw new ConnectionError("PROVIDER_NOT_RUNNING", 409, `Provider '${entry.instanceId}' for slot '${req.inject_as}' is not running (status=${entry.status})`, { slot: req.inject_as, providerId: entry.instanceId, status: entry.status });
+                    }
+                }
+            }
+            resolved.push({
+                slot: req.inject_as,
+                capability: req.capability,
+                category: categoryFor(req, entries),
+                required: isRequired,
+                apply: req.apply,
+                cardinality,
+                entries,
+                source: "ui-binding",
+            });
+            continue;
+        }
+        // ── No persisted binding — try legacy single-candidate fallback ────
+        // Legacy exact require with a single registered provider auto-resolves
+        // (this preserves the meta-app "open the box and it works" UX). Prefix
+        // requires with multiple candidates always fall through to pending /
+        // throw — the user must pick.
+        if (!isCategoryToken(req.capability)) {
+            const list = capabilityRegistry.listProviders(req.capability);
+            const running = list.filter((e) => e.status === "running");
+            if (running.length === 1) {
+                resolved.push({
+                    slot: req.inject_as,
+                    capability: req.capability,
+                    category: categoryFor(req, running),
+                    required: isRequired,
+                    apply: req.apply,
+                    cardinality,
+                    entries: [running[0]],
+                    source: "legacy-fallback",
+                });
+                continue;
+            }
+            if (running.length > 1) {
+                if (isRequired && mode === "runtime") {
+                    throw new ConnectionError("AMBIGUOUS_CONNECTION", 409, `Slot '${req.inject_as}' (${req.capability}) has ${running.length} candidates; user must pick one in Connections tab`, { slot: req.inject_as, capability: req.capability, count: running.length });
+                }
+                pending.push({
+                    slot: req.inject_as,
+                    capability: req.capability,
+                    required: isRequired,
+                    reason: "ambiguous",
+                });
+                continue;
+            }
+            // No candidates running for legacy exact name.
+        }
+        else {
+            // Prefix-semantic require — never auto-fall-back, always require UI.
+            const candidates = enumerateCandidatesForPrefix(req.capability);
+            if (candidates.length > 0) {
+                // We have providers but none bound — UI selection required.
+                if (isRequired && mode === "runtime") {
+                    throw new ConnectionError("USER_SELECTION_REQUIRED", 409, `Required prefix slot '${req.inject_as}' (${req.capability}) has ${candidates.length} candidate(s); user must bind in Connections tab`, { slot: req.inject_as, capability: req.capability, count: candidates.length });
+                }
+                pending.push({
+                    slot: req.inject_as,
+                    capability: req.capability,
+                    required: isRequired,
+                    reason: "needs-ui-binding",
+                });
+                continue;
+            }
+        }
+        // No candidates at all.
+        if (isRequired && mode === "runtime") {
+            throw new ConnectionError("MISSING_REQUIRED_CONNECTION", 412, `Required connection '${req.inject_as}' (${req.capability}) has no candidates`, { slot: req.inject_as, capability: req.capability });
+        }
+        pending.push({
+            slot: req.inject_as,
+            capability: req.capability,
+            required: isRequired,
+            reason: "no-candidate",
+        });
+    }
+    return { resolved, pending };
+}
+function collectEntriesFromBinding(binding) {
+    if (!binding)
+        return [];
+    if (binding.kind === "single") {
+        const entry = capabilityRegistry.getProviderEntry(binding.providerId, binding.capability);
+        if (entry)
+            return [entry];
+        throw new ConnectionError("INVALID_PROVIDER_ID", 400, `Bound providerId '${binding.providerId}' (capability '${binding.capability}') not found in registry`, { providerId: binding.providerId, capability: binding.capability });
+    }
+    // many
+    const entries = [];
+    const missing = [];
+    for (const ref of binding.providers ?? []) {
+        const entry = capabilityRegistry.getProviderEntry(ref.providerId, ref.capability);
+        if (entry)
+            entries.push(entry);
+        else
+            missing.push(ref);
+    }
+    if (missing.length > 0) {
+        throw new ConnectionError("INVALID_PROVIDER_ID", 400, `${missing.length} bound providers not found in registry`, { missing });
+    }
+    return entries;
+}
+function enumerateCandidatesForPrefix(prefixToken) {
+    // Walk the registry snapshot and gather any entry whose capability name
+    // starts with `<prefixToken>-`.
+    const file = capabilityRegistry.snapshot();
+    const out = [];
+    const map = file.providersByCapability ?? {};
+    for (const [cap, list] of Object.entries(map)) {
+        if (cap.startsWith(prefixToken + "-") || cap === prefixToken) {
+            out.push(...list);
+        }
+    }
+    return out;
+}
+/**
+ * Convenience helper: resolved → flat env map (for default-ENV legacy
+ * fallback path used in install Phase 1, see §6.4 lazy materialization).
+ * Only entries with category=="default" are projected; LLM/MCP/Search/Browser
+ * categories use their own apply hooks (PR 4) and are skipped here.
+ */
+export function resolvedToLegacyEnv(resolved) {
+    const out = {};
+    for (const r of resolved) {
+        if (r.category !== "default")
+            continue;
+        if (r.entries.length === 0)
+            continue;
+        // For multi-entry default ENV: join addresses with comma (rare path).
+        out[r.slot] = r.entries.map((e) => e.address).join(",");
+    }
+    return out;
+}
+//# sourceMappingURL=connection-resolver.js.map

package/dist/services/connection-resolver.js.map

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

package/dist/services/connection-transactor.d.ts

@@ -0,0 +1,37 @@
+import type { ResolvedConnection } from "./connection-resolver.js";
+import type { ApplyContext } from "./connection-apply.js";
+import type { AppSpec, InstanceConnections } from "../types.js";
+import type { AppInstance } from "./types-shim.js";
+export interface TransactorInput {
+    instance: AppInstance;
+    spec: AppSpec;
+    newConnections: InstanceConnections;
+    /** Persist instance.json — supplied by caller (route handler). */
+    saveInstanceJson: (id: string, mutator: (cur: AppInstance) => AppInstance) => Promise<void>;
+    readInstanceJson: (id: string) => Promise<AppInstance>;
+    /** RuntimeAdapter for adapter-managed consumers; null for generic apps. */
+    adapter: ApplyContext["adapter"];
+}
+export interface TransactorResult {
+    resolved: ResolvedConnection[];
+}
+/**
+ * Raw-bytes snapshot of a side-effect file. `bytes === null` means the file
+ * did not exist at snapshot time — rollback should `unlink` it.
+ */
+interface FileSnapshot {
+    path: string;
+    bytes: Buffer | null;
+}
+export declare function applyConnections(input: TransactorInput): Promise<TransactorResult>;
+/**
+ * Test-only export so unit tests can exercise the snapshot/restore path
+ * without spinning up the full transactor. Production code should not
+ * import these names directly.
+ */
+export declare const __testing__: {
+    snapshotSideEffectFiles: (instanceId: string) => FileSnapshot[];
+    applyFileSnapshots: (snapshots: FileSnapshot[]) => void;
+    validateResolvedEndpoints: (resolved: ResolvedConnection[]) => Promise<void>;
+};
+export {};