@cjhyy/code-shell-core 0.7.1 → 0.8.0

package/dist/panel-apps/manifest.d.ts

@@ -0,0 +1,364 @@
+import { z } from "zod";
+export declare const PANEL_APP_MANIFEST_FILE = ".codeshell-panel/panel.json";
+export declare const PANEL_APP_PERMISSIONS: readonly ["context.session", "context.workspace", "storage", "external.open", "agent.submitPrompt", "workspace.info", "workspace.read", "workspace.write", "notifications.send"];
+export declare const PANEL_APP_ICONS: readonly ["panel", "activity", "bar-chart-3", "chart", "file-text", "globe", "image", "layout-dashboard", "line-chart", "palette", "pie-chart", "table", "terminal"];
+export declare const PanelAppAgentTool: z.ZodEffects<z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    readOnly: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    readOnly: boolean;
+}, {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    readOnly?: boolean | undefined;
+}>, {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    readOnly: boolean;
+}, {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    readOnly?: boolean | undefined;
+}>;
+export declare const PanelAppAgentContribution: z.ZodEffects<z.ZodObject<{
+    tools: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        readOnly: z.ZodDefault<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        description: string;
+        inputSchema: Record<string, unknown>;
+        readOnly: boolean;
+    }, {
+        name: string;
+        description: string;
+        inputSchema: Record<string, unknown>;
+        readOnly?: boolean | undefined;
+    }>, {
+        name: string;
+        description: string;
+        inputSchema: Record<string, unknown>;
+        readOnly: boolean;
+    }, {
+        name: string;
+        description: string;
+        inputSchema: Record<string, unknown>;
+        readOnly?: boolean | undefined;
+    }>, "many">>;
+    skills: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    skills: string[];
+    tools: {
+        name: string;
+        description: string;
+        inputSchema: Record<string, unknown>;
+        readOnly: boolean;
+    }[];
+}, {
+    skills?: string[] | undefined;
+    tools?: {
+        name: string;
+        description: string;
+        inputSchema: Record<string, unknown>;
+        readOnly?: boolean | undefined;
+    }[] | undefined;
+}>, {
+    skills: string[];
+    tools: {
+        name: string;
+        description: string;
+        inputSchema: Record<string, unknown>;
+        readOnly: boolean;
+    }[];
+}, {
+    skills?: string[] | undefined;
+    tools?: {
+        name: string;
+        description: string;
+        inputSchema: Record<string, unknown>;
+        readOnly?: boolean | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Schema v2 keeps one installable Panel App identity while allowing it to
+ * declare a narrow Agent surface. UI code still runs in the sandboxed panel;
+ * tool handlers are invoked through the host bridge, and bundled skills are
+ * read-only prompt resources rather than executable plugin code.
+ */
+export declare const PanelAppManifest: z.ZodEffects<z.ZodDiscriminatedUnion<"schemaVersion", [z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodString;
+    title: z.ZodObject<{
+        default: z.ZodString;
+        en: z.ZodOptional<z.ZodString>;
+        "zh-CN": z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        default: string;
+        en?: string | undefined;
+        "zh-CN"?: string | undefined;
+    }, {
+        default: string;
+        en?: string | undefined;
+        "zh-CN"?: string | undefined;
+    }>;
+    description: z.ZodOptional<z.ZodString>;
+    entry: z.ZodEffects<z.ZodString, string, string>;
+    icon: z.ZodDefault<z.ZodEnum<["panel", "activity", "bar-chart-3", "chart", "file-text", "globe", "image", "layout-dashboard", "line-chart", "palette", "pie-chart", "table", "terminal"]>>;
+    placement: z.ZodDefault<z.ZodLiteral<"right-dock">>;
+    singleton: z.ZodDefault<z.ZodBoolean>;
+    permissions: z.ZodDefault<z.ZodArray<z.ZodEnum<["context.session", "context.workspace", "storage", "external.open", "agent.submitPrompt", "workspace.info", "workspace.read", "workspace.write", "notifications.send"]>, "many">>;
+    schemaVersion: z.ZodLiteral<1>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    version: string;
+    permissions: ("context.session" | "context.workspace" | "storage" | "external.open" | "agent.submitPrompt" | "workspace.info" | "workspace.read" | "workspace.write" | "notifications.send")[];
+    entry: string;
+    title: {
+        default: string;
+        en?: string | undefined;
+        "zh-CN"?: string | undefined;
+    };
+    schemaVersion: 1;
+    icon: "terminal" | "image" | "panel" | "activity" | "bar-chart-3" | "chart" | "file-text" | "globe" | "layout-dashboard" | "line-chart" | "palette" | "pie-chart" | "table";
+    placement: "right-dock";
+    singleton: boolean;
+    description?: string | undefined;
+}, {
+    id: string;
+    version: string;
+    entry: string;
+    title: {
+        default: string;
+        en?: string | undefined;
+        "zh-CN"?: string | undefined;
+    };
+    schemaVersion: 1;
+    description?: string | undefined;
+    permissions?: ("context.session" | "context.workspace" | "storage" | "external.open" | "agent.submitPrompt" | "workspace.info" | "workspace.read" | "workspace.write" | "notifications.send")[] | undefined;
+    icon?: "terminal" | "image" | "panel" | "activity" | "bar-chart-3" | "chart" | "file-text" | "globe" | "layout-dashboard" | "line-chart" | "palette" | "pie-chart" | "table" | undefined;
+    placement?: "right-dock" | undefined;
+    singleton?: boolean | undefined;
+}>, z.ZodObject<{
+    agent: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        tools: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            readOnly: z.ZodDefault<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            name: string;
+            description: string;
+            inputSchema: Record<string, unknown>;
+            readOnly: boolean;
+        }, {
+            name: string;
+            description: string;
+            inputSchema: Record<string, unknown>;
+            readOnly?: boolean | undefined;
+        }>, {
+            name: string;
+            description: string;
+            inputSchema: Record<string, unknown>;
+            readOnly: boolean;
+        }, {
+            name: string;
+            description: string;
+            inputSchema: Record<string, unknown>;
+            readOnly?: boolean | undefined;
+        }>, "many">>;
+        skills: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        skills: string[];
+        tools: {
+            name: string;
+            description: string;
+            inputSchema: Record<string, unknown>;
+            readOnly: boolean;
+        }[];
+    }, {
+        skills?: string[] | undefined;
+        tools?: {
+            name: string;
+            description: string;
+            inputSchema: Record<string, unknown>;
+            readOnly?: boolean | undefined;
+        }[] | undefined;
+    }>, {
+        skills: string[];
+        tools: {
+            name: string;
+            description: string;
+            inputSchema: Record<string, unknown>;
+            readOnly: boolean;
+        }[];
+    }, {
+        skills?: string[] | undefined;
+        tools?: {
+            name: string;
+            description: string;
+            inputSchema: Record<string, unknown>;
+            readOnly?: boolean | undefined;
+        }[] | undefined;
+    }>>;
+    id: z.ZodString;
+    version: z.ZodString;
+    title: z.ZodObject<{
+        default: z.ZodString;
+        en: z.ZodOptional<z.ZodString>;
+        "zh-CN": z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        default: string;
+        en?: string | undefined;
+        "zh-CN"?: string | undefined;
+    }, {
+        default: string;
+        en?: string | undefined;
+        "zh-CN"?: string | undefined;
+    }>;
+    description: z.ZodOptional<z.ZodString>;
+    entry: z.ZodEffects<z.ZodString, string, string>;
+    icon: z.ZodDefault<z.ZodEnum<["panel", "activity", "bar-chart-3", "chart", "file-text", "globe", "image", "layout-dashboard", "line-chart", "palette", "pie-chart", "table", "terminal"]>>;
+    placement: z.ZodDefault<z.ZodLiteral<"right-dock">>;
+    singleton: z.ZodDefault<z.ZodBoolean>;
+    permissions: z.ZodDefault<z.ZodArray<z.ZodEnum<["context.session", "context.workspace", "storage", "external.open", "agent.submitPrompt", "workspace.info", "workspace.read", "workspace.write", "notifications.send"]>, "many">>;
+    schemaVersion: z.ZodLiteral<2>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    version: string;
+    permissions: ("context.session" | "context.workspace" | "storage" | "external.open" | "agent.submitPrompt" | "workspace.info" | "workspace.read" | "workspace.write" | "notifications.send")[];
+    entry: string;
+    title: {
+        default: string;
+        en?: string | undefined;
+        "zh-CN"?: string | undefined;
+    };
+    schemaVersion: 2;
+    icon: "terminal" | "image" | "panel" | "activity" | "bar-chart-3" | "chart" | "file-text" | "globe" | "layout-dashboard" | "line-chart" | "palette" | "pie-chart" | "table";
+    placement: "right-dock";
+    singleton: boolean;
+    agent?: {
+        skills: string[];
+        tools: {
+            name: string;
+            description: string;
+            inputSchema: Record<string, unknown>;
+            readOnly: boolean;
+        }[];
+    } | undefined;
+    description?: string | undefined;
+}, {
+    id: string;
+    version: string;
+    entry: string;
+    title: {
+        default: string;
+        en?: string | undefined;
+        "zh-CN"?: string | undefined;
+    };
+    schemaVersion: 2;
+    agent?: {
+        skills?: string[] | undefined;
+        tools?: {
+            name: string;
+            description: string;
+            inputSchema: Record<string, unknown>;
+            readOnly?: boolean | undefined;
+        }[] | undefined;
+    } | undefined;
+    description?: string | undefined;
+    permissions?: ("context.session" | "context.workspace" | "storage" | "external.open" | "agent.submitPrompt" | "workspace.info" | "workspace.read" | "workspace.write" | "notifications.send")[] | undefined;
+    icon?: "terminal" | "image" | "panel" | "activity" | "bar-chart-3" | "chart" | "file-text" | "globe" | "layout-dashboard" | "line-chart" | "palette" | "pie-chart" | "table" | undefined;
+    placement?: "right-dock" | undefined;
+    singleton?: boolean | undefined;
+}>]>, {
+    id: string;
+    version: string;
+    permissions: ("context.session" | "context.workspace" | "storage" | "external.open" | "agent.submitPrompt" | "workspace.info" | "workspace.read" | "workspace.write" | "notifications.send")[];
+    entry: string;
+    title: {
+        default: string;
+        en?: string | undefined;
+        "zh-CN"?: string | undefined;
+    };
+    schemaVersion: 1;
+    icon: "terminal" | "image" | "panel" | "activity" | "bar-chart-3" | "chart" | "file-text" | "globe" | "layout-dashboard" | "line-chart" | "palette" | "pie-chart" | "table";
+    placement: "right-dock";
+    singleton: boolean;
+    description?: string | undefined;
+} | {
+    id: string;
+    version: string;
+    permissions: ("context.session" | "context.workspace" | "storage" | "external.open" | "agent.submitPrompt" | "workspace.info" | "workspace.read" | "workspace.write" | "notifications.send")[];
+    entry: string;
+    title: {
+        default: string;
+        en?: string | undefined;
+        "zh-CN"?: string | undefined;
+    };
+    schemaVersion: 2;
+    icon: "terminal" | "image" | "panel" | "activity" | "bar-chart-3" | "chart" | "file-text" | "globe" | "layout-dashboard" | "line-chart" | "palette" | "pie-chart" | "table";
+    placement: "right-dock";
+    singleton: boolean;
+    agent?: {
+        skills: string[];
+        tools: {
+            name: string;
+            description: string;
+            inputSchema: Record<string, unknown>;
+            readOnly: boolean;
+        }[];
+    } | undefined;
+    description?: string | undefined;
+}, {
+    id: string;
+    version: string;
+    entry: string;
+    title: {
+        default: string;
+        en?: string | undefined;
+        "zh-CN"?: string | undefined;
+    };
+    schemaVersion: 1;
+    description?: string | undefined;
+    permissions?: ("context.session" | "context.workspace" | "storage" | "external.open" | "agent.submitPrompt" | "workspace.info" | "workspace.read" | "workspace.write" | "notifications.send")[] | undefined;
+    icon?: "terminal" | "image" | "panel" | "activity" | "bar-chart-3" | "chart" | "file-text" | "globe" | "layout-dashboard" | "line-chart" | "palette" | "pie-chart" | "table" | undefined;
+    placement?: "right-dock" | undefined;
+    singleton?: boolean | undefined;
+} | {
+    id: string;
+    version: string;
+    entry: string;
+    title: {
+        default: string;
+        en?: string | undefined;
+        "zh-CN"?: string | undefined;
+    };
+    schemaVersion: 2;
+    agent?: {
+        skills?: string[] | undefined;
+        tools?: {
+            name: string;
+            description: string;
+            inputSchema: Record<string, unknown>;
+            readOnly?: boolean | undefined;
+        }[] | undefined;
+    } | undefined;
+    description?: string | undefined;
+    permissions?: ("context.session" | "context.workspace" | "storage" | "external.open" | "agent.submitPrompt" | "workspace.info" | "workspace.read" | "workspace.write" | "notifications.send")[] | undefined;
+    icon?: "terminal" | "image" | "panel" | "activity" | "bar-chart-3" | "chart" | "file-text" | "globe" | "layout-dashboard" | "line-chart" | "palette" | "pie-chart" | "table" | undefined;
+    placement?: "right-dock" | undefined;
+    singleton?: boolean | undefined;
+}>;
+export type PanelAppAgentTool = z.infer<typeof PanelAppAgentTool>;
+export type PanelAppAgentContribution = z.infer<typeof PanelAppAgentContribution>;
+export type PanelAppManifest = z.infer<typeof PanelAppManifest>;

