@logicsrc/schemas 0.1.0

package/schemas/logicsrc-account-audit-event.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-account-audit-event.schema.json",
+  "title": "LogicSRC Account Audit Event",
+  "type": "object",
+  "required": ["id", "provider", "kind", "principal", "action", "decision", "riskScore", "requestPreview", "resultPreview", "createdAt"],
+  "additionalProperties": false,
+  "properties": {
+    "id": { "type": "string", "minLength": 1 },
+    "accountId": { "type": "string", "minLength": 1 },
+    "provider": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+    "kind": { "enum": ["social", "email"] },
+    "principal": {
+      "type": "object",
+      "required": ["type", "id"],
+      "additionalProperties": false,
+      "properties": {
+        "type": { "enum": ["user", "agent", "workflow", "plugin"] },
+        "id": { "type": "string", "minLength": 1 },
+        "trusted": { "type": "boolean" }
+      }
+    },
+    "action": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(:[a-z][a-z0-9_-]*)+$" },
+    "decision": { "enum": ["allow", "approval_required", "deny"] },
+    "riskScore": { "type": "number", "minimum": 0, "maximum": 1 },
+    "requestPreview": { "type": "object" },
+    "resultPreview": { "type": "object" },
+    "correlationId": { "type": "string", "minLength": 1 },
+    "createdAt": { "type": "string", "format": "date-time" }
+  }
+}

package/schemas/logicsrc-account-grant.schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-account-grant.schema.json",
+  "title": "LogicSRC Account Permission Grant",
+  "type": "object",
+  "required": ["id", "accountId", "principal", "permissions", "policy", "createdAt"],
+  "additionalProperties": false,
+  "properties": {
+    "id": { "type": "string", "minLength": 1 },
+    "accountId": { "type": "string", "minLength": 1 },
+    "principal": {
+      "type": "object",
+      "required": ["type", "id"],
+      "additionalProperties": false,
+      "properties": {
+        "type": { "enum": ["user", "agent", "workflow", "plugin"] },
+        "id": { "type": "string", "minLength": 1 },
+        "trusted": { "type": "boolean" }
+      }
+    },
+    "permissions": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(:[a-z][a-z0-9_-]*)+$" },
+      "uniqueItems": true
+    },
+    "policy": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "resource", "action", "default"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "resource": { "type": "string", "minLength": 1 },
+          "action": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(:[a-z][a-z0-9_-]*)+$" },
+          "default": {
+            "enum": ["allow", "approval_required", "deny", "allow_if_dry_run", "allow_if_trusted_agent", "allow_if_below_risk_score"]
+          },
+          "conditions": { "type": "object" }
+        }
+      }
+    },
+    "expiresAt": { "type": "string", "format": "date-time" },
+    "createdBy": { "type": "string", "minLength": 1 },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "revokedAt": { "type": "string", "format": "date-time" }
+  }
+}

package/schemas/logicsrc-account-provider.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-account-provider.schema.json",
+  "title": "LogicSRC Account Provider",
+  "type": "object",
+  "required": ["id", "name", "kind", "authMethods", "capabilities"],
+  "additionalProperties": false,
+  "properties": {
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+    "name": { "type": "string", "minLength": 1 },
+    "kind": { "enum": ["social", "email"] },
+    "authMethods": {
+      "type": "array",
+      "items": { "enum": ["oauth2", "api_key", "imap_smtp", "local_bridge"] },
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "capabilities": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(\\.[a-z][a-z0-9_-]*)+$" },
+      "uniqueItems": true
+    },
+    "defaultScopes": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "status": { "enum": ["available", "planned", "disabled"] },
+    "docsUrl": { "type": "string", "format": "uri" }
+  }
+}

