aevatar-agent-profile-management

Aevatar Agent Profile management

An Agent Profile answers "who is this agent, and what may it do?" — display name, purpose, instructions, an ordered set of exact Ornn skill bindings, and the maximum tool authority any turn under that profile may hold.

It is an independent resource surface. It is not another phase of the studio lifecycle:

build & operate :  scope → team → member (workflow|script|gagent) → service → schedule
Agent Profile   :  ownerHandle/profileSlug → opaque profileId → draft → published snapshot

profileId, workflowId, memberId, publishedServiceId, and a conversation actor id are five different identities. No prefix, string match, or lifecycle story converts one into another. Creating or publishing a Profile creates no workflow, member, team, service, schedule, or conversation binding.

Step 0 — Detect the capability. Do this before anything else.

The Profile contract is a deployment-gated capability. It ships in the Aevatar codebase but a given deployment may not expose it. A 404 on a profile resource is not a deployment probe — probe the surface itself, and stop honestly when it is absent.

In-session tool mode. Use the Profile path only if the exact tool agent_profiles is present in your current tool list. Never infer it from another aevatar_* tool, from Ornn access, from the system prompt, or from this skill being loaded.

Client REST mode. Read the live document and require the complete route family:

nyxid proxy request aevatar "api/openapi.json" \
  | jq -r '.paths|keys[]|select(test("agent-profiles"))'

POST   /api/scopes/{scopeId}/agent-profiles
GET    /api/scopes/{scopeId}/agent-profiles/{profileSlug}
PUT    /api/scopes/{scopeId}/agent-profiles/{profileSlug}/draft
PUT    /api/scopes/{scopeId}/agent-profiles/{profileSlug}/draft/skills/{bindingId}
DELETE /api/scopes/{scopeId}/agent-profiles/{profileSlug}/draft/skills/{bindingId}
POST   /api/scopes/{scopeId}/agent-profiles/{profileSlug}:validate
POST   /api/scopes/{scopeId}/agent-profiles/{profileSlug}:publish
GET    /api/agent-profiles/{ownerHandle}/{profileSlug}