musehub/templates/musehub/pages/docs_muse_profiles.html · gabriel/musehub

<span class="tok-key">"agent_capabilities"</span>: [<span class="tok-str">"read:repos"</span>, <span class="tok-str">"write:repos"</span>, <span class="tok-str">"mpay:send"</span>],

480

<span class="tok-key">"expires_at"</span>: <span class="tok-str">"2026-06-01T00:00:00Z"</span>,

481

<span class="tok-key">"archetype"</span>: {

482

<span class="tok-key">"agent_trust_chain"</span>: [

483

{ <span class="tok-key">"handle"</span>: <span class="tok-str">"gabriel"</span>, <span class="tok-key">"type"</span>: <span class="tok-str">"human"</span> },

484

{ <span class="tok-key">"handle"</span>: <span class="tok-str">"mix-engine-7"</span>, <span class="tok-key">"type"</span>: <span class="tok-str">"agent"</span> }

]

}

}</code></pre>

</div>

</section>

{# ── Org profiles ─────────────────────────────────────────────────────── #}

492

493

<h2 class="devdocs-section-title"><a href="#org-profiles">Org profiles</a></h2>

494

495

<p>

496

An org is a collective of humans and agents operating under a shared identity with

497

multi-sig quorum governance. The org profile shows the member roster with voting

498

weights, open proposals, and the shared AVAX treasury address.

</p>

<p>

The Spectral Sigil for an org uses the quorum polygon archetype — an N-gon where

503

N (5–8 sides) is derived from the identity_id, with diagonal weights that vary

504

edge thickness to reflect the hierarchy of voting weights within the collective.

</p>

<span class="devdocs-code-label">org manifest</span>

511

</div>

512

<pre><code>{

513

<span class="tok-key">"handle"</span>: <span class="tok-str">"darkroom-collective"</span>,

514

<span class="tok-key">"identity_type"</span>: <span class="tok-str">"org"</span>,

515

<span class="tok-key">"archetype"</span>: {

516

<span class="tok-key">"org_manifest"</span>: {

517

<span class="tok-key">"members"</span>: [

518

{ <span class="tok-key">"handle"</span>: <span class="tok-str">"gabriel"</span>, <span class="tok-key">"role"</span>: <span class="tok-str">"admin"</span>, <span class="tok-key">"voting_weight"</span>: <span class="tok-num">2</span> },

519

{ <span class="tok-key">"handle"</span>: <span class="tok-str">"aaronrene"</span>, <span class="tok-key">"role"</span>: <span class="tok-str">"member"</span>, <span class="tok-key">"voting_weight"</span>: <span class="tok-num">1</span> },

520

{ <span class="tok-key">"handle"</span>: <span class="tok-str">"stori-bot"</span>, <span class="tok-key">"role"</span>: <span class="tok-str">"member"</span>, <span class="tok-key">"voting_weight"</span>: <span class="tok-num">1</span> }

521

],

522

<span class="tok-key">"quorum"</span>: <span class="tok-num">3</span>,

523

<span class="tok-key">"treasury_address"</span>: <span class="tok-str">"0xabc…def"</span>

}

}

}</code></pre>

</div>

</section>

{# ── API reference ────────────────────────────────────────────────────── #}

531

532

<h2 class="devdocs-section-title"><a href="#api">API reference</a></h2>

<thead><tr><th>Method</th><th>Path</th><th>Auth</th><th>Description</th></tr></thead>

<tbody>

<tr>

<td><code>/avatars/{algo}/{hex}.svg</code></td>

541

542

<td>Spectral Sigil SVG — immutably cached</td>

</tr>

<tr>

<td><code>/api/profiles/{handle}</code></td>

547

548

<td>Full archetype-aware profile manifest</td>

</tr>

<tr>

<td><code>/api/profiles/{handle}/attestations</code></td>

553

554

<td>Attestations received by this handle</td>

</tr>

<tr>

<td><code>/api/profiles/{handle}/attestations</code></td>

559

<td>MSign</td>

560

<td>Issue a signed attestation</td>

561

</tr>

562

<tr>

563

<td><code>DELETE</code></td>

564

<td><code>/api/profiles/{handle}/attestations/{id}</code></td>

565

<td>MSign</td>

566

<td>Revoke (sets <code>revoked_at</code>, audit trail preserved)</td>

</tr>

<tr>

<td><code>/api/profiles/{handle}/mpay-claims</code></td>

571

<td>MSign</td>

572

<td>Record a signed MPay claim</td>

</tr>

<tr>

<td><code>/api/profiles/{handle}/mpay-ledger</code></td>

577

578

<td>Sent + received totals and recent claims</td>

</tr>

</tbody>

</table>

</div>

</section>

{# ── MCP tools ────────────────────────────────────────────────────────── #}

586

587

<h2 class="devdocs-section-title"><a href="#mcp-tools">MCP tools</a></h2>

588

589

<p>

590

All profile operations are available as MCP tools so agents can read profiles,

591

issue attestations, and record payments without direct HTTP calls.

</p>

<thead><tr><th>Tool name</th><th>Description</th></tr></thead>

597

<tbody>

598

<tr><td><code>musehub_read_profile_manifest</code></td><td>Full archetype-aware manifest for any handle</td></tr>

599

<tr><td><code>musehub_issue_attestation</code></td><td>Sign + post an attestation claim</td></tr>

600

<tr><td><code>musehub_revoke_attestation</code></td><td>Revoke an existing attestation by ID</td></tr>

601

<tr><td><code>musehub_list_attestations</code></td><td>Query attestations received by a handle</td></tr>

602

<tr><td><code>musehub_record_mpay_claim</code></td><td>Record a signed MPay payment claim</td></tr>

603

<tr><td><code>musehub_get_mpay_ledger</code></td><td>Sent + received totals for a handle</td></tr>

</tbody>

</table>

</div>

<strong>What makes this different</strong><br>

610

These are not social features bolted onto a code host. Every attestation is an

611

Ed25519-signed cryptographic claim verifiable without trusting MuseHub. Every

612

payment claim chains nonces into a tamper-evident ledger. Every profile sigil is

613

derived from the identity's genesis hash — it cannot be faked or transferred.

614

The same key that signs your commits signs your attestations and authorises your payments.

</div>

</section>

{# ── Phase nav ─────────────────────────────────────────────────────────── #}

619

620

<a class="devdocs-phase-nav-btn devdocs-phase-nav-btn--prev" href="/muse/api">{{ icon("arrow-left", 14) }} 10 API Reference</a>

621

<a class="devdocs-phase-nav-btn" href="/muse">All phases</a>

622

<a class="devdocs-phase-nav-btn devdocs-phase-nav-btn--next" href="/muse/mists">12 Mists {{ icon("arrow-right", 14) }}</a>

</nav>

</article>

</div>

</div>

{% endblock %}