Skip to content

Capability evolution wave: descriptor v2, tools, and memory plane#95

Open
mostlydev wants to merge 18 commits intomasterfrom
feat/capability-evolution-wave
Open

Capability evolution wave: descriptor v2, tools, and memory plane#95
mostlydev wants to merge 18 commits intomasterfrom
feat/capability-evolution-wave

Conversation

@mostlydev
Copy link
Copy Markdown
Owner

@mostlydev mostlydev commented Mar 31, 2026

Summary

  • Descriptor v2: Extends claw.describe with tools[] and memory capabilities alongside existing feeds[], endpoints[], and skill. Version-gated validation ensures v1 descriptors remain unchanged.
  • Pod grammar: New tools: and memory: fields in x-claw blocks with pod-level defaults (tools-defaults:, memory-defaults:) and spread expansion support.
  • Compile-time manifests: claw up compiles per-agent tools.json and memory.json into the cllama context directory, following the same declare → compile → mediate pattern as feeds.
  • History read API: Scoped GET /history/{agent-id} endpoint in cllama with three-tier auth (admin, agent-own, service-principal). Pagination via after cursor and limit.
  • Memory runtime: Pre-turn recall (synchronous, 300ms default timeout, graceful degradation) and post-turn retain (async, best-effort) in the cllama proxy. Format-aware injection for both OpenAI and Anthropic request shapes.
  • History export CLI: claw history export <agent-id> for local ledger access.
  • ADR-020 refinements and ADR-021 (memory plane as compiled capability).

Still open

  • Tool mediation runtime (ADR-020 PR5)
  • Reference memory service and spike test
  • Indexed history replay for large ledgers
  • Structured memory operation telemetry
  • Forget/tombstone flow

Test plan

  • go test ./... passes (root repo)
  • go test ./... passes (cllama submodule)
  • go vet ./... clean
  • Spike test with a real memory service against the compiled manifests
  • Verify claw history export against a running pod with session history

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant