@undefineds.co/xpod 0.1.0-local.202602081751

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) [2025] [undefineds.co]
+
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/README.md

@@ -0,0 +1,146 @@
+# Xpod: The Agent OS
+
+**Xpod is the Semantic File System for AI Agents.**
+
+As explored in recent research (Manus, Claude Code, AGFS), the most effective interface for Agents is not a complex set of APIs, but a **File System**.
+
+Following the Unix philosophy of *"Everything is a file"*, Xpod abstracts the complex world into a unified resource hierarchy accessible via standard protocols (HTTP/Solid).
+
+This is achieved through **Pods** (Personal Online Data stores)—portable web containers that act like a **"USB Drive for your Agent"**. A Pod encapsulates an Agent's entire digital life: its identity, memory, and skills.
+
+**Xpod comes with a built-in Base Agent** that runs natively within this environment, ready to navigate, read, and execute Skills out of the box.
+
+## Installation
+
+Ensure you have [Node.js](https://nodejs.org/) and [Yarn](https://yarnpkg.com/) installed:
+
+```bash
+yarn install
+yarn build
+```
+
+
+## Single-File Build & Local npm Release
+
+- Build a single-file CLI entry (Node 22 target):
+  ```bash
+  yarn build:single
+  ```
+  Output: `dist/xpod.single.cjs` (also exposed as `xpod-single` in `bin`).
+
+- Create a local-tag npm publish (auto bumps to `-local.<timestamp>`):
+  ```bash
+  yarn publish:local
+  ```
+
+- Dry-run publish (no real upload, package.json auto-restored):
+  ```bash
+  yarn publish:local:dry
+  ```
+
+## Quick Start
+
+| Mode | Command | Description |
+| --- | --- | --- |
+| Local | `yarn local` | SQLite + local disk, no external dependencies |
+| Cloud | `yarn cloud` | PostgreSQL + MinIO + Redis, production ready |
+| Dev | `yarn dev` | Alias for local mode |
+
+Configure environment:
+```bash
+cp example.env .env.local     # For local/dev
+cp example.env .env.cloud     # For cloud/production
+```
+
+Visit [http://localhost:3000/](http://localhost:3000/) after startup.
+
+See [docs/deployment-modes.md](docs/deployment-modes.md) for detailed profile comparison and cloud-edge coordination.
+
+## Deployment Strategies
+
+Xpod supports two primary deployment models, functioning like a Personal OS or a Multi-User Mainframe:
+
+1.  **Self-Hosted (Personal OS)**: Run Xpod on your laptop (`yarn local`) or private server. You have exclusive control over the hardware and kernel. Ideal for personal agents and maximum privacy.
+2.  **Managed Hosting (Multi-User OS)**: Deploy Xpod as a shared server (`yarn cloud`) hosting thousands of Pods. Similar to a Unix mainframe with many users (`/home/alice`, `/home/bob`), Xpod strictly enforces isolation between Pods using WebIDs and ACLs. Users share infrastructure but retain ownership of their data and can migrate their Pods to other instances.
+
+## The "Everything is a Resource" Architecture
+
+Xpod **leverages** the **W3C Solid Protocol** to construct a comprehensive **Runtime Environment for Agents**:
+
+### 1. File System as Memory
+Instead of opaque bytes, Xpod's file system is **Semantic**.
+- **Memory vs Context**: The entire Pod is your **Memory** (Total Knowledge). When an Agent enters a folder (e.g., `/projects/xpod/`), that folder becomes its **Context**. Navigating the file system naturally switches the Agent's attention scope.
+- **Universal Context**: In traditional systems, data is locked in proprietary formats. In Xpod, all data (Emails, Tasks, Notes) is stored in **RDF**—a universal data model. This allows Agents to understand and link data from any source without custom parsers.
+- **Universal Interface**: One protocol to rule them all. Agents use standard HTTP methods (`GET`, `PUT`, `DELETE`) to access everything—Memory, Files, Skills, and I/O. This drastically simplifies Agent design, as they don't need to learn thousands of different APIs.
+- **Smarter Agents**: Because Context is universally understood and accessible via a single protocol, Agents have a holistic view of your life and can connect dots between different domains effortlessly, leading to unprecedented intelligence.
+
+### 2. Identity as Path (`/profile/card#me`)
+Identity is not a database row, but a **URI**.
+- **WebID**: Every Agent has a globally unique ID (e.g., `https://pod.xpod.io/agent-alice/profile#me`).
+- **Access Control (ACL)**: Permissions are managed like file system attributes (Read/Write/Control), but applied to web resources.
+
+### 3. Virtual Resources (Dynamic Context)
+Not all resources are static files. Xpod supports **Virtual Resources** where the path is a key to a dynamic strategy.
+- **Implicit Graphs as Folders**: A path like `/threads/{id}/` or `/-/search?q=Entity` may not exist on disk. instead, it dynamically aggregates related messages via graph or vector retrieval, presenting them as a folder.
+- **API as File**: External capabilities are mapped to paths. Reading `/weather/current` triggers an API call; writing to `/inbox/` triggers a message delivery pipeline.
+- **Benefit**: Agents interact with complex, dynamic systems using the same simple file operations (`GET`/`PUT`) used for static memory.
+
+### 4. Security as Attributes (`chmod`)
+Xpod implements a fine-grained permission model tailored for Agents.
+- **WAC/ACP**: Access Control Lists (ACLs) determine which Agent (WebID) can Read, Write, or Append to any resource.
+- **Trust Chains**: Agents can form groups and delegate permissions, enabling secure multi-agent collaboration.
+
+### 5. Terminal & Skills (`/bin/*`)
+Xpod provides the runtime interfaces for Agent execution and interaction.
+- **`/-/terminal`** (Roadmap): A resource-based console. Agents listen to `/agents/{id}/stdin` and write to `/agents/{id}/stdout`, enabling interaction purely through file operations.
+- **Skills (Composable Capabilities)**: Xpod is the ideal runtime for Skills, enabling them to be:
+    - **Composable**: Skills interact via the standardized file system. The output of one Agent (an RDF graph or file) is immediately available as input for another.
+    - **Portable**: Built on Web Standards (JS/WASM + Markdown), Skills run consistently across Local, Server, or Edge Xpod instances.
+    - **Efficient**: Xpod's RDF indexing allows Skills to retrieve precise facts without loading massive files into the Context Window.
+    - **Powerful**: Unlike cloud agents trapped in sandboxes, Xpod Skills have **Root Access** to your digital life. They can access your full history, local files, and private devices, acting as a true Digital Butler rather than just a Chatbot.
+
+### 6. Network & Federation (Cloud-Edge Architecture)
+Xpod introduces a robust distributed architecture on top of standard Solid protocols.
+- **Control Plane (The Cloud)**: The Xpod Server acts as a coordinator, providing DNS, TLS certificates, and Tunneling services. It ensures your Agent is discoverable and reachable from the global internet.
+- **Data Plane (The Edge)**: Your Local Xpod holds the actual data and runs the Agents. It connects to the Cloud for reachability but executes Skills locally, ensuring data never leaves your physical control.
+
+## Privacy & Compliance (GDPR)
+
+Xpod is designed for the post-GDPR world, where **Data Sovereignty** is paramount.
+
+- **Data Ownership**: Unlike SaaS platforms where data is locked in silos, Xpod stores data in **User-Owned Pods**. You physically possess your data (on your disk or your chosen server).
+- **Code Moves to Data**: Computation happens **locally** next to the data. This "Local-First" architecture minimizes data leakage and cross-border transfer risks.
+- **Granular Consent**: WAC/ACP Access Control Lists allow users to grant Agents access only to specific resources (e.g., "Read `/photos/` but not `/documents/`").
+- **Right to be Forgotten**: Deleting a resource in Xpod is a true physical deletion, ensuring compliance with erasure requests.
+
+## Roadmap
+
+- [x] DB-Based Identity Provider
+- [x] Fine-Grained Pod Capacity Management
+- [x] SPARQL 1.1 via LDP (sparql-update)
+- [x] Sidecar API: SPARQL (`/-/sparql`)
+- [x] Sidecar API: Vector (`/-/vector`)
+- [x] Cloud-Edge Cluster Architecture
+- [ ] Sidecar API: Chat Completions (`/-/chat/completions`)
+- [ ] Sidecar API: Responses (`/-/responses`)
+- [ ] Sidecar API: Terminal (`/-/terminal`)
+- [ ] Attribute-Based Access Control (ABAC)
+- [ ] Feature Store (Federated Learning)
+
+## Documentation
+
+- [docs/COMPONENTS.md](docs/COMPONENTS.md) - Components.js reference and configuration patterns
+- [docs/deployment-modes.md](docs/deployment-modes.md) - Deployment profiles (local, cloud)
+- [docs/admin-guide.md](docs/admin-guide.md) - Admin initialization, roles, and reserved names
+- [docs/edge-cluster-architecture.md](docs/edge-cluster-architecture.md) - Cloud-edge coordination and routing
+- [docs/sidecar-api.md](docs/sidecar-api.md) - Sidecar API pattern (`/-/{service}`)
+- [docs/sparql-support.md](docs/sparql-support.md) - SPARQL 1.1 support details
+- [docs/vector-api-server-guide.md](docs/vector-api-server-guide.md) - Vector search API guide
+
+## Contributing
+
+Contributions are welcome! Please read the [CONTRIBUTING.md](CONTRIBUTING.md) to understand how to contribute to the project.
+
+## License
+
+Xpod is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.

package/components/components.jsonld

@@ -0,0 +1,72 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "@type": "Module",
+  "requireName": "xpod",
+  "import": [
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/sparql/SubgraphQueryEngine.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/MigratableDataAccessor.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/dns/DnsProvider.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/edge/EdgeNodeCertificateProvisioner.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/edge/interfaces/EdgeNodeTunnelManager.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/quota/QuotaService.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/AppStaticAssetHandler.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/RepresentationPartialConvertingStore.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/accessors/MinioDataAccessor.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/accessors/QuadstoreSparqlDataAccessor.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/accessors/QuintStoreSparqlDataAccessor.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/accessors/MixDataAccessor.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/logging/ConfigurableLoggerFactory.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/SparqlUpdateResourceStore.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/SubgraphSparqlHttpHandler.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/quota/QuotaAdminHttpHandler.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/admin/EdgeNodeSignalHttpHandler.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/ClusterIngressRouter.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/ClusterWebSocketConfigurator.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/EdgeNodeDirectDebugHttpHandler.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/EdgeNodeProxyHttpHandler.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/SignalInterceptHttpHandler.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/RouterHttpHandler.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/RouterHttpRoute.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/TracingHandler.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/admin/EdgeNodeCertificateHttpHandler.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/terminal/TerminalHttpHandler.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/pods/ReservedSuffixIdentifierGenerator.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/identity/drizzle/DrizzleIndexedStorage.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/keyvalue/PostgresKeyValueStorage.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/keyvalue/RedisKeyValueStorage.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/quota/DefaultQuotaService.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/quota/DrizzleQuotaService.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/quota/NoopQuotaService.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/quota/PerAccountQuotaStrategy.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/dns/tencent/TencentDnsProvider.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/edge/EdgeNodeDnsCoordinator.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/edge/Dns01CertificateProvisioner.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/edge/EdgeNodeTunnelManager.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/edge/FrpTunnelManager.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/edge/EdgeNodeHealthProbeService.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/edge/EdgeNodeAgent.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/service/EdgeNodeCertificateService.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/edge/acme/AcmeCertificateManager.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/edge/EdgeNodeModeDetector.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/util/identifiers/ClusterIdentifierStrategy.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/quota/UsageTrackingStore.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/identity/CenterNodeRegistrationService.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/PodRoutingHttpHandler.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/accessors/TieredMinioDataAccessor.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/cluster/PodMigrationHttpHandler.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/service/PodMigrationService.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/identity/ReactAppViewHandler.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/quint/SqliteQuintStore.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/quint/PgQuintStore.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/quint/BaseQuintStore.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/vector/SqliteVectorStore.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/storage/vector/PostgresVectorStore.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/http/vector/VectorHttpHandler.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/embedding/ProviderRegistryImpl.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/embedding/EmbeddingServiceImpl.jsonld",
+    "npmd:@undefineds.co/xpod/^0.0.0/dist/embedding/CredentialReaderImpl.jsonld"
+  ]
+}