@shield-agent/kya 0.1.33 → 0.1.35

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 (62) hide show
  1. package/.mcp.json +1 -1
  2. package/LIMITATIONS.md +1 -0
  3. package/README.md +49 -3
  4. package/amp/README.md +9 -0
  5. package/amp/settings.example.json +13 -0
  6. package/claude/claude_desktop_config.example.json +1 -1
  7. package/cline/README.md +9 -0
  8. package/cline/cline_mcp_settings.example.json +15 -0
  9. package/copilot/README.md +9 -0
  10. package/copilot/mcp-config.example.json +13 -0
  11. package/dist/cli.d.ts.map +1 -1
  12. package/dist/cli.js +32 -0
  13. package/dist/cli.js.map +1 -1
  14. package/dist/commands/connect.d.ts +21 -0
  15. package/dist/commands/connect.d.ts.map +1 -0
  16. package/dist/commands/connect.js +187 -0
  17. package/dist/commands/connect.js.map +1 -0
  18. package/dist/commands/serve-mcp.d.ts.map +1 -1
  19. package/dist/commands/serve-mcp.js +4 -0
  20. package/dist/commands/serve-mcp.js.map +1 -1
  21. package/dist/commands/wrap.d.ts.map +1 -1
  22. package/dist/commands/wrap.js +12 -0
  23. package/dist/commands/wrap.js.map +1 -1
  24. package/dist/dash/render.d.ts.map +1 -1
  25. package/dist/dash/render.js +4 -0
  26. package/dist/dash/render.js.map +1 -1
  27. package/dist/diff-preview.d.ts +12 -0
  28. package/dist/diff-preview.d.ts.map +1 -0
  29. package/dist/diff-preview.js +198 -0
  30. package/dist/diff-preview.js.map +1 -0
  31. package/dist/receipt/render-receipt.d.ts.map +1 -1
  32. package/dist/receipt/render-receipt.js +41 -2
  33. package/dist/receipt/render-receipt.js.map +1 -1
  34. package/dist/trail-summary.d.ts +2 -0
  35. package/dist/trail-summary.d.ts.map +1 -1
  36. package/dist/trail-summary.js +8 -3
  37. package/dist/trail-summary.js.map +1 -1
  38. package/dist/trail.d.ts +2 -0
  39. package/dist/trail.d.ts.map +1 -1
  40. package/dist/trail.js.map +1 -1
  41. package/droid/README.md +9 -0
  42. package/droid/mcp.example.json +13 -0
  43. package/gemini/settings.example.json +1 -1
  44. package/grok/README.md +1 -1
  45. package/kilo/README.md +9 -0
  46. package/kilo/kilo.example.json +14 -0
  47. package/kimi/README.md +9 -0
  48. package/kimi/mcp.example.json +13 -0
  49. package/kiro/README.md +9 -0
  50. package/kiro/mcp.example.json +13 -0
  51. package/manifest.json +2 -2
  52. package/mastracode/README.md +9 -0
  53. package/mastracode/mcp.example.json +13 -0
  54. package/mcp.json +1 -1
  55. package/openai/codex.config.example.toml +1 -1
  56. package/opencode/README.md +9 -0
  57. package/opencode/opencode.example.json +14 -0
  58. package/package.json +14 -3
  59. package/qwen/README.md +9 -0
  60. package/qwen/settings.example.json +13 -0
  61. package/qwen/settings.hosted.example.json +10 -0
  62. package/server.json +2 -2
