mirror of
https://github.com/binaricat/Netcatty.git
synced 2026-11-21 15:41:17 +00:00
Expose snippets and automation scripts to Catty, MCP, and CLI with full run lifecycle, vault bridge CRUD, and clickable tool-result cards in the chat message list. Co-authored-by: Cursor <cursoragent@cursor.com>
603 lines
19 KiB
JavaScript
603 lines
19 KiB
JavaScript
"use strict";
|
|
|
|
const { CAPABILITY_STATUS } = require("../constants.cjs");
|
|
|
|
/** @type {import("../types.cjs").CapabilityDefinition[]} */
|
|
const VAULT_CAPABILITIES = [
|
|
{
|
|
id: "vault.host.get",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Get host metadata from the vault.",
|
|
policy: {
|
|
write: false,
|
|
sensitiveRead: true,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: true,
|
|
bypassesChatCancel: true,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["vault", "host", "get"] },
|
|
global: { rpcMethod: "vault/host/get" },
|
|
public: { rpcMethod: "public/vault/host/get", mcpTool: "host_get" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.host.list",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "List saved hosts in the vault (metadata only — no passwords or keys).",
|
|
policy: {
|
|
write: false,
|
|
sensitiveRead: true,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: true,
|
|
bypassesChatCancel: true,
|
|
},
|
|
surfaces: {
|
|
global: { rpcMethod: "vault/hosts/list" },
|
|
public: { rpcMethod: "public/vault/hosts/list", mcpTool: "vault_hosts_list" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.hosts.create",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Create vault hosts from structured host objects. Use when the user wants to add/create a host (Vault → Hosts). NOT for Vault → Notes sidebar documentation.",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
global: { rpcMethod: "vault/hosts/create" },
|
|
public: { rpcMethod: "public/vault/hosts/create", mcpTool: "vault_hosts_create" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.host.import",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Parse known host export file formats (PuTTY, MobaXterm, CSV, SecureCRT, ssh_config) into vault hosts. For arbitrary unstructured text, map to host objects and use vault_hosts_create instead.",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
global: { rpcMethod: "vault/hosts/import" },
|
|
public: { rpcMethod: "public/vault/hosts/import", mcpTool: "vault_hosts_import" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.host.notes.get",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Read host metadata notes attached to a saved host (Host Details panel — not Vault sidebar Notes).",
|
|
policy: {
|
|
write: false,
|
|
sensitiveRead: true,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: true,
|
|
bypassesChatCancel: true,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["vault", "host-notes", "get"] },
|
|
global: { rpcMethod: "vault/host/notes/get" },
|
|
public: { rpcMethod: "public/vault/hostNotes/get", mcpTool: "host_notes_get" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.host.notes.set",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Update host metadata notes on a saved host (Host Details panel — not Vault sidebar Notes).",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["vault", "host-notes", "set"] },
|
|
global: { rpcMethod: "vault/host/notes/set" },
|
|
public: { rpcMethod: "public/vault/hostNotes/set", mcpTool: "host_notes_set" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.note.list",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "List notes in Vault → Notes (markdown notes visible in the vault sidebar).",
|
|
policy: {
|
|
write: false,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: true,
|
|
bypassesChatCancel: true,
|
|
},
|
|
surfaces: {
|
|
global: { rpcMethod: "vault/notes/list" },
|
|
public: { rpcMethod: "public/vault/notes/list", mcpTool: "vault_notes_list" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.note.get",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Get a Vault → Notes entry by id (full markdown content).",
|
|
policy: {
|
|
write: false,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: true,
|
|
bypassesChatCancel: true,
|
|
},
|
|
surfaces: {
|
|
global: { rpcMethod: "vault/notes/get" },
|
|
public: { rpcMethod: "public/vault/notes/get", mcpTool: "vault_notes_get" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.note.create",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Create a note in Vault → Notes sidebar (markdown documentation). NOT for adding SSH hosts — use vault_hosts_create for that.",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
global: { rpcMethod: "vault/notes/create" },
|
|
public: { rpcMethod: "public/vault/notes/create", mcpTool: "vault_notes_create" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.note.update",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Update an existing Vault → Notes entry by id.",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
global: { rpcMethod: "vault/notes/update" },
|
|
public: { rpcMethod: "public/vault/notes/update", mcpTool: "vault_notes_update" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.snippets.list",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "List code snippets stored in the vault.",
|
|
policy: {
|
|
write: false,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: true,
|
|
bypassesChatCancel: true,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["snippets", "list"] },
|
|
global: { rpcMethod: "vault/snippets/list" },
|
|
public: { rpcMethod: "public/vault/snippets/list", mcpTool: "snippets_list" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.snippets.get",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Get a single code snippet from the vault.",
|
|
policy: {
|
|
write: false,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: true,
|
|
bypassesChatCancel: true,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["snippets", "get"] },
|
|
global: { rpcMethod: "vault/snippets/get" },
|
|
public: { rpcMethod: "public/vault/snippets/get", mcpTool: "snippets_get" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.snippets.run",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Run a vault snippet or automation script in a terminal session. Text snippets paste shell commands; scripts (kind=script) run via the nct JavaScript runtime.",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: true,
|
|
requiresChatSession: true,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["snippets", "run"] },
|
|
global: { rpcMethod: "vault/snippets/run" },
|
|
public: { rpcMethod: "public/vault/snippets/run", mcpTool: "snippets_run" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.snippets.create",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Create a vault snippet or automation script (set kind=script for nct automation).",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["snippets", "create"] },
|
|
global: { rpcMethod: "vault/snippets/create" },
|
|
public: { rpcMethod: "public/vault/snippets/create", mcpTool: "snippets_create" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.snippets.update",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Update an existing vault snippet or automation script by id.",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["snippets", "update"] },
|
|
global: { rpcMethod: "vault/snippets/update" },
|
|
public: { rpcMethod: "public/vault/snippets/update", mcpTool: "snippets_update" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.snippets.delete",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Delete a vault snippet or automation script by id.",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["snippets", "delete"] },
|
|
global: { rpcMethod: "vault/snippets/delete" },
|
|
public: { rpcMethod: "public/vault/snippets/delete", mcpTool: "snippets_delete" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.scripts.list",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "List automation scripts (kind=script) in the vault.",
|
|
policy: {
|
|
write: false,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: true,
|
|
bypassesChatCancel: true,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["scripts", "list"] },
|
|
global: { rpcMethod: "vault/scripts/list" },
|
|
public: { rpcMethod: "public/vault/scripts/list", mcpTool: "scripts_list" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.scripts.get",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Get a single automation script including JavaScript source.",
|
|
policy: {
|
|
write: false,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: true,
|
|
bypassesChatCancel: true,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["scripts", "get"] },
|
|
global: { rpcMethod: "vault/scripts/get" },
|
|
public: { rpcMethod: "public/vault/scripts/get", mcpTool: "scripts_get" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.scripts.create",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Create an automation script using the nct JavaScript API. Call scripts_reference first when authoring nct automation.",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["scripts", "create"] },
|
|
global: { rpcMethod: "vault/scripts/create" },
|
|
public: { rpcMethod: "public/vault/scripts/create", mcpTool: "scripts_create" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.scripts.update",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Update an automation script by id (partial fields).",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["scripts", "update"] },
|
|
global: { rpcMethod: "vault/scripts/update" },
|
|
public: { rpcMethod: "public/vault/scripts/update", mcpTool: "scripts_update" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.scripts.delete",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Delete an automation script and remove host connect bindings.",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["scripts", "delete"] },
|
|
global: { rpcMethod: "vault/scripts/delete" },
|
|
public: { rpcMethod: "public/vault/scripts/delete", mcpTool: "scripts_delete" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.scripts.run",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Run an automation script in a terminal session via the nct runtime. Set wait=true to block until completion.",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: true,
|
|
requiresChatSession: true,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["scripts", "run"] },
|
|
global: { rpcMethod: "vault/scripts/run" },
|
|
public: { rpcMethod: "public/vault/scripts/run", mcpTool: "scripts_run" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.scripts.reference",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Return Netcatty automation script syntax: nct API, triggers, host targeting, and source wrapping rules.",
|
|
policy: {
|
|
write: false,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: true,
|
|
bypassesChatCancel: true,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["scripts", "reference"] },
|
|
global: { rpcMethod: "vault/scripts/reference" },
|
|
public: { rpcMethod: "public/vault/scripts/reference", mcpTool: "scripts_reference" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.scripts.runs.list",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "List automation script runs (optionally filter by sessionId).",
|
|
policy: {
|
|
write: false,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: true,
|
|
bypassesChatCancel: true,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["scripts", "runs", "list"] },
|
|
global: { rpcMethod: "vault/scripts/runs/list" },
|
|
public: { rpcMethod: "public/vault/scripts/runs/list", mcpTool: "scripts_runs_list" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.scripts.run.stop",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Stop a running automation script by runId.",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: true,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["scripts", "run", "stop"] },
|
|
global: { rpcMethod: "vault/scripts/run/stop" },
|
|
public: { rpcMethod: "public/vault/scripts/run/stop", mcpTool: "scripts_run_stop" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.scripts.run.pause",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Pause a running automation script by runId.",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: true,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["scripts", "run", "pause"] },
|
|
global: { rpcMethod: "vault/scripts/run/pause" },
|
|
public: { rpcMethod: "public/vault/scripts/run/pause", mcpTool: "scripts_run_pause" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.scripts.run.resume",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Resume a paused automation script by runId.",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: true,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["scripts", "run", "resume"] },
|
|
global: { rpcMethod: "vault/scripts/run/resume" },
|
|
public: { rpcMethod: "public/vault/scripts/run/resume", mcpTool: "scripts_run_resume" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.scripts.targets.set",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Set host targets or targetsAllHosts for an automation script. onConnect scripts sync host connect queues.",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["scripts", "targets", "set"] },
|
|
global: { rpcMethod: "vault/scripts/targets/set" },
|
|
public: { rpcMethod: "public/vault/scripts/targets/set", mcpTool: "scripts_targets_set" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.host.connectScripts.list",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "List resolved onConnect automation scripts for a host (global scripts first, then host queue).",
|
|
policy: {
|
|
write: false,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: true,
|
|
bypassesChatCancel: true,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["vault", "host", "connect-scripts", "list"] },
|
|
global: { rpcMethod: "vault/host/connectScripts/list" },
|
|
public: { rpcMethod: "public/vault/hostConnectScripts/list", mcpTool: "host_connect_scripts_list" },
|
|
},
|
|
},
|
|
{
|
|
id: "vault.host.connectScripts.set",
|
|
domain: "vault",
|
|
status: CAPABILITY_STATUS.IMPLEMENTED,
|
|
description: "Set ordered onConnect script IDs for a host (host-specific queue; globals run separately).",
|
|
policy: {
|
|
write: true,
|
|
sensitiveRead: false,
|
|
longRunning: false,
|
|
requiresChatSession: false,
|
|
bypassesObserverBlock: false,
|
|
bypassesApproval: false,
|
|
bypassesChatCancel: false,
|
|
},
|
|
surfaces: {
|
|
cli: { command: ["vault", "host", "connect-scripts", "set"] },
|
|
global: { rpcMethod: "vault/host/connectScripts/set" },
|
|
public: { rpcMethod: "public/vault/hostConnectScripts/set", mcpTool: "host_connect_scripts_set" },
|
|
},
|
|
},
|
|
];
|
|
|
|
module.exports = { VAULT_CAPABILITIES };
|