@agent-phonon/protocol 0.2.0

package/dist/schemas/skill.d.ts

@@ -0,0 +1,465 @@
+import { z } from "zod";
+/**
+ * Skill 管理协议（design D24）。
+ *
+ * 给指定 agent 安装/卸载 skill，支持两级 scope：
+ *   - global  : agent 全局，对该 agent 所有项目可见
+ *   - project : 项目级，仅对某 projectId 可见（需 projectId）
+ *
+ * 每个 agent 靠 capability `skillManagement` 声明是否支持；不支持 → errCapabilityUnsupported。
+ */
+export declare const SkillScope: z.ZodEnum<["global", "project"]>;
+export type SkillScope = z.infer<typeof SkillScope>;
+/** skill 来源：内联内容、本地路径、或远端引用。 */
+export declare const SkillSource: z.ZodUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"inline">;
+    files: z.ZodRecord<z.ZodString, z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "inline";
+    files: Record<string, string>;
+}, {
+    kind: "inline";
+    files: Record<string, string>;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"archive">;
+    /** v0 先支持 tar.gz；zip/archiveUrl 后续再加，避免安全边界没收稳。 */
+    format: z.ZodLiteral<"tar.gz">;
+    contentBase64: z.ZodString;
+    /** 强烈建议传；phonon 会校验内容 hash，防传输/供应链篡改。 */
+    sha256: z.ZodOptional<z.ZodString>;
+    /** 可选大小提示，便于 policy/日志；实际大小以 decode 后为准。 */
+    sizeBytes: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "archive";
+    format: "tar.gz";
+    contentBase64: string;
+    sizeBytes?: number | undefined;
+    sha256?: string | undefined;
+}, {
+    kind: "archive";
+    format: "tar.gz";
+    contentBase64: string;
+    sizeBytes?: number | undefined;
+    sha256?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"localPath">;
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    kind: "localPath";
+}, {
+    path: string;
+    kind: "localPath";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"url">;
+    url: z.ZodString;
+    /** 可选：内容校验和（P2-12 / 供应链可信度）。url 装需 policy allowUrlSkillInstall。 */
+    sha256: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "url";
+    url: string;
+    sha256?: string | undefined;
+}, {
+    kind: "url";
+    url: string;
+    sha256?: string | undefined;
+}>]>;
+export type SkillSource = z.infer<typeof SkillSource>;
+/** 已安装 skill 的描述。 */
+export declare const SkillDescriptor: z.ZodObject<{
+    /** skill 名/key。 */
+    name: z.ZodString;
+    /** 归属哪个 agent。 */
+    agent: z.ZodBranded<z.ZodString, "AgentId">;
+    scope: z.ZodEnum<["global", "project"]>;
+    /** scope=project 时所属项目。 */
+    projectId: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+    /** 版本（P2-12，同名冲突可辨）。 */
+    version: z.ZodOptional<z.ZodString>;
+    /** 内容 hash（P2-12，可复现/防篡改）。 */
+    hash: z.ZodOptional<z.ZodString>;
+    /** 适配的 agent（某些 skill 只适 OpenClaw 不适 Codex）。 */
+    compatibleAgents: z.ZodOptional<z.ZodArray<z.ZodBranded<z.ZodString, "AgentId">, "many">>;
+    /** 来源是否可信（本地/内联=可信，url=需校验）。 */
+    sourceTrusted: z.ZodOptional<z.ZodBoolean>;
+    /** 安装落地路径（设备本地）。 */
+    installedPath: z.ZodOptional<z.ZodString>;
+    installedAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    agent: string & z.BRAND<"AgentId">;
+    name: string;
+    scope: "project" | "global";
+    version?: string | undefined;
+    projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+    hash?: string | undefined;
+    compatibleAgents?: (string & z.BRAND<"AgentId">)[] | undefined;
+    sourceTrusted?: boolean | undefined;
+    installedPath?: string | undefined;
+    installedAt?: string | undefined;
+}, {
+    agent: string;
+    name: string;
+    scope: "project" | "global";
+    version?: string | undefined;
+    projectId?: string | undefined;
+    hash?: string | undefined;
+    compatibleAgents?: string[] | undefined;
+    sourceTrusted?: boolean | undefined;
+    installedPath?: string | undefined;
+    installedAt?: string | undefined;
+}>;
+export type SkillDescriptor = z.infer<typeof SkillDescriptor>;
+export declare const SkillInstallParams: z.ZodEffects<z.ZodObject<{
+    /** 目标 agent。 */
+    agent: z.ZodBranded<z.ZodString, "AgentId">;
+    name: z.ZodString;
+    scope: z.ZodEnum<["global", "project"]>;
+    /** scope=project 时必填。 */
+    projectId: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+    source: z.ZodUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"inline">;
+        files: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "inline";
+        files: Record<string, string>;
+    }, {
+        kind: "inline";
+        files: Record<string, string>;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"archive">;
+        /** v0 先支持 tar.gz；zip/archiveUrl 后续再加，避免安全边界没收稳。 */
+        format: z.ZodLiteral<"tar.gz">;
+        contentBase64: z.ZodString;
+        /** 强烈建议传；phonon 会校验内容 hash，防传输/供应链篡改。 */
+        sha256: z.ZodOptional<z.ZodString>;
+        /** 可选大小提示，便于 policy/日志；实际大小以 decode 后为准。 */
+        sizeBytes: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "archive";
+        format: "tar.gz";
+        contentBase64: string;
+        sizeBytes?: number | undefined;
+        sha256?: string | undefined;
+    }, {
+        kind: "archive";
+        format: "tar.gz";
+        contentBase64: string;
+        sizeBytes?: number | undefined;
+        sha256?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"localPath">;
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        kind: "localPath";
+    }, {
+        path: string;
+        kind: "localPath";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodString;
+        /** 可选：内容校验和（P2-12 / 供应链可信度）。url 装需 policy allowUrlSkillInstall。 */
+        sha256: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "url";
+        url: string;
+        sha256?: string | undefined;
+    }, {
+        kind: "url";
+        url: string;
+        sha256?: string | undefined;
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    agent: string & z.BRAND<"AgentId">;
+    name: string;
+    scope: "project" | "global";
+    source: {
+        kind: "inline";
+        files: Record<string, string>;
+    } | {
+        kind: "archive";
+        format: "tar.gz";
+        contentBase64: string;
+        sizeBytes?: number | undefined;
+        sha256?: string | undefined;
+    } | {
+        path: string;
+        kind: "localPath";
+    } | {
+        kind: "url";
+        url: string;
+        sha256?: string | undefined;
+    };
+    projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+}, {
+    agent: string;
+    name: string;
+    scope: "project" | "global";
+    source: {
+        kind: "inline";
+        files: Record<string, string>;
+    } | {
+        kind: "archive";
+        format: "tar.gz";
+        contentBase64: string;
+        sizeBytes?: number | undefined;
+        sha256?: string | undefined;
+    } | {
+        path: string;
+        kind: "localPath";
+    } | {
+        kind: "url";
+        url: string;
+        sha256?: string | undefined;
+    };
+    projectId?: string | undefined;
+}>, {
+    agent: string & z.BRAND<"AgentId">;
+    name: string;
+    scope: "project" | "global";
+    source: {
+        kind: "inline";
+        files: Record<string, string>;
+    } | {
+        kind: "archive";
+        format: "tar.gz";
+        contentBase64: string;
+        sizeBytes?: number | undefined;
+        sha256?: string | undefined;
+    } | {
+        path: string;
+        kind: "localPath";
+    } | {
+        kind: "url";
+        url: string;
+        sha256?: string | undefined;
+    };
+    projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+}, {
+    agent: string;
+    name: string;
+    scope: "project" | "global";
+    source: {
+        kind: "inline";
+        files: Record<string, string>;
+    } | {
+        kind: "archive";
+        format: "tar.gz";
+        contentBase64: string;
+        sizeBytes?: number | undefined;
+        sha256?: string | undefined;
+    } | {
+        path: string;
+        kind: "localPath";
+    } | {
+        kind: "url";
+        url: string;
+        sha256?: string | undefined;
+    };
+    projectId?: string | undefined;
+}>;
+export type SkillInstallParams = z.infer<typeof SkillInstallParams>;
+export declare const SkillInstallResult: z.ZodObject<{
+    skill: z.ZodObject<{
+        /** skill 名/key。 */
+        name: z.ZodString;
+        /** 归属哪个 agent。 */
+        agent: z.ZodBranded<z.ZodString, "AgentId">;
+        scope: z.ZodEnum<["global", "project"]>;
+        /** scope=project 时所属项目。 */
+        projectId: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+        /** 版本（P2-12，同名冲突可辨）。 */
+        version: z.ZodOptional<z.ZodString>;
+        /** 内容 hash（P2-12，可复现/防篡改）。 */
+        hash: z.ZodOptional<z.ZodString>;
+        /** 适配的 agent（某些 skill 只适 OpenClaw 不适 Codex）。 */
+        compatibleAgents: z.ZodOptional<z.ZodArray<z.ZodBranded<z.ZodString, "AgentId">, "many">>;
+        /** 来源是否可信（本地/内联=可信，url=需校验）。 */
+        sourceTrusted: z.ZodOptional<z.ZodBoolean>;
+        /** 安装落地路径（设备本地）。 */
+        installedPath: z.ZodOptional<z.ZodString>;
+        installedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        agent: string & z.BRAND<"AgentId">;
+        name: string;
+        scope: "project" | "global";
+        version?: string | undefined;
+        projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+        hash?: string | undefined;
+        compatibleAgents?: (string & z.BRAND<"AgentId">)[] | undefined;
+        sourceTrusted?: boolean | undefined;
+        installedPath?: string | undefined;
+        installedAt?: string | undefined;
+    }, {
+        agent: string;
+        name: string;
+        scope: "project" | "global";
+        version?: string | undefined;
+        projectId?: string | undefined;
+        hash?: string | undefined;
+        compatibleAgents?: string[] | undefined;
+        sourceTrusted?: boolean | undefined;
+        installedPath?: string | undefined;
+        installedAt?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    skill: {
+        agent: string & z.BRAND<"AgentId">;
+        name: string;
+        scope: "project" | "global";
+        version?: string | undefined;
+        projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+        hash?: string | undefined;
+        compatibleAgents?: (string & z.BRAND<"AgentId">)[] | undefined;
+        sourceTrusted?: boolean | undefined;
+        installedPath?: string | undefined;
+        installedAt?: string | undefined;
+    };
+}, {
+    skill: {
+        agent: string;
+        name: string;
+        scope: "project" | "global";
+        version?: string | undefined;
+        projectId?: string | undefined;
+        hash?: string | undefined;
+        compatibleAgents?: string[] | undefined;
+        sourceTrusted?: boolean | undefined;
+        installedPath?: string | undefined;
+        installedAt?: string | undefined;
+    };
+}>;
+export type SkillInstallResult = z.infer<typeof SkillInstallResult>;
+export declare const SkillUninstallParams: z.ZodEffects<z.ZodObject<{
+    agent: z.ZodBranded<z.ZodString, "AgentId">;
+    name: z.ZodString;
+    scope: z.ZodEnum<["global", "project"]>;
+    projectId: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+}, "strip", z.ZodTypeAny, {
+    agent: string & z.BRAND<"AgentId">;
+    name: string;
+    scope: "project" | "global";
+    projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+}, {
+    agent: string;
+    name: string;
+    scope: "project" | "global";
+    projectId?: string | undefined;
+}>, {
+    agent: string & z.BRAND<"AgentId">;
+    name: string;
+    scope: "project" | "global";
+    projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+}, {
+    agent: string;
+    name: string;
+    scope: "project" | "global";
+    projectId?: string | undefined;
+}>;
+export type SkillUninstallParams = z.infer<typeof SkillUninstallParams>;
+export declare const SkillUninstallResult: z.ZodObject<{
+    agent: z.ZodBranded<z.ZodString, "AgentId">;
+    name: z.ZodString;
+    scope: z.ZodEnum<["global", "project"]>;
+    uninstalled: z.ZodLiteral<true>;
+}, "strip", z.ZodTypeAny, {
+    agent: string & z.BRAND<"AgentId">;
+    name: string;
+    scope: "project" | "global";
+    uninstalled: true;
+}, {
+    agent: string;
+    name: string;
+    scope: "project" | "global";
+    uninstalled: true;
+}>;
+export type SkillUninstallResult = z.infer<typeof SkillUninstallResult>;
+export declare const SkillListParams: z.ZodObject<{
+    /** 可选：按 agent 过滤。 */
+    agent: z.ZodOptional<z.ZodBranded<z.ZodString, "AgentId">>;
+    /** 可选：按 scope 过滤。 */
+    scope: z.ZodOptional<z.ZodEnum<["global", "project"]>>;
+    /** 可选：按项目过滤（看某项目可见的 skill）。 */
+    projectId: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+}, "strip", z.ZodTypeAny, {
+    agent?: (string & z.BRAND<"AgentId">) | undefined;
+    scope?: "project" | "global" | undefined;
+    projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+}, {
+    agent?: string | undefined;
+    scope?: "project" | "global" | undefined;
+    projectId?: string | undefined;
+}>;
+export type SkillListParams = z.infer<typeof SkillListParams>;
+export declare const SkillListResult: z.ZodObject<{
+    skills: z.ZodArray<z.ZodObject<{
+        /** skill 名/key。 */
+        name: z.ZodString;
+        /** 归属哪个 agent。 */
+        agent: z.ZodBranded<z.ZodString, "AgentId">;
+        scope: z.ZodEnum<["global", "project"]>;
+        /** scope=project 时所属项目。 */
+        projectId: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+        /** 版本（P2-12，同名冲突可辨）。 */
+        version: z.ZodOptional<z.ZodString>;
+        /** 内容 hash（P2-12，可复现/防篡改）。 */
+        hash: z.ZodOptional<z.ZodString>;
+        /** 适配的 agent（某些 skill 只适 OpenClaw 不适 Codex）。 */
+        compatibleAgents: z.ZodOptional<z.ZodArray<z.ZodBranded<z.ZodString, "AgentId">, "many">>;
+        /** 来源是否可信（本地/内联=可信，url=需校验）。 */
+        sourceTrusted: z.ZodOptional<z.ZodBoolean>;
+        /** 安装落地路径（设备本地）。 */
+        installedPath: z.ZodOptional<z.ZodString>;
+        installedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        agent: string & z.BRAND<"AgentId">;
+        name: string;
+        scope: "project" | "global";
+        version?: string | undefined;
+        projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+        hash?: string | undefined;
+        compatibleAgents?: (string & z.BRAND<"AgentId">)[] | undefined;
+        sourceTrusted?: boolean | undefined;
+        installedPath?: string | undefined;
+        installedAt?: string | undefined;
+    }, {
+        agent: string;
+        name: string;
+        scope: "project" | "global";
+        version?: string | undefined;
+        projectId?: string | undefined;
+        hash?: string | undefined;
+        compatibleAgents?: string[] | undefined;
+        sourceTrusted?: boolean | undefined;
+        installedPath?: string | undefined;
+        installedAt?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    skills: {
+        agent: string & z.BRAND<"AgentId">;
+        name: string;
+        scope: "project" | "global";
+        version?: string | undefined;
+        projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+        hash?: string | undefined;
+        compatibleAgents?: (string & z.BRAND<"AgentId">)[] | undefined;
+        sourceTrusted?: boolean | undefined;
+        installedPath?: string | undefined;
+        installedAt?: string | undefined;
+    }[];
+}, {
+    skills: {
+        agent: string;
+        name: string;
+        scope: "project" | "global";
+        version?: string | undefined;
+        projectId?: string | undefined;
+        hash?: string | undefined;
+        compatibleAgents?: string[] | undefined;
+        sourceTrusted?: boolean | undefined;
+        installedPath?: string | undefined;
+        installedAt?: string | undefined;
+    }[];
+}>;
+export type SkillListResult = z.infer<typeof SkillListResult>;
+//# sourceMappingURL=skill.d.ts.map

package/dist/schemas/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/schemas/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;GAQG;AAEH,eAAO,MAAM,UAAU,kCAAgC,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,gCAAgC;AAChC,eAAO,MAAM,WAAW;;;;;;;;;;;IAIpB,mDAAmD;;;IAGnD,yCAAyC;;IAEzC,4CAA4C;;;;;;;;;;;;;;;;;;;;;;;;;;IAO5C,mEAAmE;;;;;;;;;;IAGrE,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,qBAAqB;AACrB,eAAO,MAAM,eAAe;IAC1B,mBAAmB;;IAEnB,kBAAkB;;;IAGlB,2BAA2B;;IAE3B,wBAAwB;;IAExB,8BAA8B;;IAE9B,gDAAgD;;IAEhD,gCAAgC;;IAEhC,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;EAGpB,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAG9D,eAAO,MAAM,kBAAkB;IAE3B,gBAAgB;;;;IAIhB,yBAAyB;;;;;;;;;;;;;QAhDzB,mDAAmD;;;QAGnD,yCAAyC;;QAEzC,4CAA4C;;;;;;;;;;;;;;;;;;;;;;;;;;QAO5C,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2CnE,CAAC;AACL,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,eAAO,MAAM,kBAAkB;;QAtC7B,mBAAmB;;QAEnB,kBAAkB;;;QAGlB,2BAA2B;;QAE3B,wBAAwB;;QAExB,8BAA8B;;QAE9B,gDAAgD;;QAEhD,gCAAgC;;QAEhC,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBpB,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAGpE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;EAU7B,CAAC;AACL,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAGxE,eAAO,MAAM,eAAe;IAC1B,qBAAqB;;IAErB,qBAAqB;;IAErB,+BAA+B;;;;;;;;;;EAE/B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,eAAe;;QA5E1B,mBAAmB;;QAEnB,kBAAkB;;;QAGlB,2BAA2B;;QAE3B,wBAAwB;;QAExB,8BAA8B;;QAE9B,gDAAgD;;QAEhD,gCAAgC;;QAEhC,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+DpB,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/schemas/skill.js

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import { AgentId, ProjectId, Timestamp } from "./common.js";
+/**
+ * Skill 管理协议（design D24）。
+ *
+ * 给指定 agent 安装/卸载 skill，支持两级 scope：
+ *   - global  : agent 全局，对该 agent 所有项目可见
+ *   - project : 项目级，仅对某 projectId 可见（需 projectId）
+ *
+ * 每个 agent 靠 capability `skillManagement` 声明是否支持；不支持 → errCapabilityUnsupported。
+ */
+export const SkillScope = z.enum(["global", "project"]);
+/** skill 来源：内联内容、本地路径、或远端引用。 */
+export const SkillSource = z.union([
+    z.object({ kind: z.literal("inline"), files: z.record(z.string()) }), // path → content
+    z.object({
+        kind: z.literal("archive"),
+        /** v0 先支持 tar.gz；zip/archiveUrl 后续再加，避免安全边界没收稳。 */
+        format: z.literal("tar.gz"),
+        contentBase64: z.string().min(1),
+        /** 强烈建议传；phonon 会校验内容 hash，防传输/供应链篡改。 */
+        sha256: z.string().optional(),
+        /** 可选大小提示，便于 policy/日志；实际大小以 decode 后为准。 */
+        sizeBytes: z.number().int().positive().optional(),
+    }),
+    z.object({ kind: z.literal("localPath"), path: z.string().min(1) }),
+    z.object({
+        kind: z.literal("url"),
+        url: z.string().min(1),
+        /** 可选：内容校验和（P2-12 / 供应链可信度）。url 装需 policy allowUrlSkillInstall。 */
+        sha256: z.string().optional(),
+    }),
+]);
+/** 已安装 skill 的描述。 */
+export const SkillDescriptor = z.object({
+    /** skill 名/key。 */
+    name: z.string().min(1),
+    /** 归属哪个 agent。 */
+    agent: AgentId,
+    scope: SkillScope,
+    /** scope=project 时所属项目。 */
+    projectId: ProjectId.optional(),
+    /** 版本（P2-12，同名冲突可辨）。 */
+    version: z.string().optional(),
+    /** 内容 hash（P2-12，可复现/防篡改）。 */
+    hash: z.string().optional(),
+    /** 适配的 agent（某些 skill 只适 OpenClaw 不适 Codex）。 */
+    compatibleAgents: z.array(AgentId).optional(),
+    /** 来源是否可信（本地/内联=可信，url=需校验）。 */
+    sourceTrusted: z.boolean().optional(),
+    /** 安装落地路径（设备本地）。 */
+    installedPath: z.string().optional(),
+    installedAt: Timestamp.optional(),
+});
+// --- skill.install ---
+export const SkillInstallParams = z
+    .object({
+    /** 目标 agent。 */
+    agent: AgentId,
+    name: z.string().min(1),
+    scope: SkillScope,
+    /** scope=project 时必填。 */
+    projectId: ProjectId.optional(),
+    source: SkillSource,
+})
+    .refine((v) => v.scope !== "project" || !!v.projectId, {
+    message: "scope=project requires projectId",
+    path: ["projectId"],
+});
+export const SkillInstallResult = z.object({
+    skill: SkillDescriptor,
+});
+// --- skill.uninstall ---
+export const SkillUninstallParams = z
+    .object({
+    agent: AgentId,
+    name: z.string().min(1),
+    scope: SkillScope,
+    projectId: ProjectId.optional(),
+})
+    .refine((v) => v.scope !== "project" || !!v.projectId, {
+    message: "scope=project requires projectId",
+    path: ["projectId"],
+});
+export const SkillUninstallResult = z.object({
+    agent: AgentId,
+    name: z.string(),
+    scope: SkillScope,
+    uninstalled: z.literal(true),
+});
+// --- skill.list ---
+export const SkillListParams = z.object({
+    /** 可选：按 agent 过滤。 */
+    agent: AgentId.optional(),
+    /** 可选：按 scope 过滤。 */
+    scope: SkillScope.optional(),
+    /** 可选：按项目过滤（看某项目可见的 skill）。 */
+    projectId: ProjectId.optional(),
+});
+export const SkillListResult = z.object({
+    skills: z.array(SkillDescriptor),
+});
+//# sourceMappingURL=skill.js.map

package/dist/schemas/skill.js.map

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