Roadmap and known gaps
In shortWhat 10xGraph does not do yet, which surfaces are incomplete, and where dated release planning actually lives.
- 3 min read
- 5 sections
- Updated
- v1.0.0
- Markdown
This page is the honest inventory: things that are announced, half-built, or deliberately absent. It exists so you can tell whether 10xGraph fits your project before you find out the hard way.
Dated planning and prioritisation happen in the open on GitHub:
- Issues for tracked work
- Discussions for proposals
- Releases for what actually shipped
Nothing on this page is a delivery commitment. If a gap blocks you, say so in an issue: real demand reorders the list.
In 1.0
These ship in 1.0.
- Background jobs, worker and scheduler.
10xgraph worker,10xgraph scheduler, the/v1/tasksroutes and theworkerconfig key, on a TaskIQ broker. See Run background tasks with a worker. - Audit log and JSON logs. Metadata-only audit events (the
auditconfig block) andLOG_FORMAT=json. 10xGraph writes the lines to stdout and stores nothing; your log pipeline keeps them. See Audit log.
The control mapping lists what 10xGraph does and does not provide for SOC 2 and ISO 27001 audits. It is a docs page, not a product feature.
Not implemented yet
Per-tool permissions
Role-based tool allow-lists are planned, so a role can allow one tool and deny another from configuration.
Today: routes are guarded by role permissions (for example graph:invoke), and tools receive the verified identity in config and check access themselves, for example with can(). See authentication and authorization.
Agent-to-Agent (A2A) serving
The core package ships an optional a2a_sdk extra, but the API server does not
expose an A2A endpoint. The a2a routers were removed from the CLI package in a
recent release because they were commented out, never mounted, and shipping as
dead code in the wheel. They can be restored from git history when the surface is
actually built.
Today: agents talk to each other in-process through handoffs and supervisor or swarm topologies. Cross-process agent calls go over the normal REST API.
File attachments in the playground
The playground’s Files page is a placeholder marked “Soon”, and the paperclip button in the chat composer is inert.
Today: file upload works over the REST API and the TypeScript client. See send images and documents.
Server-owned schemas for client tools
registerToolHandler() stores a handler locally. Tools the browser can execute
must be declared under remote_tools in server 10xgraph.json.
Partial support
| Area | What works | What does not |
|---|---|---|
| Gemini explicit context caching | Caching through the provider directly | SummaryContextManager does not accept cached_content, and caching is not wired through CriterionConfig. See Google provider. |
| OpenAI evaluation judge | The judge calls call_llm normally |
Extra kwargs are not forwarded from the judge configuration. See OpenAI provider. |
ExactMatchCriterion |
Usable by constructing it directly | Not reachable through CriteriaConfig, which forbids unknown keys and has no exact_match field. |
| Light theme on this docs site | Readable and complete | Tuned less carefully than the dark theme, which is canonical. |
Deliberately out of scope
These are not gaps. They are decisions, and they are unlikely to change.
- No hosted control plane. 10xGraph is a library plus a server you run. There is no account, no telemetry phoning home, and no paid tier gating features.
- No LangChain dependency. Provider clients are implemented directly. That is why the dependency tree is small and why LangChain integrations do not drop in unchanged.
- No sandboxing of tools. Tools run with the privileges of the host process by design. Isolation is your deployment’s job. See the security policy.
- No prompt-injection guarantee. The framework gives you validators, per-tool authorization, and human-in-the-loop interrupts. It does not claim to make a language model safe to point at untrusted input.
Stability commitments
From 1.0 on, the public API does not break before 2.0. Anything that has to go is deprecated first, keeps working while deprecated, and is removed only in 2.0. Moved modules keep working at their old import path. See Stability and deprecation policy.