@@ -2,7 +2,7 @@
2
2
  "mcpServers": {
3
3
  "shield-kya": {
4
4
  "command": "npx",
5
- "args": ["--no-install", "@shield-agent/kya@0.1.33", "serve-mcp", "--stdio"],
5
+ "args": ["--no-install", "@shield-agent/kya@0.1.35", "serve-mcp", "--stdio"],
6
6
  "env": {
7
7
  "KYA_BASE_URL": "https://shield-agent.com",
8
8
  "KYA_API_KEY": "${KYA_API_KEY}",
package/grok/README.md CHANGED
@@ -40,7 +40,7 @@ chat = client.chat.create(
40
40
  There is no grok.com stdio path. For a local agent host use the same stdio launch as Claude:
41
41
 
42
42
  ```bash
43
- npx --no-install @shield-agent/kya@0.1.33 serve-mcp --stdio
43
+ npx --no-install @shield-agent/kya@0.1.35 serve-mcp --stdio
44
44
  ```
45
45
 
46
46
  Env: `KYA_BASE_URL`, `KYA_API_KEY`, `KYA_HOST`. Codex and Gemini example configs in this package show the full snippets.
package/kilo/README.md ADDED
@@ -0,0 +1,9 @@
1
+ # Kilo Code CLI + Shield KYA
2
+
3
+ Auto-wire: `kya connect kilo` (global `~/.config/kilo/kilo.json`) or `kya connect kilo --project` (`./kilo.json`).
4
+
5
+ Manual: merge `kilo.example.json` into your config (Kilo uses the `mcp` key with `type: "local"` + a command array, same shape as OpenCode).
6
+
7
+ Verify with `kilo mcp list` — shield-kya should show three tools.
8
+
9
+ Full recipe: [docs/hosts/kilo.md](../docs/hosts/kilo.md)
@@ -0,0 +1,14 @@
1
+ {
2
+ "mcp": {
3
+ "shield-kya": {
4
+ "type": "local",
5
+ "command": ["npx", "--no-install", "@shield-agent/kya@0.1.35", "serve-mcp", "--stdio"],
6
+ "enabled": true,
7
+ "environment": {
8
+ "KYA_BASE_URL": "https://shield-agent.com",
9
+ "KYA_API_KEY": "${KYA_API_KEY}",
10
+ "KYA_HOST": "ide"
11
+ }
12
+ }
13
+ }
14
+ }
package/kimi/README.md ADDED
@@ -0,0 +1,9 @@
1
+ # Kimi Code CLI + Shield KYA
2
+
3
+ Auto-wire: `kya connect kimi` (global `~/.kimi-code/mcp.json`) or `kya connect kimi --project` (`.kimi-code/mcp.json`).
4
+
5
+ Manual: merge `mcp.example.json` into your mcp.json (classic `mcpServers` shape).
6
+
7
+ Verify from the `/mcp-config` panel — shield-kya should show three tools.
8
+
9
+ Full recipe: [docs/hosts/kimi.md](../docs/hosts/kimi.md)
@@ -0,0 +1,13 @@
1
+ {
2
+ "mcpServers": {
3
+ "shield-kya": {
4
+ "command": "npx",
5
+ "args": ["--no-install", "@shield-agent/kya@0.1.35", "serve-mcp", "--stdio"],
6
+ "env": {
7
+ "KYA_BASE_URL": "https://shield-agent.com",
8
+ "KYA_API_KEY": "${KYA_API_KEY}",
9
+ "KYA_HOST": "ide"
10
+ }
11
+ }
12
+ }
13
+ }
package/kiro/README.md ADDED
@@ -0,0 +1,9 @@
1
+ # Kiro CLI + Shield KYA
2
+
3
+ Auto-wire: `kya connect kiro` (global `~/.kiro/settings/mcp.json`) or `kya connect kiro --project` (`.kiro/settings/mcp.json`).
4
+
5
+ Manual: merge `mcp.example.json` into your mcp.json (classic `mcpServers` shape).
6
+
7
+ Verify with `kiro-cli mcp list` — shield-kya should show three tools.
8
+
9
+ Full recipe: [docs/hosts/kiro.md](../docs/hosts/kiro.md)
@@ -0,0 +1,13 @@
1
+ {
2
+ "mcpServers": {
3
+ "shield-kya": {
4
+ "command": "npx",
5
+ "args": ["--no-install", "@shield-agent/kya@0.1.35", "serve-mcp", "--stdio"],
6
+ "env": {
7
+ "KYA_BASE_URL": "https://shield-agent.com",
8
+ "KYA_API_KEY": "${KYA_API_KEY}",
9
+ "KYA_HOST": "ide"
10
+ }
11
+ }
12
+ }
13
+ }
package/manifest.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "manifest_version": "0.3",
3
3
  "name": "shield-kya",
4
4
  "display_name": "Shield KYA",
5
- "version": "0.1.33",
5
+ "version": "0.1.35",
6
6
  "description": "Know Your Agent MCP gate: ALLOW / DENY / REQUIRE_APPROVE. Sole PEP is Shield.",
7
7
  "long_description": "Local Claude Desktop extension that runs the packaged `dist/cli.js serve-mcp --stdio` against your Shield control plane (local or https://shield-agent.com). Tools evaluate policy, ingest session risk, and open Hold tickets. They never execute irreversible side effects.",
8
8
  "author": {
@@ -81,7 +81,7 @@
81
81
  "api_key": {
82
82
  "type": "string",
83
83
  "title": "API key",
84
- "description": "Machine API key (sk_live_\u2026). Stored in the OS keychain.",
84
+ "description": "Machine API key (sk_live_). Stored in the OS keychain.",
85
85
  "sensitive": true,
86
86
  "required": true
87
87
  },
@@ -0,0 +1,9 @@
1
+ # MastraCode + Shield KYA
2
+
3
+ Auto-wire: `kya connect mastracode` (global `~/.mastracode/mcp.json`) or `kya connect mastracode --project` (`.mastracode/mcp.json`). MastraCode also reads `.mcp.json`, which `kya start` already wires.
4
+
5
+ Manual: merge `mcp.example.json` into your mcp.json (classic `mcpServers` shape).
6
+
7
+ Verify from the `/mcp` status panel — shield-kya should show three tools.
8
+
9
+ Full recipe: [docs/hosts/mastracode.md](../docs/hosts/mastracode.md)
@@ -0,0 +1,13 @@
1
+ {
2
+ "mcpServers": {
3
+ "shield-kya": {
4
+ "command": "npx",
5
+ "args": ["--no-install", "@shield-agent/kya@0.1.35", "serve-mcp", "--stdio"],
6
+ "env": {
7
+ "KYA_BASE_URL": "https://shield-agent.com",
8
+ "KYA_API_KEY": "${KYA_API_KEY}",
9
+ "KYA_HOST": "ide"
10
+ }
11
+ }
12
+ }
13
+ }
package/mcp.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "shield-kya": {
4
4
  "description": "Know Your Agent local MCP gate: wrap-before-write, named-agent registry, Hold/Clear.",
5
5
  "command": "npx",
6
- "args": ["--no-install", "@shield-agent/kya@0.1.33", "serve-mcp", "--stdio"],
6
+ "args": ["--no-install", "@shield-agent/kya@0.1.35", "serve-mcp", "--stdio"],
7
7
  "env": {
8
8
  "KYA_BASE_URL": "${KYA_BASE_URL}",
9
9
  "KYA_API_KEY": "${KYA_API_KEY}",
@@ -11,7 +11,7 @@
11
11
  # --- Local stdio (OSS) ---
12
12
  [mcp_servers.shield-kya]
13
13
  command = "npx"
14
- args = ["--no-install", "@shield-agent/kya@0.1.33", "serve-mcp", "--stdio"]
14
+ args = ["--no-install", "@shield-agent/kya@0.1.35", "serve-mcp", "--stdio"]
15
15
  startup_timeout_sec = 20
16
16
  env_vars = ["KYA_BASE_URL", "KYA_API_KEY", "KYA_HOST", "KYA_AGENT_ID"]
17
17
 
@@ -0,0 +1,9 @@
1
+ # OpenCode + Shield KYA
2
+
3
+ Auto-wire: `kya connect opencode` (global `~/.config/opencode/opencode.json`) or `kya connect opencode --project` (`./opencode.json`).
4
+
5
+ Manual: merge `opencode.example.json` into your config (OpenCode uses the `mcp` key with `type: "local"` + a command array).
6
+
7
+ Restart OpenCode, then ask it to list MCP tools — `kya.policy_evaluate`, `kya.session_ingest`, `kya.request_approval` should appear.
8
+
9
+ Full recipe: [docs/hosts/opencode.md](../docs/hosts/opencode.md)
@@ -0,0 +1,14 @@
1
+ {
2
+ "mcp": {
3
+ "shield-kya": {
4
+ "type": "local",
5
+ "command": ["npx", "--no-install", "@shield-agent/kya@0.1.35", "serve-mcp", "--stdio"],
6
+ "enabled": true,
7
+ "environment": {
8
+ "KYA_BASE_URL": "https://shield-agent.com",
9
+ "KYA_API_KEY": "${KYA_API_KEY}",
10
+ "KYA_HOST": "ide"
11
+ }
12
+ }
13
+ }
14
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@shield-agent/kya",
3
- "version": "0.1.33",
3
+ "version": "0.1.35",
4
4
  "description": "Know Your Agent light CLI + local MCP gate (provider-agnostic, zero vertical packs required).",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -34,7 +34,17 @@
34
34
  ".cursor-plugin",
35
35
  "openai",
36
36
  "gemini",
37
- "grok"
37
+ "grok",
38
+ "opencode",
39
+ "kilo",
40
+ "kiro",
41
+ "qwen",
42
+ "kimi",
43
+ "mastracode",
44
+ "amp",
45
+ "copilot",
46
+ "cline",
47
+ "droid"
38
48
  ],
39
49
  "homepage": "https://shield-agent.com/install",
40
50
  "repository": {
@@ -77,6 +87,7 @@
77
87
  "test": "vitest run",
78
88
  "test:watch": "vitest",
79
89
  "test:coverage": "vitest run --coverage",
80
- "pack:check": "pnpm run build && pnpm pack --pack-destination /tmp && node dist/cli.js --help"
90
+ "pack:check": "pnpm run build && pnpm pack --pack-destination /tmp && node dist/cli.js --help",
91
+ "sync:version": "node scripts/sync-version.mjs"
81
92
  }
82
93
  }
package/qwen/README.md ADDED
@@ -0,0 +1,9 @@
1
+ # Qwen Code + Shield KYA
2
+
3
+ Auto-wire: `kya connect qwen` (global `~/.qwen/settings.json`) or `kya connect qwen --project` (`.qwen/settings.json`).
4
+
5
+ Manual: merge `settings.example.json` (stdio) or `settings.hosted.example.json` (hosted HTTP via `httpUrl`) into your settings.
6
+
7
+ Verify with `qwen mcp list` — shield-kya should show three tools.
8
+
9
+ Full recipe: [docs/hosts/qwen.md](../docs/hosts/qwen.md)
@@ -0,0 +1,13 @@
1
+ {
2
+ "mcpServers": {
3
+ "shield-kya": {
4
+ "command": "npx",
5
+ "args": ["--no-install", "@shield-agent/kya@0.1.35", "serve-mcp", "--stdio"],
6
+ "env": {
7
+ "KYA_BASE_URL": "https://shield-agent.com",
8
+ "KYA_API_KEY": "${KYA_API_KEY}",
9
+ "KYA_HOST": "ide"
10
+ }
11
+ }
12
+ }
13
+ }
@@ -0,0 +1,10 @@
1
+ {
2
+ "mcpServers": {
3
+ "shield-kya": {
4
+ "httpUrl": "https://shield-agent.com/mcp",
5
+ "headers": {
6
+ "Authorization": "Bearer ${KYA_API_KEY}"
7
+ }
8
+ }
9
+ }
10
+ }
package/server.json CHANGED
@@ -7,12 +7,12 @@
7
7
  "url": "https://github.com/The-Pixel-Boys/shield-kya",
8
8
  "source": "github"
9
9
  },
10
- "version": "0.1.33",
10
+ "version": "0.1.35",
11
11
  "packages": [
12
12
  {
13
13
  "registryType": "npm",
14
14
  "identifier": "@shield-agent/kya",
15
- "version": "0.1.33",
15
+ "version": "0.1.35",
16
16
  "transport": {
17
17
  "type": "stdio"
18
18
  },