motebit 0.8.0 → 1.0.0

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "motebit",
-  "version": "0.8.0",
+  "version": "1.0.0",
   "type": "module",
-  "description": "Sovereign AI agent — persistent identity, accumulated trust, governance at the boundary",
+  "description": "Reference runtime and operator console for sovereign AI agents — REPL, daemon, delegation, MCP server. Persistent Ed25519 identity, signed execution receipts, governance at the boundary.",
   "main": "./dist/index.js",
   "bin": {
     "motebit": "./dist/index.js"
@@ -10,7 +10,9 @@
   "files": [
     "dist/index.js",
     "dist/index.js.map",
+    "schema/motebit-yaml-v1.json",
     "LICENSE",
+    "NOTICE",
     "README.md"
   ],
   "license": "BSL-1.1",
@@ -43,10 +45,19 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "@noble/curves": "^1.9.0",
     "@noble/ed25519": "~3.0.1",
-    "@noble/hashes": "~1.6.0",
+    "@noble/hashes": "~1.8.0",
+    "@solana/spl-token": "^0.4.9",
+    "@solana/web3.js": "^1.95.0",
     "sql.js": "^1.14.1",
-    "ws": "^8.20.0"
+    "vscode-jsonrpc": "^8.2.1",
+    "vscode-languageserver": "^9.0.1",
+    "vscode-languageserver-textdocument": "^1.0.12",
+    "ws": "^8.20.0",
+    "yaml": "^2.6.0",
+    "zod": "^3.25.0",
+    "zod-to-json-schema": "^3.25.2"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
@@ -54,33 +65,40 @@
     "tsx": "^4.19.0",
     "typescript": "^5.6.0",
     "vitest": "^2.1.0",
-    "@motebit/ai-core": "0.1.17",
-    "@motebit/behavior-engine": "0.1.17",
-    "@motebit/core-identity": "0.1.17",
-    "@motebit/encryption": "0.1.17",
-    "@motebit/event-log": "0.1.17",
-    "@motebit/gradient": "0.1.17",
-    "@motebit/identity-file": "0.1.17",
-    "@motebit/mcp-client": "0.1.17",
-    "@motebit/mcp-server": "0.1.17",
-    "@motebit/memory-graph": "0.1.17",
-    "@motebit/persistence": "0.1.17",
-    "@motebit/planner": "0.1.17",
-    "@motebit/policy": "0.1.17",
-    "@motebit/runtime": "0.1.17",
-    "@motebit/sdk": "0.8.0",
-    "@motebit/state-vector": "0.1.17",
-    "@motebit/sync-engine": "0.1.17",
-    "@motebit/tools": "0.1.17",
-    "@motebit/wallet-solana": "0.1.17"
+    "@motebit/ai-core": "0.2.0",
+    "@motebit/behavior-engine": "0.1.18",
+    "@motebit/core-identity": "0.1.18",
+    "@motebit/crypto": "1.0.0",
+    "@motebit/encryption": "0.2.0",
+    "@motebit/event-log": "0.1.18",
+    "@motebit/gradient": "0.1.18",
+    "@motebit/identity-file": "0.1.18",
+    "@motebit/mcp-client": "0.1.18",
+    "@motebit/mcp-server": "0.1.18",
+    "@motebit/memory-graph": "0.2.0",
+    "@motebit/persistence": "0.1.18",
+    "@motebit/planner": "0.1.18",
+    "@motebit/policy": "0.1.18",
+    "@motebit/privacy-layer": "0.1.18",
+    "@motebit/runtime": "0.2.0",
+    "@motebit/sdk": "1.0.0",
+    "@motebit/self-knowledge": "0.1.17",
+    "@motebit/state-vector": "0.1.18",
+    "@motebit/sync-engine": "0.1.18",
+    "@motebit/tools": "0.2.0",
+    "@motebit/voice": "0.1.15",
+    "@motebit/wallet-solana": "0.2.0",
+    "@motebit/wire-schemas": "0.2.0"
   },
   "scripts": {
     "start": "tsx src/index.ts",
     "build": "tsup",
+    "build-schema": "tsx scripts/build-schema.ts",
     "test": "vitest run --passWithNoTests",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src/",
+    "lint:pack": "publint --strict",
     "clean": "rm -rf dist .turbo *.tsbuildinfo"
   }
 }

package/schema/motebit-yaml-v1.json

