@viewportai/daemon 0.1.0 → 0.2.1

package/package.json

@@ -1,17 +1,18 @@
 {
   "name": "@viewportai/daemon",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Viewport daemon — supervision and orchestration layer for AI coding agents",
   "license": "Apache-2.0",
   "type": "module",
   "repository": {
     "type": "git",
-    "url": "https://github.com/viewportai/daemon"
+    "url": "https://github.com/viewportai/viewport.git",
+    "directory": "packages/daemon"
   },
   "bugs": {
-    "url": "https://github.com/viewportai/daemon/issues"
+    "url": "https://github.com/viewportai/viewport/issues"
   },
-  "homepage": "https://github.com/viewportai/daemon#readme",
+  "homepage": "https://github.com/viewportai/viewport/tree/main/packages/daemon#readme",
   "bin": {
     "vpd": "bin/vpd.js"
   },
@@ -19,7 +20,11 @@
     "bin",
     "dist",
     "README.md",
-    "docs"
+    "docs",
+    "schemas"
+  ],
+  "bundledDependencies": [
+    "@viewportai/context-engine"
   ],
   "publishConfig": {
     "access": "public"
@@ -29,11 +34,14 @@
   },
   "scripts": {
     "dev": "tsx watch src/index.ts",
+    "dev:daemon": "tsx watch src/index.ts start --foreground",
     "build": "tsc",
-    "prepack": "npm run build",
+    "start:foreground": "npm run build && node dist/index.js start --foreground",
+    "prepack": "npm run build && node ./scripts/vendor-context-engine.mjs prepare",
+    "postpack": "node ./scripts/vendor-context-engine.mjs clean",
     "typecheck": "tsc --noEmit",
     "test": "bash ./scripts/test.sh",
-    "test:unit": "vitest run",
+    "test:unit": "vitest run --pool=forks",
     "test:verify": "npm run test -- --verify",
     "test:setup": "vitest run tests/cli/setup-command.test.ts tests/cli/service-commands.test.ts tests/startup-prereqs.test.ts tests/core/built-in-agents.test.ts",
     "test:e2e": "vitest run tests/e2e",
@@ -62,9 +70,16 @@
     "@fastify/cors": "^10.0.1",
     "@fastify/websocket": "^11.0.1",
     "@openai/codex-sdk": "^0.107.0",
+    "@hpke/core": "^1.9.0",
+    "@hpke/dhkem-x25519": "^1.8.0",
+    "@viewportai/context-engine": "^0.0.1",
+    "ajv": "^8.20.0",
+    "better-sqlite3": "^11.10.0",
     "fastify": "^5.2.1",
+    "jsonata": "^2.1.0",
     "pino": "^9.6.0",
     "pino-pretty": "^13.1.3",
+    "yaml": "^2.8.3",
     "zod": "^4.0.0"
   },
   "devDependencies": {

package/schemas/viewport-config-v1.schema.json

@@ -0,0 +1,209 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://getviewport.dev/schemas/viewport-config-v1.schema.json",
+  "title": "Viewport repository contract",
+  "description": "Schema for .viewport/config.yaml. This contract declares the workflows, context providers, resources, and approval rules vpd resolves for agent runs in a repository.",
+  "type": "object",
+  "additionalProperties": true,
+  "properties": {
+    "$schema": { "type": "string", "format": "uri" },
+    "version": { "const": 1 },
+    "name": { "type": "string", "minLength": 1, "maxLength": 256 },
+    "resources": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "contexts": { "$ref": "#/$defs/resourceRefs" },
+        "workflows": { "$ref": "#/$defs/resourceRefs" },
+        "plans": { "$ref": "#/$defs/resourceRefs" },
+        "agentProfiles": { "$ref": "#/$defs/resourceRefs" }
+      }
+    },
+    "context": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "providers": {
+          "type": "array",
+          "maxItems": 50,
+          "items": { "$ref": "#/$defs/contextProvider" }
+        },
+        "resolution": { "$ref": "#/$defs/contextResolution" }
+      }
+    },
+    "workflows": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/workflowRef" }
+    },
+    "approvals": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "risky_paths": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "$ref": "#/$defs/riskyPathRule" }
+        },
+        "riskyPaths": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "$ref": "#/$defs/riskyPathRule" }
+        }
+      }
+    },
+    "defaults": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "inboxRoute": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "workflow": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "visibility": { "enum": ["private", "team", "organization"] },
+        "context_candidate_review": {
+          "enum": ["single_reviewer", "owner_auto_approve", "manual_assign"]
+        },
+        "contextCandidateReview": { "type": "string", "minLength": 1, "maxLength": 256 }
+      }
+    },
+    "scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "includeChildren": { "type": "boolean" },
+        "maxDepth": { "type": "integer", "minimum": 0, "maximum": 5 },
+        "exclude": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "type": "string", "minLength": 1, "maxLength": 256 }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "resourceRefs": {
+      "type": "array",
+      "maxItems": 100,
+      "items": {
+        "oneOf": [
+          { "type": "string", "minLength": 1, "maxLength": 512 },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id"],
+            "properties": {
+              "id": { "type": "string", "minLength": 1, "maxLength": 512 },
+              "required": { "type": "boolean" }
+            }
+          }
+        ]
+      }
+    },
+    "contextProvider": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "provider"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "provider": {
+          "enum": ["repo-docs", "viewport-vault", "notebooklm", "glean", "custom-cli", "custom-mcp"]
+        },
+        "required": { "type": "boolean" },
+        "privacy": {
+          "enum": ["local_only", "control_plane_blind", "third_party_terms", "customer_hosted", "unknown"]
+        },
+        "capabilities": {
+          "type": "array",
+          "maxItems": 4,
+          "items": { "enum": ["search", "get", "propose", "write_approved"] }
+        },
+        "credential_ref": { "$ref": "#/$defs/credentialRef" },
+        "credentialRef": { "$ref": "#/$defs/credentialRef" },
+        "paths": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "type": "string", "minLength": 1, "maxLength": 512 }
+        },
+        "vault": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "notebook": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "command": { "type": "string", "minLength": 1, "maxLength": 512 }
+      },
+      "not": {
+        "anyOf": [
+          { "required": ["token"] },
+          { "required": ["api_key"] },
+          { "required": ["apiKey"] },
+          { "required": ["client_secret"] },
+          { "required": ["clientSecret"] },
+          { "required": ["password"] },
+          { "required": ["credentials"] }
+        ]
+      }
+    },
+    "credentialRef": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256,
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._/:@-]*$"
+    },
+    "contextResolution": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "order": {
+          "type": "array",
+          "maxItems": 50,
+          "items": { "type": "string", "minLength": 1, "maxLength": 128 }
+        },
+        "size_budget": { "$ref": "#/$defs/sizeBudget" },
+        "size_budget_bytes": { "$ref": "#/$defs/sizeBudget" },
+        "strategy": {
+          "enum": ["rank_by_recency_then_query", "pinned_then_recent", "provider_order"]
+        },
+        "propose_fallback_provider": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "proposeFallbackProvider": { "type": "string", "minLength": 1, "maxLength": 128 }
+      }
+    },
+    "sizeBudget": {
+      "oneOf": [
+        { "type": "integer", "minimum": 1024, "maximum": 1000000 },
+        { "type": "string", "pattern": "^\\d+(b|kb|mb)?$" }
+      ]
+    },
+    "workflowRef": {
+      "oneOf": [
+        { "type": "string", "minLength": 1, "maxLength": 512 },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "anyOf": [{ "required": ["path"] }, { "required": ["resource"] }],
+          "properties": {
+            "path": { "type": "string", "minLength": 1, "maxLength": 512 },
+            "resource": { "type": "string", "minLength": 1, "maxLength": 256 },
+            "version": { "type": "string", "minLength": 1, "maxLength": 64 },
+            "digest": { "type": "string", "minLength": 1, "maxLength": 256 },
+            "required": { "type": "boolean" }
+          }
+        }
+      ]
+    },
+    "riskyPathRule": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "require"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "path": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "require": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 20,
+          "items": { "type": "string", "minLength": 1, "maxLength": 128 }
+        },
+        "checks": {
+          "type": "array",
+          "maxItems": 20,
+          "items": { "type": "string", "minLength": 1, "maxLength": 512 }
+        }
+      }
+    }
+  }
+}

