跳到主要內容

AFS

Providers

Understand AFS providers as capability-owning modules that expose resources through paths.

An AFS provider is an AFSModule that supplies resources and operations behind paths. It is the unit that decides which operations exist, how paths resolve, and how a backing system is reached.

Role in routing

StepWho owns it
Path string in the instance namespaceCaller
Mount path → provider instanceRuntime / configuration
Operation implementation and enforcementProvider
Backing store or network transportProvider

Without a mount that maps a path prefix to a provider, the path is not a product feature—it is an unresolved address. See the routing diagram on Overview.

What a provider must make explicit

Provider documentation (or acceptance records) should state:

TopicWhy it matters
Owned path shapeHow callers form stable paths
Declared operations and featuresWhat is in contract vs optional
Access mode / auth / network-read policyWho may read or mutate
Search and query behaviorSeparate contracts; see Search and query
Failure codes and side effectsWhat callers can branch on
Support ownershipWho maintains it

Source inventory is not a catalog

The current ARC repository groups provider packages under areas such as core, basic, AI, messaging, platform, runtime, cost, IoT, and test. That inventory is implementation evidence. A package directory does not by itself become a stable public integration.

This board therefore:

Runtime modules you may already see

On a local daemon, arc afs ls / and mount list show this instance's mounts—not the full source inventory. Examples observed on one beta.28 host (not a support matrix): fs:// project and memory trees, web-device://, vault://, agent code mounts, and others. Treat them as environment-specific until a catalog entry with evidence exists.