pressship 0.1.12 → 0.1.13

package/dist/web/jobs.js

@@ -0,0 +1,155 @@
+import { EventEmitter } from "node:events";
+export class WebJobManager {
+    jobs = new Map();
+    create(type, title, run) {
+        const job = new InternalWebJob(type, title);
+        this.jobs.set(job.snapshot.id, job);
+        void job.start(run);
+        return job.snapshot;
+    }
+    get(id) {
+        return this.jobs.get(id)?.snapshot;
+    }
+    list() {
+        return Array.from(this.jobs.values()).map((job) => job.snapshot);
+    }
+    cancel(id) {
+        return this.jobs.get(id)?.cancel() ?? false;
+    }
+    subscribe(id, onEvent, onClose) {
+        const job = this.jobs.get(id);
+        if (!job) {
+            onClose();
+            return () => undefined;
+        }
+        for (const event of job.snapshot.events) {
+            onEvent(event);
+        }
+        if (!["queued", "running"].includes(job.snapshot.status)) {
+            onClose();
+            return () => undefined;
+        }
+        return job.subscribe(onEvent, onClose);
+    }
+    cancelRunningJobs() {
+        for (const job of this.jobs.values()) {
+            if (job.snapshot.status === "queued" || job.snapshot.status === "running") {
+                job.cancel();
+            }
+        }
+    }
+}
+class InternalWebJob {
+    emitter = new EventEmitter();
+    controller = new AbortController();
+    cancelCallbacks = [];
+    eventId = 0;
+    snapshot;
+    constructor(type, title) {
+        const now = new Date().toISOString();
+        this.snapshot = {
+            id: createJobId(),
+            type,
+            status: "queued",
+            title,
+            createdAt: now,
+            updatedAt: now,
+            events: []
+        };
+    }
+    async start(run) {
+        this.setStatus("running");
+        this.emit("status", { message: "Job started." });
+        try {
+            const returned = await run({
+                signal: this.controller.signal,
+                log: (message, data) => this.emit("log", { message, data: redactSecrets(data) }),
+                status: (message) => this.emit("status", { message }),
+                result: (data) => this.emit("result", redactSecrets(data)),
+                registerCancel: (cancel) => {
+                    this.cancelCallbacks.push(cancel);
+                }
+            });
+            if (returned !== undefined) {
+                this.emit("result", redactSecrets(returned));
+            }
+            if (this.snapshot.status === "cancelled") {
+                this.emit("done", { status: "cancelled" });
+                return;
+            }
+            this.setStatus("succeeded");
+            this.emit("done", { status: "succeeded" });
+        }
+        catch (error) {
+            if (this.snapshot.status === "cancelled" || this.controller.signal.aborted) {
+                this.setStatus("cancelled");
+                this.emit("done", { status: "cancelled" });
+                return;
+            }
+            this.setStatus("failed");
+            this.emit("error", { message: error instanceof Error ? error.message : String(error) });
+            this.emit("done", { status: "failed" });
+        }
+    }
+    cancel() {
+        if (!["queued", "running"].includes(this.snapshot.status)) {
+            return false;
+        }
+        this.controller.abort();
+        for (const cancel of this.cancelCallbacks) {
+            cancel();
+        }
+        this.cancelCallbacks = [];
+        this.setStatus("cancelled");
+        this.emit("status", { message: "Job cancelled." });
+        this.emit("done", { status: "cancelled" });
+        return true;
+    }
+    subscribe(onEvent, onClose) {
+        this.emitter.on("event", onEvent);
+        this.emitter.once("close", onClose);
+        return () => {
+            this.emitter.off("event", onEvent);
+            this.emitter.off("close", onClose);
+        };
+    }
+    setStatus(status) {
+        this.snapshot.status = status;
+        this.snapshot.updatedAt = new Date().toISOString();
+    }
+    emit(type, data) {
+        const event = {
+            id: ++this.eventId,
+            type,
+            time: new Date().toISOString(),
+            data
+        };
+        this.snapshot.events.push(event);
+        this.snapshot.updatedAt = event.time;
+        this.emitter.emit("event", event);
+        if (type === "done") {
+            this.emitter.emit("close");
+        }
+    }
+}
+function createJobId() {
+    return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+function redactSecrets(value) {
+    if (typeof value === "string") {
+        return value
+            .replace(/(--password\s+)(\S+)/g, "$1<redacted>")
+            .replace(/("password"\s*:\s*")([^"]+)(")/g, "$1<redacted>$3");
+    }
+    if (Array.isArray(value)) {
+        return value.map(redactSecrets);
+    }
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, nested]) => [
+            key,
+            /password|token|storage/i.test(key) ? "<redacted>" : redactSecrets(nested)
+        ]));
+    }
+    return value;
+}
+//# sourceMappingURL=jobs.js.map

