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

package/docs/schemas/project.schema.json

@@ -0,0 +1,112 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/project.schema.json",
+  "title": "dingtalk-agent Agent Project",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "name", "dtaVersion", "agent", "workspaces"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/project@1" },
+    "name": { "$ref": "#/$defs/name" },
+    "dtaVersion": { "type": "string", "minLength": 1 },
+    "agent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["definition", "skills"],
+      "properties": {
+        "definition": { "type": "string", "minLength": 1 },
+        "skills": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "contains": { "const": "dingtalk-basic-behavior" },
+          "items": { "$ref": "#/$defs/name" }
+        }
+      }
+    },
+    "workspaces": {
+      "type": "object",
+      "propertyNames": {
+        "allOf": [
+          { "$ref": "#/$defs/name" },
+          { "not": { "const": "legacy-prepared" } }
+        ]
+      },
+      "additionalProperties": { "$ref": "#/$defs/workspace" }
+    }
+  },
+  "$defs": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$"
+    },
+    "envRef": {
+      "type": "string",
+      "pattern": "^env:[A-Z_][A-Z0-9_]*$"
+    },
+    "storage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["memory", "knowledge"],
+      "properties": {
+        "memory": { "type": "string", "pattern": "^(local-md|dingtalk-doc):.+$" },
+        "knowledge": { "type": "string", "pattern": "^(local-md|dingtalk-doc):.+$" },
+        "artifacts": { "type": "string", "pattern": "^local-dir:.+$" }
+      }
+    },
+    "authority": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["dwsProfileFrom", "expectedUserIdFrom"],
+      "properties": {
+        "dwsProfileFrom": { "$ref": "#/$defs/envRef" },
+        "expectedUserIdFrom": { "$ref": "#/$defs/envRef" }
+      }
+    },
+    "opencodeProvider": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "model"],
+      "properties": {
+        "kind": { "const": "opencode" },
+        "model": { "type": "string", "minLength": 1 }
+      }
+    },
+    "multicaProvider": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "profile", "workspaceIdFrom", "runtimeIdFrom"],
+      "properties": {
+        "kind": { "const": "multica" },
+        "profile": { "type": "string", "minLength": 1 },
+        "workspaceIdFrom": { "$ref": "#/$defs/envRef" },
+        "runtimeIdFrom": { "$ref": "#/$defs/envRef" },
+        "agentIdFrom": { "$ref": "#/$defs/envRef" }
+      }
+    },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "provider", "storage"],
+      "properties": {
+        "stage": { "enum": ["dev", "test", "staging", "prod"] },
+        "provider": {
+          "oneOf": [
+            { "$ref": "#/$defs/opencodeProvider" },
+            { "$ref": "#/$defs/multicaProvider" }
+          ]
+        },
+        "storage": { "$ref": "#/$defs/storage" },
+        "authority": { "$ref": "#/$defs/authority" }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": { "provider": { "properties": { "kind": { "const": "multica" } } } }
+          },
+          "then": { "required": ["authority"] }
+        }
+      ]
+    }
+  }
+}

package/docs/schemas/promotion-list.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/promotion-list.schema.json",
+  "title": "dingtalk-agent Promotion List",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "promotions", "remoteRead", "remoteWrite", "localWrite", "triggerWrite", "sideEffect", "dingtalkSideEffect"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/promotion-list@1" },
+    "promotions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["promotionId", "receiptId", "routeId", "status", "passed", "sourceHash", "evalEvidenceHash", "deploymentHash", "observedHash"],
+        "properties": {
+          "promotionId": { "$ref": "promotion-plan.schema.json#/$defs/id" },
+          "receiptId": { "$ref": "promotion-plan.schema.json#/$defs/id" },
+          "routeId": { "$ref": "promotion-plan.schema.json#/$defs/name" },
+          "status": { "enum": ["promoted", "verifying", "failed"] },
+          "passed": { "type": "boolean" },
+          "sourceHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" },
+          "evalEvidenceHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" },
+          "deploymentHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" },
+          "observedHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" }
+        }
+      }
+    },
+    "remoteRead": { "const": false },
+    "remoteWrite": { "const": false },
+    "localWrite": { "const": false },
+    "triggerWrite": { "const": false },
+    "sideEffect": { "const": false },
+    "dingtalkSideEffect": { "const": false }
+  }
+}

