# openalice-agent-basic

> Thin, embed-agnostic agent core — the reusable perceive→reason→act loop over openalice-agent-protocol, shared by Persona/World/Live/Social. Extraction TARGET from openalice-agent-lite (embed-specifics — brand RAG, visitor memory, quota, billing, tenants config — stay in agent-lite). M1 scaffold = the AgentCore trait surface + the net-new perception→observation bridge (visual_/spatial_perception → one LLM line, the way voice_utterance becomes a user line). Real ReAct-loop extraction is lab-gated M2/M3.

## At a glance
| field | value |
|---|---|
| kind | `service` |
| priority | `—` |
| default branch | `mvp` |
| last activity | 2026-06-02T09:08:48+00:00 |
| features catalogued | **3** |
| runtime deps declared | **1** |

## Manifest
`.atlas-deps.yml` — parsed cleanly: **yes**

### Runtime deps
- **`openalice-agent-protocol-rs`** · `other` · via `cargo` — ConnectorEvent / ToolCall + visual_/spatial_perception (v0.2) — the AgentCore loop is built on the wire contract.

### Exposes
- `cargo_crate` — openalice-agent-basic

## Features (3)

### agent-basic/core
- **`agent-basic.core.agent-core`** — `AgentCore` — the reusable perceive→reason→act contract. One impl per runtime (agent-lite canonical; persona/world reuse it). Product state (memory, quota, brand, billing) is intentionally NOT in the core; it lives in the product runtime and is reached only through tool handlers.  
  *src/core.rs:9*
- **`agent-basic.core.crate`** — Embed-agnostic agent core extracted from agent-lite: the `AgentCore` perceive→reason→act contract + the perception→observation bridge, agent-protocol-native, so one runtime serves every OpenAlice product.  
  *src/lib.rs:20*

### agent-basic/perception
- **`agent-basic.perception.observe`** — Maps visual_/spatial_perception ConnectorEvents to a single LLM-ready observation line; returns None for non-perception events so callers keep their existing chat/voice paths untouched.  
  *src/perception.rs:11*

---

*Generated by [openalice-atlas](https://atlas.blal.pro) — single source of truth for the openalicelabs ecosystem.*