@@ -0,0 +1,213 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/motebit/motebit/main/apps/cli/schema/motebit-yaml-v1.json",
+  "title": "motebit.yaml (v1)",
+  "description": "Declarative surface for a motebit: personality, provider, governance, MCP servers, and scheduled routines. Applied by `motebit up`.",
+  "type": "object",
+  "properties": {
+    "version": {
+      "type": "number",
+      "const": 1,
+      "description": "Schema version. Currently `1`. Pinning lets future CLI versions print a targeted error on mismatch instead of silently misinterpreting the document."
+    },
+    "name": {
+      "type": "string",
+      "description": "Display name for this motebit. Surfaces in the REPL banner and delegation listings."
+    },
+    "personality_notes": {
+      "type": "string",
+      "description": "Free-form personality guidance. Appended to the system prompt on every turn. Keep short — every token here costs on every call."
+    },
+    "temperature": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 2,
+      "description": "Sampling temperature for the default provider [0, 2]. Unset = model default. Only applied when explicitly set."
+    },
+    "max_tokens": {
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "description": "Default max output tokens per response. Overridden by `--max-tokens` at the CLI."
+    },
+    "provider": {
+      "type": "object",
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": ["byok", "paid", "sovereign"],
+          "description": "Provider mode. `byok` = bring-your-own API key (env var). `paid` = motebit cloud. `sovereign` = local on-device model (no external calls)."
+        },
+        "wireProtocol": {
+          "type": "string",
+          "enum": ["anthropic", "openai"],
+          "description": "Wire protocol the endpoint speaks. `anthropic` for Claude, `openai` for OpenAI-compatible endpoints (OpenAI, Ollama, LM Studio, vLLM)."
+        },
+        "model": {
+          "type": "string",
+          "description": "Model identifier, e.g. `claude-sonnet-4-6`, `gpt-5.4-mini`, `llama3.2`."
+        },
+        "baseUrl": {
+          "type": "string",
+          "format": "uri",
+          "description": "Override the API base URL. Used for local inference servers (`http://localhost:11434/v1` for Ollama) or routing through a proxy."
+        },
+        "maxTokens": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "description": "Upper bound on response length (model output tokens)."
+        }
+      },
+      "additionalProperties": false,
+      "description": "AI provider configuration. API keys are NEVER declared here — they're read from environment variables or the OS keyring."
+    },
+    "governance": {
+      "type": "object",
+      "properties": {
+        "approvalPreset": {
+          "type": "string",
+          "enum": ["cautious", "balanced", "autonomous"],
+          "description": "Default gate for tool calls. `cautious` = approve every sensitive call. `balanced` = approve writes, auto-approve reads. `autonomous` = auto-approve most calls."
+        },
+        "persistenceThreshold": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Memory-formation threshold [0, 1]. Higher = fewer memories formed; only strong signals persist. Typical: 0.6."
+        },
+        "rejectSecrets": {
+          "type": "boolean",
+          "description": "When true, the privacy layer blocks any tool call or outbound message whose content is classified as `secret`. Fail-closed: error on classifier failure."
+        },
+        "maxCallsPerTurn": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "description": "Per-turn tool-call ceiling. Bounds runaway loops and protects the policy gate from exhaustion attacks."
+        },
+        "maxMemoriesPerTurn": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "description": "Per-turn memory-formation ceiling. Prevents a single turn from flooding the memory graph."
+        }
+      },
+      "required": [
+        "approvalPreset",
+        "persistenceThreshold",
+        "rejectSecrets",
+        "maxCallsPerTurn",
+        "maxMemoriesPerTurn"
+      ],
+      "additionalProperties": false,
+      "description": "Governance at the boundary — surface-tension constraints that apply to every turn."
+    },
+    "mcp_servers": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Local name for the MCP server. Must be unique."
+          },
+          "transport": {
+            "type": "string",
+            "enum": ["stdio", "http"],
+            "description": "Transport. `stdio` spawns a child process; `http` connects to a URL."
+          },
+          "command": {
+            "type": "string",
+            "description": "Executable to spawn when `transport: stdio`. E.g. `npx`, `node`, `python`."
+          },
+          "args": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Argument vector passed to `command` when `transport: stdio`."
+          },
+          "url": {
+            "type": "string",
+            "format": "uri",
+            "description": "Endpoint URL when `transport: http`. Must be a full URL including scheme."
+          },
+          "env": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "description": "Environment variables set for the child process (stdio transport)."
+          },
+          "trusted": {
+            "type": "boolean",
+            "description": "Auto-approve tool calls from this server. Equivalent to promoting the server into `mcp_trusted_servers`. Off by default."
+          },
+          "motebit": {
+            "type": "boolean",
+            "description": "This server is another motebit instance — enables motebit-to-motebit transport with caller identity injected into every call."
+          },
+          "motebitType": {
+            "type": "string",
+            "enum": ["personal", "service", "collaborative"],
+            "description": "Semantic role of the peer motebit. `personal` = another device of yours. `service` = paid worker. `collaborative` = peer agent."
+          }
+        },
+        "required": ["name", "transport"],
+        "additionalProperties": false,
+        "description": "MCP server — a tool source. stdio transports spawn a subprocess; http transports dial a remote endpoint."
+      },
+      "description": "MCP tool servers to connect on start. Each entry declares transport, endpoint, and (optionally) trust status."
+    },
+    "routines": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64,
+            "pattern": "^[a-z0-9][a-z0-9_-]*$",
+            "description": "Stable identifier for the routine. Used as the upsert key — changing the id renames the routine (old one is pruned, new one added). Lowercase alphanumeric with `-` or `_`."
+          },
+          "prompt": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Natural-language prompt the agent runs on each tick. Content changes update the same goal row (preserving `created_at`)."
+          },
+          "every": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Run cadence. Interval string (`<n>m`, `<n>h`, `<n>d`). E.g. `1h` = hourly."
+          },
+          "mode": {
+            "type": "string",
+            "enum": ["recurring", "once"],
+            "default": "recurring",
+            "description": "`recurring` runs every `every` tick forever. `once` runs a single time then marks the goal completed."
+          },
+          "wall_clock": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Hard wall-clock timeout per run. Kills the turn if it exceeds this. Default: 10m."
+          },
+          "project": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Project identifier — groups goals that share context (shared memory scope)."
+          },
+          "enabled": {
+            "type": "boolean",
+            "default": true,
+            "description": "Set false to pause the routine without deleting it. Preserves state and history; resumable with no data loss."
+          }
+        },
+        "required": ["id", "prompt", "every"],
+        "additionalProperties": false,
+        "description": "A scheduled routine — compiles to exactly one Goal row. Changing fields other than `id` updates the same row in place."
+      },
+      "description": "Scheduled routines. Each compiles to exactly one Goal row; `id` is the upsert key. Re-running `motebit up` on unchanged yaml is a true no-op."
+    }
+  },
+  "required": ["version"],
+  "additionalProperties": false
+}