package/dist/panel-apps/manifest.js

@@ -0,0 +1,189 @@
+import { z } from "zod";
+import { validateToolInputSchemaStrict } from "../tool-system/validation.js";
+export const PANEL_APP_MANIFEST_FILE = ".codeshell-panel/panel.json";
+export const PANEL_APP_PERMISSIONS = [
+    "context.session",
+    "context.workspace",
+    "storage",
+    "external.open",
+    "agent.submitPrompt",
+    "workspace.info",
+    "workspace.read",
+    "workspace.write",
+    "notifications.send",
+];
+export const PANEL_APP_ICONS = [
+    "panel",
+    "activity",
+    "bar-chart-3",
+    "chart",
+    "file-text",
+    "globe",
+    "image",
+    "layout-dashboard",
+    "line-chart",
+    "palette",
+    "pie-chart",
+    "table",
+    "terminal",
+];
+const SafePanelAppEntry = z.string().superRefine((value, ctx) => {
+    if (value.length === 0 ||
+        value.length > 1_024 ||
+        !value.includes("/") ||
+        value.startsWith("/") ||
+        value.includes("\\") ||
+        value.includes("\0") ||
+        value.includes("?") ||
+        value.includes("#") ||
+        value
+            .split("/")
+            .some((segment) => segment === "" || segment === "." || segment === ".." || segment.startsWith(".")) ||
+        !value.toLowerCase().endsWith(".html")) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "panel app entry must be a nested, safe POSIX-relative .html path without traversal, query, hash, or hidden segments",
+        });
+    }
+});
+const SafePanelAppSkillEntry = z.string().superRefine((value, ctx) => {
+    const segments = value.split("/");
+    if (value.length === 0 ||
+        value.length > 1_024 ||
+        value.startsWith("/") ||
+        value.includes("\\") ||
+        value.includes("\0") ||
+        segments.length !== 4 ||
+        segments[0] !== "agent" ||
+        segments[1] !== "skills" ||
+        !/^[a-z][a-z0-9-]{0,63}$/.test(segments[2] ?? "") ||
+        segments[3] !== "SKILL.md") {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "panel app skills must use agent/skills/<skill-id>/SKILL.md",
+        });
+    }
+});
+const LocalizedTitle = z
+    .object({
+    default: z.string().min(1).max(80),
+    en: z.string().min(1).max(80).optional(),
+    "zh-CN": z.string().min(1).max(80).optional(),
+})
+    .strict();
+export const PanelAppAgentTool = z
+    .object({
+    name: z.string().regex(/^[a-z][a-z0-9_]{0,63}$/),
+    description: z.string().min(1).max(500),
+    inputSchema: z.record(z.unknown()),
+    readOnly: z.boolean().default(false),
+})
+    .strict()
+    .superRefine((value, ctx) => {
+    if (value.inputSchema.type !== "object") {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["inputSchema", "type"],
+            message: "panel app tool inputSchema must describe a JSON object",
+        });
+        return;
+    }
+    const schemaError = validateToolInputSchemaStrict(value.inputSchema);
+    if (schemaError) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["inputSchema"],
+            message: `panel app tool inputSchema is invalid: ${schemaError}`,
+        });
+    }
+});
+export const PanelAppAgentContribution = z
+    .object({
+    tools: z.array(PanelAppAgentTool).max(16).default([]),
+    skills: z.array(SafePanelAppSkillEntry).max(8).default([]),
+})
+    .strict()
+    .superRefine((value, ctx) => {
+    const toolNames = new Set();
+    for (const [index, tool] of value.tools.entries()) {
+        if (toolNames.has(tool.name)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["tools", index, "name"],
+                message: `duplicate panel app tool name '${tool.name}'`,
+            });
+        }
+        toolNames.add(tool.name);
+    }
+    const skillEntries = new Set();
+    for (const [index, skill] of value.skills.entries()) {
+        if (skillEntries.has(skill)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["skills", index],
+                message: `duplicate panel app skill entry '${skill}'`,
+            });
+        }
+        skillEntries.add(skill);
+    }
+});
+const PanelAppManifestFields = {
+    id: z.string().regex(/^[a-z][a-z0-9-]{0,63}$/),
+    version: z.string().min(1).max(80),
+    title: LocalizedTitle,
+    description: z.string().min(1).max(500).optional(),
+    entry: SafePanelAppEntry,
+    icon: z.enum(PANEL_APP_ICONS).default("panel"),
+    placement: z.literal("right-dock").default("right-dock"),
+    singleton: z.boolean().default(true),
+    permissions: z.array(z.enum(PANEL_APP_PERMISSIONS)).max(8).default([]),
+};
+/**
+ * Schema v2 keeps one installable Panel App identity while allowing it to
+ * declare a narrow Agent surface. UI code still runs in the sandboxed panel;
+ * tool handlers are invoked through the host bridge, and bundled skills are
+ * read-only prompt resources rather than executable plugin code.
+ */
+export const PanelAppManifest = z
+    .discriminatedUnion("schemaVersion", [
+    z
+        .object({
+        schemaVersion: z.literal(1),
+        ...PanelAppManifestFields,
+    })
+        .strict(),
+    z
+        .object({
+        schemaVersion: z.literal(2),
+        ...PanelAppManifestFields,
+        agent: PanelAppAgentContribution.optional(),
+    })
+        .strict(),
+])
+    .superRefine((value, ctx) => {
+    const permissionSet = new Set(value.permissions);
+    if (permissionSet.size !== value.permissions.length) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["permissions"],
+            message: "panel app permissions must not contain duplicates",
+        });
+    }
+    if (value.permissions.includes("agent.submitPrompt") &&
+        !value.permissions.includes("context.session")) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["permissions"],
+            message: "agent.submitPrompt requires context.session",
+        });
+    }
+    if ((value.permissions.includes("workspace.read") ||
+        value.permissions.includes("workspace.write")) &&
+        !value.permissions.includes("context.workspace")) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["permissions"],
+            message: "workspace.read and workspace.write require context.workspace",
+        });
+    }
+});