package/docs/schemas/promotion-plan.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/promotion-plan.schema.json",
+  "title": "dingtalk-agent Promotion Plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "planId", "routeId", "policyPath", "policyHash", "source", "eval", "target", "deployment", "blocking", "requiresPlanId", "requiresExplicitYes", "remoteRead", "remoteWrite", "localWrite", "triggerWrite", "sideEffect", "dingtalkSideEffect"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/promotion-plan@1" },
+    "planId": { "$ref": "#/$defs/id" }, "routeId": { "$ref": "#/$defs/name" },
+    "policyPath": { "type": "string", "minLength": 1 }, "policyHash": { "$ref": "#/$defs/hash" },
+    "source": { "$ref": "#/$defs/source" }, "eval": { "$ref": "#/$defs/eval" },
+    "target": { "$ref": "#/$defs/target" },
+    "deployment": { "$ref": "multica-deployment-plan.schema.json" },
+    "blocking": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "requiresPlanId": { "const": true }, "requiresExplicitYes": { "const": true },
+    "remoteRead": { "const": false }, "remoteWrite": { "const": false }, "localWrite": { "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}$" },
+    "source": {
+      "type": "object", "additionalProperties": false,
+      "required": ["workspace", "stage", "sourceHash", "desiredHash", "observedHash", "definitionHash", "skills"],
+      "properties": {
+        "workspace": { "$ref": "#/$defs/name" }, "stage": { "enum": ["dev", "test", "staging", "prod"] },
+        "sourceHash": { "$ref": "#/$defs/hash" }, "desiredHash": { "$ref": "#/$defs/hash" },
+        "observedHash": { "$ref": "#/$defs/hash" }, "definitionHash": { "$ref": "#/$defs/hash" },
+        "skills": { "type": "array", "minItems": 2, "items": { "type": "object", "additionalProperties": false, "required": ["name", "hash"], "properties": { "name": { "$ref": "#/$defs/name" }, "hash": { "$ref": "#/$defs/hash" } } } }
+      }
+    },
+    "eval": {
+      "type": "object", "additionalProperties": false,
+      "required": ["runId", "evidencePath", "evidenceHash", "planHash", "suiteHash", "reportHash", "suiteId", "model", "runs", "configurations", "caseIds", "requiredSurfaces", "loadGate", "hardGate", "falseCompletionGate", "behaviorGate"],
+      "properties": {
+        "runId": { "type": "string" }, "evidencePath": { "type": "string" },
+        "evidenceHash": { "$ref": "#/$defs/hash" }, "planHash": { "$ref": "#/$defs/hash" },
+        "suiteHash": { "$ref": "#/$defs/hash" }, "reportHash": { "$ref": "#/$defs/hash" },
+        "suiteId": { "type": "string" }, "model": { "type": "string" },
+        "runs": { "type": "integer", "minimum": 0, "maximum": 10 },
+        "configurations": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+        "caseIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/name" } },
+        "requiredSurfaces": { "type": "array", "uniqueItems": true, "items": { "enum": ["response", "filesystem", "workspace", "artifact"] } },
+        "loadGate": { "type": "boolean" }, "hardGate": { "type": "boolean" },
+        "falseCompletionGate": { "type": "boolean" }, "behaviorGate": { "type": "boolean" }
+      }
+    },
+    "target": {
+      "type": "object", "additionalProperties": false,
+      "required": ["workspace", "stage", "desiredHash", "deploymentHash", "deploymentPlanId"],
+      "properties": {
+        "workspace": { "$ref": "#/$defs/name" }, "stage": { "enum": ["dev", "test", "staging", "prod"] },
+        "desiredHash": { "$ref": "#/$defs/hash" }, "deploymentHash": { "$ref": "#/$defs/hash" },
+        "deploymentPlanId": { "$ref": "#/$defs/id" }
+      }
+    }
+  }
+}