package/dist/web/jobs.js.map

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

package/dist/web/open-url.d.ts

@@ -0,0 +1 @@
+export declare function openUrl(url: string): Promise<void>;

package/dist/web/open-url.js

@@ -0,0 +1,13 @@
+import { execa } from "execa";
+export async function openUrl(url) {
+    if (process.platform === "darwin") {
+        await execa("open", [url]);
+        return;
+    }
+    if (process.platform === "win32") {
+        await execa("cmd", ["/c", "start", "", url]);
+        return;
+    }
+    await execa("xdg-open", [url]);
+}
+//# sourceMappingURL=open-url.js.map

package/dist/web/open-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-url.js","sourceRoot":"","sources":["../../src/web/open-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW;IACvC,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC"}

package/dist/web/plugin-check-state.d.ts

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { type StudioPluginCheckFinding, type StudioPluginCheckSummary } from "./plugin-check.js";
+declare const studioPluginCheckStateSchema: z.ZodObject<{
+    pluginId: z.ZodString;
+    pluginPath: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+    checkedAt: z.ZodString;
+    skipped: z.ZodBoolean;
+    available: z.ZodBoolean;
+    findings: z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+            info: "info";
+        }>;
+        message: z.ZodString;
+        code: z.ZodOptional<z.ZodString>;
+        file: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+        originalFile: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    summary: z.ZodObject<{
+        error: z.ZodNumber;
+        warning: z.ZodNumber;
+        info: z.ZodNumber;
+        total: z.ZodNumber;
+        blocking: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type StudioPluginCheckState = z.infer<typeof studioPluginCheckStateSchema>;
+export declare function readStudioPluginCheckState(pluginId: string): Promise<StudioPluginCheckState | undefined>;
+export declare function writeStudioPluginCheckState(input: {
+    pluginId: string;
+    pluginPath: string;
+    slug: string;
+    name: string;
+    skipped: boolean;
+    available: boolean;
+    findings: StudioPluginCheckFinding[];
+    summary: StudioPluginCheckSummary;
+    checkedAt?: string;
+}): Promise<StudioPluginCheckState>;
+export declare function removeStudioPluginCheckFindingsForFiles(pluginId: string, files: string[]): Promise<StudioPluginCheckState | undefined>;
+export declare function removeStudioPluginCheckState(pluginId: string): Promise<void>;
+export {};

package/dist/web/plugin-check-state.js

@@ -0,0 +1,107 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { z } from "zod";
+import { ensureConfigDir, getWebPluginCheckStatePath, pathExists } from "../utils/paths.js";
+import { summarizeStudioPluginCheckFindings } from "./plugin-check.js";
+const severitySchema = z.enum(["error", "warning", "info"]);
+const studioPluginCheckFindingSchema = z.object({
+    severity: severitySchema,
+    message: z.string(),
+    code: z.string().optional(),
+    file: z.string().optional(),
+    line: z.number().optional(),
+    column: z.number().optional(),
+    originalFile: z.string().optional()
+});
+const studioPluginCheckSummarySchema = z.object({
+    error: z.number().int().min(0),
+    warning: z.number().int().min(0),
+    info: z.number().int().min(0),
+    total: z.number().int().min(0),
+    blocking: z.boolean()
+});
+const studioPluginCheckStateSchema = z.object({
+    pluginId: z.string().min(1),
+    pluginPath: z.string().min(1),
+    slug: z.string().min(1),
+    name: z.string().min(1),
+    checkedAt: z.string().min(1),
+    skipped: z.boolean(),
+    available: z.boolean(),
+    findings: z.array(studioPluginCheckFindingSchema),
+    summary: studioPluginCheckSummarySchema
+});
+const studioPluginCheckStateStoreSchema = z.object({
+    version: z.literal(1),
+    states: z.record(z.string(), studioPluginCheckStateSchema)
+});
+export async function readStudioPluginCheckState(pluginId) {
+    return (await readStudioPluginCheckStateStore()).states[pluginId];
+}
+export async function writeStudioPluginCheckState(input) {
+    const store = await readStudioPluginCheckStateStore();
+    const state = studioPluginCheckStateSchema.parse({
+        ...input,
+        checkedAt: input.checkedAt ?? new Date().toISOString()
+    });
+    store.states[input.pluginId] = state;
+    await writeStudioPluginCheckStateStore(store);
+    return state;
+}
+export async function removeStudioPluginCheckFindingsForFiles(pluginId, files) {
+    const targetFiles = new Set(files.map(normalizeStateFilePath).filter((filePath) => Boolean(filePath)));
+    if (!targetFiles.size) {
+        return readStudioPluginCheckState(pluginId);
+    }
+    const store = await readStudioPluginCheckStateStore();
+    const current = store.states[pluginId];
+    if (!current) {
+        return undefined;
+    }
+    const findings = current.findings.filter((finding) => {
+        const filePath = normalizeStateFilePath(finding.file);
+        return !filePath || !targetFiles.has(filePath);
+    });
+    if (findings.length === current.findings.length) {
+        return current;
+    }
+    const next = studioPluginCheckStateSchema.parse({
+        ...current,
+        checkedAt: new Date().toISOString(),
+        findings,
+        summary: summarizeStudioPluginCheckFindings(findings)
+    });
+    store.states[pluginId] = next;
+    await writeStudioPluginCheckStateStore(store);
+    return next;
+}
+export async function removeStudioPluginCheckState(pluginId) {
+    const store = await readStudioPluginCheckStateStore();
+    if (!(pluginId in store.states)) {
+        return;
+    }
+    delete store.states[pluginId];
+    await writeStudioPluginCheckStateStore(store);
+}
+async function readStudioPluginCheckStateStore() {
+    const statePath = getWebPluginCheckStatePath();
+    if (!pathExists(statePath)) {
+        return emptyStore();
+    }
+    try {
+        return studioPluginCheckStateStoreSchema.parse(JSON.parse(await readFile(statePath, "utf8")));
+    }
+    catch {
+        return emptyStore();
+    }
+}
+async function writeStudioPluginCheckStateStore(store) {
+    await ensureConfigDir();
+    await writeFile(getWebPluginCheckStatePath(), `${JSON.stringify(store, null, 2)}\n`, { mode: 0o600 });
+}
+function emptyStore() {
+    return { version: 1, states: {} };
+}
+function normalizeStateFilePath(filePath) {
+    return filePath?.replace(/\\/g, "/").replace(/^\/+/, "");
+}
+//# sourceMappingURL=plugin-check-state.js.map

package/dist/web/plugin-check-state.js.map

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

package/dist/web/plugin-check.d.ts

@@ -0,0 +1,11 @@
+import type { Finding, Severity } from "../types.js";
+export type StudioPluginCheckFinding = Finding & {
+    originalFile?: string;
+};
+export type StudioPluginCheckSummary = Record<Severity, number> & {
+    total: number;
+    blocking: boolean;
+};
+export declare function normalizeStudioPluginCheckFindings(findings: Finding[], pluginRoot: string, slug?: string): StudioPluginCheckFinding[];
+export declare function addStudioPluginCheckLineHints(findings: StudioPluginCheckFinding[], pluginRoot: string): Promise<StudioPluginCheckFinding[]>;
+export declare function summarizeStudioPluginCheckFindings(findings: Finding[]): StudioPluginCheckSummary;

package/dist/web/plugin-check.js

@@ -0,0 +1,124 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+export function normalizeStudioPluginCheckFindings(findings, pluginRoot, slug) {
+    return findings.map((finding) => {
+        const file = normalizeStudioPluginCheckPath(finding.file, pluginRoot, slug);
+        return file === finding.file
+            ? { ...finding }
+            : {
+                ...finding,
+                file,
+                originalFile: finding.file
+            };
+    });
+}
+export async function addStudioPluginCheckLineHints(findings, pluginRoot) {
+    return Promise.all(findings.map(async (finding) => {
+        if (isPositiveInteger(finding.line) || !finding.file) {
+            return normalizeStudioFindingColumn(finding);
+        }
+        const line = await inferStudioFindingLine(finding, pluginRoot);
+        return normalizeStudioFindingColumn({
+            ...finding,
+            line: line ?? 1
+        });
+    }));
+}
+export function summarizeStudioPluginCheckFindings(findings) {
+    const summary = {
+        error: 0,
+        warning: 0,
+        info: 0,
+        total: findings.length,
+        blocking: false
+    };
+    for (const finding of findings) {
+        summary[finding.severity] += 1;
+    }
+    summary.blocking = summary.error > 0;
+    return summary;
+}
+function normalizeStudioPluginCheckPath(file, pluginRoot, slug) {
+    if (!file) {
+        return undefined;
+    }
+    const root = path.resolve(pluginRoot);
+    const normalizedFile = file.replace(/\\/g, "/");
+    const absolutePath = path.isAbsolute(file) ? path.resolve(file) : undefined;
+    if (absolutePath && (absolutePath === root || absolutePath.startsWith(`${root}${path.sep}`))) {
+        return path.relative(root, absolutePath).split(path.sep).join("/");
+    }
+    const relative = normalizedFile.replace(/^\/+/, "");
+    const leadingFolder = slug ?? path.basename(root);
+    if (relative === leadingFolder) {
+        return "";
+    }
+    if (relative.startsWith(`${leadingFolder}/`)) {
+        return relative.slice(leadingFolder.length + 1);
+    }
+    return relative;
+}
+async function inferStudioFindingLine(finding, pluginRoot) {
+    if (!finding.file) {
+        return undefined;
+    }
+    if (path.basename(finding.file).toLowerCase() !== "readme.txt") {
+        return 1;
+    }
+    const readmePath = resolveStudioFindingFilePath(pluginRoot, finding.file);
+    if (!readmePath) {
+        return 1;
+    }
+    try {
+        return inferReadmeFindingLine(finding, await readFile(readmePath, "utf8")) ?? 1;
+    }
+    catch {
+        return 1;
+    }
+}
+function inferReadmeFindingLine(finding, contents) {
+    const haystack = `${finding.code ?? ""} ${finding.message}`.toLowerCase();
+    const fieldPatterns = [
+        [/tested[_\s-]*(up[\s-]*to|upto)|tested up to/, /^\s*tested up to\s*:/i],
+        [/stable[_\s-]*tag|stable tag/, /^\s*stable tag\s*:/i],
+        [/requires[_\s-]*at[_\s-]*least|requires at least/, /^\s*requires at least\s*:/i],
+        [/requires[_\s-]*php|requires php/, /^\s*requires php\s*:/i],
+        [/license/, /^\s*license\s*:/i],
+        [/contributors?/, /^\s*contributors\s*:/i],
+        [/tags?/, /^\s*tags\s*:/i],
+        [/donate/, /^\s*donate link\s*:/i]
+    ];
+    for (const [hint, linePattern] of fieldPatterns) {
+        if (hint.test(haystack)) {
+            const line = findReadmeLine(contents, linePattern);
+            if (line) {
+                return line;
+            }
+        }
+    }
+    return findReadmeLine(contents, /^===\s+.+?\s+===$/) ?? 1;
+}
+function findReadmeLine(contents, pattern) {
+    const lines = contents.split(/\r?\n/);
+    const index = lines.findIndex((line) => pattern.test(line));
+    return index >= 0 ? index + 1 : undefined;
+}
+function resolveStudioFindingFilePath(pluginRoot, file) {
+    const root = path.resolve(pluginRoot);
+    const normalized = file.replace(/\\/g, "/").replace(/^\/+/, "");
+    const filePath = path.resolve(root, normalized);
+    return filePath === root || filePath.startsWith(`${root}${path.sep}`) ? filePath : undefined;
+}
+function normalizeStudioFindingColumn(finding) {
+    if (!isPositiveInteger(finding.line)) {
+        return finding;
+    }
+    return {
+        ...finding,
+        column: isPositiveInteger(finding.column) ? finding.column : 1
+    };
+}
+function isPositiveInteger(value) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0;
+}
+//# sourceMappingURL=plugin-check.js.map

