npm - @almadar/std - Versions diffs - 17.0.3 → 17.1.0 - Mend

@almadar/std 17.0.3 → 17.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (313) hide show

package/behaviors/registry/cli/atoms/std-orb-serve.orb CHANGED Viewed

	@@ -1 +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}],"OrbCommandArgs":[{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"cwd","type":"string","required":true}],"ServeApp":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"text","type":"string","required":true}],"ServeAppRead":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"loadedResolved","type":"boolean","required":true},{"nullable":false,"name":"programPath","type":"string","required":true}],"ServeAux":[{"nullable":false,"name":"collection","type":"string"}],"ServeMachine":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"ServeOrbital":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"ServePage":[{"nullable":false,"name":"protocol","type":"string"}],"ServeProgram":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"ServeTrait":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"ServeTransition":[{"nullable":false,"name":"event","type":"string"}]},"name":"std-orb-serve","version":"1.0.0","description":"std-orb-serve — the `orb serve <file> [--port N] [--host H] [--no-mock] [--client-dir DIR] [--open] [--no-emulators]` command (spec/cli/orb-serve.lolo; port of orbital-cli program_command.rs serve_program and server_overrides). It resolves the app with program/read { resolve: true, path }. An app that declares its own http endpoint is composed alone, and --port, --host or --client-dir is refused (status 400): its server's options are set in the program. Without --client-dir the app gets a browser client prepared first: program/eval generate { mode: client, webClient: true } compiles it client-mode into <cwd>/.orbital/serve/<app> and lays the typescript shell's prebuilt web client, with the app's runtime files over it, out in .orbital/serve/<app>/web-client, which becomes the clientDir; when FIREBASE_AUTH_EMULATOR_HOST and FIREBASE_PROJECT_ID are both set, that folder's __/firebase/init.json names the Auth emulator for the page. Otherwise it writes ~/.almadar/serve/<app path with / as _>.server.lolo, which imports std-http-server's HttpServerOrbital with the serve options as its call-site config (host, port, portFromEnv false and, with --client-dir made absolute against the working directory and required to lie under it, clientDir relative to the working directory), resolves it with program/read so each knob reaches the trait bodies, and composes the app with std-http-server's resolved program (behavior/resolve, for its header grants) carrying that configured orbital, adding the listen grant for host:port and the anchored cwd read grant of the client dir. The compose, prepare-client and answer half is std-orb-serve-handoff's ServeHandoff, which std-orb-launchpad composes as well. The command never runs the program: it answers a hand-off the bootloader acts on, status 200 with headers orb-run: server, orb-app: the absolute app path, and the composed program's JSON as the body. --open and --no-emulators answer status 500 on stderr with the texts the Rust command bailed with; a port that is not an integer in 0..65535 answers status 400 on stderr; a client dir outside the working directory, an app that names no app or a program that does not resolve or compose answers status 500 on stderr `Error: <reason>`; a missing or second file or an unknown flag answers the usage (status 400, exit 2). Defaults: port 3030, host 127.0.0.1. The resolved app is written (with its catalogs and lazy behaviors) to ~/.almadar/serve/<app path with / as _>.orb, the directory read from the HOME env grant and written under the fs grant ~/.almadar/serve/; orb-app names that file, so the bootloader finds the catalogs.","orbitals":[{"name":"OrbServeOrbital","id":"orb_ZQA89DBEC9Q64ZV00CKBH0A797","uses":[{"from":"almadar-std/orb-serve","as":"Spec"},{"from":"std/behaviors/std-args","as":"Args"},{"from":"std/behaviors/std-orb-serve-handoff","as":"Handoff"}],"entity":{"name":"ServeRun","id":"ent_CMTFNEWD4F6J7ZMSMQB8MH1C36","persistence":"runtime","fields":[{"nullable":false,"name":"id","type":"string","required":true},{"nullable":false,"name":"path","type":"string","default":""},{"nullable":false,"name":"host","type":"string","default":""},{"nullable":false,"name":"port","type":"number","default":0},{"nullable":false,"name":"rel","type":"string","default":""},{"nullable":false,"name":"hasClient","type":"boolean","default":false},{"nullable":false,"name":"mock","type":"boolean","default":true},{"nullable":false,"name":"out","type":"string","default":""},{"nullable":false,"name":"flagged","type":"boolean","default":false},{"nullable":false,"name":"serverName","type":"string","default":""},{"nullable":false,"name":"serverPath","type":"string","default":""},{"nullable":false,"name":"serverOrbitals","type":"array","default":[],"items":{"nullable":false,"type":"object","properties":{"name":{"nullable":false,"name":"name","type":"string","required":true},"pages":{"nullable":false,"name":"pages","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"protocol":{"nullable":false,"name":"protocol","type":"string","required":false}},"projectedFrom":{"type":"ServePage"}}},"auxiliaryEntities":{"nullable":false,"name":"auxiliaryEntities","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"collection":{"nullable":false,"name":"collection","type":"string","required":false}},"projectedFrom":{"type":"ServeAux"}}},"traits":{"nullable":false,"name":"traits","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"name":{"nullable":false,"name":"name","type":"string","required":true},"stateMachine":{"nullable":false,"name":"stateMachine","type":"object","required":false,"properties":{"transitions":{"nullable":false,"name":"transitions","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"event":{"nullable":false,"name":"event","type":"string","required":false}},"projectedFrom":{"type":"ServeTransition"}}}},"projectedFrom":{"type":"ServeMachine"}}},"projectedFrom":{"type":"ServeTrait"}}}},"projectedFrom":{"type":"ServeOrbital"}}},{"nullable":false,"name":"appName","type":"string","default":""},{"nullable":false,"name":"app","type":"object","default":{"name":""},"properties":{"name":{"nullable":false,"name":"name","type":"string","required":false},"orbitals":{"nullable":false,"name":"orbitals","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"name":{"nullable":false,"name":"name","type":"string","required":true},"pages":{"nullable":false,"name":"pages","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"protocol":{"nullable":false,"name":"protocol","type":"string","required":false}},"projectedFrom":{"type":"ServePage"}}},"auxiliaryEntities":{"nullable":false,"name":"auxiliaryEntities","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"collection":{"nullable":false,"name":"collection","type":"string","required":false}},"projectedFrom":{"type":"ServeAux"}}},"traits":{"nullable":false,"name":"traits","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"name":{"nullable":false,"name":"name","type":"string","required":true},"stateMachine":{"nullable":false,"name":"stateMachine","type":"object","required":false,"properties":{"transitions":{"nullable":false,"name":"transitions","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"event":{"nullable":false,"name":"event","type":"string","required":false}},"projectedFrom":{"type":"ServeTransition"}}}},"projectedFrom":{"type":"ServeMachine"}}},"projectedFrom":{"type":"ServeTrait"}}}},"projectedFrom":{"type":"ServeOrbital"}}}},"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"cwd","type":"string","default":""},{"nullable":false,"name":"prepare","type":"boolean","default":false,"description":"Serve prepares the browser client itself (no --client-dir), from the composed program."},{"nullable":false,"name":"source","type":"string","default":"","description":"The app file itself, whose folder holds its locales/ and public/."}]},"traits":[{"ref":"Args.traits.ArgsParser","id":"trt_RWCGCWJKVD9XPMW72CBEN5NWN8","name":"ArgsCli","listens":[{"event":"SERVE_ARGS_PARSE","triggers":"ARGS_PARSE","source":{"kind":"trait","trait":"OrbServe"}}]},{"name":"OrbServe","id":"trt_7CE4HCXS06WG36DK92P6BSZF3M","effectRow":[{"kind":"emit","resource":"SERVE_ANSWERED"},{"kind":"emit","resource":"SERVE_ARGS_PARSE"},{"kind":"emit","resource":"SERVE_START"},{"kind":"set","resource":"@entity.path"}],"linkedEntity":"ServeRun","linkedEntityId":"ent_CMTFNEWD4F6J7ZMSMQB8MH1C36","entityRefIds":{"ServeRun":"ent_CMTFNEWD4F6J7ZMSMQB8MH1C36"},"emits":[{"event":"SERVE_ANSWERED","eventId":"evt_XJ9EFGWT2HD18Q7FVZ3JGHHC8W","description":"Internal: the command's answer, which the cli hook prints; headers carry the bootloader hand-off.","tier":"internal","scope":"internal","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true},{"nullable":false,"name":"stderr","type":"string"},{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}]},{"event":"SERVE_ARGS_PARSE","eventId":"evt_8H34PW6BE95Q4SP2H7ZD7HHFPW","description":"Internal: parse the call's words.","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":"SERVE_START","eventId":"evt_QYX9G1R7SC3WPA2X6RCJXKHXY3","description":"Internal: the parsed serve request.","tier":"internal","payloadSchema":[{"nullable":false,"name":"cwd","type":"string","required":true},{"nullable":false,"name":"path","type":"string","required":true},{"nullable":false,"name":"portText","type":"string","required":true},{"nullable":false,"name":"portOk","type":"boolean","required":true},{"nullable":false,"name":"host","type":"string","required":true},{"nullable":false,"name":"hasClient","type":"boolean","required":true},{"nullable":false,"name":"clientDir","type":"string","required":true},{"nullable":false,"name":"clientGiven","type":"string","required":true},{"nullable":false,"name":"clientInside","type":"boolean","required":true},{"nullable":false,"name":"mock","type":"boolean","required":true},{"nullable":false,"name":"open","type":"boolean","required":true},{"nullable":false,"name":"noEmulators","type":"boolean","required":true},{"nullable":false,"name":"flagged","type":"boolean","required":true}]}],"listens":[{"event":"ARGS_PARSED","triggers":"SERVE_ARGS_DONE","triggersId":"evt_K30T57A1NX0TYKYXWWQFDXHS3A","source":{"kind":"trait","trait":"ArgsCli","traitId":"trt_RWCGCWJKVD9XPMW72CBEN5NWN8"}},{"event":"SERVE_ANSWERED","eventId":"evt_XJ9EFGWT2HD18Q7FVZ3JGHHC8W","triggers":"SERVE_DONE","triggersId":"evt_X0QCH44MPMABA29HMMED68WBQG","source":{"kind":"trait","trait":"ServeEngine","traitId":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"}},{"event":"SERVE_ANSWERED","eventId":"evt_XJ9EFGWT2HD18Q7FVZ3JGHHC8W","triggers":"SERVE_DONE","triggersId":"evt_X0QCH44MPMABA29HMMED68WBQG","source":{"kind":"trait","trait":"ServeHandoff","traitId":"trt_9G89799AE5N72R9TCKBH6S17B6"}}],"stateMachine":{"states":[{"name":"ready","isInitial":true},{"name":"parsing"},{"name":"working"}],"events":[{"key":"INIT","id":"evt_H836C79STMWXAF5SS8XM6ZWAQ3","name":"Initialize"},{"key":"SERVE_CALLED","id":"evt_TPN6AAV72RKHCCRW0WJFS4QMKN","name":"Serve Called","description":"Run `orb serve`.","synonyms":"orb serve, serve a program, run the app on a port, http server for a lolo program","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-serve","answers":"SERVE_ANSWERED"}},{"key":"SERVE_ARGS_DONE","id":"evt_K30T57A1NX0TYKYXWWQFDXHS3A","name":"Serve Args Done","description":"std-args's ARGS_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":"SERVE_DONE","id":"evt_X0QCH44MPMABA29HMMED68WBQG","name":"Serve Done","description":"Internal: the engine's answer, relayed to the hook by its handler.","tier":"internal","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true},{"nullable":false,"name":"stderr","type":"string"},{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}],"listened":true},{"key":"SERVE_ANSWERED","id":"evt_XJ9EFGWT2HD18Q7FVZ3JGHHC8W","name":"Serve Answered","description":"Internal: the command's answer, which the cli hook prints; headers carry the bootloader hand-off.","tier":"internal","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true},{"nullable":false,"name":"stderr","type":"string"},{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}]},{"key":"SERVE_ARGS_PARSE","id":"evt_8H34PW6BE95Q4SP2H7ZD7HHFPW","name":"Serve Args Parse","description":"Internal: parse the call's words.","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":"SERVE_START","id":"evt_QYX9G1R7SC3WPA2X6RCJXKHXY3","name":"Serve Start","description":"Internal: the parsed serve request.","tier":"internal","payloadSchema":[{"nullable":false,"name":"cwd","type":"string","required":true},{"nullable":false,"name":"path","type":"string","required":true},{"nullable":false,"name":"portText","type":"string","required":true},{"nullable":false,"name":"portOk","type":"boolean","required":true},{"nullable":false,"name":"host","type":"string","required":true},{"nullable":false,"name":"hasClient","type":"boolean","required":true},{"nullable":false,"name":"clientDir","type":"string","required":true},{"nullable":false,"name":"clientGiven","type":"string","required":true},{"nullable":false,"name":"clientInside","type":"boolean","required":true},{"nullable":false,"name":"mock","type":"boolean","required":true},{"nullable":false,"name":"open","type":"boolean","required":true},{"nullable":false,"name":"noEmulators","type":"boolean","required":true},{"nullable":false,"name":"flagged","type":"boolean","required":true}]}],"transitions":[{"from":"ready","to":"ready","event":"INIT","eventId":"evt_H836C79STMWXAF5SS8XM6ZWAQ3"},{"from":"ready","to":"ready","event":"SERVE_CALLED","eventId":"evt_TPN6AAV72RKHCCRW0WJFS4QMKN","guard":["=",["json/parse","@payload.rawBody","OrbCommandArgs"],null],"effects":[["emit","SERVE_ANSWERED",{"status":400,"body":"","stderr":"usage: orb serve <FILE> [--port N] [--host H] [--no-mock] [--client-dir DIR] [--open] [--no-emulators]"}]]},{"from":"ready","to":"parsing","event":"SERVE_CALLED","eventId":"evt_TPN6AAV72RKHCCRW0WJFS4QMKN","guard":["!=",["json/parse","@payload.rawBody","OrbCommandArgs"],null],"effects":[["set","@entity.path",["object/get",["json/parse","@payload.rawBody","OrbCommandArgs"],"cwd"]],["emit","SERVE_ARGS_PARSE",{"stage":"serve","argv":["object/get",["json/parse","@payload.rawBody","OrbCommandArgs"],"argv"],"flags":[{"name":"port","aliases":["-p"],"takesValue":true,"repeatable":false},{"name":"host","aliases":[],"takesValue":true,"repeatable":false},{"name":"client-dir","aliases":[],"takesValue":true,"repeatable":false},{"name":"no-mock","aliases":[],"takesValue":false,"repeatable":false},{"name":"open","aliases":[],"takesValue":false,"repeatable":false},{"name":"no-emulators","aliases":[],"takesValue":false,"repeatable":false}]}]]},{"from":"parsing","to":"parsing","event":"INIT","eventId":"evt_H836C79STMWXAF5SS8XM6ZWAQ3"},{"from":"parsing","to":"ready","event":"SERVE_ARGS_DONE","eventId":"evt_K30T57A1NX0TYKYXWWQFDXHS3A","guard":["or",[">",["array/len","@payload.errors"],0],["!=",["array/len","@payload.positionals"],1]],"effects":[["emit","SERVE_ANSWERED",{"status":400,"body":"","stderr":"usage: orb serve <FILE> [--port N] [--host H] [--no-mock] [--client-dir DIR] [--open] [--no-emulators]"}]]},{"from":"parsing","to":"working","event":"SERVE_ARGS_DONE","eventId":"evt_K30T57A1NX0TYKYXWWQFDXHS3A","guard":["and",["=",["array/len","@payload.errors"],0],["=",["array/len","@payload.positionals"],1]],"effects":[["emit","SERVE_START",{"cwd":"@entity.path","path":["if",["os/path-is-absolute",["default",["array/first","@payload.positionals"],""]],["default",["array/first","@payload.positionals"],""],["os/path-join","@entity.path",["default",["array/first","@payload.positionals"],""]]],"portText":["default",["array/first",["default",["object/get","@payload.flags","port"],["3030"]]],""],"portOk":["and",["!=",["str/to-number",["default",["array/first",["default",["object/get","@payload.flags","port"],["3030"]]],""]],null],[">=",["str/to-number",["default",["array/first",["default",["object/get","@payload.flags","port"],["3030"]]],""]],0],["<=",["str/to-number",["default",["array/first",["default",["object/get","@payload.flags","port"],["3030"]]],""]],65535],["=",["str/to-int",["default",["array/first",["default",["object/get","@payload.flags","port"],["3030"]]],""]],["str/to-number",["default",["array/first",["default",["object/get","@payload.flags","port"],["3030"]]],""]]]],"host":["default",["array/first",["default",["object/get","@payload.flags","host"],["127.0.0.1"]]],""],"hasClient":["object/has","@payload.flags","client-dir"],"clientDir":["if",["not",["object/has","@payload.flags","client-dir"]],"",["if",["os/path-is-absolute",["default",["array/first",["object/get","@payload.flags","client-dir"]],""]],["default",["array/first",["object/get","@payload.flags","client-dir"]],""],["os/path-join","@entity.path",["default",["array/first",["object/get","@payload.flags","client-dir"]],""]]]],"clientGiven":["default",["array/first",["default",["object/get","@payload.flags","client-dir"],[""]]],""],"clientInside":["if",["not",["object/has","@payload.flags","client-dir"]],true,["str/startsWith",["if",["os/path-is-absolute",["default",["array/first",["object/get","@payload.flags","client-dir"]],""]],["default",["array/first",["object/get","@payload.flags","client-dir"]],""],["os/path-join","@entity.path",["default",["array/first",["object/get","@payload.flags","client-dir"]],""]]],["str/concat","@entity.path","/"]]],"mock":["not",["object/has","@payload.flags","no-mock"]],"open":["object/has","@payload.flags","open"],"noEmulators":["object/has","@payload.flags","no-emulators"],"flagged":["or",["object/has","@payload.flags","port"],["object/has","@payload.flags","host"],["object/has","@payload.flags","client-dir"]]}]]},{"from":"working","to":"working","event":"INIT","eventId":"evt_H836C79STMWXAF5SS8XM6ZWAQ3"},{"from":"working","to":"ready","event":"SERVE_DONE","eventId":"evt_X0QCH44MPMABA29HMMED68WBQG","effects":[["emit","SERVE_ANSWERED",{"status":"@payload.status","body":"@payload.body","stderr":"@payload.stderr","headers":"@payload.headers"}]]}]},"dispatch":"optimistic","sourceDeclaration":{"traitId":"trt_7CE4HCXS06WG36DK92P6BSZF3M","fingerprint":"6c15f23da1e0cdbfd19fb412dcb4b0bcdb2a7e09d99df92076979a1d43757bd3"}},{"name":"ServeEngine","id":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA","effectRow":[{"kind":"behavior/resolve"},{"kind":"emit","resource":"SERVE_ANSWERED"},{"kind":"emit","resource":"SERVE_COMPOSE_READY"},{"kind":"emit","resource":"SERVE_DECLARED_READY"},{"kind":"emit","resource":"SERVE_SEED_DECIDED"},{"kind":"emit","resource":"SERVE_WRITE_SERVER"},{"kind":"os/getenv"},{"kind":"os/mkdir"},{"kind":"os/write-file"},{"kind":"program/read"},{"kind":"set","resource":"@entity.app"},{"kind":"set","resource":"@entity.appName"},{"kind":"set","resource":"@entity.cwd"},{"kind":"set","resource":"@entity.flagged"},{"kind":"set","resource":"@entity.hasClient"},{"kind":"set","resource":"@entity.host"},{"kind":"set","resource":"@entity.mock"},{"kind":"set","resource":"@entity.out"},{"kind":"set","resource":"@entity.path"},{"kind":"set","resource":"@entity.port"},{"kind":"set","resource":"@entity.prepare"},{"kind":"set","resource":"@entity.rel"},{"kind":"set","resource":"@entity.serverName"},{"kind":"set","resource":"@entity.serverOrbitals"},{"kind":"set","resource":"@entity.serverPath"}],"linkedEntity":"ServeRun","linkedEntityId":"ent_CMTFNEWD4F6J7ZMSMQB8MH1C36","entityRefIds":{"ServeRun":"ent_CMTFNEWD4F6J7ZMSMQB8MH1C36"},"emits":[{"event":"SERVE_ANSWERED","eventId":"evt_ZYAFA7YMG1A80XSMZ8RGJZ2VT3","description":"The command's answer, which the cli hook prints; headers carry the bootloader hand-off.","tier":"internal","scope":"external","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true},{"nullable":false,"name":"stderr","type":"string"},{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}]},{"event":"SERVE_REFUSED","eventId":"evt_E13GJG6V01DG0HTE0XRZF3S1PY","description":"The app could not be read or the server could not be resolved.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"}]},{"event":"SERVE_HOME","eventId":"evt_XTMCN01ZN7ZTKSYSHM7GHXQ9PF","description":"os/getenv: the HOME directory.","tier":"internal","payloadSchema":[{"nullable":false,"name":"value","type":"string","required":true}]},{"event":"SERVE_DIR","eventId":"evt_6D84Y5K5M4JT23760AJ4BJSYG7","description":"os/mkdir: the directory serve writes the resolved app into exists.","tier":"internal"},{"event":"SERVE_DIR_FAILED","eventId":"evt_FZPJFCB4CYJ6F9CC054089DVH4","description":"os/mkdir: the serve directory could not be created.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"},{"nullable":false,"name":"kind","type":"string"}]},{"event":"SERVE_APP_READ","eventId":"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y","description":"program/read: the resolved app.","tier":"internal","payloadSchema":[{"nullable":false,"name":"result","type":"object","required":true,"properties":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"loadedResolved","type":"boolean","required":true},{"nullable":false,"name":"programPath","type":"string","required":true}],"projectedFrom":{"type":"ServeAppRead"}}]},{"event":"SERVE_WRITE_SERVER","eventId":"evt_E3AW7CMEVG7DR5A6YHV09KQHZM","description":"Write the server program, std-http-server imported with the serve options as its call-site config.","tier":"internal"},{"event":"SERVE_SEED_DECIDED","eventId":"evt_XGBHKWHSEKWQ9TJV6MW7F0RDKP","description":"The .lolo that composes std-mock-page-seed as MockData, seeding each routed page on its first visit: non-empty only when mock is on and the resolved app declares no MockSeedMark store (it does not already compose std-mock-seed).","tier":"internal","payloadSchema":[{"nullable":false,"name":"seed","type":"string","required":true}]},{"event":"SERVE_SERVER_WRITTEN","eventId":"evt_5NHS4QP5X42YJ9Q3VQYTVTKFQ7","description":"os/write-file: the server program, std-http-server imported with the serve options as its call-site config, is written.","tier":"internal","payloadSchema":[{"nullable":false,"name":"bytes","type":"number"}]},{"event":"SERVE_SERVER_READ","eventId":"evt_VC5KDASP6EV3762KCXVT4A4JZE","description":"program/read: the written server program resolved, its orbital configured with the serve options.","tier":"internal","payloadSchema":[{"nullable":false,"name":"result","type":"object","required":true,"properties":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"text","type":"string","required":true}],"projectedFrom":{"type":"ServeApp"}}]},{"event":"SERVE_SERVER_RESOLVED","eventId":"evt_QZ6W466Z0VFGDKC33EMJX0GA80","description":"behavior/resolve: std-http-server, whose header (grants, environment, egress) the served server keeps around the configured orbital.","tier":"internal","payloadSchema":[{"nullable":false,"name":"result","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}}]},{"event":"SERVE_DECLARED_READY","eventId":"evt_ZG0JP9AVW6DY30J9KJ5HMZ5Z4K","description":"The app declares its own http endpoint, served by its orbital serverOrbital: composed alone, with the serve options set on that orbital.","tier":"internal","payloadSchema":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"serverOrbital","type":"string","required":true},{"nullable":false,"name":"appName","type":"string","required":true},{"nullable":false,"name":"host","type":"string","required":true},{"nullable":false,"name":"port","type":"number","required":true},{"nullable":false,"name":"rel","type":"string","required":true},{"nullable":false,"name":"hasClient","type":"boolean","required":true},{"nullable":false,"name":"path","type":"string","required":true}]},{"event":"SERVE_COMPOSE_READY","eventId":"evt_Q798W27KFTSQXE9VWVYS77C732","description":"Internal: the resolved server, ready to compose with the app.","tier":"internal","payloadSchema":[{"nullable":false,"name":"programs","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"items":{"nullable":false,"name":"","type":"ServeProgram","projectedFrom":{"type":"ServeProgram"}}},{"nullable":false,"name":"appName","type":"string","required":true},{"nullable":false,"name":"host","type":"string","required":true},{"nullable":false,"name":"port","type":"number","required":true},{"nullable":false,"name":"rel","type":"string","required":true},{"nullable":false,"name":"hasClient","type":"boolean","required":true},{"nullable":false,"name":"path","type":"string","required":true},{"nullable":false,"name":"prepare","type":"boolean","required":true},{"nullable":false,"name":"cwd","type":"string","required":true},{"nullable":false,"name":"source","type":"string","required":true}]}],"listens":[{"event":"SERVE_START","eventId":"evt_QYX9G1R7SC3WPA2X6RCJXKHXY3","triggers":"SERVE_START","triggersId":"evt_K256XNB34EHJ7EHVMXG643VRZ3","source":{"kind":"trait","trait":"OrbServe","traitId":"trt_7CE4HCXS06WG36DK92P6BSZF3M"}}],"stateMachine":{"states":[{"name":"idle","isInitial":true},{"name":"homing"},{"name":"making"},{"name":"reading"},{"name":"writing"},{"name":"resolving"}],"events":[{"key":"INIT","id":"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ","name":"Initialize"},{"key":"SERVE_START","id":"evt_K256XNB34EHJ7EHVMXG643VRZ3","name":"Serve Start","description":"Compose the app with std-http-server.","payloadSchema":[{"nullable":false,"name":"cwd","type":"string","required":true},{"nullable":false,"name":"path","type":"string","required":true},{"nullable":false,"name":"portText","type":"string","required":true},{"nullable":false,"name":"portOk","type":"boolean","required":true},{"nullable":false,"name":"host","type":"string","required":true},{"nullable":false,"name":"hasClient","type":"boolean","required":true},{"nullable":false,"name":"clientDir","type":"string","required":true},{"nullable":false,"name":"clientGiven","type":"string","required":true},{"nullable":false,"name":"clientInside","type":"boolean","required":true},{"nullable":false,"name":"mock","type":"boolean","required":true},{"nullable":false,"name":"open","type":"boolean","required":true},{"nullable":false,"name":"noEmulators","type":"boolean","required":true},{"nullable":false,"name":"flagged","type":"boolean","required":true}],"listened":true},{"key":"SERVE_REFUSED","id":"evt_E13GJG6V01DG0HTE0XRZF3S1PY","name":"Serve Refused","description":"The app could not be read or the server could not be resolved.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"}]},{"key":"SERVE_HOME","id":"evt_XTMCN01ZN7ZTKSYSHM7GHXQ9PF","name":"Serve Home","description":"os/getenv: the HOME directory.","tier":"internal","payloadSchema":[{"nullable":false,"name":"value","type":"string","required":true}]},{"key":"SERVE_DIR_FAILED","id":"evt_FZPJFCB4CYJ6F9CC054089DVH4","name":"Serve Dir Failed","description":"os/mkdir: the serve directory could not be created.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"},{"nullable":false,"name":"kind","type":"string"}]},{"key":"SERVE_DIR","id":"evt_6D84Y5K5M4JT23760AJ4BJSYG7","name":"Serve Dir","description":"os/mkdir: the directory serve writes the resolved app into exists.","tier":"internal"},{"key":"SERVE_APP_READ","id":"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y","name":"Serve App Read","description":"program/read: the resolved app.","tier":"internal","payloadSchema":[{"nullable":false,"name":"result","type":"object","required":true,"properties":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"loadedResolved","type":"boolean","required":true},{"nullable":false,"name":"programPath","type":"string","required":true}],"projectedFrom":{"type":"ServeAppRead"}}]},{"key":"SERVE_WRITE_SERVER","id":"evt_E3AW7CMEVG7DR5A6YHV09KQHZM","name":"Serve Write Server","description":"Write the server program, std-http-server imported with the serve options as its call-site config.","tier":"internal"},{"key":"SERVE_SEED_DECIDED","id":"evt_XGBHKWHSEKWQ9TJV6MW7F0RDKP","name":"Serve Seed Decided","description":"The .lolo that composes std-mock-page-seed as MockData, seeding each routed page on its first visit: non-empty only when mock is on and the resolved app declares no MockSeedMark store (it does not already compose std-mock-seed).","tier":"internal","payloadSchema":[{"nullable":false,"name":"seed","type":"string","required":true}],"listened":true},{"key":"SERVE_SERVER_WRITTEN","id":"evt_5NHS4QP5X42YJ9Q3VQYTVTKFQ7","name":"Serve Server Written","description":"os/write-file: the server program, std-http-server imported with the serve options as its call-site config, is written.","tier":"internal","payloadSchema":[{"nullable":false,"name":"bytes","type":"number"}]},{"key":"SERVE_SERVER_READ","id":"evt_VC5KDASP6EV3762KCXVT4A4JZE","name":"Serve Server Read","description":"program/read: the written server program resolved, its orbital configured with the serve options.","tier":"internal","payloadSchema":[{"nullable":false,"name":"result","type":"object","required":true,"properties":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"text","type":"string","required":true}],"projectedFrom":{"type":"ServeApp"}}]},{"key":"SERVE_SERVER_RESOLVED","id":"evt_QZ6W466Z0VFGDKC33EMJX0GA80","name":"Serve Server Resolved","description":"behavior/resolve: std-http-server, whose header (grants, environment, egress) the served server keeps around the configured orbital.","tier":"internal","payloadSchema":[{"nullable":false,"name":"result","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}}]},{"key":"SERVE_ANSWERED","id":"evt_ZYAFA7YMG1A80XSMZ8RGJZ2VT3","name":"Serve Answered","description":"The command's answer, which the cli hook prints; headers carry the bootloader hand-off.","tier":"internal","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true},{"nullable":false,"name":"stderr","type":"string"},{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}]},{"key":"SERVE_DECLARED_READY","id":"evt_ZG0JP9AVW6DY30J9KJ5HMZ5Z4K","name":"Serve Declared Ready","description":"The app declares its own http endpoint, served by its orbital serverOrbital: composed alone, with the serve options set on that orbital.","tier":"internal","payloadSchema":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"serverOrbital","type":"string","required":true},{"nullable":false,"name":"appName","type":"string","required":true},{"nullable":false,"name":"host","type":"string","required":true},{"nullable":false,"name":"port","type":"number","required":true},{"nullable":false,"name":"rel","type":"string","required":true},{"nullable":false,"name":"hasClient","type":"boolean","required":true},{"nullable":false,"name":"path","type":"string","required":true}]},{"key":"SERVE_COMPOSE_READY","id":"evt_Q798W27KFTSQXE9VWVYS77C732","name":"Serve Compose Ready","description":"Internal: the resolved server, ready to compose with the app.","tier":"internal","payloadSchema":[{"nullable":false,"name":"programs","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"items":{"nullable":false,"name":"","type":"ServeProgram","projectedFrom":{"type":"ServeProgram"}}},{"nullable":false,"name":"appName","type":"string","required":true},{"nullable":false,"name":"host","type":"string","required":true},{"nullable":false,"name":"port","type":"number","required":true},{"nullable":false,"name":"rel","type":"string","required":true},{"nullable":false,"name":"hasClient","type":"boolean","required":true},{"nullable":false,"name":"path","type":"string","required":true},{"nullable":false,"name":"prepare","type":"boolean","required":true},{"nullable":false,"name":"cwd","type":"string","required":true},{"nullable":false,"name":"source","type":"string","required":true}]}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ"},{"from":"idle","to":"idle","event":"SERVE_START","eventId":"evt_K256XNB34EHJ7EHVMXG643VRZ3","guard":"@payload.open","effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":"Error: orb serve --open has no declared counterpart in std-http-server: open the browser yourself"}]]},{"from":"idle","to":"idle","event":"SERVE_START","eventId":"evt_K256XNB34EHJ7EHVMXG643VRZ3","guard":["and",["not","@payload.open"],"@payload.noEmulators"],"effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":"Error: orb serve --no-emulators has no declared counterpart in std-http-server: sign-in is selected by AUTH_PROVIDER in the environment"}]]},{"from":"idle","to":"idle","event":"SERVE_START","eventId":"evt_K256XNB34EHJ7EHVMXG643VRZ3","guard":["and",["not","@payload.open"],["not","@payload.noEmulators"],["not","@payload.portOk"]],"effects":[["emit","SERVE_ANSWERED",{"status":400,"body":"","stderr":["str/concat","error: invalid value '","@payload.portText","' for '--port <PORT>': not an integer from 0 to 65535"]}]]},{"from":"idle","to":"idle","event":"SERVE_START","eventId":"evt_K256XNB34EHJ7EHVMXG643VRZ3","guard":["and",["not","@payload.open"],["not","@payload.noEmulators"],"@payload.portOk",["not","@payload.clientInside"]],"effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":["str/concat","Error: --client-dir ","@payload.clientGiven"," is outside the working directory ","@payload.cwd","; the server reads its client under it"]}]]},{"from":"idle","to":"homing","event":"SERVE_START","eventId":"evt_K256XNB34EHJ7EHVMXG643VRZ3","guard":["and",["not","@payload.open"],["not","@payload.noEmulators"],"@payload.portOk","@payload.clientInside"],"effects":[["set","@entity.path","@payload.path"],["set","@entity.host","@payload.host"],["set","@entity.port",["default",["str/to-number","@payload.portText"],0]],["set","@entity.hasClient","@payload.hasClient"],["set","@entity.rel",["if","@payload.hasClient",["str/slice","@payload.clientDir",["+",["str/len","@payload.cwd"],1],["str/len","@payload.clientDir"]],""]],["set","@entity.mock","@payload.mock"],["set","@entity.flagged","@payload.flagged"],["set","@entity.cwd","@payload.cwd"],["os/getenv","HOME",{"key":"home","emit":{"success":"SERVE_HOME","failure":"SERVE_REFUSED"}}]]},{"from":"homing","to":"homing","event":"INIT","eventId":"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ"},{"from":"homing","to":"idle","event":"SERVE_REFUSED","eventId":"evt_E13GJG6V01DG0HTE0XRZF3S1PY","effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":["str/concat","Error: ",["default","@payload.error",""]]}]]},{"from":"homing","to":"idle","event":"SERVE_HOME","eventId":"evt_XTMCN01ZN7ZTKSYSHM7GHXQ9PF","guard":["=","@payload.value",""],"effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":"Error: HOME is not set; orb serve writes the resolved app under ~/.almadar/serve"}]]},{"from":"homing","to":"making","event":"SERVE_HOME","eventId":"evt_XTMCN01ZN7ZTKSYSHM7GHXQ9PF","guard":["!=","@payload.value",""],"effects":[["set","@entity.out",["os/path-join","@payload.value",".almadar/serve",["str/concat",["str/replaceAll","@entity.path","/","_"],".orb"]]],["set","@entity.serverName",["str/concat",["str/replaceAll","@entity.path","/","_"],".server.lolo"]],["set","@entity.serverPath",["os/path-join","@payload.value",".almadar/serve",["str/concat",["str/replaceAll","@entity.path","/","_"],".server.lolo"]]],["os/mkdir","~/.almadar/serve",true,{"key":"servedir","emit":{"success":"SERVE_DIR","failure":"SERVE_DIR_FAILED"}}]]},{"from":"making","to":"making","event":"INIT","eventId":"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ"},{"from":"making","to":"idle","event":"SERVE_DIR_FAILED","eventId":"evt_FZPJFCB4CYJ6F9CC054089DVH4","effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":["str/concat","Error: orb serve could not create ~/.almadar/serve: ",["default","@payload.error",""]]}]]},{"from":"making","to":"reading","event":"SERVE_DIR","eventId":"evt_6D84Y5K5M4JT23760AJ4BJSYG7","effects":[["program/read","",{"resolve":true,"path":"@entity.path","output":"@entity.out","text":false},{"key":"app","emit":{"success":"SERVE_APP_READ","failure":"SERVE_REFUSED"}}]]},{"from":"reading","to":"reading","event":"INIT","eventId":"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ"},{"from":"reading","to":"idle","event":"SERVE_REFUSED","eventId":"evt_E13GJG6V01DG0HTE0XRZF3S1PY","effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":["str/concat","Error: ",["default","@payload.error",""]]}]]},{"from":"reading","to":"idle","event":"SERVE_APP_READ","eventId":"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y","guard":["=",["default",["object/get",["object/get","@payload.result","program"],"name"],""],""],"effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":"Error: the program to serve names no app"}]]},{"from":"reading","to":"idle","event":"SERVE_APP_READ","eventId":"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y","guard":["and",["!=",["default",["object/get",["object/get","@payload.result","program"],"name"],""],""],["array/some",["object/get","@payload.result.program","orbitals",[]],["fn","o",["array/some",["object/get","@o","pages",[]],["fn","pg",["=",["object/get","@pg","protocol","route"],"http"]]]]],"@entity.flagged"],"effects":[["emit","SERVE_ANSWERED",{"status":400,"body":"","stderr":["str/concat","Error: ",["default",["object/get",["object/get","@payload.result","program"],"name"],""]," declares its own http endpoint, so its host, port and client folder are set in the program; drop --port, --host and --client-dir"]}]]},{"from":"reading","to":"idle","event":"SERVE_APP_READ","eventId":"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y","guard":["and",["!=",["default",["object/get",["object/get","@payload.result","program"],"name"],""],""],["array/some",["object/get","@payload.result.program","orbitals",[]],["fn","o",["array/some",["object/get","@o","pages",[]],["fn","pg",["=",["object/get","@pg","protocol","route"],"http"]]]]],["not","@entity.flagged"]],"effects":[["set","@entity.appName",["default",["object/get",["object/get","@payload.result","program"],"name"],""]],["set","@entity.out","@payload.result.programPath"],["set","@entity.app",["object/get","@payload.result","program"]],["emit","SERVE_DECLARED_READY",{"program":["object/get","@payload.result","program"],"serverOrbital":["let",[["so",["array/find",["object/get","@payload.result.program","orbitals",[]],["fn","o",["array/some",["object/get","@o","pages",[]],["fn","pg",["=",["object/get","@pg","protocol","route"],"http"]]]]]]],["if",["=","@so",null],"",["object/get","@so","name"]]],"appName":"@entity.appName","host":"@entity.host","port":"@entity.port","rel":"@entity.rel","hasClient":"@entity.hasClient","path":"@entity.out"}]]},{"from":"reading","to":"writing","event":"SERVE_APP_READ","eventId":"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y","guard":["and",["and",["!=",["default",["object/get",["object/get","@payload.result","program"],"name"],""],""],["not",["array/some",["object/get","@payload.result.program","orbitals",[]],["fn","o",["array/some",["object/get","@o","pages",[]],["fn","pg",["=",["object/get","@pg","protocol","route"],"http"]]]]]]],"@entity.hasClient"],"effects":[["set","@entity.appName",["default",["object/get",["object/get","@payload.result","program"],"name"],""]],["set","@entity.out","@payload.result.programPath"],["set","@entity.app",["object/get","@payload.result","program"]],["emit","SERVE_WRITE_SERVER",{}]]},{"from":"reading","to":"writing","event":"SERVE_APP_READ","eventId":"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y","guard":["and",["and",["!=",["default",["object/get",["object/get","@payload.result","program"],"name"],""],""],["not",["array/some",["object/get","@payload.result.program","orbitals",[]],["fn","o",["array/some",["object/get","@o","pages",[]],["fn","pg",["=",["object/get","@pg","protocol","route"],"http"]]]]]]],["not","@entity.hasClient"]],"effects":[["set","@entity.appName",["default",["object/get",["object/get","@payload.result","program"],"name"],""]],["set","@entity.out","@payload.result.programPath"],["set","@entity.app",["object/get","@payload.result","program"]],["set","@entity.rel",["str/concat",".orbital/serve/","@entity.appName","/web-client"]],["set","@entity.hasClient",true],["set","@entity.prepare",true],["emit","SERVE_WRITE_SERVER",{}]]},{"from":"writing","to":"writing","event":"INIT","eventId":"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ"},{"from":"writing","to":"writing","event":"SERVE_WRITE_SERVER","eventId":"evt_E3AW7CMEVG7DR5A6YHV09KQHZM","effects":[["emit","SERVE_SEED_DECIDED",{"seed":["if",["and","@entity.mock",["not",["array/some",["object/get","@entity.app","orbitals",[]],["fn","o",["array/some",["object/get","@o","auxiliaryEntities",[]],["fn","e",["=",["object/get","@e","collection",""],"mock_seed_marks"]]]]]]],"uses Seed from \"std/behaviors/std-mock-page-seed\"\norbital MockData = Seed.orbitals.MockData {}\n",""]}]]},{"from":"writing","to":"resolving","event":"SERVE_SEED_DECIDED","eventId":"evt_XGBHKWHSEKWQ9TJV6MW7F0RDKP","effects":[["os/write-file",["str/concat","~/.almadar/serve/","@entity.serverName"],["bytes/from-string",["str/concat","app orb-served-server [version: \"1.0.0\"]\n","uses Server from \"std/behaviors/std-http-server\"\n","orbital HttpServerOrbital = Server.orbitals.HttpServerOrbital {\n config {\n"," host: ",["json/stringify","@entity.host"],"\n"," port: ",["json/stringify","@entity.port"],"\n"," portFromEnv: false\n",["if","@entity.hasClient",["str/concat"," clientDir: ",["json/stringify","@entity.rel"],"\n"],""]," }\n}\n","@payload.seed"]],{"key":"serverText","emit":{"success":"SERVE_SERVER_WRITTEN","failure":"SERVE_REFUSED"}}]]},{"from":"resolving","to":"resolving","event":"INIT","eventId":"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ"},{"from":"resolving","to":"idle","event":"SERVE_REFUSED","eventId":"evt_E13GJG6V01DG0HTE0XRZF3S1PY","effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":["str/concat","Error: ",["default","@payload.error",""]]}]]},{"from":"resolving","to":"resolving","event":"SERVE_SERVER_WRITTEN","eventId":"evt_5NHS4QP5X42YJ9Q3VQYTVTKFQ7","effects":[["program/read","",{"resolve":true,"path":"@entity.serverPath"},{"key":"server","emit":{"success":"SERVE_SERVER_READ","failure":"SERVE_REFUSED"}}]]},{"from":"resolving","to":"resolving","event":"SERVE_SERVER_READ","eventId":"evt_VC5KDASP6EV3762KCXVT4A4JZE","effects":[["set","@entity.serverOrbitals",["object/get",["object/get","@payload.result","program"],"orbitals",[]]],["behavior/resolve",{"behavior":"std/behaviors/std-http-server"},{},{"key":"serverHeader","emit":{"success":"SERVE_SERVER_RESOLVED","failure":"SERVE_REFUSED"}}]]},{"from":"resolving","to":"idle","event":"SERVE_SERVER_RESOLVED","eventId":"evt_QZ6W466Z0VFGDKC33EMJX0GA80","effects":[["emit","SERVE_COMPOSE_READY",{"programs":["@entity.app",["object/set","@payload.result","orbitals","@entity.serverOrbitals"]],"appName":"@entity.appName","host":"@entity.host","port":"@entity.port","rel":"@entity.rel","hasClient":"@entity.hasClient","path":"@entity.out","prepare":"@entity.prepare","cwd":"@entity.cwd","source":"@entity.path"}]]}]},"dispatch":"optimistic","sourceDeclaration":{"traitId":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA","fingerprint":"ccf12900cca397680f67b45670bba98a243ac342db8e6fd96838ec880eda902b"}},{"ref":"Handoff.traits.ServeHandoff","id":"trt_9G89799AE5N72R9TCKBH6S17B6","name":"ServeHandoff","listens":[{"event":"SERVE_COMPOSE_READY","triggers":"SERVE_COMPOSE_READY","source":{"kind":"trait","trait":"ServeEngine"}},{"event":"SERVE_DECLARED_READY","triggers":"SERVE_DECLARED_READY","source":{"kind":"trait","trait":"ServeEngine"}}]}],"pages":[{"name":"OrbServePage","id":"pag_PV5R78DAEKN79TMXW3WM43MB5M","path":"","protocol":"boot","traits":[{"ref":"OrbServe","refId":"trt_7CE4HCXS06WG36DK92P6BSZF3M"},{"ref":"ArgsCli","refId":"trt_RWCGCWJKVD9XPMW72CBEN5NWN8"},{"ref":"ServeEngine","refId":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},{"ref":"ServeHandoff","refId":"trt_9G89799AE5N72R9TCKBH6S17B6"}]}],"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}],"OrbCommandArgs":[{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"cwd","type":"string","required":true}],"ServeApp":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"text","type":"string","required":true}],"ServeAppRead":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"loadedResolved","type":"boolean","required":true},{"nullable":false,"name":"programPath","type":"string","required":true}],"ServeAux":[{"nullable":false,"name":"collection","type":"string"}],"ServeMachine":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"ServeOrbital":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"ServePage":[{"nullable":false,"name":"protocol","type":"string"}],"ServeProgram":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"ServeTrait":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"ServeTransition":[{"nullable":false,"name":"event","type":"string"}]}}],"inbound":["cli-serve"],"osGrants":{"fs":[{"glob":"~/.almadar/serve","modes":["create"]},{"glob":"~/.almadar/serve/","modes":["write","create","read"]}],"exec":[],"net":[],"env":["HOME","FIREBASE_AUTH_EMULATOR_HOST","FIREBASE_PROJECT_ID"],"stdio":[],"sys":[],"desktop":[],"anchored":{"fs":[{"anchor":"cwd","glob":".orbital","modes":["create"]},{"anchor":"cwd","glob":".orbital/serve","modes":["create"]},{"anchor":"cwd","glob":".orbital/serve/**","modes":["write","create"]}]}},"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_CMTFNEWD4F6J7ZMSMQB8MH1C36":{"id":"ent_CMTFNEWD4F6J7ZMSMQB8MH1C36","kind":"entity","bakedName":"ServeRun","curName":"ServeRun","renames":[],"owner":"workspace"},"evt_5NHS4QP5X42YJ9Q3VQYTVTKFQ7":{"id":"evt_5NHS4QP5X42YJ9Q3VQYTVTKFQ7","kind":"event","bakedName":"SERVE_SERVER_WRITTEN","curName":"SERVE_SERVER_WRITTEN","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_6D84Y5K5M4JT23760AJ4BJSYG7":{"id":"evt_6D84Y5K5M4JT23760AJ4BJSYG7","kind":"event","bakedName":"SERVE_DIR","curName":"SERVE_DIR","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y":{"id":"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y","kind":"event","bakedName":"SERVE_APP_READ","curName":"SERVE_APP_READ","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_8H34PW6BE95Q4SP2H7ZD7HHFPW":{"id":"evt_8H34PW6BE95Q4SP2H7ZD7HHFPW","kind":"event","bakedName":"SERVE_ARGS_PARSE","curName":"SERVE_ARGS_PARSE","renames":[],"owner":"workspace","parent":"trt_7CE4HCXS06WG36DK92P6BSZF3M"},"evt_E13GJG6V01DG0HTE0XRZF3S1PY":{"id":"evt_E13GJG6V01DG0HTE0XRZF3S1PY","kind":"event","bakedName":"SERVE_REFUSED","curName":"SERVE_REFUSED","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_E3AW7CMEVG7DR5A6YHV09KQHZM":{"id":"evt_E3AW7CMEVG7DR5A6YHV09KQHZM","kind":"event","bakedName":"SERVE_WRITE_SERVER","curName":"SERVE_WRITE_SERVER","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_FZPJFCB4CYJ6F9CC054089DVH4":{"id":"evt_FZPJFCB4CYJ6F9CC054089DVH4","kind":"event","bakedName":"SERVE_DIR_FAILED","curName":"SERVE_DIR_FAILED","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_H836C79STMWXAF5SS8XM6ZWAQ3":{"id":"evt_H836C79STMWXAF5SS8XM6ZWAQ3","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_7CE4HCXS06WG36DK92P6BSZF3M"},"evt_K256XNB34EHJ7EHVMXG643VRZ3":{"id":"evt_K256XNB34EHJ7EHVMXG643VRZ3","kind":"event","bakedName":"SERVE_START","curName":"SERVE_START","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_K30T57A1NX0TYKYXWWQFDXHS3A":{"id":"evt_K30T57A1NX0TYKYXWWQFDXHS3A","kind":"event","bakedName":"SERVE_ARGS_DONE","curName":"SERVE_ARGS_DONE","renames":[],"owner":"workspace","parent":"trt_7CE4HCXS06WG36DK92P6BSZF3M"},"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ":{"id":"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_Q798W27KFTSQXE9VWVYS77C732":{"id":"evt_Q798W27KFTSQXE9VWVYS77C732","kind":"event","bakedName":"SERVE_COMPOSE_READY","curName":"SERVE_COMPOSE_READY","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_QYX9G1R7SC3WPA2X6RCJXKHXY3":{"id":"evt_QYX9G1R7SC3WPA2X6RCJXKHXY3","kind":"event","bakedName":"SERVE_START","curName":"SERVE_START","renames":[],"owner":"workspace","parent":"trt_7CE4HCXS06WG36DK92P6BSZF3M"},"evt_QZ6W466Z0VFGDKC33EMJX0GA80":{"id":"evt_QZ6W466Z0VFGDKC33EMJX0GA80","kind":"event","bakedName":"SERVE_SERVER_RESOLVED","curName":"SERVE_SERVER_RESOLVED","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_TPN6AAV72RKHCCRW0WJFS4QMKN":{"id":"evt_TPN6AAV72RKHCCRW0WJFS4QMKN","kind":"event","bakedName":"SERVE_CALLED","curName":"SERVE_CALLED","renames":[],"owner":"workspace","parent":"trt_7CE4HCXS06WG36DK92P6BSZF3M"},"evt_VC5KDASP6EV3762KCXVT4A4JZE":{"id":"evt_VC5KDASP6EV3762KCXVT4A4JZE","kind":"event","bakedName":"SERVE_SERVER_READ","curName":"SERVE_SERVER_READ","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_X0QCH44MPMABA29HMMED68WBQG":{"id":"evt_X0QCH44MPMABA29HMMED68WBQG","kind":"event","bakedName":"SERVE_DONE","curName":"SERVE_DONE","renames":[],"owner":"workspace","parent":"trt_7CE4HCXS06WG36DK92P6BSZF3M"},"evt_XGBHKWHSEKWQ9TJV6MW7F0RDKP":{"id":"evt_XGBHKWHSEKWQ9TJV6MW7F0RDKP","kind":"event","bakedName":"SERVE_SEED_DECIDED","curName":"SERVE_SEED_DECIDED","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_XJ9EFGWT2HD18Q7FVZ3JGHHC8W":{"id":"evt_XJ9EFGWT2HD18Q7FVZ3JGHHC8W","kind":"event","bakedName":"SERVE_ANSWERED","curName":"SERVE_ANSWERED","renames":[],"owner":"workspace","parent":"trt_7CE4HCXS06WG36DK92P6BSZF3M"},"evt_XTMCN01ZN7ZTKSYSHM7GHXQ9PF":{"id":"evt_XTMCN01ZN7ZTKSYSHM7GHXQ9PF","kind":"event","bakedName":"SERVE_HOME","curName":"SERVE_HOME","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_ZG0JP9AVW6DY30J9KJ5HMZ5Z4K":{"id":"evt_ZG0JP9AVW6DY30J9KJ5HMZ5Z4K","kind":"event","bakedName":"SERVE_DECLARED_READY","curName":"SERVE_DECLARED_READY","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_ZYAFA7YMG1A80XSMZ8RGJZ2VT3":{"id":"evt_ZYAFA7YMG1A80XSMZ8RGJZ2VT3","kind":"event","bakedName":"SERVE_ANSWERED","curName":"SERVE_ANSWERED","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"orb_ZQA89DBEC9Q64ZV00CKBH0A797":{"id":"orb_ZQA89DBEC9Q64ZV00CKBH0A797","kind":"orbital","bakedName":"OrbServeOrbital","curName":"OrbServeOrbital","renames":[],"owner":"workspace"},"pag_PV5R78DAEKN79TMXW3WM43MB5M":{"id":"pag_PV5R78DAEKN79TMXW3WM43MB5M","kind":"page","bakedName":"OrbServePage","curName":"OrbServePage","renames":[],"owner":"workspace"},"trt_7CE4HCXS06WG36DK92P6BSZF3M":{"id":"trt_7CE4HCXS06WG36DK92P6BSZF3M","kind":"trait","bakedName":"OrbServe","curName":"OrbServe","renames":[],"owner":"workspace"},"trt_9G89799AE5N72R9TCKBH6S17B6":{"id":"trt_9G89799AE5N72R9TCKBH6S17B6","kind":"trait","bakedName":"ServeHandoff","curName":"ServeHandoff","renames":[],"owner":"workspace"},"trt_RWCGCWJKVD9XPMW72CBEN5NWN8":{"id":"trt_RWCGCWJKVD9XPMW72CBEN5NWN8","kind":"trait","bakedName":"ArgsCli","curName":"ArgsCli","renames":[],"owner":"workspace"},"trt_ZSNM783DE1PQ0NY9V03K8AZGWA":{"id":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA","kind":"trait","bakedName":"ServeEngine","curName":"ServeEngine","renames":[],"owner":"workspace"}}}}
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}],"OrbCommandArgs":[{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"cwd","type":"string","required":true}],"ServeApp":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"text","type":"string","required":true}],"ServeAppRead":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"loadedResolved","type":"boolean","required":true},{"nullable":false,"name":"programPath","type":"string","required":true}],"ServeAux":[{"nullable":false,"name":"collection","type":"string"}],"ServeMachine":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"ServeOrbital":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"ServePage":[{"nullable":false,"name":"protocol","type":"string"}],"ServeProgram":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"ServeTrait":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"ServeTransition":[{"nullable":false,"name":"event","type":"string"}]},"name":"std-orb-serve","version":"1.0.0","description":"std-orb-serve — the `orb serve <file> [--port N] [--host H] [--no-mock] [--client-dir DIR] [--open] [--no-emulators]` command (spec/cli/orb-serve.lolo; port of orbital-cli program_command.rs serve_program and server_overrides). It resolves the app with program/read { resolve: true, path }. An app that declares its own http endpoint is composed alone, and --port, --host or --client-dir is refused (status 400): its server's options are set in the program. Without --client-dir the app gets a browser client prepared first: program/eval generate { mode: client, webClient: true } compiles it client-mode into <cwd>/.orbital/serve/<app> and lays the typescript shell's prebuilt web client, with the app's runtime files over it, out in .orbital/serve/<app>/web-client, which becomes the clientDir; when FIREBASE_AUTH_EMULATOR_HOST and FIREBASE_PROJECT_ID are both set, that folder's __/firebase/init.json names the Auth emulator for the page. Otherwise it writes ~/.almadar/serve/<app path with / as _>.server.lolo, which imports std-http-server's HttpServerOrbital with the serve options as its call-site config (host, port, portFromEnv false and, with --client-dir made absolute against the working directory and required to lie under it, clientDir relative to the working directory), resolves it with program/read so each knob reaches the trait bodies, and composes the app with std-http-server's resolved program (behavior/resolve, for its header grants) carrying that configured orbital, adding the listen grant for host:port and the anchored cwd read grant of the client dir. The compose, prepare-client and answer half is std-orb-serve-handoff's ServeHandoff, which std-orb-launchpad composes as well. The command never runs the program: it answers a hand-off the bootloader acts on, status 200 with headers orb-run: server, orb-app: the absolute app path, and the composed program's JSON as the body. --open and --no-emulators answer status 500 on stderr with the texts the Rust command bailed with; a port that is not an integer in 0..65535 answers status 400 on stderr; a client dir outside the working directory, an app that names no app or a program that does not resolve or compose answers status 500 on stderr `Error: <reason>`; a missing or second file or an unknown flag answers the usage (status 400, exit 2). Defaults: port 3030, host 127.0.0.1. The resolved app is written (with its catalogs and lazy behaviors) to ~/.almadar/serve/<app path with / as _>.orb, the directory read from the HOME env grant and written under the fs grant ~/.almadar/serve/; orb-app names that file, so the bootloader finds the catalogs. Unless --no-mock, and when the app does not already seed itself, the server program also composes std-mock-page-seed, and, when the app declares an [identity] entity no trait of it signs in, std-dev-personas over that entity (std-mock-seed-marks answers both texts), so the seeder can sign each owner in and the session starts as the first declared role.","orbitals":[{"name":"OrbServeOrbital","id":"orb_ZQA89DBEC9Q64ZV00CKBH0A797","uses":[{"from":"almadar-std/orb-serve","as":"Spec"},{"from":"std/behaviors/std-args","as":"Args"},{"from":"std/behaviors/std-mock-seed-marks","as":"Marks"},{"from":"std/behaviors/std-orb-serve-handoff","as":"Handoff"}],"entity":{"name":"ServeRun","id":"ent_CMTFNEWD4F6J7ZMSMQB8MH1C36","persistence":"runtime","fields":[{"nullable":false,"name":"id","type":"string","required":true},{"nullable":false,"name":"path","type":"string","default":""},{"nullable":false,"name":"host","type":"string","default":""},{"nullable":false,"name":"port","type":"number","default":0},{"nullable":false,"name":"rel","type":"string","default":""},{"nullable":false,"name":"hasClient","type":"boolean","default":false},{"nullable":false,"name":"mock","type":"boolean","default":true},{"nullable":false,"name":"out","type":"string","default":""},{"nullable":false,"name":"flagged","type":"boolean","default":false},{"nullable":false,"name":"serverName","type":"string","default":""},{"nullable":false,"name":"serverPath","type":"string","default":""},{"nullable":false,"name":"serverOrbitals","type":"array","default":[],"items":{"nullable":false,"type":"object","properties":{"name":{"nullable":false,"name":"name","type":"string","required":true},"pages":{"nullable":false,"name":"pages","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"protocol":{"nullable":false,"name":"protocol","type":"string","required":false}},"projectedFrom":{"type":"ServePage"}}},"auxiliaryEntities":{"nullable":false,"name":"auxiliaryEntities","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"collection":{"nullable":false,"name":"collection","type":"string","required":false}},"projectedFrom":{"type":"ServeAux"}}},"traits":{"nullable":false,"name":"traits","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"name":{"nullable":false,"name":"name","type":"string","required":true},"stateMachine":{"nullable":false,"name":"stateMachine","type":"object","required":false,"properties":{"transitions":{"nullable":false,"name":"transitions","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"event":{"nullable":false,"name":"event","type":"string","required":false}},"projectedFrom":{"type":"ServeTransition"}}}},"projectedFrom":{"type":"ServeMachine"}}},"projectedFrom":{"type":"ServeTrait"}}}},"projectedFrom":{"type":"ServeOrbital"}}},{"nullable":false,"name":"appName","type":"string","default":""},{"nullable":false,"name":"app","type":"object","default":{"name":""},"properties":{"name":{"nullable":false,"name":"name","type":"string","required":false},"orbitals":{"nullable":false,"name":"orbitals","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"name":{"nullable":false,"name":"name","type":"string","required":true},"pages":{"nullable":false,"name":"pages","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"protocol":{"nullable":false,"name":"protocol","type":"string","required":false}},"projectedFrom":{"type":"ServePage"}}},"auxiliaryEntities":{"nullable":false,"name":"auxiliaryEntities","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"collection":{"nullable":false,"name":"collection","type":"string","required":false}},"projectedFrom":{"type":"ServeAux"}}},"traits":{"nullable":false,"name":"traits","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"name":{"nullable":false,"name":"name","type":"string","required":true},"stateMachine":{"nullable":false,"name":"stateMachine","type":"object","required":false,"properties":{"transitions":{"nullable":false,"name":"transitions","type":"array","required":false,"items":{"nullable":false,"type":"object","properties":{"event":{"nullable":false,"name":"event","type":"string","required":false}},"projectedFrom":{"type":"ServeTransition"}}}},"projectedFrom":{"type":"ServeMachine"}}},"projectedFrom":{"type":"ServeTrait"}}}},"projectedFrom":{"type":"ServeOrbital"}}}},"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"cwd","type":"string","default":""},{"nullable":false,"name":"prepare","type":"boolean","default":false,"description":"Serve prepares the browser client itself (no --client-dir), from the composed program."},{"nullable":false,"name":"source","type":"string","default":"","description":"The app file itself, whose folder holds its locales/ and public/."}]},"traits":[{"ref":"Args.traits.ArgsParser","id":"trt_RWCGCWJKVD9XPMW72CBEN5NWN8","name":"ArgsCli","listens":[{"event":"SERVE_ARGS_PARSE","triggers":"ARGS_PARSE","source":{"kind":"trait","trait":"OrbServe"}}]},{"ref":"Marks.traits.MarksCheck","id":"trt_G7VJAG0YGAF85CS7FPPWNQJMT9","name":"MarksCli","listens":[{"event":"SERVE_SEED_ASK","triggers":"MARKS_CHECK","source":{"kind":"trait","trait":"ServeEngine"}}]},{"name":"OrbServe","id":"trt_7CE4HCXS06WG36DK92P6BSZF3M","effectRow":[{"kind":"emit","resource":"SERVE_ANSWERED"},{"kind":"emit","resource":"SERVE_ARGS_PARSE"},{"kind":"emit","resource":"SERVE_START"},{"kind":"set","resource":"@entity.path"}],"linkedEntity":"ServeRun","linkedEntityId":"ent_CMTFNEWD4F6J7ZMSMQB8MH1C36","entityRefIds":{"ServeRun":"ent_CMTFNEWD4F6J7ZMSMQB8MH1C36"},"emits":[{"event":"SERVE_ANSWERED","eventId":"evt_XJ9EFGWT2HD18Q7FVZ3JGHHC8W","description":"Internal: the command's answer, which the cli hook prints; headers carry the bootloader hand-off.","tier":"internal","scope":"internal","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true},{"nullable":false,"name":"stderr","type":"string"},{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}]},{"event":"SERVE_ARGS_PARSE","eventId":"evt_8H34PW6BE95Q4SP2H7ZD7HHFPW","description":"Internal: parse the call's words.","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":"SERVE_START","eventId":"evt_QYX9G1R7SC3WPA2X6RCJXKHXY3","description":"Internal: the parsed serve request.","tier":"internal","payloadSchema":[{"nullable":false,"name":"cwd","type":"string","required":true},{"nullable":false,"name":"path","type":"string","required":true},{"nullable":false,"name":"portText","type":"string","required":true},{"nullable":false,"name":"portOk","type":"boolean","required":true},{"nullable":false,"name":"host","type":"string","required":true},{"nullable":false,"name":"hasClient","type":"boolean","required":true},{"nullable":false,"name":"clientDir","type":"string","required":true},{"nullable":false,"name":"clientGiven","type":"string","required":true},{"nullable":false,"name":"clientInside","type":"boolean","required":true},{"nullable":false,"name":"mock","type":"boolean","required":true},{"nullable":false,"name":"open","type":"boolean","required":true},{"nullable":false,"name":"noEmulators","type":"boolean","required":true},{"nullable":false,"name":"flagged","type":"boolean","required":true}]}],"listens":[{"event":"ARGS_PARSED","triggers":"SERVE_ARGS_DONE","triggersId":"evt_K30T57A1NX0TYKYXWWQFDXHS3A","source":{"kind":"trait","trait":"ArgsCli","traitId":"trt_RWCGCWJKVD9XPMW72CBEN5NWN8"}},{"event":"SERVE_ANSWERED","eventId":"evt_XJ9EFGWT2HD18Q7FVZ3JGHHC8W","triggers":"SERVE_DONE","triggersId":"evt_X0QCH44MPMABA29HMMED68WBQG","source":{"kind":"trait","trait":"ServeEngine","traitId":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"}},{"event":"SERVE_ANSWERED","eventId":"evt_XJ9EFGWT2HD18Q7FVZ3JGHHC8W","triggers":"SERVE_DONE","triggersId":"evt_X0QCH44MPMABA29HMMED68WBQG","source":{"kind":"trait","trait":"ServeHandoff","traitId":"trt_9G89799AE5N72R9TCKBH6S17B6"}}],"stateMachine":{"states":[{"name":"ready","isInitial":true},{"name":"parsing"},{"name":"working"}],"events":[{"key":"INIT","id":"evt_H836C79STMWXAF5SS8XM6ZWAQ3","name":"Initialize"},{"key":"SERVE_CALLED","id":"evt_TPN6AAV72RKHCCRW0WJFS4QMKN","name":"Serve Called","description":"Run `orb serve`.","synonyms":"orb serve, serve a program, run the app on a port, http server for a lolo program","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-serve","answers":"SERVE_ANSWERED"}},{"key":"SERVE_ARGS_DONE","id":"evt_K30T57A1NX0TYKYXWWQFDXHS3A","name":"Serve Args Done","description":"std-args's ARGS_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":"SERVE_DONE","id":"evt_X0QCH44MPMABA29HMMED68WBQG","name":"Serve Done","description":"Internal: the engine's answer, relayed to the hook by its handler.","tier":"internal","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true},{"nullable":false,"name":"stderr","type":"string"},{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}],"listened":true},{"key":"SERVE_ANSWERED","id":"evt_XJ9EFGWT2HD18Q7FVZ3JGHHC8W","name":"Serve Answered","description":"Internal: the command's answer, which the cli hook prints; headers carry the bootloader hand-off.","tier":"internal","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true},{"nullable":false,"name":"stderr","type":"string"},{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}]},{"key":"SERVE_ARGS_PARSE","id":"evt_8H34PW6BE95Q4SP2H7ZD7HHFPW","name":"Serve Args Parse","description":"Internal: parse the call's words.","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":"SERVE_START","id":"evt_QYX9G1R7SC3WPA2X6RCJXKHXY3","name":"Serve Start","description":"Internal: the parsed serve request.","tier":"internal","payloadSchema":[{"nullable":false,"name":"cwd","type":"string","required":true},{"nullable":false,"name":"path","type":"string","required":true},{"nullable":false,"name":"portText","type":"string","required":true},{"nullable":false,"name":"portOk","type":"boolean","required":true},{"nullable":false,"name":"host","type":"string","required":true},{"nullable":false,"name":"hasClient","type":"boolean","required":true},{"nullable":false,"name":"clientDir","type":"string","required":true},{"nullable":false,"name":"clientGiven","type":"string","required":true},{"nullable":false,"name":"clientInside","type":"boolean","required":true},{"nullable":false,"name":"mock","type":"boolean","required":true},{"nullable":false,"name":"open","type":"boolean","required":true},{"nullable":false,"name":"noEmulators","type":"boolean","required":true},{"nullable":false,"name":"flagged","type":"boolean","required":true}]}],"transitions":[{"from":"ready","to":"ready","event":"INIT","eventId":"evt_H836C79STMWXAF5SS8XM6ZWAQ3"},{"from":"ready","to":"ready","event":"SERVE_CALLED","eventId":"evt_TPN6AAV72RKHCCRW0WJFS4QMKN","guard":["=",["json/parse","@payload.rawBody","OrbCommandArgs"],null],"effects":[["emit","SERVE_ANSWERED",{"status":400,"body":"","stderr":"usage: orb serve <FILE> [--port N] [--host H] [--no-mock] [--client-dir DIR] [--open] [--no-emulators]"}]]},{"from":"ready","to":"parsing","event":"SERVE_CALLED","eventId":"evt_TPN6AAV72RKHCCRW0WJFS4QMKN","guard":["!=",["json/parse","@payload.rawBody","OrbCommandArgs"],null],"effects":[["set","@entity.path",["object/get",["json/parse","@payload.rawBody","OrbCommandArgs"],"cwd"]],["emit","SERVE_ARGS_PARSE",{"stage":"serve","argv":["object/get",["json/parse","@payload.rawBody","OrbCommandArgs"],"argv"],"flags":[{"name":"port","aliases":["-p"],"takesValue":true,"repeatable":false},{"name":"host","aliases":[],"takesValue":true,"repeatable":false},{"name":"client-dir","aliases":[],"takesValue":true,"repeatable":false},{"name":"no-mock","aliases":[],"takesValue":false,"repeatable":false},{"name":"open","aliases":[],"takesValue":false,"repeatable":false},{"name":"no-emulators","aliases":[],"takesValue":false,"repeatable":false}]}]]},{"from":"parsing","to":"parsing","event":"INIT","eventId":"evt_H836C79STMWXAF5SS8XM6ZWAQ3"},{"from":"parsing","to":"ready","event":"SERVE_ARGS_DONE","eventId":"evt_K30T57A1NX0TYKYXWWQFDXHS3A","guard":["or",[">",["array/len","@payload.errors"],0],["!=",["array/len","@payload.positionals"],1]],"effects":[["emit","SERVE_ANSWERED",{"status":400,"body":"","stderr":"usage: orb serve <FILE> [--port N] [--host H] [--no-mock] [--client-dir DIR] [--open] [--no-emulators]"}]]},{"from":"parsing","to":"working","event":"SERVE_ARGS_DONE","eventId":"evt_K30T57A1NX0TYKYXWWQFDXHS3A","guard":["and",["=",["array/len","@payload.errors"],0],["=",["array/len","@payload.positionals"],1]],"effects":[["emit","SERVE_START",{"cwd":"@entity.path","path":["if",["os/path-is-absolute",["default",["array/first","@payload.positionals"],""]],["default",["array/first","@payload.positionals"],""],["os/path-join","@entity.path",["default",["array/first","@payload.positionals"],""]]],"portText":["default",["array/first",["default",["object/get","@payload.flags","port"],["3030"]]],""],"portOk":["and",["!=",["str/to-number",["default",["array/first",["default",["object/get","@payload.flags","port"],["3030"]]],""]],null],[">=",["str/to-number",["default",["array/first",["default",["object/get","@payload.flags","port"],["3030"]]],""]],0],["<=",["str/to-number",["default",["array/first",["default",["object/get","@payload.flags","port"],["3030"]]],""]],65535],["=",["str/to-int",["default",["array/first",["default",["object/get","@payload.flags","port"],["3030"]]],""]],["str/to-number",["default",["array/first",["default",["object/get","@payload.flags","port"],["3030"]]],""]]]],"host":["default",["array/first",["default",["object/get","@payload.flags","host"],["127.0.0.1"]]],""],"hasClient":["object/has","@payload.flags","client-dir"],"clientDir":["if",["not",["object/has","@payload.flags","client-dir"]],"",["if",["os/path-is-absolute",["default",["array/first",["object/get","@payload.flags","client-dir"]],""]],["default",["array/first",["object/get","@payload.flags","client-dir"]],""],["os/path-join","@entity.path",["default",["array/first",["object/get","@payload.flags","client-dir"]],""]]]],"clientGiven":["default",["array/first",["default",["object/get","@payload.flags","client-dir"],[""]]],""],"clientInside":["if",["not",["object/has","@payload.flags","client-dir"]],true,["str/startsWith",["if",["os/path-is-absolute",["default",["array/first",["object/get","@payload.flags","client-dir"]],""]],["default",["array/first",["object/get","@payload.flags","client-dir"]],""],["os/path-join","@entity.path",["default",["array/first",["object/get","@payload.flags","client-dir"]],""]]],["str/concat","@entity.path","/"]]],"mock":["not",["object/has","@payload.flags","no-mock"]],"open":["object/has","@payload.flags","open"],"noEmulators":["object/has","@payload.flags","no-emulators"],"flagged":["or",["object/has","@payload.flags","port"],["object/has","@payload.flags","host"],["object/has","@payload.flags","client-dir"]]}]]},{"from":"working","to":"working","event":"INIT","eventId":"evt_H836C79STMWXAF5SS8XM6ZWAQ3"},{"from":"working","to":"ready","event":"SERVE_DONE","eventId":"evt_X0QCH44MPMABA29HMMED68WBQG","effects":[["emit","SERVE_ANSWERED",{"status":"@payload.status","body":"@payload.body","stderr":"@payload.stderr","headers":"@payload.headers"}]]}]},"dispatch":"optimistic","sourceDeclaration":{"traitId":"trt_7CE4HCXS06WG36DK92P6BSZF3M","fingerprint":"6c15f23da1e0cdbfd19fb412dcb4b0bcdb2a7e09d99df92076979a1d43757bd3"}},{"name":"ServeEngine","id":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA","effectRow":[{"kind":"behavior/resolve"},{"kind":"emit","resource":"SERVE_ANSWERED"},{"kind":"emit","resource":"SERVE_COMPOSE_READY"},{"kind":"emit","resource":"SERVE_DECLARED_READY"},{"kind":"emit","resource":"SERVE_SEED_ASK"},{"kind":"emit","resource":"SERVE_SEED_DECIDED"},{"kind":"emit","resource":"SERVE_WRITE_SERVER"},{"kind":"os/getenv"},{"kind":"os/mkdir"},{"kind":"os/write-file"},{"kind":"program/read"},{"kind":"set","resource":"@entity.app"},{"kind":"set","resource":"@entity.appName"},{"kind":"set","resource":"@entity.cwd"},{"kind":"set","resource":"@entity.flagged"},{"kind":"set","resource":"@entity.hasClient"},{"kind":"set","resource":"@entity.host"},{"kind":"set","resource":"@entity.mock"},{"kind":"set","resource":"@entity.out"},{"kind":"set","resource":"@entity.path"},{"kind":"set","resource":"@entity.port"},{"kind":"set","resource":"@entity.prepare"},{"kind":"set","resource":"@entity.rel"},{"kind":"set","resource":"@entity.serverName"},{"kind":"set","resource":"@entity.serverOrbitals"},{"kind":"set","resource":"@entity.serverPath"}],"linkedEntity":"ServeRun","linkedEntityId":"ent_CMTFNEWD4F6J7ZMSMQB8MH1C36","entityRefIds":{"ServeRun":"ent_CMTFNEWD4F6J7ZMSMQB8MH1C36"},"emits":[{"event":"SERVE_ANSWERED","eventId":"evt_ZYAFA7YMG1A80XSMZ8RGJZ2VT3","description":"The command's answer, which the cli hook prints; headers carry the bootloader hand-off.","tier":"internal","scope":"external","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true},{"nullable":false,"name":"stderr","type":"string"},{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}]},{"event":"SERVE_REFUSED","eventId":"evt_E13GJG6V01DG0HTE0XRZF3S1PY","description":"The app could not be read or the server could not be resolved.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"}]},{"event":"SERVE_HOME","eventId":"evt_XTMCN01ZN7ZTKSYSHM7GHXQ9PF","description":"os/getenv: the HOME directory.","tier":"internal","payloadSchema":[{"nullable":false,"name":"value","type":"string","required":true}]},{"event":"SERVE_DIR","eventId":"evt_6D84Y5K5M4JT23760AJ4BJSYG7","description":"os/mkdir: the directory serve writes the resolved app into exists.","tier":"internal"},{"event":"SERVE_DIR_FAILED","eventId":"evt_FZPJFCB4CYJ6F9CC054089DVH4","description":"os/mkdir: the serve directory could not be created.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"},{"nullable":false,"name":"kind","type":"string"}]},{"event":"SERVE_APP_READ","eventId":"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y","description":"program/read: the resolved app.","tier":"internal","payloadSchema":[{"nullable":false,"name":"result","type":"object","required":true,"properties":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"loadedResolved","type":"boolean","required":true},{"nullable":false,"name":"programPath","type":"string","required":true}],"projectedFrom":{"type":"ServeAppRead"}}]},{"event":"SERVE_WRITE_SERVER","eventId":"evt_E3AW7CMEVG7DR5A6YHV09KQHZM","description":"Write the server program, std-http-server imported with the serve options as its call-site config.","tier":"internal"},{"event":"SERVE_SEED_ASK","eventId":"evt_ACEHTRF079G3MN4V13BV1S7KYK","description":"Ask std-mock-seed-marks whether the resolved app already declares the MockSeedMark store.","tier":"internal","payloadSchema":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}}]},{"event":"SERVE_SEED_DECIDED","eventId":"evt_XGBHKWHSEKWQ9TJV6MW7F0RDKP","description":"The .lolo that composes std-mock-page-seed as MockData, seeding each routed page on its first visit: non-empty only when mock is on and the resolved app declares no MockSeedMark store (it does not already compose std-mock-seed).","tier":"internal","payloadSchema":[{"nullable":false,"name":"seed","type":"string","required":true}]},{"event":"SERVE_SERVER_WRITTEN","eventId":"evt_5NHS4QP5X42YJ9Q3VQYTVTKFQ7","description":"os/write-file: the server program, std-http-server imported with the serve options as its call-site config, is written.","tier":"internal","payloadSchema":[{"nullable":false,"name":"bytes","type":"number"}]},{"event":"SERVE_SERVER_READ","eventId":"evt_VC5KDASP6EV3762KCXVT4A4JZE","description":"program/read: the written server program resolved, its orbital configured with the serve options.","tier":"internal","payloadSchema":[{"nullable":false,"name":"result","type":"object","required":true,"properties":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"text","type":"string","required":true}],"projectedFrom":{"type":"ServeApp"}}]},{"event":"SERVE_SERVER_RESOLVED","eventId":"evt_QZ6W466Z0VFGDKC33EMJX0GA80","description":"behavior/resolve: std-http-server, whose header (grants, environment, egress) the served server keeps around the configured orbital.","tier":"internal","payloadSchema":[{"nullable":false,"name":"result","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}}]},{"event":"SERVE_DECLARED_READY","eventId":"evt_ZG0JP9AVW6DY30J9KJ5HMZ5Z4K","description":"The app declares its own http endpoint, served by its orbital serverOrbital: composed alone, with the serve options set on that orbital.","tier":"internal","payloadSchema":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"serverOrbital","type":"string","required":true},{"nullable":false,"name":"appName","type":"string","required":true},{"nullable":false,"name":"host","type":"string","required":true},{"nullable":false,"name":"port","type":"number","required":true},{"nullable":false,"name":"rel","type":"string","required":true},{"nullable":false,"name":"hasClient","type":"boolean","required":true},{"nullable":false,"name":"path","type":"string","required":true}]},{"event":"SERVE_COMPOSE_READY","eventId":"evt_Q798W27KFTSQXE9VWVYS77C732","description":"Internal: the resolved server, ready to compose with the app.","tier":"internal","payloadSchema":[{"nullable":false,"name":"programs","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"items":{"nullable":false,"name":"","type":"ServeProgram","projectedFrom":{"type":"ServeProgram"}}},{"nullable":false,"name":"appName","type":"string","required":true},{"nullable":false,"name":"host","type":"string","required":true},{"nullable":false,"name":"port","type":"number","required":true},{"nullable":false,"name":"rel","type":"string","required":true},{"nullable":false,"name":"hasClient","type":"boolean","required":true},{"nullable":false,"name":"path","type":"string","required":true},{"nullable":false,"name":"prepare","type":"boolean","required":true},{"nullable":false,"name":"cwd","type":"string","required":true},{"nullable":false,"name":"source","type":"string","required":true}]}],"listens":[{"event":"SERVE_START","eventId":"evt_QYX9G1R7SC3WPA2X6RCJXKHXY3","triggers":"SERVE_START","triggersId":"evt_K256XNB34EHJ7EHVMXG643VRZ3","source":{"kind":"trait","trait":"OrbServe","traitId":"trt_7CE4HCXS06WG36DK92P6BSZF3M"}},{"event":"MARKS_CHECKED","triggers":"SERVE_SEED_MARKED","triggersId":"evt_6TNCZVJAJ85944SJ0292NPE12C","source":{"kind":"trait","trait":"MarksCli","traitId":"trt_G7VJAG0YGAF85CS7FPPWNQJMT9"}}],"stateMachine":{"states":[{"name":"idle","isInitial":true},{"name":"homing"},{"name":"making"},{"name":"reading"},{"name":"writing"},{"name":"resolving"}],"events":[{"key":"INIT","id":"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ","name":"Initialize"},{"key":"SERVE_START","id":"evt_K256XNB34EHJ7EHVMXG643VRZ3","name":"Serve Start","description":"Compose the app with std-http-server.","payloadSchema":[{"nullable":false,"name":"cwd","type":"string","required":true},{"nullable":false,"name":"path","type":"string","required":true},{"nullable":false,"name":"portText","type":"string","required":true},{"nullable":false,"name":"portOk","type":"boolean","required":true},{"nullable":false,"name":"host","type":"string","required":true},{"nullable":false,"name":"hasClient","type":"boolean","required":true},{"nullable":false,"name":"clientDir","type":"string","required":true},{"nullable":false,"name":"clientGiven","type":"string","required":true},{"nullable":false,"name":"clientInside","type":"boolean","required":true},{"nullable":false,"name":"mock","type":"boolean","required":true},{"nullable":false,"name":"open","type":"boolean","required":true},{"nullable":false,"name":"noEmulators","type":"boolean","required":true},{"nullable":false,"name":"flagged","type":"boolean","required":true}],"listened":true},{"key":"SERVE_REFUSED","id":"evt_E13GJG6V01DG0HTE0XRZF3S1PY","name":"Serve Refused","description":"The app could not be read or the server could not be resolved.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"}]},{"key":"SERVE_HOME","id":"evt_XTMCN01ZN7ZTKSYSHM7GHXQ9PF","name":"Serve Home","description":"os/getenv: the HOME directory.","tier":"internal","payloadSchema":[{"nullable":false,"name":"value","type":"string","required":true}]},{"key":"SERVE_DIR_FAILED","id":"evt_FZPJFCB4CYJ6F9CC054089DVH4","name":"Serve Dir Failed","description":"os/mkdir: the serve directory could not be created.","tier":"internal","payloadSchema":[{"nullable":false,"name":"error","type":"string"},{"nullable":false,"name":"kind","type":"string"}]},{"key":"SERVE_DIR","id":"evt_6D84Y5K5M4JT23760AJ4BJSYG7","name":"Serve Dir","description":"os/mkdir: the directory serve writes the resolved app into exists.","tier":"internal"},{"key":"SERVE_APP_READ","id":"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y","name":"Serve App Read","description":"program/read: the resolved app.","tier":"internal","payloadSchema":[{"nullable":false,"name":"result","type":"object","required":true,"properties":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"loadedResolved","type":"boolean","required":true},{"nullable":false,"name":"programPath","type":"string","required":true}],"projectedFrom":{"type":"ServeAppRead"}}]},{"key":"SERVE_WRITE_SERVER","id":"evt_E3AW7CMEVG7DR5A6YHV09KQHZM","name":"Serve Write Server","description":"Write the server program, std-http-server imported with the serve options as its call-site config.","tier":"internal"},{"key":"SERVE_SEED_MARKED","id":"evt_6TNCZVJAJ85944SJ0292NPE12C","name":"Serve Seed Marked","description":"std-mock-seed-marks's MARKS_CHECKED: whether the app already declares the marks store, and the personas text that composes std-dev-personas onto the app's identity entity (empty when there is none).","tier":"internal","payloadSchema":[{"nullable":false,"name":"marked","type":"boolean","required":true},{"nullable":false,"name":"personas","type":"string","required":true}],"listened":true},{"key":"SERVE_SEED_DECIDED","id":"evt_XGBHKWHSEKWQ9TJV6MW7F0RDKP","name":"Serve Seed Decided","description":"The .lolo that composes std-mock-page-seed as MockData, seeding each routed page on its first visit: non-empty only when mock is on and the resolved app declares no MockSeedMark store (it does not already compose std-mock-seed).","tier":"internal","payloadSchema":[{"nullable":false,"name":"seed","type":"string","required":true}],"listened":true},{"key":"SERVE_SERVER_WRITTEN","id":"evt_5NHS4QP5X42YJ9Q3VQYTVTKFQ7","name":"Serve Server Written","description":"os/write-file: the server program, std-http-server imported with the serve options as its call-site config, is written.","tier":"internal","payloadSchema":[{"nullable":false,"name":"bytes","type":"number"}]},{"key":"SERVE_SERVER_READ","id":"evt_VC5KDASP6EV3762KCXVT4A4JZE","name":"Serve Server Read","description":"program/read: the written server program resolved, its orbital configured with the serve options.","tier":"internal","payloadSchema":[{"nullable":false,"name":"result","type":"object","required":true,"properties":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"text","type":"string","required":true}],"projectedFrom":{"type":"ServeApp"}}]},{"key":"SERVE_SERVER_RESOLVED","id":"evt_QZ6W466Z0VFGDKC33EMJX0GA80","name":"Serve Server Resolved","description":"behavior/resolve: std-http-server, whose header (grants, environment, egress) the served server keeps around the configured orbital.","tier":"internal","payloadSchema":[{"nullable":false,"name":"result","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}}]},{"key":"SERVE_ANSWERED","id":"evt_ZYAFA7YMG1A80XSMZ8RGJZ2VT3","name":"Serve Answered","description":"The command's answer, which the cli hook prints; headers carry the bootloader hand-off.","tier":"internal","payloadSchema":[{"nullable":false,"name":"status","type":"number","required":true},{"nullable":false,"name":"body","type":"string","required":true},{"nullable":false,"name":"stderr","type":"string"},{"nullable":false,"name":"headers","type":"Map<string,string>","items":{"nullable":false,"name":"","type":"string"}}]},{"key":"SERVE_SEED_ASK","id":"evt_ACEHTRF079G3MN4V13BV1S7KYK","name":"Serve Seed Ask","description":"Ask std-mock-seed-marks whether the resolved app already declares the MockSeedMark store.","tier":"internal","payloadSchema":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}}]},{"key":"SERVE_DECLARED_READY","id":"evt_ZG0JP9AVW6DY30J9KJ5HMZ5Z4K","name":"Serve Declared Ready","description":"The app declares its own http endpoint, served by its orbital serverOrbital: composed alone, with the serve options set on that orbital.","tier":"internal","payloadSchema":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"serverOrbital","type":"string","required":true},{"nullable":false,"name":"appName","type":"string","required":true},{"nullable":false,"name":"host","type":"string","required":true},{"nullable":false,"name":"port","type":"number","required":true},{"nullable":false,"name":"rel","type":"string","required":true},{"nullable":false,"name":"hasClient","type":"boolean","required":true},{"nullable":false,"name":"path","type":"string","required":true}]},{"key":"SERVE_COMPOSE_READY","id":"evt_Q798W27KFTSQXE9VWVYS77C732","name":"Serve Compose Ready","description":"Internal: the resolved server, ready to compose with the app.","tier":"internal","payloadSchema":[{"nullable":false,"name":"programs","type":"[object]","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"items":{"nullable":false,"name":"","type":"ServeProgram","projectedFrom":{"type":"ServeProgram"}}},{"nullable":false,"name":"appName","type":"string","required":true},{"nullable":false,"name":"host","type":"string","required":true},{"nullable":false,"name":"port","type":"number","required":true},{"nullable":false,"name":"rel","type":"string","required":true},{"nullable":false,"name":"hasClient","type":"boolean","required":true},{"nullable":false,"name":"path","type":"string","required":true},{"nullable":false,"name":"prepare","type":"boolean","required":true},{"nullable":false,"name":"cwd","type":"string","required":true},{"nullable":false,"name":"source","type":"string","required":true}]}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ"},{"from":"idle","to":"idle","event":"SERVE_START","eventId":"evt_K256XNB34EHJ7EHVMXG643VRZ3","guard":"@payload.open","effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":"Error: orb serve --open has no declared counterpart in std-http-server: open the browser yourself"}]]},{"from":"idle","to":"idle","event":"SERVE_START","eventId":"evt_K256XNB34EHJ7EHVMXG643VRZ3","guard":["and",["not","@payload.open"],"@payload.noEmulators"],"effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":"Error: orb serve --no-emulators has no declared counterpart in std-http-server: sign-in is selected by AUTH_PROVIDER in the environment"}]]},{"from":"idle","to":"idle","event":"SERVE_START","eventId":"evt_K256XNB34EHJ7EHVMXG643VRZ3","guard":["and",["not","@payload.open"],["not","@payload.noEmulators"],["not","@payload.portOk"]],"effects":[["emit","SERVE_ANSWERED",{"status":400,"body":"","stderr":["str/concat","error: invalid value '","@payload.portText","' for '--port <PORT>': not an integer from 0 to 65535"]}]]},{"from":"idle","to":"idle","event":"SERVE_START","eventId":"evt_K256XNB34EHJ7EHVMXG643VRZ3","guard":["and",["not","@payload.open"],["not","@payload.noEmulators"],"@payload.portOk",["not","@payload.clientInside"]],"effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":["str/concat","Error: --client-dir ","@payload.clientGiven"," is outside the working directory ","@payload.cwd","; the server reads its client under it"]}]]},{"from":"idle","to":"homing","event":"SERVE_START","eventId":"evt_K256XNB34EHJ7EHVMXG643VRZ3","guard":["and",["not","@payload.open"],["not","@payload.noEmulators"],"@payload.portOk","@payload.clientInside"],"effects":[["set","@entity.path","@payload.path"],["set","@entity.host","@payload.host"],["set","@entity.port",["default",["str/to-number","@payload.portText"],0]],["set","@entity.hasClient","@payload.hasClient"],["set","@entity.rel",["if","@payload.hasClient",["str/slice","@payload.clientDir",["+",["str/len","@payload.cwd"],1],["str/len","@payload.clientDir"]],""]],["set","@entity.mock","@payload.mock"],["set","@entity.flagged","@payload.flagged"],["set","@entity.cwd","@payload.cwd"],["os/getenv","HOME",{"key":"home","emit":{"success":"SERVE_HOME","failure":"SERVE_REFUSED"}}]]},{"from":"homing","to":"homing","event":"INIT","eventId":"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ"},{"from":"homing","to":"idle","event":"SERVE_REFUSED","eventId":"evt_E13GJG6V01DG0HTE0XRZF3S1PY","effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":["str/concat","Error: ",["default","@payload.error",""]]}]]},{"from":"homing","to":"idle","event":"SERVE_HOME","eventId":"evt_XTMCN01ZN7ZTKSYSHM7GHXQ9PF","guard":["=","@payload.value",""],"effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":"Error: HOME is not set; orb serve writes the resolved app under ~/.almadar/serve"}]]},{"from":"homing","to":"making","event":"SERVE_HOME","eventId":"evt_XTMCN01ZN7ZTKSYSHM7GHXQ9PF","guard":["!=","@payload.value",""],"effects":[["set","@entity.out",["os/path-join","@payload.value",".almadar/serve",["str/concat",["str/replaceAll","@entity.path","/","_"],".orb"]]],["set","@entity.serverName",["str/concat",["str/replaceAll","@entity.path","/","_"],".server.lolo"]],["set","@entity.serverPath",["os/path-join","@payload.value",".almadar/serve",["str/concat",["str/replaceAll","@entity.path","/","_"],".server.lolo"]]],["os/mkdir","~/.almadar/serve",true,{"key":"servedir","emit":{"success":"SERVE_DIR","failure":"SERVE_DIR_FAILED"}}]]},{"from":"making","to":"making","event":"INIT","eventId":"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ"},{"from":"making","to":"idle","event":"SERVE_DIR_FAILED","eventId":"evt_FZPJFCB4CYJ6F9CC054089DVH4","effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":["str/concat","Error: orb serve could not create ~/.almadar/serve: ",["default","@payload.error",""]]}]]},{"from":"making","to":"reading","event":"SERVE_DIR","eventId":"evt_6D84Y5K5M4JT23760AJ4BJSYG7","effects":[["program/read","",{"resolve":true,"path":"@entity.path","output":"@entity.out","text":false},{"key":"app","emit":{"success":"SERVE_APP_READ","failure":"SERVE_REFUSED"}}]]},{"from":"reading","to":"reading","event":"INIT","eventId":"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ"},{"from":"reading","to":"idle","event":"SERVE_REFUSED","eventId":"evt_E13GJG6V01DG0HTE0XRZF3S1PY","effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":["str/concat","Error: ",["default","@payload.error",""]]}]]},{"from":"reading","to":"idle","event":"SERVE_APP_READ","eventId":"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y","guard":["=",["default",["object/get",["object/get","@payload.result","program"],"name"],""],""],"effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":"Error: the program to serve names no app"}]]},{"from":"reading","to":"idle","event":"SERVE_APP_READ","eventId":"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y","guard":["and",["!=",["default",["object/get",["object/get","@payload.result","program"],"name"],""],""],["array/some",["object/get","@payload.result.program","orbitals",[]],["fn","o",["array/some",["object/get","@o","pages",[]],["fn","pg",["=",["object/get","@pg","protocol","route"],"http"]]]]],"@entity.flagged"],"effects":[["emit","SERVE_ANSWERED",{"status":400,"body":"","stderr":["str/concat","Error: ",["default",["object/get",["object/get","@payload.result","program"],"name"],""]," declares its own http endpoint, so its host, port and client folder are set in the program; drop --port, --host and --client-dir"]}]]},{"from":"reading","to":"idle","event":"SERVE_APP_READ","eventId":"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y","guard":["and",["!=",["default",["object/get",["object/get","@payload.result","program"],"name"],""],""],["array/some",["object/get","@payload.result.program","orbitals",[]],["fn","o",["array/some",["object/get","@o","pages",[]],["fn","pg",["=",["object/get","@pg","protocol","route"],"http"]]]]],["not","@entity.flagged"]],"effects":[["set","@entity.appName",["default",["object/get",["object/get","@payload.result","program"],"name"],""]],["set","@entity.out","@payload.result.programPath"],["set","@entity.app",["object/get","@payload.result","program"]],["emit","SERVE_DECLARED_READY",{"program":["object/get","@payload.result","program"],"serverOrbital":["let",[["so",["array/find",["object/get","@payload.result.program","orbitals",[]],["fn","o",["array/some",["object/get","@o","pages",[]],["fn","pg",["=",["object/get","@pg","protocol","route"],"http"]]]]]]],["if",["=","@so",null],"",["object/get","@so","name"]]],"appName":"@entity.appName","host":"@entity.host","port":"@entity.port","rel":"@entity.rel","hasClient":"@entity.hasClient","path":"@entity.out"}]]},{"from":"reading","to":"writing","event":"SERVE_APP_READ","eventId":"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y","guard":["and",["and",["!=",["default",["object/get",["object/get","@payload.result","program"],"name"],""],""],["not",["array/some",["object/get","@payload.result.program","orbitals",[]],["fn","o",["array/some",["object/get","@o","pages",[]],["fn","pg",["=",["object/get","@pg","protocol","route"],"http"]]]]]]],"@entity.hasClient"],"effects":[["set","@entity.appName",["default",["object/get",["object/get","@payload.result","program"],"name"],""]],["set","@entity.out","@payload.result.programPath"],["set","@entity.app",["object/get","@payload.result","program"]],["emit","SERVE_WRITE_SERVER",{}]]},{"from":"reading","to":"writing","event":"SERVE_APP_READ","eventId":"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y","guard":["and",["and",["!=",["default",["object/get",["object/get","@payload.result","program"],"name"],""],""],["not",["array/some",["object/get","@payload.result.program","orbitals",[]],["fn","o",["array/some",["object/get","@o","pages",[]],["fn","pg",["=",["object/get","@pg","protocol","route"],"http"]]]]]]],["not","@entity.hasClient"]],"effects":[["set","@entity.appName",["default",["object/get",["object/get","@payload.result","program"],"name"],""]],["set","@entity.out","@payload.result.programPath"],["set","@entity.app",["object/get","@payload.result","program"]],["set","@entity.rel",["str/concat",".orbital/serve/","@entity.appName","/web-client"]],["set","@entity.hasClient",true],["set","@entity.prepare",true],["emit","SERVE_WRITE_SERVER",{}]]},{"from":"writing","to":"writing","event":"INIT","eventId":"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ"},{"from":"writing","to":"writing","event":"SERVE_WRITE_SERVER","eventId":"evt_E3AW7CMEVG7DR5A6YHV09KQHZM","guard":["not","@entity.mock"],"effects":[["emit","SERVE_SEED_DECIDED",{"seed":""}]]},{"from":"writing","to":"writing","event":"SERVE_WRITE_SERVER","eventId":"evt_E3AW7CMEVG7DR5A6YHV09KQHZM","guard":"@entity.mock","effects":[["emit","SERVE_SEED_ASK",{"program":"@entity.app"}]]},{"from":"writing","to":"writing","event":"SERVE_SEED_MARKED","eventId":"evt_6TNCZVJAJ85944SJ0292NPE12C","effects":[["emit","SERVE_SEED_DECIDED",{"seed":["if","@payload.marked","",["str/concat","uses Seed from \"std/behaviors/std-mock-page-seed\"\norbital MockData = Seed.orbitals.MockData {}\n","@payload.personas"]]}]]},{"from":"writing","to":"resolving","event":"SERVE_SEED_DECIDED","eventId":"evt_XGBHKWHSEKWQ9TJV6MW7F0RDKP","effects":[["os/write-file",["str/concat","~/.almadar/serve/","@entity.serverName"],["bytes/from-string",["str/concat","app orb-served-server [version: \"1.0.0\"]\n","uses Server from \"std/behaviors/std-http-server\"\n","orbital HttpServerOrbital = Server.orbitals.HttpServerOrbital {\n config {\n"," host: ",["json/stringify","@entity.host"],"\n"," port: ",["json/stringify","@entity.port"],"\n"," portFromEnv: false\n",["if","@entity.hasClient",["str/concat"," clientDir: ",["json/stringify","@entity.rel"],"\n"],""]," }\n}\n","@payload.seed"]],{"key":"serverText","emit":{"success":"SERVE_SERVER_WRITTEN","failure":"SERVE_REFUSED"}}]]},{"from":"resolving","to":"resolving","event":"INIT","eventId":"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ"},{"from":"resolving","to":"idle","event":"SERVE_REFUSED","eventId":"evt_E13GJG6V01DG0HTE0XRZF3S1PY","effects":[["emit","SERVE_ANSWERED",{"status":500,"body":"","stderr":["str/concat","Error: ",["default","@payload.error",""]]}]]},{"from":"resolving","to":"resolving","event":"SERVE_SERVER_WRITTEN","eventId":"evt_5NHS4QP5X42YJ9Q3VQYTVTKFQ7","effects":[["program/read","",{"resolve":true,"path":"@entity.serverPath"},{"key":"server","emit":{"success":"SERVE_SERVER_READ","failure":"SERVE_REFUSED"}}]]},{"from":"resolving","to":"resolving","event":"SERVE_SERVER_READ","eventId":"evt_VC5KDASP6EV3762KCXVT4A4JZE","effects":[["set","@entity.serverOrbitals",["object/get",["object/get","@payload.result","program"],"orbitals",[]]],["behavior/resolve",{"behavior":"std/behaviors/std-http-server"},{},{"key":"serverHeader","emit":{"success":"SERVE_SERVER_RESOLVED","failure":"SERVE_REFUSED"}}]]},{"from":"resolving","to":"idle","event":"SERVE_SERVER_RESOLVED","eventId":"evt_QZ6W466Z0VFGDKC33EMJX0GA80","effects":[["emit","SERVE_COMPOSE_READY",{"programs":["@entity.app",["object/set","@payload.result","orbitals","@entity.serverOrbitals"]],"appName":"@entity.appName","host":"@entity.host","port":"@entity.port","rel":"@entity.rel","hasClient":"@entity.hasClient","path":"@entity.out","prepare":"@entity.prepare","cwd":"@entity.cwd","source":"@entity.path"}]]}]},"dispatch":"optimistic","sourceDeclaration":{"traitId":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA","fingerprint":"a262ee1c6d635d7da19b2e5d126aab9c78bf24be3b254c00c1018c3f56b018a5"}},{"ref":"Handoff.traits.ServeHandoff","id":"trt_9G89799AE5N72R9TCKBH6S17B6","name":"ServeHandoff","listens":[{"event":"SERVE_COMPOSE_READY","triggers":"SERVE_COMPOSE_READY","source":{"kind":"trait","trait":"ServeEngine"}},{"event":"SERVE_DECLARED_READY","triggers":"SERVE_DECLARED_READY","source":{"kind":"trait","trait":"ServeEngine"}}]}],"pages":[{"name":"OrbServePage","id":"pag_PV5R78DAEKN79TMXW3WM43MB5M","path":"","protocol":"boot","traits":[{"ref":"OrbServe","refId":"trt_7CE4HCXS06WG36DK92P6BSZF3M"},{"ref":"ArgsCli","refId":"trt_RWCGCWJKVD9XPMW72CBEN5NWN8"},{"ref":"MarksCli","refId":"trt_G7VJAG0YGAF85CS7FPPWNQJMT9"},{"ref":"ServeEngine","refId":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},{"ref":"ServeHandoff","refId":"trt_9G89799AE5N72R9TCKBH6S17B6"}]}],"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}],"OrbCommandArgs":[{"nullable":false,"name":"argv","type":"[string]","required":true,"items":{"nullable":false,"name":"","type":"string"}},{"nullable":false,"name":"cwd","type":"string","required":true}],"ServeApp":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"text","type":"string","required":true}],"ServeAppRead":[{"nullable":false,"name":"program","type":"object","required":true,"properties":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"projectedFrom":{"type":"ServeProgram"}},{"nullable":false,"name":"loadedResolved","type":"boolean","required":true},{"nullable":false,"name":"programPath","type":"string","required":true}],"ServeAux":[{"nullable":false,"name":"collection","type":"string"}],"ServeMachine":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"ServeOrbital":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"ServePage":[{"nullable":false,"name":"protocol","type":"string"}],"ServeProgram":[{"nullable":false,"name":"name","type":"string"},{"nullable":false,"name":"orbitals","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"pages","type":"[object]","properties":[{"nullable":false,"name":"protocol","type":"string"}],"items":{"nullable":false,"name":"","type":"ServePage","projectedFrom":{"type":"ServePage"}}},{"nullable":false,"name":"auxiliaryEntities","type":"[object]","properties":[{"nullable":false,"name":"collection","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeAux","projectedFrom":{"type":"ServeAux"}}},{"nullable":false,"name":"traits","type":"[object]","properties":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"items":{"nullable":false,"name":"","type":"ServeTrait","projectedFrom":{"type":"ServeTrait"}}}],"items":{"nullable":false,"name":"","type":"ServeOrbital","projectedFrom":{"type":"ServeOrbital"}}}],"ServeTrait":[{"nullable":false,"name":"name","type":"string","required":true},{"nullable":false,"name":"stateMachine","type":"object","properties":[{"nullable":false,"name":"transitions","type":"[object]","properties":[{"nullable":false,"name":"event","type":"string"}],"items":{"nullable":false,"name":"","type":"ServeTransition","projectedFrom":{"type":"ServeTransition"}}}],"projectedFrom":{"type":"ServeMachine"}}],"ServeTransition":[{"nullable":false,"name":"event","type":"string"}]}}],"inbound":["cli-serve"],"osGrants":{"fs":[{"glob":"~/.almadar/serve","modes":["create"]},{"glob":"~/.almadar/serve/","modes":["write","create","read"]}],"exec":[],"net":[],"env":["HOME","FIREBASE_AUTH_EMULATOR_HOST","FIREBASE_PROJECT_ID"],"stdio":[],"sys":[],"desktop":[],"anchored":{"fs":[{"anchor":"cwd","glob":".orbital","modes":["create"]},{"anchor":"cwd","glob":".orbital/serve","modes":["create"]},{"anchor":"cwd","glob":".orbital/serve/**","modes":["write","create"]}]}},"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_CMTFNEWD4F6J7ZMSMQB8MH1C36":{"id":"ent_CMTFNEWD4F6J7ZMSMQB8MH1C36","kind":"entity","bakedName":"ServeRun","curName":"ServeRun","renames":[],"owner":"workspace"},"evt_5NHS4QP5X42YJ9Q3VQYTVTKFQ7":{"id":"evt_5NHS4QP5X42YJ9Q3VQYTVTKFQ7","kind":"event","bakedName":"SERVE_SERVER_WRITTEN","curName":"SERVE_SERVER_WRITTEN","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_6D84Y5K5M4JT23760AJ4BJSYG7":{"id":"evt_6D84Y5K5M4JT23760AJ4BJSYG7","kind":"event","bakedName":"SERVE_DIR","curName":"SERVE_DIR","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_6TNCZVJAJ85944SJ0292NPE12C":{"id":"evt_6TNCZVJAJ85944SJ0292NPE12C","kind":"event","bakedName":"SERVE_SEED_MARKED","curName":"SERVE_SEED_MARKED","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y":{"id":"evt_76BYQE45ZZ2ZZWHNTQDBC9E24Y","kind":"event","bakedName":"SERVE_APP_READ","curName":"SERVE_APP_READ","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_8H34PW6BE95Q4SP2H7ZD7HHFPW":{"id":"evt_8H34PW6BE95Q4SP2H7ZD7HHFPW","kind":"event","bakedName":"SERVE_ARGS_PARSE","curName":"SERVE_ARGS_PARSE","renames":[],"owner":"workspace","parent":"trt_7CE4HCXS06WG36DK92P6BSZF3M"},"evt_ACEHTRF079G3MN4V13BV1S7KYK":{"id":"evt_ACEHTRF079G3MN4V13BV1S7KYK","kind":"event","bakedName":"SERVE_SEED_ASK","curName":"SERVE_SEED_ASK","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_E13GJG6V01DG0HTE0XRZF3S1PY":{"id":"evt_E13GJG6V01DG0HTE0XRZF3S1PY","kind":"event","bakedName":"SERVE_REFUSED","curName":"SERVE_REFUSED","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_E3AW7CMEVG7DR5A6YHV09KQHZM":{"id":"evt_E3AW7CMEVG7DR5A6YHV09KQHZM","kind":"event","bakedName":"SERVE_WRITE_SERVER","curName":"SERVE_WRITE_SERVER","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_FZPJFCB4CYJ6F9CC054089DVH4":{"id":"evt_FZPJFCB4CYJ6F9CC054089DVH4","kind":"event","bakedName":"SERVE_DIR_FAILED","curName":"SERVE_DIR_FAILED","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_H836C79STMWXAF5SS8XM6ZWAQ3":{"id":"evt_H836C79STMWXAF5SS8XM6ZWAQ3","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_7CE4HCXS06WG36DK92P6BSZF3M"},"evt_K256XNB34EHJ7EHVMXG643VRZ3":{"id":"evt_K256XNB34EHJ7EHVMXG643VRZ3","kind":"event","bakedName":"SERVE_START","curName":"SERVE_START","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_K30T57A1NX0TYKYXWWQFDXHS3A":{"id":"evt_K30T57A1NX0TYKYXWWQFDXHS3A","kind":"event","bakedName":"SERVE_ARGS_DONE","curName":"SERVE_ARGS_DONE","renames":[],"owner":"workspace","parent":"trt_7CE4HCXS06WG36DK92P6BSZF3M"},"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ":{"id":"evt_MMWZ0E32H4H8J3SX63ZSCNP2JZ","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_Q798W27KFTSQXE9VWVYS77C732":{"id":"evt_Q798W27KFTSQXE9VWVYS77C732","kind":"event","bakedName":"SERVE_COMPOSE_READY","curName":"SERVE_COMPOSE_READY","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_QYX9G1R7SC3WPA2X6RCJXKHXY3":{"id":"evt_QYX9G1R7SC3WPA2X6RCJXKHXY3","kind":"event","bakedName":"SERVE_START","curName":"SERVE_START","renames":[],"owner":"workspace","parent":"trt_7CE4HCXS06WG36DK92P6BSZF3M"},"evt_QZ6W466Z0VFGDKC33EMJX0GA80":{"id":"evt_QZ6W466Z0VFGDKC33EMJX0GA80","kind":"event","bakedName":"SERVE_SERVER_RESOLVED","curName":"SERVE_SERVER_RESOLVED","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_TPN6AAV72RKHCCRW0WJFS4QMKN":{"id":"evt_TPN6AAV72RKHCCRW0WJFS4QMKN","kind":"event","bakedName":"SERVE_CALLED","curName":"SERVE_CALLED","renames":[],"owner":"workspace","parent":"trt_7CE4HCXS06WG36DK92P6BSZF3M"},"evt_VC5KDASP6EV3762KCXVT4A4JZE":{"id":"evt_VC5KDASP6EV3762KCXVT4A4JZE","kind":"event","bakedName":"SERVE_SERVER_READ","curName":"SERVE_SERVER_READ","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_X0QCH44MPMABA29HMMED68WBQG":{"id":"evt_X0QCH44MPMABA29HMMED68WBQG","kind":"event","bakedName":"SERVE_DONE","curName":"SERVE_DONE","renames":[],"owner":"workspace","parent":"trt_7CE4HCXS06WG36DK92P6BSZF3M"},"evt_XGBHKWHSEKWQ9TJV6MW7F0RDKP":{"id":"evt_XGBHKWHSEKWQ9TJV6MW7F0RDKP","kind":"event","bakedName":"SERVE_SEED_DECIDED","curName":"SERVE_SEED_DECIDED","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_XJ9EFGWT2HD18Q7FVZ3JGHHC8W":{"id":"evt_XJ9EFGWT2HD18Q7FVZ3JGHHC8W","kind":"event","bakedName":"SERVE_ANSWERED","curName":"SERVE_ANSWERED","renames":[],"owner":"workspace","parent":"trt_7CE4HCXS06WG36DK92P6BSZF3M"},"evt_XTMCN01ZN7ZTKSYSHM7GHXQ9PF":{"id":"evt_XTMCN01ZN7ZTKSYSHM7GHXQ9PF","kind":"event","bakedName":"SERVE_HOME","curName":"SERVE_HOME","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_ZG0JP9AVW6DY30J9KJ5HMZ5Z4K":{"id":"evt_ZG0JP9AVW6DY30J9KJ5HMZ5Z4K","kind":"event","bakedName":"SERVE_DECLARED_READY","curName":"SERVE_DECLARED_READY","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"evt_ZYAFA7YMG1A80XSMZ8RGJZ2VT3":{"id":"evt_ZYAFA7YMG1A80XSMZ8RGJZ2VT3","kind":"event","bakedName":"SERVE_ANSWERED","curName":"SERVE_ANSWERED","renames":[],"owner":"workspace","parent":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA"},"orb_ZQA89DBEC9Q64ZV00CKBH0A797":{"id":"orb_ZQA89DBEC9Q64ZV00CKBH0A797","kind":"orbital","bakedName":"OrbServeOrbital","curName":"OrbServeOrbital","renames":[],"owner":"workspace"},"pag_PV5R78DAEKN79TMXW3WM43MB5M":{"id":"pag_PV5R78DAEKN79TMXW3WM43MB5M","kind":"page","bakedName":"OrbServePage","curName":"OrbServePage","renames":[],"owner":"workspace"},"trt_7CE4HCXS06WG36DK92P6BSZF3M":{"id":"trt_7CE4HCXS06WG36DK92P6BSZF3M","kind":"trait","bakedName":"OrbServe","curName":"OrbServe","renames":[],"owner":"workspace"},"trt_9G89799AE5N72R9TCKBH6S17B6":{"id":"trt_9G89799AE5N72R9TCKBH6S17B6","kind":"trait","bakedName":"ServeHandoff","curName":"ServeHandoff","renames":[],"owner":"workspace"},"trt_G7VJAG0YGAF85CS7FPPWNQJMT9":{"id":"trt_G7VJAG0YGAF85CS7FPPWNQJMT9","kind":"trait","bakedName":"MarksCli","curName":"MarksCli","renames":[],"owner":"workspace"},"trt_RWCGCWJKVD9XPMW72CBEN5NWN8":{"id":"trt_RWCGCWJKVD9XPMW72CBEN5NWN8","kind":"trait","bakedName":"ArgsCli","curName":"ArgsCli","renames":[],"owner":"workspace"},"trt_ZSNM783DE1PQ0NY9V03K8AZGWA":{"id":"trt_ZSNM783DE1PQ0NY9V03K8AZGWA","kind":"trait","bakedName":"ServeEngine","curName":"ServeEngine","renames":[],"owner":"workspace"}}}}