total-recall-brain 3.41.4 → 3.41.6

package/scaffold/.agent/skills/total-recall/plugins/cli-agents/README.md

@@ -1,65 +0,0 @@
-# Command Fleet
-
-All nine adapters share one plugin: Claude Code, Codex, Antigravity, Cursor,
-DSH, Grok, Muse, Pi and Hermes. `runtime <agent> ...` exposes their native runtime
-commands; DSH observations and Hermes gateway management live here as well.
-
-`total-recall cli-agents setup` connects all nine native instruction surfaces.
-The declared setup operation also runs during daemon-owned plugin refresh.
-Every dispatched agent receives a freshly checked Total Recall context, complete
-core help, installed plugin operations and composed commands. Setup failure or
-an unready context stops dispatch.
-
-`docs-refresh`, `docs-ensure`, `docs-status`, `docs-read` and `docs-search` manage
-downloaded official documentation rather than a list of links. Content is hashed,
-bounded and refreshed after 24 hours. Maintenance uses the existing Total Recall
-daemon's plugin task, refreshing one stale adapter per run. Failed pages remain
-visible as failures and cannot certify complete coverage; successful cached
-content remains readable. `setup --node <recorded-node>` selects maintenance
-placement without creating a second scheduler.
-
-Standalone Total Recall owner for CLI-agent discovery and explicit mesh command execution. Install with `total-recall plugin install <path-or-private-git-url>`. Installation rebuilds the plugin inventory, CLI library and connected instruction surfaces. No model account is created or selected automatically.
-
-```sh
-total-recall cli-agents catalog --json
-total-recall cli-agents nodes --json
-total-recall cli-agents inspect --node <recorded-node> --json
-total-recall cli-agents run-command --stdin --json < request.json
-```
-
-`request.json` selects one installed plugin operation, its literal arguments, a node and an agent:
-
-```json
-{
-  "pluginId": "git-sentinel",
-  "subcommand": "status",
-  "args": [],
-  "execution": {
-    "agent": "codex",
-    "node": "local",
-    "permissions": { "read": true, "write": false, "send": false, "destructive": false }
-  }
-}
-```
-
-For remote nodes, supply `execution.cwd` as an explicit absolute workspace. `agent: "direct"` runs the actual installed Total Recall CLI without a model. Remote access comes from recorded mesh entities and verified SSH configuration; unavailable nodes or binaries produce errors. Secrets are never accepted in an agent prompt. Existing account metadata is inspected without printing credentials or substituting provider API keys.
-
-The four permissions are strict boolean **command-effect admission controls**. They allow or deny the selected plugin command before dispatch. They are not a network policy or an OS sandbox for every action a model might propose. Supported adapter write modes are scoped through the vendor CLI; vendor approval and sandbox defaults stay enabled. The host's authenticated authorization still applies.
-
-A completed model turn is distinct from a completed plugin operation. Structured results return `commandExecutionVerified: false` for agent turns; only direct CLI execution returns a command exit receipt. Muse preserves its actual headless JSONL log and documented process exit status rather than treating session-protocol notifications as headless output. Do not infer working accounts, provider delivery or successful mutations from discovery or fixture tests.
-
-## Primary contracts checked 2026-10-14
-
-| Adapter | Contract |
-| --- | --- |
-| Claude Code | [Headless](https://code.claude.com/docs/en/headless) |
-| Codex | [Non-interactive mode](https://developers.openai.com/codex/noninteractive) |
-| Antigravity | [Headless CLI](https://antigravity.google/docs/cli/headless/) |
-| Cursor | [CLI parameters](https://docs.cursor.com/en/cli/reference/parameters) |
-| DSH | [Official CLI source](https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/README.md) |
-| Grok | [Headless scripting](https://docs.x.ai/build/cli/headless-scripting) |
-| Muse | [Headless and CI](https://dev.meta.ai/docs/muse-code/extending) |
-| Pi | [Official CLI reference](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/cli.md) |
-| Hermes | [Official command reference](https://github.com/NousResearch/hermes-agent/blob/main/website/docs/reference/cli-commands.md) |
-
-Cursor discovery uses `cursor-agent`; an ambiguous `agent` binary is not assumed to be Cursor. Missing installations are listed as unavailable. Unknown authentication requires explicit agent selection and remains unverified until a real run. Tests exercise literal stdin, bounded child-process cleanup, command admission, recorded SSH access, account checks and completed-result parsing. Run suites on the configured sanctioned test node.

package/scaffold/.agent/skills/total-recall/plugins/cli-agents/cli.mjs

@@ -1,76 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { pathToFileURL } from 'node:url';
-import { ADAPTERS, inspectAgents } from './src/worker.mjs';
-import { inspectNode, listTargets, executeCommand, executeOnNode } from './src/executor.mjs';
-import { DOC_SOURCES, documentationStatus, refreshDocumentation, ensureDocumentation, maintainDocumentation, readDocumentation, searchDocumentation } from './src/documentation.mjs';
-import { manageRuntime } from './src/runtime.mjs';
-import { setupIntegrations } from './src/setup.mjs';
-
-export async function run(argv = []) {
-  const args = argv.slice(3); const operation = args[0] || 'status';
-  if (['--help', '-h', 'help'].includes(operation)) {
-    const manifest=JSON.parse(fs.readFileSync(new URL('./plugin.json',import.meta.url),'utf8'));
-    console.log('Usage: total-recall cli-agents <operation> [options]\nEvery agent receives Total Recall bootstrap before dispatch. Runtime syntax: runtime <agent> <native-command...> [--node ID].\n');
-    for(const command of manifest.cli.subcommands)console.log(`  ${command.name} ${(command.args || []).map(arg=>arg.flag?`${arg.flag} <${arg.name}>`:`<${arg.name}>`).join(' ')} — ${command.description}`);
-    return;
-  }
-  let result;
-  if (operation === 'status') result = {...await inspectAgents(),documentation:documentationStatus()};
-  else if (operation === 'catalog') result = { adapters: ADAPTERS, permissions: ['read', 'write', 'send', 'destructive'] };
-  else if (operation === 'nodes') result = await listTargets();
-  else if(operation==='docs-sources')result={sources:DOC_SOURCES};
-  else if(operation==='docs-read' || operation==='docs-search') {
-    const option=name=>{const i=args.indexOf(name);if(i<0)return undefined;if(!args[i+1] || args[i+1].startsWith('--'))throw new Error(`${name} requires a value`);return args[i+1];};
-    result=operation==='docs-read'?readDocumentation({agent:option('--agent'),url:option('--url')}):searchDocumentation({agent:option('--agent'),query:option('--query')});
-  }
-  else if(operation==='setup') {
-    const index=args.indexOf('--node');
-    if(index>=0 && (!args[index+1] || args[index+1].startsWith('-')))throw new Error('--node requires a recorded node');
-    result=await setupIntegrations({node:index>=0?args[index+1]:undefined});
-  }
-  else if (['docs-status','docs-refresh','docs-ensure','maintenance'].includes(operation)) {
-    const selected = args.indexOf('--agent');
-    if (selected>=0 && (!args[selected+1] || args[selected+1].startsWith('-'))) throw new Error('--agent requires an adapter identifier');
-    const options = selected>=0 ? {agent:args[selected+1]} : {};
-    if(operation==='maintenance') {
-      const setup=await setupIntegrations();
-      result={...await maintainDocumentation(options),setup};
-    } else result = operation==='docs-status' ? documentationStatus(options) : operation==='docs-ensure' ? await ensureDocumentation(options) : await refreshDocumentation(options);
-    if(!result.ok)process.exitCode=1;
-  }
-  else if (operation === 'runtime') {
-    const runtimeArgs=args.slice(1).filter(arg=>arg!=='--json'), agent=runtimeArgs.shift();
-    const index=runtimeArgs.indexOf('--node'); let node='local';
-    if(index>=0){node=runtimeArgs[index+1];if(!node || node.startsWith('-'))throw new Error('--node requires an identifier');runtimeArgs.splice(index,2);}
-    result = node==='local' ? await manageRuntime(agent,runtimeArgs) : await executeOnNode(node,{operation:'direct',cwd:process.cwd(),argv:['total-recall','cli-agents','runtime',agent,...runtimeArgs,'--json']});
-    if(!result.ok)process.exitCode=1;
-  }
-  else if(operation==='dispatch') {
-    if(!args.includes('--stdin'))throw new Error('Task requests must arrive through stdin');
-    const input=fs.readFileSync(0,'utf8');if(Buffer.byteLength(input)>65536)throw new Error('Task request too large');
-    const request=JSON.parse(input);
-    result=await executeOnNode(request.node || 'local',{...request,operation:'dispatch'});
-    if(!result.ok)process.exitCode=1;
-  }
-  else if (operation === 'inspect') {
-    const index = args.indexOf('--node');
-    if (index >= 0 && (!args[index + 1] || args[index + 1].startsWith('--'))) throw new Error('--node requires a recorded node identifier');
-    result = await inspectNode(index >= 0 ? args[index + 1] : 'local');
-  }
-  else if (operation === 'run-command') {
-    if (!args.includes('--stdin')) throw new Error('Supply the command request through stdin');
-    const input = fs.readFileSync(0, 'utf8'); if (Buffer.byteLength(input) > 65536) throw new Error('Command request is too large');
-    const request = JSON.parse(input);
-    const root = process.env.TR_PACKAGE_ROOT;
-    if (!root) throw new Error('Native host context required');
-    if (!path.isAbsolute(root)) throw new Error('Absolute native host context required');
-    if (JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).name !== 'total-recall-brain') throw new Error('Native host identity mismatch');
-    const { getPlugin } = await import(pathToFileURL(path.join(root, 'src/core/plugin-loader.mjs')));
-    const plugin = getPlugin(request.pluginId, request.projectRoot || process.cwd());
-    result = await executeCommand({ ...request, plugin });
-    if (!result.ok) process.exitCode = 1;
-  } else throw new Error('Unknown CLI-agents operation');
-  console.log(JSON.stringify(result));
-}
-export default run;

package/scaffold/.agent/skills/total-recall/plugins/cli-agents/package.json

@@ -1,19 +0,0 @@
-{
-  "name": "tr-plugin-cli-agents",
-  "version": "0.2.0",
-  "type": "module",
-  "scripts": {
-    "test": "node --test test/*.test.mjs"
-  },
-  "files": [
-    "cli.mjs",
-    "plugin.json",
-    "README.md",
-    "src/",
-    "!src/**/*.spec.mjs",
-    "ui/"
-  ],
-  "publishConfig": {
-    "access": "public"
-  }
-}

package/scaffold/.agent/skills/total-recall/plugins/cli-agents/plugin.json

@@ -1,266 +0,0 @@
-{
-  "id": "cli-agents",
-  "name": "Command Fleet",
-  "version": "0.2.0",
-  "description": "Discover, configure, document and run CLI agents through Total Recall on selected mesh nodes.",
-  "cli": {
-    "command": "cli-agents",
-    "handler": "cli.mjs",
-    "subcommands": [
-      {
-        "name": "status",
-        "description": "Inspect local agent binaries and authentication metadata",
-        "effect": "read",
-        "output": "json",
-        "args": []
-      },
-      {
-        "name": "catalog",
-        "description": "List documented adapter contracts and source references",
-        "effect": "read",
-        "output": "json",
-        "args": []
-      },
-      {
-        "name": "nodes",
-        "description": "List recorded mesh targets without probing or changing them",
-        "effect": "read",
-        "output": "json",
-        "args": []
-      },
-      {
-        "name": "inspect",
-        "description": "Inspect installed harnesses on a selected node",
-        "effect": "read",
-        "output": "json",
-        "args": [
-          {
-            "name": "node",
-            "flag": "--node",
-            "type": "string",
-            "label": "Mesh node"
-          }
-        ],
-        "timeout_ms": 120000
-      },
-      {
-        "name": "run-command",
-        "description": "Run an explicit plugin command through the selected agent and node using a JSON request on stdin",
-        "effect": "write",
-        "output": "json",
-        "args": [],
-        "timeout_ms": 600000
-      },
-      {
-        "name": "runtime",
-        "description": "Manage any agent runtime; includes Hermes gateway/auth/skills/plugins and DSH observations",
-        "effect": "write",
-        "output": "json",
-        "args": [
-          {
-            "name": "agent",
-            "type": "string",
-            "label": "Agent adapter",
-            "required": true,
-            "positional": true
-          },
-          {
-            "name": "operation",
-            "type": "string",
-            "label": "Native operation",
-            "required": true,
-            "positional": true
-          }
-        ],
-        "timeout_ms": 120000
-      },
-      {
-        "name": "dispatch",
-        "description": "Run a task from stdin after automatic Total Recall bootstrap",
-        "effect": "write",
-        "output": "json",
-        "args": [],
-        "timeout_ms": 120000
-      },
-      {
-        "name": "docs-status",
-        "description": "Verify cached official documentation coverage freshness and hashes",
-        "effect": "read",
-        "output": "json",
-        "args": [
-          {
-            "name": "agent",
-            "flag": "--agent",
-            "type": "string",
-            "label": "Agent adapter"
-          }
-        ],
-        "timeout_ms": 120000
-      },
-      {
-        "name": "docs-refresh",
-        "description": "Download complete official agent documentation and retain last-good content on failure",
-        "effect": "write",
-        "output": "json",
-        "args": [
-          {
-            "name": "agent",
-            "flag": "--agent",
-            "type": "string",
-            "label": "Agent adapter"
-          }
-        ],
-        "timeout_ms": 600000
-      },
-      {
-        "name": "docs-ensure",
-        "description": "Refresh missing or stale documentation automatically",
-        "effect": "write",
-        "output": "json",
-        "args": [
-          {
-            "name": "agent",
-            "flag": "--agent",
-            "type": "string",
-            "label": "Agent adapter"
-          }
-        ],
-        "timeout_ms": 600000
-      },
-      {
-        "name": "maintenance",
-        "description": "Total Recall daemon maintenance: current official documentation and integration surfaces",
-        "effect": "write",
-        "output": "json",
-        "args": [],
-        "timeout_ms": 600000
-      },
-      {
-        "name": "setup",
-        "description": "Configure supported agent instruction surfaces and daemon task placement",
-        "effect": "write",
-        "output": "json",
-        "args": [
-          {
-            "name": "node",
-            "flag": "--node",
-            "type": "string",
-            "label": "Maintenance mesh node"
-          }
-        ],
-        "timeout_ms": 120000
-      },
-      {
-        "name": "docs-sources",
-        "description": "List approved official documentation sources",
-        "effect": "read",
-        "output": "json",
-        "args": []
-      },
-      {
-        "name": "docs-read",
-        "description": "Read integrity-checked cached official documentation",
-        "effect": "read",
-        "output": "json",
-        "args": [
-          {
-            "name": "agent",
-            "flag": "--agent",
-            "type": "string",
-            "label": "Agent"
-          },
-          {
-            "name": "url",
-            "flag": "--url",
-            "type": "string",
-            "label": "Url"
-          }
-        ]
-      },
-      {
-        "name": "docs-search",
-        "description": "Search downloaded official documentation",
-        "effect": "read",
-        "output": "json",
-        "args": [
-          {
-            "name": "agent",
-            "flag": "--agent",
-            "type": "string",
-            "label": "Agent"
-          },
-          {
-            "name": "query",
-            "flag": "--query",
-            "type": "string",
-            "required": true,
-            "label": "Query"
-          }
-        ]
-      }
-    ]
-  },
-  "runtime": {
-    "modules": {
-      "command-executor": "src/executor.mjs",
-      "documentation": "src/documentation.mjs",
-      "agent-runtime": "src/runtime.mjs"
-    },
-    "setup_command": "setup"
-  },
-  "branding": {
-    "name": "Command Fleet",
-    "color": "#184e47",
-    "accent": "#dbb76a",
-    "background": "#f3eee3",
-    "font": "system"
-  },
-  "ui": {
-    "elements": [
-      {
-        "id": "fleet-card",
-        "kind": "card",
-        "tag": "command-fleet-card",
-        "module": "ui/card.js",
-        "description": "Installed agent fleet"
-      }
-    ]
-  },
-  "card_face": {
-    "quick_actions": [
-      {
-        "subcommand": "status",
-        "label": "Local agents"
-      },
-      {
-        "subcommand": "nodes",
-        "label": "Mesh nodes"
-      },
-      {
-        "subcommand": "catalog",
-        "label": "Adapters"
-      }
-    ]
-  },
-  "auth": {
-    "plugin": "auth",
-    "methods": [
-      "passkey",
-      "google-oauth2"
-    ],
-    "session_verification": true
-  },
-  "distribution": {
-    "tier": "official",
-    "license": "open"
-  },
-  "tasks": [
-    {
-      "intent": "Keep official agent documentation and Total Recall integrations current",
-      "schedule": "*/15 * * * *",
-      "command": "maintenance",
-      "placement": "selected-node",
-      "timeout_ms": 600000
-    }
-  ]
-}