package/docs/schemas/promotion-policy.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/promotion-policy.schema.json",
+  "title": "dingtalk-agent Promotion Policy",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "routes"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/promotion-policy@1" },
+    "routes": {
+      "type": "array", "minItems": 1, "maxItems": 32,
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["id", "fromWorkspace", "toWorkspace", "suite", "minimumRuns", "requiredCases", "requiredSurfaces", "requireBehaviorGate"],
+        "properties": {
+          "id": { "$ref": "#/$defs/name" },
+          "fromWorkspace": { "$ref": "#/$defs/name" },
+          "toWorkspace": { "$ref": "#/$defs/name" },
+          "suite": { "type": "string", "minLength": 1 },
+          "minimumRuns": { "type": "integer", "minimum": 1, "maximum": 10 },
+          "requiredCases": { "type": "array", "minItems": 1, "maxItems": 30, "uniqueItems": true, "items": { "$ref": "#/$defs/name" } },
+          "requiredSurfaces": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["response", "filesystem", "workspace", "artifact"] } },
+          "requireBehaviorGate": { "type": "boolean" }
+        }
+      }
+    }
+  },
+  "$defs": { "name": { "type": "string", "pattern": "^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$" } }
+}

package/docs/schemas/promotion-receipt.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/promotion-receipt.schema.json",
+  "title": "dingtalk-agent Promotion Receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "promotionId", "receiptId", "planId", "routeId", "policyHash", "status", "passed", "idempotent", "source", "eval", "target", "linkHash", "failures", "evidencePath", "remoteRead", "remoteWrite", "localWrite", "triggerWrite", "sideEffect", "dingtalkSideEffect"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/promotion-receipt@1" },
+    "promotionId": { "$ref": "promotion-plan.schema.json#/$defs/id" },
+    "receiptId": { "$ref": "promotion-plan.schema.json#/$defs/id" },
+    "planId": { "$ref": "promotion-plan.schema.json#/$defs/id" },
+    "routeId": { "$ref": "promotion-plan.schema.json#/$defs/name" },
+    "policyHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" },
+    "status": { "enum": ["promoted", "verifying", "failed"] }, "passed": { "type": "boolean" },
+    "idempotent": { "type": "boolean" },
+    "source": { "$ref": "promotion-plan.schema.json#/$defs/source" },
+    "eval": { "$ref": "promotion-plan.schema.json#/$defs/eval" },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["workspace", "stage", "desiredHash", "deploymentHash", "deploymentPlanId", "deploymentReceiptId", "deploymentOperationId", "deploymentReceiptPath", "deploymentReceiptHash", "observedHash"],
+      "properties": {
+        "workspace": { "$ref": "promotion-plan.schema.json#/$defs/name" },
+        "stage": { "enum": ["dev", "test", "staging", "prod"] },
+        "desiredHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" },
+        "deploymentHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" },
+        "deploymentPlanId": { "$ref": "promotion-plan.schema.json#/$defs/id" },
+        "deploymentReceiptId": { "$ref": "promotion-plan.schema.json#/$defs/id" },
+        "deploymentOperationId": { "$ref": "promotion-plan.schema.json#/$defs/id" },
+        "deploymentReceiptPath": { "type": "string", "minLength": 1 },
+        "deploymentReceiptHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" },
+        "observedHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" }
+      }
+    },
+    "linkHash": { "$ref": "promotion-plan.schema.json#/$defs/hash" },
+    "failures": { "type": "array", "items": { "type": "string" } },
+    "evidencePath": { "type": "string", "minLength": 1 },
+    "remoteRead": { "type": "boolean" }, "remoteWrite": { "type": "boolean" }, "localWrite": { "const": true },
+    "triggerWrite": { "const": false }, "sideEffect": { "enum": ["multica-read-write", "multica-read", "none"] },
+    "dingtalkSideEffect": { "const": false }
+  }
+}

