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

{% block docs_content %}
  <div class="d-flex flex-wrap align-items-center justify-content-between gap-2 mb-4">
    <div>
      <h1 class="h3 mb-1">File uploads</h1>
      <p class="text-muted mb-0">MCP tools for repo-scoped file uploads.</p>
    </div>
    <div class="d-flex flex-wrap gap-2">
      <a class="btn btn-sm btn-outline-secondary active" href="/docs/mcp/file-uploads">Overview</a>
      <a class="btn btn-sm btn-outline-secondary" href="/docs/mcp/list-file-uploads">List</a>
      <a class="btn btn-sm btn-outline-secondary" href="/docs/mcp/get-file-upload">Get</a>
      <a class="btn btn-sm btn-outline-secondary" href="/docs/mcp/create-file-upload">Create</a>
      <a class="btn btn-sm btn-outline-secondary" href="/docs/mcp/update-file-upload">Update</a>
      <a class="btn btn-sm btn-outline-secondary" href="/docs/mcp/delete-file-upload">Delete</a>
      <a class="btn btn-sm btn-outline-secondary" href="/docs/mcp/get-file-upload-content">Content</a>
    </div>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Sections</h2>
      <div class="list-group list-group-flush">
        <a class="list-group-item list-group-item-action" href="/docs/mcp/list-file-uploads">List file uploads</a>
        <a class="list-group-item list-group-item-action" href="/docs/mcp/get-file-upload">Get file upload</a>
        <a class="list-group-item list-group-item-action" href="/docs/mcp/create-file-upload">Create file upload</a>
        <a class="list-group-item list-group-item-action" href="/docs/mcp/update-file-upload">Update file upload</a>
        <a class="list-group-item list-group-item-action" href="/docs/mcp/delete-file-upload">Delete file upload</a>
        <a class="list-group-item list-group-item-action" href="/docs/mcp/get-file-upload-content">Get file upload content</a>
      </div>
    </div>
  </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>list_file_uploads</code></li>
        <li><code>get_file_upload</code></li>
        <li><code>create_file_upload</code></li>
        <li><code>update_file_upload</code></li>
        <li><code>delete_file_upload</code></li>
        <li><code>get_file_upload_content</code></li>
      </ul>
    </div>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Parameters</h2>
      <ul class="mb-0">
        <li><code>repo</code>: repo locator such as <code>teams/team_slug/repo_slug</code> or <code>username/repo_slug</code>.</li>
        <li><code>uuid</code>: file upload UUID for read/update/delete/content calls.</li>
        <li><code>filename</code>, <code>content_base64</code>, <code>description</code>, and <code>content_type</code> for create.</li>
      </ul>
    </div>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Example</h2>
      <div class="bg-light border rounded p-3">
        <pre class="mb-0"><code>curl -X POST https://pearing.example/api/v1/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "create_file_upload",
      "arguments": {
        "repo": "teams/acme/webapp",
        "filename": "screenshot.png",
        "content_base64": "iVBORw0KGgoAAAANSUhEUgAA...",
        "description": "Build screenshot",
        "content_type": "image/png"
      }
    }
  }'</code></pre>
      </div>
    </div>
  </div>

  <div class="card shadow-sm">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Notes</h2>
      <ul class="mb-0">
        <li>The tool responses return the same file-upload resource shapes as the REST API.</li>
        <li>Stored bytes are fetched from repo- and file-UUID buckets; callers do not supply paths directly.</li>
      </ul>
    </div>
  </div>
{% endblock %}