moltblock 0.7.4 → 0.7.6

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 +25 -28
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "moltblock",
3
- "version": "0.7.4",
3
+ "version": "0.7.6",
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,7 +1,7 @@
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.4
4
+ version: 0.7.6
5
5
  metadata:
6
6
  openclaw:
7
7
  requires:
@@ -15,7 +15,7 @@ metadata:
15
15
  homepage: https://github.com/moltblock/moltblock
16
16
  install:
17
17
  - kind: node
18
- package: moltblock@0.7.4
18
+ package: moltblock@0.7.6
19
19
  bins: [moltblock]
20
20
  ---
21
21
 
@@ -23,24 +23,30 @@ metadata:
23
23
 
24
24
  ## Description
25
25
 
26
- 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:**
29
+ - Generates code via LLM API calls, then runs policy checks against the output
30
+ - When `--test` is provided, executes vitest to verify generated code against the test file
31
+ - Reads its own config files (`moltblock.json`, `~/.moltblock/moltblock.json`) if present
32
+ - API keys are read from environment variables at runtime — never stored or transmitted beyond the configured LLM provider
27
33
 
28
34
  ## When to Use
29
35
 
30
- Use `moltblock_verify` when the task involves:
36
+ Use `moltblock` when the task involves:
31
37
 
32
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
33
39
  - **Medium risk** (verify when uncertain): Network requests (`curl`, `wget`, `fetch`), file writes, database modifications, subprocess spawning, dynamic code evaluation
34
40
  - **Low risk** (skip verification): Simple text responses, math, reading public information, code that doesn't touch the filesystem or network
35
41
 
36
- ## Tool: moltblock_verify
42
+ ## Tool: moltblock
37
43
 
38
44
  Verify a task before execution.
39
45
 
40
46
  ### Usage
41
47
 
42
48
  ```bash
43
- npx moltblock "<task description>" --provider <provider> --json
49
+ npx moltblock@0.7.6 "<task description>" --provider <provider> --json
44
50
  ```
45
51
 
46
52
  ### Parameters
@@ -65,10 +71,10 @@ No API key is required — moltblock falls back to a local LLM (localhost:1234)
65
71
 
66
72
  ```bash
67
73
  # Verify a task
68
- npx moltblock "implement a function that validates email addresses" --json
74
+ npx moltblock@0.7.6 "implement a function that validates email addresses" --json
69
75
 
70
76
  # Verify code with tests
71
- npx moltblock "implement a markdown-to-html converter" --test ./tests/markdown.test.ts --json
77
+ npx moltblock@0.7.6 "implement a markdown-to-html converter" --test ./tests/markdown.test.ts --json
72
78
  ```
73
79
 
74
80
  ### Output (JSON mode)
@@ -86,47 +92,38 @@ npx moltblock "implement a markdown-to-html converter" --test ./tests/markdown.t
86
92
 
87
93
  ## Installation
88
94
 
95
+ Use directly with npx (recommended, no install needed):
96
+
89
97
  ```bash
90
- npm install -g moltblock
98
+ npx moltblock@0.7.6 "your task" --json
91
99
  ```
92
100
 
93
- Or use directly with npx (no install needed):
101
+ Or install globally:
94
102
 
95
103
  ```bash
96
- npx moltblock "your task" --json
104
+ npm install -g moltblock@0.7.6
97
105
  ```
98
106
 
99
107
  ## Configuration
100
108
 
101
109
  No configuration file is required. Moltblock auto-detects your LLM provider from environment variables and falls back to sensible defaults.
102
110
 
103
- 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:
104
112
 
105
113
  ```json
106
114
  {
107
115
  "agent": {
108
116
  "bindings": {
109
- "generator": { "backend": "google", "base_url": "https://generativelanguage.googleapis.com/v1beta/openai/", "model": "gemini-2.0-flash" },
110
- "critic": { "backend": "google", "base_url": "https://generativelanguage.googleapis.com/v1beta/openai/", "model": "gemini-2.0-flash" },
111
- "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" }
112
120
  }
113
- },
114
- "policy": {
115
- "rules": [
116
- {
117
- "id": "custom-allow-tmp",
118
- "description": "Allow operations in /tmp",
119
- "target": "artifact",
120
- "pattern": "\\/tmp\\/",
121
- "action": "allow",
122
- "category": "destructive-cmd",
123
- "enabled": true
124
- }
125
- ]
126
121
  }
127
122
  }
128
123
  ```
129
124
 
125
+ See the [full configuration docs](https://github.com/moltblock/moltblock#configuration) for policy rules and advanced options.
126
+
130
127
  ## Source
131
128
 
132
129
  - Repository: [github.com/moltblock/moltblock](https://github.com/moltblock/moltblock)