@xdxer/dingtalk-agent 0.1.4-beta.8 → 0.1.4-beta.9

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:.+" } } }
+    }
+  ]
+}

package/docs/schemas/multica-deployment-list.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/multica-deployment-list.schema.json",
+  "title": "dingtalk-agent Multica Deployment List",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "workspace", "provider", "deployments", "remoteRead", "remoteWrite", "triggerWrite", "sideEffect", "dingtalkSideEffect"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/multica-deployment-list@1" },
+    "workspace": { "type": "string", "minLength": 1 }, "provider": { "const": "multica" },
+    "deployments": {
+      "type": "array",
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["receiptId", "operationId", "action", "status", "passed", "providerReady", "planId", "deploymentHash"],
+        "properties": {
+          "receiptId": { "type": "string" }, "operationId": { "type": "string" },
+          "action": { "enum": ["apply", "retire"] },
+          "status": { "enum": ["applying", "reconciling", "verifying", "ready", "failed", "retired"] },
+          "passed": { "type": "boolean" }, "providerReady": { "type": "boolean" },
+          "planId": { "type": "string" }, "deploymentHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+        }
+      }
+    },
+    "remoteRead": { "const": false }, "remoteWrite": { "const": false },
+    "triggerWrite": { "const": false }, "sideEffect": { "const": false },
+    "dingtalkSideEffect": { "const": false }
+  }
+}

package/docs/schemas/multica-deployment-operation.schema.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/multica-deployment-operation.schema.json",
+  "title": "dingtalk-agent Multica Deployment Operation",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "operationId", "planId", "workspace", "action", "status", "profile", "workspaceId", "runtimeId", "agentId", "deploymentHash", "ambiguousAction", "receiptId", "receiptPath", "calls", "failures", "updatedAt"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/multica-deployment-operation@1" },
+    "operationId": { "$ref": "#/$defs/id" },
+    "planId": { "$ref": "#/$defs/id" },
+    "workspace": { "$ref": "#/$defs/name" },
+    "action": { "enum": ["apply", "retire"] },
+    "status": { "$ref": "#/$defs/status" },
+    "profile": { "type": "string", "minLength": 1 },
+    "workspaceId": { "type": "string", "minLength": 1 },
+    "runtimeId": { "type": "string", "minLength": 1 },
+    "agentId": { "type": "string" },
+    "deploymentHash": { "$ref": "#/$defs/hash" },
+    "ambiguousAction": { "type": "string" },
+    "receiptId": { "type": "string" },
+    "receiptPath": { "type": "string" },
+    "calls": { "$ref": "#/$defs/calls" },
+    "failures": { "type": "array", "items": { "type": "string" } },
+    "updatedAt": { "type": "string", "format": "date-time" }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{1,127}$" },
+    "name": { "type": "string", "pattern": "^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$" },
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "status": { "enum": ["applying", "reconciling", "verifying", "ready", "failed", "retired"] },
+    "calls": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "kind", "argv", "exitCode", "stdoutHash", "stderrHash", "passed", "ambiguous"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "kind": { "enum": ["read", "write", "rollback"] },
+          "argv": { "type": "array", "items": { "type": "string" } },
+          "exitCode": { "type": "integer" },
+          "stdoutHash": { "$ref": "#/$defs/hash" },
+          "stderrHash": { "$ref": "#/$defs/hash" },
+          "passed": { "type": "boolean" },
+          "ambiguous": { "type": "boolean" }
+        }
+      }
+    }
+  }
+}

package/docs/schemas/multica-deployment-plan.schema.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/multica-deployment-plan.schema.json",
+  "title": "dingtalk-agent Multica Deployment Plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "planId", "action", "workspace", "provider", "profile", "inspectionId", "desiredHash", "deploymentHash", "expected", "operations", "writeBudget", "blocking", "requiresPlanId", "requiresExplicitYes", "remoteRead", "remoteWrite", "triggerWrite", "sideEffect", "dingtalkSideEffect"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/multica-deployment-plan@1" },
+    "planId": { "$ref": "#/$defs/id" },
+    "action": { "enum": ["apply", "retire"] },
+    "workspace": { "$ref": "#/$defs/name" },
+    "provider": { "const": "multica" },
+    "profile": { "type": "string", "minLength": 1 },
+    "inspectionId": { "type": "string" },
+    "desiredHash": { "$ref": "#/$defs/hash" },
+    "deploymentHash": { "$ref": "#/$defs/hash" },
+    "expected": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["workspaceId", "runtimeId", "agentId", "agentName", "skills", "definitionHash", "instructionsHash"],
+      "properties": {
+        "workspaceId": { "type": "string", "minLength": 1 },
+        "runtimeId": { "type": "string", "minLength": 1 },
+        "agentId": { "type": "string" },
+        "agentName": { "type": "string", "minLength": 1 },
+        "skills": {
+          "type": "array",
+          "minItems": 2,
+          "uniqueItems": true,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name", "hash", "files"],
+            "properties": {
+              "name": { "$ref": "#/$defs/name" },
+              "hash": { "$ref": "#/$defs/hash" },
+              "files": { "type": "integer", "minimum": 1 }
+            }
+          }
+        },
+        "definitionHash": { "$ref": "#/$defs/hash" },
+        "instructionsHash": { "$ref": "#/$defs/hash" }
+      }
+    },
+    "operations": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+    "writeBudget": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["forward", "rollback"],
+      "properties": {
+        "forward": { "type": "integer", "minimum": 0 },
+        "rollback": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "blocking": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "requiresPlanId": { "const": true },
+    "requiresExplicitYes": { "const": true },
+    "remoteRead": { "const": false },
+    "remoteWrite": { "const": false },
+    "triggerWrite": { "const": false },
+    "sideEffect": { "const": false },
+    "dingtalkSideEffect": { "const": false }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{1,127}$" },
+    "name": { "type": "string", "pattern": "^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$" },
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}

