capsule-identity README

The project's README from github.com/unicity-aos/capsule-identity. As one markdown file: README.md.

astrid-capsule-identity

License: MIT OR Apache-2.0 MSRV: 1.94

The identity and system prompt builder for Astrid OS.

In the OS model, this capsule is /etc/profile. It owns the agent's spark identity, persists it as capsule state, and assembles the identity plus environment context into a system prompt.

How it works

On a spark.v1.request.build event:

  1. Loads the persisted spark identity from capsule KV state.
  2. Auto-detects home://.config/spark.toml if KV state is empty.
  3. Adds environment context (working directory, platform).
  4. Publishes the assembled prompt on spark.v1.response.ready.

If no identity exists yet, the prompt includes onboarding instructions. After onboarding, the LLM calls save_identity, which saves the chosen callsign, class, aura, signal, and core directives to capsule state and writes home://.config/spark.toml as a recovery copy.

State is scoped by Astrid's capsule KV isolation for the calling principal. Session ID is echoed back for react loop correlation.

IPC protocol

Direction Topic
Subscribe spark.v1.request.build
Subscribe tool.v1.execute.save_identity
Subscribe tool.v1.request.describe
Subscribe cli.v1.command.execute
Publish spark.v1.response.ready
Publish tool.v1.execute.*.result
Publish tool.v1.response.describe.*
Publish agent.v1.response

Development

cargo build
cargo test

License

Dual-licensed under MIT and Apache 2.0.

Copyright (c) 2025-2026 Joshua J. Bouw and Unicity Labs.

capsule-identity (unicity-aos/capsule-identity)

Searching Database…

Что это такое?Это строитель системного промпта для капсулы Astrid OS (часть Unicity AOS). Он хранит идентичность агента «spark», объединяет её с контекстом рабочей области и окружения и собирает итоговый системный промпт, который получает LLM.
Это отдельное приложение или часть чего-то большего?Это капсула, то есть модульный IPC-сервис в архитектуре капсул Astrid OS. В README его сравнивают с /etc/profile в обычной ОС. Он работает только как компонент Astrid OS / Unicity AOS и сам по себе не запускается.
Как это запустить?Вручную его не запускают. Он активируется, когда Astrid OS отправляет событие spark.v1.request.build, затем загружает сохранённую идентичность из KV-состояния капсулы или автоматически находит её в home://.config/spark.toml.
Мне нужна Astrid OS, чтобы этим пользоваться?Да, он полностью зависит от KV-состояния капсулы и шины IPC pub/sub в Astrid OS. Он подписывается на такие темы, как spark.v1.request.build и tool.v1.execute.saveidentity, и самостоятельной среды выполнения не имеет.
Что происходит в первый раз, когда идентичность ещё не настроена?Если идентичность ещё не сохранена, собранный промпт включает инструкции по первоначальной настройке. Агент проводит пользователя через выбор позывного, класса, ауры, сигнала и базовых директив.
Какие поля идентичности сохраняются при первоначальной настройке?При первоначальной настройке LLM вызывает saveidentity, который сохраняет позывной, класс, ауру, сигнал и базовые директивы. Затем он записывает резервную копию в home://.config/spark.toml.
Как эта капсула взаимодействует с остальной Astrid OS?Исключительно через IPC pub/sub. Она слушает события вроде spark.v1.request.build и tool.v1.execute.saveidentity и публикует собранный промпт в spark.v1.response.ready.
Почему её сравнивают с /etc/profile?Как /etc/profile инициализирует сессию оболочки, так и эта капсула в начале каждой сессии инициализирует идентичность агента и контекст окружения. Она также возвращает ID сессии для сопоставления циклов.
Size
0.2 MB
Stars
8.4K
Age
7mo
Commits · 90 Days