package/dist/panel-apps/paths.d.ts

@@ -0,0 +1,13 @@
+export declare class PanelAppInstallError extends Error {
+    constructor(message: string);
+}
+export declare class PanelAppReviewChangedError extends PanelAppInstallError {
+    constructor();
+}
+export declare class PanelAppAlreadyInstalledError extends PanelAppInstallError {
+    constructor(id: string);
+}
+export declare function assertSafePanelAppId(id: string): void;
+export declare function panelAppsRoot(): string;
+export declare function panelAppInstallDir(id: string): string;
+export declare function panelAppsRegistryPath(): string;

package/dist/panel-apps/paths.js

@@ -0,0 +1,38 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+export class PanelAppInstallError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PanelAppInstallError";
+    }
+}
+export class PanelAppReviewChangedError extends PanelAppInstallError {
+    constructor() {
+        super("Panel App source changed after review. Review it again before installing.");
+        this.name = "PanelAppReviewChangedError";
+    }
+}
+export class PanelAppAlreadyInstalledError extends PanelAppInstallError {
+    constructor(id) {
+        super(`Panel App '${id}' is already installed`);
+        this.name = "PanelAppAlreadyInstalledError";
+    }
+}
+function userHome() {
+    return process.env.HOME ?? homedir();
+}
+export function assertSafePanelAppId(id) {
+    if (!/^[a-z][a-z0-9-]{0,63}$/.test(id)) {
+        throw new PanelAppInstallError(`invalid Panel App id: ${JSON.stringify(id)}`);
+    }
+}
+export function panelAppsRoot() {
+    return join(userHome(), ".code-shell", "panel-apps");
+}
+export function panelAppInstallDir(id) {
+    assertSafePanelAppId(id);
+    return join(panelAppsRoot(), id);
+}
+export function panelAppsRegistryPath() {
+    return join(panelAppsRoot(), "installed.json");
+}

