@xdxer/dingtalk-agent 0.1.4-beta.1 → 0.1.4-beta.10

package/docs/schemas/agent-audit.schema.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/agent-audit.schema.json",
+  "title": "dingtalk-agent Agent Audit Report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema", "status", "ready", "sideEffect", "dingtalkSideEffect", "root",
+    "bindings", "definition", "storageMode", "requiredSkills", "checks", "missing",
+    "repairs", "verification"
+  ],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/agent-audit@1" },
+    "status": { "enum": ["ready", "partial"] },
+    "ready": { "type": "boolean" },
+    "sideEffect": { "enum": [false, "local-opencode-eval"] },
+    "dingtalkSideEffect": { "const": false },
+    "root": { "type": "string", "minLength": 1 },
+    "bindings": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path", "hash"],
+          "properties": {
+            "path": { "type": "string" },
+            "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+          }
+        }
+      ]
+    },
+    "definition": { "type": "object" },
+    "storageMode": { "enum": ["local", "remote", "mixed"] },
+    "requiredSkills": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "checks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "surface", "level", "blocking", "summary", "evidence"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "surface": { "enum": ["definition", "skills", "storage", "authority", "host", "load"] },
+          "level": { "enum": ["pass", "warn", "fail"] },
+          "blocking": { "type": "boolean" },
+          "summary": { "type": "string", "minLength": 1 },
+          "evidence": { "type": "object" }
+        }
+      }
+    },
+    "missing": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "repairs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "why", "actions"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "why": { "type": "string", "minLength": 1 },
+          "actions": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
+    "verification": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["loadReport", "remoteReport", "commands"],
+      "properties": {
+        "loadReport": { "type": "string" },
+        "remoteReport": { "type": "string" },
+        "commands": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}

package/docs/schemas/agent-bindings.schema.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/agent-bindings.schema.json",
+  "title": "dingtalk-agent Agent Bindings",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema",
+    "agent",
+    "skills",
+    "memory",
+    "knowledge",
+    "artifacts",
+    "stateDir",
+    "authority"
+  ],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/agent-bindings@1" },
+    "agent": {
+      "type": "string",
+      "pattern": "^local-dir:.+$"
+    },
+    "skills": {
+      "type": "string",
+      "pattern": "^(local-dir|local-md):.+$"
+    },
+    "memory": {
+      "type": "string",
+      "pattern": "^(local-md|dingtalk-doc):.+$"
+    },
+    "knowledge": {
+      "type": "string",
+      "pattern": "^(local-md|dingtalk-doc):.+$"
+    },
+    "artifacts": {
+      "type": "string",
+      "pattern": "^local-dir:.+$"
+    },
+    "stateDir": {
+      "type": "string",
+      "minLength": 1,
+      "not": { "pattern": "^[A-Za-z][A-Za-z0-9-]*:" }
+    },
+    "authority": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["profile", "expectedUserId"],
+      "properties": {
+        "profile": { "type": "string" },
+        "expectedUserId": { "type": "string" }
+      }
+    }
+  }
+}

package/docs/schemas/agent-definition.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dingtalk-agent.dev/schemas/agent-definition.schema.json",
+  "title": "dingtalk-agent AgentDefinition",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "id", "source", "body", "skills", "storage", "authority", "configuration", "status", "missing", "hash"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/agent-definition@1" },
+    "id": { "type": "string", "minLength": 1 },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "uri", "revision"],
+      "properties": {
+        "kind": { "enum": ["local-folder", "git-checkout", "dingtalk-doc", "workspace"] },
+        "uri": { "type": "string", "minLength": 1 },
+        "revision": { "type": "string" }
+      }
+    },
+    "body": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path", "hash"],
+          "properties": {
+            "path": { "type": "string", "minLength": 1 },
+            "hash": { "type": "string", "minLength": 1 }
+          }
+        }
+      ]
+    },
+    "skills": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "version", "source", "path", "hash"],
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "version": { "type": "string" },
+          "source": { "type": "string" },
+          "path": { "type": "string" },
+          "hash": { "type": "string" }
+        }
+      }
+    },
+    "storage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["memory", "knowledge", "artifacts", "state"],
+      "properties": {
+        "memory": { "type": "string" },
+        "knowledge": { "type": "string" },
+        "artifacts": { "type": "string" },
+        "state": { "type": "string" }
+      }
+    },
+    "authority": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["dwsProfile", "expectedUserId"],
+      "properties": {
+        "dwsProfile": { "type": "string" },
+        "expectedUserId": { "type": "string" }
+      }
+    },
+    "configuration": {
+      "type": "object",
+      "additionalProperties": { "enum": ["explicit", "context", "environment", "workspace", "convention"] }
+    },
+    "status": { "enum": ["ready", "partial"] },
+    "missing": { "type": "array", "items": { "type": "string" } },
+    "hash": { "type": "string", "minLength": 1 }
+  }
+}

