@vincenthanxiaodu/pi-web 1.202608.1

package/dist/shared/machinePluginIds.js

@@ -0,0 +1,43 @@
+import { 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}`);
+    if (isReservedPiWebPluginId(pluginId))
+        throw new Error(`Reserved PI WEB plugin id: ${pluginId}`);
+    return `${MACHINE_PLUGIN_ID_PREFIX}${stringToHex(machineId)}.${pluginId}`;
+}
+export function parseMachineScopedPluginId(pluginId) {
+    if (!pluginId.startsWith(MACHINE_PLUGIN_ID_PREFIX))
+        return undefined;
+    const rest = pluginId.slice(MACHINE_PLUGIN_ID_PREFIX.length);
+    const separator = rest.indexOf(".");
+    if (separator < 1)
+        return undefined;
+    const encodedMachineId = rest.slice(0, separator);
+    const sourcePluginId = rest.slice(separator + 1);
+    if (!isHexString(encodedMachineId) || !isPiWebPluginId(sourcePluginId) || isReservedPiWebPluginId(sourcePluginId))
+        return undefined;
+    const machineId = hexToString(encodedMachineId);
+    if (machineId === "")
+        return undefined;
+    return { machineId, pluginId: sourcePluginId };
+}
+function stringToHex(value) {
+    return [...new TextEncoder().encode(value)]
+        .map((byte) => byte.toString(16).padStart(2, "0"))
+        .join("");
+}
+function hexToString(value) {
+    const bytes = new Uint8Array(value.length / 2);
+    for (let index = 0; index < value.length; index += 2) {
+        bytes[index / 2] = Number.parseInt(value.slice(index, index + 2), 16);
+    }
+    return new TextDecoder().decode(bytes);
+}
+function isHexString(value) {
+    return value.length > 0 && value.length % 2 === 0 && /^[0-9a-f]+$/u.test(value);
+}
+//# sourceMappingURL=machinePluginIds.js.map

package/dist/shared/machinePluginIds.js.map

@@ -0,0 +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"}

package/dist/shared/machineStatus.js

@@ -0,0 +1,94 @@
+/**
+ * Internal per-machine status contract shared by sessiond, the web tier, and
+ * the browser.
+ *
+ * sessiond resolves `cwd → workspace → project` and rolls status up, so the
+ * browser never attributes anything itself: it renders whatever node flags the
+ * snapshot carries. The types are deliberately internal — nothing here is
+ * exported from the plugin API.
+ */
+/** The complete set of flags PI WEB itself publishes today. */
+export const CORE_STATUS_FLAGS = {
+    /** A session in the subtree has work in progress (`isSessionActive`). */
+    working: "core:working",
+    /** A live terminal in the subtree. */
+    terminal: "core:terminal",
+    /** An unread session completion in the subtree. */
+    unread: "core:unread",
+};
+/**
+ * Combine child flags into a parent node. A flag is set on the parent when it
+ * is set on any child, and unset flags are omitted so that two trees carrying
+ * the same status compare equal by structure.
+ */
+export function rollUpStatusFlags(sources) {
+    const rolled = new Map();
+    for (const source of sources) {
+        for (const [flagId, isSet] of Object.entries(source)) {
+            if (isSet)
+                rolled.set(flagId, true);
+        }
+    }
+    return Object.fromEntries(rolled);
+}
+/**
+ * Parse a snapshot received over HTTP or the realtime socket.
+ *
+ * Structural fields are required, because a snapshot missing them cannot be
+ * ordered or rendered. Flag content is tolerated instead: an unrecognised flag
+ * id is kept as-is so it still contributes an indicator, and an entry whose
+ * value is not a boolean is dropped rather than failing the whole payload,
+ * since a newer daemon adding flags must never blank a machine's status.
+ */
+export function parseMachineStatusSnapshot(value) {
+    if (!isRecord(value))
+        return undefined;
+    const epochId = value["epochId"];
+    const revision = value["revision"];
+    const generatedAt = value["generatedAt"];
+    const machine = parseStatusFlags(value["machine"]);
+    const unattributed = parseStatusFlags(value["unattributed"]);
+    const projects = parseStatusFlagsByNodeId(value["projects"]);
+    const workspaces = parseStatusFlagsByNodeId(value["workspaces"]);
+    if (typeof epochId !== "string" || epochId === "")
+        return undefined;
+    if (typeof revision !== "number" || !Number.isFinite(revision))
+        return undefined;
+    if (typeof generatedAt !== "string" || generatedAt === "")
+        return undefined;
+    if (machine === undefined || unattributed === undefined)
+        return undefined;
+    if (projects === undefined || workspaces === undefined)
+        return undefined;
+    return { epochId, revision, machine, projects, workspaces, unattributed, generatedAt };
+}
+/**
+ * Flag ids arrive from another machine, so entries are collected through a map
+ * and `Object.fromEntries`: a key such as `__proto__` then becomes an ordinary
+ * own property instead of reassigning the result's prototype.
+ */
+function parseStatusFlags(value) {
+    if (!isRecord(value))
+        return undefined;
+    const flags = new Map();
+    for (const [flagId, isSet] of Object.entries(value)) {
+        if (typeof isSet === "boolean")
+            flags.set(flagId, isSet);
+    }
+    return Object.fromEntries(flags);
+}
+function parseStatusFlagsByNodeId(value) {
+    if (!isRecord(value))
+        return undefined;
+    const nodes = new Map();
+    for (const [nodeId, nodeFlags] of Object.entries(value)) {
+        const parsed = parseStatusFlags(nodeFlags);
+        if (parsed !== undefined)
+            nodes.set(nodeId, parsed);
+    }
+    return Object.fromEntries(nodes);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=machineStatus.js.map

package/dist/shared/machineStatus.js.map

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

package/dist/shared/piWebStatusParsing.js

@@ -0,0 +1,141 @@
+import { parseActiveAgentProfileDescriptor } from "./activeAgentProfile.js";
+import { parseKnownPiWebCapabilities } from "./capabilities.js";
+export function parsePiWebVersionResponse(value) {
+    if (!isRecord(value))
+        return undefined;
+    const packageName = value["packageName"];
+    const generatedAt = value["generatedAt"];
+    const components = value["components"];
+    if (typeof packageName !== "string" || packageName === "" || typeof generatedAt !== "string" || generatedAt === "" || !isRecord(components))
+        return undefined;
+    const web = parsePiWebComponentStatus(components["web"]);
+    const sessiond = parsePiWebComponentStatus(components["sessiond"]);
+    if (web === undefined || sessiond === undefined)
+        return undefined;
+    return { packageName, generatedAt, components: { web, sessiond } };
+}
+export function parsePiWebRuntimeResponse(value) {
+    if (!isRecord(value))
+        return undefined;
+    const packageName = value["packageName"];
+    const generatedAt = value["generatedAt"];
+    const components = value["components"];
+    const capabilities = parseKnownPiWebCapabilities(value["capabilities"]);
+    if (typeof packageName !== "string" || packageName === "" || typeof generatedAt !== "string" || generatedAt === "" || !isRecord(components) || capabilities === undefined)
+        return undefined;
+    const web = parsePiWebRuntimeComponent(components["web"]);
+    const sessiond = parsePiWebRuntimeComponent(components["sessiond"]);
+    if (web === undefined || sessiond === undefined)
+        return undefined;
+    return { packageName, generatedAt, components: { web, sessiond }, capabilities };
+}
+export function parsePiWebRuntimeComponent(value) {
+    if (!isRecord(value))
+        return undefined;
+    const component = value["component"];
+    const label = value["label"];
+    const runtimeVersion = value["runtimeVersion"];
+    const piVersion = value["piVersion"];
+    const available = value["available"];
+    const capabilities = parseKnownPiWebCapabilities(value["capabilities"]);
+    const activeAgentProfileValue = value["activeAgentProfile"];
+    const activeAgentProfile = activeAgentProfileValue === undefined ? undefined : parseActiveAgentProfileDescriptor(activeAgentProfileValue);
+    const deprecatedAgentInputs = parseDeprecatedAgentInputs(value["deprecatedAgentInputs"]);
+    const error = value["error"];
+    if (component !== "web" && component !== "sessiond")
+        return undefined;
+    if (typeof label !== "string" || label === "" || typeof available !== "boolean" || capabilities === undefined)
+        return undefined;
+    if (activeAgentProfileValue !== undefined && (component !== "sessiond" || activeAgentProfile === undefined))
+        return undefined;
+    return {
+        component,
+        label,
+        ...(typeof runtimeVersion === "string" ? { runtimeVersion } : {}),
+        ...(typeof piVersion === "string" ? { piVersion } : {}),
+        available,
+        capabilities,
+        ...(activeAgentProfile === undefined ? {} : { activeAgentProfile }),
+        ...(deprecatedAgentInputs === undefined ? {} : { deprecatedAgentInputs }),
+        ...(typeof error === "string" ? { error } : {}),
+    };
+}
+/**
+ * Parse deprecated agent-configuration inputs reported by another component or
+ * machine. The payload only feeds an advisory warning banner, so malformed
+ * entries are dropped rather than failing the whole runtime snapshot: a
+ * cross-version peer must never blank a machine's runtime over a warning.
+ * Returns undefined when the field itself is absent or not an array.
+ */
+export function parseDeprecatedAgentInputs(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const inputs = [];
+    for (const entry of value) {
+        if (!isRecord(entry))
+            continue;
+        const source = entry["source"];
+        const name = entry["name"];
+        const replacement = entry["replacement"];
+        if (source !== "environment" && source !== "config")
+            continue;
+        if (typeof name !== "string" || name === "")
+            continue;
+        if (replacement !== undefined && (typeof replacement !== "string" || replacement === ""))
+            continue;
+        inputs.push({ source, name, ...(replacement === undefined ? {} : { replacement }) });
+    }
+    return inputs;
+}
+export function parsePiWebComponentStatus(value) {
+    if (!isRecord(value))
+        return undefined;
+    const component = value["component"];
+    const label = value["label"];
+    const runtimeVersion = value["runtimeVersion"];
+    const installedVersion = value["installedVersion"];
+    const piVersion = value["piVersion"];
+    const stale = value["stale"];
+    const available = value["available"];
+    const error = value["error"];
+    const installation = parsePiWebInstallationInfo(value["installation"]);
+    if (component !== "web" && component !== "sessiond")
+        return undefined;
+    if (typeof label !== "string" || label === "" || typeof stale !== "boolean" || typeof available !== "boolean")
+        return undefined;
+    return {
+        component,
+        label,
+        ...(typeof runtimeVersion === "string" ? { runtimeVersion } : {}),
+        ...(typeof installedVersion === "string" ? { installedVersion } : {}),
+        ...(typeof piVersion === "string" ? { piVersion } : {}),
+        stale,
+        available,
+        ...(installation === undefined ? {} : { installation }),
+        ...(typeof error === "string" ? { error } : {}),
+    };
+}
+export function parsePiWebInstallationInfo(value) {
+    if (!isRecord(value))
+        return undefined;
+    const kind = value["kind"];
+    const path = value["path"];
+    const source = value["source"];
+    const scope = value["scope"];
+    const npmRoot = value["npmRoot"];
+    const dockerMode = value["dockerMode"];
+    if (kind !== "pi-package" && kind !== "npm-global" && kind !== "local" && kind !== "docker" && kind !== "unknown")
+        return undefined;
+    return {
+        kind,
+        ...(typeof path === "string" ? { path } : {}),
+        ...(typeof source === "string" ? { source } : {}),
+        ...(scope === "user" || scope === "project" ? { scope } : {}),
+        ...(typeof npmRoot === "string" ? { npmRoot } : {}),
+        ...(dockerMode === "runtime" || dockerMode === "dev" ? { dockerMode } : {}),
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=piWebStatusParsing.js.map

package/dist/shared/piWebStatusParsing.js.map

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

package/dist/shared/pluginApiTypes.d.ts

@@ -0,0 +1,150 @@
+export type MachineKind = "local" | "remote";
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | readonly JsonValue[];
+export interface JsonObject {
+    readonly [key: string]: JsonValue;
+}
+export interface WorkspaceProviderCapabilities {
+    readonly request: boolean;
+    /** True only when this specific workspace advertises removal. */
+    readonly remove: boolean;
+}
+/** Public identity and browser-visible data for the plugin that owns a workspace. */
+export interface WorkspaceProviderMetadata {
+    readonly pluginId: string;
+    readonly capabilities: WorkspaceProviderCapabilities;
+    readonly metadata?: JsonObject;
+}
+/** Provider-authored removal wording exposed to browser plugins. */
+export interface WorkspaceRemovalPresentation {
+    readonly actionLabel: string;
+    readonly confirmation: string;
+}
+export interface FileTreeEntry {
+    name: string;
+    path: string;
+    type: "file" | "directory" | "symlink";
+    size?: number;
+    modifiedAt?: string;
+}
+export interface FileTreeResponse {
+    path: string;
+    entries: FileTreeEntry[];
+    scannedAt: string;
+    truncated: boolean;
+}
+export type FileContentMediaType = "image" | "html" | "pdf" | "markdown";
+export interface FileContentResponse {
+    path: string;
+    language?: string;
+    mediaType?: FileContentMediaType;
+    mimeType?: string;
+    encoding: "utf8";
+    size: number;
+    modifiedAt: string;
+    content: string;
+    truncated: boolean;
+    binary: boolean;
+}
+export interface WriteWorkspaceFileOptions {
+    createDirs?: boolean;
+    overwrite?: boolean;
+}
+export interface WriteWorkspaceFileResponse {
+    path: string;
+    size: number;
+    modifiedAt: string;
+    created: boolean;
+}
+export interface DeleteWorkspaceFileResponse {
+    path: string;
+    existed: boolean;
+}
+export interface MoveWorkspaceFileOptions {
+    createDirs?: boolean;
+    overwrite?: boolean;
+}
+export interface MoveWorkspaceFileResponse {
+    fromPath: string;
+    toPath: string;
+    size: number;
+    modifiedAt: string;
+}
+export type TerminalCommandRunStatus = "queued" | "running" | "succeeded" | "failed";
+export interface TerminalCommandRun {
+    id: string;
+    origin: string;
+    projectId: string;
+    workspaceId: string;
+    terminalId: string;
+    title: string;
+    command: string;
+    status: TerminalCommandRunStatus;
+    exitCode?: number;
+    createdAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    metadata: Record<string, string>;
+}
+export interface TerminalCommandRunHandle {
+    run: TerminalCommandRun;
+    completed: Promise<TerminalCommandRun>;
+}
+export type PiWebServiceComponent = "web" | "sessiond";
+export type PiWebStatusSeverity = "info" | "warning" | "error";
+export type PiWebInstallationKind = "pi-package" | "npm-global" | "local" | "docker" | "unknown";
+export type PiWebDockerMode = "runtime" | "dev";
+export interface PiWebInstallationInfo {
+    kind: PiWebInstallationKind;
+    path?: string;
+    source?: string;
+    scope?: "user" | "project";
+    npmRoot?: string;
+    dockerMode?: PiWebDockerMode;
+}
+export interface PiWebComponentStatus {
+    component: PiWebServiceComponent;
+    label: string;
+    runtimeVersion?: string;
+    installedVersion?: string;
+    /** Version of the Pi coding agent library loaded by this component's process; omitted when the component does not report it. */
+    piVersion?: string;
+    stale: boolean;
+    available: boolean;
+    installation?: PiWebInstallationInfo;
+    error?: string;
+}
+export interface PiWebReleaseStatus {
+    packageName: string;
+    latestVersion?: string;
+    updateAvailable: boolean;
+    checkedAt?: string;
+    skipped?: boolean;
+    error?: string;
+}
+export interface PiWebStatusMessage {
+    id: string;
+    severity: PiWebStatusSeverity;
+    title: string;
+    body: string;
+    command?: string;
+}
+export interface PiWebVersionResponse {
+    packageName: string;
+    generatedAt: string;
+    components: {
+        web: PiWebComponentStatus;
+        sessiond: PiWebComponentStatus;
+    };
+}
+export interface PiWebStatusResponse extends PiWebVersionResponse {
+    release: PiWebReleaseStatus;
+    commands: {
+        update?: string;
+        restart?: string;
+        restartWeb?: string;
+        restartSessiond?: string;
+        status?: string;
+    };
+    messages: PiWebStatusMessage[];
+}

package/dist/shared/pluginApiTypes.js

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

package/dist/shared/pluginApiTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginApiTypes.js","sourceRoot":"","sources":["../../src/shared/pluginApiTypes.ts"],"names":[],"mappings":"AAAA,wFAAwF"}

package/dist/shared/pluginBackendProtocol.js

@@ -0,0 +1,110 @@
+/** Maximum UTF-8 JSON input accepted from a browser plugin. */
+export const PLUGIN_BACKEND_JSON_MAX_BYTES = 256 * 1024;
+/** Bounded result allowance demonstrated by Git's existing 2 MiB command-output limit. */
+export const PLUGIN_BACKEND_RESPONSE_JSON_MAX_BYTES = 8 * 1024 * 1024;
+/** Envelope allowance for the active backend revision and JSON field names. */
+export const PLUGIN_BACKEND_REQUEST_BODY_MAX_BYTES = PLUGIN_BACKEND_JSON_MAX_BYTES + 4 * 1024;
+/** Allowance for an attributed error envelope around a bounded result. */
+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. */
+export const PLUGIN_BACKEND_DISPATCH_TIMEOUT_MS = 25_000;
+/** Remote gateway deadline, including workspace owner 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;
+const OPERATION_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);
+}
+export function requirePluginBackendOperation(value) {
+    if (!isPluginBackendOperation(value)) {
+        throw new Error(`Plugin backend operation must match ${String(OPERATION_PATTERN)} and be at most ${String(PLUGIN_BACKEND_OPERATION_MAX_LENGTH)} characters`);
+    }
+    return value;
+}
+export function requirePluginBackendRevision(value) {
+    if (typeof value !== "string" || value === "" || value.length > PLUGIN_BACKEND_REVISION_MAX_LENGTH) {
+        throw new Error(`Plugin backend revision must be a non-empty string of at most ${String(PLUGIN_BACKEND_REVISION_MAX_LENGTH)} characters`);
+    }
+    return value;
+}
+/** Clone and freeze a runtime value after enforcing the JSON and byte contract. */
+export function cloneBoundedPluginBackendJson(value, label, maxBytes = PLUGIN_BACKEND_JSON_MAX_BYTES) {
+    const cloned = cloneJsonValue(value, new Set(), label, 0);
+    const serialized = JSON.stringify(cloned);
+    if (utf8ByteLength(serialized) > maxBytes) {
+        throw new Error(`${label} exceeds the ${String(maxBytes)} byte limit`);
+    }
+    return cloned;
+}
+export function serializeBoundedPluginBackendJson(value, label, maxBytes = PLUGIN_BACKEND_JSON_MAX_BYTES) {
+    return JSON.stringify(cloneBoundedPluginBackendJson(value, label, maxBytes));
+}
+export function parseBoundedPluginBackendJson(text, label, maxBytes = PLUGIN_BACKEND_JSON_MAX_BYTES) {
+    if (utf8ByteLength(text) > maxBytes) {
+        throw new Error(`${label} exceeds the ${String(maxBytes)} byte limit`);
+    }
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`${label} must be valid JSON`, { cause: error });
+    }
+    return cloneBoundedPluginBackendJson(value, label, maxBytes);
+}
+export function parsePluginBackendRequestEnvelope(value) {
+    if (!isPlainRecord(value))
+        throw new Error("Plugin backend request body must be an object");
+    return Object.freeze({
+        revision: requirePluginBackendRevision(value["revision"]),
+        input: cloneBoundedPluginBackendJson(value["input"], "Plugin backend request input"),
+    });
+}
+export function utf8ByteLength(value) {
+    return new TextEncoder().encode(value).byteLength;
+}
+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)}`);
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return value;
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw new Error(`${label} must contain only finite JSON numbers`);
+        return value;
+    }
+    if (Array.isArray(value)) {
+        if (ancestors.has(value))
+            throw new Error(`${label} must not contain cycles`);
+        ancestors.add(value);
+        const output = value.map((child) => cloneJsonValue(child, ancestors, label, depth + 1));
+        ancestors.delete(value);
+        Object.freeze(output);
+        return output;
+    }
+    if (!isPlainRecord(value))
+        throw new Error(`${label} must contain only JSON values`);
+    if (ancestors.has(value))
+        throw new Error(`${label} must not contain cycles`);
+    ancestors.add(value);
+    const output = {};
+    for (const [key, child] of Object.entries(value)) {
+        defineJsonProperty(output, key, cloneJsonValue(child, ancestors, label, depth + 1));
+    }
+    ancestors.delete(value);
+    return Object.freeze(output);
+}
+function defineJsonProperty(record, key, value) {
+    Object.defineProperty(record, key, { value, enumerable: true, configurable: true, writable: true });
+}
+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=pluginBackendProtocol.js.map