package/dist/web/plugin-check.js.map

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

package/dist/web/ports.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveFreePort(host: string, startPort: number, strict: boolean, endPort?: number): Promise<number>;
+export declare function isPortAvailable(host: string, port: number): Promise<boolean>;

package/dist/web/ports.js

@@ -0,0 +1,38 @@
+import { createServer } from "node:net";
+export async function resolveFreePort(host, startPort, strict, endPort = startPort + 25) {
+    if (startPort === 0) {
+        return probePort(host, 0);
+    }
+    for (let port = startPort; port <= endPort; port += 1) {
+        if (await isPortAvailable(host, port)) {
+            return port;
+        }
+        if (strict) {
+            break;
+        }
+    }
+    throw new Error(strict
+        ? `Port ${startPort} is already in use on ${host}.`
+        : `No available port found between ${startPort} and ${endPort} on ${host}.`);
+}
+export async function isPortAvailable(host, port) {
+    try {
+        await probePort(host, port);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function probePort(host, port) {
+    const server = createServer();
+    return new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(port, host, () => {
+            const address = server.address();
+            const resolvedPort = typeof address === "object" && address ? address.port : port;
+            server.close((error) => (error ? reject(error) : resolve(resolvedPort)));
+        });
+    });
+}
+//# sourceMappingURL=ports.js.map

package/dist/web/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/web/ports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,SAAiB,EACjB,MAAe,EACf,OAAO,GAAG,SAAS,GAAG,EAAE;IAExB,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,IAAI,IAAI,GAAG,SAAS,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QACtD,IAAI,MAAM,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM;QACR,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,MAAM;QACJ,CAAC,CAAC,QAAQ,SAAS,yBAAyB,IAAI,GAAG;QACnD,CAAC,CAAC,mCAAmC,SAAS,QAAQ,OAAO,OAAO,IAAI,GAAG,CAC9E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,IAAY;IAC9D,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,IAAY;IACjD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC7C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;YAC7B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,YAAY,GAAG,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YAClF,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/web/registry.d.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { type LocalPluginInfo } from "../plugin/info.js";
+declare const localPluginSourceSchema: z.ZodEnum<{
+    manual: "manual";
+    clone: "clone";
+}>;
+declare const localPluginEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    path: z.ZodString;
+    source: z.ZodEnum<{
+        manual: "manual";
+        clone: "clone";
+    }>;
+    slug: z.ZodString;
+    name: z.ZodString;
+    addedAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+declare const localPluginRegistrySchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    plugins: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        path: z.ZodString;
+        source: z.ZodEnum<{
+            manual: "manual";
+            clone: "clone";
+        }>;
+        slug: z.ZodString;
+        name: z.ZodString;
+        addedAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LocalPluginSource = z.infer<typeof localPluginSourceSchema>;
+export type LocalPluginEntry = z.infer<typeof localPluginEntrySchema>;
+export type LocalPluginRegistry = z.infer<typeof localPluginRegistrySchema>;
+export type EnrichedLocalPlugin = LocalPluginEntry & {
+    exists: boolean;
+    info?: LocalPluginInfo;
+    error?: string;
+};
+export declare function readLocalPluginRegistry(): Promise<LocalPluginRegistry>;
+export declare function writeLocalPluginRegistry(registry: LocalPluginRegistry): Promise<void>;
+export declare function listLocalPlugins(): Promise<EnrichedLocalPlugin[]>;
+export declare function getLocalPlugin(id: string): Promise<EnrichedLocalPlugin | undefined>;
+export declare function addLocalPluginPath(pluginPath: string, source?: LocalPluginSource): Promise<EnrichedLocalPlugin>;
+export declare function removeLocalPlugin(id: string): Promise<boolean>;
+export declare function pluginPathId(pluginPath: string): string;
+export {};