package/schemas/workflow-v1.schema.json

@@ -0,0 +1,245 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://getviewport.dev/schemas/workflow-v1.schema.json",
+  "title": "Viewport workflow",
+  "description": "Schema for viewport.workflow/v1 YAML files executed by vpd.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "name", "nodes"],
+  "properties": {
+    "schema": { "const": "viewport.workflow/v1" },
+    "name": { "$ref": "#/$defs/identifier" },
+    "title": { "type": "string", "minLength": 1 },
+    "description": { "type": "string" },
+    "inputs": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/inputDefinition" }
+    },
+    "context": {
+      "type": "array",
+      "items": {
+        "oneOf": [
+          { "type": "string", "minLength": 1 },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["ref"],
+            "properties": {
+              "ref": { "type": "string", "minLength": 1 },
+              "as": { "$ref": "#/$defs/identifier" },
+              "required": { "type": "boolean" },
+              "description": { "type": "string" },
+              "refresh": { "enum": ["manual", "before_run", "on_demand"] }
+            }
+          }
+        ]
+      }
+    },
+    "requires": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "agents": { "$ref": "#/$defs/stringList" },
+        "tools": { "$ref": "#/$defs/stringList" },
+        "integrations": { "$ref": "#/$defs/stringList" },
+        "secrets": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/identifier" }
+        }
+      }
+    },
+    "nodes": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": { "$ref": "#/$defs/node" }
+    }
+  },
+  "$defs": {
+    "identifier": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[a-zA-Z0-9._/-]+$"
+    },
+    "stringList": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "inputValue": {
+      "oneOf": [
+        { "type": "string" },
+        { "type": "number" },
+        { "type": "boolean" },
+        { "type": "null" },
+        { "type": "array" },
+        { "type": "object" }
+      ]
+    },
+    "inputDefinition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type"],
+      "properties": {
+        "type": { "enum": ["string", "number", "boolean", "json"] },
+        "required": { "type": "boolean" },
+        "default": { "$ref": "#/$defs/inputValue" },
+        "description": { "type": "string" }
+      }
+    },
+    "outputDefinition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type"],
+      "properties": {
+        "type": { "enum": ["string", "number", "boolean", "json", "file", "artifact"] },
+        "description": { "type": "string" },
+        "extract": { "type": "string", "minLength": 1 }
+      }
+    },
+    "artifactDefinition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "type": { "enum": ["file", "directory", "patch", "report", "log"] },
+        "description": { "type": "string" }
+      }
+    },
+    "retryPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["maxAttempts"],
+      "properties": {
+        "maxAttempts": { "type": "integer", "minimum": 1, "maximum": 10 },
+        "backoffSeconds": { "type": "integer", "minimum": 0, "maximum": 86400 },
+        "transient": { "$ref": "#/$defs/stringList" },
+        "fatal": { "$ref": "#/$defs/stringList" }
+      }
+    },
+    "nodeBase": {
+      "type": "object",
+      "properties": {
+        "title": { "type": "string", "minLength": 1 },
+        "needs": { "$ref": "#/$defs/stringList" },
+        "when": { "type": "string", "minLength": 1 },
+        "triggerRule": { "enum": ["all_success", "all_done", "one_success"] },
+        "timeoutSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 },
+        "retry": { "$ref": "#/$defs/retryPolicy" },
+        "policy": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "onFailure": { "enum": ["halt", "continue", "skip_dependents"] },
+            "approvalRequired": { "type": "boolean" }
+          }
+        },
+        "outputs": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/outputDefinition" }
+        },
+        "artifacts": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/artifactDefinition" }
+        },
+        "env": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "oneOf": [{ "required": ["value"] }, { "required": ["secret"] }],
+            "properties": {
+              "value": { "type": "string" },
+              "secret": { "$ref": "#/$defs/identifier" }
+            }
+          }
+        }
+      }
+    },
+    "node": {
+      "allOf": [{ "$ref": "#/$defs/nodeBase" }],
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["type", "command"],
+          "properties": {
+            "type": { "const": "shell" },
+            "command": { "type": "string", "minLength": 1 },
+            "cwd": { "type": "string", "minLength": 1 }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["type", "prompt"],
+          "properties": {
+            "type": { "const": "prompt" },
+            "prompt": { "type": "string", "minLength": 1 },
+            "agent": { "type": "string", "minLength": 1 },
+            "provider": { "type": "string", "minLength": 1 },
+            "model": { "type": "string", "minLength": 1 }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["type", "prompt"],
+          "properties": {
+            "type": { "const": "approval" },
+            "prompt": { "type": "string", "minLength": 1 },
+            "captureResponse": { "type": "boolean" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["type", "title", "body"],
+          "properties": {
+            "type": { "const": "plan" },
+            "title": { "type": "string", "minLength": 1 },
+            "body": { "type": "string", "minLength": 1 },
+            "summary": { "type": "string", "minLength": 1 },
+            "waitForApproval": { "type": "boolean" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["type", "gate"],
+          "properties": {
+            "type": { "const": "gate" },
+            "gate": {
+              "type": "object",
+              "required": ["type"],
+              "properties": {
+                "type": { "enum": ["check", "policy", "human_review", "schedule"] }
+              },
+              "additionalProperties": true
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["type", "maxIterations", "body"],
+          "properties": {
+            "type": { "const": "loop" },
+            "foreach": { "type": "string", "minLength": 1 },
+            "while": { "type": "string", "minLength": 1 },
+            "until": { "type": "string", "minLength": 1 },
+            "maxIterations": { "type": "integer", "minimum": 1, "maximum": 1000 }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["type", "inline"],
+          "properties": {
+            "type": { "const": "subflow" },
+            "inline": { "type": "object" }
+          }
+        }
+      ]
+    }
+  }
+}