package/docs/schemas/promotion-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/promotion-status.schema.json",
+  "title": "dingtalk-agent Promotion Status",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "available", "promotionId", "status", "passed", "integrity", "receipt", "remoteRead", "remoteWrite", "localWrite", "triggerWrite", "sideEffect", "dingtalkSideEffect"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/promotion-status@1" },
+    "available": { "type": "boolean" },
+    "promotionId": { "type": "string" },
+    "status": { "enum": ["promoted", "verifying", "failed", "missing"] },
+    "passed": { "type": "boolean" },
+    "integrity": { "type": "boolean" },
+    "receipt": { "oneOf": [{ "$ref": "promotion-receipt.schema.json" }, { "type": "null" }] },
+    "remoteRead": { "const": false },
+    "remoteWrite": { "const": false },
+    "localWrite": { "const": false },
+    "triggerWrite": { "const": false },
+    "sideEffect": { "const": false },
+    "dingtalkSideEffect": { "const": false }
+  }
+}

package/docs/schemas/release-readiness.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/release-readiness.schema.json",
+  "title": "dingtalk-agent Release Readiness",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "passed", "version", "tarball", "install", "smoke", "sideEffects", "limitations"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/release-readiness@1" },
+    "passed": { "const": true },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+-beta\\.\\d+$" },
+    "tarball": {
+      "type": "object", "additionalProperties": false,
+      "required": ["filename", "sha256", "files", "packageSize", "unpackedSize", "requiredFiles", "forbiddenFiles"],
+      "properties": {
+        "filename": { "type": "string", "pattern": "^[A-Za-z0-9._-]+\\.tgz$" },
+        "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "files": { "type": "integer", "minimum": 1 },
+        "packageSize": { "type": "integer", "minimum": 1 },
+        "unpackedSize": { "type": "integer", "minimum": 1 },
+        "requiredFiles": { "type": "integer", "minimum": 1 },
+        "forbiddenFiles": { "const": 0 }
+      }
+    },
+    "install": {
+      "type": "object", "additionalProperties": false,
+      "required": ["offlineTarball", "cliEntries", "versionMatched", "canonicalSkillCopies", "clientsReady"],
+      "properties": {
+        "offlineTarball": { "const": true },
+        "cliEntries": { "const": 2 },
+        "versionMatched": { "const": true },
+        "canonicalSkillCopies": { "const": 1 },
+        "clientsReady": { "const": 3 }
+      }
+    },
+    "smoke": {
+      "type": "object", "additionalProperties": false,
+      "required": ["setup", "doctor", "bootstrapDirect", "labEvalPlanOnly", "upgradeFromTarball", "rollbackDryRun"],
+      "properties": {
+        "setup": { "const": true },
+        "doctor": { "const": true },
+        "bootstrapDirect": { "const": true },
+        "labEvalPlanOnly": { "const": true },
+        "upgradeFromTarball": { "const": true },
+        "rollbackDryRun": { "const": true }
+      }
+    },
+    "sideEffects": {
+      "type": "object", "additionalProperties": false,
+      "required": ["registryPublish", "gitTag", "githubRelease", "dingtalk", "multica", "trigger"],
+      "properties": {
+        "registryPublish": { "const": false },
+        "gitTag": { "const": false },
+        "githubRelease": { "const": false },
+        "dingtalk": { "const": false },
+        "multica": { "const": false },
+        "trigger": { "const": false }
+      }
+    },
+    "limitations": {
+      "type": "array", "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    }
+  }
+}

