@jmfederico/pi-web 1.202608.2 → 1.202609.1

package/dist/shared/machinePluginIds.js

@@ -1,13 +1,23 @@
-import { isPiWebPluginId, isReservedPiWebPluginId } from "./pluginIds.js";
+import { isPiWebBundledPluginId, isPiWebPluginId, isReservedPiWebPluginId } from "./pluginIds.js";
 const MACHINE_PLUGIN_ID_PREFIX = "machine.";
 export function machineScopedPluginId(machineId, pluginId) {
-    if (machineId === "")
-        throw new Error("Machine id is required");
-    if (!isPiWebPluginId(pluginId))
-        throw new Error(`Invalid PI WEB plugin id: ${pluginId}`);
+    requireMachinePluginId(machineId, pluginId);
     if (isReservedPiWebPluginId(pluginId))
         throw new Error(`Reserved PI WEB plugin id: ${pluginId}`);
-    return `${MACHINE_PLUGIN_ID_PREFIX}${stringToHex(machineId)}.${pluginId}`;
+    return scopedPluginId(machineId, pluginId);
+}
+/** Machine-scope a host-validated plugin from PI WEB's bundled-only namespace. */
+export function machineScopedBundledPluginId(machineId, pluginId) {
+    requireMachinePluginId(machineId, pluginId);
+    if (!isPiWebBundledPluginId(pluginId))
+        throw new Error(`PI WEB bundled plugin id is required: ${pluginId}`);
+    return scopedPluginId(machineId, pluginId);
+}
+/** Machine-scope an id only after its host-authored manifest has been validated. */
+export function machineScopedManifestPluginId(machineId, pluginId) {
+    return isPiWebBundledPluginId(pluginId)
+        ? machineScopedBundledPluginId(machineId, pluginId)
+        : machineScopedPluginId(machineId, pluginId);
 }
 export function parseMachineScopedPluginId(pluginId) {
     if (!pluginId.startsWith(MACHINE_PLUGIN_ID_PREFIX))
@@ -18,13 +28,24 @@ export function parseMachineScopedPluginId(pluginId) {
         return undefined;
     const encodedMachineId = rest.slice(0, separator);
     const sourcePluginId = rest.slice(separator + 1);
-    if (!isHexString(encodedMachineId) || !isPiWebPluginId(sourcePluginId) || isReservedPiWebPluginId(sourcePluginId))
+    if (!isHexString(encodedMachineId)
+        || !isPiWebPluginId(sourcePluginId)
+        || (isReservedPiWebPluginId(sourcePluginId) && !isPiWebBundledPluginId(sourcePluginId)))
         return undefined;
     const machineId = hexToString(encodedMachineId);
     if (machineId === "")
         return undefined;
     return { machineId, pluginId: sourcePluginId };
 }
+function requireMachinePluginId(machineId, pluginId) {
+    if (machineId === "")
+        throw new Error("Machine id is required");
+    if (!isPiWebPluginId(pluginId))
+        throw new Error(`Invalid PI WEB plugin id: ${pluginId}`);
+}
+function scopedPluginId(machineId, pluginId) {
+    return `${MACHINE_PLUGIN_ID_PREFIX}${stringToHex(machineId)}.${pluginId}`;
+}
 function stringToHex(value) {
     return [...new TextEncoder().encode(value)]
         .map((byte) => byte.toString(16).padStart(2, "0"))

package/dist/shared/machinePluginIds.js.map

@@ -1 +1 @@
-{"version":3,"file":"machinePluginIds.js","sourceRoot":"","sources":["../../src/shared/machinePluginIds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,MAAM,wBAAwB,GAAG,UAAU,CAAC;AAO5C,MAAM,UAAU,qBAAqB,CAAC,SAAiB,EAAE,QAAgB;IACvE,IAAI,SAAS,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAChE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,EAAE,CAAC,CAAC;IACzF,IAAI,uBAAuB,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;IACjG,OAAO,GAAG,wBAAwB,GAAG,WAAW,CAAC,SAAS,CAAC,IAAI,QAAQ,EAAE,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAgB;IACzD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,wBAAwB,CAAC;QAAE,OAAO,SAAS,CAAC;IACrE,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAEpC,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAClD,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IACjD,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,IAAI,uBAAuB,CAAC,cAAc,CAAC;QAAE,OAAO,SAAS,CAAC;IAEpI,MAAM,SAAS,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAChD,IAAI,SAAS,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACvC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;AACjD,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,CAAC,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SACxC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SACjD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClF,CAAC"}
+{"version":3,"file":"machinePluginIds.js","sourceRoot":"","sources":["../../src/shared/machinePluginIds.ts"],"names":[],"mappings":"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"}

package/dist/shared/pluginApiTypes.d.ts

@@ -4,8 +4,28 @@ export type JsonValue = JsonPrimitive | JsonObject | readonly JsonValue[];
 export interface JsonObject {
     readonly [key: string]: JsonValue;
 }
+/**
+ * Typed token for one exact host/plugin capability version. The provider id
+ * and package-local id together with the version form the stable capability
+ * identity; matching keys do not imply matching parsers. `parse` validates and
+ * may snapshot values at provider, declared-requirement, and resolution boundaries.
+ * Parsers must be pure (no input mutation or lifecycle side effects) and tolerate
+ * repeated calls; invocation counts and returned object identity are not guaranteed.
+ * A resolver's parser receives the provider-parsed value, not the discarded result
+ * of declared-requirement validation.
+ */
+export interface PluginCapability<Value = unknown, Version extends number = number> {
+    readonly pluginId: string;
+    readonly id: string;
+    readonly version: Version;
+    readonly parse: (value: unknown) => Value;
+}
+/** One capability value declaratively published by its owning plugin. */
+export interface PluginCapabilityProvision<Value = unknown, Version extends number = number> {
+    readonly capability: PluginCapability<Value, Version>;
+    readonly value: Value;
+}
 export interface WorkspaceProviderCapabilities {
-    readonly request: boolean;
     /** True only when this specific workspace advertises removal. */
     readonly remove: boolean;
 }

package/dist/shared/pluginApiTypes.js

@@ -1,3 +1,2 @@
 // Dependency-free DTOs shared by PI WEB's public plugin entrypoints and host protocols.
 export {};
-//# sourceMappingURL=pluginApiTypes.js.map

package/dist/shared/pluginBackendProtocol.js

@@ -8,13 +8,47 @@ export const PLUGIN_BACKEND_REQUEST_BODY_MAX_BYTES = PLUGIN_BACKEND_JSON_MAX_BYT
 export const PLUGIN_BACKEND_RESPONSE_BODY_MAX_BYTES = PLUGIN_BACKEND_RESPONSE_JSON_MAX_BYTES + 4 * 1024;
 /** Bounded provider callback deadline inside sessiond. */
 export const PLUGIN_BACKEND_REQUEST_TIMEOUT_MS = 10_000;
-/** End-to-end sessiond deadline, including owner re-resolution and validation. */
+/** End-to-end sessiond deadline, including workspace re-resolution and validation. */
 export const PLUGIN_BACKEND_DISPATCH_TIMEOUT_MS = 25_000;
-/** Remote gateway deadline, including workspace owner re-resolution. */
+/** Remote gateway deadline, including authoritative workspace re-resolution. */
 export const PLUGIN_BACKEND_FEDERATION_TIMEOUT_MS = 30_000;
 export const PLUGIN_BACKEND_OPERATION_MAX_LENGTH = 128;
 export const PLUGIN_BACKEND_REVISION_MAX_LENGTH = 512;
+/** Host-envelope allowance around the existing bounded request-sized channel open input. */
+export const PLUGIN_BACKEND_CHANNEL_OPEN_FRAME_MAX_BYTES = PLUGIN_BACKEND_JSON_MAX_BYTES + 4 * 1024;
+/** Maximum JSON payload carried by one channel data envelope. */
+export const PLUGIN_BACKEND_CHANNEL_DATA_JSON_MAX_BYTES = 64 * 1024;
+/** Host-envelope allowance around one bounded channel data payload. */
+export const PLUGIN_BACKEND_CHANNEL_DATA_FRAME_MAX_BYTES = PLUGIN_BACKEND_CHANNEL_DATA_JSON_MAX_BYTES + 4 * 1024;
+export const PLUGIN_BACKEND_CHANNEL_QUEUE_MAX_FRAMES = 128;
+/** Browser-to-server aggregate queue bound at each host hop. */
+export const PLUGIN_BACKEND_CHANNEL_QUEUE_MAX_BYTES = 1024 * 1024;
+/** Server-to-browser bound accommodates Terminal's full worst-case escaped replay plus live output. */
+export const PLUGIN_BACKEND_CHANNEL_SERVER_TO_BROWSER_QUEUE_MAX_BYTES = 1_280 * 1024;
+/** Independent aggregate edge cap and authoritative sessiond global cap. */
+export const PLUGIN_BACKEND_CHANNEL_MAX_TOTAL = 128;
+/** Authoritative sessiond per-plugin admission cap. */
+export const PLUGIN_BACKEND_CHANNEL_MAX_PER_PLUGIN = 32;
+/** Authoritative sessiond per-plugin/workspace admission cap. */
+export const PLUGIN_BACKEND_CHANNEL_MAX_PER_PLUGIN_WORKSPACE = 8;
+export const PLUGIN_BACKEND_CHANNEL_CALLBACK_TIMEOUT_MS = 10_000;
+/**
+ * Shared duration for independently owned edge transport-connect and sessiond
+ * plugin-open deadlines. An upstream OPEN cancels only the edge deadline.
+ */
+export const PLUGIN_BACKEND_CHANNEL_OPEN_TIMEOUT_MS = 10_000;
+/** Maximum time a clean close may wait for already-accepted socket frames or callbacks. */
+export const PLUGIN_BACKEND_CHANNEL_DRAIN_TIMEOUT_MS = 10_000;
+/** Hard deadline before a non-cooperating peer is physically terminated. */
+export const PLUGIN_BACKEND_CHANNEL_TEARDOWN_TIMEOUT_MS = 1_000;
+export const PLUGIN_BACKEND_CHANNEL_MAX_LIFETIME_MS = 12 * 60 * 60_000;
+export const PLUGIN_BACKEND_CHANNEL_CLOSE_REASON_MAX_BYTES = 120;
+export const PLUGIN_BACKEND_CHANNEL_ERROR_MESSAGE_MAX_BYTES = 2_048;
+export const PLUGIN_BACKEND_CHANNEL_ERROR_CODE_MAX_LENGTH = 64;
+export const PAIRED_PLUGIN_BACKEND_REQUEST_ROUTE_PATH = "/paired-plugin-backends/:pluginId/projects/:projectId/workspaces/:workspaceId/:operation";
+export const PAIRED_PLUGIN_BACKEND_CHANNEL_ROUTE_PATH = "/paired-plugin-backends/:pluginId/projects/:projectId/workspaces/:workspaceId/channels/:operation";
 const OPERATION_PATTERN = /^[a-z][a-z0-9.-]*$/u;
+const CHANNEL_ERROR_CODE_PATTERN = /^[a-z][a-z0-9.-]*$/u;
 const MAX_JSON_DEPTH = 64;
 export function isPluginBackendOperation(value) {
     return value.length <= PLUGIN_BACKEND_OPERATION_MAX_LENGTH && OPERATION_PATTERN.test(value);
@@ -64,9 +98,136 @@ export function parsePluginBackendRequestEnvelope(value) {
         input: cloneBoundedPluginBackendJson(value["input"], "Plugin backend request input"),
     });
 }
+export function serializePluginBackendChannelOpenEnvelope(revision, input) {
+    return serializePluginBackendChannelEnvelope({
+        version: 1,
+        kind: "open",
+        revision: requirePluginBackendRevision(revision),
+        input: cloneBoundedPluginBackendJson(input, "Plugin backend channel open input", PLUGIN_BACKEND_JSON_MAX_BYTES),
+    }, "Plugin backend channel open envelope", PLUGIN_BACKEND_CHANNEL_OPEN_FRAME_MAX_BYTES);
+}
+export function serializePluginBackendChannelReadyEnvelope() {
+    return JSON.stringify({ version: 1, kind: "ready" });
+}
+export function serializePluginBackendChannelDataEnvelope(data) {
+    return serializePluginBackendChannelEnvelope({
+        version: 1,
+        kind: "data",
+        data: cloneBoundedPluginBackendJson(data, "Plugin backend channel data", PLUGIN_BACKEND_CHANNEL_DATA_JSON_MAX_BYTES),
+    }, "Plugin backend channel data envelope", PLUGIN_BACKEND_CHANNEL_DATA_FRAME_MAX_BYTES);
+}
+export function serializePluginBackendChannelErrorEnvelope(code, message) {
+    const parsedCode = requirePluginBackendChannelErrorCode(code);
+    const parsedMessage = requirePluginBackendChannelErrorMessage(message);
+    return serializePluginBackendChannelEnvelope({ version: 1, kind: "error", code: parsedCode, message: parsedMessage }, "Plugin backend channel error envelope", PLUGIN_BACKEND_CHANNEL_DATA_FRAME_MAX_BYTES);
+}
+export function parsePluginBackendChannelClientEnvelope(text) {
+    const value = parseChannelEnvelopeRecord(text, "Plugin backend channel client frame");
+    requireChannelEnvelopeVersion(value);
+    if (value["kind"] === "open") {
+        requireFrameByteLimit(text, PLUGIN_BACKEND_CHANNEL_OPEN_FRAME_MAX_BYTES, "Plugin backend channel open frame");
+        return Object.freeze({
+            version: 1,
+            kind: "open",
+            revision: requirePluginBackendRevision(value["revision"]),
+            input: cloneBoundedPluginBackendJson(value["input"], "Plugin backend channel open input", PLUGIN_BACKEND_JSON_MAX_BYTES),
+        });
+    }
+    if (value["kind"] === "data")
+        return parseChannelDataEnvelope(value, text);
+    throw new Error("Plugin backend channel client frame kind is invalid");
+}
+export function parsePluginBackendChannelServerEnvelope(text) {
+    const value = parseChannelEnvelopeRecord(text, "Plugin backend channel server frame");
+    requireChannelEnvelopeVersion(value);
+    if (value["kind"] === "ready") {
+        requireFrameByteLimit(text, PLUGIN_BACKEND_CHANNEL_DATA_FRAME_MAX_BYTES, "Plugin backend channel ready frame");
+        return Object.freeze({ version: 1, kind: "ready" });
+    }
+    if (value["kind"] === "data")
+        return parseChannelDataEnvelope(value, text);
+    if (value["kind"] === "error") {
+        requireFrameByteLimit(text, PLUGIN_BACKEND_CHANNEL_DATA_FRAME_MAX_BYTES, "Plugin backend channel error frame");
+        return Object.freeze({
+            version: 1,
+            kind: "error",
+            code: requirePluginBackendChannelErrorCode(value["code"]),
+            message: requirePluginBackendChannelErrorMessage(value["message"]),
+        });
+    }
+    throw new Error("Plugin backend channel server frame kind is invalid");
+}
+export function requirePluginBackendChannelCloseReason(value) {
+    if (typeof value !== "string")
+        throw new Error("Plugin backend channel close reason must be a string");
+    if (utf8ByteLength(value) > PLUGIN_BACKEND_CHANNEL_CLOSE_REASON_MAX_BYTES) {
+        throw new Error(`Plugin backend channel close reason exceeds the ${String(PLUGIN_BACKEND_CHANNEL_CLOSE_REASON_MAX_BYTES)} byte limit`);
+    }
+    return value;
+}
+export function boundedPluginBackendChannelCloseReason(value) {
+    const input = typeof value === "string" ? value : String(value);
+    if (utf8ByteLength(input) <= PLUGIN_BACKEND_CHANNEL_CLOSE_REASON_MAX_BYTES)
+        return input;
+    let output = "";
+    for (const character of input) {
+        if (utf8ByteLength(`${output}${character}`) > PLUGIN_BACKEND_CHANNEL_CLOSE_REASON_MAX_BYTES)
+            break;
+        output += character;
+    }
+    return output;
+}
 export function utf8ByteLength(value) {
     return new TextEncoder().encode(value).byteLength;
 }
+function serializePluginBackendChannelEnvelope(value, label, maxBytes) {
+    const serialized = JSON.stringify(value);
+    requireFrameByteLimit(serialized, maxBytes, label);
+    return serialized;
+}
+function parseChannelEnvelopeRecord(text, label) {
+    requireFrameByteLimit(text, PLUGIN_BACKEND_CHANNEL_OPEN_FRAME_MAX_BYTES, label);
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`${label} must be valid JSON`, { cause: error });
+    }
+    if (!isPlainRecord(value))
+        throw new Error(`${label} must be an object`);
+    return value;
+}
+function parseChannelDataEnvelope(value, text) {
+    requireFrameByteLimit(text, PLUGIN_BACKEND_CHANNEL_DATA_FRAME_MAX_BYTES, "Plugin backend channel data frame");
+    return Object.freeze({
+        version: 1,
+        kind: "data",
+        data: cloneBoundedPluginBackendJson(value["data"], "Plugin backend channel data", PLUGIN_BACKEND_CHANNEL_DATA_JSON_MAX_BYTES),
+    });
+}
+function requireChannelEnvelopeVersion(value) {
+    if (value["version"] !== 1)
+        throw new Error("Plugin backend channel frame version is unsupported");
+}
+function requirePluginBackendChannelErrorCode(value) {
+    if (typeof value !== "string" || value.length > PLUGIN_BACKEND_CHANNEL_ERROR_CODE_MAX_LENGTH || !CHANNEL_ERROR_CODE_PATTERN.test(value)) {
+        throw new Error("Plugin backend channel error code is invalid");
+    }
+    return value;
+}
+function requirePluginBackendChannelErrorMessage(value) {
+    if (typeof value !== "string" || value === "")
+        throw new Error("Plugin backend channel error message must be a non-empty string");
+    if (utf8ByteLength(value) > PLUGIN_BACKEND_CHANNEL_ERROR_MESSAGE_MAX_BYTES) {
+        throw new Error(`Plugin backend channel error message exceeds the ${String(PLUGIN_BACKEND_CHANNEL_ERROR_MESSAGE_MAX_BYTES)} byte limit`);
+    }
+    return value;
+}
+function requireFrameByteLimit(text, maxBytes, label) {
+    if (utf8ByteLength(text) > maxBytes)
+        throw new Error(`${label} exceeds the ${String(maxBytes)} byte limit`);
+}
 function cloneJsonValue(value, ancestors, label, depth) {
     if (depth > MAX_JSON_DEPTH)
         throw new Error(`${label} exceeds the maximum JSON depth of ${String(MAX_JSON_DEPTH)}`);

package/dist/shared/pluginBackendProtocol.js.map

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

package/dist/shared/pluginIds.js

@@ -1,10 +1,17 @@
 export const piWebPluginIdPattern = /^[a-z][a-z0-9.-]*$/u;
 const reservedPiWebPluginIds = new Set(["core", "themes"]);
 const machinePluginIdPrefix = "machine.";
+const bundledPiWebPluginId = "pi-web";
+const bundledPiWebPluginIdPrefix = `${bundledPiWebPluginId}.`;
 export function isPiWebPluginId(value) {
     return piWebPluginIdPattern.test(value);
 }
+export function isPiWebBundledPluginId(value) {
+    return value === bundledPiWebPluginId || value.startsWith(bundledPiWebPluginIdPrefix);
+}
 export function isReservedPiWebPluginId(value) {
-    return reservedPiWebPluginIds.has(value) || value.startsWith(machinePluginIdPrefix);
+    return reservedPiWebPluginIds.has(value)
+        || value.startsWith(machinePluginIdPrefix)
+        || isPiWebBundledPluginId(value);
 }
 //# sourceMappingURL=pluginIds.js.map

package/dist/shared/pluginIds.js.map

@@ -1 +1 @@
-{"version":3,"file":"pluginIds.js","sourceRoot":"","sources":["../../src/shared/pluginIds.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAE1D,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC3D,MAAM,qBAAqB,GAAG,UAAU,CAAC;AAEzC,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,OAAO,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;AACtF,CAAC"}
+{"version":3,"file":"pluginIds.js","sourceRoot":"","sources":["../../src/shared/pluginIds.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAE1D,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC3D,MAAM,qBAAqB,GAAG,UAAU,CAAC;AACzC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AACtC,MAAM,0BAA0B,GAAG,GAAG,oBAAoB,GAAG,CAAC;AAE9D,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,OAAO,KAAK,KAAK,oBAAoB,IAAI,KAAK,CAAC,UAAU,CAAC,0BAA0B,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,OAAO,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC;WACnC,KAAK,CAAC,UAAU,CAAC,qBAAqB,CAAC;WACvC,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC"}

package/dist/shared/requiredTerminalPlugin.js

@@ -0,0 +1,6 @@
+export const REQUIRED_TERMINAL_PLUGIN_ID = "pi-web.terminal";
+export function terminalPluginModeForSafeStart(safeStart) {
+    return safeStart === "none" ? "recovery-disabled" : "required";
+}
+export const REQUIRED_TERMINAL_RECOVERY_GUIDANCE = "Use `pi-web plugins safe-start set none --restart` to start PI WEB without Terminal for recovery.";
+//# sourceMappingURL=requiredTerminalPlugin.js.map

package/dist/shared/requiredTerminalPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requiredTerminalPlugin.js","sourceRoot":"","sources":["../../src/shared/requiredTerminalPlugin.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,iBAAiB,CAAC;AAI7D,MAAM,UAAU,8BAA8B,CAAC,SAA8C;IAC3F,OAAO,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,UAAU,CAAC;AACjE,CAAC;AAED,MAAM,CAAC,MAAM,mCAAmC,GAAG,mGAAmG,CAAC"}

package/dist/shared/serverNoticeContract.js

@@ -0,0 +1,88 @@
+/** Reserved host-derived attribution prefix for plugin-authored notices. */
+export const SERVER_PLUGIN_NOTICE_SOURCE_PREFIX = "plugin:";
+/** Maximum UTF-8 size of one plugin-authored notice message. */
+export const SERVER_PLUGIN_NOTICE_MESSAGE_MAX_BYTES = 4 * 1024;
+/** Maximum serialized UTF-8 size of plugin-authored detached metadata. */
+export const SERVER_PLUGIN_NOTICE_CONTEXT_MAX_BYTES = 16 * 1024;
+/** Maximum nesting below a plugin-authored notice context root. */
+export const SERVER_PLUGIN_NOTICE_CONTEXT_MAX_DEPTH = 32;
+/** Maximum length of each project, workspace, or session scope identifier. */
+export const SERVER_NOTICE_SCOPE_ID_MAX_LENGTH = 512;
+/** Maximum retained notices attributed to one plugin source. */
+export const SERVER_PLUGIN_NOTICE_PER_SOURCE_LIMIT = 25;
+/** Maximum retained plugin-authored notices across all plugin sources. */
+export const SERVER_PLUGIN_NOTICE_GLOBAL_LIMIT = 100;
+const SERVER_NOTICE_SCOPE_KEYS = ["projectId", "workspaceId", "sessionId"];
+/** Validate, detach, and freeze the visibility selectors carried by a notice. */
+export function parseServerNoticeScope(value, label) {
+    if (!isPlainRecord(value))
+        throw new Error(`${label} must be an object`);
+    let hasOwnKey = false;
+    for (const key in value) {
+        if (!Object.hasOwn(value, key))
+            continue;
+        hasOwnKey = true;
+        if (!isServerNoticeScopeKey(key))
+            throw new Error(`Unsupported ${label} field: ${key}`);
+    }
+    if (!hasOwnKey) {
+        throw new Error(`${label} must contain at least one of projectId, workspaceId, or sessionId`);
+    }
+    const scope = {};
+    for (const key of SERVER_NOTICE_SCOPE_KEYS) {
+        if (!Object.hasOwn(value, key))
+            continue;
+        const id = value[key];
+        if (typeof id !== "string" || id.length > SERVER_NOTICE_SCOPE_ID_MAX_LENGTH || id.trim() === "") {
+            throw new Error(`${label} ${key} must be a non-empty string of at most ${String(SERVER_NOTICE_SCOPE_ID_MAX_LENGTH)} characters`);
+        }
+        scope[key] = id;
+    }
+    if (scope.projectId !== undefined)
+        return Object.freeze({ ...scope, projectId: scope.projectId });
+    if (scope.workspaceId !== undefined)
+        return Object.freeze({ ...scope, workspaceId: scope.workspaceId });
+    if (scope.sessionId !== undefined)
+        return Object.freeze({ ...scope, sessionId: scope.sessionId });
+    throw new Error(`${label} must contain at least one visibility selector`);
+}
+export function isPluginServerNoticeSource(source) {
+    return source?.startsWith(SERVER_PLUGIN_NOTICE_SOURCE_PREFIX) === true;
+}
+/** Return as soon as a string cannot fit within a notice UTF-8 byte budget. */
+export function serverNoticeStringExceedsUtf8ByteLimit(value, maxBytes) {
+    let byteLength = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        const codeUnit = value.charCodeAt(index);
+        if (codeUnit <= 0x7f) {
+            byteLength += 1;
+        }
+        else if (codeUnit <= 0x7ff) {
+            byteLength += 2;
+        }
+        else if (codeUnit >= 0xd800 && codeUnit <= 0xdbff
+            && index + 1 < value.length
+            && value.charCodeAt(index + 1) >= 0xdc00
+            && value.charCodeAt(index + 1) <= 0xdfff) {
+            byteLength += 4;
+            index += 1;
+        }
+        else {
+            // TextEncoder replaces isolated surrogates with the three-byte U+FFFD.
+            byteLength += 3;
+        }
+        if (byteLength > maxBytes)
+            return true;
+    }
+    return false;
+}
+function isServerNoticeScopeKey(value) {
+    return SERVER_NOTICE_SCOPE_KEYS.some((key) => key === value);
+}
+function isPlainRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+//# sourceMappingURL=serverNoticeContract.js.map

package/dist/shared/serverNoticeContract.js.map

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

package/dist/shared/sessionDefaults.js

@@ -0,0 +1,41 @@
+import { isKnownThinkingLevel } from "./thinkingLevels.js";
+/** Exactly one selector can be pinned per request; a model is always a pair. */
+export function parseSessionDefaultsUpdate(value) {
+    const { provider, modelId, thinkingLevel } = value;
+    if (thinkingLevel !== undefined) {
+        if (provider !== undefined || modelId !== undefined)
+            throw new Error("Specify either provider/modelId or thinkingLevel");
+        if (typeof thinkingLevel !== "string" || !isKnownThinkingLevel(thinkingLevel))
+            throw new Error("Invalid thinking level");
+        return { thinkingLevel };
+    }
+    if (typeof provider !== "string" || provider.trim() === "" || typeof modelId !== "string" || modelId.trim() === "") {
+        throw new Error("provider and modelId must both be non-empty strings");
+    }
+    return { provider, modelId };
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+export function parseSessionDefaults(value) {
+    if (!isRecord(value))
+        throw new Error("Invalid session defaults");
+    const record = value;
+    const result = {};
+    for (const key of ["defaultProvider", "defaultModel"]) {
+        const field = record[key];
+        if (field === undefined)
+            continue;
+        if (typeof field !== "string")
+            throw new Error(`Invalid ${key}`);
+        result[key] = field;
+    }
+    const level = record["defaultThinkingLevel"];
+    if (level !== undefined) {
+        if (typeof level !== "string" || !isKnownThinkingLevel(level))
+            throw new Error("Invalid defaultThinkingLevel");
+        result.defaultThinkingLevel = level;
+    }
+    return result;
+}
+//# sourceMappingURL=sessionDefaults.js.map

package/dist/shared/sessionDefaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionDefaults.js","sourceRoot":"","sources":["../../src/shared/sessionDefaults.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,gFAAgF;AAChF,MAAM,UAAU,0BAA0B,CAAC,KAA8B;IACvE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IACnD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACzH,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,CAAC,oBAAoB,CAAC,aAAa,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACzH,OAAO,EAAE,aAAa,EAAE,CAAC;IAC3B,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACnH,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,KAAK,CAAC;IACrB,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,KAAK,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,cAAc,CAAU,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;QACjE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAC7C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC/G,MAAM,CAAC,oBAAoB,GAAG,KAAK,CAAC;IACtC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}