@adea-ai/plugins 1.0.0

package/dist/agent-plugins-schema.d.ts

@@ -0,0 +1,402 @@
+import { z } from 'zod';
+export declare const AGENT_PLUGINS_VERSION: "1.0.0";
+export declare const PLUGIN_SCHEMA_ID = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
+export declare const MCP_SCHEMA_ID = "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json";
+export declare const NORMALIZER_VERSION: "adea-agent-plugins/1";
+export declare const PluginNameSchema: z.ZodString;
+export declare const AgentManifestSchema: z.ZodObject<{
+    $schema: z.ZodLiteral<"https://agent-plugins.org/schemas/1.0.0/plugin.schema.json">;
+    name: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    homepage: z.ZodOptional<z.ZodString>;
+    repository: z.ZodOptional<z.ZodString>;
+    license: z.ZodOptional<z.ZodString>;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strict>;
+export declare const McpServerSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"stdio">;
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"streamable-http">;
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"sse">;
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>], "type">;
+export declare const AgentMcpSchema: z.ZodObject<{
+    $schema: z.ZodLiteral<"https://agent-plugins.org/schemas/1.0.0/mcp.schema.json">;
+    mcpServers: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"stdio">;
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cwd: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"streamable-http">;
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"sse">;
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>], "type">>;
+}, z.core.$strict>;
+export declare const SkillFrontmatterSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    license: z.ZodOptional<z.ZodString>;
+    compatibility: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    'allowed-tools': z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const DiagnosticSchema: z.ZodObject<{
+    code: z.ZodString;
+    scope: z.ZodEnum<{
+        plugin: "plugin";
+        skills: "skills";
+        skill: "skill";
+        mcp: "mcp";
+        server: "server";
+        extension: "extension";
+        translation: "translation";
+    }>;
+    path: z.ZodString;
+    severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+    }>;
+    message: z.ZodString;
+}, z.core.$strict>;
+export declare const PackageFileSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"copy">;
+    sourcePath: z.ZodString;
+    targetPath: z.ZodString;
+    digest: z.ZodString;
+    preserveMode: z.ZodLiteral<true>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"write">;
+    targetPath: z.ZodString;
+    digest: z.ZodString;
+    content: z.ZodString;
+    mode: z.ZodLiteral<"0644">;
+}, z.core.$strict>], "action">;
+export declare const AgentPackageSchema: z.ZodObject<{
+    contractVersion: z.ZodLiteral<1>;
+    normalizerVersion: z.ZodLiteral<"adea-agent-plugins/1">;
+    format: z.ZodLiteral<"agent-plugins">;
+    specVersion: z.ZodLiteral<"1.0.0">;
+    originFormat: z.ZodEnum<{
+        "agent-plugins": "agent-plugins";
+        legacy: "legacy";
+    }>;
+    sourceDigest: z.ZodString;
+    status: z.ZodEnum<{
+        portable: "portable";
+        partial: "partial";
+        unavailable: "unavailable";
+    }>;
+    manifest: z.ZodOptional<z.ZodObject<{
+        $schema: z.ZodLiteral<"https://agent-plugins.org/schemas/1.0.0/plugin.schema.json">;
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        author: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        homepage: z.ZodOptional<z.ZodString>;
+        repository: z.ZodOptional<z.ZodString>;
+        license: z.ZodOptional<z.ZodString>;
+        keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strict>>;
+    packageDigest: z.ZodOptional<z.ZodString>;
+    files: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        action: z.ZodLiteral<"copy">;
+        sourcePath: z.ZodString;
+        targetPath: z.ZodString;
+        digest: z.ZodString;
+        preserveMode: z.ZodLiteral<true>;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"write">;
+        targetPath: z.ZodString;
+        digest: z.ZodString;
+        content: z.ZodString;
+        mode: z.ZodLiteral<"0644">;
+    }, z.core.$strict>], "action">>;
+    skills: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        path: z.ZodString;
+        description: z.ZodString;
+        compatibility: z.ZodOptional<z.ZodString>;
+        allowedTools: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    mcpServers: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"stdio">;
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cwd: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"streamable-http">;
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"sse">;
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>], "type">>;
+    nonPortable: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        paths: z.ZodArray<z.ZodString>;
+        reason: z.ZodString;
+    }, z.core.$strict>>;
+    diagnostics: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        scope: z.ZodEnum<{
+            plugin: "plugin";
+            skills: "skills";
+            skill: "skill";
+            mcp: "mcp";
+            server: "server";
+            extension: "extension";
+            translation: "translation";
+        }>;
+        path: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strict>>;
+    requirements: z.ZodObject<{
+        skills: z.ZodBoolean;
+        mcpTransports: z.ZodArray<z.ZodEnum<{
+            stdio: "stdio";
+            "streamable-http": "streamable-http";
+            sse: "sse";
+        }>>;
+        executables: z.ZodArray<z.ZodString>;
+        environmentReview: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+/** Reported by the actual Control Plane harness adapter, not inferred from a brand name. */
+export declare const HarnessProfileSchema: z.ZodObject<{
+    profileVersion: z.ZodLiteral<1>;
+    harness: z.ZodString;
+    runtimeVersion: z.ZodString;
+    adapterVersion: z.ZodString;
+    agentPlugins: z.ZodObject<{
+        versions: z.ZodArray<z.ZodString>;
+        skills: z.ZodBoolean;
+        mcpTransports: z.ZodArray<z.ZodEnum<{
+            stdio: "stdio";
+            "streamable-http": "streamable-http";
+            sse: "sse";
+        }>>;
+    }, z.core.$strict>;
+    components: z.ZodObject<{
+        skillDirectories: z.ZodBoolean;
+        mcpTransports: z.ZodArray<z.ZodEnum<{
+            stdio: "stdio";
+            "streamable-http": "streamable-http";
+            sse: "sse";
+        }>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const InstallationPlanSchema: z.ZodObject<{
+    planVersion: z.ZodLiteral<2>;
+    pluginId: z.ZodString;
+    releaseId: z.ZodString;
+    instanceId: z.ZodString;
+    profile: z.ZodObject<{
+        profileVersion: z.ZodLiteral<1>;
+        harness: z.ZodString;
+        runtimeVersion: z.ZodString;
+        adapterVersion: z.ZodString;
+        agentPlugins: z.ZodObject<{
+            versions: z.ZodArray<z.ZodString>;
+            skills: z.ZodBoolean;
+            mcpTransports: z.ZodArray<z.ZodEnum<{
+                stdio: "stdio";
+                "streamable-http": "streamable-http";
+                sse: "sse";
+            }>>;
+        }, z.core.$strict>;
+        components: z.ZodObject<{
+            skillDirectories: z.ZodBoolean;
+            mcpTransports: z.ZodArray<z.ZodEnum<{
+                stdio: "stdio";
+                "streamable-http": "streamable-http";
+                sse: "sse";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    source: z.ZodObject<{
+        repositoryUrl: z.ZodString;
+        commitSha: z.ZodString;
+        pluginSubdirectory: z.ZodString;
+        contentDigest: z.ZodString;
+    }, z.core.$strict>;
+    package: z.ZodObject<{
+        contractVersion: z.ZodLiteral<1>;
+        normalizerVersion: z.ZodLiteral<"adea-agent-plugins/1">;
+        format: z.ZodLiteral<"agent-plugins">;
+        specVersion: z.ZodLiteral<"1.0.0">;
+        originFormat: z.ZodEnum<{
+            "agent-plugins": "agent-plugins";
+            legacy: "legacy";
+        }>;
+        sourceDigest: z.ZodString;
+        status: z.ZodEnum<{
+            portable: "portable";
+            partial: "partial";
+            unavailable: "unavailable";
+        }>;
+        manifest: z.ZodOptional<z.ZodObject<{
+            $schema: z.ZodLiteral<"https://agent-plugins.org/schemas/1.0.0/plugin.schema.json">;
+            name: z.ZodString;
+            version: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            author: z.ZodOptional<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                email: z.ZodOptional<z.ZodString>;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            homepage: z.ZodOptional<z.ZodString>;
+            repository: z.ZodOptional<z.ZodString>;
+            license: z.ZodOptional<z.ZodString>;
+            keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        }, z.core.$strict>>;
+        packageDigest: z.ZodOptional<z.ZodString>;
+        files: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            action: z.ZodLiteral<"copy">;
+            sourcePath: z.ZodString;
+            targetPath: z.ZodString;
+            digest: z.ZodString;
+            preserveMode: z.ZodLiteral<true>;
+        }, z.core.$strict>, z.ZodObject<{
+            action: z.ZodLiteral<"write">;
+            targetPath: z.ZodString;
+            digest: z.ZodString;
+            content: z.ZodString;
+            mode: z.ZodLiteral<"0644">;
+        }, z.core.$strict>], "action">>;
+        skills: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            path: z.ZodString;
+            description: z.ZodString;
+            compatibility: z.ZodOptional<z.ZodString>;
+            allowedTools: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        mcpServers: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"stdio">;
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cwd: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"streamable-http">;
+            url: z.ZodString;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"sse">;
+            url: z.ZodString;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>], "type">>;
+        nonPortable: z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            paths: z.ZodArray<z.ZodString>;
+            reason: z.ZodString;
+        }, z.core.$strict>>;
+        diagnostics: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            scope: z.ZodEnum<{
+                plugin: "plugin";
+                skills: "skills";
+                skill: "skill";
+                mcp: "mcp";
+                server: "server";
+                extension: "extension";
+                translation: "translation";
+            }>;
+            path: z.ZodString;
+            severity: z.ZodEnum<{
+                error: "error";
+                warning: "warning";
+            }>;
+            message: z.ZodString;
+        }, z.core.$strict>>;
+        requirements: z.ZodObject<{
+            skills: z.ZodBoolean;
+            mcpTransports: z.ZodArray<z.ZodEnum<{
+                stdio: "stdio";
+                "streamable-http": "streamable-http";
+                sse: "sse";
+            }>>;
+            executables: z.ZodArray<z.ZodString>;
+            environmentReview: z.ZodBoolean;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    packageKey: z.ZodString;
+    dataKey: z.ZodString;
+    preserveDataAcrossUpdates: z.ZodLiteral<true>;
+    strategy: z.ZodEnum<{
+        unavailable: "unavailable";
+        "native-agent-plugin": "native-agent-plugin";
+        "component-adapter": "component-adapter";
+    }>;
+    compatibility: z.ZodEnum<{
+        partial: "partial";
+        full: "full";
+        unsupported: "unsupported";
+    }>;
+    allowedToActivate: z.ZodLiteral<false>;
+    approvalRequired: z.ZodLiteral<true>;
+    selection: z.ZodObject<{
+        skillDirectories: z.ZodArray<z.ZodString>;
+        mcpServers: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"stdio">;
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cwd: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"streamable-http">;
+            url: z.ZodString;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"sse">;
+            url: z.ZodString;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>;
+    disabled: z.ZodArray<z.ZodObject<{
+        component: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strict>>;
+    requiredConnectors: z.ZodArray<z.ZodString>;
+    requiredCredentials: z.ZodArray<z.ZodString>;
+    preconditions: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type AgentManifest = z.infer<typeof AgentManifestSchema>;
+export type McpServer = z.infer<typeof McpServerSchema>;
+export type AgentPackage = z.infer<typeof AgentPackageSchema>;
+export type PackageFile = z.infer<typeof PackageFileSchema>;
+export type Diagnostic = z.infer<typeof DiagnosticSchema>;
+export type HarnessProfile = z.infer<typeof HarnessProfileSchema>;
+export type InstallationPlan = z.infer<typeof InstallationPlanSchema>;

package/dist/agent-plugins-schema.js

@@ -0,0 +1,200 @@
+import { z } from 'zod';
+// Locally pinned contracts. Never fetch a schema while inspecting a plugin.
+export const AGENT_PLUGINS_VERSION = '1.0.0';
+export const PLUGIN_SCHEMA_ID = 'https://agent-plugins.org/schemas/1.0.0/plugin.schema.json';
+export const MCP_SCHEMA_ID = 'https://agent-plugins.org/schemas/1.0.0/mcp.schema.json';
+export const NORMALIZER_VERSION = 'adea-agent-plugins/1';
+export const PluginNameSchema = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(/^(?!.*(?:--|\.\.))[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$/);
+const Strings = z.record(z.string(), z.string());
+const Digest = z.string().regex(/^sha256:[a-f0-9]{64}$/);
+const Path = z
+    .string()
+    .min(1)
+    .max(1024)
+    .regex(
+// eslint-disable-next-line no-control-regex
+/^(?!.*(?:^|\/)\.{1,2}(?:\/|$))[^\\:\u0000-\u001f\u007f/]+(?:\/[^\\:\u0000-\u001f\u007f/]+)*$/);
+export const AgentManifestSchema = z
+    .object({
+    $schema: z.literal(PLUGIN_SCHEMA_ID),
+    name: PluginNameSchema,
+    version: z.string().optional(),
+    description: z.string().optional(),
+    author: z
+        .object({
+        name: z.string().optional(),
+        email: z.string().optional(),
+        url: z.string().optional(),
+    })
+        .strict()
+        .optional(),
+    homepage: z.string().optional(),
+    repository: z.string().optional(),
+    license: z.string().optional(),
+    keywords: z.array(z.string()).optional(),
+    extensions: z.record(z.string(), z.record(z.string(), z.unknown())).optional(),
+})
+    .strict();
+export const McpServerSchema = z.discriminatedUnion('type', [
+    z
+        .object({
+        type: z.literal('stdio'),
+        command: z.string().min(1),
+        args: z.array(z.string()).optional(),
+        env: Strings.optional(),
+        cwd: z.string().optional(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('streamable-http'),
+        url: z.string().min(1),
+        headers: Strings.optional(),
+    })
+        .strict(),
+    z
+        .object({ type: z.literal('sse'), url: z.string().min(1), headers: Strings.optional() })
+        .strict(),
+]);
+export const AgentMcpSchema = z
+    .object({ $schema: z.literal(MCP_SCHEMA_ID), mcpServers: z.record(z.string(), McpServerSchema) })
+    .strict();
+export const SkillFrontmatterSchema = z
+    .object({
+    name: z
+        .string()
+        .min(1)
+        .max(64)
+        .regex(/^(?!.*--)[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/),
+    description: z.string().min(1).max(1024),
+    license: z.string().optional(),
+    compatibility: z.string().min(1).max(500).optional(),
+    metadata: Strings.optional(),
+    'allowed-tools': z.string().optional(),
+})
+    .strict();
+export const DiagnosticSchema = z
+    .object({
+    code: z.string().min(1),
+    scope: z.enum(['plugin', 'skills', 'skill', 'mcp', 'server', 'extension', 'translation']),
+    path: z.string(),
+    severity: z.enum(['warning', 'error']),
+    message: z.string().min(1),
+})
+    .strict();
+export const PackageFileSchema = z.discriminatedUnion('action', [
+    z
+        .object({
+        action: z.literal('copy'),
+        sourcePath: Path,
+        targetPath: Path,
+        digest: Digest,
+        preserveMode: z.literal(true),
+    })
+        .strict(),
+    z
+        .object({
+        action: z.literal('write'),
+        targetPath: Path,
+        digest: Digest,
+        content: z.string(),
+        mode: z.literal('0644'),
+    })
+        .strict(),
+]);
+export const AgentPackageSchema = z
+    .object({
+    contractVersion: z.literal(1),
+    normalizerVersion: z.literal(NORMALIZER_VERSION),
+    format: z.literal('agent-plugins'),
+    specVersion: z.literal(AGENT_PLUGINS_VERSION),
+    originFormat: z.enum(['agent-plugins', 'legacy']),
+    sourceDigest: Digest,
+    status: z.enum(['portable', 'partial', 'unavailable']),
+    manifest: AgentManifestSchema.optional(),
+    packageDigest: Digest.optional(),
+    files: z.array(PackageFileSchema).max(8192),
+    skills: z.array(z
+        .object({
+        name: z.string(),
+        path: Path,
+        description: z.string(),
+        compatibility: z.string().optional(),
+        allowedTools: z.string().optional(),
+    })
+        .strict()),
+    mcpServers: z.record(z.string(), McpServerSchema),
+    nonPortable: z.array(z.object({ kind: z.string(), paths: z.array(Path), reason: z.string() }).strict()),
+    diagnostics: z.array(DiagnosticSchema),
+    requirements: z
+        .object({
+        skills: z.boolean(),
+        mcpTransports: z.array(z.enum(['stdio', 'streamable-http', 'sse'])),
+        executables: z.array(z.string()),
+        environmentReview: z.boolean(),
+    })
+        .strict(),
+})
+    .strict();
+/** Reported by the actual Control Plane harness adapter, not inferred from a brand name. */
+export const HarnessProfileSchema = z
+    .object({
+    profileVersion: z.literal(1),
+    harness: z.string().min(1).max(128),
+    runtimeVersion: z.string().min(1).max(128),
+    adapterVersion: z.string().min(1).max(128),
+    agentPlugins: z
+        .object({
+        versions: z.array(z.string()),
+        skills: z.boolean(),
+        mcpTransports: z.array(z.enum(['stdio', 'streamable-http', 'sse'])),
+    })
+        .strict(),
+    components: z
+        .object({
+        skillDirectories: z.boolean(),
+        mcpTransports: z.array(z.enum(['stdio', 'streamable-http', 'sse'])),
+    })
+        .strict(),
+})
+    .strict();
+export const InstallationPlanSchema = z
+    .object({
+    planVersion: z.literal(2),
+    pluginId: z.string().min(1),
+    releaseId: z.string().min(1),
+    instanceId: z.string().min(1).max(256),
+    profile: HarnessProfileSchema,
+    source: z
+        .object({
+        repositoryUrl: z.string().url(),
+        commitSha: z.string().regex(/^[a-f0-9]{40}$/),
+        pluginSubdirectory: z.string().min(1).max(1024),
+        contentDigest: Digest,
+    })
+        .strict(),
+    package: AgentPackageSchema,
+    packageKey: z.string(),
+    dataKey: z.string(),
+    preserveDataAcrossUpdates: z.literal(true),
+    strategy: z.enum(['native-agent-plugin', 'component-adapter', 'unavailable']),
+    compatibility: z.enum(['full', 'partial', 'unsupported']),
+    allowedToActivate: z.literal(false),
+    approvalRequired: z.literal(true),
+    selection: z
+        .object({
+        skillDirectories: z.array(Path),
+        mcpServers: z.record(z.string(), McpServerSchema),
+    })
+        .strict(),
+    disabled: z.array(z.object({ component: z.string(), reason: z.string() }).strict()),
+    requiredConnectors: z.array(z.string()),
+    requiredCredentials: z.array(z.string()),
+    preconditions: z.array(z.string()),
+})
+    .strict();
+//# sourceMappingURL=agent-plugins-schema.js.map

package/dist/agent-plugins-schema.js.map

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