package/schemas/logicsrc-agent.schema.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-agent.schema.json",
+  "title": "LogicSRC Agent",
+  "type": "object",
+  "required": ["type", "version", "name", "did", "owner_did", "skills", "permissions_requested"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "logicsrc.agent" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "name": { "type": "string", "minLength": 1, "maxLength": 120 },
+    "did": { "$ref": "#/$defs/did" },
+    "owner_did": { "$ref": "#/$defs/did" },
+    "description": { "type": "string" },
+    "skills": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "supported_task_types": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "pricing": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "model": { "type": "string", "enum": ["free", "per_task", "hourly", "subscription"] },
+        "amount": { "type": "number", "minimum": 0 },
+        "currency": { "type": "string", "minLength": 2, "maxLength": 12 }
+      }
+    },
+    "permissions_requested": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9._-]*(:[a-z][a-z0-9._-]*)?$" },
+      "uniqueItems": true
+    },
+    "webhook_url": { "type": "string", "format": "uri" },
+    "polling_mode": { "type": "boolean" },
+    "public": { "type": "boolean", "default": true },
+    "logicsrc_compatibility_version": { "type": "string" }
+  },
+  "$defs": {
+    "did": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._-]*\\.[a-z0-9][a-z0-9._-]*$"
+    }
+  }
+}

package/schemas/logicsrc-connected-account.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-connected-account.schema.json",
+  "title": "LogicSRC Connected Account",
+  "type": "object",
+  "required": ["id", "ownerUserId", "kind", "provider", "displayName", "status", "scopes", "capabilities", "credentialRef", "metadata", "createdAt", "updatedAt"],
+  "additionalProperties": false,
+  "properties": {
+    "id": { "type": "string", "minLength": 1 },
+    "orgId": { "type": "string", "minLength": 1 },
+    "projectId": { "type": "string", "minLength": 1 },
+    "boardId": { "type": "string", "minLength": 1 },
+    "ownerUserId": { "type": "string", "minLength": 1 },
+    "kind": { "enum": ["social", "email"] },
+    "provider": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+    "providerAccountId": { "type": "string", "minLength": 1 },
+    "displayName": { "type": "string", "minLength": 1 },
+    "handle": { "type": "string", "minLength": 1 },
+    "email": { "type": "string", "format": "email" },
+    "avatarUrl": { "type": "string", "format": "uri" },
+    "homepageUrl": { "type": "string", "format": "uri" },
+    "status": { "enum": ["connected", "expired", "revoked", "error", "disabled", "pending"] },
+    "scopes": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "capabilities": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(\\.[a-z][a-z0-9_-]*)+$" },
+      "uniqueItems": true
+    },
+    "credentialRef": { "type": "string", "minLength": 1 },
+    "metadata": { "type": "object" },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" },
+    "lastSyncedAt": { "type": "string", "format": "date-time" }
+  }
+}

package/schemas/logicsrc-credential-audit-event.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-credential-audit-event.schema.json",
+  "title": "LogicSRC Credential Audit Event",
+  "type": "object",
+  "required": ["type", "id", "provider", "action", "key", "target", "principal", "decision", "dryRun", "createdAt"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "logicsrc.credential_audit_event" },
+    "id": { "type": "string", "minLength": 1 },
+    "runId": { "type": "string", "minLength": 1 },
+    "planId": { "type": "string", "minLength": 1 },
+    "provider": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+    "action": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(:[a-z][a-z0-9_-]*)+$" },
+    "key": { "type": "string", "minLength": 1 },
+    "target": { "type": "string", "minLength": 1 },
+    "fingerprint": { "type": "string" },
+    "principal": {
+      "type": "object",
+      "required": ["type", "id"],
+      "additionalProperties": false,
+      "properties": {
+        "type": { "enum": ["user", "agent", "workflow", "plugin"] },
+        "id": { "type": "string", "minLength": 1 },
+        "trusted": { "type": "boolean" }
+      }
+    },
+    "decision": { "enum": ["allow", "approval_required", "deny"] },
+    "dryRun": { "type": "boolean" },
+    "createdAt": { "type": "string", "format": "date-time" }
+  }
+}

package/schemas/logicsrc-credential-provider.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-credential-provider.schema.json",
+  "title": "LogicSRC Credential Provider",
+  "type": "object",
+  "required": ["id", "name", "description", "capabilities", "authRequirements", "status"],
+  "additionalProperties": false,
+  "properties": {
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+    "name": { "type": "string", "minLength": 1 },
+    "description": { "type": "string", "minLength": 1 },
+    "capabilities": {
+      "type": "object",
+      "required": ["readValues", "readNames", "write", "delete", "rollback", "audit"],
+      "additionalProperties": false,
+      "properties": {
+        "readValues": { "type": "boolean" },
+        "readNames": { "type": "boolean" },
+        "write": { "type": "boolean" },
+        "delete": { "type": "boolean" },
+        "rollback": { "type": "boolean" },
+        "audit": { "type": "boolean" }
+      }
+    },
+    "authRequirements": { "type": "array", "items": { "type": "string" } },
+    "status": { "enum": ["available", "planned"] }
+  }
+}

