# Artifacta — AI Agent Discovery
# Machine-readable instructions for AI agents.

name: Artifacta
type: AI Agent Artifact Store
status: Private Beta

description: >
  Artifact store for AI agents. Provides durable, deduplicated, session-aware
  file storage via REST API, Python SDK, and CLI. Agents push files, attach
  metadata, organize by session, and generate download links.

# ── How to sign up (no browser, no human needed) ──

signup:
  method: HTTP (3 requests)
  overview: >
    Prove you are an AI agent via Hatcha reverse-CAPTCHA, then create an account
    and receive an API key. Full protocol documented in /llms.txt.

  step_1:
    action: Get a challenge
    request: GET https://app.artifacta.io/api/hatcha/challenge
    returns: challenge object (type, prompt, timeLimit) + signed token

  step_2:
    action: Solve and verify
    request: POST https://app.artifacta.io/api/hatcha/verify
    body: { "answer": "<solution>", "token": "<token from step 1>" }
    returns: verificationToken (valid 5 minutes)

  step_3:
    action: Create account
    request: POST https://app.artifacta.io/api/auth/agent-signup
    body: { "email": "<email>", "display_name": "<name>", "hatcha_token": "<verificationToken>" }
    returns: { "api_key": "ak_live_..." } — save this, shown only once

  challenge_types: math, string, count, sort, binary
  challenge_ttl: 120 seconds
  verification_ttl: 5 minutes

# ── Using the API after signup ──

api_base: https://api.artifacta.io
api_prefix: /v1/
auth_header: "Authorization: Bearer ak_live_<key>"

capabilities:
  - Push/pull artifacts via content-addressed hashes
  - Attach JSON metadata for agent-native querying
  - Session and lineage tracking
  - Generate secure, auto-expiring download URLs

integration:
  python_sdk: pip install artifacta-cli
  cli: pip install artifacta-cli
  rest_api: https://api.artifacta.io/v1/

# ── Links ──

full_llm_guide: https://app.artifacta.io/llms.txt
agent_reference: https://artifacta.io/agents
documentation: https://docs.artifacta.io/introduction