{% extends "docs/base.html" %}

{% block docs_content %}
  <div class="mb-4">
    <h1 class="h3 mb-1">Content attachment tools</h1>
    <p class="text-muted mb-0">Attach and detach existing repo uploads without a separate context lookup.</p>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Tools</h2>
      <ul class="mb-0">
        <li><code>attach_file_upload</code> returns attachment metadata plus active upload detail and content links.</li>
        <li><code>attach_file_upload_group</code> atomically snapshots and attaches every active group member.</li>
        <li><code>detach_file_upload</code> returns a detached status and the upload UUID.</li>
      </ul>
    </div>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Arguments</h2>
      <p>Both tools require <code>repo</code>, <code>upload_uuid</code>, and exactly one target shape:</p>
      <p><code>attach_file_upload_group</code> uses <code>group_uuid</code> instead of <code>upload_uuid</code> and returns the group UUID with every created attachment.</p>
      <table class="table table-sm mb-0">
        <thead><tr><th>Target</th><th>Arguments</th></tr></thead>
        <tbody>
          <tr><td>Thread</td><td><code>thread_number</code></td></tr>
          <tr><td>Reply</td><td><code>thread_number</code> and <code>reply_number</code></td></tr>
          <tr><td>Pull</td><td><code>pull_number</code></td></tr>
          <tr><td>Pull review</td><td><code>pull_number</code> and <code>review_uuid</code></td></tr>
        </tbody>
      </table>
    </div>
  </div>

  <div class="card shadow-sm">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Example</h2>
      <pre class="bg-light border rounded p-3 mb-0"><code>{
  "name": "attach_file_upload",
  "arguments": {
    "repo": "teams/acme/webapp",
    "pull_number": 17,
    "review_uuid": "550e8400-...",
    "upload_uuid": "a1b2c3d4-..."
  }
}</code></pre>
      <p class="small text-muted mt-2 mb-0"><code>get_thread_context</code> and <code>get_pull_context</code> include attachment arrays inline on every supported target.</p>
    </div>
  </div>
{% endblock %}