{
  "schema": "agent-buildprint/publication.v1",
  "publish": true,
  "fileExcludes": [],
  "slug": "personal-agent-chat",
  "title": "Personal Agent Chat",
  "creator": "Agent Buildprint",
  "category": "Mapped Project",
  "tier": "agent-grade",
  "status": "validated",
  "runtime": [
    "Mapper executable Buildprint",
    "Any backend",
    "Deterministic local proof first"
  ],
  "stack": [
    "Streaming chat",
    "Provider router",
    "Tools / Skills / MCP",
    "Memory and compaction",
    "Subagents",
    "Telemetry",
    "WebUI/API workbench"
  ],
  "iconKeys": [
    "typescript",
    "json",
    "md"
  ],
  "difficulty": "Advanced",
  "featured": true,
  "summary": "Mapper phase-flow packet for building a clean-room, self-hosted personal agent chatbot with streaming chat, provider routing, tools, skills, MCP, memory, subagents, telemetry, and WebUI/API workbench surfaces.",
  "plainDescription": "An executable Buildprint packet for implementing a local personal AI assistant through phase-flow artifacts, review contracts, and honest runtime evidence. It preserves the mapped Emperor Agent-inspired scope without claiming clone, live provider, real MCP, shell/browser/network, auth, billing, publishing, or hosted SaaS parity.",
  "promise": "A phase-flow Buildprint that lets a downstream agent implement a source-independent personal agent chatbot while keeping deterministic proof separate from live/external claims.",
  "whatYouGet": [
    "Canonical BUILDPRINT.md start file",
    "Setup gate with architecture, operating model, safety, and AGENTS.md plan",
    "Phase-flow orchestration contract",
    "Six implementation phases",
    "Evidence ledger schema for honest runtime proof",
    "Evaluation gates for provider, persistence, security, UI/API, and claim boundaries"
  ],
  "whatYouNeed": [
    "A local implementation workspace",
    "No provider keys for deterministic proof mode",
    "Provider keys only for optional live adapter smoke tests",
    "A persistence choice for memory/history/checkpoints",
    "Explicit approval for shell, browser, network, billing, publishing, or hosted deployment work"
  ],
  "architectureFlow": [
    "Chat workbench",
    "Session controller",
    "Context + memory",
    "Provider router",
    "Tools / skills / MCP",
    "Subagent team bus",
    "Telemetry + persistence"
  ],
  "includes": [
    "BUILDPRINT.md canonical entry",
    "01-questions.md setup questions",
    "02-project-setup.md architecture and operating contract",
    "blueprint.yaml machine contract",
    "03-phases/phase-index.yaml phase index",
    "03-phases/phase-flow.md orchestration protocol",
    "Phase files for storage, runtime, tools/MCP, memory/team/telemetry, safety, and WebUI/API",
    "04-evaluation.md evidence honesty gates",
    "05-evidence/evidence-ledger.schema.json",
    "Seed-only evidence ledger",
    "06-contracts/*.md role contracts for delegated architecture, UX/UI, integration/runtime, security, data persistence, and verification"
  ],
  "risks": [
    "Overclaiming full Emperor Agent clone parity",
    "Unsafe shell/filesystem/network/browser tools",
    "Provider API drift",
    "Context truncation losing user instructions",
    "Skill injection bloat",
    "MCP timeout/security failures",
    "In-memory state being mistaken for durable persistence",
    "Telemetry hidden from UI",
    "Hosted auth, billing, publishing, media, or retrieval claims without proof"
  ],
  "checks": [
    "Mapper selected-output structural check passes",
    "Executable packet starts from BUILDPRINT.md",
    "02-project-setup.md defines product shape, architecture decisions, production readiness, implementation setup, assumptions, and phase start gate",
    "Every phase starts with the required implementation heading and routes through phase-flow artifacts",
    "Packaged evidence ledger is seed-only",
    "Runtime evidence belongs only in .buildprint/evidence/evidence-ledger.jsonl",
    "Evidence schema blocks blocked/missing/synthetic/partial rows from upgrading claims",
    "Publication copy prompt names the executable read order",
    "Legacy document sludge removed or reduced to compatibility spine files"
  ],
  "resultChecklist": [
    "Complete 01-questions.md and 02-project-setup.md before implementation",
    "Create root/local AGENTS.md in the implementation project",
    "Run each phase through 03-phases/phase-flow.md",
    "Create phase-run plan, team, handoff, return, review, proof, progress, state, and next-agent artifacts",
    "Append runtime proof or blockers only to .buildprint/evidence/evidence-ledger.jsonl",
    "Do not upgrade live provider, MCP, shell/browser/network, auth, billing, publishing, or clone claims without separate evidence"
  ],
  "trustBadges": [
    {
      "label": "Mapper phase-flow",
      "detail": "Converted to executable Buildprint with phase-run artifacts and review contracts.",
      "tone": "success"
    },
    {
      "label": "Clean-room scope",
      "detail": "Preserves personal agent behavior without copying source implementation or claiming exact clone parity.",
      "tone": "info"
    },
    {
      "label": "Evidence honesty",
      "detail": "Runtime evidence is separated from seed evidence and blocked proof cannot upgrade claims.",
      "tone": "success"
    },
    {
      "label": "Safety-gated tools",
      "detail": "Shell, browser, network, filesystem writes, live providers, and real MCP are explicit approval/proof boundaries.",
      "tone": "warning"
    }
  ],
  "originGithubUrl": "https://github.com/TheSyart/emperor-agent",
  "originLabel": "TheSyart/emperor-agent",
  "copyPrompt": "Use the Personal Agent Chat Buildprint. First bootstrap exact snapshots: agb start https://agent-buildprint.com/buildprints/personal-agent-chat/package.json . If agb is not installed, clone https://github.com/DomEscobar/agent-buildprint and run node agent-buildprint/bin/agb.js start https://agent-buildprint.com/buildprints/personal-agent-chat/package.json . Then read .buildprint/next-agent.md and continue. Do not write Buildprint snapshots manually. The bootstrapped packet is the source of truth — follow its read order (BUILDPRINT.md, 01-questions.md, 02-project-setup.md, blueprint.yaml, 03-phases/phase-index.yaml, 04-evaluation.md, and the active phase files) instead of restating its rules here.",
  "publicStatus": {
    "label": "Mapper converted",
    "explanation": "Converted to executable Buildprint phase-flow methodology with seed-only packaged evidence and honest runtime evidence rules."
  }
}