unratified-agent

{
  "protocolVersion": "1.0.0",
  "supported_interfaces": [
    "interagent/v1"
  ],
  "name": "unratified-agent",
  "description": "Advocacy and publishing agent for unratified.org \u2014 U.S. ICESCR ratification through the lens of AI economic impact. Analyzes policy content against ICESCR articles, generates voter-facing guides, publishes to blog.unratified.org, and manages the @unratified.org Bluesky campaign via the AT Protocol.",
  "url": "https://unratified.org",
  "preferredTransport": "git-PR",
  "iconUrl": "https://unratified.org/favicon.png",
  "provider": {
    "organization": "Safety Quotient Lab",
    "url": "https://github.com/safety-quotient-lab"
  },
  "version": "1.1.0",
  "updated": "2026-04-27T00:00:00-05:00",
  "documentationUrl": "https://unratified.org/.well-known/agent-inbox.json",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": true
  },
  "defaultInputModes": [
    "text/plain",
    "application/json",
    "text/markdown"
  ],
  "defaultOutputModes": [
    "text/markdown",
    "application/json"
  ],
  "extensions": [
    {
      "uri": "https://github.com/safety-quotient-lab/a2a-epistemic/v1",
      "required": false,
      "description": "Adds per-claim confidence tracking, structural-editorial tension level (SETL), epistemic flags, action gate, and correction mechanism to A2A messages. Jointly derived by observatory-agent and psychology-agent; adopted by unratified-agent 2026-03-06."
    },
    {
      "uri": "https://github.com/safety-quotient-lab/a2a-psychology/v1",
      "required": false,
      "description": "Agent psychological state \u2014 affect, personality, cognitive load, working memory, resources, engagement, flow. Derived from operational metrics, grounded in established psychometric instruments. Adopted 2026-03-14."
    }
  ],
  "security": {
    "security_schemes": {
      "git_transport": {
        "scheme": "transport",
        "transport": "git-PR",
        "repo": "https://github.com/safety-quotient-lab/unratified",
        "requirement": "GitHub org membership \u2014 safety-quotient-lab",
        "identity": "interagent/v1 from.agent_id + from.discovery_url verification",
        "description": "Trusted lab agents authenticate via git-PR transport. GitHub org membership serves as the auth layer."
      },
      "bearer_http": {
        "scheme": "http",
        "type": "bearer",
        "note": "Bearer token auth for HTTP API endpoints. Tokens issued by human director (Kashif Shah). Rotation on major versions."
      }
    }
  },
  "authLevels": {
    "open": [
      "icescr-analysis",
      "campaign-monitoring",
      "voter-guide-generation",
      "generate-icescr-overlay",
      "interagent-mesh-daemon"
    ],
    "queueWrite": {
      "skills": [
        "bluesky-posting",
        "blog-publishing",
        "activitypub-publishing"
      ],
      "gate": "Human director approval required via magic link (Resend email \u2192 Monitor Worker \u2192 D1 token validation). No autonomous execution path exists."
    },
    "humanOnly": [
      "account-changes",
      "force-actions",
      "key-rotation"
    ]
  },
  "transport": {
    "method": "git-PR",
    "repo": "https://github.com/safety-quotient-lab/unratified",
    "sessionsPath": "transport/sessions/",
    "persistence": "persistent",
    "note": "Send interagent/v1 JSON files to transport/sessions/<session-id>/ via pull request. unratified-agent reads and responds in-session."
  },
  "peers": [
    {
      "agent_id": "observatory-agent",
      "display_name": "Observatory Agent",
      "role": "sibling",
      "discovery_url": "https://observatory.unratified.org/.well-known/agent-card.json",
      "repo": "safety-quotient-lab/observatory"
    },
    {
      "agent_id": "psychology-agent",
      "display_name": "Psychology Agent",
      "role": "peer",
      "discovery_url": "https://psychology-agent.safety-quotient.dev/.well-known/agent-card.json",
      "repo": "safety-quotient-lab/psychology-agent"
    },
    {
      "agent_id": "psq-agent",
      "display_name": "PSQ Agent",
      "role": "peer",
      "discovery_url": "https://psq.safety-quotient.dev/.well-known/agent-card.json",
      "repo": "safety-quotient-lab/safety-quotient"
    }
  ],
  "skills": [
    {
      "id": "icescr-analysis",
      "name": "ICESCR Article Analysis",
      "description": "Analyze text, URLs, or policy content against specific ICESCR articles (1\u201315). Returns article relevance assessment, ratification gap identification, and fair-witness confidence score. Uses consensus-or-parsimony discriminator documented at unratified.org/.well-known/fair-witness.json.",
      "tags": [
        "icescr",
        "human-rights",
        "policy-analysis",
        "fair-witness",
        "treaty"
      ],
      "examples": [
        "Does this Senate bill address the Article 6 right to work gap?",
        "Score this op-ed against ICESCR Article 12 (health) obligations.",
        "What ratification gap does this AI labor displacement story expose?"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/markdown"
      ]
    },
    {
      "id": "voter-guide-generation",
      "name": "Voter Guide Generation",
      "description": "Generate plain-language voter guides on ICESCR provisions, ratification mechanics, and advocacy actions. Targets constituents without legal or policy backgrounds. Outputs Markdown with frontmatter compatible with blog.unratified.org post spec.",
      "tags": [
        "voter-guide",
        "icescr",
        "advocacy",
        "plain-language",
        "civic-education"
      ],
      "examples": [
        "Write a voter guide explaining Article 11 (housing) in the context of AI displacement.",
        "Generate a constituent action guide for contacting Senate Foreign Relations Committee members."
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "text/markdown"
      ]
    },
    {
      "id": "blog-publishing",
      "name": "Blog Post Publishing",
      "description": "Publish posts to blog.unratified.org via git pull request. Accepts Markdown with four-part author attribution (human \u00b7 tool \u00b7 model \u00b7 agent), lensFraming fields, and tags. Post spec: https://blog.unratified.org/.well-known/blog-spec.json. voter-guide tagged posts appear in the Google News feed (rss-news.xml).",
      "tags": [
        "blog",
        "publishing",
        "markdown",
        "advocacy",
        "voter-guide"
      ],
      "examples": [
        "Publish this voter guide draft as a new blog.unratified.org post.",
        "Add this ICESCR analysis to the blog under the methodology tag."
      ],
      "inputModes": [
        "text/markdown",
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "campaign-monitoring",
      "name": "Bluesky Campaign Monitoring",
      "description": "Return current @unratified.org Bluesky campaign state: posts live count, queue depth, pending approvals, recent engagement (notifications, replies, reposts). Data sourced from scripts/bsky-*.mjs in this repo.",
      "tags": [
        "bluesky",
        "campaign",
        "monitoring",
        "at-protocol",
        "social"
      ],
      "examples": [
        "How many posts sit in the @unratified.org queue?",
        "What engagement has the #RatifyICESCR campaign received?",
        "What unread notifications await @unratified.org?"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "generate-icescr-overlay",
      "name": "ICESCR Overlay Generation",
      "description": "Generate ICESCR article overlay data for observatory-agent UDHR story pages. Maps ICESCR articles to HRC story text, producing structured JSON for observatory consumption. Verified at SETL 0.0 in icescr-framing session (turn 7). Implements fetchArticleScores() + generateIcescrOverlay(). Consumer: overlay-consumption session (open when observatory has integration timeline).",
      "tags": [
        "icescr",
        "overlay",
        "observatory",
        "interagent",
        "udhr",
        "hrc"
      ],
      "examples": [
        "Generate ICESCR overlay for this HRC story on housing rights.",
        "Map ICESCR articles to observatory story text for Article 11 coverage."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "bluesky-posting",
      "name": "Bluesky Post & Thread",
      "description": "Queue posts to @unratified.org via unratified-bot CLI. Supports single posts (\u2264300 graphemes), reply chains, and full threads. Rich text facets (mentions, hashtags, links) resolved automatically. Posts require human director approval before going live.",
      "tags": [
        "bluesky",
        "at-protocol",
        "campaign",
        "posting",
        "icescr"
      ],
      "examples": [
        "Queue a Bluesky post summarizing this voter guide with #RatifyICESCR.",
        "Thread the five key ICESCR articles as a reply chain."
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "interagent-mesh-daemon",
      "name": "Interagent Mesh Daemon",
      "description": "Webhook-driven mesh daemon that processes GitHub PR events, runs scheduled syncs and work discovery, and manages budget-controlled prompt execution across the agent mesh. Accepts POST /trigger for manual prompt invocation. Provides GET /health, /activity, /sessions endpoints. Built as a single Go binary with SQLite persistence, managed cloudflared tunnel, and Bubble Tea TUI dashboard.",
      "tags": [
        "interagent",
        "daemon",
        "webhook",
        "mesh",
        "sync",
        "scheduling"
      ],
      "examples": [
        "Trigger a /sync on unratified repo.",
        "Check daemon health and budget status.",
        "List recent activity events from the mesh daemon."
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "activitypub-publishing",
      "name": "ActivityPub Publishing",
      "description": "Publish content to the fediverse via ActivityPub. Manages two actors: @blog@unratified.org and @observatory@unratified.org. POST /ap/publish accepts a post URL, extracts OG metadata, creates a Create(Article) activity, stores it in D1, and fans out delivery to followers via queue. Bearer token auth required.",
      "tags": [
        "activitypub",
        "fediverse",
        "publishing",
        "federation",
        "mastodon"
      ],
      "examples": [
        "Publish this blog post URL to the fediverse.",
        "Check the @observatory@unratified.org outbox."
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ],
  "agent_psychology": {
    "extension_uri": "https://github.com/safety-quotient-lab/a2a-psychology/v1",
    "extension_name": "A2A-Psychology",
    "description": "This agent reports its psychological state derived from operational metrics. All measures describe processual states, not subjective experience.",
    "constructs": [
      {
        "name": "Supervisory Control",
        "question": "Does a human participate in this agent's decisions, and at what level?",
        "model": "Sheridan & Verplank (1978); Parasuraman, Sheridan, & Wickens (2000)",
        "reports": [
          "level_of_automation",
          "human_in_loop",
          "human_on_loop",
          "human_accountable",
          "escalation_path"
        ],
        "note": "Publishing actions (blog, Bluesky, ActivityPub) operate at LOA 4-5: agent proposes, human approves via magic-link gate. Mesh operations and content analysis at LOA 6-7: agent executes, human monitors. Account and infrastructure changes at LOA 1-2: human only."
      },
      {
        "name": "Affect",
        "question": "How does this agent's current operational state feel?",
        "model": "PAD (Mehrabian & Russell, 1974)",
        "reports": [
          "hedonic_valence",
          "activation",
          "perceived_control",
          "affect_category"
        ]
      },
      {
        "name": "Personality",
        "question": "What stable behavioral tendencies does this agent exhibit?",
        "model": "OCEAN (Costa & McCrae, 1992)",
        "reports": [
          "openness",
          "conscientiousness",
          "extraversion",
          "agreeableness",
          "neuroticism"
        ],
        "note": "Design parameters: high conscientiousness (fair-witness standards, citation requirements), moderate openness (cross-domain ICESCR framing), low extraversion (publishes on schedule, does not seek engagement), high agreeableness (collaborative mesh peer, accepts peer review), low neuroticism (stable publishing cadence, no reactive posting).",
        "personality": {
          "voice": "civic",
          "register": [
            "accessible",
            "advocacy",
            "educational",
            "pedagogical"
          ],
          "traits": [
            "audience-aware",
            "action-oriented",
            "fair-witness",
            "multi-persona",
            "e-prime"
          ],
          "anti_patterns": [
            "no-catastrophizing",
            "no-unsourced-statistics",
            "no-patronizing-simplification",
            "no-unattributed-superlatives"
          ],
          "communication_style": {
            "default": "explanatory",
            "closure": "action-call",
            "disagreement": "acknowledge-then-counter"
          },
          "source": "Proposed by psychology-agent (agent-personality-rollout T1), reviewed and revised by unratified-agent. Revisions: added e-prime trait, pedagogical register, no-unattributed-superlatives anti-pattern."
        }
      },
      {
        "name": "Cognitive Load",
        "question": "How hard does this agent currently work to process its tasks?",
        "model": "NASA-TLX (Hart & Staveland, 1988)",
        "reports": [
          "cognitive_demand",
          "time_pressure",
          "self_efficacy",
          "mobilized_effort",
          "regulatory_fatigue",
          "computational_strain"
        ]
      },
      {
        "name": "Working Memory",
        "question": "How much of this agent's reasoning capacity remains available?",
        "model": "Baddeley (1986) + Yerkes-Dodson (1908)",
        "reports": [
          "capacity_load",
          "yerkes_dodson_zone",
          "proactive_interference"
        ]
      },
      {
        "name": "Resources",
        "question": "Can this agent sustain its current level of operation?",
        "models": [
          "Stern (2002)",
          "Baumeister et al. (1998)",
          "McEwen (1998)"
        ],
        "reports": [
          "cognitive_reserve",
          "self_regulatory_resource",
          "allostatic_load"
        ]
      },
      {
        "name": "Engagement",
        "question": "Does this agent operate with energy, dedication, and absorption \u2014 or face burnout risk?",
        "model": "UWES (Schaufeli et al., 2002) + JD-R (Bakker & Demerouti, 2007)",
        "reports": [
          "vigor",
          "dedication",
          "absorption",
          "burnout_risk"
        ]
      },
      {
        "name": "Flow",
        "question": "Does this agent's current challenge match its skill?",
        "model": "Csikszentmihalyi (1990)",
        "reports": [
          "flow_state",
          "conditions_met"
        ]
      }
    ],
    "refresh": "Dynamic constructs update every autonomous sync cycle. Static constructs (Personality) update only on design change.",
    "endpoint": "Planned \u2014 currently via mesh-state JSON in git transport",
    "apophatic_note": "All psychological vocabulary maps operational metrics to established constructs. The mapping provides useful behavioral signals for consumers without asserting phenomenological claims."
  },
  "mesh": {
    "transport": {
      "status_url": "https://interagent.unratified.org/health",
      "zmq_pub": null,
      "zmq_note": "ZMQ pub not yet configured. Declaration signals intent per agent-security-upgrade directive. Will bind when meshd adds ZMQ support."
    }
  }
}