package/schemas/logicsrc-credential-sync-plan.schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-credential-sync-plan.schema.json",
+  "title": "LogicSRC Credential Sync Plan",
+  "type": "object",
+  "required": ["type", "id", "from", "to", "policy", "changes", "requiresApproval", "createdAt"],
+  "additionalProperties": false,
+  "$defs": {
+    "endpoint": {
+      "type": "object",
+      "required": ["provider"],
+      "additionalProperties": false,
+      "properties": {
+        "provider": { "type": "string", "minLength": 1 },
+        "path": { "type": "string" },
+        "project": { "type": "string" },
+        "config": { "type": "string" },
+        "service": { "type": "string" },
+        "scope": { "type": "string" },
+        "metadata": { "type": "object" }
+      }
+    },
+    "change": {
+      "type": "object",
+      "required": ["key", "op", "destructive"],
+      "additionalProperties": false,
+      "properties": {
+        "key": { "type": "string", "minLength": 1 },
+        "op": { "enum": ["add", "update", "remove", "unchanged", "unknown"] },
+        "sourceFingerprint": { "type": "string" },
+        "targetFingerprint": { "type": "string" },
+        "destructive": { "type": "boolean" }
+      }
+    }
+  },
+  "properties": {
+    "type": { "const": "logicsrc.credential_sync_plan" },
+    "id": { "type": "string", "minLength": 1 },
+    "from": { "$ref": "#/$defs/endpoint" },
+    "to": { "$ref": "#/$defs/endpoint" },
+    "policy": {
+      "type": "object",
+      "required": ["redactValues", "requireApprovalForDestructive"],
+      "additionalProperties": false,
+      "properties": {
+        "redactValues": { "const": true },
+        "requireApprovalForDestructive": { "type": "boolean" },
+        "denyKeys": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "changes": { "type": "array", "items": { "$ref": "#/$defs/change" } },
+    "requiresApproval": { "type": "boolean" },
+    "rollbackOfRunId": { "type": "string", "minLength": 1 },
+    "createdAt": { "type": "string", "format": "date-time" }
+  }
+}

package/schemas/logicsrc-credential-sync-run.schema.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-credential-sync-run.schema.json",
+  "title": "LogicSRC Credential Sync Run",
+  "type": "object",
+  "required": ["type", "id", "planId", "status", "dryRun", "results", "auditEventIds", "reversible", "startedAt", "finishedAt"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "logicsrc.credential_sync_run" },
+    "id": { "type": "string", "minLength": 1 },
+    "planId": { "type": "string", "minLength": 1 },
+    "status": { "enum": ["planned", "dry_run", "applied", "partial", "failed", "rolled_back"] },
+    "dryRun": { "type": "boolean" },
+    "results": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["key", "op", "applied", "dryRun"],
+        "additionalProperties": false,
+        "properties": {
+          "key": { "type": "string", "minLength": 1 },
+          "op": { "enum": ["add", "update", "remove", "unchanged", "unknown"] },
+          "applied": { "type": "boolean" },
+          "dryRun": { "type": "boolean" },
+          "targetFingerprint": { "type": "string" },
+          "error": { "type": "string" }
+        }
+      }
+    },
+    "auditEventIds": { "type": "array", "items": { "type": "string" } },
+    "reversible": { "type": "boolean" },
+    "startedAt": { "type": "string", "format": "date-time" },
+    "finishedAt": { "type": "string", "format": "date-time" }
+  }
+}

