moltblock 0.7.3 → 0.7.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/package.json +1 -1
  2. package/skill/SKILL.md +26 -34
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "moltblock",
3
- "version": "0.7.3",
3
+ "version": "0.7.5",
4
4
  "description": "Framework for building evolving composite AI intelligences (Entities)",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
package/skill/SKILL.md CHANGED
@@ -1,15 +1,10 @@
1
1
  ---
2
2
  name: moltblock
3
3
  description: Verification gating for AI-generated artifacts. Policy checks and code verification to catch dangerous patterns before execution.
4
- version: 0.7.3
4
+ version: 0.7.5
5
5
  metadata:
6
6
  openclaw:
7
7
  requires:
8
- env:
9
- - OPENAI_API_KEY
10
- - ANTHROPIC_API_KEY
11
- - GOOGLE_API_KEY
12
- - ZAI_API_KEY
13
8
  anyBins:
14
9
  - npx
15
10
  - node
@@ -20,7 +15,7 @@ metadata:
20
15
  homepage: https://github.com/moltblock/moltblock
21
16
  install:
22
17
  - kind: node
23
- package: moltblock@0.7.3
18
+ package: moltblock@latest
24
19
  bins: [moltblock]
25
20
  ---
26
21
 
@@ -28,24 +23,30 @@ metadata:
28
23
 
29
24
  ## Description
30
25
 
31
- Moltblock provides verification gating for AI-generated artifacts. Before any high-risk action (file deletion, credential access, system modification, network exfiltration), the `moltblock_verify` tool runs policy checks and optional code verification to catch dangerous patterns.
26
+ Moltblock provides verification gating for AI-generated artifacts. It runs policy checks and optional code verification (via vitest) to catch dangerous patterns before they reach production.
27
+
28
+ **What moltblock does NOT do:**
29
+ - Does not execute generated code on your system
30
+ - Does not access, read, or modify files outside its own config
31
+ - Does not make network calls beyond the configured LLM API
32
+ - Does not store or transmit your API keys — they are read from env vars at runtime only
32
33
 
33
34
  ## When to Use
34
35
 
35
- Use `moltblock_verify` when the task involves:
36
+ Use `moltblock` when the task involves:
36
37
 
37
38
  - **High risk** (always verify): Destructive operations (`rm -rf`, `DROP TABLE`), privilege escalation (`sudo`, `chmod 777`), credential/key access (`.ssh/`, `id_rsa`, `.env`), system modification, raw disk writes
38
39
  - **Medium risk** (verify when uncertain): Network requests (`curl`, `wget`, `fetch`), file writes, database modifications, subprocess spawning, dynamic code evaluation
39
40
  - **Low risk** (skip verification): Simple text responses, math, reading public information, code that doesn't touch the filesystem or network
40
41
 
41
- ## Tool: moltblock_verify
42
+ ## Tool: moltblock
42
43
 
43
44
  Verify a task before execution.
44
45
 
45
46
  ### Usage
46
47
 
47
48
  ```bash
48
- npx moltblock "<task description>" --provider <provider> --json
49
+ npx moltblock@latest "<task description>" --provider <provider> --json
49
50
  ```
50
51
 
51
52
  ### Parameters
@@ -70,10 +71,10 @@ No API key is required — moltblock falls back to a local LLM (localhost:1234)
70
71
 
71
72
  ```bash
72
73
  # Verify a task
73
- npx moltblock "implement a function that validates email addresses" --json
74
+ npx moltblock@latest "implement a function that validates email addresses" --json
74
75
 
75
76
  # Verify code with tests
76
- npx moltblock "implement a markdown-to-html converter" --test ./tests/markdown.test.ts --json
77
+ npx moltblock@latest "implement a markdown-to-html converter" --test ./tests/markdown.test.ts --json
77
78
  ```
78
79
 
79
80
  ### Output (JSON mode)
@@ -91,47 +92,38 @@ npx moltblock "implement a markdown-to-html converter" --test ./tests/markdown.t
91
92
 
92
93
  ## Installation
93
94
 
95
+ Use directly with npx (recommended, no install needed):
96
+
94
97
  ```bash
95
- npm install -g moltblock
98
+ npx moltblock@latest "your task" --json
96
99
  ```
97
100
 
98
- Or use directly with npx (no install needed):
101
+ Or install globally:
99
102
 
100
103
  ```bash
101
- npx moltblock "your task" --json
104
+ npm install -g moltblock@latest
102
105
  ```
103
106
 
104
107
  ## Configuration
105
108
 
106
- No configuration file is required. Moltblock auto-detects your LLM provider from environment variables and falls back to sensible defaults. If you use OpenClaw, moltblock will also read your `openclaw.json` automatically.
109
+ No configuration file is required. Moltblock auto-detects your LLM provider from environment variables and falls back to sensible defaults.
107
110
 
108
- Optionally, place `moltblock.json` in your project root or `~/.moltblock/moltblock.json` to customize bindings or policy rules:
111
+ Optionally, place `moltblock.json` in your project root or `~/.moltblock/moltblock.json` to customize model bindings:
109
112
 
110
113
  ```json
111
114
  {
112
115
  "agent": {
113
116
  "bindings": {
114
- "generator": { "backend": "google", "base_url": "https://generativelanguage.googleapis.com/v1beta/openai/", "model": "gemini-2.0-flash" },
115
- "critic": { "backend": "google", "base_url": "https://generativelanguage.googleapis.com/v1beta/openai/", "model": "gemini-2.0-flash" },
116
- "judge": { "backend": "google", "base_url": "https://generativelanguage.googleapis.com/v1beta/openai/", "model": "gemini-2.0-flash" }
117
+ "generator": { "backend": "google", "model": "gemini-2.0-flash" },
118
+ "critic": { "backend": "google", "model": "gemini-2.0-flash" },
119
+ "judge": { "backend": "google", "model": "gemini-2.0-flash" }
117
120
  }
118
- },
119
- "policy": {
120
- "rules": [
121
- {
122
- "id": "custom-allow-tmp",
123
- "description": "Allow operations in /tmp",
124
- "target": "artifact",
125
- "pattern": "\\/tmp\\/",
126
- "action": "allow",
127
- "category": "destructive-cmd",
128
- "enabled": true
129
- }
130
- ]
131
121
  }
132
122
  }
133
123
  ```
134
124
 
125
+ See the [full configuration docs](https://github.com/moltblock/moltblock#configuration) for policy rules and advanced options.
126
+
135
127
  ## Source
136
128
 
137
129
  - Repository: [github.com/moltblock/moltblock](https://github.com/moltblock/moltblock)