diff --git a/README.md b/README.md index 214801f..13bdd13 100644 --- a/README.md +++ b/README.md @@ -146,13 +146,9 @@ For the deeper technical reasoning: ## Configuration -| Property | Type | Required | Default | Description | -| --- | --- | --- | --- | --- | -| `apiKey` | string | Yes | — | Your Contexto API key | -| `contextEnabled` | boolean | No | `true` | Enable or disable context injection | -| `maxContextChars` | number | No | — | Max characters for injected context | -| `compactThreshold` | number (0-1) | No | `0.50` | Ingest and evict at this share of token budget | -| `compactionStrategy` | `'sliding-window' \| 'default'` | No | `'default'` | Compaction strategy | +| Property | Type | Required | Description | +| --- | --- | --- | --- | +| `apiKey` | string | Yes | Your Contexto API key | ## Custom Backends diff --git a/packages/contexto/README.md b/packages/contexto/README.md index ca41547..a2762af 100644 --- a/packages/contexto/README.md +++ b/packages/contexto/README.md @@ -1,19 +1,13 @@ -

Contexto

-

Keep long-running OpenClaw agents reliable after the context window fills.

-

A drop-in OpenClaw context engine that retrieves old constraints instead of losing them to summaries.

- -

- Quick Start  •   - Why Contexto  •   - How It Works  •   - Website  •   - Discord -

- -

- OpenClaw works well until long sessions start compacting away the exact instruction that mattered.
- Contexto is the context engine built for that failure mode. -

+# Contexto + +**Keep long-running OpenClaw agents reliable after the context window fills.** + +A drop-in OpenClaw context engine that retrieves old constraints instead of losing them to summaries. + +[Quick Start](#quick-start) · [Why Contexto](#why-contexto) · [How It Works](#how-it-works) · [Website](https://getcontexto.com/) · [Discord](https://discord.gg/4QTRS5ew) + +OpenClaw works well until long sessions start compacting away the exact instruction that mattered. +Contexto is the context engine built for that failure mode. ## The Problem in 15 Seconds @@ -26,10 +20,6 @@ Do NOT delete anything." tools, retries, compaction ...] ``` - - - - - -
- **Without Contexto** ```text @@ -37,9 +27,6 @@ Turn 35: Agent deletes 12 flagged emails. The constraint was lost in compaction. ``` - - **With Contexto** ```text @@ -51,10 +38,6 @@ Retrieved context: The instruction survives compaction. ``` -
- ## Why Contexto Contexto is a context engine for OpenClaw. It is built for the exact moment OpenClaw starts dropping or blurring the context your agent still needs: @@ -109,10 +92,6 @@ If you are deciding whether this is worth installing, this is the short version. | **Can you explain what was retrieved?** | No | Yes, full path tracing (`travel -> Japan -> visa docs`) | | **Setup time** | Built-in | One plugin install, one config key | -

- Before and after Contexto: without Contexto the full session is pushed directly to the model, with Contexto the runtime sends scoped context through Contexto before it reaches the LLM. -

- ## How It Works Contexto turns aging conversation history into a searchable context tree instead of a lossy summary blob. @@ -139,51 +118,18 @@ For the deeper technical reasoning: ## Configuration -| Property | Type | Required | Default | Description | -| --- | --- | --- | --- | --- | -| `apiKey` | string | Yes | — | Your Contexto API key | -| `contextEnabled` | boolean | No | `true` | Enable or disable context injection | -| `maxContextChars` | number | No | — | Max characters for injected context | -| `compactThreshold` | number (0-1) | No | `0.50` | Ingest and evict at this share of token budget | -| `compactionStrategy` | `'sliding-window' \| 'default'` | No | `'default'` | Compaction strategy | - -## Custom Backends - -The engine talks to storage through `ContextoBackend`. The default remote backend calls `api.getcontexto.com`, but you can implement your own. - -```ts -interface ContextoBackend { - ingest(payload: WebhookPayload | WebhookPayload[]): Promise; - search( - query: string, - maxResults: number, - filter?: Record, - minScore?: number - ): Promise; -} -``` - -## Roadmap - -- [ ] Horizontal scaling with sub-agent context delegation -- [ ] Scoped context with access boundaries -- [ ] Knowledge from external documents -- [ ] Local backend -- [ ] Context sharing across agents +| Property | Type | Required | Description | +| --- | --- | --- | --- | +| `apiKey` | string | Yes | Your Contexto API key | ## Community - [Discord](https://discord.gg/4QTRS5ew) - [Discussions](https://github.com/ekailabs/contexto/discussions) - [Issues](https://github.com/ekailabs/contexto/issues) -- [Contributing guide](CONTRIBUTING.md) ## License -Apache 2.0. See [LICENSE](LICENSE). +Apache 2.0 --- - -

- If long-session reliability matters to you, star the repo and help other OpenClaw users discover it. -

diff --git a/packages/contexto/package.json b/packages/contexto/package.json index 48b9682..42c9ffc 100644 --- a/packages/contexto/package.json +++ b/packages/contexto/package.json @@ -1,7 +1,7 @@ { "name": "@ekai/contexto", - "version": "0.1.11", - "description": "Openclaw plugin for smart context management", + "version": "0.1.12", + "description": "Context Engine for Long-running OpenClaw agents", "type": "module", "license": "Apache-2.0", "publishConfig": {