package/dist/shared/pluginBackendProtocol.js.map

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

package/dist/shared/pluginIds.js

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

package/dist/shared/pluginIds.js.map

@@ -0,0 +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"}

package/dist/shared/pluginRecoveryCommands.js

@@ -0,0 +1,14 @@
+import { isPiWebPluginId } from "./pluginIds.js";
+/** Secret-free commands accepted by the offline recovery CLI. */
+export const PI_WEB_PLUGIN_RECOVERY_COMMANDS = Object.freeze({
+    showSafeStart: "pi-web plugins safe-start show",
+    bundledOnly: "pi-web plugins safe-start set bundled-only --restart",
+    noServerPlugins: "pi-web plugins safe-start set none --restart",
+    clearSafeStart: "pi-web plugins safe-start clear --restart",
+});
+export function pluginDisableRecoveryCommand(pluginId) {
+    if (!isPiWebPluginId(pluginId))
+        throw new Error(`Invalid PI WEB plugin id: ${pluginId}`);
+    return `pi-web plugins disable ${pluginId} --restart`;
+}
+//# sourceMappingURL=pluginRecoveryCommands.js.map

package/dist/shared/pluginRecoveryCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginRecoveryCommands.js","sourceRoot":"","sources":["../../src/shared/pluginRecoveryCommands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,iEAAiE;AACjE,MAAM,CAAC,MAAM,+BAA+B,GAA0C,MAAM,CAAC,MAAM,CAAC;IAClG,aAAa,EAAE,gCAAgC;IAC/C,WAAW,EAAE,sDAAsD;IACnE,eAAe,EAAE,8CAA8C;IAC/D,cAAc,EAAE,2CAA2C;CAC5D,CAAC,CAAC;AAEH,MAAM,UAAU,4BAA4B,CAAC,QAAgB;IAC3D,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,EAAE,CAAC,CAAC;IACzF,OAAO,0BAA0B,QAAQ,YAAY,CAAC;AACxD,CAAC"}