package/docs/schemas/remote-semantic-state-live-eval.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dingtalk-agent.dev/schemas/remote-semantic-state-live-eval.schema.json",
+  "title": "dingtalk-agent Remote Semantic State Live Eval",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema", "id", "scenario", "liveAuthorized", "provider", "requiredSkills",
+    "evidenceRoot", "write"
+  ],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/remote-semantic-state-live-eval@1" },
+    "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]*$" },
+    "scenario": { "const": "memory-and-storage" },
+    "liveAuthorized": { "enum": ["yes", "no"] },
+    "provider": { "$ref": "remote-semantic-state-provider.schema.json" },
+    "requiredSkills": {
+      "type": "array",
+      "minItems": 2,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "evidenceRoot": { "type": "string", "pattern": "^\\.dingtalk-agent/.+" },
+    "write": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "allowlist", "budget", "documentSlots", "aitableFields", "driftProbe",
+        "retainMarkers"
+      ],
+      "properties": {
+        "allowlist": {
+          "type": "array",
+          "minItems": 3,
+          "maxItems": 3,
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "budget": { "type": "integer", "minimum": 1, "maximum": 10 },
+        "documentSlots": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 2,
+          "uniqueItems": true,
+          "items": { "enum": ["l1", "l3"] }
+        },
+        "aitableFields": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 2,
+          "uniqueItems": true,
+          "items": { "enum": ["summary", "nextAction"] }
+        },
+        "driftProbe": { "const": true },
+        "retainMarkers": { "const": true }
+      }
+    },
+    "nonAdocNegativeTestUri": { "type": "string", "minLength": 1 }
+  }
+}

package/docs/schemas/remote-semantic-state-manifest.schema.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dingtalk-agent.dev/schemas/remote-semantic-state-manifest.schema.json",
+  "title": "dingtalk-agent Remote Semantic State Manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema", "providerId", "providerHash", "scopeId", "definitionHash", "authority",
+    "layers", "nextAction", "stateHash", "controlState", "pulledAt", "hash"
+  ],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/remote-semantic-state-manifest@1" },
+    "providerId": { "type": "string", "minLength": 1 },
+    "providerHash": { "$ref": "#/$defs/hash" },
+    "scopeId": { "type": "string", "minLength": 1 },
+    "definitionHash": { "$ref": "#/$defs/hash" },
+    "authority": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["profile", "expectedUserId", "actualUserId"],
+      "properties": {
+        "profile": { "type": "string", "minLength": 1 },
+        "expectedUserId": { "type": "string", "minLength": 1 },
+        "actualUserId": { "type": "string", "minLength": 1 }
+      }
+    },
+    "layers": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["l1", "l2", "l3"],
+      "properties": {
+        "l1": { "$ref": "#/$defs/layer" },
+        "l2": { "$ref": "#/$defs/layer" },
+        "l3": { "$ref": "#/$defs/layer" }
+      }
+    },
+    "nextAction": { "type": "string", "minLength": 1 },
+    "stateHash": { "$ref": "#/$defs/hash" },
+    "controlState": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["provider", "remoteProjection", "excludedFromRemoteMarkdown"],
+      "properties": {
+        "provider": { "const": "host-atomic-store" },
+        "remoteProjection": { "const": false },
+        "excludedFromRemoteMarkdown": {
+          "type": "array",
+          "minItems": 6,
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "pulledAt": { "type": "string", "format": "date-time" },
+    "hash": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "layer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "slot", "semanticRole", "provider", "mode", "source", "mediaType",
+        "cachePath", "remoteHash", "cacheHash"
+      ],
+      "properties": {
+        "slot": { "enum": ["l1", "l2", "l3"] },
+        "semanticRole": { "type": "string", "minLength": 1 },
+        "provider": { "enum": ["dingtalk-doc", "dingtalk-aitable"] },
+        "mode": { "type": "string", "minLength": 1 },
+        "source": { "type": "string", "minLength": 1 },
+        "mediaType": { "enum": ["ALIDOC/adoc", "application/json"] },
+        "cachePath": { "type": "string", "minLength": 1 },
+        "remoteHash": { "$ref": "#/$defs/hash" },
+        "cacheHash": { "$ref": "#/$defs/hash" }
+      }
+    }
+  }
+}