package/docs/schemas/multica-deployment-receipt.schema.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/multica-deployment-receipt.schema.json",
+  "title": "dingtalk-agent Multica Deployment Receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "receiptId", "operationId", "planId", "action", "workspace", "provider", "profile", "status", "passed", "providerReady", "idempotent", "inspectionId", "inspectionObservedHash", "inspectionEvidencePath", "desiredHash", "deploymentHash", "observedHash", "agent", "skills", "assignmentHash", "calls", "smoke", "rollback", "failures", "evidencePath", "remoteRead", "remoteWrite", "triggerWrite", "sideEffect", "dingtalkSideEffect"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/multica-deployment-receipt@1" },
+    "receiptId": { "$ref": "#/$defs/id" },
+    "operationId": { "$ref": "#/$defs/id" },
+    "planId": { "$ref": "#/$defs/id" },
+    "action": { "enum": ["apply", "retire"] },
+    "workspace": { "$ref": "#/$defs/name" },
+    "provider": { "const": "multica" },
+    "profile": { "type": "string", "minLength": 1 },
+    "status": { "$ref": "#/$defs/status" },
+    "passed": { "type": "boolean" },
+    "providerReady": { "type": "boolean" },
+    "idempotent": { "type": "boolean" },
+    "inspectionId": { "type": "string" },
+    "inspectionObservedHash": { "type": "string" },
+    "inspectionEvidencePath": { "type": "string" },
+    "desiredHash": { "$ref": "#/$defs/hash" },
+    "deploymentHash": { "$ref": "#/$defs/hash" },
+    "observedHash": { "type": "string" },
+    "agent": {
+      "type": "object", "additionalProperties": false,
+      "required": ["id", "runtimeId", "instructionsHash", "archived", "action"],
+      "properties": {
+        "id": { "type": "string" }, "runtimeId": { "type": "string" },
+        "instructionsHash": { "type": "string" }, "archived": { "type": "boolean" },
+        "action": { "enum": ["create", "update", "restore", "archive", "noop", "unknown"] }
+      }
+    },
+    "skills": {
+      "type": "array",
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["id", "name", "sourceHash", "remoteHash", "action"],
+        "properties": {
+          "id": { "type": "string" }, "name": { "$ref": "#/$defs/name" },
+          "sourceHash": { "$ref": "#/$defs/hash" }, "remoteHash": { "type": "string" },
+          "action": { "enum": ["create", "update", "noop", "unknown"] }
+        }
+      }
+    },
+    "assignmentHash": { "type": "string" },
+    "calls": { "$ref": "multica-deployment-operation.schema.json#/$defs/calls" },
+    "smoke": {
+      "type": "object", "additionalProperties": false,
+      "required": ["status", "marker", "markerHash", "issueId", "taskId", "taskStatus", "requiredSkills", "loadedSkills", "toolTracePassed", "responsePassed", "responseHash", "failures"],
+      "properties": {
+        "status": { "enum": ["not-run", "pending", "passed", "failed"] },
+        "marker": { "type": "string" }, "markerHash": { "type": "string" },
+        "issueId": { "type": "string" }, "taskId": { "type": "string" },
+        "taskStatus": { "type": "string" },
+        "requiredSkills": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/name" } },
+        "loadedSkills": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/name" } },
+        "toolTracePassed": { "type": "boolean" }, "responsePassed": { "type": "boolean" },
+        "responseHash": { "type": "string" },
+        "failures": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "rollback": {
+      "type": "object", "additionalProperties": false,
+      "required": ["attempted", "passed", "actions", "failures"],
+      "properties": {
+        "attempted": { "type": "boolean" }, "passed": { "type": "boolean" },
+        "actions": { "type": "array", "items": { "type": "string" } },
+        "failures": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "failures": { "type": "array", "items": { "type": "string" } },
+    "evidencePath": { "type": "string", "minLength": 1 },
+    "remoteRead": { "const": true }, "remoteWrite": { "type": "boolean" },
+    "triggerWrite": { "const": false },
+    "sideEffect": { "enum": ["multica-read-write", "multica-read", "none"] },
+    "dingtalkSideEffect": { "const": false }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{1,127}$" },
+    "name": { "type": "string", "pattern": "^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$" },
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "status": { "enum": ["applying", "reconciling", "verifying", "ready", "failed", "retired"] }
+  }
+}

package/docs/schemas/multica-deployment-status.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/multica-deployment-status.schema.json",
+  "title": "dingtalk-agent Multica Deployment Status",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "workspace", "provider", "available", "operationId", "receiptId", "status", "passed", "providerReady", "operationIntegrity", "receiptIntegrity", "reconciled", "failures", "receipt", "remoteRead", "remoteWrite", "triggerWrite", "sideEffect", "dingtalkSideEffect"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/multica-deployment-status@1" },
+    "workspace": { "type": "string", "minLength": 1 }, "provider": { "const": "multica" },
+    "available": { "type": "boolean" }, "operationId": { "type": "string" },
+    "receiptId": { "type": "string" },
+    "status": { "enum": ["missing", "applying", "reconciling", "verifying", "ready", "failed", "retired"] },
+    "passed": { "type": "boolean" }, "providerReady": { "type": "boolean" },
+    "operationIntegrity": { "type": "boolean" }, "receiptIntegrity": { "type": "boolean" },
+    "reconciled": { "type": "boolean" },
+    "failures": { "type": "array", "items": { "type": "string" } },
+    "receipt": { "oneOf": [{ "type": "null" }, { "$ref": "multica-deployment-receipt.schema.json" }] },
+    "remoteRead": { "type": "boolean" }, "remoteWrite": { "const": false },
+    "triggerWrite": { "const": false }, "sideEffect": { "enum": [false, "multica-read"] },
+    "dingtalkSideEffect": { "const": false }
+  }
+}

