@dharma-ai-labs/agent-fabric 0.1.0

package/dist/schemas/task-envelope.schema.json

@@ -0,0 +1,384 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.dharma-ai.io/task/v1",
+  "title": "Dharma Task Envelope",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "taskId",
+    "organizationId",
+    "workspaceId",
+    "taskType",
+    "target",
+    "skillBundle",
+    "instructions",
+    "requiredSkills",
+    "authority",
+    "execution",
+    "acceptance",
+    "budget",
+    "createdAt",
+    "expiresAt",
+    "nonce"
+  ],
+  "properties": {
+    "schema": {
+      "const": "dharma.task/v1"
+    },
+    "taskId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "organizationId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "workspaceId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "taskType": {
+      "type": "string",
+      "enum": [
+        "external_request",
+        "a2a_handoff",
+        "evaluation_retest",
+        "remediation_smoke"
+      ]
+    },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "deviceId",
+        "provider"
+      ],
+      "properties": {
+        "deviceId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "provider": {
+          "type": "string",
+          "enum": ["codex", "claude", "agy"]
+        }
+      }
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["taskId", "endpointId"],
+      "properties": {
+        "taskId": { "type": "string", "format": "uuid" },
+        "endpointId": { "type": "string", "format": "uuid" }
+      }
+    },
+    "skillBundle": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["bundleId", "bundleHash"],
+          "properties": {
+            "bundleId": {
+              "type": "string",
+              "format": "uuid"
+            },
+            "bundleHash": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            }
+          }
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "instructions": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 20000
+    },
+    "requiredSkills": {
+      "type": "array",
+      "maxItems": 50,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "skillId",
+          "version",
+          "commit",
+          "contentHash"
+        ],
+        "properties": {
+          "skillId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200,
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._/@-]{0,199}$"
+          },
+          "version": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "commit": {
+            "type": "string",
+            "pattern": "^[A-Fa-f0-9]{40,64}$"
+          },
+          "contentHash": {
+            "type": "string",
+            "pattern": "^(sha256|blake3):[A-Fa-f0-9]{32,128}$"
+          }
+        }
+      }
+    },
+    "stateEnvelope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "intent",
+        "evidence_used",
+        "known_state",
+        "unknown_or_missing_state",
+        "allowed_next_actions",
+        "blocked_actions",
+        "decision_authority",
+        "tool_results"
+      ],
+      "properties": {
+        "intent": { "type": "string", "minLength": 1, "maxLength": 1000 },
+        "evidence_used": {
+          "type": "array",
+          "maxItems": 50,
+          "items": { "type": "string", "minLength": 1, "maxLength": 500 }
+        },
+        "known_state": { "type": "object", "maxProperties": 100 },
+        "unknown_or_missing_state": {
+          "type": "array",
+          "maxItems": 50,
+          "items": { "type": "string", "minLength": 1, "maxLength": 1000 }
+        },
+        "allowed_next_actions": {
+          "type": "array",
+          "maxItems": 50,
+          "items": { "type": "string", "minLength": 1, "maxLength": 500 }
+        },
+        "blocked_actions": {
+          "type": "array",
+          "maxItems": 50,
+          "items": { "type": "string", "minLength": 1, "maxLength": 500 }
+        },
+        "decision_authority": { "type": "string", "minLength": 1, "maxLength": 1000 },
+        "tool_results": { "type": "array", "maxItems": 50 }
+      }
+    },
+    "evidenceReferences": {
+      "type": "array",
+      "maxItems": 20,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["trajectoryId", "revision", "capsuleHash"],
+        "properties": {
+          "trajectoryId": { "type": "string", "format": "uuid" },
+          "revision": { "type": "integer", "minimum": 1 },
+          "capsuleHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+        }
+      }
+    },
+    "authority": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "readPaths",
+        "writePaths",
+        "commands",
+        "network",
+        "git"
+      ],
+      "properties": {
+        "readPaths": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "writePaths": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "commands": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["commandId"],
+            "properties": {
+              "commandId": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
+              }
+            }
+          }
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "deny",
+            "package_registry_only",
+            "allowlisted_domains",
+            "inherit_local_provider"
+          ]
+        },
+        "git": {
+          "type": "string",
+          "enum": [
+            "read_only",
+            "task_branch",
+            "merge_allowed",
+            "deploy_allowed"
+          ]
+        },
+        "allowlistedDomains": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      }
+    },
+    "execution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "isolation",
+        "timeoutSeconds",
+        "leaseSeconds",
+        "maximumConcurrentAgents"
+      ],
+      "properties": {
+        "isolation": {
+          "const": "git_worktree"
+        },
+        "timeoutSeconds": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "leaseSeconds": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "maximumConcurrentAgents": {
+          "type": "integer",
+          "minimum": 1
+        }
+      }
+    },
+    "acceptance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "commands",
+        "requiredArtifacts"
+      ],
+      "properties": {
+        "commands": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["commandId"],
+            "properties": {
+              "commandId": {
+                "type": "string",
+                "minLength": 1,
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
+              }
+            }
+          }
+        },
+        "requiredArtifacts": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "budget": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "mode",
+        "maximumDharmaCostCents"
+      ],
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": [
+            "byok_local",
+            "byok_cloud",
+            "dharma_managed"
+          ]
+        },
+        "maximumDharmaCostCents": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "maximumProviderCostCents": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 0
+        }
+      }
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "expiresAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "nonce": {
+      "type": "string",
+      "minLength": 1
+    },
+    "signature": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "taskType": { "const": "a2a_handoff" } },
+        "required": ["taskType"]
+      },
+      "then": {
+        "required": ["source", "stateEnvelope", "evidenceReferences"]
+      },
+      "else": {
+        "not": {
+          "anyOf": [
+            { "required": ["source"] },
+            { "required": ["stateEnvelope"] },
+            { "required": ["evidenceReferences"] }
+          ]
+        }
+      }
+    }
+  ]
+}

