ai

module
v0.0.0-...-7ec15ec Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 21, 2026 License: GPL-3.0

README

TOS AI services

This repository holds the tos_service_v1 protocol specification and the Go implementation of the service layer on top of the TOS Network: the protocol boundary library and tools, the stateless public gateway, the local execution base, and the Agent-native Messenger through which OpenFox agents talk to each other. Finalized TOS account state is the only authority; everything here either specifies that state, reads and relays it, or executes work bound by it.

Layout

Directory Contents
spec/ Normative product and protocol specification: documents, the tos.service.v1 schema, JSON schemas, manifests, frozen test vectors and deployment evidence records
protocol/ Protocol boundary: generated Connect API, Agent and Capability state machines, finalized chain reads, SDKs, the private service RPC and tools
gateway/ Stateless public gateway: transport authentication, forwarding, discovery and retrieval; it holds no business authority
execution/ Local execution base: fail-closed container execution bound by an Accepted Quote, and the evidence it produces for on-chain receipts
messenger/ Agent-native Messenger: identities, conversations, groups (with the OpenMLS driver in messenger/rust/openmls-driver), mailboxes, public channels and encrypted attachments for Agents

The public gateway, the executor service, the Messenger daemon and the protocol library remain separate programs. make boundary-lint enforces that gateway/ does not import execution/, that protocol/ imports neither, that messenger/ imports protocol/ only, and that nothing imports messenger/.

Build and test

The repository is one Go module (github.com/tosnetwork/ai, Go 1.26.11).

make verify

runs format, schema, vet, race-enabled tests, build, conformance, boundary and specification checks, and messenger's ADNL, OpenMLS (with cargo), attachment sandbox and vector checks. The sandbox check needs bubblewrap, prlimit, a user systemd manager and unprivileged user namespaces (on Ubuntu with AppArmor: kernel.apparmor_restrict_unprivileged_userns=0); it fails rather than skips without them. Tests that check real ML-DSA-44 bytes need a pinned tosctl helper built from tosnetwork/tos and fail without it:

export TOS_SERVICE_TOSCTL=/path/to/tosctl
export TOS_SERVICE_TOSCTL_SHA256=<sha256 of that binary>

make test-privileged runs the executor service's privileged suite (root and a private containerd); it is opt-in and not part of verify.

License

GPL-3.0; see LICENSE.

Directories

