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

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" } }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/multica-workspace-plan.schema.json",
+  "title": "dingtalk-agent Multica Workspace Read-only Plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema", "planId", "workspace", "provider", "profile", "desiredHash",
+    "currentState", "expected", "observed", "diff", "blocking", "operations",
+    "writes", "remoteRead", "remoteWrite", "sideEffect", "dingtalkSideEffect"
+  ],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/multica-workspace-plan@1" },
+    "planId": { "type": "string", "pattern": "^multica_plan_[a-f0-9]{24}$" },
+    "workspace": { "$ref": "#/$defs/name" },
+    "provider": { "const": "multica" },
+    "profile": { "type": "string", "minLength": 1 },
+    "desiredHash": { "$ref": "#/$defs/hash" },
+    "currentState": { "type": "string", "minLength": 1 },
+    "expected": { "$ref": "#/$defs/expected" },
+    "observed": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["workspaceId", "runtimeId", "agentId", "skillSetHash"],
+      "properties": {
+        "workspaceId": { "type": "string" },
+        "runtimeId": { "type": "string" },
+        "agentId": { "type": "string" },
+        "skillSetHash": { "type": "string" }
+      }
+    },
+    "diff": { "type": "array", "items": { "type": "string" } },
+    "blocking": { "type": "array", "items": { "type": "string" } },
+    "operations": {
+      "type": "array",
+      "minItems": 8,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "argv"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "argv": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    },
+    "writes": { "type": "array", "maxItems": 0 },
+    "remoteRead": { "const": false },
+    "remoteWrite": { "const": false },
+    "sideEffect": { "const": false },
+    "dingtalkSideEffect": { "const": false }
+  },
+  "$defs": {
+    "name": { "type": "string", "pattern": "^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$" },
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "expected": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["workspaceId", "runtimeId", "agentId", "skills"],
+      "properties": {
+        "workspaceId": { "type": "string" },
+        "runtimeId": { "type": "string" },
+        "agentId": { "type": "string" },
+        "skills": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/name" } }
+      }
+    }
+  }
+}

package/docs/schemas/multica-workspace-resource-list.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/multica-workspace-resource-list.schema.json",
+  "title": "dingtalk-agent Multica Workspace Redacted Resource List",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema", "passed", "workspace", "provider", "profile", "inspectionId",
+    "resources", "failures", "calls", "remoteRead", "remoteWrite", "sideEffect",
+    "dingtalkSideEffect"
+  ],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/multica-workspace-resource-list@1" },
+    "passed": { "type": "boolean" },
+    "workspace": { "type": "string", "minLength": 1 },
+    "provider": { "const": "multica" },
+    "profile": { "type": "string", "minLength": 1 },
+    "inspectionId": { "type": "string", "pattern": "^multica_inspect_[a-f0-9]{24}$" },
+    "resources": { "type": "object" },
+    "failures": { "type": "array", "items": { "type": "string" } },
+    "calls": { "type": "array", "items": { "type": "object" } },
+    "remoteRead": { "const": true },
+    "remoteWrite": { "const": false },
+    "sideEffect": { "const": "remote-read" },
+    "dingtalkSideEffect": { "const": false }
+  }
+}

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

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/multica-workspace-status.schema.json",
+  "title": "dingtalk-agent Multica Workspace Local Status",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema", "workspace", "provider", "available", "inspectionId", "passed",
+    "readyForApply", "providerReady", "evidencePath", "evidenceIntegrity", "stateMatched",
+    "desiredHash", "observedHash", "diff", "failures", "remoteRead", "remoteWrite",
+    "sideEffect", "dingtalkSideEffect"
+  ],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/multica-workspace-status@1" },
+    "workspace": { "type": "string", "minLength": 1 },
+    "provider": { "const": "multica" },
+    "available": { "type": "boolean" },
+    "inspectionId": { "type": "string" },
+    "passed": { "type": "boolean" },
+    "readyForApply": { "type": "boolean" },
+    "providerReady": { "const": false },
+    "evidencePath": { "type": "string" },
+    "evidenceIntegrity": { "type": "boolean" },
+    "stateMatched": { "type": "boolean" },
+    "desiredHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "observedHash": { "type": "string" },
+    "diff": { "type": "array", "items": { "type": "string" } },
+    "failures": { "type": "array", "items": { "type": "string" } },
+    "remoteRead": { "const": false },
+    "remoteWrite": { "const": false },
+    "sideEffect": { "const": false },
+    "dingtalkSideEffect": { "const": false }
+  }
+}

package/docs/schemas/observation.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/observation.schema.json",
+  "title": "dingtalk-agent Redacted Observation",
+  "type": "object", "additionalProperties": false,
+  "required": ["$schema", "observedAt", "observedHash", "category", "risk", "capability", "outcome", "summary", "expected", "actual", "sourceRefs", "redacted"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/observation@1" },
+    "observedAt": { "type": "string", "format": "date-time" },
+    "observedHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" },
+    "category": { "enum": ["behavior", "safety", "reliability", "quality"] },
+    "risk": { "enum": ["low", "medium", "high", "critical"] },
+    "capability": { "type": "string", "minLength": 1, "maxLength": 100 },
+    "outcome": { "enum": ["pass", "fail", "mixed", "unknown"] },
+    "summary": { "type": "string", "minLength": 1, "maxLength": 500 },
+    "expected": { "type": "string", "minLength": 1, "maxLength": 1000 },
+    "actual": { "type": "string", "minLength": 1, "maxLength": 1000 },
+    "sourceRefs": { "type": "array", "maxItems": 10, "items": { "type": "string", "minLength": 1, "maxLength": 200 } },
+    "redacted": { "const": true }
+  }
+}

package/docs/schemas/operational-memory-provider.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dingtalk-agent.dev/schemas/operational-memory-provider.schema.json",
+  "title": "dingtalk-agent Operational Memory Provider",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "provider", "baseId", "tableId", "fields"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/operational-memory-provider@1" },
+    "provider": { "const": "dingtalk-aitable" },
+    "baseId": { "type": "string", "minLength": 1 },
+    "tableId": { "type": "string", "minLength": 1 },
+    "profile": { "type": "string" },
+    "expectedUserId": { "type": "string" },
+    "fields": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "key", "scopeId", "kind", "subjectId", "summary", "sourceRefs", "occurredAt",
+        "recordedAt", "confidence", "attributes"
+      ],
+      "properties": {
+        "key": { "type": "string", "minLength": 1 },
+        "scopeId": { "type": "string", "minLength": 1 },
+        "kind": { "type": "string", "minLength": 1 },
+        "subjectId": { "type": "string", "minLength": 1 },
+        "summary": { "type": "string", "minLength": 1 },
+        "sourceRefs": { "type": "string", "minLength": 1 },
+        "occurredAt": { "type": "string", "minLength": 1 },
+        "recordedAt": { "type": "string", "minLength": 1 },
+        "confidence": { "type": "string", "minLength": 1 },
+        "attributes": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/docs/schemas/operational-memory-record.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dingtalk-agent.dev/schemas/operational-memory-record.schema.json",
+  "title": "dingtalk-agent Operational Memory Record",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema", "key", "scopeId", "kind", "subjectId", "summary", "sourceRefs",
+    "occurredAt", "recordedAt", "confidence", "attributes"
+  ],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/operational-memory-record@1" },
+    "key": { "type": "string", "minLength": 1 },
+    "scopeId": { "type": "string", "minLength": 1 },
+    "kind": { "enum": ["summary", "interaction", "task", "calendar", "fact"] },
+    "subjectId": { "type": "string", "minLength": 1 },
+    "summary": { "type": "string", "minLength": 1 },
+    "sourceRefs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "occurredAt": { "type": ["string", "null"], "format": "date-time" },
+    "recordedAt": { "type": "string" },
+    "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+    "attributes": { "type": "object" }
+  }
+}

package/docs/schemas/perception-input.schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dingtalk-agent.dev/schemas/perception-input.schema.json",
+  "title": "Trusted Perception Input",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/perception-input@1" },
+    "fetchedAt": { "type": "string", "format": "date-time" },
+    "quote": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["conversationId", "messageId", "text", "source"],
+      "properties": {
+        "conversationId": { "type": "string" },
+        "messageId": { "type": "string" },
+        "text": { "type": "string" },
+        "occurredAt": { "type": "string" },
+        "author": { "type": "object" },
+        "source": { "enum": ["host-event", "dws-readback"] }
+      }
+    },
+    "recentMessages": {
+      "type": "array",
+      "maxItems": 50,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["conversationId", "messageId", "actorId", "text", "source"],
+        "properties": {
+          "conversationId": { "type": "string" },
+          "messageId": { "type": "string" },
+          "actorId": { "type": "string" },
+          "actorName": { "type": "string" },
+          "text": { "type": "string" },
+          "occurredAt": { "type": "string" },
+          "source": { "enum": ["host-event", "dws-readback"] }
+        }
+      }
+    },
+    "identity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["subjectId", "displayName", "source"],
+      "properties": {
+        "subjectId": { "type": "string" },
+        "displayName": { "type": "string" },
+        "userId": { "type": "string" },
+        "openDingTalkId": { "type": "string" },
+        "department": { "type": "string" },
+        "title": { "type": "string" },
+        "source": { "enum": ["host-event", "dws-contact"] }
+      }
+    }
+  }
+}