package/docs/schemas/agent-enhancement-plan.schema.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/agent-enhancement-plan.schema.json",
+  "title": "dingtalk-agent Agent Enhancement Plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema", "planId", "ready", "status", "sideEffect", "dingtalkSideEffect",
+    "triggerSideEffect", "root", "source", "projectName", "roleSkills", "bindings",
+    "baselineHash", "desiredHash", "operations", "blockers", "warnings",
+    "semanticReview", "apply", "verification"
+  ],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/agent-enhancement-plan@1" },
+    "planId": { "type": "string", "pattern": "^aep_[a-f0-9]{32}$" },
+    "ready": { "type": "boolean" },
+    "status": { "enum": ["ready", "blocked"] },
+    "sideEffect": { "const": false },
+    "dingtalkSideEffect": { "const": false },
+    "triggerSideEffect": { "const": false },
+    "root": { "type": "string", "minLength": 1 },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "revision"],
+      "properties": {
+        "kind": { "enum": ["git-checkout", "local-folder"] },
+        "revision": { "type": "string" }
+      }
+    },
+    "projectName": { "type": "string" },
+    "roleSkills": {
+      "type": "array", "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "bindings": { "type": "string", "minLength": 1 },
+    "baselineHash": { "$ref": "#/$defs/hash" },
+    "desiredHash": { "$ref": "#/$defs/hash" },
+    "operations": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/operation" }
+    },
+    "blockers": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "warnings": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "semanticReview": {
+      "type": "object", "additionalProperties": false,
+      "required": ["required", "files", "why"],
+      "properties": {
+        "required": { "type": "boolean" },
+        "files": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+        "why": { "type": "string", "minLength": 1 }
+      }
+    },
+    "apply": {
+      "type": "object", "additionalProperties": false,
+      "required": ["command", "requiresCurrentPlanId"],
+      "properties": {
+        "command": { "type": "string", "minLength": 1 },
+        "requiresCurrentPlanId": { "const": true }
+      }
+    },
+    "verification": {
+      "type": "object", "additionalProperties": false,
+      "required": ["commands"],
+      "properties": {
+        "commands": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+      }
+    }
+  },
+  "$defs": {
+    "name": { "type": "string", "pattern": "^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$" },
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "hashOrEmpty": { "type": "string", "pattern": "^(?:[a-f0-9]{64})?$" },
+    "operation": {
+      "type": "object", "additionalProperties": false,
+      "required": ["id", "kind", "path", "beforeHash", "afterHash", "backupRequired", "reason"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "kind": { "enum": ["create-file", "update-file", "create-directory", "replace-directory", "preserve"] },
+        "path": { "type": "string", "minLength": 1 },
+        "beforeHash": { "$ref": "#/$defs/hashOrEmpty" },
+        "afterHash": { "$ref": "#/$defs/hash" },
+        "backupRequired": { "type": "boolean" },
+        "reason": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/docs/schemas/agent-enhancement-receipt.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/agent-enhancement-receipt.schema.json",
+  "title": "dingtalk-agent Agent Enhancement Receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema", "status", "operationId", "planId", "sideEffect", "dingtalkSideEffect",
+    "triggerSideEffect", "root", "backupRoot", "idempotent", "changes", "audit"
+  ],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/agent-enhancement-receipt@1" },
+    "status": { "const": "applied" },
+    "operationId": { "type": "string", "pattern": "^agent_enhance_[0-9]+_[a-f0-9]{8}$" },
+    "planId": { "type": "string", "pattern": "^aep_[a-f0-9]{32}$" },
+    "sideEffect": { "const": "local-files-only" },
+    "dingtalkSideEffect": { "const": false },
+    "triggerSideEffect": { "const": false },
+    "root": { "type": "string", "minLength": 1 },
+    "backupRoot": { "type": "string" },
+    "idempotent": { "type": "boolean" },
+    "changes": {
+      "type": "array",
+      "items": { "$ref": "agent-enhancement-plan.schema.json#/$defs/operation" }
+    },
+    "audit": {
+      "type": "object", "additionalProperties": false,
+      "required": ["status", "ready", "missing", "commands"],
+      "properties": {
+        "status": { "enum": ["ready", "partial"] },
+        "ready": { "type": "boolean" },
+        "missing": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+        "commands": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+      }
+    }
+  }
+}

