Skip to content

v1.4.0 - Agent Identity v1

Choose a tag to compare

View all tags
@blackms blackms released this 27 Jan 11:02
· 83 commits to main since this release
v1.4.0
6e82cfb

Agent Identity v1

This release introduces Agent Identity as a first-class concept, enabling agents to exist as persistent entities with stable identifiers, lifecycle management, and owned memory across executions.

Key Features

Persistent Identity Model

  • Stable agent_id (UUID) that persists across executions
  • Lifecycle states: created → active → dormant → retired (no hard deletes)
  • Agent capabilities and metadata storage
  • Full audit trail for all identity lifecycle events

Agent-Scoped Memory

  • Memory namespaces owned by agents with agentId parameter
  • includeShared option to access shared memory
  • Memory isolation between agents

REST API

New endpoints at /api/v1/identities:

  • Create, list, get, update identities
  • Lifecycle operations: activate, deactivate, retire
  • Audit trail retrieval

MCP Tools

8 new tools for identity management:

  • identity_create, identity_get, identity_list, identity_update
  • identity_activate, identity_deactivate, identity_retire, identity_audit

Spawner Integration

  • identityId option to spawn with existing identity
  • createIdentity option for ephemeral identities
  • Stopping an agent transitions its identity to dormant

Example Usage

# Create identity via REST
curl -X POST /api/v1/identities \
  -d '{"agentType":"coder","displayName":"main-coder"}'

# Spawn agent with identity
curl -X POST /api/v1/agents \
  -d '{"type":"coder","identityId":"<uuid>"}'

# Store agent-scoped memory
aistack memory store -k learning -c "I learned X" --agent-id <uuid>

Test Coverage

  • 7 new test files with 90%+ coverage on identity code
  • All 1728 tests passing

Full Changelog: v1.3.1...v1.4.0

Assets 2
Loading