Module m4a_adopt 

Adoption of a provider session the node did not spawn: the node gives it a per-session m4a account and puts the node’s own m4a MCP server (m4a-agent mcp, stdio) in the provider’s config, removing a stale standalone mailbox MCP entry (a loopback HTTP url) with a backup.

POST /m4a/adopt?provider=<id>&session=<provider session id>[&stale=<entry name>] (owner token, same policy as /m4a/attach):

1. provisions the account under the same key /m4a/attach uses for that session, so the MCP server’s own attach later gets the same nick;
2. records a pending adoption, so an attach whose caller carries no session id (an MCP child of a shared provider backend) is bound to this session and not to the backend’s pid;
3. for grok: rewrites <grok home>/config.toml (backup first) and returns the mcpServers entry an ACP session/load can carry, which grok reads when the session is (re)loaded.

The MCP entry in the shared config names no account: each MCP process attaches by its own ancestry and session, so every session gets its own nick from one config.

Structs

ConfigEdit

Constants

DEFAULT_STALE_ENTRY

NODE_ENTRY

Functions

add_pending

apply_grok_config

Applies rewrite_grok_config to a file: writes <file>.bak-<unix secs> first, then the new text through a temp file and rename. A missing file is created (nothing to back up).

claim_pending

Takes the oldest live pending adoption of provider (one attach binds one session).

client_adopt

Client side (gate4agent-node m4a-adopt): owner token from the file /health names.

grok_config_path

<grok home>/config.toml: GROK_HOME, else ~/.grok.

handle

Handles /m4a/adopt.

is_loopback_http

Is url a loopback HTTP endpoint (a standalone local mailbox daemon)?

mcp_args

MCP server args the node’s own entry uses (no account, no secret: identity comes from attach).

process_cmdline

Command line of a live process (argv), best effort.

resolve_session

Session key resolution for an attach: explicit > provider command line > pending adoption.

rewrite_grok_config

Pure edit of a grok config.toml: drops mcp_servers.<stale> when it is a loopback HTTP url, and sets mcp_servers.m4a to the node’s stdio server. Other content is kept verbatim.

session_from_cmdline

Session id named on a provider command line (--resume <id>, --session <id>, = forms).

split_windows_cmdline

Minimal Windows command-line split (quotes group, backslashes kept).