package/dist/schemas/trajectory-capsule.schema.json

@@ -0,0 +1,281 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.dharma-ai.io/trajectory-capsule/v1",
+  "title": "Dharma Trajectory Capsule",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "trajectoryId",
+    "revision",
+    "organizationId",
+    "deviceId",
+    "workspaceId",
+    "provider",
+    "sessionId",
+    "timeRange",
+    "status",
+    "evidenceMode",
+    "coverage",
+    "events",
+    "contentIndex",
+    "redactionReceipt",
+    "localEvidenceAvailable",
+    "capsuleHash",
+    "createdAt"
+  ],
+  "properties": {
+    "schema": {
+      "const": "dharma.trajectory-capsule/v1"
+    },
+    "trajectoryId": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "revision": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "previousRevisionHash": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "pattern": "^(sha256|blake3):[A-Fa-f0-9]{32,128}$"
+    },
+    "organizationId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "deviceId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "workspaceId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "provider": {
+      "type": "string"
+    },
+    "sessionId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "taskId": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "timeRange": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "start",
+        "end"
+      ],
+      "properties": {
+        "start": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "end": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "open",
+        "completed",
+        "failed",
+        "cancelled",
+        "partial"
+      ]
+    },
+    "evidenceMode": {
+      "type": "string",
+      "enum": [
+        "structured",
+        "deep",
+        "reduced_full_session",
+        "incident_capture"
+      ]
+    },
+    "coverage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "state",
+        "admittedSessions",
+        "excludedSessions",
+        "missingFields"
+      ],
+      "properties": {
+        "state": {
+          "type": "string",
+          "enum": [
+            "observed",
+            "partial",
+            "unavailable"
+          ]
+        },
+        "admittedSessions": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "excludedSessions": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "missingFields": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true
+        }
+      }
+    },
+    "repoState": {
+      "type": "object"
+    },
+    "skillState": {
+      "type": "object"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "$ref": "https://schemas.dharma-ai.io/agent-event/v1"
+      }
+    },
+    "contentIndex": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "contentId",
+          "kind",
+          "bytes",
+          "uploaded",
+          "availableLocally"
+        ],
+        "properties": {
+          "contentId": {
+            "type": "string",
+            "pattern": "^(sha256|blake3):[A-Fa-f0-9]{32,128}$"
+          },
+          "kind": {
+            "type": "string"
+          },
+          "bytes": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "uploaded": {
+            "type": "boolean"
+          },
+          "availableLocally": {
+            "type": "boolean"
+          },
+          "mimeType": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "normalizedPath": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        }
+      }
+    },
+    "validationResults": {
+      "type": "array",
+      "items": {
+        "type": "object"
+      },
+      "default": []
+    },
+    "redactionReceipt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "policyRevision",
+        "classes",
+        "redactedValues",
+        "excludedPaths",
+        "inputBytes",
+        "outputBytes"
+      ],
+      "properties": {
+        "policyRevision": {
+          "type": "string"
+        },
+        "classes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true
+        },
+        "redactedValues": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "excludedPaths": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "inputBytes": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "outputBytes": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "localEvidenceAvailable": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "contentId",
+          "kind",
+          "bytes"
+        ],
+        "properties": {
+          "contentId": {
+            "type": "string",
+            "pattern": "^(sha256|blake3):[A-Fa-f0-9]{32,128}$"
+          },
+          "kind": {
+            "type": "string"
+          },
+          "bytes": {
+            "type": "integer",
+            "minimum": 0
+          }
+        }
+      }
+    },
+    "capsuleHash": {
+      "type": "string",
+      "pattern": "^(sha256|blake3):[A-Fa-f0-9]{32,128}$"
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@dharma-ai-labs/agent-fabric",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": { "dharma": "dist/index.js" },
+  "engines": { "node": ">=22.20.0 <25.0.0", "npm": ">=10.9.3 <12.0.0" },
+  "repository": { "type": "git", "url": "git+https://github.com/dharma-ai-labs/dharma-agent-fabric.git", "directory": "packages/cli" },
+  "files": ["dist"],
+  "publishConfig": { "access": "public", "provenance": true },
+  "scripts": { "test": "node --test dist/*.test.js" },
+  "dependencies": {
+    "@dharma-ai-labs/agent-fabric-contracts": "0.1.0",
+    "@dharma-ai-labs/agent-fabric-evidence-reduction": "0.1.0",
+    "@dharma-ai-labs/agent-fabric-local-vault": "0.1.0",
+    "@dharma-ai-labs/agent-fabric-policy": "0.1.0",
+    "@dharma-ai-labs/agent-fabric-provider-adapters": "0.1.0",
+    "@dharma-ai-labs/agent-fabric-relay-client": "0.1.0",
+    "@dharma-ai-labs/agent-fabric-skill-manager": "0.1.0",
+    "@dharma-ai-labs/agent-fabric-task-runner": "0.1.0"
+  }
+}