package/docs/schemas/enriched-invocation.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dingtalk-agent.dev/schemas/enriched-invocation.schema.json",
+  "title": "EnrichedInvocation",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "invocation", "message", "enrichments", "missing", "hash"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/enriched-invocation@1" },
+    "invocation": { "type": "object" },
+    "message": {
+      "type": "object",
+      "required": ["originalText", "effectiveText"],
+      "properties": {
+        "originalText": { "type": "string" },
+        "effectiveText": { "type": "string" }
+      }
+    },
+    "enrichments": {
+      "type": "object",
+      "required": ["quote", "burst", "identity"],
+      "properties": {
+        "quote": { "$ref": "#/$defs/item" },
+        "burst": { "$ref": "#/$defs/item" },
+        "identity": { "$ref": "#/$defs/item" }
+      }
+    },
+    "missing": { "type": "array", "items": { "type": "string" } },
+    "hash": { "type": "string" }
+  },
+  "$defs": {
+    "item": {
+      "type": "object",
+      "required": ["status", "source", "fetchedAt", "confidence", "truncated", "reason", "data"],
+      "properties": {
+        "status": { "enum": ["available", "missing", "rejected"] },
+        "source": { "type": "string" },
+        "fetchedAt": { "type": ["string", "null"] },
+        "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+        "truncated": { "type": "boolean" },
+        "reason": { "type": "string" },
+        "data": { "type": ["object", "null"] }
+      }
+    }
+  }
+}

package/docs/schemas/eval-candidate-plan.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/eval-candidate-plan.schema.json",
+  "title": "dingtalk-agent Eval Candidate Plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "candidateId", "promotionId", "observedHash", "observationHash", "candidatePath", "writeBudget", "reviewRequired", "eligibleForSuite", "remoteRead", "remoteWrite", "localWrite", "triggerWrite", "sideEffect", "dingtalkSideEffect"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/eval-candidate-plan@1" },
+    "candidateId": { "$ref": "promotion-plan.schema.json#/$defs/id" },
+    "promotionId": { "$ref": "promotion-plan.schema.json#/$defs/id" },
+    "observedHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" },
+    "observationHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" },
+    "candidatePath": { "type": "string", "minLength": 1 },
+    "writeBudget": {
+      "type": "object", "additionalProperties": false, "required": ["local"],
+      "properties": { "local": { "const": 1 } }
+    },
+    "reviewRequired": { "const": true },
+    "eligibleForSuite": { "const": false },
+    "remoteRead": { "const": false },
+    "remoteWrite": { "const": false },
+    "localWrite": { "const": false },
+    "triggerWrite": { "const": false },
+    "sideEffect": { "const": false },
+    "dingtalkSideEffect": { "const": false }
+  }
+}