package/schemas/logicsrc-email-message.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-email-message.schema.json",
+  "title": "LogicSRC Email Message Metadata",
+  "type": "object",
+  "required": ["id", "providerMessageId", "toAddresses", "ccAddresses", "labels", "hasAttachments"],
+  "additionalProperties": false,
+  "properties": {
+    "id": { "type": "string", "minLength": 1 },
+    "providerMessageId": { "type": "string", "minLength": 1 },
+    "threadId": { "type": "string", "minLength": 1 },
+    "subject": { "type": "string" },
+    "fromAddress": { "type": "string" },
+    "toAddresses": { "type": "array", "items": { "type": "string" } },
+    "ccAddresses": { "type": "array", "items": { "type": "string" } },
+    "snippet": { "type": "string" },
+    "labels": { "type": "array", "items": { "type": "string" } },
+    "hasAttachments": { "type": "boolean" },
+    "receivedAt": { "type": "string", "format": "date-time" },
+    "sentAt": { "type": "string", "format": "date-time" }
+  }
+}

package/schemas/logicsrc-event.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.logicsrc.com/logicsrc-event.schema.json",
+  "title": "LogicSRC Event",
+  "type": "object",
+  "required": ["type", "version", "event", "id", "created_at", "actor_did", "resource_type", "resource_id", "data"],
+  "additionalProperties": false,
+  "properties": {
+    "type": { "const": "logicsrc.event" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "event": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_]*\\.[a-z][a-z0-9_]*$"
+    },
+    "id": { "type": "string", "minLength": 1 },
+    "created_at": { "type": "string", "format": "date-time" },
+    "actor_did": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._-]*\\.[a-z0-9][a-z0-9._-]*$"
+    },
+    "resource_type": { "type": "string", "minLength": 1 },
+    "resource_id": { "type": "string", "minLength": 1 },
+    "data": { "type": "object" }
+  }
+}

package/schemas/logicsrc-opencontext-audit-event.schema.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://logicsrc.com/schemas/opencontext/audit-event.schema.json",
+  "title": "OpenContext Audit Event",
+  "description": "One recorded interaction with the context plane: a read, a bundle generation, a write, a conflict the resolver refused to guess about, or a decision. The specification defines the event shape and leaves storage to the implementation — an NDJSON file in the repository is a conforming sink, and so is a warehouse. The point is that after an agent is retired, its reads and writes remain attributable.",
+  "type": "object",
+  "required": ["opencontext", "event", "at", "actor"],
+  "additionalProperties": false,
+  "properties": {
+    "opencontext": { "type": "string", "pattern": "^\\d+\\.\\d+(\\.\\d+)?$" },
+    "event": {
+      "type": "string",
+      "enum": [
+        "context.read",
+        "context.search",
+        "context.resolve",
+        "context.bundle",
+        "context.write",
+        "context.supersede",
+        "context.conflict",
+        "context.denied",
+        "decision.record"
+      ],
+      "description": "What happened. context.denied records an authorization refusal, which is usually the most interesting line in the log."
+    },
+    "at": { "type": "string", "format": "date-time", "description": "When it happened." },
+    "actor": {
+      "type": "object",
+      "required": ["type", "id"],
+      "additionalProperties": false,
+      "description": "Who did it. An agent acting for a person records both, so an action is never attributable to a model alone.",
+      "properties": {
+        "type": { "type": "string", "enum": ["agent", "human", "role", "service"] },
+        "id": { "type": "string", "minLength": 1 },
+        "roles": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+        "on_behalf_of": { "type": "string", "description": "The human or service the actor was acting for." }
+      }
+    },
+    "task": { "type": "string", "description": "The task the context was being used for, when there was one." },
+    "objects": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 },
+      "description": "Context object ids the event touched."
+    },
+    "bundle": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "The bundle produced or consumed. The digest is what makes the record verifiable rather than merely descriptive.",
+      "properties": {
+        "bundle_id": { "type": "string", "pattern": "^ocb_[a-z0-9_-]+$" },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+        "object_count": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "outcome": {
+      "type": "string",
+      "enum": ["allowed", "denied", "partial", "error"],
+      "description": "partial is the normal outcome of a resolution that excluded some candidates; denied means the consumer was refused everything it asked for."
+    },
+    "reason": { "type": "string", "description": "Why, especially for denied and error outcomes." },
+    "namespace": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
+    "extensions": {
+      "type": "object",
+      "propertyNames": { "type": "string", "pattern": "^[a-z0-9]+(\\.[a-z0-9-]+)+$" },
+      "additionalProperties": true
+    }
+  }
+}