agent-permission 0.1.1 → 0.1.3

package/README.md

@@ -1,21 +1,43 @@
 # Agent Permission CLI
 
-Run Agent Permission checks from a terminal or install agent-readable instructions into a project.
+Give AI agents a permission gate before they touch external URLs.
 
 ## Quickstart
 
+```bash
+npx agent-permission install --adapter auto
+```
+
+This adds an Agent Permission block to the local agent instruction file, such as `AGENTS.md`, `CLAUDE.md`, or `agent-permission.chatgpt.md`, depending on the selected adapter.
+
+To install instructions and configure live checks in one step:
+
+```bash
+npx agent-permission install --adapter auto --api-key <YOUR_API_KEY>
+```
+
+Add an API key when you want live checks from the command line, CI, or agent runs:
+
 ```bash
 npx agent-permission config set api-key <YOUR_API_KEY>
-npx agent-permission check https://example.com/blog-post --action summarize --exit-code
+npx -y agent-permission@latest check https://example.com/blog-post --action summarize --exit-code
 ```
 
-## Give This To Your Agent
+## What the Agent Runs
+
+After install, project instructions tell compatible agents to run:
 
 ```bash
-npx agent-permission install --adapter auto
+npx -y agent-permission@latest check <url> --action <crawl|summarize|extract|train|transact|post> --exit-code
 ```
 
-This adds an Agent Permission block to the local agent instruction file, such as `AGENTS.md`, `CLAUDE.md`, or `agent-permission.chatgpt.md`, depending on the selected adapter.
+The first run may need npm registry network access; later runs can use the local npm cache.
+
+If the binary is already available in the agent shell, the same check can also run as:
+
+```bash
+agent-permission check <url> --action <crawl|summarize|extract|train|transact|post> --exit-code
+```
 
 ## Commands
 
@@ -23,7 +45,7 @@ This adds an Agent Permission block to the local agent instruction file, such as
 agent-permission check <url> --action <crawl|summarize|extract|train|transact|post>
 agent-permission batch --file checks.json
 agent-permission verify-receipt --file receipt.json
-agent-permission install --adapter auto|codex|claude|chatgpt|openclaw
+agent-permission install --adapter auto|codex|claude|chatgpt|openclaw [--api-key <key>]
 agent-permission config set api-key <key>
 agent-permission config doctor
 ```

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAKA,OAAO,EAAyD,KAAK,EAAuD,OAAO,EAAE,MAAM,YAAY,CAAC;AAExJ,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACxC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BzF;AA+GD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CA2BtD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAKA,OAAO,EAAyD,KAAK,EAAuD,OAAO,EAAE,MAAM,YAAY,CAAC;AAExJ,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACxC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BzF;AAgID,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CA2BtD"}

package/dist/cli.js

@@ -100,7 +100,20 @@ async function runInstall(args, runtime, io) {
     const adapter = parseAdapter(stringFlag(parsed, 'adapter') || parsed.positionals[0] || 'auto');
     const scope = parseScope(stringFlag(parsed, 'scope') || 'project');
     const result = await installAgentInstructions(adapter, scope, runtime);
-    io.stdout(`Installed Agent Permission instructions for ${result.adapter} at ${result.path}`);
+    const messages = [`Installed Agent Permission instructions for ${result.adapter} at ${result.path}`];
+    const apiKey = stringFlag(parsed, 'api-key');
+    if (apiKey) {
+        const current = await readConfig(runtime);
+        const path = await writeConfig(runtime, { ...current, apiKey });
+        messages.push(`Saved API key to ${path}`);
+    }
+    else {
+        const config = await resolveConfig(runtime);
+        if (!config.apiKey) {
+            messages.push('API key is not configured. Live checks will fail until you run `npx agent-permission config set api-key <YOUR_API_KEY>` or set AGENT_PERMISSION_API_KEY.', 'Verify setup with `npx -y agent-permission@latest config doctor`.');
+        }
+    }
+    io.stdout(messages.join('\n'));
     return 0;
 }
 async function runConfig(args, runtime, io) {
@@ -192,7 +205,7 @@ Usage:
   agent-permission check <url> --action <action> [--json] [--exit-code]
   agent-permission batch --file checks.json [--json]
   agent-permission verify-receipt --file receipt.json
-  agent-permission install --adapter auto|codex|claude|chatgpt|openclaw [--scope project|user]
+  agent-permission install --adapter auto|codex|claude|chatgpt|openclaw [--scope project|user] [--api-key <key>]
   agent-permission config set api-key <key>
   agent-permission config doctor
 

package/dist/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAK5D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAa9H;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,UAU9D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,UAqBtE"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAK5D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAa9H;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,UAU9D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,UA2BtE"}

package/dist/install.js

@@ -37,6 +37,12 @@ These instructions equip ${agentName} with Agent Permission preflight checks.
 
 Before crawling, summarizing, extracting, training on, transacting with, or posting to a URL, run:
 
+\`\`\`bash
+npx -y agent-permission@latest check <url> --action <crawl|summarize|extract|train|transact|post> --exit-code
+\`\`\`
+
+If the \`agent-permission\` binary is available in the agent shell, the same check can also run as:
+
 \`\`\`bash
 agent-permission check <url> --action <crawl|summarize|extract|train|transact|post> --exit-code
 \`\`\`
@@ -47,11 +53,15 @@ Treat \`allow\` as permitted, \`deny\` as blocked, and \`escalate\` as requiring
 }
 async function detectAdapter(runtime) {
     const claudePath = join(runtime.cwd, 'CLAUDE.md');
+    const chatgptPath = join(runtime.cwd, 'agent-permission.chatgpt.md');
     const agentsPath = join(runtime.cwd, 'AGENTS.md');
     if (await fileExists(claudePath))
         return 'claude';
-    if (await fileExists(agentsPath))
-        return 'codex';
+    if (await fileExists(chatgptPath))
+        return 'chatgpt';
+    const agents = await readFileIfExists(agentsPath);
+    if (agents !== undefined)
+        return isOpenClawInstructions(agents) ? 'openclaw' : 'codex';
     return 'codex';
 }
 function getInstructionPath(adapter, scope, runtime) {
@@ -69,14 +79,21 @@ function getInstructionPath(adapter, scope, runtime) {
     return join(runtime.cwd, 'AGENTS.md');
 }
 async function fileExists(path) {
+    return (await readFileIfExists(path)) !== undefined;
+}
+async function readFileIfExists(path) {
     try {
-        await readFile(path, 'utf8');
-        return true;
+        return await readFile(path, 'utf8');
     }
-    catch {
-        return false;
+    catch (err) {
+        if (err && typeof err === 'object' && 'code' in err && err.code === 'ENOENT')
+            return undefined;
+        throw err;
     }
 }
+function isOpenClawInstructions(content) {
+    return /\bOpenClaw\b/i.test(content);
+}
 function escapeRegExp(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-permission",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Public CLI for Agent Permission checks and agent workspace installation.",
   "type": "module",
   "bin": "./dist/index.js",