Path Synopsis
execution
cmd/software-work-execute command
Command software-work-execute runs one V1 software-work job through the production bounded executor and prints its content-addressed outcome.
Command software-work-execute runs one V1 software-work job through the production bounded executor and prints its content-addressed outcome.
cmd/software-work-executord command
Command software-work-executord is the root-run executor service of a provider host.
Command software-work-executord is the root-run executor service of a provider host.
executor/gpuisolation
Package gpuisolation provides the exclusive GPU-device lease boundary used in front of a reviewed container backend.
Package gpuisolation provides the exclusive GPU-device lease boundary used in front of a reviewed container backend.
internal/actionauthoritytest
Package actionauthoritytest supports tests of the ML-DSA-44 Action Authority boundary: an authority-scoped resolver, a private tosctl vault whose controllers can sign one message under any signature use (so a test can present a signature made under another context), and the refusal variants every Action Authority consumer must reject.
Package actionauthoritytest supports tests of the ML-DSA-44 Action Authority boundary: an authority-scoped resolver, a private tosctl vault whose controllers can sign one message under any signature use (so a test can present a signature made under another context), and the refusal variants every Action Authority consumer must reject.
internal/dirlock
Package dirlock provides non-blocking process ownership for private local state directories.
Package dirlock provides non-blocking process ownership for private local state directories.
internal/nilcheck
Package nilcheck provides the construction-time interface validation used at operator-controlled dependency injection boundaries.
Package nilcheck provides the construction-time interface validation used at operator-controlled dependency injection boundaries.
internal/resourceguard
Package resourceguard continuously verifies that the host class which backed startup admission still exists.
Package resourceguard continuously verifies that the host class which backed startup admission still exists.
pkg/artifacthttp
Package artifacthttp publishes verified artifactstore objects through a stable HTTPS content-addressed URL.
Package artifacthttp publishes verified artifactstore objects through a stable HTTPS content-addressed URL.
pkg/artifactstore
Package artifactstore provides a bounded, immutable local content-addressed store for software-work outputs.
Package artifactstore provides a bounded, immutable local content-addressed store for software-work outputs.
pkg/capabilitygate
Package capabilitygate enforces Trusted Capability V1 at the executor sink.
Package capabilitygate enforces Trusted Capability V1 at the executor sink.
pkg/commercegate
Package commercegate implements the local, Agreement-bound execution start boundary.
Package commercegate implements the local, Agreement-bound execution start boundary.
pkg/executor
Package executor defines the isolation contract for containerd-backed execution.
Package executor defines the isolation contract for containerd-backed execution.
pkg/executor/backendtest
Package backendtest provides a reusable black-box lifecycle suite for audited isolated-execution backend implementations.
Package backendtest provides a reusable black-box lifecycle suite for audited isolated-execution backend implementations.
pkg/executorservice
Package executorservice is the privilege boundary between an unprivileged provider node and the root-only private containerd: a server that runs the frozen software-work job on behalf of an allowed local uid, and the client that node uses to reach it over a Unix socket.
Package executorservice is the privilege boundary between an unprivileged provider node and the root-only private containerd: a server that runs the frozen software-work job on behalf of an allowed local uid, and the client that node uses to reach it over a Unix socket.
pkg/metricsexport
Package metricsexport provides an explicitly configured, bounded remote export path for the worker's privacy-minimized Prometheus snapshot.
Package metricsexport provides an explicitly configured, bounded remote export path for the worker's privacy-minimized Prometheus snapshot.
pkg/privateingress
Package privateingress implements the receiver-selected, Agreement-bound private byte ingress used before a commerce execution starts.
Package privateingress implements the receiver-selected, Agreement-bound private byte ingress used before a commerce execution starts.
pkg/probe
Package probe reports coarse host capabilities without exposing serial numbers, exact topology, customer data, or a stable hardware fingerprint.
Package probe reports coarse host capabilities without exposing serial numbers, exact topology, customer data, or a stable hardware fingerprint.
pkg/railgate
Package railgate admits the execution of a paid Service Actor request at most once, and only while finalized TOS state shows the request pending with enough time left to answer it.
Package railgate admits the execution of a paid Service Actor request at most once, and only while finalized TOS state shows the request pending with enough time left to answer it.
pkg/servicemanager
Package servicemanager provides a fixed-unit systemd adapter for operator composition.
Package servicemanager provides a fixed-unit systemd adapter for operator composition.
pkg/softwareupdate
Package softwareupdate manages two crash-safe software release slots.
Package softwareupdate manages two crash-safe software release slots.
pkg/softwarework
Package softwarework binds the frozen software-work contract to the bounded executor and immutable artifact store.
Package softwarework binds the frozen software-work contract to the bounded executor and immutable artifact store.
pkg/update
Package update verifies content-addressed release manifests.
Package update verifies content-addressed release manifests.
gateway
cmd/api command
Command api runs the stateless tos_service_v1 gateway.
Command api runs the stateless tos_service_v1 gateway.
cmd/tos-service-intent-carrierd command
Command tos-service-intent-carrierd runs the Gateway Intent Carrier as an independently deployable process.
Command tos-service-intent-carrierd runs the Gateway Intent Carrier as an independently deployable process.
internal/actionauthoritytest
Package actionauthoritytest supports tests of the ML-DSA-44 Action Authority boundary: an authority-scoped resolver, a private tosctl vault whose controllers can sign one message under any signature use (so a test can present a signature made under another context), and the refusal variants every Action Authority consumer must reject.
Package actionauthoritytest supports tests of the ML-DSA-44 Action Authority boundary: an authority-scoped resolver, a private tosctl vault whose controllers can sign one message under any signature use (so a test can present a signature made under another context), and the refusal variants every Action Authority consumer must reject.
internal/adapters/serviceprotocol
Package toprotocol is the privileged Native-only client for the protocol/ private RPC service (tos-service-rpc).
Package toprotocol is the privileged Native-only client for the protocol/ private RPC service (tos-service-rpc).
internal/config
Package config loads the Native-only TOS Service Gateway configuration.
Package config loads the Native-only TOS Service Gateway configuration.
internal/ingress
Package ingress bounds the work a client can make the public gateway do before any handler runs: request size, body read time, global concurrency, and per-client concurrency and request rate.
Package ingress bounds the work a client can make the public gateway do before any handler runs: request size, body read time, global concurrency, and per-client concurrency and request rate.
internal/intentcarrier
Package intentcarrier implements a bounded, non-authoritative Intent Carrier.
Package intentcarrier implements a bounded, non-authoritative Intent Carrier.
internal/nativegateway
Package nativegateway exposes the stateless tos_service_v1 transport.
Package nativegateway exposes the stateless tos_service_v1 transport.
internal/quotesource
Package quotesource loads an owner-private provider profile and constructs the production non-canonical Quote source on the Service Actor rail.
Package quotesource loads an owner-private provider profile and constructs the production non-canonical Quote source on the Service Actor rail.
internal/trustedcapabilitycarrier
Package trustedcapabilitycarrier is a bounded, non-authoritative Carrier for exact Trusted Capability V1 objects.
Package trustedcapabilitycarrier is a bounded, non-authoritative Carrier for exact Trusted Capability V1 objects.
messenger
cmd/tos-attachment-clamav-scanner command
Command tos-attachment-clamav-scanner adapts one pinned ClamScan engine and pinned official CVD/CLD snapshots to the Messenger scan-verdict protocol.
Command tos-attachment-clamav-scanner adapts one pinned ClamScan engine and pinned official CVD/CLD snapshots to the Messenger scan-verdict protocol.
cmd/tos-attachment-corpus command
Command tos-attachment-corpus runs and verifies externally approved private attachment scanner corpora.
Command tos-attachment-corpus runs and verifies externally approved private attachment scanner corpora.
cmd/tos-attachment-text-scanner command
Command tos-attachment-text-scanner is the minimal reference content inspector for inert UTF-8 text attachments.
Command tos-attachment-text-scanner is the minimal reference content inspector for inert UTF-8 text attachments.
cmd/tos-attachmentd command
Command tos-attachmentd runs authenticated opaque attachment storage over a private Unix carrier.
Command tos-attachmentd runs authenticated opaque attachment storage over a private Unix carrier.
cmd/tos-device-fork-evidence command
Command tos-device-fork-evidence assembles or verifies portable proof that one finalized Messaging Endpoint published two non-orderable device sets at the same freshness watermark.
Command tos-device-fork-evidence assembles or verifies portable proof that one finalized Messaging Endpoint published two non-orderable device sets at the same freshness watermark.
cmd/tos-intent-carrierd command
Command tos-intent-carrierd runs the Messenger public-channel Intent Carrier profile.
Command tos-intent-carrierd runs the Messenger public-channel Intent Carrier profile.
cmd/tos-mailboxd command
Command tos-mailboxd runs the bounded authenticated Mailbox service over a private Unix carrier.
Command tos-mailboxd runs the bounded authenticated Mailbox service over a private Unix carrier.
cmd/tos-messenger-lab-group command
Command tos-messenger-lab-group runs the local-only group-chat acceptance carrier.
Command tos-messenger-lab-group runs the local-only group-chat acceptance carrier.
cmd/tos-messenger-openfox-mls command
Command tos-messenger-openfox-mls bootstraps private per-Agent OpenMLS state or serves one owner-private plaintext proxy in front of an opaque lab Relay.
Command tos-messenger-openfox-mls bootstraps private per-Agent OpenMLS state or serves one owner-private plaintext proxy in front of an opaque lab Relay.
cmd/tos-messenger-owner command
Command tos-messenger-owner operates the owner-only approval boundary.
Command tos-messenger-owner operates the owner-only approval boundary.
cmd/tos-messengerd command
Command tos-messengerd runs one Messenger installation.
Command tos-messengerd runs one Messenger installation.
cmd/tos-public-channeld command
Command tos-public-channeld runs one route-neutral public-channel replica on native TOS DHT + ADNL Overlay/RLDP.
Command tos-public-channeld runs one route-neutral public-channel replica on native TOS DHT + ADNL Overlay/RLDP.
cmd/tos-reachability command
Command tos-reachability runs one endpoint of one measured pair and appends a trial record to a study log.
Command tos-reachability runs one endpoint of one measured pair and appends a trial record to a study log.
cmd/tos-reachability-coordinator command
Command tos-reachability-coordinator runs the rendezvous service used by the reachability study.
Command tos-reachability-coordinator runs the rendezvous service used by the reachability study.
cmd/tos-reachability-report command
Command tos-reachability-report aggregates a study log against a predeclared policy and prints the matrix and the route decision.
Command tos-reachability-report aggregates a study log against a predeclared policy and prints the matrix and the route decision.
cmd/tos-reachability-tunnel command
Command tos-reachability-tunnel runs the double-registration UDP forwarder the reachability study's proxy-fallback phase measures against.
Command tos-reachability-tunnel runs the double-registration UDP forwarder the reachability study's proxy-fallback phase measures against.
internal/actionauthoritytest
Package actionauthoritytest supports tests of the ML-DSA-44 Action Authority boundary: an authority-scoped resolver, a private tosctl vault whose controllers can sign one message under any signature use (so a test can present a signature made under another context), and the refusal variants every Action Authority consumer must reject.
Package actionauthoritytest supports tests of the ML-DSA-44 Action Authority boundary: an authority-scoped resolver, a private tosctl vault whose controllers can sign one message under any signature use (so a test can present a signature made under another context), and the refusal variants every Action Authority consumer must reject.
internal/canon
Package canon holds the shared canonical-encoding primitives used by every signed or digest-committed Messenger object.
Package canon holds the shared canonical-encoding primitives used by every signed or digest-committed Messenger object.
internal/dirlock
Package dirlock gives one process exclusive ownership of one private local state directory.
Package dirlock gives one process exclusive ownership of one private local state directory.
internal/ids
Package ids holds every Messenger identifier pattern in one place.
Package ids holds every Messenger identifier pattern in one place.
internal/localwire
Package localwire owns the common bounded Unix-socket mechanics used by local authority-separated APIs.
Package localwire owns the common bounded Unix-socket mechanics used by local authority-separated APIs.
internal/safehttps
Package safehttps constructs bounded HTTPS clients that refuse ambient proxies, redirects, DNS rebinding into non-public address space, and URL authority ambiguity.
Package safehttps constructs bounded HTTPS clients that refuse ambient proxies, redirects, DNS rebinding into non-public address space, and URL authority ambiguity.
internal/securefile
Package securefile reads operator-pinned inputs without following a path substitution between validation and use.
Package securefile reads operator-pinned inputs without following a path substitution between validation and use.
pkg/admission
Package admission decides whether a decrypted inbound event may reach an Agent runtime.
Package admission decides whether a decrypted inbound event may reach an Agent runtime.
pkg/agentpacketbridge
Package agentpacketbridge carries exact Agent Packet V1 bytes through an E2EE Messenger event, reuses the service protocol's finalized verifier, and replaces its process-local replay map with the Messenger's durable journal.
Package agentpacketbridge carries exact Agent Packet V1 bytes through an E2EE Messenger event, reuses the service protocol's finalized verifier, and replaces its process-local replay map with the Messenger's durable journal.
pkg/attachmentadmission
Package attachmentadmission owns the recipient-side boundary from an authenticated encrypted-attachment Event to content an Agent may consume.
Package attachmentadmission owns the recipient-side boundary from an authenticated encrypted-attachment Event to content an Agent may consume.
pkg/attachmentapi
Package attachmentapi is the bounded service protocol for authenticated opaque attachment storage.
Package attachmentapi is the bounded service protocol for authenticated opaque attachment storage.
pkg/attachmentcorpus
Package attachmentcorpus defines signed, private hostile-corpus manifests and signed execution reports for attachment scanner release acceptance.
Package attachmentcorpus defines signed, private hostile-corpus manifests and signed execution reports for attachment scanner release acceptance.
pkg/attachmentops
Package attachmentops assembles the operator-owned resources and daemon-owned durable transaction used to emit encrypted attachments.
Package attachmentops assembles the operator-owned resources and daemon-owned durable transaction used to emit encrypted attachments.
pkg/attachments
Package attachments implements the route-neutral private attachment profile.
Package attachments implements the route-neutral private attachment profile.
pkg/carrierapi
Package carrierapi is the local boundary between the Messenger daemon and the process that carries its relay frames (OpenFox's chat RelayTransport).
Package carrierapi is the local boundary between the Messenger daemon and the process that carries its relay frames (OpenFox's chat RelayTransport).
pkg/chainagent
Package chainagent reads finalized Agent state from TOS chain state and satisfies the Messenger's identity.AgentResolver.
Package chainagent reads finalized Agent state from TOS chain state and satisfies the Messenger's identity.AgentResolver.
pkg/conformance
Package conformance verifies signed reports produced by independent vector consumers.
Package conformance verifies signed reports produced by independent vector consumers.
pkg/contact
Package contact owns the human-input boundary for Messenger contacts.
Package contact owns the human-input boundary for Messenger contacts.
pkg/daemon
Package daemon assembles the Messenger into something that runs.
Package daemon assembles the Messenger into something that runs.
pkg/directhttps
Package directhttps provides the bounded HTTPS first-contact fallback.
Package directhttps provides the bounded HTTPS first-contact fallback.
pkg/directory
Package directory implements Messenger discovery: the signed Messaging Contact Descriptor and the bounded DHT locator that points at it.
Package directory implements Messenger discovery: the signed Messaging Contact Descriptor and the bounded DHT locator that points at it.
pkg/dispatch
Package dispatch sends queued events and decides what to do when a send fails.
Package dispatch sends queued events and decides what to do when a send fails.
pkg/e2ee
Package e2ee defines the contract a candidate end-to-end encryption profile must satisfy, and the bindings that tie one ciphertext to one conversation.
Package e2ee defines the contract a candidate end-to-end encryption profile must satisfy, and the bindings that tie one ciphertext to one conversation.
pkg/e2ee/conformance
Package conformance refutes candidate end-to-end encryption suites.
Package conformance refutes candidate end-to-end encryption suites.
pkg/economicaction
Package economicaction is the Messenger-owned admission boundary for economic side effects.
Package economicaction is the Messenger-owned admission boundary for economic side effects.
pkg/envelope
Package envelope implements the two-layer Messenger wire model.
Package envelope implements the two-layer Messenger wire model.
pkg/eventlog
Package eventlog implements the durable single-writer journal.
Package eventlog implements the durable single-writer journal.
pkg/evidence
Package evidence creates and verifies self-contained M0 review bundles.
Package evidence creates and verifies self-contained M0 review bundles.
pkg/fault
Package fault defines the Messenger's typed failures and what a caller may do about them.
Package fault defines the Messenger's typed failures and what a caller may do about them.
pkg/firewall
Package firewall is the upper half of the context firewall.
Package firewall is the upper half of the context firewall.
pkg/group
Package group contains the refutation floor and application-side TOS-MLS candidate adapter.
Package group contains the refutation floor and application-side TOS-MLS candidate adapter.
pkg/group/conformance
Package conformance refutes candidate group-key-agreement schemes.
Package conformance refutes candidate group-key-agreement schemes.
pkg/identity
Package identity implements the Messaging Endpoint delegation document.
Package identity implements the Messaging Endpoint delegation document.
pkg/intentcarrier
Package intentcarrier implements the Messenger public-channel carrier profile.
Package intentcarrier implements the Messenger public-channel carrier profile.
pkg/labgroup
Package labgroup provides a local-only group-chat carrier for integration testing.
Package labgroup provides a local-only group-chat carrier for integration testing.
pkg/localapi
Package localapi is the owner-private boundary between the Messenger daemon and the Agent runtime that uses it.
Package localapi is the owner-private boundary between the Messenger daemon and the Agent runtime that uses it.
pkg/mailbox
Package mailbox implements the route-independent Mailbox Relay contract.
Package mailbox implements the route-independent Mailbox Relay contract.
pkg/mailboxapi
Package mailboxapi is the bounded, transport-neutral service protocol for an authenticated Mailbox store.
Package mailboxapi is the bounded, transport-neutral service protocol for an authenticated Mailbox store.
pkg/mlslab
Package mlslab provides a local acceptance boundary between OpenFox and an untrusted group delivery service.
Package mlslab provides a local acceptance boundary between OpenFox and an untrusted group delivery service.
pkg/ownercontrol
Package ownercontrol provides the transport-neutral, deduplicated command sink for Trusted Capability and Owner Control V1.
Package ownercontrol provides the transport-neutral, deduplicated command sink for Trusted Capability and Owner Control V1.
pkg/payload
Package payload gives every event kind a typed body.
Package payload gives every event kind a typed body.
pkg/prekeyapi
Package prekeyapi exposes the public-only device contribution boundary.
Package prekeyapi exposes the public-only device contribution boundary.
pkg/probe
Package probe implements the M0-R measurement transport.
Package probe implements the M0-R measurement transport.
pkg/publicationops
Package publicationops assembles the operator-owned resources used to publish public Messenger prekey generations.
Package publicationops assembles the operator-owned resources used to publish public Messenger prekey generations.
pkg/publicchannel
Package publicchannel defines the route-neutral authority, signed-event and convergent-history core for public Agent channels.
Package publicchannel defines the route-neutral authority, signed-event and convergent-history core for public Agent channels.
pkg/reachability
Package reachability implements the M0-R reachability study record format.
Package reachability implements the M0-R reachability study record format.
pkg/relayframe
Package relayframe is the binary codec of Messenger relay carriage: the padded frame that rides as the payload of one signed Agent Packet, the objects it carries (a device copy, an Endpoint-signed delivery ack, an evidence pull), and the locator-free relay identity evidence every frame repeats.
Package relayframe is the binary codec of Messenger relay carriage: the padded frame that rides as the payload of one signed Agent Packet, the objects it carries (a device copy, an Endpoint-signed delivery ack, an evidence pull), and the locator-free relay identity evidence every frame repeats.
pkg/room
Package room is the membership state machine for a private group.
Package room is the membership state machine for a private group.
pkg/signerapi
Package signerapi implements the narrow local client used to keep the delegated Endpoint private key outside the Messenger daemon.
Package signerapi implements the narrow local client used to keep the delegated Endpoint private key outside the Messenger daemon.
pkg/tosaddr
Package tosaddr recomputes TOS account addresses using the registry's own addressing rules.
Package tosaddr recomputes TOS account addresses using the registry's own addressing rules.
protocol
cmd/agent-commerce-carrier-campaign command
Command agent-commerce-carrier-campaign drives the released HTTP Carrier contract without importing either Carrier implementation.
Command agent-commerce-carrier-campaign drives the released HTTP Carrier contract without importing either Carrier implementation.
cmd/agent-guarantor-fixtures command
Command agent-guarantor-fixtures emits the released Guarantor V1 dispatch registries and canonical digests for independent implementations.
Command agent-guarantor-fixtures emits the released Guarantor V1 dispatch registries and canonical digests for independent implementations.
cmd/agent-guarantor-schema command
Command agent-guarantor-schema emits the structural JSON Schema for every released Guarantor V1 object and mutation request.
Command agent-guarantor-schema emits the structural JSON Schema for every released Guarantor V1 object and mutation request.
cmd/agentcommerce-registry command
Command agentcommerce-registry emits the released semantic-action registry in stable JSON for cross-implementation conformance checks.
Command agentcommerce-registry emits the released semantic-action registry in stable JSON for cross-implementation conformance checks.
cmd/mcp-buyer-e2e-client command
Command mcp-buyer-e2e-client is the MCP client of the MCP buyer adapter's end-to-end harness (protocol/e2e/mcp-buyer).
Command mcp-buyer-e2e-client is the MCP client of the MCP buyer adapter's end-to-end harness (protocol/e2e/mcp-buyer).
cmd/native-gate-c-check command
Command native-gate-c-check resolves deployed Native Registry objects through the production quorum and typed-state decoder.
Command native-gate-c-check resolves deployed Native Registry objects through the production quorum and typed-state decoder.
cmd/native-vector-reference command
Command native-vector-reference reproduces frozen registration values using the independent conformance encoder.
Command native-vector-reference reproduces frozen registration values using the independent conformance encoder.
cmd/prediction-market-fixtures command
Command prediction-market-fixtures emits deterministic cross-language PredictionMarket V1 cell, digest, signature, and rejection vectors.
Command prediction-market-fixtures emits deterministic cross-language PredictionMarket V1 cell, digest, signature, and rejection vectors.
cmd/service-actor-e2e-fixture command
Command service-actor-e2e-fixture prepares the provider-side inputs of the local Service Actor buyer acceptance run: the canonical software-work manifest naming the actor in key 21, the NSM1 metadata hash the actor must carry, a code hash of a code BOC, a Quote Proposal package built by pkg/quoteprovider from finalized chain state, and the attestor's check of a software-work Receipt before it signs the response.
Command service-actor-e2e-fixture prepares the provider-side inputs of the local Service Actor buyer acceptance run: the canonical software-work manifest naming the actor in key 21, the NSM1 metadata hash the actor must carry, a code hash of a code BOC, a Quote Proposal package built by pkg/quoteprovider from finalized chain state, and the attestor's check of a software-work Receipt before it signs the response.
cmd/tos-service-buyer command
Command tos-service-buyer discovers, verifies and calls Service Actors from quorum-finalized TOS state, and queries the derived request index.
Command tos-service-buyer discovers, verifies and calls Service Actors from quorum-finalized TOS state, and queries the derived request index.
cmd/tos-service-buyer-mcp command
Command tos-service-buyer-mcp is the stdio MCP server of the MCP buyer adapter (spec/docs/MCP_BUYER_ADAPTER_V1.md).
Command tos-service-buyer-mcp is the stdio MCP server of the MCP buyer adapter (spec/docs/MCP_BUYER_ADAPTER_V1.md).
cmd/tos-service-discovery command
Command tos-service-discovery uses only the public derived Capability API.
Command tos-service-discovery uses only the public derived Capability API.
cmd/tos-service-packet-relay command
Command tos-service-packet-relay runs an Agent Packet Relay V1 mailbox: a bounded store of end-to-end-encrypted envelopes.
Command tos-service-packet-relay runs an Agent Packet Relay V1 mailbox: a bounded store of end-to-end-encrypted envelopes.
cmd/tos-service-provider-publish command
Command tos-service-provider-publish turns a reviewed provider Capability action into finalized Native state and then publishes its immutable manifest to the derived Gateway catalog.
Command tos-service-provider-publish turns a reviewed provider Capability action into finalized Native state and then publishes its immutable manifest to the derived Gateway catalog.
cmd/tos-service-rpc command
Command tos-service-rpc runs the private tos_service_v1 chain boundary.
Command tos-service-rpc runs the private tos_service_v1 chain boundary.
cmd/tos-service-verify command
Command tos-service-verify is the third-party verifier of one Service Actor purchase.
Command tos-service-verify is the third-party verifier of one Service Actor purchase.
cmd/tos-service-wallet command
Command tos-service-wallet reviews and signs tos_service_v1 action JSON.
Command tos-service-wallet reviews and signs tos_service_v1 action JSON.
e2e/mcp-buyer-pilot/rendergolden command
Command rendergolden prints the confirmer's screen for one presentation, read as JSON from standard input, with the default sensitive-name patterns.
Command rendergolden prints the confirmer's screen for one presentation, read as JSON from standard input, with the default sensitive-name patterns.
internal/actionauthorityvector
Package actionauthorityvector reads the shared Action Authority signature vector: Pure ML-DSA-44 signatures under TOS-ACTION-AUTHORITY-V1 made by the tosctl test from a fixed public seed with the deterministic FIPS 204 variant.
Package actionauthorityvector reads the shared Action Authority signature vector: Pure ML-DSA-44 signatures under TOS-ACTION-AUTHORITY-V1 made by the tosctl test from a fixed public seed with the deterministic FIPS 204 variant.
internal/jsonstrict
Package jsonstrict rejects ambiguous JSON before typed decoding.
Package jsonstrict rejects ambiguous JSON before typed decoding.
internal/purchasefixture
Package purchasefixture builds one complete synthetic Service Actor purchase for tests: a Capability and its owner Agent, an actor, a Quote package, the call, a Receipt and its artifact, and a fake finalized session that serves them in any of the request's outcomes.
Package purchasefixture builds one complete synthetic Service Actor purchase for tests: a Capability and its owner Agent, an actor, a Quote package, the call, a Receipt and its artifact, and a fake finalized session that serves them in any of the request's outcomes.
internal/referencecodec
Package referencecodec is an independent tos_service_v1 registration encoder used only for conformance.
Package referencecodec is an independent tos_service_v1 registration encoder used only for conformance.
internal/servicefixture
Package servicefixture builds shape-valid Service Actor rail inputs for tests.
Package servicefixture builds shape-valid Service Actor rail inputs for tests.
pkg/agentcommerce
Package agentcommerce implements the business-neutral objects shared by Intent discovery, Agreement authorization, execution, and settlement.
Package agentcommerce implements the business-neutral objects shared by Intent discovery, Agreement authorization, execution, and settlement.
pkg/agentgift
Package agentgift defines the canonical, private direct-message objects for OpenFox Agent Gifts.
Package agentgift defines the canonical, private direct-message objects for OpenFox Agent Gifts.
pkg/agentguarantor
Package agentguarantor implements the bounded, Carrier-neutral Agent Guarantor Service V1 profile.
Package agentguarantor implements the bounded, Carrier-neutral Agent Guarantor Service V1 profile.
pkg/agentpacket
Package agentpacket defines an off-chain, chain-authenticated Agent packet.
Package agentpacket defines an off-chain, chain-authenticated Agent packet.
pkg/agentpacketrelay
Package agentpacketrelay is the Agent Packet Relay V1 mailbox: an HTTP service that stores end-to-end-encrypted envelopes for recipient Agents, and the client a sender or recipient uses to reach it.
Package agentpacketrelay is the Agent Packet Relay V1 mailbox: an HTTP service that stores end-to-end-encrypted envelopes for recipient Agents, and the client a sender or recipient uses to reach it.
pkg/agentpacketseal
Package agentpacketseal is the reference codec of Agent Packet Relay V1: it seals one exact signed Agent Packet V1 JSON to a recipient Agent's encryption key with RFC 9180 HPKE, and opens it again.
Package agentpacketseal is the reference codec of Agent Packet Relay V1: it seals one exact signed Agent Packet V1 JSON to a recipient Agent's encryption key with RFC 9180 HPKE, and opens it again.
pkg/agentpacketseal/keycardtest
Package keycardtest builds signed encryption key card packets for tests.
Package keycardtest builds signed encryption key card packets for tests.
pkg/agentrelay
Package agentrelay defines the business-neutral service profile used by an Agent that sponsors gas, relays an exact client-signed transaction, or does both.
Package agentrelay defines the business-neutral service profile used by an Agent that sponsors gas, relays an exact client-signed transaction, or does both.
pkg/buyeragent
Package buyeragent is the custody-side core of the MCP buyer adapter (spec/docs/MCP_BUYER_ADAPTER_V1.md): the agent that holds the call journal, re-validates every request a client sends, and confirms a payment only on a human decision taken from the custody account.
Package buyeragent is the custody-side core of the MCP buyer adapter (spec/docs/MCP_BUYER_ADAPTER_V1.md): the agent that holds the call journal, re-validates every request a client sends, and confirms a payment only on a human decision taken from the custody account.
pkg/buyerconfirm
Package buyerconfirm is the confirmer of the MCP buyer adapter (spec/docs/MCP_BUYER_ADAPTER_V1.md section 5): the program a human runs as the custody account, on a terminal no developer-account process touches, to read a prepared purchase and type its confirmation code.
Package buyerconfirm is the confirmer of the MCP buyer adapter (spec/docs/MCP_BUYER_ADAPTER_V1.md section 5): the program a human runs as the custody account, on a terminal no developer-account process touches, to read a prepared purchase and type its confirmation code.
pkg/buyerinit
Package buyerinit is `tos-service-buyer init`: it creates the buyer's identity on the TOS chain through the pinned tosctl, in a plan step that sends nothing and an apply step that journals and resumes every chain message (MCP_BUYER_ADAPTER_V1 section 3.2).
Package buyerinit is `tos-service-buyer init`: it creates the buyer's identity on the TOS chain through the pinned tosctl, in a plan step that sends nothing and an apply step that journals and resumes every chain message (MCP_BUYER_ADAPTER_V1 section 3.2).
pkg/buyersdk
Package buyersdk discovers, verifies and calls Service Actors from quorum-finalized state.
Package buyersdk discovers, verifies and calls Service Actors from quorum-finalized state.
pkg/capabilitycatalog
Package capabilitycatalog maintains a derived, incomplete discovery set of Capability IDs and immutable software-work manifests.
Package capabilitycatalog maintains a derived, incomplete discovery set of Capability IDs and immutable software-work manifests.
pkg/chain
Package chain contains the stable, bounded boundary to TOS JSON-RPC.
Package chain contains the stable, bounded boundary to TOS JSON-RPC.
pkg/codec
Package codec implements the canonical signed representation for TOS service protocol values.
Package codec implements the canonical signed representation for TOS service protocol values.
pkg/dnsalias
Package dnsalias verifies the narrow .tos -> Native object alias boundary.
Package dnsalias verifies the narrow .tos -> Native object alias boundary.
pkg/gatewaydiscovery
Package gatewaydiscovery validates the authority-neutral TOS Service Gateway locator.
Package gatewaydiscovery validates the authority-neutral TOS Service Gateway locator.
pkg/gatewayfederation
Package gatewayfederation combines authority-neutral discovery responses from independent Gateways.
Package gatewayfederation combines authority-neutral discovery responses from independent Gateways.
pkg/mcpbuyer
Package mcpbuyer is the stdio MCP server of the MCP buyer adapter (spec/docs/MCP_BUYER_ADAPTER_V1.md sections 2 and 4).
Package mcpbuyer is the stdio MCP server of the MCP buyer adapter (spec/docs/MCP_BUYER_ADAPTER_V1.md sections 2 and 4).
pkg/mldsa44
Package mldsa44 is the ML-DSA-44 (FIPS 204) boundary of tos_service_v1.
Package mldsa44 is the ML-DSA-44 (FIPS 204) boundary of tos_service_v1.
pkg/mldsa44/mldsa44test
Package mldsa44test provides test support for the ML-DSA-44 boundary: the real tosctl helper taken from the environment, a private tosctl vault with named controllers, and Fake, an in-process stand-in for pure-logic tests.
Package mldsa44test provides test support for the ML-DSA-44 boundary: the real tosctl helper taken from the environment, a private tosctl vault with named controllers, and Fake, an in-process stand-in for pure-logic tests.
pkg/nativeclient
Package nativeclient provides the public, authority-neutral Connect client used by Native SDKs.
Package nativeclient provides the public, authority-neutral Connect client used by Native SDKs.
pkg/nativecore
Package nativecore implements the single-mode tos_service_v1 execution envelope.
Package nativecore implements the single-mode tos_service_v1 execution envelope.
pkg/nativewallet
Package nativewallet provides local, review-before-signing support for tos_service_v1 actions.
Package nativewallet provides local, review-before-signing support for tos_service_v1 actions.
pkg/predictionmarket
Package predictionmarket implements the canonical off-chain objects and deterministic arithmetic shared by TOS PredictionMarket V1 clients.
Package predictionmarket implements the canonical off-chain objects and deterministic arithmetic shared by TOS PredictionMarket V1 clients.
pkg/providersdk
Package providersdk implements the first Gate E provider workflow over the canonical Native Submit/Resolve API.
Package providersdk implements the first Gate E provider workflow over the canonical Native Submit/Resolve API.
pkg/publicerrors
Package publicerrors defines the stable Connect error detail and automatic retry contract shared by public Native Gateways and clients.
Package publicerrors defines the stable Connect error detail and automatic retry contract shared by public Native Gateways and clients.
pkg/purchaseevidence
Package purchaseevidence verifies one Service Actor purchase from public inputs and quorum-finalized state, and defines the evidence bundle a buyer exports for that verification.
Package purchaseevidence verifies one Service Actor purchase from public inputs and quorum-finalized state, and defines the evidence bundle a buyer exports for that verification.
pkg/quoteexchange
Package quoteexchange validates portable, complete-preimage Quote Proposal packages.
Package quoteexchange validates portable, complete-preimage Quote Proposal packages.
pkg/quoteprovider
Package quoteprovider constructs non-canonical, complete-preimage Quote Proposal packages from the Capability state and the policy of the Service Actor that manifest key 21 names, both read at one finalized checkpoint.
Package quoteprovider constructs non-canonical, complete-preimage Quote Proposal packages from the Capability state and the policy of the Service Actor that manifest key 21 names, both read at one finalized checkpoint.
pkg/railwork
Package railwork implements the Service Actor rail work frames (spec/docs/SERVICE_ACTOR_RAIL_WORK_FRAMES_V1.md): the binary frame that carries one chunk of a rail message inside an Agent Packet, the canonical JSON messages a buyer and a provider exchange (task, result, result acknowledgement, result request), the values derived from them, and the receiver checks that bind them to the paid Service Actor request.
Package railwork implements the Service Actor rail work frames (spec/docs/SERVICE_ACTOR_RAIL_WORK_FRAMES_V1.md): the binary frame that carries one chunk of a rail message inside an Agent Packet, the canonical JSON messages a buyer and a provider exchange (task, result, result acknowledgement, result request), the values derived from them, and the receiver checks that bind them to the paid Service Actor request.
pkg/serviceactor
Package serviceactor implements the verification procedures that bind a Capability version to a Service Actor (SERVICE_ACTOR_SETTLEMENT_DESIGN section 2.4): the common binding steps 1-4, admission-time steps 5-8 before a call, and existing-request steps 5-9 from the finalized call transaction and its request snapshot.
Package serviceactor implements the verification procedures that bind a Capability version to a Service Actor (SERVICE_ACTOR_SETTLEMENT_DESIGN section 2.4): the common binding steps 1-4, admission-time steps 5-8 before a call, and existing-request steps 5-9 from the finalized call transaction and its request snapshot.
pkg/serviceactorindex
Package serviceactorindex is a rebuildable, derived index of Service Actor requests and a discovery query over Capability offers settled by Service Actors.
Package serviceactorindex is a rebuildable, derived index of Service Actor requests and a discovery query over Capability offers settled by Service Actors.
pkg/servicerpc
Package servicerpc exposes the private Native-only Connect boundary.
Package servicerpc exposes the private Native-only Connect boundary.
pkg/toschain
Package toschain implements finalized, quorum-backed Native Registry reads.
Package toschain implements finalized, quorum-backed Native Registry reads.
pkg/trustedcapability
Package trustedcapability implements the portable wire objects for the Trusted Capability and Owner Control V1 profile.
Package trustedcapability implements the portable wire objects for the Trusted Capability and Owner Control V1 profile.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL