@chainingintention/pi-web-cn 1.202610.4 → 2.202610.0

package/dist/server/plugins/projectPluginSettings.js

@@ -0,0 +1,95 @@
+import { isAbsolute, resolve } from "node:path";
+import { loadProjectPiWebConfig, snapshotPluginSettings } from "../workspaces/projectPiWebConfig.js";
+/**
+ * Daemon-lifetime project overrides, including absent files and scope errors.
+ * Only a new instance observes edits; each invocation supplies its own global base.
+ */
+export class ProjectPluginSettingsSnapshots {
+    constructor(projects, { timeoutMs = 5_000, loadConfig = loadProjectPiWebConfig } = {}) {
+        this.projects = projects;
+        this.scopes = new Map();
+        if (!Number.isInteger(timeoutMs) || timeoutMs <= 0)
+            throw new Error("Project config timeoutMs must be a positive integer");
+        this.timeoutMs = timeoutMs;
+        this.loadConfig = loadConfig;
+    }
+    /** Optional startup preload. Bad or timed-out scopes are retained without rejecting startup. */
+    async initialize(projects) {
+        await Promise.all(projects.map(async ({ id }) => {
+            const registered = await this.requireProject(id);
+            await this.scopeSnapshot(registered);
+        }));
+    }
+    async resolve(pluginId, globalSettings, project, signal) {
+        signal.throwIfAborted();
+        // Capture before yielding: callers cannot change the base during project I/O.
+        const base = snapshotPluginSettings(globalSettings, `Global settings for server plugin ${pluginId}`);
+        try {
+            const registered = await this.requireProject(project.id);
+            signal.throwIfAborted();
+            const snapshot = await this.scopeSnapshot(registered);
+            signal.throwIfAborted();
+            if ("error" in snapshot)
+                throw snapshot.error;
+            const overrides = Object.hasOwn(snapshot.settings, pluginId) ? snapshot.settings[pluginId] : undefined;
+            return snapshotPluginSettings({ ...base, ...overrides }, `Project settings for server plugin ${pluginId}`);
+        }
+        finally {
+            signal.throwIfAborted();
+        }
+    }
+    async requireProject(id) {
+        if (id === "")
+            throw new Error("PI WEB plugin settings require a registered project id");
+        const project = await this.projects.requireProject(id);
+        if (project.id !== id)
+            throw new Error("PI WEB plugin settings resolved a mismatched project id");
+        if (!isAbsolute(project.path))
+            throw new Error("PI WEB plugin settings require an absolute registered project path");
+        // Never read a caller-supplied path, even for an already cached id.
+        return { id, path: resolve(project.path) };
+    }
+    scopeSnapshot(project) {
+        const key = JSON.stringify([project.id, project.path]);
+        let snapshot = this.scopes.get(key);
+        if (snapshot === undefined) {
+            snapshot = this.loadScope(project);
+            this.scopes.set(key, snapshot);
+        }
+        return snapshot;
+    }
+    async loadScope(project) {
+        // This deadline belongs to the shared snapshot, not to any one caller.
+        const controller = new AbortController();
+        let timeout;
+        const deadline = new Promise((_resolve, reject) => {
+            timeout = setTimeout(() => {
+                const error = new Error(`Project config read timed out after ${String(this.timeoutMs)}ms`);
+                reject(error);
+                controller.abort(error);
+            }, this.timeoutMs);
+            timeout.unref();
+        });
+        try {
+            // Race as well as abort: stat/open and an uncooperative reader may not
+            // settle on cancellation. A late result must never replace this snapshot.
+            const loaded = await Promise.race([
+                Promise.resolve().then(() => this.loadConfig(project.path, controller.signal)),
+                deadline,
+            ]);
+            const settings = Object.freeze(Object.fromEntries(Object.entries(loaded.config.plugins ?? {})
+                .flatMap(([pluginId, config]) => config.settings === undefined ? [] : [[pluginId, config.settings]])));
+            return Object.freeze({ settings });
+        }
+        catch (error) {
+            // Fulfilled error snapshots avoid unhandled preload rejections and fail only
+            // consumers of this project. They must not fall back to global settings.
+            const message = error instanceof Error ? error.message : String(error);
+            return Object.freeze({ error: new Error(`PI WEB plugin settings for project ${project.id} (${project.path}) could not be loaded: ${message}`, { cause: error }) });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=projectPluginSettings.js.map

package/dist/server/plugins/projectPluginSettings.js.map

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

package/dist/server/plugins/serverPluginCatalogCapability.js

@@ -0,0 +1,106 @@
+import { isAbsolute, resolve } from "node:path";
+import { PI_WEB_HOST_CATALOG_CAPABILITY, } from "../../shared/pluginCatalogTypes.js";
+/** Register after provider topology settles, alongside the workspace authority factory. */
+export function createServerPluginCatalogCapabilityFactory(options) {
+    return Object.freeze({
+        capability: PI_WEB_HOST_CATALOG_CAPABILITY,
+        create(context) {
+            const disposal = new AbortController();
+            const lifetime = AbortSignal.any([context.lifetimeSignal, disposal.signal]);
+            function signalFor(read) {
+                return read?.signal === undefined ? lifetime : AbortSignal.any([lifetime, read.signal]);
+            }
+            function assertActive(signal) {
+                if (lifetime.aborted)
+                    throw new Error(`PI WEB host catalog for server plugin ${context.pluginId} is no longer active`, { cause: lifetime.reason });
+                signal.throwIfAborted();
+            }
+            async function read(requested, operation) {
+                const signal = signalFor(requested);
+                assertActive(signal);
+                try {
+                    const result = await operation(signal);
+                    assertActive(signal);
+                    return result;
+                }
+                catch (error) {
+                    assertActive(signal);
+                    throw error;
+                }
+            }
+            async function project(projectId, signal) {
+                assertActive(signal);
+                const result = await options.projects.requireProject(projectId);
+                assertActive(signal);
+                if (result.id !== projectId)
+                    throw new Error("Catalog project authority returned a mismatched project");
+                return result;
+            }
+            async function workspaces(projectId, signal) {
+                const selected = await project(projectId, signal);
+                const resolution = await options.workspaces.resolve(selected, signal);
+                assertActive(signal);
+                if (resolution.projectId !== projectId)
+                    throw new Error("Catalog workspace authority returned a mismatched project");
+                return resolution.workspaces.map((workspace) => {
+                    if (workspace.projectId !== projectId)
+                        throw new Error("Catalog workspace is outside selected project");
+                    return {
+                        id: workspace.id, projectId, path: absolutePath(workspace.path), label: workspace.label, isMain: workspace.isMain,
+                        ...(workspace.provider === undefined ? {} : { provider: workspace.provider }),
+                        ...(workspace.removal === undefined ? {} : { removal: workspace.removal }),
+                    };
+                });
+            }
+            async function workspace(selection, signal) {
+                const result = (await workspaces(selection.projectId, signal)).find(({ id }) => id === selection.workspaceId);
+                if (result === undefined)
+                    throw new Error("Catalog selected workspace is stale or unavailable");
+                return result;
+            }
+            async function sessions(selection, signal) {
+                const selected = await workspace(selection, signal);
+                const rows = await options.sessions.listCatalogSessions(selected.path, signal);
+                assertActive(signal);
+                // A reader must not supply records from a different workspace, even for get-by-id.
+                if (rows.some((row) => absolutePath(row.cwd) !== selected.path))
+                    throw new Error("Catalog session is outside selected workspace");
+                return rows;
+            }
+            const value = PI_WEB_HOST_CATALOG_CAPABILITY.parse({
+                version: 1,
+                projects: {
+                    list: (requested) => read(requested, async (signal) => {
+                        const rows = await options.projects.list();
+                        assertActive(signal);
+                        return rows.map(projectSnapshot);
+                    }),
+                    get: (id, requested) => read(requested, async (signal) => projectSnapshot(await project(id, signal))),
+                },
+                workspaces: {
+                    list: (id, requested) => read(requested, (signal) => workspaces(id, signal)),
+                    get: (selection, requested) => read(requested, (signal) => workspace(selection, signal)),
+                },
+                sessions: {
+                    list: (selection, requested) => read(requested, (signal) => sessions(selection, signal)),
+                    get: (selection, requested) => read(requested, async (signal) => {
+                        const result = (await sessions({ projectId: selection.projectId, workspaceId: selection.workspaceId }, signal)).find(({ id }) => id === selection.sessionId);
+                        if (result === undefined)
+                            throw new Error("Catalog selected session is stale or unavailable");
+                        return result;
+                    }),
+                },
+            });
+            return Object.freeze({ value, dispose: () => { disposal.abort(); } });
+        },
+    });
+}
+function absolutePath(path) {
+    if (!isAbsolute(path))
+        throw new Error("Catalog authority returned a non-absolute path");
+    return resolve(path);
+}
+function projectSnapshot(project) {
+    return { id: project.id, name: project.name, path: absolutePath(project.path) };
+}
+//# sourceMappingURL=serverPluginCatalogCapability.js.map

package/dist/server/plugins/serverPluginCatalogCapability.js.map

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

package/dist/server/plugins/serverPluginRuntime.js

@@ -22,13 +22,15 @@ export async function createServerPluginRuntime(options) {
     return await ServerPluginRuntime.activate(snapshot, options);
 }
 export class ServerPluginRuntime {
-    constructor(dataDir, safeStart, diagnostics, logger, importer, execFile, lifecycleTimeoutMs, noticeSink, hostCapabilities, hostCapabilityFactories, lateHostCapabilities, enforceRequiredTerminal, translator) {
+    constructor(dataDir, safeStart, diagnostics, logger, importer, execFile, projectSettingsResolver, workspaceNotificationsFactory, lifecycleTimeoutMs, noticeSink, hostCapabilities, hostCapabilityFactories, lateHostCapabilities, enforceRequiredTerminal, translator) {
         this.dataDir = dataDir;
         this.safeStart = safeStart;
         this.diagnostics = diagnostics;
         this.logger = logger;
         this.importer = importer;
         this.execFile = execFile;
+        this.projectSettingsResolver = projectSettingsResolver;
+        this.workspaceNotificationsFactory = workspaceNotificationsFactory;
         this.lifecycleTimeoutMs = lifecycleTimeoutMs;
         this.noticeSink = noticeSink;
         this.enforceRequiredTerminal = enforceRequiredTerminal;
@@ -51,7 +53,7 @@ export class ServerPluginRuntime {
             this.registerHostCapability(capability);
     }
     static async activate(snapshot, options) {
-        const runtime = new ServerPluginRuntime(resolve(options.dataDir), options.safeStart, Object.freeze(snapshot.diagnostics.map((diagnostic) => Object.freeze({ ...diagnostic }))), options.logger, options.importer ?? importServerPluginModule, options.execFile ?? createServerPluginExecFile(), positiveInteger(options.lifecycleTimeoutMs, DEFAULT_LIFECYCLE_TIMEOUT_MS, "lifecycleTimeoutMs"), options.noticeSink, snapshotHostCapabilities(options.hostCapabilities), snapshotHostCapabilityFactories(options.hostCapabilityFactories), snapshotLateHostCapabilities(options.lateHostCapabilities), options.enforceRequiredTerminal !== false && options.safeStart !== "none", options.translator);
+        const runtime = new ServerPluginRuntime(resolve(options.dataDir), options.safeStart, Object.freeze(snapshot.diagnostics.map((diagnostic) => Object.freeze({ ...diagnostic }))), options.logger, options.importer ?? importServerPluginModule, options.execFile ?? createServerPluginExecFile(), options.projectSettingsResolver, options.workspaceNotificationsFactory, positiveInteger(options.lifecycleTimeoutMs, DEFAULT_LIFECYCLE_TIMEOUT_MS, "lifecycleTimeoutMs"), options.noticeSink, snapshotHostCapabilities(options.hostCapabilities), snapshotHostCapabilityFactories(options.hostCapabilityFactories), snapshotLateHostCapabilities(options.lateHostCapabilities), options.enforceRequiredTerminal !== false && options.safeStart !== "none", options.translator);
         try {
             await runtime.start(snapshot.plugins);
             return runtime;
@@ -224,14 +226,21 @@ export class ServerPluginRuntime {
             const dataDirectory = resolve(this.dataDir, "plugin-data", entry.id);
             await mkdir(dataDirectory, { recursive: true });
             const scopedLogger = createScopedLogger(entry.id, this.logger);
+            if (loadedPlugin.apiVersion === 3) {
+                this.logger.warn({ pluginId: entry.id, apiVersion: 3 }, "Server plugin API v3 is deprecated; migrate to API v5");
+            }
             noticeReporter = createScopedNoticeReporter(entry.id, this.noticeSink);
+            const resolveProjectSettings = this.projectSettingsResolver?.bind(undefined, entry.id, settings);
+            const workspaceNotifications = this.workspaceNotificationsFactory?.(entry.id);
             const activationValue = await runBounded(entry.id, phase, this.lifecycleTimeoutMs, (signal) => loadedPlugin.activate(Object.freeze({
-                apiVersion: 3,
+                apiVersion: loadedPlugin.apiVersion,
                 pluginId: entry.id,
                 packageRoot: entry.packageRoot,
                 dataDirectory,
                 logger: scopedLogger,
                 settings,
+                ...(resolveProjectSettings === undefined ? {} : { resolveProjectSettings }),
+                ...(workspaceNotifications === undefined ? {} : { workspaceNotifications }),
                 ...(noticeReporter === undefined ? {} : { notices: noticeReporter.reporter }),
                 execFile: this.execFile,
                 signal,
@@ -240,7 +249,7 @@ export class ServerPluginRuntime {
             })));
             rollbackDispose = activationDisposeForRollback(activationValue);
             phase = "validate";
-            const loadedActivation = parseActivation(activationValue, entry.id);
+            const loadedActivation = parseActivation(activationValue, entry.id, loadedPlugin.apiVersion);
             if (this.enforceRequiredTerminal && entry.id === REQUIRED_TERMINAL_PLUGIN_ID) {
                 requireTerminalActivation(loadedActivation);
             }
@@ -475,6 +484,7 @@ export class ServerPluginRuntime {
                 source: staged.entry.source,
                 scope: staged.entry.scope,
                 moduleRevision: requireServerModule(staged.entry).revision,
+                apiVersion: staged.plugin.apiVersion,
                 backend: staged.activation.peer,
                 requires: this.resolvedCapabilityRequirements(staged),
             });
@@ -681,7 +691,7 @@ function parsePluginExport(imported) {
     const apiVersion = plugin["apiVersion"];
     const name = plugin["name"];
     const activateValue = plugin["activate"];
-    if (apiVersion !== 3) {
+    if (apiVersion !== 3 && apiVersion !== 5) {
         throw new IncompatibleServerPluginError(`Unsupported server plugin API version: ${formatUnknown(apiVersion)}`);
     }
     if (typeof name !== "string" || name === "") {
@@ -692,6 +702,7 @@ function parsePluginExport(imported) {
     }
     const requires = snapshotCapabilityRequirements(plugin["requires"], `Server plugin ${name} requirements`);
     return Object.freeze({
+        apiVersion,
         name,
         ...(requires.length === 0 ? {} : { requires }),
         activate(context) {
@@ -710,7 +721,7 @@ function activationDisposeForRollback(value) {
         await Reflect.apply(dispose, value, [signal]);
     };
 }
-function parseActivation(value, pluginId) {
+function parseActivation(value, pluginId, apiVersion) {
     if (!isRecord(value))
         throw new IncompatibleServerPluginError("Server plugin activation must be an object");
     if (value["workspaceProviders"] !== undefined) {
@@ -727,7 +738,7 @@ function parseActivation(value, pluginId) {
     const provides = snapshotCapabilityProvisions(value["provides"], pluginId, `Server plugin ${pluginId} provisions`);
     const candidate = {
         workspaceProvider: workspaceProviderValue === undefined ? undefined : snapshotWorkspaceProvider(workspaceProviderValue),
-        peer: peerValue === undefined ? undefined : snapshotPluginPeer(peerValue),
+        peer: peerValue === undefined ? undefined : snapshotPluginPeer(peerValue, apiVersion),
         provides,
         start: value["start"],
         dispose: value["dispose"],
@@ -1041,7 +1052,7 @@ function combinedDisposalError(pluginError, hostCleanupError) {
         return pluginError;
     return new AggregateError([pluginError, hostCleanupError], `${errorMessage(pluginError)}; host capability cleanup failed: ${errorMessage(hostCleanupError)}`);
 }
-function snapshotPluginPeer(value) {
+function snapshotPluginPeer(value, apiVersion) {
     if (!isPluginPeer(value)) {
         throw new IncompatibleServerPluginError("Server plugin peer must include a request or channel handler");
     }
@@ -1049,10 +1060,10 @@ function snapshotPluginPeer(value) {
     const openChannel = value.openChannel?.bind(value);
     const snapshotRequest = request === undefined
         ? undefined
-        : (context) => request(context);
+        : (context) => request(peerContextForVersion(context, apiVersion));
     const snapshotOpenChannel = openChannel === undefined
         ? undefined
-        : async (context) => (snapshotPluginPeerChannel(await openChannel(context)));
+        : async (context) => (snapshotPluginPeerChannel(await openChannel(peerContextForVersion(context, apiVersion))));
     if (snapshotRequest !== undefined && snapshotOpenChannel !== undefined) {
         return Object.freeze({ request: snapshotRequest, openChannel: snapshotOpenChannel });
     }
@@ -1062,6 +1073,14 @@ function snapshotPluginPeer(value) {
         return Object.freeze({ openChannel: snapshotOpenChannel });
     throw new IncompatibleServerPluginError("Server plugin peer must include a request or channel handler");
 }
+function peerContextForVersion(context, apiVersion) {
+    if (apiVersion === 5)
+        return context;
+    if (context.scope.kind !== "workspace")
+        throw new Error("Server plugin API v3 requires workspace scope");
+    const { scope, ...invocation } = context;
+    return Object.freeze({ ...invocation, project: scope.project, workspace: scope.workspace });
+}
 function isPluginPeer(value) {
     if (!isRecord(value))
         return false;
@@ -1101,17 +1120,20 @@ function snapshotWorkspaceProvider(value) {
         probe: value["probe"],
         list: value["list"],
         prepareRemove: value["prepareRemove"],
+        integration: value["integration"],
     };
     if (!isWorkspaceProvider(candidate))
         throw new IncompatibleServerPluginError("Server plugin workspaceProvider is invalid");
     const probe = candidate.probe.bind(value);
     const list = candidate.list.bind(value);
     const prepareRemove = candidate.prepareRemove?.bind(value);
+    const integration = snapshotWorkspaceProviderIntegration(candidate.integration);
     return Object.freeze({
         ...(candidate.fallback === undefined ? {} : { fallback: candidate.fallback }),
         probe: (project, signal) => probe(project, signal),
         list: (project, signal) => list(project, signal),
         ...(prepareRemove === undefined ? {} : { prepareRemove: (context) => prepareRemove(context) }),
+        ...(integration === undefined ? {} : { integration }),
     });
 }
 function isWorkspaceProvider(value) {
@@ -1124,7 +1146,21 @@ function isWorkspaceProvider(value) {
     return (fallback === undefined || typeof fallback === "boolean")
         && typeof probe === "function"
         && typeof list === "function"
-        && (prepareRemove === undefined || typeof prepareRemove === "function");
+        && (prepareRemove === undefined || typeof prepareRemove === "function")
+        && (value["integration"] === undefined || isWorkspaceProviderIntegration(value["integration"]));
+}
+function isWorkspaceProviderIntegration(value) {
+    return isRecord(value) && typeof value["reconcile"] === "function" && typeof value["acceptNotification"] === "function";
+}
+function snapshotWorkspaceProviderIntegration(value) {
+    if (value === undefined)
+        return undefined;
+    const reconcile = value.reconcile.bind(value);
+    const acceptNotification = value.acceptNotification.bind(value);
+    return Object.freeze({
+        reconcile: (project, signal) => reconcile(project, signal),
+        acceptNotification: (project, signal) => acceptNotification(project, signal),
+    });
 }
 function parseHealth(value) {
     if (!isRecord(value))