@agent-phonon/protocol 0.9.0 → 0.10.0

package/dist/schemas/skill.d.ts

@@ -10,6 +10,29 @@ import { z } from "zod";
  */
 export declare const SkillScope: z.ZodEnum<["global", "project"]>;
 export type SkillScope = z.infer<typeof SkillScope>;
+export declare const SkillSelection: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodObject<{
+    name: z.ZodEffects<z.ZodString, string, string>;
+    version: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    scope: z.ZodOptional<z.ZodEnum<["global", "project"]>>;
+    force: z.ZodOptional<z.ZodBoolean>;
+    revision: z.ZodOptional<z.ZodString>;
+    installationId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    version?: string | undefined;
+    scope?: "project" | "global" | undefined;
+    force?: boolean | undefined;
+    revision?: string | undefined;
+    installationId?: string | undefined;
+}, {
+    name: string;
+    version?: string | undefined;
+    scope?: "project" | "global" | undefined;
+    force?: boolean | undefined;
+    revision?: string | undefined;
+    installationId?: string | undefined;
+}>]>;
+export type SkillSelection = z.infer<typeof SkillSelection>;
 /** skill 来源：内联内容、本地路径、或远端引用。 */
 export declare const SkillSource: z.ZodUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"inline">;
@@ -33,14 +56,14 @@ export declare const SkillSource: z.ZodUnion<[z.ZodObject<{
     kind: "archive";
     format: "tar.gz";
     contentBase64: string;
-    sizeBytes?: number | undefined;
     sha256?: string | undefined;
+    sizeBytes?: number | undefined;
 }, {
     kind: "archive";
     format: "tar.gz";
     contentBase64: string;
-    sizeBytes?: number | undefined;
     sha256?: string | undefined;
+    sizeBytes?: number | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"localPath">;
     path: z.ZodString;
@@ -85,31 +108,59 @@ export declare const SkillDescriptor: z.ZodObject<{
     /** 安装落地路径（设备本地）。 */
     installedPath: z.ZodOptional<z.ZodString>;
     installedAt: z.ZodOptional<z.ZodString>;
+    revision: z.ZodOptional<z.ZodString>;
+    publication: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodLiteral<"immutable">;
+        versionId: z.ZodString;
+        treeHash: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "immutable";
+        versionId: string;
+        treeHash: string;
+    }, {
+        kind: "immutable";
+        versionId: string;
+        treeHash: string;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     agent: string & z.BRAND<"AgentId">;
     name: string;
     scope: "project" | "global";
     version?: string | undefined;
+    revision?: 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;
+    publication?: {
+        kind: "immutable";
+        versionId: string;
+        treeHash: string;
+    } | undefined;
 }, {
     agent: string;
     name: string;
     scope: "project" | "global";
     version?: string | undefined;
+    revision?: string | undefined;
     projectId?: string | undefined;
     hash?: string | undefined;
     compatibleAgents?: string[] | undefined;
     sourceTrusted?: boolean | undefined;
     installedPath?: string | undefined;
     installedAt?: string | undefined;
+    publication?: {
+        kind: "immutable";
+        versionId: string;
+        treeHash: string;
+    } | undefined;
 }>;
 export type SkillDescriptor = z.infer<typeof SkillDescriptor>;
 export declare const SkillInstallParams: z.ZodEffects<z.ZodObject<{
+    /** Exact parsed request identity; changed payloads cannot reuse a confirmed receipt. */
+    clientRequestId: z.ZodOptional<z.ZodString>;
     /** 目标 agent。 */
     agent: z.ZodBranded<z.ZodString, "AgentId">;
     name: z.ZodString;
@@ -138,14 +189,14 @@ export declare const SkillInstallParams: z.ZodEffects<z.ZodObject<{
         kind: "archive";
         format: "tar.gz";
         contentBase64: string;
-        sizeBytes?: number | undefined;
         sha256?: string | undefined;
+        sizeBytes?: number | undefined;
     }, {
         kind: "archive";
         format: "tar.gz";
         contentBase64: string;
-        sizeBytes?: number | undefined;
         sha256?: string | undefined;
+        sizeBytes?: number | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"localPath">;
         path: z.ZodString;
@@ -180,8 +231,8 @@ export declare const SkillInstallParams: z.ZodEffects<z.ZodObject<{
         kind: "archive";
         format: "tar.gz";
         contentBase64: string;
-        sizeBytes?: number | undefined;
         sha256?: string | undefined;
+        sizeBytes?: number | undefined;
     } | {
         path: string;
         kind: "localPath";
@@ -191,6 +242,7 @@ export declare const SkillInstallParams: z.ZodEffects<z.ZodObject<{
         sha256?: string | undefined;
     };
     projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+    clientRequestId?: string | undefined;
 }, {
     agent: string;
     name: string;
@@ -202,8 +254,8 @@ export declare const SkillInstallParams: z.ZodEffects<z.ZodObject<{
         kind: "archive";
         format: "tar.gz";
         contentBase64: string;
-        sizeBytes?: number | undefined;
         sha256?: string | undefined;
+        sizeBytes?: number | undefined;
     } | {
         path: string;
         kind: "localPath";
@@ -213,6 +265,7 @@ export declare const SkillInstallParams: z.ZodEffects<z.ZodObject<{
         sha256?: string | undefined;
     };
     projectId?: string | undefined;
+    clientRequestId?: string | undefined;
 }>, {
     agent: string & z.BRAND<"AgentId">;
     name: string;
@@ -224,8 +277,8 @@ export declare const SkillInstallParams: z.ZodEffects<z.ZodObject<{
         kind: "archive";
         format: "tar.gz";
         contentBase64: string;
-        sizeBytes?: number | undefined;
         sha256?: string | undefined;
+        sizeBytes?: number | undefined;
     } | {
         path: string;
         kind: "localPath";
@@ -235,6 +288,7 @@ export declare const SkillInstallParams: z.ZodEffects<z.ZodObject<{
         sha256?: string | undefined;
     };
     projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+    clientRequestId?: string | undefined;
 }, {
     agent: string;
     name: string;
@@ -246,8 +300,8 @@ export declare const SkillInstallParams: z.ZodEffects<z.ZodObject<{
         kind: "archive";
         format: "tar.gz";
         contentBase64: string;
-        sizeBytes?: number | undefined;
         sha256?: string | undefined;
+        sizeBytes?: number | undefined;
     } | {
         path: string;
         kind: "localPath";
@@ -257,6 +311,7 @@ export declare const SkillInstallParams: z.ZodEffects<z.ZodObject<{
         sha256?: string | undefined;
     };
     projectId?: string | undefined;
+    clientRequestId?: string | undefined;
 }>;
 export type SkillInstallParams = z.infer<typeof SkillInstallParams>;
 export declare const SkillInstallResult: z.ZodObject<{
@@ -279,28 +334,54 @@ export declare const SkillInstallResult: z.ZodObject<{
         /** 安装落地路径（设备本地）。 */
         installedPath: z.ZodOptional<z.ZodString>;
         installedAt: z.ZodOptional<z.ZodString>;
+        revision: z.ZodOptional<z.ZodString>;
+        publication: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodLiteral<"immutable">;
+            versionId: z.ZodString;
+            treeHash: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        }, {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         agent: string & z.BRAND<"AgentId">;
         name: string;
         scope: "project" | "global";
         version?: string | undefined;
+        revision?: 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;
+        publication?: {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        } | undefined;
     }, {
         agent: string;
         name: string;
         scope: "project" | "global";
         version?: string | undefined;
+        revision?: string | undefined;
         projectId?: string | undefined;
         hash?: string | undefined;
         compatibleAgents?: string[] | undefined;
         sourceTrusted?: boolean | undefined;
         installedPath?: string | undefined;
         installedAt?: string | undefined;
+        publication?: {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        } | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     skill: {
@@ -308,12 +389,18 @@ export declare const SkillInstallResult: z.ZodObject<{
         name: string;
         scope: "project" | "global";
         version?: string | undefined;
+        revision?: 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;
+        publication?: {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        } | undefined;
     };
 }, {
     skill: {
@@ -321,16 +408,824 @@ export declare const SkillInstallResult: z.ZodObject<{
         name: string;
         scope: "project" | "global";
         version?: string | undefined;
+        revision?: string | undefined;
         projectId?: string | undefined;
         hash?: string | undefined;
         compatibleAgents?: string[] | undefined;
         sourceTrusted?: boolean | undefined;
         installedPath?: string | undefined;
         installedAt?: string | undefined;
+        publication?: {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        } | undefined;
     };
 }>;
 export type SkillInstallResult = z.infer<typeof SkillInstallResult>;
+export declare const SkillPublishParams: z.ZodObject<{
+    clientRequestId: z.ZodString;
+    agent: z.ZodBranded<z.ZodString, "AgentId">;
+    name: z.ZodEffects<z.ZodString, string, string>;
+    scope: z.ZodDefault<z.ZodLiteral<"project">>;
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+    baseRevision: z.ZodNullable<z.ZodString>;
+    expectedReceiverID: z.ZodOptional<z.ZodString>;
+    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;
+        sha256?: string | undefined;
+        sizeBytes?: number | undefined;
+    }, {
+        kind: "archive";
+        format: "tar.gz";
+        contentBase64: string;
+        sha256?: string | undefined;
+        sizeBytes?: number | undefined;
+    }>]>;
+}, "strict", z.ZodTypeAny, {
+    agent: string & z.BRAND<"AgentId">;
+    name: string;
+    scope: "project";
+    projectId: string & z.BRAND<"ProjectId">;
+    clientRequestId: string;
+    source: {
+        kind: "inline";
+        files: Record<string, string>;
+    } | {
+        kind: "archive";
+        format: "tar.gz";
+        contentBase64: string;
+        sha256?: string | undefined;
+        sizeBytes?: number | undefined;
+    };
+    baseRevision: string | null;
+    expectedReceiverID?: string | undefined;
+}, {
+    agent: string;
+    name: string;
+    projectId: string;
+    clientRequestId: string;
+    source: {
+        kind: "inline";
+        files: Record<string, string>;
+    } | {
+        kind: "archive";
+        format: "tar.gz";
+        contentBase64: string;
+        sha256?: string | undefined;
+        sizeBytes?: number | undefined;
+    };
+    baseRevision: string | null;
+    scope?: "project" | undefined;
+    expectedReceiverID?: string | undefined;
+}>;
+export type SkillPublishParams = z.infer<typeof SkillPublishParams>;
+export declare const SkillUnpublishParams: z.ZodObject<{
+    clientRequestId: z.ZodString;
+    agent: z.ZodBranded<z.ZodString, "AgentId">;
+    name: z.ZodEffects<z.ZodString, string, string>;
+    scope: z.ZodDefault<z.ZodLiteral<"project">>;
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+    baseRevision: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    agent: string & z.BRAND<"AgentId">;
+    name: string;
+    scope: "project";
+    projectId: string & z.BRAND<"ProjectId">;
+    clientRequestId: string;
+    baseRevision: string;
+}, {
+    agent: string;
+    name: string;
+    projectId: string;
+    clientRequestId: string;
+    baseRevision: string;
+    scope?: "project" | undefined;
+}>;
+export type SkillUnpublishParams = z.infer<typeof SkillUnpublishParams>;
+export declare const SkillUnpublishResult: z.ZodObject<{
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+    name: z.ZodEffects<z.ZodString, string, string>;
+    deactivated: z.ZodLiteral<true>;
+    previousRevision: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    projectId: string & z.BRAND<"ProjectId">;
+    deactivated: true;
+    previousRevision: string;
+}, {
+    name: string;
+    projectId: string;
+    deactivated: true;
+    previousRevision: string;
+}>;
+export type SkillUnpublishResult = z.infer<typeof SkillUnpublishResult>;
+export declare const SkillInstallStatusParams: z.ZodEffects<z.ZodObject<{
+    clientRequestId: z.ZodString;
+    agent: z.ZodBranded<z.ZodString, "AgentId">;
+    name: z.ZodString;
+    scope: z.ZodEnum<["global", "project"]>;
+    projectId: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+    includeReceiverIdentity: z.ZodOptional<z.ZodLiteral<true>>;
+    includeRecoveryContext: z.ZodOptional<z.ZodLiteral<true>>;
+}, "strict", z.ZodTypeAny, {
+    agent: string & z.BRAND<"AgentId">;
+    name: string;
+    scope: "project" | "global";
+    clientRequestId: string;
+    projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+    includeReceiverIdentity?: true | undefined;
+    includeRecoveryContext?: true | undefined;
+}, {
+    agent: string;
+    name: string;
+    scope: "project" | "global";
+    clientRequestId: string;
+    projectId?: string | undefined;
+    includeReceiverIdentity?: true | undefined;
+    includeRecoveryContext?: true | undefined;
+}>, {
+    agent: string & z.BRAND<"AgentId">;
+    name: string;
+    scope: "project" | "global";
+    clientRequestId: string;
+    projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+    includeReceiverIdentity?: true | undefined;
+    includeRecoveryContext?: true | undefined;
+}, {
+    agent: string;
+    name: string;
+    scope: "project" | "global";
+    clientRequestId: string;
+    projectId?: string | undefined;
+    includeReceiverIdentity?: true | undefined;
+    includeRecoveryContext?: true | undefined;
+}>;
+export type SkillInstallStatusParams = z.infer<typeof SkillInstallStatusParams>;
+export declare const SkillInstallRecoveryContext: z.ZodEffects<z.ZodObject<{
+    revision: z.ZodString;
+    receiverID: z.ZodString;
+    originalReceiverID: z.ZodNullable<z.ZodString>;
+    fenced: z.ZodBoolean;
+    fenceID: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    revision: string;
+    receiverID: string;
+    originalReceiverID: string | null;
+    fenced: boolean;
+    fenceID?: string | undefined;
+}, {
+    revision: string;
+    receiverID: string;
+    originalReceiverID: string | null;
+    fenced: boolean;
+    fenceID?: string | undefined;
+}>, {
+    revision: string;
+    receiverID: string;
+    originalReceiverID: string | null;
+    fenced: boolean;
+    fenceID?: string | undefined;
+}, {
+    revision: string;
+    receiverID: string;
+    originalReceiverID: string | null;
+    fenced: boolean;
+    fenceID?: string | undefined;
+}>;
+export type SkillInstallRecoveryContext = z.infer<typeof SkillInstallRecoveryContext>;
+export declare const SkillInstallStatusResult: z.ZodDiscriminatedUnion<"state", [z.ZodObject<{
+    clientRequestId: z.ZodString;
+    state: z.ZodLiteral<"not_found">;
+    found: z.ZodLiteral<false>;
+    outcomeKnown: z.ZodLiteral<false>;
+}, "strict", z.ZodTypeAny, {
+    state: "not_found";
+    clientRequestId: string;
+    found: false;
+    outcomeKnown: false;
+}, {
+    state: "not_found";
+    clientRequestId: string;
+    found: false;
+    outcomeKnown: false;
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"prepared">;
+    found: z.ZodLiteral<true>;
+    outcomeKnown: z.ZodLiteral<false>;
+    dispatchClaimed: z.ZodLiteral<false>;
+    clientRequestId: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    receiverID: z.ZodOptional<z.ZodString>;
+    recovery: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        revision: z.ZodString;
+        receiverID: z.ZodString;
+        originalReceiverID: z.ZodNullable<z.ZodString>;
+        fenced: z.ZodBoolean;
+        fenceID: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }>, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    state: "prepared";
+    createdAt: string;
+    updatedAt: string;
+    clientRequestId: string;
+    found: true;
+    outcomeKnown: false;
+    dispatchClaimed: false;
+    receiverID?: string | undefined;
+    recovery?: {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    } | undefined;
+}, {
+    state: "prepared";
+    createdAt: string;
+    updatedAt: string;
+    clientRequestId: string;
+    found: true;
+    outcomeKnown: false;
+    dispatchClaimed: false;
+    receiverID?: string | undefined;
+    recovery?: {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"dispatched">;
+    found: z.ZodLiteral<true>;
+    outcomeKnown: z.ZodLiteral<false>;
+    dispatchClaimed: z.ZodLiteral<true>;
+    clientRequestId: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    receiverID: z.ZodOptional<z.ZodString>;
+    recovery: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        revision: z.ZodString;
+        receiverID: z.ZodString;
+        originalReceiverID: z.ZodNullable<z.ZodString>;
+        fenced: z.ZodBoolean;
+        fenceID: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }>, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    state: "dispatched";
+    createdAt: string;
+    updatedAt: string;
+    clientRequestId: string;
+    found: true;
+    outcomeKnown: false;
+    dispatchClaimed: true;
+    receiverID?: string | undefined;
+    recovery?: {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    } | undefined;
+}, {
+    state: "dispatched";
+    createdAt: string;
+    updatedAt: string;
+    clientRequestId: string;
+    found: true;
+    outcomeKnown: false;
+    dispatchClaimed: true;
+    receiverID?: string | undefined;
+    recovery?: {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"unknown">;
+    found: z.ZodLiteral<true>;
+    outcomeKnown: z.ZodLiteral<false>;
+    dispatchClaimed: z.ZodLiteral<true>;
+    reasonCode: z.ZodEnum<["write_outcome_unconfirmed", "controller_not_observed"]>;
+    clientRequestId: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    receiverID: z.ZodOptional<z.ZodString>;
+    recovery: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        revision: z.ZodString;
+        receiverID: z.ZodString;
+        originalReceiverID: z.ZodNullable<z.ZodString>;
+        fenced: z.ZodBoolean;
+        fenceID: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }>, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    state: "unknown";
+    createdAt: string;
+    updatedAt: string;
+    reasonCode: "write_outcome_unconfirmed" | "controller_not_observed";
+    clientRequestId: string;
+    found: true;
+    outcomeKnown: false;
+    dispatchClaimed: true;
+    receiverID?: string | undefined;
+    recovery?: {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    } | undefined;
+}, {
+    state: "unknown";
+    createdAt: string;
+    updatedAt: string;
+    reasonCode: "write_outcome_unconfirmed" | "controller_not_observed";
+    clientRequestId: string;
+    found: true;
+    outcomeKnown: false;
+    dispatchClaimed: true;
+    receiverID?: string | undefined;
+    recovery?: {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"failed">;
+    found: z.ZodLiteral<true>;
+    outcomeKnown: z.ZodLiteral<true>;
+    dispatchClaimed: z.ZodLiteral<false>;
+    reasonCode: z.ZodLiteral<"preparation_failed">;
+    clientRequestId: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    receiverID: z.ZodOptional<z.ZodString>;
+    recovery: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        revision: z.ZodString;
+        receiverID: z.ZodString;
+        originalReceiverID: z.ZodNullable<z.ZodString>;
+        fenced: z.ZodBoolean;
+        fenceID: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }>, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    state: "failed";
+    createdAt: string;
+    updatedAt: string;
+    reasonCode: "preparation_failed";
+    clientRequestId: string;
+    found: true;
+    outcomeKnown: true;
+    dispatchClaimed: false;
+    receiverID?: string | undefined;
+    recovery?: {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    } | undefined;
+}, {
+    state: "failed";
+    createdAt: string;
+    updatedAt: string;
+    reasonCode: "preparation_failed";
+    clientRequestId: string;
+    found: true;
+    outcomeKnown: true;
+    dispatchClaimed: false;
+    receiverID?: string | undefined;
+    recovery?: {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"confirmed">;
+    found: z.ZodLiteral<true>;
+    outcomeKnown: z.ZodLiteral<true>;
+    dispatchClaimed: z.ZodLiteral<true>;
+    result: 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>;
+            revision: z.ZodOptional<z.ZodString>;
+            publication: z.ZodOptional<z.ZodObject<{
+                kind: z.ZodLiteral<"immutable">;
+                versionId: z.ZodString;
+                treeHash: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                kind: "immutable";
+                versionId: string;
+                treeHash: string;
+            }, {
+                kind: "immutable";
+                versionId: string;
+                treeHash: string;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            agent: string & z.BRAND<"AgentId">;
+            name: string;
+            scope: "project" | "global";
+            version?: string | undefined;
+            revision?: 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;
+            publication?: {
+                kind: "immutable";
+                versionId: string;
+                treeHash: string;
+            } | undefined;
+        }, {
+            agent: string;
+            name: string;
+            scope: "project" | "global";
+            version?: string | undefined;
+            revision?: string | undefined;
+            projectId?: string | undefined;
+            hash?: string | undefined;
+            compatibleAgents?: string[] | undefined;
+            sourceTrusted?: boolean | undefined;
+            installedPath?: string | undefined;
+            installedAt?: string | undefined;
+            publication?: {
+                kind: "immutable";
+                versionId: string;
+                treeHash: string;
+            } | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        skill: {
+            agent: string & z.BRAND<"AgentId">;
+            name: string;
+            scope: "project" | "global";
+            version?: string | undefined;
+            revision?: 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;
+            publication?: {
+                kind: "immutable";
+                versionId: string;
+                treeHash: string;
+            } | undefined;
+        };
+    }, {
+        skill: {
+            agent: string;
+            name: string;
+            scope: "project" | "global";
+            version?: string | undefined;
+            revision?: string | undefined;
+            projectId?: string | undefined;
+            hash?: string | undefined;
+            compatibleAgents?: string[] | undefined;
+            sourceTrusted?: boolean | undefined;
+            installedPath?: string | undefined;
+            installedAt?: string | undefined;
+            publication?: {
+                kind: "immutable";
+                versionId: string;
+                treeHash: string;
+            } | undefined;
+        };
+    }>;
+    clientRequestId: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    receiverID: z.ZodOptional<z.ZodString>;
+    recovery: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        revision: z.ZodString;
+        receiverID: z.ZodString;
+        originalReceiverID: z.ZodNullable<z.ZodString>;
+        fenced: z.ZodBoolean;
+        fenceID: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }>, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }, {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    state: "confirmed";
+    createdAt: string;
+    updatedAt: string;
+    clientRequestId: string;
+    found: true;
+    outcomeKnown: true;
+    dispatchClaimed: true;
+    result: {
+        skill: {
+            agent: string & z.BRAND<"AgentId">;
+            name: string;
+            scope: "project" | "global";
+            version?: string | undefined;
+            revision?: 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;
+            publication?: {
+                kind: "immutable";
+                versionId: string;
+                treeHash: string;
+            } | undefined;
+        };
+    };
+    receiverID?: string | undefined;
+    recovery?: {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    } | undefined;
+}, {
+    state: "confirmed";
+    createdAt: string;
+    updatedAt: string;
+    clientRequestId: string;
+    found: true;
+    outcomeKnown: true;
+    dispatchClaimed: true;
+    result: {
+        skill: {
+            agent: string;
+            name: string;
+            scope: "project" | "global";
+            version?: string | undefined;
+            revision?: string | undefined;
+            projectId?: string | undefined;
+            hash?: string | undefined;
+            compatibleAgents?: string[] | undefined;
+            sourceTrusted?: boolean | undefined;
+            installedPath?: string | undefined;
+            installedAt?: string | undefined;
+            publication?: {
+                kind: "immutable";
+                versionId: string;
+                treeHash: string;
+            } | undefined;
+        };
+    };
+    receiverID?: string | undefined;
+    recovery?: {
+        revision: string;
+        receiverID: string;
+        originalReceiverID: string | null;
+        fenced: boolean;
+        fenceID?: string | undefined;
+    } | undefined;
+}>]>;
+export type SkillInstallStatusResult = z.infer<typeof SkillInstallStatusResult>;
+export declare const SkillInstallFenceParams: z.ZodObject<{
+    clientRequestId: z.ZodString;
+    originalRequestId: z.ZodString;
+    agent: z.ZodBranded<z.ZodString, "AgentId">;
+    name: z.ZodString;
+    scope: z.ZodDefault<z.ZodLiteral<"project">>;
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+    expectedReceiverID: z.ZodString;
+    baseRecoveryRevision: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    agent: string & z.BRAND<"AgentId">;
+    name: string;
+    scope: "project";
+    projectId: string & z.BRAND<"ProjectId">;
+    clientRequestId: string;
+    expectedReceiverID: string;
+    originalRequestId: string;
+    baseRecoveryRevision: string;
+}, {
+    agent: string;
+    name: string;
+    projectId: string;
+    clientRequestId: string;
+    expectedReceiverID: string;
+    originalRequestId: string;
+    baseRecoveryRevision: string;
+    scope?: "project" | undefined;
+}>;
+export type SkillInstallFenceParams = z.infer<typeof SkillInstallFenceParams>;
+export declare const SkillInstallFenceResult: z.ZodObject<{
+    clientRequestId: z.ZodString;
+    originalRequestId: z.ZodString;
+    agent: z.ZodBranded<z.ZodString, "AgentId">;
+    name: z.ZodString;
+    scope: z.ZodLiteral<"project">;
+    projectId: z.ZodBranded<z.ZodString, "ProjectId">;
+    receiverID: z.ZodString;
+    originalReceiverID: z.ZodNullable<z.ZodString>;
+    fenceID: z.ZodString;
+    disposition: z.ZodLiteral<"unconfirmed_metadata_fenced">;
+    outcomeKnown: z.ZodLiteral<false>;
+    targetLocked: z.ZodLiteral<true>;
+    filesDeleted: z.ZodLiteral<false>;
+    originalWritesMayContinue: z.ZodLiteral<true>;
+    recordedAt: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    agent: string & z.BRAND<"AgentId">;
+    name: string;
+    scope: "project";
+    projectId: string & z.BRAND<"ProjectId">;
+    clientRequestId: string;
+    receiverID: string;
+    originalReceiverID: string | null;
+    fenceID: string;
+    outcomeKnown: false;
+    originalRequestId: string;
+    disposition: "unconfirmed_metadata_fenced";
+    targetLocked: true;
+    filesDeleted: false;
+    originalWritesMayContinue: true;
+    recordedAt: string;
+}, {
+    agent: string;
+    name: string;
+    scope: "project";
+    projectId: string;
+    clientRequestId: string;
+    receiverID: string;
+    originalReceiverID: string | null;
+    fenceID: string;
+    outcomeKnown: false;
+    originalRequestId: string;
+    disposition: "unconfirmed_metadata_fenced";
+    targetLocked: true;
+    filesDeleted: false;
+    originalWritesMayContinue: true;
+    recordedAt: string;
+}>;
+export type SkillInstallFenceResult = z.infer<typeof SkillInstallFenceResult>;
 export declare const SkillUninstallParams: z.ZodEffects<z.ZodObject<{
+    clientRequestId: z.ZodOptional<z.ZodString>;
     agent: z.ZodBranded<z.ZodString, "AgentId">;
     name: z.ZodString;
     scope: z.ZodEnum<["global", "project"]>;
@@ -340,21 +1235,25 @@ export declare const SkillUninstallParams: z.ZodEffects<z.ZodObject<{
     name: string;
     scope: "project" | "global";
     projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+    clientRequestId?: string | undefined;
 }, {
     agent: string;
     name: string;
     scope: "project" | "global";
     projectId?: string | undefined;
+    clientRequestId?: string | undefined;
 }>, {
     agent: string & z.BRAND<"AgentId">;
     name: string;
     scope: "project" | "global";
     projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+    clientRequestId?: string | undefined;
 }, {
     agent: string;
     name: string;
     scope: "project" | "global";
     projectId?: string | undefined;
+    clientRequestId?: string | undefined;
 }>;
 export type SkillUninstallParams = z.infer<typeof SkillUninstallParams>;
 export declare const SkillUninstallResult: z.ZodObject<{
@@ -411,28 +1310,54 @@ export declare const SkillListResult: z.ZodObject<{
         /** 安装落地路径（设备本地）。 */
         installedPath: z.ZodOptional<z.ZodString>;
         installedAt: z.ZodOptional<z.ZodString>;
+        revision: z.ZodOptional<z.ZodString>;
+        publication: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodLiteral<"immutable">;
+            versionId: z.ZodString;
+            treeHash: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        }, {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         agent: string & z.BRAND<"AgentId">;
         name: string;
         scope: "project" | "global";
         version?: string | undefined;
+        revision?: 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;
+        publication?: {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        } | undefined;
     }, {
         agent: string;
         name: string;
         scope: "project" | "global";
         version?: string | undefined;
+        revision?: string | undefined;
         projectId?: string | undefined;
         hash?: string | undefined;
         compatibleAgents?: string[] | undefined;
         sourceTrusted?: boolean | undefined;
         installedPath?: string | undefined;
         installedAt?: string | undefined;
+        publication?: {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        } | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     skills: {
@@ -440,12 +1365,18 @@ export declare const SkillListResult: z.ZodObject<{
         name: string;
         scope: "project" | "global";
         version?: string | undefined;
+        revision?: 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;
+        publication?: {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        } | undefined;
     }[];
 }, {
     skills: {
@@ -453,12 +1384,18 @@ export declare const SkillListResult: z.ZodObject<{
         name: string;
         scope: "project" | "global";
         version?: string | undefined;
+        revision?: string | undefined;
         projectId?: string | undefined;
         hash?: string | undefined;
         compatibleAgents?: string[] | undefined;
         sourceTrusted?: boolean | undefined;
         installedPath?: string | undefined;
         installedAt?: string | undefined;
+        publication?: {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        } | undefined;
     }[];
 }>;
 export type SkillListResult = z.infer<typeof SkillListResult>;
@@ -490,6 +1427,20 @@ export declare const SkillDirectoryDescriptor: z.ZodObject<{
     /** skill 目录真实本机路径。 */
     path: z.ZodString;
     exists: z.ZodBoolean;
+    active: z.ZodOptional<z.ZodBoolean>;
+    publication: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodLiteral<"immutable">;
+        versionId: z.ZodString;
+        treeHash: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "immutable";
+        versionId: string;
+        treeHash: string;
+    }, {
+        kind: "immutable";
+        versionId: string;
+        treeHash: string;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     path: string;
     name: string;
@@ -498,6 +1449,12 @@ export declare const SkillDirectoryDescriptor: z.ZodObject<{
     exists: boolean;
     agent?: (string & z.BRAND<"AgentId">) | undefined;
     projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+    publication?: {
+        kind: "immutable";
+        versionId: string;
+        treeHash: string;
+    } | undefined;
+    active?: boolean | undefined;
 }, {
     path: string;
     name: string;
@@ -506,6 +1463,12 @@ export declare const SkillDirectoryDescriptor: z.ZodObject<{
     exists: boolean;
     agent?: string | undefined;
     projectId?: string | undefined;
+    publication?: {
+        kind: "immutable";
+        versionId: string;
+        treeHash: string;
+    } | undefined;
+    active?: boolean | undefined;
 }>;
 export type SkillDirectoryDescriptor = z.infer<typeof SkillDirectoryDescriptor>;
 export declare const SkillDirsResult: z.ZodObject<{
@@ -520,6 +1483,20 @@ export declare const SkillDirsResult: z.ZodObject<{
         /** skill 目录真实本机路径。 */
         path: z.ZodString;
         exists: z.ZodBoolean;
+        active: z.ZodOptional<z.ZodBoolean>;
+        publication: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodLiteral<"immutable">;
+            versionId: z.ZodString;
+            treeHash: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        }, {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         path: string;
         name: string;
@@ -528,6 +1505,12 @@ export declare const SkillDirsResult: z.ZodObject<{
         exists: boolean;
         agent?: (string & z.BRAND<"AgentId">) | undefined;
         projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+        publication?: {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        } | undefined;
+        active?: boolean | undefined;
     }, {
         path: string;
         name: string;
@@ -536,6 +1519,12 @@ export declare const SkillDirsResult: z.ZodObject<{
         exists: boolean;
         agent?: string | undefined;
         projectId?: string | undefined;
+        publication?: {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        } | undefined;
+        active?: boolean | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     directories: {
@@ -546,6 +1535,12 @@ export declare const SkillDirsResult: z.ZodObject<{
         exists: boolean;
         agent?: (string & z.BRAND<"AgentId">) | undefined;
         projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+        publication?: {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        } | undefined;
+        active?: boolean | undefined;
     }[];
 }, {
     directories: {
@@ -556,6 +1551,12 @@ export declare const SkillDirsResult: z.ZodObject<{
         exists: boolean;
         agent?: string | undefined;
         projectId?: string | undefined;
+        publication?: {
+            kind: "immutable";
+            versionId: string;
+            treeHash: string;
+        } | undefined;
+        active?: boolean | undefined;
     }[];
 }>;
 export type SkillDirsResult = z.infer<typeof SkillDirsResult>;