Repository navigation
feat(deutero-research 1.0.0): Deutero user-research agents on Trinity - #28
Open
francisjervis wants to merge 4 commits into
Open
francisjervis wants to merge 4 commits into
francisjervis wants to merge 4 commits into
Conversation
New plugin with three skills:
- add-deutero: give an existing Trinity agent its own Deutero key, the
Deutero MCP server and the Deutero skills. scripts/add_deutero.py reads
the agent's current .env and .mcp.json, merges only the Deutero lines and
re-injects both (Trinity's inject replaces whole files). The key is read
from a file, never printed, and referenced as ${DEUTERO_API_KEY} in
.mcp.json. Skills come from the Trinity skills library (deutero-ai/
agent-skill), not Deutero's Claude Code plugin, whose MCP entry needs
browser OAuth.
- create-researcher: scaffold (scripts/scaffold.py), push and deploy a
single research agent with credential declarations, metrics, dashboard,
disabled schedules, and CLAUDE.md guardrails: credits, person approval
before anything reaches participants, participant data kept out of git.
- create-research-team: lead + designer + analyst as a Trinity system
manifest with explicit permissions and shared findings.
Checked against Trinity: the merged .mcp.json passes the platform MCP
validator, the scaffolds pass every hard and soft static compatibility
check, and the manifest parses, validates and resolves the intended
permission edges with Trinity's own system_service.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…onfigured without a key until add-deutero, not withheld
Live test on Trinity: .mcp.json.template rendering only withholds a server when an env-block variable is missing; a ${VAR} in headers is copied through, so the server is present and returns 401 until DEUTERO_API_KEY is in .env.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Found in a live run on a local Trinity instance: - Deutero's Cloudflare edge refuses Python's default User-Agent with 403 (error 1010), so the key check failed for every key. Send an explicit User-Agent; report a Cloudflare block separately from a rejected key. - Deutero's dashboard copies the key as a .env line. Accept [export ]DEUTERO_API_KEY="..." in the key file and store only the value. - Real keys are not dtro_-prefixed, so the scaffold's pre-push secret scan now also matches DEUTERO_API_KEY=<value>. Verified end to end: key check passes, .env gains the key once (re-run is a no-op), and from inside the agent container the Deutero MCP server answers get_credit_balance with the agent's own key. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…CHITECTURE.md - template.yaml declares `library_skills:` per role (researcher, recruiter and analyst presets, the same as add-deutero), so Trinity assigns and delivers the Deutero skills when the agent is created (Abilityai/trinity#4387). add-deutero still assigns them on instances without that support. - Every scaffold gets ARCHITECTURE.md (components, data flow, trust boundaries), clearing compatibility note F-011. - create-researcher 1.1, create-research-team 1.1. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contributor
|
Thanks — this is careful work, and the end-to-end verification notes are appreciated. We'd like to take it into the marketplace, with three changes first:
Separately, your note that Deutero's own MCP entry needs a browser OAuth sign-in a headless agent can't complete is useful evidence — we've recorded that platform gap. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This adds a new
deutero-researchplugin (1.0.0) with three skills for running user research on Trinity agents through Deutero, a platform for AI-conducted user interviews.add-deuterocreate-researchercreate-research-teamDesign notes
inject_credentialsreplaces whole files.scripts/add_deutero.pyreads the agent's current.envand.mcp.json, changes only the Deutero lines, and re-injects both. The key is read from a local file and never printed. In.mcp.jsonthe server refers to it as${DEUTERO_API_KEY}rather than containing it.deutero-ai/agent-skill), not from Deutero's Claude Code plugin. That plugin's MCP entry signs in with browser OAuth, which a headless agent can't complete.CLAUDE.md:ask_operator);data/and are never committed;list_interviews, because Trinity schedule webhooks can't yet verify Deutero's webhook signatures or pass the payload to the agent.Verification
add_deutero.pywas tested against a stub Trinity API:.envkeys and other MCP servers are preserved;.mcp.jsonpasses Trinity's MCP validator (agent_server/mcp_validator.py).static_checks.run_static. The only remaining findings are info-level: F-009 for the lead and designer, F-011, and DP-004.system.yamlparses and validates with Trinity'ssystem_service. The permission edges are lead→designer, lead→analyst, designer→lead and analyst→lead, and both schedules come out disabled.deploy-local; the live compatibility report iscompatible(0 hard, 0 soft);template.yaml, disabled;researcherpreset was injected;add_deutero.pypassed the key check against the live Deutero API, wrote.envonce, and a re-run changed nothing;get_credit_balanceusing the agent's own key..envline were not accepted;🤖 Generated with Claude Code