Skip to content

docs: linking runtimes (peering) and the remote caller - #99

Draft
dlipicar wants to merge 9 commits into
docs/runtime-processfrom
feat/peering
Draft

dlipicar wants to merge 9 commits into
docs/runtime-processfrom
feat/peering

Conversation

@dlipicar

@dlipicar dlipicar commented Sep 26, 2026 •

Copy link
Copy Markdown
Contributor

Stacked on #98 (docs/runtime-process). Documents cross-instance module calls: logos-co/logos-peering, logos-co/logos-liblogos#230 and logos-co/logos-logoscore-cli (feat/peering).

  • New §9.6 "Linking runtimes (peering)":

  • Caller identity: the Remote{peer, name} arm, in C++ (isRemote()) and Rust; the operator @peer:<runtime id>:<consumer> a remote client's forwarded call arrives as.

  • §6.1: logos_host_remote and LOGOS_HOST_REMOTE_PATH.

  • CLI summary: logosctl peer. peer and remote exist only in the logosctl binary, so §9.6 uses logosctl throughout.

  • §6.1, placement: "single_process": true, for a deployment with no other processes: every module runs in the runtime's process or does not load, and peering_module, peering_identity and each import's facade run there too (feat: peering — imports as facades, exports on tls_tcp logos-liblogos#230).

🤖 Generated with Claude Code

dlipicar and others added 6 commits September 26, 2026 00:58
…mote

A new §9.6: the peering section, pairing by code, invite or local invite,
export, import and policy, facades and what a provider module sees. The
caller identity section gains the Remote arm (C++ and Rust), §6.1 names
logos_host_remote and LOGOS_HOST_REMOTE_PATH, and the CLI summary lists
`logoscore peer`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…camp's page

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…quests

- The provider's capability_module decides every route from its remote
  policy, and a narrower policy ends the routes it no longer allows.
- Basecamp's "Accept pairing for 5 min" and its consent dialog.
- `peer status` says why an enabled control endpoint is not listening.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
§9.6 and the CLI summary used `logoscore peer` and `logoscore --remote`,
but only the logosctl binary has these commands. The names now match the
downstream fix in #100, line for line.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
dlipicar and others added 3 commits September 26, 2026 23:53
§9.6 "Operating a daemon from another computer" follows logos-lips
runtime §9, as logos-peering, liblogos and logosctl now implement it:
`runtime_control: true` on the daemon, `peer invite --runtime-control`,
and a remote policy that grants the client's `logosctl` consumer each
core_service method (and the target method of a forwarded call). Pairing
grants nothing; "*" covers user modules, never core_service; the
runtime's own modules are never reachable. The caller table names the
operator `@peer:<runtime id>:<consumer>` a forwarded call arrives as.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…itself

Documents `"single_process": true` placement: every module in the runtime's
process or not at all, the package modules never, and peering_module,
peering_identity and each import's facade there too.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…cess

Found by the standalone-apps session: a single-process runtime refuses a module
that is not bundled, which is by design but the first thing an app author hits.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant