{
  "info": {
    "_postman_id": "7bbf9acd-1f3f-48f7-9464-7b87aa0fe722",
    "name": "Context Factory API",
    "description": "Read-only artifact and collection discovery. Responses contain metadata and source links, never source bodies.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://preview.api.contextfactory.dev/v1"
    },
    {
      "key": "artifactId",
      "value": "123456789ABC"
    },
    {
      "key": "collectionId",
      "value": "ABCDEFGHJKLM"
    },
    {
      "key": "cursor",
      "value": ""
    },
    {
      "key": "missingArtifactId",
      "value": "zzzzzzzzzzzz"
    }
  ],
  "item": [
    {
      "name": "Search artifacts",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{baseUrl}}/artifacts?q=agent%20guidance&type=skill&limit=10",
          "host": ["{{baseUrl}}"],
          "path": ["artifacts"],
          "query": [
            { "key": "q", "value": "agent guidance" },
            { "key": "type", "value": "skill" },
            { "key": "limit", "value": "10" }
          ]
        }
      }
    },
    {
      "name": "Filter by repository",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{baseUrl}}/artifacts?repository=Context-Factory%2Fcontext-factory-skill",
          "host": ["{{baseUrl}}"],
          "path": ["artifacts"],
          "query": [
            {
              "key": "repository",
              "value": "Context-Factory/context-factory-skill"
            }
          ]
        }
      }
    },
    {
      "name": "Continue artifact search",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{baseUrl}}/artifacts?cursor={{cursor}}&limit=10",
          "host": ["{{baseUrl}}"],
          "path": ["artifacts"],
          "query": [
            { "key": "cursor", "value": "{{cursor}}" },
            { "key": "limit", "value": "10" }
          ]
        }
      }
    },
    {
      "name": "Get artifact",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{baseUrl}}/artifacts/{{artifactId}}",
          "host": ["{{baseUrl}}"],
          "path": ["artifacts", "{{artifactId}}"]
        }
      }
    },
    {
      "name": "Get collection",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{baseUrl}}/collections/{{collectionId}}",
          "host": ["{{baseUrl}}"],
          "path": ["collections", "{{collectionId}}"]
        }
      }
    },
    {
      "name": "Filter collection",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{baseUrl}}/collections/{{collectionId}}?type=skill&limit=20",
          "host": ["{{baseUrl}}"],
          "path": ["collections", "{{collectionId}}"],
          "query": [
            { "key": "type", "value": "skill" },
            { "key": "limit", "value": "20" }
          ]
        }
      }
    },
    {
      "name": "Empty search",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{baseUrl}}/artifacts?q=term-that-should-not-exist",
          "host": ["{{baseUrl}}"],
          "path": ["artifacts"],
          "query": [
            { "key": "q", "value": "term-that-should-not-exist" }
          ]
        }
      }
    },
    {
      "name": "Invalid request",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{baseUrl}}/artifacts?type=unknown&limit=100",
          "host": ["{{baseUrl}}"],
          "path": ["artifacts"],
          "query": [
            { "key": "type", "value": "unknown" },
            { "key": "limit", "value": "100" }
          ]
        }
      }
    },
    {
      "name": "Missing artifact",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{baseUrl}}/artifacts/{{missingArtifactId}}",
          "host": ["{{baseUrl}}"],
          "path": ["artifacts", "{{missingArtifactId}}"]
        }
      }
    }
  ]
}