package/docs/schemas/multica-workspace-inspection.schema.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/multica-workspace-inspection.schema.json",
+  "title": "dingtalk-agent Multica Workspace Redacted Inspection",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema", "passed", "readyForApply", "providerReady", "inspectionId",
+    "workspace", "provider", "profile", "cliVersion", "desiredHash", "observedHash",
+    "expected", "auth", "resources", "diff", "failures", "calls", "evidencePath",
+    "remoteRead", "remoteWrite", "sideEffect", "dingtalkSideEffect"
+  ],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/multica-workspace-inspection@1" },
+    "passed": { "type": "boolean" },
+    "readyForApply": { "type": "boolean" },
+    "providerReady": { "const": false },
+    "inspectionId": { "type": "string", "pattern": "^multica_inspect_[a-f0-9]{24}$" },
+    "workspace": { "type": "string", "minLength": 1 },
+    "provider": { "const": "multica" },
+    "profile": { "type": "string", "minLength": 1 },
+    "cliVersion": { "type": "string" },
+    "desiredHash": { "$ref": "#/$defs/hash" },
+    "observedHash": { "$ref": "#/$defs/hash" },
+    "expected": { "type": "object" },
+    "auth": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["authenticated", "principalHash", "serverHash"],
+      "properties": {
+        "authenticated": { "type": "boolean" },
+        "principalHash": { "type": "string" },
+        "serverHash": { "type": "string" }
+      }
+    },
+    "resources": { "$ref": "#/$defs/resources" },
+    "diff": { "type": "array", "items": { "type": "string" } },
+    "failures": { "type": "array", "items": { "type": "string" } },
+    "calls": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "argv", "exitCode", "stdoutHash", "stderrHash", "passed"],
+        "properties": {
+          "id": { "type": "string" },
+          "argv": { "type": "array", "items": { "type": "string" } },
+          "exitCode": { "type": "integer" },
+          "stdoutHash": { "$ref": "#/$defs/hash" },
+          "stderrHash": { "$ref": "#/$defs/hash" },
+          "passed": { "type": "boolean" }
+        }
+      }
+    },
+    "evidencePath": { "type": "string", "minLength": 1 },
+    "remoteRead": { "const": true },
+    "remoteWrite": { "const": false },
+    "sideEffect": { "const": "remote-read" },
+    "dingtalkSideEffect": { "const": false }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "resources": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["workspace", "runtime", "agent", "agentCandidates", "catalogSkills", "assignedSkills"],
+      "properties": {
+        "workspace": { "type": ["object", "null"] },
+        "runtime": { "type": ["object", "null"] },
+        "agent": { "type": ["object", "null"] },
+        "agentCandidates": { "type": "array", "items": { "type": "object" } },
+        "catalogSkills": { "type": "array", "items": { "type": "object" } },
+        "assignedSkills": { "type": "array", "items": { "type": "object" } }
+      }
+    }
+  }
+}