package/docs/schemas/eval-candidate-result.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/eval-candidate-result.schema.json",
+  "title": "dingtalk-agent Eval Candidate Result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "applied", "idempotent", "candidate", "remoteRead", "remoteWrite", "localWrite", "triggerWrite", "sideEffect", "dingtalkSideEffect"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/eval-candidate-result@1" },
+    "applied": { "type": "boolean" },
+    "idempotent": { "type": "boolean" },
+    "candidate": { "$ref": "eval-candidate.schema.json" },
+    "remoteRead": { "const": false },
+    "remoteWrite": { "const": false },
+    "localWrite": { "type": "boolean" },
+    "triggerWrite": { "const": false },
+    "sideEffect": { "enum": [false, "local-eval-candidate"] },
+    "dingtalkSideEffect": { "const": false }
+  }
+}

package/docs/schemas/eval-candidate.schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/eval-candidate.schema.json",
+  "title": "dingtalk-agent Review-only Eval Candidate",
+  "type": "object", "additionalProperties": false,
+  "required": ["$schema", "candidateId", "status", "eligibleForSuite", "reviewRequired", "published", "promotion", "source", "eval", "target", "observation", "observationHash", "candidateHash", "evidencePath", "remoteRead", "remoteWrite", "localWrite", "triggerWrite", "sideEffect", "dingtalkSideEffect"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/eval-candidate@1" },
+    "candidateId": { "$ref": "promotion-plan.schema.json#/$defs/id" },
+    "status": { "const": "proposed" }, "eligibleForSuite": { "const": false },
+    "reviewRequired": { "const": true }, "published": { "const": false },
+    "promotion": { "type": "object", "additionalProperties": false, "required": ["promotionId", "receiptId", "receiptHash", "linkHash"], "properties": {
+      "promotionId": { "$ref": "promotion-plan.schema.json#/$defs/id" }, "receiptId": { "$ref": "promotion-plan.schema.json#/$defs/id" },
+      "receiptHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" }, "linkHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" }
+    } },
+    "source": { "$ref": "promotion-plan.schema.json#/$defs/source" },
+    "eval": { "type": "object", "additionalProperties": false, "required": ["runId", "evidenceHash", "suiteId"], "properties": {
+      "runId": { "type": "string" }, "evidenceHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" }, "suiteId": { "type": "string" }
+    } },
+    "target": { "type": "object", "additionalProperties": false, "required": ["workspace", "deploymentReceiptId", "deploymentHash", "observedHash"], "properties": {
+      "workspace": { "$ref": "promotion-plan.schema.json#/$defs/name" }, "deploymentReceiptId": { "$ref": "promotion-plan.schema.json#/$defs/id" },
+      "deploymentHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" }, "observedHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" }
+    } },
+    "observation": { "$ref": "observation.schema.json" },
+    "observationHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" }, "candidateHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" },
+    "evidencePath": { "type": "string", "minLength": 1 },
+    "remoteRead": { "const": false }, "remoteWrite": { "const": false }, "localWrite": { "const": true },
+    "triggerWrite": { "const": false }, "sideEffect": { "const": "local-eval-candidate" }, "dingtalkSideEffect": { "const": false }
+  }
+}

package/docs/schemas/invocation.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dingtalk-agent.dev/schemas/invocation.schema.json",
+  "title": "dingtalk-agent InvocationContext",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "mode", "authority", "eventId", "sessionKey", "occurredAt", "actor", "target", "conversation"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/invocation@1" },
+    "mode": { "enum": ["direct", "dm", "mention", "ambient", "heartbeat", "continuation"] },
+    "authority": { "enum": ["default", "host", "event"] },
+    "eventId": { "type": "string" },
+    "sessionKey": { "type": "string" },
+    "occurredAt": { "type": ["string", "null"] },
+    "actor": { "type": ["object", "null"] },
+    "target": { "type": ["object", "null"] },
+    "conversation": { "type": ["object", "null"] }
+  }
+}

