@almadar/std 17.0.0 → 17.0.2

package/behaviors/registry/cli/atoms/std-orb-mcp-install.orb

@@ -1 +1 @@
-{"typeContractVersion":1,"types":{"ArgFlag":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"aliases","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"takesValue","type":"boolean","required":true},{"nullable":false,"name":"repeatable","type":"boolean","required":true}],"McpConfig":[{"nullable":false,"name":"","type":"Map<string,SExpr>","items":{"nullable":false,"name":"","type":"SExpr"}}],"OrbCommandArgs":[{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"cwd","type":"string","required":true}]},"name":"std-orb-mcp-install","version":"1.0.0","description":"std-orb-mcp-install — the `orb mcp install --client claude|cursor|vscode` command. It registers the `orb` MCP server in the directory the command runs in (claude: .mcp.json, cursor: .cursor/mcp.json, vscode: .vscode/mcp.json): the entry runs `npx -y @almadar/orb mcp` (the vscode entry also carries type stdio) under `mcpServers` (claude, cursor) or `servers` (vscode). Every other entry and key of an existing config is kept; a config that is not a JSON object, or a servers key that is not an object, is left unchanged and answered with its path (status 500, exit 1); the parent directory is created when missing. A missing or unknown --client, or any further word, answers the usage (status 400, exit 2). On success the answer is `Registered `orb mcp` in <path>`; the installed language is then checked through std-cli (`orb list --global`) and a failure adds a warning line naming `npx -y @almadar/orb update --global`. The file is written as compact JSON followed by a newline.","orbitals":[{"name":"OrbMcpInstallOrbital","id":"orb_A1T319MJ81940Y8D5CABPXKR7C","uses":[{"from":"almadar-std/orb-mcp-install","as":"Spec"},{"from":"std/behaviors/std-cli","as":"Cli"},{"from":"std/behaviors/std-args","as":"Args"}],"entity":{"name":"OrbMcpInstallRun","id":"ent_6TNXGX2VVZDXZQJJZDKD55K3FV","persistence":"runtime","fields":[{"nullable":false,"name":"id","type":"string","required":true},{"nullable":false,"name":"cwd","type":"string","default":""},{"nullable":false,"name":"client","type":"string","default":""},{"nullable":false,"name":"dir","type":"string","default":""},{"nullable":false,"name":"path","type":"string","default":""},{"nullable":false,"name":"serversKey","type":"string","default":""},{"nullable":false,"name":"config","type":"object","default":{},"items":{"nullable":false,"type":"SExpr"},"projectedFrom":{"type":"McpConfig"}}]},"traits":[{"ref":"Args.traits.ArgsParser","id":"trt_0MZ2PVPXXCEYPCP2BZJ1DK8QEW","name":"ArgsCli","listens":[{"event":"MCP_ARGS_PARSE","triggers":"ARGS_PARSE","source":{"kind":"trait","trait":"OrbMcpInstall"}}]},{"ref":"Cli.traits.CliRunner","id":"trt_QNYX4MZ6Y2KF1FX3WT396AW47F","name":"SetupCli","config":{"commands":{"type":"unknown","default":["orb"],"wired":true},"passEnv":{"type":"unknown","default":["PATH","HOME"],"wired":true}},"listens":[{"event":"MCP_SETUP_RUN","triggers":"CLI_RUN","source":{"kind":"trait","trait":"OrbMcpInstall"}}]},{"name":"OrbMcpInstall","id":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2","effectRow":[{"kind":"emit","resource":"MCP_ARGS_PARSE"},{"kind":"emit","resource":"MCP_ARGS_UNREAD"},{"kind":"emit","resource":"MCP_DIR_READY"},{"kind":"emit","resource":"MCP_HOST_FAILED"},{"kind":"emit","resource":"MCP_INSTALL_ANSWERED"},{"kind":"emit","resource":"MCP_MERGE"},{"kind":"emit","resource":"MCP_SETUP_RUN"},{"kind":"os/exists"},{"kind":"os/mkdir"},{"kind":"os/read-file"},{"kind":"os/write-file"},{"kind":"set","resource":"@entity.client"},{"kind":"set","resource":"@entity.config"},{"kind":"set","resource":"@entity.cwd"},{"kind":"set","resource":"@entity.dir"},{"kind":"set","resource":"@entity.path"},{"kind":"set","resource":"@entity.serversKey"}],"linkedEntity":"OrbMcpInstallRun","linkedEntityId":"ent_6TNXGX2VVZDXZQJJZDKD55K3FV","entityRefIds":{"OrbMcpInstallRun":"ent_6TNXGX2VVZDXZQJJZDKD55K3FV"},"emits":[{"event":"MCP_INSTALL_ANSWERED","eventId":"evt_MAV1ZC7HJ5RS2G9DPGJF78ZXWG","description":"Internal: the command's answer, which the cli hook prints.","tier":"internal","scope":"internal","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true}]},{"event":"MCP_EXISTS","eventId":"evt_EAMT1R803Q01VT17TCW7TFYE2M","description":"os/exists: whether the client's config file is there.","tier":"internal","payloadSchema":[{"nullable":false,"name":"ok","type":"boolean","required":true}]},{"event":"MCP_READ","eventId":"evt_B1DM183WW9YE4NY6JMAT79SEPG","description":"os/read-file: the existing config.","tier":"internal","payloadSchema":[{"nullable":false,"name":"data","type":"bytes","required":true}]},{"event":"MCP_WRITTEN","eventId":"evt_FFCCZRWVRJDW9FGWD0V7JHTV8R","description":"os/write-file: the config is saved.","tier":"internal"},{"event":"MCP_HOST_FAILED","eventId":"evt_KAGGJE2FD27PH6VNN3R9HEBTCD","description":"An os/exists, os/read-file, os/mkdir or os/write-file failure.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"}]},{"event":"MCP_MERGE","eventId":"evt_DB7VC5JEN47AJF3C8C0FFD6Q6H","description":"Internal: merge the orb entry into the config.","tier":"internal"},{"event":"MCP_DIR_READY","eventId":"evt_KP0VG4V2E1H70K0H432JPE5PTC","description":"Internal: the config's parent directory exists.","tier":"internal"},{"event":"MCP_ARGS_UNREAD","eventId":"evt_C72R31W4JX29EXXS3WAXJRP1M7","description":"Internal: the call's arguments could not be read.","tier":"internal"},{"event":"MCP_ARGS_PARSE","eventId":"evt_4X4VA1NJM1SA0WEDABSR38JAE8","description":"Internal: parse the call's words against the --client flag.","tier":"internal","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"flags","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"aliases","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"takesValue","type":"boolean","required":true},{"nullable":false,"name":"repeatable","type":"boolean","required":true}],"items":{"nullable":false,"name":"","type":"ArgFlag","projectedFrom":{"type":"ArgFlag"}}}]},{"event":"MCP_SETUP_RUN","eventId":"evt_SK40XY66N93AMN4KHJ7N96ZPY2","description":"Internal: run `orb list --global` to check the installed language.","tier":"internal","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}}]}],"listens":[{"event":"ARGS_PARSED","triggers":"MCP_ARGS_DONE","triggersId":"evt_21EMYDM47T23X9GQ5Z9SRC97XB","source":{"kind":"trait","trait":"ArgsCli","traitId":"trt_0MZ2PVPXXCEYPCP2BZJ1DK8QEW"}},{"event":"CLI_DONE","triggers":"MCP_SETUP_DONE","triggersId":"evt_SA84WF5CS0PCGF2WEHK1HKP0R5","source":{"kind":"trait","trait":"SetupCli","traitId":"trt_QNYX4MZ6Y2KF1FX3WT396AW47F"}},{"event":"CLI_FAILED","triggers":"MCP_SETUP_FAILED","triggersId":"evt_T4AXY7N557JJKG7598HKTPNH30","source":{"kind":"trait","trait":"SetupCli","traitId":"trt_QNYX4MZ6Y2KF1FX3WT396AW47F"}}],"stateMachine":{"states":[{"name":"ready","isInitial":true},{"name":"parsing"},{"name":"probing"},{"name":"reading"},{"name":"writing"},{"name":"setup"}],"events":[{"key":"INIT","id":"evt_VDMBYMKG5FR2QHVCG1W2TD6N21","name":"Initialize"},{"key":"MCP_CALLED","id":"evt_B32F2FD7ZWKZY7EWT5ATPX3A4K","name":"Mcp Called","description":"Run `orb mcp install` with its --client flag.","synonyms":"orb mcp install, register the orb mcp server in a client config","payloadSchema":[{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"rawBody","type":"string","required":true}],"listened":true,"inbound":{"name":"cli-mcp-install","answers":"MCP_INSTALL_ANSWERED"}},{"key":"MCP_ARGS_UNREAD","id":"evt_C72R31W4JX29EXXS3WAXJRP1M7","name":"Mcp Args Unread","description":"Internal: the call's arguments could not be read.","tier":"internal"},{"key":"MCP_ARGS_DONE","id":"evt_21EMYDM47T23X9GQ5Z9SRC97XB","name":"Mcp Args Done","description":"std-args's ARGS_PARSED: the call's words, parsed.","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"flags","type":"Map<string,[string]>","required":true,"items":{"nullable":false,"name":"","type":"[string]","items":{"nullable":false,"name":"","type":"string"}}},{"nullable":false,"name":"positionals","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"errors","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"words","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}}],"listened":true},{"key":"MCP_HOST_FAILED","id":"evt_KAGGJE2FD27PH6VNN3R9HEBTCD","name":"Mcp Host Failed","description":"An os/exists, os/read-file, os/mkdir or os/write-file failure.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"}]},{"key":"MCP_EXISTS","id":"evt_EAMT1R803Q01VT17TCW7TFYE2M","name":"Mcp Exists","description":"os/exists: whether the client's config file is there.","tier":"internal","payloadSchema":[{"nullable":false,"name":"ok","type":"boolean","required":true}]},{"key":"MCP_READ","id":"evt_B1DM183WW9YE4NY6JMAT79SEPG","name":"Mcp Read","description":"os/read-file: the existing config.","tier":"internal","payloadSchema":[{"nullable":false,"name":"data","type":"bytes","required":true}]},{"key":"MCP_MERGE","id":"evt_DB7VC5JEN47AJF3C8C0FFD6Q6H","name":"Mcp Merge","description":"Internal: merge the orb entry into the config.","tier":"internal"},{"key":"MCP_DIR_READY","id":"evt_KP0VG4V2E1H70K0H432JPE5PTC","name":"Mcp Dir Ready","description":"Internal: the config's parent directory exists.","tier":"internal"},{"key":"MCP_WRITTEN","id":"evt_FFCCZRWVRJDW9FGWD0V7JHTV8R","name":"Mcp Written","description":"os/write-file: the config is saved.","tier":"internal"},{"key":"MCP_SETUP_DONE","id":"evt_SA84WF5CS0PCGF2WEHK1HKP0R5","name":"Mcp Setup Done","description":"std-cli's CLI_DONE: the language check exited.","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"exitCode","type":"number","required":true},{"nullable":false,"name":"signal","type":"number","required":true},{"nullable":false,"name":"stdout","type":"string","required":true},{"nullable":false,"name":"stderr","type":"string","required":true}],"listened":true},{"key":"MCP_SETUP_FAILED","id":"evt_T4AXY7N557JJKG7598HKTPNH30","name":"Mcp Setup Failed","description":"std-cli's CLI_FAILED: orb could not be run.","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"code","type":"string","required":true}],"listened":true},{"key":"MCP_INSTALL_ANSWERED","id":"evt_MAV1ZC7HJ5RS2G9DPGJF78ZXWG","name":"Mcp Install Answered","description":"Internal: the command's answer, which the cli hook prints.","tier":"internal","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true}]},{"key":"MCP_ARGS_PARSE","id":"evt_4X4VA1NJM1SA0WEDABSR38JAE8","name":"Mcp Args Parse","description":"Internal: parse the call's words against the --client flag.","tier":"internal","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"flags","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"aliases","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"takesValue","type":"boolean","required":true},{"nullable":false,"name":"repeatable","type":"boolean","required":true}],"items":{"nullable":false,"name":"","type":"ArgFlag","projectedFrom":{"type":"ArgFlag"}}}]},{"key":"MCP_SETUP_RUN","id":"evt_SK40XY66N93AMN4KHJ7N96ZPY2","name":"Mcp Setup Run","description":"Internal: run `orb list --global` to check the installed language.","tier":"internal","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}}]}],"transitions":[{"from":"ready","to":"ready","event":"INIT","eventId":"evt_VDMBYMKG5FR2QHVCG1W2TD6N21"},{"from":"ready","to":"parsing","event":"MCP_CALLED","eventId":"evt_B32F2FD7ZWKZY7EWT5ATPX3A4K","guard":["=",["json/parse","@payload.rawBody","OrbCommandArgs"],null],"effects":[["emit","MCP_ARGS_UNREAD",{}]]},{"from":"ready","to":"parsing","event":"MCP_CALLED","eventId":"evt_B32F2FD7ZWKZY7EWT5ATPX3A4K","guard":["!=",["json/parse","@payload.rawBody","OrbCommandArgs"],null],"effects":[["set","@entity.cwd",["object/get",["json/parse","@payload.rawBody","OrbCommandArgs"],"cwd"]],["emit","MCP_ARGS_PARSE",{"stage":"mcp","argv":["object/get",["json/parse","@payload.rawBody","OrbCommandArgs"],"argv"],"flags":[{"name":"client","aliases":[],"takesValue":true,"repeatable":false}]}]]},{"from":"parsing","to":"parsing","event":"INIT","eventId":"evt_VDMBYMKG5FR2QHVCG1W2TD6N21"},{"from":"parsing","to":"ready","event":"MCP_ARGS_UNREAD","eventId":"evt_C72R31W4JX29EXXS3WAXJRP1M7","effects":[["emit","MCP_INSTALL_ANSWERED",{"status":500,"body":"Error: the call's arguments could not be read"}]]},{"from":"parsing","to":"ready","event":"MCP_ARGS_DONE","eventId":"evt_21EMYDM47T23X9GQ5Z9SRC97XB","guard":["not",["and",["=",["array/len","@payload.errors"],0],["=",["array/len","@payload.positionals"],0],["array/includes",["claude","cursor","vscode"],["array/first",["default",["object/get","@payload.flags","client"],[]]]]]],"effects":[["emit","MCP_INSTALL_ANSWERED",{"status":400,"body":"usage: orb mcp install --client <claude|cursor|vscode>"}]]},{"from":"parsing","to":"probing","event":"MCP_ARGS_DONE","eventId":"evt_21EMYDM47T23X9GQ5Z9SRC97XB","guard":["and",["=",["array/len","@payload.errors"],0],["=",["array/len","@payload.positionals"],0],["array/includes",["claude","cursor","vscode"],["array/first",["default",["object/get","@payload.flags","client"],[]]]]],"effects":[["set","@entity.client",["default",["array/first",["default",["object/get","@payload.flags","client"],[]]],""]],["set","@entity.dir",["if",["=","@entity.client","cursor"],".cursor",["if",["=","@entity.client","vscode"],".vscode",""]]],["set","@entity.path",["if",["=","@entity.dir",""],".mcp.json",["str/concat","@entity.dir","/mcp.json"]]],["set","@entity.serversKey",["if",["=","@entity.client","vscode"],"servers","mcpServers"]],["os/exists",{"anchor":"cwd","path":"@entity.path"},{"key":"config","emit":{"success":"MCP_EXISTS","failure":"MCP_HOST_FAILED"}}]]},{"from":"probing","to":"probing","event":"INIT","eventId":"evt_VDMBYMKG5FR2QHVCG1W2TD6N21"},{"from":"probing","to":"ready","event":"MCP_HOST_FAILED","eventId":"evt_KAGGJE2FD27PH6VNN3R9HEBTCD","effects":[["emit","MCP_INSTALL_ANSWERED",{"status":500,"body":["str/concat","@entity.cwd","/","@entity.path",": ",["default","@payload.error",""]]}]]},{"from":"probing","to":"reading","event":"MCP_EXISTS","eventId":"evt_EAMT1R803Q01VT17TCW7TFYE2M","guard":"@payload.ok","effects":[["os/read-file",{"anchor":"cwd","path":"@entity.path"},{"key":"config","emit":{"success":"MCP_READ","failure":"MCP_HOST_FAILED"}}]]},{"from":"probing","to":"writing","event":"MCP_EXISTS","eventId":"evt_EAMT1R803Q01VT17TCW7TFYE2M","guard":["not","@payload.ok"],"effects":[["set","@entity.config",{}],["emit","MCP_MERGE",{}]]},{"from":"reading","to":"reading","event":"INIT","eventId":"evt_VDMBYMKG5FR2QHVCG1W2TD6N21"},{"from":"reading","to":"ready","event":"MCP_HOST_FAILED","eventId":"evt_KAGGJE2FD27PH6VNN3R9HEBTCD","effects":[["emit","MCP_INSTALL_ANSWERED",{"status":500,"body":["str/concat","@entity.cwd","/","@entity.path",": ",["default","@payload.error",""]]}]]},{"from":"reading","to":"ready","event":"MCP_READ","eventId":"evt_B1DM183WW9YE4NY6JMAT79SEPG","guard":["not",["and",["json/valid",["default",["bytes/to-string","@payload.data"],""]],["str/startsWith",["str/trim",["default",["bytes/to-string","@payload.data"],""]],"{"],["!=",["json/parse",["default",["bytes/to-string","@payload.data"],""],"McpConfig"],null]]],"effects":[["emit","MCP_INSTALL_ANSWERED",{"status":500,"body":["str/concat","@entity.cwd","/","@entity.path"]}]]},{"from":"reading","to":"writing","event":"MCP_READ","eventId":"evt_B1DM183WW9YE4NY6JMAT79SEPG","guard":["and",["json/valid",["default",["bytes/to-string","@payload.data"],""]],["str/startsWith",["str/trim",["default",["bytes/to-string","@payload.data"],""]],"{"],["!=",["json/parse",["default",["bytes/to-string","@payload.data"],""],"McpConfig"],null]],"effects":[["set","@entity.config",["default",["json/parse",["default",["bytes/to-string","@payload.data"],""],"McpConfig"],{}]],["emit","MCP_MERGE",{}]]},{"from":"writing","to":"writing","event":"INIT","eventId":"evt_VDMBYMKG5FR2QHVCG1W2TD6N21"},{"from":"writing","to":"ready","event":"MCP_HOST_FAILED","eventId":"evt_KAGGJE2FD27PH6VNN3R9HEBTCD","effects":[["emit","MCP_INSTALL_ANSWERED",{"status":500,"body":["str/concat","@entity.cwd","/","@entity.path",": ",["default","@payload.error",""]]}]]},{"from":"writing","to":"ready","event":"MCP_MERGE","eventId":"evt_DB7VC5JEN47AJF3C8C0FFD6Q6H","guard":["and",["!=",["object/get","@entity.config","@entity.serversKey"],null],["not",["str/startsWith",["json/stringify",["object/get","@entity.config","@entity.serversKey"]],"{"]]],"effects":[["emit","MCP_INSTALL_ANSWERED",{"status":500,"body":["str/concat","@entity.cwd","/","@entity.path"]}]]},{"from":"writing","to":"writing","event":"MCP_MERGE","eventId":"evt_DB7VC5JEN47AJF3C8C0FFD6Q6H","guard":["and",["=","@entity.dir",""],["or",["=",["object/get","@entity.config","@entity.serversKey"],null],["str/startsWith",["json/stringify",["object/get","@entity.config","@entity.serversKey"]],"{"]]],"effects":[["let",[["empty",{},"{\"version\":1,\"name\":\"McpConfig\",\"type\":{\"kind\":\"map\",\"key\":{\"kind\":\"string\"},\"value\":{\"kind\":\"sexpr\"}}}"],["servers",["object/set",["if",["=",["object/get","@entity.config","@entity.serversKey"],null],"@empty",["object/get","@entity.config","@entity.serversKey"]],"orb",["if",["=","@entity.client","vscode"],{"type":"stdio","command":"npx","args":["-y",["str/slice","x@almadar/orb",1],"mcp"]},{"command":"npx","args":["-y",["str/slice","x@almadar/orb",1],"mcp"]}]]]],["if",["=","@servers",null],["emit","MCP_HOST_FAILED",{"error":"could not register orb in the servers entry"}],["let",[["merged",["object/set","@entity.config","@entity.serversKey","@servers"]]],["if",["=","@merged",null],["emit","MCP_HOST_FAILED",{"error":"could not register orb in the servers entry"}],["do",["set","@entity.config","@merged"],["emit","MCP_DIR_READY",{}]]]]]]]},{"from":"writing","to":"writing","event":"MCP_MERGE","eventId":"evt_DB7VC5JEN47AJF3C8C0FFD6Q6H","guard":["and",["!=","@entity.dir",""],["or",["=",["object/get","@entity.config","@entity.serversKey"],null],["str/startsWith",["json/stringify",["object/get","@entity.config","@entity.serversKey"]],"{"]]],"effects":[["let",[["empty",{},"{\"version\":1,\"name\":\"McpConfig\",\"type\":{\"kind\":\"map\",\"key\":{\"kind\":\"string\"},\"value\":{\"kind\":\"sexpr\"}}}"],["servers",["object/set",["if",["=",["object/get","@entity.config","@entity.serversKey"],null],"@empty",["object/get","@entity.config","@entity.serversKey"]],"orb",["if",["=","@entity.client","vscode"],{"type":"stdio","command":"npx","args":["-y",["str/slice","x@almadar/orb",1],"mcp"]},{"command":"npx","args":["-y",["str/slice","x@almadar/orb",1],"mcp"]}]]]],["if",["=","@servers",null],["emit","MCP_HOST_FAILED",{"error":"could not register orb in the servers entry"}],["let",[["merged",["object/set","@entity.config","@entity.serversKey","@servers"]]],["if",["=","@merged",null],["emit","MCP_HOST_FAILED",{"error":"could not register orb in the servers entry"}],["do",["set","@entity.config","@merged"],["os/mkdir",{"anchor":"cwd","path":"@entity.dir"},true,{"key":"dir","emit":{"success":"MCP_DIR_READY","failure":"MCP_HOST_FAILED"}}]]]]]]]},{"from":"writing","to":"writing","event":"MCP_DIR_READY","eventId":"evt_KP0VG4V2E1H70K0H432JPE5PTC","effects":[["os/write-file",{"anchor":"cwd","path":"@entity.path"},["bytes/from-string",["str/concat",["json/stringify","@entity.config",{"pretty":true}],"\n"]],{"key":"config","emit":{"success":"MCP_WRITTEN","failure":"MCP_HOST_FAILED"}}]]},{"from":"writing","to":"setup","event":"MCP_WRITTEN","eventId":"evt_FFCCZRWVRJDW9FGWD0V7JHTV8R","effects":[["emit","MCP_SETUP_RUN",{"stage":"setup","argv":["list","list","--global"]}]]},{"from":"setup","to":"setup","event":"INIT","eventId":"evt_VDMBYMKG5FR2QHVCG1W2TD6N21"},{"from":"setup","to":"ready","event":"MCP_SETUP_DONE","eventId":"evt_SA84WF5CS0PCGF2WEHK1HKP0R5","guard":["=","@payload.exitCode",0],"effects":[["emit","MCP_INSTALL_ANSWERED",{"status":200,"body":["str/concat","Registered `orb mcp` in ","@entity.cwd","/","@entity.path"]}]]},{"from":"setup","to":"ready","event":"MCP_SETUP_DONE","eventId":"evt_SA84WF5CS0PCGF2WEHK1HKP0R5","guard":["!=","@payload.exitCode",0],"effects":[["emit","MCP_INSTALL_ANSWERED",{"status":200,"body":["str/concat","Registered `orb mcp` in ","@entity.cwd","/","@entity.path","\norb: the language is not set up yet (",["str/trim","@payload.stderr"],"); run `npx -y @almadar/orb update --global`, or orb retries on the first tool call"]}]]},{"from":"setup","to":"ready","event":"MCP_SETUP_FAILED","eventId":"evt_T4AXY7N557JJKG7598HKTPNH30","effects":[["emit","MCP_INSTALL_ANSWERED",{"status":200,"body":["str/concat","Registered `orb mcp` in ","@entity.cwd","/","@entity.path","\norb: the language is not set up yet (","@payload.error","); run `npx -y @almadar/orb update --global`, or orb retries on the first tool call"]}]]}]},"dispatch":"optimistic","sourceDeclaration":{"traitId":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2","fingerprint":"8f7e66919716c89f52a8a7f510eed87a887639ccadfedb62dd48d8a8a859c9bf"}}],"pages":[{"name":"OrbMcpInstallOrbitalStart","id":"pag_WNBJZ11TZ6XFK1WD3PWX554GAQ","path":"","protocol":"boot","traits":[{"ref":"OrbMcpInstall","refId":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},{"ref":"ArgsCli","refId":"trt_0MZ2PVPXXCEYPCP2BZJ1DK8QEW"},{"ref":"SetupCli","refId":"trt_QNYX4MZ6Y2KF1FX3WT396AW47F"}]}],"types":{"ArgFlag":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"aliases","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"takesValue","type":"boolean","required":true},{"nullable":false,"name":"repeatable","type":"boolean","required":true}],"McpConfig":[{"nullable":false,"name":"","type":"Map<string,SExpr>","items":{"nullable":false,"name":"","type":"SExpr"}}],"OrbCommandArgs":[{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"cwd","type":"string","required":true}]}}],"inbound":["cli-mcp-install"],"osGrants":{"fs":[],"exec":["orb"],"net":[],"env":["PATH","HOME"],"stdio":[],"sys":[],"desktop":[],"anchored":{"fs":[{"anchor":"cwd","glob":"**","modes":["read","write","create"]}]}},"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_6TNXGX2VVZDXZQJJZDKD55K3FV":{"id":"ent_6TNXGX2VVZDXZQJJZDKD55K3FV","kind":"entity","bakedName":"OrbMcpInstallRun","curName":"OrbMcpInstallRun","renames":[],"owner":"workspace"},"evt_21EMYDM47T23X9GQ5Z9SRC97XB":{"id":"evt_21EMYDM47T23X9GQ5Z9SRC97XB","kind":"event","bakedName":"MCP_ARGS_DONE","curName":"MCP_ARGS_DONE","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_4X4VA1NJM1SA0WEDABSR38JAE8":{"id":"evt_4X4VA1NJM1SA0WEDABSR38JAE8","kind":"event","bakedName":"MCP_ARGS_PARSE","curName":"MCP_ARGS_PARSE","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_B1DM183WW9YE4NY6JMAT79SEPG":{"id":"evt_B1DM183WW9YE4NY6JMAT79SEPG","kind":"event","bakedName":"MCP_READ","curName":"MCP_READ","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_B32F2FD7ZWKZY7EWT5ATPX3A4K":{"id":"evt_B32F2FD7ZWKZY7EWT5ATPX3A4K","kind":"event","bakedName":"MCP_CALLED","curName":"MCP_CALLED","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_C72R31W4JX29EXXS3WAXJRP1M7":{"id":"evt_C72R31W4JX29EXXS3WAXJRP1M7","kind":"event","bakedName":"MCP_ARGS_UNREAD","curName":"MCP_ARGS_UNREAD","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_DB7VC5JEN47AJF3C8C0FFD6Q6H":{"id":"evt_DB7VC5JEN47AJF3C8C0FFD6Q6H","kind":"event","bakedName":"MCP_MERGE","curName":"MCP_MERGE","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_EAMT1R803Q01VT17TCW7TFYE2M":{"id":"evt_EAMT1R803Q01VT17TCW7TFYE2M","kind":"event","bakedName":"MCP_EXISTS","curName":"MCP_EXISTS","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_FFCCZRWVRJDW9FGWD0V7JHTV8R":{"id":"evt_FFCCZRWVRJDW9FGWD0V7JHTV8R","kind":"event","bakedName":"MCP_WRITTEN","curName":"MCP_WRITTEN","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_KAGGJE2FD27PH6VNN3R9HEBTCD":{"id":"evt_KAGGJE2FD27PH6VNN3R9HEBTCD","kind":"event","bakedName":"MCP_HOST_FAILED","curName":"MCP_HOST_FAILED","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_KP0VG4V2E1H70K0H432JPE5PTC":{"id":"evt_KP0VG4V2E1H70K0H432JPE5PTC","kind":"event","bakedName":"MCP_DIR_READY","curName":"MCP_DIR_READY","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_MAV1ZC7HJ5RS2G9DPGJF78ZXWG":{"id":"evt_MAV1ZC7HJ5RS2G9DPGJF78ZXWG","kind":"event","bakedName":"MCP_INSTALL_ANSWERED","curName":"MCP_INSTALL_ANSWERED","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_SA84WF5CS0PCGF2WEHK1HKP0R5":{"id":"evt_SA84WF5CS0PCGF2WEHK1HKP0R5","kind":"event","bakedName":"MCP_SETUP_DONE","curName":"MCP_SETUP_DONE","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_SK40XY66N93AMN4KHJ7N96ZPY2":{"id":"evt_SK40XY66N93AMN4KHJ7N96ZPY2","kind":"event","bakedName":"MCP_SETUP_RUN","curName":"MCP_SETUP_RUN","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_T4AXY7N557JJKG7598HKTPNH30":{"id":"evt_T4AXY7N557JJKG7598HKTPNH30","kind":"event","bakedName":"MCP_SETUP_FAILED","curName":"MCP_SETUP_FAILED","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_VDMBYMKG5FR2QHVCG1W2TD6N21":{"id":"evt_VDMBYMKG5FR2QHVCG1W2TD6N21","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"orb_A1T319MJ81940Y8D5CABPXKR7C":{"id":"orb_A1T319MJ81940Y8D5CABPXKR7C","kind":"orbital","bakedName":"OrbMcpInstallOrbital","curName":"OrbMcpInstallOrbital","renames":[],"owner":"workspace"},"pag_WNBJZ11TZ6XFK1WD3PWX554GAQ":{"id":"pag_WNBJZ11TZ6XFK1WD3PWX554GAQ","kind":"page","bakedName":"OrbMcpInstallOrbitalStart","curName":"OrbMcpInstallOrbitalStart","renames":[],"owner":"workspace"},"trt_0MZ2PVPXXCEYPCP2BZJ1DK8QEW":{"id":"trt_0MZ2PVPXXCEYPCP2BZJ1DK8QEW","kind":"trait","bakedName":"ArgsCli","curName":"ArgsCli","renames":[],"owner":"workspace"},"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2":{"id":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2","kind":"trait","bakedName":"OrbMcpInstall","curName":"OrbMcpInstall","renames":[],"owner":"workspace"},"trt_QNYX4MZ6Y2KF1FX3WT396AW47F":{"id":"trt_QNYX4MZ6Y2KF1FX3WT396AW47F","kind":"trait","bakedName":"SetupCli","curName":"SetupCli","renames":[],"owner":"workspace"}}}}
+{"typeContractVersion":1,"types":{"ArgFlag":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"aliases","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"takesValue","type":"boolean","required":true},{"nullable":false,"name":"repeatable","type":"boolean","required":true}],"McpConfig":[{"nullable":false,"name":"","type":"Map<string,SExpr>","items":{"nullable":false,"name":"","type":"SExpr"}}],"OrbCommandArgs":[{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"cwd","type":"string","required":true}]},"name":"std-orb-mcp-install","version":"1.0.0","description":"std-orb-mcp-install — the `orb mcp install --client claude|cursor|vscode` command. It registers the `orb` MCP server in the directory the command runs in (claude: .mcp.json, cursor: .cursor/mcp.json, vscode: .vscode/mcp.json): the entry runs `npx -y @almadar/orb mcp` (the vscode entry also carries type stdio) under `mcpServers` (claude, cursor) or `servers` (vscode). Every other entry and key of an existing config is kept; a config that is not a JSON object, or a servers key that is not an object, is left unchanged and answered with its path (status 500, exit 1); the parent directory is created when missing. A missing or unknown --client, or any further word, answers the usage (status 400, exit 2). On success the answer is `Registered `orb mcp` in <path>`; the installed language is then checked through std-cli (`orb list --global`) and a failure adds a warning line naming `npx -y @almadar/orb update --global`. The file is written as compact JSON followed by a newline.","orbitals":[{"name":"OrbMcpInstallOrbital","id":"orb_A1T319MJ81940Y8D5CABPXKR7C","uses":[{"from":"almadar-std/orb-mcp-install","as":"Spec"},{"from":"std/behaviors/std-cli","as":"Cli"},{"from":"std/behaviors/std-args","as":"Args"}],"entity":{"name":"OrbMcpInstallRun","id":"ent_6TNXGX2VVZDXZQJJZDKD55K3FV","persistence":"runtime","fields":[{"nullable":false,"name":"id","type":"string","required":true},{"nullable":false,"name":"cwd","type":"string","default":""},{"nullable":false,"name":"client","type":"string","default":""},{"nullable":false,"name":"dir","type":"string","default":""},{"nullable":false,"name":"path","type":"string","default":""},{"nullable":false,"name":"serversKey","type":"string","default":""},{"nullable":false,"name":"config","type":"object","default":{},"items":{"nullable":false,"type":"SExpr"},"projectedFrom":{"type":"McpConfig"}}]},"traits":[{"ref":"Args.traits.ArgsParser","id":"trt_0MZ2PVPXXCEYPCP2BZJ1DK8QEW","name":"ArgsCli","listens":[{"event":"MCP_ARGS_PARSE","triggers":"ARGS_PARSE","source":{"kind":"trait","trait":"OrbMcpInstall"}}]},{"ref":"Cli.traits.CliRunner","id":"trt_QNYX4MZ6Y2KF1FX3WT396AW47F","name":"SetupCli","config":{"commands":{"type":"unknown","default":["orb"],"wired":true},"passEnv":{"type":"unknown","default":["PATH","HOME"],"wired":true}},"listens":[{"event":"MCP_SETUP_RUN","triggers":"CLI_RUN","source":{"kind":"trait","trait":"OrbMcpInstall"}}]},{"name":"OrbMcpInstall","id":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2","effectRow":[{"kind":"emit","resource":"MCP_ARGS_PARSE"},{"kind":"emit","resource":"MCP_ARGS_UNREAD"},{"kind":"emit","resource":"MCP_DIR_READY"},{"kind":"emit","resource":"MCP_HOST_FAILED"},{"kind":"emit","resource":"MCP_INSTALL_ANSWERED"},{"kind":"emit","resource":"MCP_MERGE"},{"kind":"emit","resource":"MCP_SETUP_RUN"},{"kind":"os/exists"},{"kind":"os/mkdir"},{"kind":"os/read-file"},{"kind":"os/write-file"},{"kind":"set","resource":"@entity.client"},{"kind":"set","resource":"@entity.config"},{"kind":"set","resource":"@entity.cwd"},{"kind":"set","resource":"@entity.dir"},{"kind":"set","resource":"@entity.path"},{"kind":"set","resource":"@entity.serversKey"}],"linkedEntity":"OrbMcpInstallRun","linkedEntityId":"ent_6TNXGX2VVZDXZQJJZDKD55K3FV","entityRefIds":{"OrbMcpInstallRun":"ent_6TNXGX2VVZDXZQJJZDKD55K3FV"},"emits":[{"event":"MCP_INSTALL_ANSWERED","eventId":"evt_MAV1ZC7HJ5RS2G9DPGJF78ZXWG","description":"Internal: the command's answer, which the cli hook prints.","tier":"internal","scope":"internal","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true}]},{"event":"MCP_EXISTS","eventId":"evt_EAMT1R803Q01VT17TCW7TFYE2M","description":"os/exists: whether the client's config file is there.","tier":"internal","payloadSchema":[{"nullable":false,"name":"ok","type":"boolean","required":true}]},{"event":"MCP_READ","eventId":"evt_B1DM183WW9YE4NY6JMAT79SEPG","description":"os/read-file: the existing config.","tier":"internal","payloadSchema":[{"nullable":false,"name":"data","type":"bytes","required":true}]},{"event":"MCP_WRITTEN","eventId":"evt_FFCCZRWVRJDW9FGWD0V7JHTV8R","description":"os/write-file: the config is saved.","tier":"internal"},{"event":"MCP_HOST_FAILED","eventId":"evt_KAGGJE2FD27PH6VNN3R9HEBTCD","description":"An os/exists, os/read-file, os/mkdir or os/write-file failure.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"}]},{"event":"MCP_MERGE","eventId":"evt_DB7VC5JEN47AJF3C8C0FFD6Q6H","description":"Internal: merge the orb entry into the config.","tier":"internal"},{"event":"MCP_DIR_READY","eventId":"evt_KP0VG4V2E1H70K0H432JPE5PTC","description":"Internal: the config's parent directory exists.","tier":"internal"},{"event":"MCP_ARGS_UNREAD","eventId":"evt_C72R31W4JX29EXXS3WAXJRP1M7","description":"Internal: the call's arguments could not be read.","tier":"internal"},{"event":"MCP_ARGS_PARSE","eventId":"evt_4X4VA1NJM1SA0WEDABSR38JAE8","description":"Internal: parse the call's words against the --client flag.","tier":"internal","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"flags","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"aliases","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"takesValue","type":"boolean","required":true},{"nullable":false,"name":"repeatable","type":"boolean","required":true}],"items":{"nullable":false,"name":"","type":"ArgFlag","projectedFrom":{"type":"ArgFlag"}}}]},{"event":"MCP_SETUP_RUN","eventId":"evt_SK40XY66N93AMN4KHJ7N96ZPY2","description":"Internal: run `orb list --global` to check the installed language.","tier":"internal","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}}]}],"listens":[{"event":"ARGS_PARSED","triggers":"MCP_ARGS_DONE","triggersId":"evt_21EMYDM47T23X9GQ5Z9SRC97XB","source":{"kind":"trait","trait":"ArgsCli","traitId":"trt_0MZ2PVPXXCEYPCP2BZJ1DK8QEW"}},{"event":"CLI_DONE","triggers":"MCP_SETUP_DONE","triggersId":"evt_SA84WF5CS0PCGF2WEHK1HKP0R5","source":{"kind":"trait","trait":"SetupCli","traitId":"trt_QNYX4MZ6Y2KF1FX3WT396AW47F"}},{"event":"CLI_FAILED","triggers":"MCP_SETUP_FAILED","triggersId":"evt_T4AXY7N557JJKG7598HKTPNH30","source":{"kind":"trait","trait":"SetupCli","traitId":"trt_QNYX4MZ6Y2KF1FX3WT396AW47F"}}],"stateMachine":{"states":[{"name":"ready","isInitial":true},{"name":"parsing"},{"name":"probing"},{"name":"reading"},{"name":"writing"},{"name":"setup"}],"events":[{"key":"INIT","id":"evt_VDMBYMKG5FR2QHVCG1W2TD6N21","name":"Initialize"},{"key":"MCP_CALLED","id":"evt_B32F2FD7ZWKZY7EWT5ATPX3A4K","name":"Mcp Called","description":"Run `orb mcp install` with its --client flag.","synonyms":"orb mcp install, register the orb mcp server in a client config","payloadSchema":[{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"rawBody","type":"string","required":true}],"listened":true,"inbound":{"name":"cli-mcp-install","answers":"MCP_INSTALL_ANSWERED"}},{"key":"MCP_ARGS_UNREAD","id":"evt_C72R31W4JX29EXXS3WAXJRP1M7","name":"Mcp Args Unread","description":"Internal: the call's arguments could not be read.","tier":"internal"},{"key":"MCP_ARGS_DONE","id":"evt_21EMYDM47T23X9GQ5Z9SRC97XB","name":"Mcp Args Done","description":"std-args's ARGS_PARSED: the call's words, parsed.","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"flags","type":"Map<string,[string]>","required":true,"items":{"nullable":false,"name":"","type":"[string]","items":{"nullable":false,"name":"","type":"string"}}},{"nullable":false,"name":"positionals","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"errors","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"words","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}}],"listened":true},{"key":"MCP_HOST_FAILED","id":"evt_KAGGJE2FD27PH6VNN3R9HEBTCD","name":"Mcp Host Failed","description":"An os/exists, os/read-file, os/mkdir or os/write-file failure.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"}]},{"key":"MCP_EXISTS","id":"evt_EAMT1R803Q01VT17TCW7TFYE2M","name":"Mcp Exists","description":"os/exists: whether the client's config file is there.","tier":"internal","payloadSchema":[{"nullable":false,"name":"ok","type":"boolean","required":true}]},{"key":"MCP_READ","id":"evt_B1DM183WW9YE4NY6JMAT79SEPG","name":"Mcp Read","description":"os/read-file: the existing config.","tier":"internal","payloadSchema":[{"nullable":false,"name":"data","type":"bytes","required":true}]},{"key":"MCP_MERGE","id":"evt_DB7VC5JEN47AJF3C8C0FFD6Q6H","name":"Mcp Merge","description":"Internal: merge the orb entry into the config.","tier":"internal"},{"key":"MCP_DIR_READY","id":"evt_KP0VG4V2E1H70K0H432JPE5PTC","name":"Mcp Dir Ready","description":"Internal: the config's parent directory exists.","tier":"internal"},{"key":"MCP_WRITTEN","id":"evt_FFCCZRWVRJDW9FGWD0V7JHTV8R","name":"Mcp Written","description":"os/write-file: the config is saved.","tier":"internal"},{"key":"MCP_SETUP_DONE","id":"evt_SA84WF5CS0PCGF2WEHK1HKP0R5","name":"Mcp Setup Done","description":"std-cli's CLI_DONE: the language check exited.","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"exitCode","type":"number","required":true},{"nullable":false,"name":"signal","type":"number","required":true},{"nullable":false,"name":"stdout","type":"string","required":true},{"nullable":false,"name":"stderr","type":"string","required":true}],"listened":true},{"key":"MCP_SETUP_FAILED","id":"evt_T4AXY7N557JJKG7598HKTPNH30","name":"Mcp Setup Failed","description":"std-cli's CLI_FAILED: orb could not be run.","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"error","type":"string","required":true},{"nullable":false,"name":"code","type":"string","required":true}],"listened":true},{"key":"MCP_INSTALL_ANSWERED","id":"evt_MAV1ZC7HJ5RS2G9DPGJF78ZXWG","name":"Mcp Install Answered","description":"Internal: the command's answer, which the cli hook prints.","tier":"internal","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true}]},{"key":"MCP_ARGS_PARSE","id":"evt_4X4VA1NJM1SA0WEDABSR38JAE8","name":"Mcp Args Parse","description":"Internal: parse the call's words against the --client flag.","tier":"internal","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"flags","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"aliases","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"takesValue","type":"boolean","required":true},{"nullable":false,"name":"repeatable","type":"boolean","required":true}],"items":{"nullable":false,"name":"","type":"ArgFlag","projectedFrom":{"type":"ArgFlag"}}}]},{"key":"MCP_SETUP_RUN","id":"evt_SK40XY66N93AMN4KHJ7N96ZPY2","name":"Mcp Setup Run","description":"Internal: run `orb list --global` to check the installed language.","tier":"internal","payloadSchema":[{"nullable":false,"name":"stage","type":"string","required":true},{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}}]}],"transitions":[{"from":"ready","to":"ready","event":"INIT","eventId":"evt_VDMBYMKG5FR2QHVCG1W2TD6N21"},{"from":"ready","to":"parsing","event":"MCP_CALLED","eventId":"evt_B32F2FD7ZWKZY7EWT5ATPX3A4K","guard":["=",["json/parse","@payload.rawBody","OrbCommandArgs"],null],"effects":[["emit","MCP_ARGS_UNREAD",{}]]},{"from":"ready","to":"parsing","event":"MCP_CALLED","eventId":"evt_B32F2FD7ZWKZY7EWT5ATPX3A4K","guard":["!=",["json/parse","@payload.rawBody","OrbCommandArgs"],null],"effects":[["set","@entity.cwd",["object/get",["json/parse","@payload.rawBody","OrbCommandArgs"],"cwd"]],["emit","MCP_ARGS_PARSE",{"stage":"mcp","argv":["object/get",["json/parse","@payload.rawBody","OrbCommandArgs"],"argv"],"flags":[{"name":"client","aliases":[],"takesValue":true,"repeatable":false}]}]]},{"from":"parsing","to":"parsing","event":"INIT","eventId":"evt_VDMBYMKG5FR2QHVCG1W2TD6N21"},{"from":"parsing","to":"ready","event":"MCP_ARGS_UNREAD","eventId":"evt_C72R31W4JX29EXXS3WAXJRP1M7","effects":[["emit","MCP_INSTALL_ANSWERED",{"status":500,"body":"Error: the call's arguments could not be read"}]]},{"from":"parsing","to":"ready","event":"MCP_ARGS_DONE","eventId":"evt_21EMYDM47T23X9GQ5Z9SRC97XB","guard":["not",["and",["=",["array/len","@payload.errors"],0],["=",["array/len","@payload.positionals"],0],["array/includes",["claude","cursor","vscode"],["array/first",["default",["object/get","@payload.flags","client"],[]]]]]],"effects":[["emit","MCP_INSTALL_ANSWERED",{"status":400,"body":"usage: orb mcp install --client <claude|cursor|vscode>"}]]},{"from":"parsing","to":"probing","event":"MCP_ARGS_DONE","eventId":"evt_21EMYDM47T23X9GQ5Z9SRC97XB","guard":["and",["=",["array/len","@payload.errors"],0],["=",["array/len","@payload.positionals"],0],["array/includes",["claude","cursor","vscode"],["array/first",["default",["object/get","@payload.flags","client"],[]]]]],"effects":[["set","@entity.client",["default",["array/first",["default",["object/get","@payload.flags","client"],[]]],""]],["set","@entity.dir",["if",["=","@entity.client","cursor"],".cursor",["if",["=","@entity.client","vscode"],".vscode",""]]],["set","@entity.path",["if",["=","@entity.dir",""],".mcp.json",["str/concat","@entity.dir","/mcp.json"]]],["set","@entity.serversKey",["if",["=","@entity.client","vscode"],"servers","mcpServers"]],["os/exists",{"anchor":"cwd","path":"@entity.path"},{"key":"config","emit":{"success":"MCP_EXISTS","failure":"MCP_HOST_FAILED"}}]]},{"from":"probing","to":"probing","event":"INIT","eventId":"evt_VDMBYMKG5FR2QHVCG1W2TD6N21"},{"from":"probing","to":"ready","event":"MCP_HOST_FAILED","eventId":"evt_KAGGJE2FD27PH6VNN3R9HEBTCD","effects":[["emit","MCP_INSTALL_ANSWERED",{"status":500,"body":["str/concat","@entity.cwd","/","@entity.path",": ",["default","@payload.error",""]]}]]},{"from":"probing","to":"reading","event":"MCP_EXISTS","eventId":"evt_EAMT1R803Q01VT17TCW7TFYE2M","guard":"@payload.ok","effects":[["os/read-file",{"anchor":"cwd","path":"@entity.path"},{"key":"config","emit":{"success":"MCP_READ","failure":"MCP_HOST_FAILED"}}]]},{"from":"probing","to":"writing","event":"MCP_EXISTS","eventId":"evt_EAMT1R803Q01VT17TCW7TFYE2M","guard":["not","@payload.ok"],"effects":[["set","@entity.config",{}],["emit","MCP_MERGE",{}]]},{"from":"reading","to":"reading","event":"INIT","eventId":"evt_VDMBYMKG5FR2QHVCG1W2TD6N21"},{"from":"reading","to":"ready","event":"MCP_HOST_FAILED","eventId":"evt_KAGGJE2FD27PH6VNN3R9HEBTCD","effects":[["emit","MCP_INSTALL_ANSWERED",{"status":500,"body":["str/concat","@entity.cwd","/","@entity.path",": ",["default","@payload.error",""]]}]]},{"from":"reading","to":"ready","event":"MCP_READ","eventId":"evt_B1DM183WW9YE4NY6JMAT79SEPG","guard":["not",["and",["json/valid",["default",["bytes/to-string","@payload.data"],""]],["str/startsWith",["str/trim",["default",["bytes/to-string","@payload.data"],""]],"{"],["!=",["json/parse",["default",["bytes/to-string","@payload.data"],""],"McpConfig"],null]]],"effects":[["emit","MCP_INSTALL_ANSWERED",{"status":500,"body":["str/concat","@entity.cwd","/","@entity.path"]}]]},{"from":"reading","to":"writing","event":"MCP_READ","eventId":"evt_B1DM183WW9YE4NY6JMAT79SEPG","guard":["and",["json/valid",["default",["bytes/to-string","@payload.data"],""]],["str/startsWith",["str/trim",["default",["bytes/to-string","@payload.data"],""]],"{"],["!=",["json/parse",["default",["bytes/to-string","@payload.data"],""],"McpConfig"],null]],"effects":[["set","@entity.config",["default",["json/parse",["default",["bytes/to-string","@payload.data"],""],"McpConfig"],{}]],["emit","MCP_MERGE",{}]]},{"from":"writing","to":"writing","event":"INIT","eventId":"evt_VDMBYMKG5FR2QHVCG1W2TD6N21"},{"from":"writing","to":"ready","event":"MCP_HOST_FAILED","eventId":"evt_KAGGJE2FD27PH6VNN3R9HEBTCD","effects":[["emit","MCP_INSTALL_ANSWERED",{"status":500,"body":["str/concat","@entity.cwd","/","@entity.path",": ",["default","@payload.error",""]]}]]},{"from":"writing","to":"ready","event":"MCP_MERGE","eventId":"evt_DB7VC5JEN47AJF3C8C0FFD6Q6H","guard":["and",["!=",["object/get","@entity.config","@entity.serversKey"],null],["not",["str/startsWith",["json/stringify",["object/get","@entity.config","@entity.serversKey"]],"{"]]],"effects":[["emit","MCP_INSTALL_ANSWERED",{"status":500,"body":["str/concat","@entity.cwd","/","@entity.path"]}]]},{"from":"writing","to":"writing","event":"MCP_MERGE","eventId":"evt_DB7VC5JEN47AJF3C8C0FFD6Q6H","guard":["and",["=","@entity.dir",""],["or",["=",["object/get","@entity.config","@entity.serversKey"],null],["str/startsWith",["json/stringify",["object/get","@entity.config","@entity.serversKey"]],"{"]]],"effects":[["let",[["empty",{},"{\"version\":1,\"name\":\"McpConfig\",\"type\":{\"kind\":\"map\",\"key\":{\"kind\":\"string\"},\"value\":{\"kind\":\"sexpr\"}}}"],["servers",["object/set",["if",["=",["object/get","@entity.config","@entity.serversKey"],null],"@empty",["object/get","@entity.config","@entity.serversKey"]],"orb",["if",["=","@entity.client","vscode"],{"type":"stdio","command":"npx","args":["-y",["str/slice","x@almadar/orb",1],"mcp"]},{"command":"npx","args":["-y",["str/slice","x@almadar/orb",1],"mcp"]}]]]],["if",["=","@servers",null],["emit","MCP_HOST_FAILED",{"error":"could not register orb in the servers entry"}],["let",[["merged",["object/set","@entity.config","@entity.serversKey","@servers"]]],["if",["=","@merged",null],["emit","MCP_HOST_FAILED",{"error":"could not register orb in the servers entry"}],["do",["set","@entity.config","@merged"],["emit","MCP_DIR_READY",{}]]]]]]]},{"from":"writing","to":"writing","event":"MCP_MERGE","eventId":"evt_DB7VC5JEN47AJF3C8C0FFD6Q6H","guard":["and",["!=","@entity.dir",""],["or",["=",["object/get","@entity.config","@entity.serversKey"],null],["str/startsWith",["json/stringify",["object/get","@entity.config","@entity.serversKey"]],"{"]]],"effects":[["let",[["empty",{},"{\"version\":1,\"name\":\"McpConfig\",\"type\":{\"kind\":\"map\",\"key\":{\"kind\":\"string\"},\"value\":{\"kind\":\"sexpr\"}}}"],["servers",["object/set",["if",["=",["object/get","@entity.config","@entity.serversKey"],null],"@empty",["object/get","@entity.config","@entity.serversKey"]],"orb",["if",["=","@entity.client","vscode"],{"type":"stdio","command":"npx","args":["-y",["str/slice","x@almadar/orb",1],"mcp"]},{"command":"npx","args":["-y",["str/slice","x@almadar/orb",1],"mcp"]}]]]],["if",["=","@servers",null],["emit","MCP_HOST_FAILED",{"error":"could not register orb in the servers entry"}],["let",[["merged",["object/set","@entity.config","@entity.serversKey","@servers"]]],["if",["=","@merged",null],["emit","MCP_HOST_FAILED",{"error":"could not register orb in the servers entry"}],["do",["set","@entity.config","@merged"],["os/mkdir",{"anchor":"cwd","path":"@entity.dir"},true,{"key":"dir","emit":{"success":"MCP_DIR_READY","failure":"MCP_HOST_FAILED"}}]]]]]]]},{"from":"writing","to":"writing","event":"MCP_DIR_READY","eventId":"evt_KP0VG4V2E1H70K0H432JPE5PTC","effects":[["os/write-file",{"anchor":"cwd","path":"@entity.path"},["bytes/from-string",["str/concat",["json/stringify","@entity.config",{"pretty":true}],"\n"]],{"key":"config","emit":{"success":"MCP_WRITTEN","failure":"MCP_HOST_FAILED"}}]]},{"from":"writing","to":"setup","event":"MCP_WRITTEN","eventId":"evt_FFCCZRWVRJDW9FGWD0V7JHTV8R","effects":[["emit","MCP_SETUP_RUN",{"stage":"setup","argv":["list","list","--global"]}]]},{"from":"setup","to":"setup","event":"INIT","eventId":"evt_VDMBYMKG5FR2QHVCG1W2TD6N21"},{"from":"setup","to":"ready","event":"MCP_SETUP_DONE","eventId":"evt_SA84WF5CS0PCGF2WEHK1HKP0R5","guard":["=","@payload.exitCode",0],"effects":[["emit","MCP_INSTALL_ANSWERED",{"status":200,"body":["str/concat","Registered `orb mcp` in ","@entity.cwd","/","@entity.path"]}]]},{"from":"setup","to":"ready","event":"MCP_SETUP_DONE","eventId":"evt_SA84WF5CS0PCGF2WEHK1HKP0R5","guard":["!=","@payload.exitCode",0],"effects":[["emit","MCP_INSTALL_ANSWERED",{"status":200,"body":["str/concat","Registered `orb mcp` in ","@entity.cwd","/","@entity.path","\norb: the language is not set up yet (",["str/trim","@payload.stderr"],"); run `npx -y @almadar/orb update --global`, or orb retries on the first tool call"]}]]},{"from":"setup","to":"ready","event":"MCP_SETUP_FAILED","eventId":"evt_T4AXY7N557JJKG7598HKTPNH30","effects":[["emit","MCP_INSTALL_ANSWERED",{"status":200,"body":["str/concat","Registered `orb mcp` in ","@entity.cwd","/","@entity.path","\norb: the language is not set up yet (","@payload.error","); run `npx -y @almadar/orb update --global`, or orb retries on the first tool call"]}]]}]},"dispatch":"optimistic","sourceDeclaration":{"traitId":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2","fingerprint":"8f7e66919716c89f52a8a7f510eed87a887639ccadfedb62dd48d8a8a859c9bf"}}],"pages":[{"name":"OrbMcpInstallOrbitalStart","id":"pag_WNBJZ11TZ6XFK1WD3PWX554GAQ","path":"","protocol":"boot","traits":[{"ref":"OrbMcpInstall","refId":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},{"ref":"ArgsCli","refId":"trt_0MZ2PVPXXCEYPCP2BZJ1DK8QEW"},{"ref":"SetupCli","refId":"trt_QNYX4MZ6Y2KF1FX3WT396AW47F"}]}],"types":{"ArgFlag":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"aliases","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"takesValue","type":"boolean","required":true},{"nullable":false,"name":"repeatable","type":"boolean","required":true}],"McpConfig":[{"nullable":false,"name":"","type":"Map<string,SExpr>","items":{"nullable":false,"name":"","type":"SExpr"}}],"OrbCommandArgs":[{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"cwd","type":"string","required":true}]}}],"inbound":["cli-mcp-install"],"osGrants":{"fs":[],"exec":["orb"],"net":[],"env":["PATH","HOME"],"stdio":[],"sys":[],"desktop":[],"anchored":{"fs":[{"anchor":"cwd","glob":"**","modes":["read","write","create"]}],"exec":[{"anchor":"exe"}]}},"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_6TNXGX2VVZDXZQJJZDKD55K3FV":{"id":"ent_6TNXGX2VVZDXZQJJZDKD55K3FV","kind":"entity","bakedName":"OrbMcpInstallRun","curName":"OrbMcpInstallRun","renames":[],"owner":"workspace"},"evt_21EMYDM47T23X9GQ5Z9SRC97XB":{"id":"evt_21EMYDM47T23X9GQ5Z9SRC97XB","kind":"event","bakedName":"MCP_ARGS_DONE","curName":"MCP_ARGS_DONE","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_4X4VA1NJM1SA0WEDABSR38JAE8":{"id":"evt_4X4VA1NJM1SA0WEDABSR38JAE8","kind":"event","bakedName":"MCP_ARGS_PARSE","curName":"MCP_ARGS_PARSE","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_B1DM183WW9YE4NY6JMAT79SEPG":{"id":"evt_B1DM183WW9YE4NY6JMAT79SEPG","kind":"event","bakedName":"MCP_READ","curName":"MCP_READ","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_B32F2FD7ZWKZY7EWT5ATPX3A4K":{"id":"evt_B32F2FD7ZWKZY7EWT5ATPX3A4K","kind":"event","bakedName":"MCP_CALLED","curName":"MCP_CALLED","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_C72R31W4JX29EXXS3WAXJRP1M7":{"id":"evt_C72R31W4JX29EXXS3WAXJRP1M7","kind":"event","bakedName":"MCP_ARGS_UNREAD","curName":"MCP_ARGS_UNREAD","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_DB7VC5JEN47AJF3C8C0FFD6Q6H":{"id":"evt_DB7VC5JEN47AJF3C8C0FFD6Q6H","kind":"event","bakedName":"MCP_MERGE","curName":"MCP_MERGE","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_EAMT1R803Q01VT17TCW7TFYE2M":{"id":"evt_EAMT1R803Q01VT17TCW7TFYE2M","kind":"event","bakedName":"MCP_EXISTS","curName":"MCP_EXISTS","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_FFCCZRWVRJDW9FGWD0V7JHTV8R":{"id":"evt_FFCCZRWVRJDW9FGWD0V7JHTV8R","kind":"event","bakedName":"MCP_WRITTEN","curName":"MCP_WRITTEN","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_KAGGJE2FD27PH6VNN3R9HEBTCD":{"id":"evt_KAGGJE2FD27PH6VNN3R9HEBTCD","kind":"event","bakedName":"MCP_HOST_FAILED","curName":"MCP_HOST_FAILED","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_KP0VG4V2E1H70K0H432JPE5PTC":{"id":"evt_KP0VG4V2E1H70K0H432JPE5PTC","kind":"event","bakedName":"MCP_DIR_READY","curName":"MCP_DIR_READY","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_MAV1ZC7HJ5RS2G9DPGJF78ZXWG":{"id":"evt_MAV1ZC7HJ5RS2G9DPGJF78ZXWG","kind":"event","bakedName":"MCP_INSTALL_ANSWERED","curName":"MCP_INSTALL_ANSWERED","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_SA84WF5CS0PCGF2WEHK1HKP0R5":{"id":"evt_SA84WF5CS0PCGF2WEHK1HKP0R5","kind":"event","bakedName":"MCP_SETUP_DONE","curName":"MCP_SETUP_DONE","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_SK40XY66N93AMN4KHJ7N96ZPY2":{"id":"evt_SK40XY66N93AMN4KHJ7N96ZPY2","kind":"event","bakedName":"MCP_SETUP_RUN","curName":"MCP_SETUP_RUN","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_T4AXY7N557JJKG7598HKTPNH30":{"id":"evt_T4AXY7N557JJKG7598HKTPNH30","kind":"event","bakedName":"MCP_SETUP_FAILED","curName":"MCP_SETUP_FAILED","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"evt_VDMBYMKG5FR2QHVCG1W2TD6N21":{"id":"evt_VDMBYMKG5FR2QHVCG1W2TD6N21","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2"},"orb_A1T319MJ81940Y8D5CABPXKR7C":{"id":"orb_A1T319MJ81940Y8D5CABPXKR7C","kind":"orbital","bakedName":"OrbMcpInstallOrbital","curName":"OrbMcpInstallOrbital","renames":[],"owner":"workspace"},"pag_WNBJZ11TZ6XFK1WD3PWX554GAQ":{"id":"pag_WNBJZ11TZ6XFK1WD3PWX554GAQ","kind":"page","bakedName":"OrbMcpInstallOrbitalStart","curName":"OrbMcpInstallOrbitalStart","renames":[],"owner":"workspace"},"trt_0MZ2PVPXXCEYPCP2BZJ1DK8QEW":{"id":"trt_0MZ2PVPXXCEYPCP2BZJ1DK8QEW","kind":"trait","bakedName":"ArgsCli","curName":"ArgsCli","renames":[],"owner":"workspace"},"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2":{"id":"trt_GHEQGNX9DQMPVSD6JN63Y4PBN2","kind":"trait","bakedName":"OrbMcpInstall","curName":"OrbMcpInstall","renames":[],"owner":"workspace"},"trt_QNYX4MZ6Y2KF1FX3WT396AW47F":{"id":"trt_QNYX4MZ6Y2KF1FX3WT396AW47F","kind":"trait","bakedName":"SetupCli","curName":"SetupCli","renames":[],"owner":"workspace"}}}}