agent.json

{
  "type": "agent",
  "_note": "AgentSchema. Seeded from docs/audits/2026-06-agentschema-property-liveness.md. agent-runtime.ts is the runtime consumer; AgentPreview is display-only. ⚠ EVIDENCE LIVES IN CLOUD/EE: the `packages/services/service-ai/...` paths cited below are the closed `@objectstack/service-ai` runtime in the CLOUD repo, NOT git-tracked framework code (the framework's own service-ai tree is a stale build artifact with no src/). These props are `live` because that cloud runtime consumes them; the OPEN framework edition does not — see content/docs/ai for the open/cloud boundary.",
  "props": {
    "name": {
      "status": "live",
      "evidence": "packages/services/service-ai/src/agent-runtime.ts"
    },
    "surface": {
      "status": "live",
      "evidence": "packages/services/service-ai/src/agent-runtime.ts (resolveActiveSkills)",
      "note": "ADR-0063 §1 — the product surface this agent binds ('ask'|'build'). resolveActiveSkills enforces that only surface-compatible skills (matching, or 'both') attach; tool scoping is derived from that bundle."
    },
    "label": {
      "status": "live",
      "note": "display/core."
    },
    "avatar": {
      "status": "live",
      "note": "display."
    },
    "role": {
      "status": "live",
      "evidence": "packages/services/service-ai/src/agent-runtime.ts",
      "note": "persona → system prompt."
    },
    "instructions": {
      "status": "live",
      "evidence": "packages/services/service-ai/src/agent-runtime.ts",
      "note": "system prompt."
    },
    "model": {
      "status": "live",
      "evidence": "packages/services/service-ai/src/agent-runtime.ts:264",
      "note": "PARTIAL — model/temperature/maxTokens applied; model.provider + topP DEAD."
    },
    "skills": {
      "status": "live",
      "evidence": "packages/services/service-ai/src/agent-runtime.ts",
      "note": "Agent→Skill→Tool."
    },
    "tools": {
      "status": "live",
      "evidence": "packages/services/service-ai/src/agent-runtime.ts",
      "note": "legacy direct-tool fallback."
    },
    "active": {
      "status": "live",
      "evidence": "packages/services/service-ai/src/agent-runtime.ts",
      "note": "gates listing + 403 on chat."
    },
    "planning": {
      "status": "live",
      "evidence": "packages/services/service-ai/src/agent-runtime.ts",
      "note": "Only planning.maxIterations remains; the dead strategy/allowReplan knobs were removed in 16.0 (#2377)."
    },
    "access": {
      "status": "live",
      "evidence": "packages/services/service-ai/src/routes/agent-access.ts:50",
      "note": "evaluateAgentAccess() — allow-list by userId/role; enforced at the chat route (agent-routes.ts:151). #1884 (landed after the 2026-06 audit, which still listed it dead)."
    },
    "permissions": {
      "status": "live",
      "evidence": "packages/services/service-ai/src/routes/agent-access.ts:50",
      "note": "evaluateAgentAccess() — caller must hold ALL required permissions/roles; enforced at the chat route. #1884."
    },
    "knowledge": {
      "status": "live",
      "evidence": "objectui: packages/app-shell/src/views/metadata-admin/previews/AgentPreview.tsx:69 (d.knowledge; KnowledgeSummary renders sources/indexes)",
      "note": "LIVE via objectui metadata-admin authoring UI — the 2026-06 audit missed objectui; verified by reading the file."
    },
    "lifecycle": {
      "status": "experimental",
      "evidence": "no runtime reader (StateMachine)",
      "note": "aspirational autonomy."
    },
    "memory": {
      "status": "experimental",
      "evidence": "no runtime reader",
      "note": "aspirational autonomy."
    },
    "guardrails": {
      "status": "experimental",
      "evidence": "no runtime reader",
      "note": "aspirational — real limits via quota service."
    },
    "structuredOutput": {
      "status": "experimental",
      "evidence": "no runtime reader",
      "note": "aspirational."
    }
  }
}