Skip to content

Commit ca21ea4

Browse files
docs: update sparse kernel repo positioning
1 parent 07b09af commit ca21ea4

1 file changed

Lines changed: 11 additions & 2 deletions

File tree

README.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ It is built for personal and small-machine deployments where hundreds of agents
2525
- Brokers expensive resources by trust zone: browser contexts, sandbox allocations, filesystem access, tool invocation, and artifact reads/writes.
2626
- Keeps large outputs out of SQLite by placing screenshots, traces, downloads, exported transcripts, and other blobs in a content-addressed artifact store.
2727
- Enforces capability checks around sensitive operations and records allow, deny, grant, revoke, and broker events for auditability.
28+
- Defines an Agent Factory boundary for observing workflows, generating agent specs, compiling policy, and handing deployment plans to Sparse Kernel for safe execution.
2829
- Provides a Rust core, a local CLI/daemon, and a small TypeScript client surface for adapters.
2930

3031
## Why Sparse Execution
@@ -43,15 +44,23 @@ The goal is to make local multi-agent systems practical on ordinary machines, in
4344

4445
- `crates/sparsekernel-core`: Rust ledger, artifact store, task leases, capabilities, audit records, and mock broker primitives.
4546
- `crates/sparsekernel-cli`: `sparsekernel` CLI and `sparsekerneld` local daemon.
46-
- `crates/sparsekernel-core/migrations/0001_initial.sql`: initial SQLite runtime schema.
47+
- `crates/sparsekernel-core/migrations/`: SQLite runtime schema migrations.
48+
- `packages/agent-factory`: TypeScript contracts for workflow observations, candidate workflows, agent specs, policy compilation, and deployment plans.
49+
- `packages/agent-factory-connectors`: connector adapter contracts for Gmail, CRM, calendar, accounting, and ticketing discovery surfaces.
4750
- `packages/browser-broker`: TypeScript CDP browser broker for materialized browser-context leases and artifactized screenshots/downloads.
4851
- `packages/openclaw-sparsekernel-adapter`: TypeScript adapter that wraps OpenClaw-shaped tools in Sparse Kernel session, capability, tool-call, and artifact lifecycle calls.
4952
- `packages/sparsekernel-client`: TypeScript client for the daemon HTTP surface.
50-
- `schemas/`: API and event schema definitions.
53+
- `schemas/`: API, event, capability, and Agent Factory schema definitions.
5154
- `docs/architecture/`: architecture notes for the ledger, brokers, artifact store, trust zones, security boundaries, and small-VM resource model.
5255

5356
The Rust crates are workspace-internal for now (`publish = false`); run them from this repository until a crates.io release path exists.
5457

58+
## Agent Factory Boundary
59+
60+
Agent Factory decides what should exist. Sparse Kernel decides how it safely runs.
61+
62+
The factory contracts model workflow observations, candidate workflows, generated agent specs, compiled policy, approvals, evaluations, and deployment history. The factory does not allocate browser contexts, open sandboxes, invoke connector tools, or grant capabilities directly; it emits deployment plans that the Sparse Kernel ledger and brokers can approve, audit, and materialize.
63+
5564
## Quick Start
5665

5766
Runtime requirements:

0 commit comments

Comments
 (0)