package/dist/panel-apps/registry.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+declare const RegistryEntry: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodString;
+    source: z.ZodUnion<[z.ZodString, z.ZodObject<{
+        kind: z.ZodLiteral<"git">;
+        url: z.ZodString;
+        ref: z.ZodOptional<z.ZodString>;
+        subdir: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        url: string;
+        kind: "git";
+        ref?: string | undefined;
+        subdir?: string | undefined;
+    }, {
+        url: string;
+        kind: "git";
+        ref?: string | undefined;
+        subdir?: string | undefined;
+    }>]>;
+    installedAt: z.ZodString;
+    lastUpdated: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    version: string;
+    source: string | {
+        url: string;
+        kind: "git";
+        ref?: string | undefined;
+        subdir?: string | undefined;
+    };
+    installedAt: string;
+    lastUpdated: string;
+}, {
+    id: string;
+    version: string;
+    source: string | {
+        url: string;
+        kind: "git";
+        ref?: string | undefined;
+        subdir?: string | undefined;
+    };
+    installedAt: string;
+    lastUpdated: string;
+}>;
+export type InstalledPanelAppRecord = z.infer<typeof RegistryEntry>;
+export declare function readInstalledPanelAppsRegistry(): Promise<InstalledPanelAppRecord[]>;
+export declare function writeInstalledPanelAppsRegistry(apps: InstalledPanelAppRecord[]): Promise<void>;
+export declare function upsertInstalledPanelAppRecord(record: InstalledPanelAppRecord): Promise<void>;
+export declare function removeInstalledPanelAppRecord(id: string): Promise<void>;
+export {};