package/docs/schemas/memory-candidate-proposal.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dingtalk-agent.dev/schemas/memory-candidate-proposal.schema.json",
+  "title": "dingtalk-agent Memory Candidate Proposal",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "kind", "scopeId", "title", "content", "sourceRefs", "confidence", "supersedes"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/memory-candidate-proposal@1" },
+    "kind": { "enum": ["semantic", "procedural"] },
+    "scopeId": { "type": "string", "minLength": 1 },
+    "title": { "type": "string", "minLength": 1 },
+    "content": { "type": "string", "minLength": 1, "maxLength": 32768 },
+    "sourceRefs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+    "supersedes": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+  }
+}

package/docs/schemas/memory-candidate.schema.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dingtalk-agent.dev/schemas/memory-candidate.schema.json",
+  "title": "dingtalk-agent Memory Candidate Lifecycle",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema", "id", "revision", "kind", "scopeId", "title", "content", "sourceRefs",
+    "confidence", "supersedes", "status", "proposedAt", "proposer", "review", "publication", "hash"
+  ],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/memory-candidate@1" },
+    "id": { "type": "string", "pattern": "^memcand_[a-f0-9]{24}$" },
+    "revision": { "type": "integer", "minimum": 1 },
+    "kind": { "enum": ["semantic", "procedural"] },
+    "scopeId": { "type": "string", "minLength": 1 },
+    "title": { "type": "string", "minLength": 1 },
+    "content": { "type": "string", "minLength": 1 },
+    "sourceRefs": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+    "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+    "supersedes": { "type": "array", "items": { "type": "string" } },
+    "status": { "enum": ["proposed", "approved", "rejected", "published"] },
+    "proposedAt": { "type": "string", "format": "date-time" },
+    "proposer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "runId", "eventId", "definitionHash"],
+      "properties": {
+        "mode": { "enum": ["prepared", "direct"] },
+        "runId": { "type": "string" },
+        "eventId": { "type": "string" },
+        "definitionHash": { "type": "string" }
+      }
+    },
+    "review": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["decision", "reviewer", "reason", "reviewedAt"],
+          "properties": {
+            "decision": { "enum": ["approve", "reject"] },
+            "reviewer": { "type": "string", "minLength": 1 },
+            "reason": { "type": "string", "minLength": 1 },
+            "reviewedAt": { "type": "string", "format": "date-time" }
+          }
+        }
+      ]
+    },
+    "publication": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "provider", "uri", "targetHashBefore", "targetHashAfter", "verification",
+            "concurrency", "publishedAt", "gitHead"
+          ],
+          "properties": {
+            "provider": { "enum": ["local-md", "dingtalk-doc"] },
+            "uri": { "type": "string" },
+            "targetHashBefore": { "type": "string" },
+            "targetHashAfter": { "type": "string" },
+            "verification": { "type": "string" },
+            "concurrency": { "enum": ["atomic-local-cas", "best-effort-read-check-append"] },
+            "publishedAt": { "type": "string", "format": "date-time" },
+            "gitHead": { "type": "string" }
+          }
+        }
+      ]
+    },
+    "hash": { "type": "string", "minLength": 1 }
+  }
+}

package/docs/schemas/memory-publish-target.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dingtalk-agent.dev/schemas/memory-publish-target.schema.json",
+  "title": "dingtalk-agent Memory Publish Target",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "provider", "uri"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/memory-publish-target@1" },
+    "provider": { "enum": ["local-md", "dingtalk-doc"] },
+    "uri": { "type": "string", "minLength": 1 },
+    "profile": { "type": "string" },
+    "expectedUserId": { "type": "string" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "provider": { "const": "local-md" } } },
+      "then": { "properties": { "uri": { "pattern": "^local-md:.+" } } }
+    },
+    {
+      "if": { "properties": { "provider": { "const": "dingtalk-doc" } } },
+      "then": { "properties": { "uri": { "pattern": "^dingtalk-doc:.+" } } }
+    }
+  ]
+}