package/docs/schemas/remote-semantic-state-provider.schema.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dingtalk-agent.dev/schemas/remote-semantic-state-provider.schema.json",
+  "title": "dingtalk-agent Remote Semantic State Provider",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "id", "scopeId", "authority", "layers", "controlState"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/remote-semantic-state-provider@1" },
+    "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]*$" },
+    "scopeId": { "type": "string", "minLength": 1 },
+    "authority": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["profile", "expectedUserId"],
+      "properties": {
+        "profile": { "type": "string", "minLength": 1, "pattern": "^[^,]+$" },
+        "expectedUserId": { "type": "string", "minLength": 1 }
+      }
+    },
+    "layers": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["l1", "l2", "l3"],
+      "properties": {
+        "l1": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["provider", "semanticRole", "mode", "uri"],
+          "properties": {
+            "provider": { "const": "dingtalk-doc" },
+            "semanticRole": { "const": "session-working-memory" },
+            "mode": { "const": "semantic-read-only-mirror" },
+            "uri": { "type": "string", "pattern": "^dingtalk-doc:.+" }
+          }
+        },
+        "l2": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "provider", "semanticRole", "mode", "baseId", "tableId", "recordId",
+            "expected", "fields"
+          ],
+          "properties": {
+            "provider": { "const": "dingtalk-aitable" },
+            "semanticRole": { "const": "structured-hot-state" },
+            "mode": { "const": "business-fact-source" },
+            "baseId": { "type": "string", "minLength": 1 },
+            "tableId": { "type": "string", "minLength": 1 },
+            "recordId": { "type": "string", "minLength": 1 },
+            "expected": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["key", "scopeId"],
+              "properties": {
+                "key": { "type": "string", "minLength": 1 },
+                "scopeId": { "type": "string", "minLength": 1 }
+              }
+            },
+            "fields": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["key", "scopeId", "status", "nextAction", "summary", "sourceRefs"],
+              "properties": {
+                "key": { "type": "string", "minLength": 1 },
+                "scopeId": { "type": "string", "minLength": 1 },
+                "status": { "type": "string", "minLength": 1 },
+                "nextAction": { "type": "string", "minLength": 1 },
+                "summary": { "type": "string", "minLength": 1 },
+                "sourceRefs": { "type": "string", "minLength": 1 }
+              }
+            }
+          }
+        },
+        "l3": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["provider", "semanticRole", "mode", "uri"],
+          "properties": {
+            "provider": { "const": "dingtalk-doc" },
+            "semanticRole": { "const": "long-term-knowledge" },
+            "mode": { "const": "reviewed-knowledge-source" },
+            "uri": { "type": "string", "pattern": "^dingtalk-doc:.+" }
+          }
+        }
+      }
+    },
+    "controlState": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["provider", "remoteProjection"],
+      "properties": {
+        "provider": { "const": "host-atomic-store" },
+        "remoteProjection": { "const": false }
+      }
+    }
+  }
+}

package/docs/schemas/response-gate.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dingtalk-agent.dev/schemas/response-gate.schema.json",
+  "title": "Response Gate Snapshot",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "decision", "reason", "hardAllowedActions", "softChecks", "perceptionHash", "hash"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/response-gate@1" },
+    "decision": { "enum": ["engage", "silent", "inspect"] },
+    "reason": { "type": "string" },
+    "hardAllowedActions": {
+      "type": "array",
+      "items": { "enum": ["ack", "reply", "ask", "silence"] }
+    },
+    "softChecks": { "type": "array", "items": { "type": "string" } },
+    "perceptionHash": { "type": "string" },
+    "hash": { "type": "string" }
+  }
+}