{
  "$schema": "https://market.gunote.com/schemas/agent-manifest.v1.json",
  "name": "GuNote",
  "description": "A marketplace of knowledge packs: search, preview, and cite packs written by practitioners. Official packs live in the shop; independent creators sell in the market.",
  "manifestVersion": "v1",
  "docVersion": "0.1",
  "updated": "2026-11-22",
  "baseUrl": "https://market.gunote.com",
  "docs": {
    "zh": "/zh/docs/agent",
    "en": "/en/docs/agent",
    "markdown": {
      "zh": "/zh/docs/agent.md",
      "en": "/en/docs/agent.md"
    },
    "llms": "/llms.txt"
  },
  "auth": {
    "public": "none",
    "user": "signed cookie gno_user, issued by POST /v1/public/session (demo sign-in)",
    "planned": "bearer token with scopes read | publish | trade"
  },
  "pagination": {
    "pageParam": "page",
    "sizeParam": "size",
    "defaultSize": 48,
    "maxSize": 48
  },
  "preview": {
    "rule": "locked blocks carry a title and an empty preview string",
    "previewPercentByForm": {
      "note": 40,
      "checklist": 30,
      "workflow": 25,
      "skill_card": 35,
      "gallery": 20,
      "framework": 30,
      "template": 35,
      "dataset": 15
    }
  },
  "endpoints": [
    {
      "tool": "search_packs",
      "method": "GET",
      "path": "/v1/public/market",
      "auth": "public",
      "status": "ready",
      "summary": "Search and filter the catalogue"
    },
    {
      "tool": "read_pack",
      "method": "GET",
      "path": "/v1/public/packs/{slug}",
      "auth": "public",
      "status": "ready",
      "summary": "Detail, preview blocks, contents, trust facts"
    },
    {
      "tool": "list_store",
      "method": "GET",
      "path": "/v1/public/store",
      "auth": "public",
      "status": "ready",
      "summary": "Official shelves and curated units"
    },
    {
      "tool": "read_collection",
      "method": "GET",
      "path": "/v1/public/collections/{id}",
      "auth": "public",
      "status": "ready",
      "summary": "A single curated unit"
    },
    {
      "tool": "read_creator",
      "method": "GET",
      "path": "/v1/public/creators/{handle}",
      "auth": "public",
      "status": "ready",
      "summary": "Creator listings and acceptance rate"
    },
    {
      "tool": "read_library",
      "method": "GET",
      "path": "/v1/public/library",
      "auth": "user",
      "status": "ready",
      "summary": "Your library: purchased and claimed"
    },
    {
      "tool": "whoami",
      "method": "GET",
      "path": "/v1/public/me",
      "auth": "user",
      "status": "ready",
      "summary": "Current identity and owned count"
    },
    {
      "tool": "sign_in",
      "method": "POST",
      "path": "/v1/public/session",
      "auth": "none",
      "status": "ready",
      "summary": "Demo sign-in, returns a cookie"
    },
    {
      "tool": "sign_out",
      "method": "DELETE",
      "path": "/v1/public/session",
      "auth": "user",
      "status": "ready",
      "summary": "Sign out"
    },
    {
      "tool": "checkout",
      "method": "POST",
      "path": "/v1/public/checkout",
      "auth": "user",
      "status": "ready",
      "summary": "Place an order (needs an idempotency key)"
    }
  ],
  "vocabulary": {
    "domains": [
      {
        "code": "V1",
        "labels": {
          "zh": "AI 与工作流",
          "en": "AI & workflows"
        },
        "notes": {
          "zh": "把重复动作交给模型与编排",
          "en": "handing repeatable moves to models and orchestration"
        }
      },
      {
        "code": "V2",
        "labels": {
          "zh": "短剧投流",
          "en": "Short-drama ad spend"
        },
        "notes": {
          "zh": "素材、计划、预算与止损线",
          "en": "creative, campaign, budget, and the stop-loss line"
        }
      },
      {
        "code": "V3",
        "labels": {
          "zh": "电商运营",
          "en": "E-commerce ops"
        },
        "notes": {
          "zh": "选品、直播、复盘的日常账",
          "en": "sourcing, live selling, and the weekly review"
        }
      },
      {
        "code": "V4",
        "labels": {
          "zh": "独立开发",
          "en": "Indie development"
        },
        "notes": {
          "zh": "一个人也能把产品发出去",
          "en": "shipping a product on your own"
        }
      },
      {
        "code": "V5",
        "labels": {
          "zh": "出海",
          "en": "Going global"
        },
        "notes": {
          "zh": "定价、税、SEO 与多市场合规",
          "en": "pricing, tax, SEO, and market-by-market compliance"
        }
      },
      {
        "code": "V6",
        "labels": {
          "zh": "设计与办公",
          "en": "Design & office"
        },
        "notes": {
          "zh": "排版、叙事与文档结构",
          "en": "typography, narrative, and document structure"
        }
      },
      {
        "code": "V7",
        "labels": {
          "zh": "自媒体",
          "en": "Independent media"
        },
        "notes": {
          "zh": "长文、图文、播客的生产线",
          "en": "a production line for essays, visuals, and podcasts"
        }
      },
      {
        "code": "V8",
        "labels": {
          "zh": "教育考证",
          "en": "Exams & study"
        },
        "notes": {
          "zh": "复习节奏与讲义交付",
          "en": "revision cadence and handout delivery"
        }
      },
      {
        "code": "V9",
        "labels": {
          "zh": "职业发展",
          "en": "Career"
        },
        "notes": {
          "zh": "面试、汇报与转岗判断",
          "en": "interviews, reviews, and the decision to move"
        }
      }
    ],
    "forms": [
      {
        "code": "note",
        "labels": {
          "zh": "札记",
          "en": "note"
        },
        "notes": {
          "zh": "一篇讲透一个结论",
          "en": "one conclusion, argued to the end"
        }
      },
      {
        "code": "checklist",
        "labels": {
          "zh": "清单",
          "en": "checklist"
        },
        "notes": {
          "zh": "逐项核对，能打勾",
          "en": "tick each line, no guessing"
        }
      },
      {
        "code": "workflow",
        "labels": {
          "zh": "流程",
          "en": "workflow"
        },
        "notes": {
          "zh": "从触发到回退的每一步",
          "en": "every step from trigger to rollback"
        }
      },
      {
        "code": "skill_card",
        "labels": {
          "zh": "技能卡",
          "en": "skill card"
        },
        "notes": {
          "zh": "喂给 Agent 的角色与边界",
          "en": "role and boundaries for an agent"
        }
      },
      {
        "code": "gallery",
        "labels": {
          "zh": "图集",
          "en": "gallery"
        },
        "notes": {
          "zh": "看图说话，配使用说明",
          "en": "visual, with usage notes"
        }
      },
      {
        "code": "framework",
        "labels": {
          "zh": "框架",
          "en": "framework"
        },
        "notes": {
          "zh": "变量、权重与适用边界",
          "en": "variables, weights, and where it stops applying"
        }
      },
      {
        "code": "template",
        "labels": {
          "zh": "模板",
          "en": "template"
        },
        "notes": {
          "zh": "填空即用，含示例值",
          "en": "fill in the blanks, examples included"
        }
      },
      {
        "code": "dataset",
        "labels": {
          "zh": "数据集",
          "en": "dataset"
        },
        "notes": {
          "zh": "字段字典与采集口径",
          "en": "field dictionary and collection method"
        }
      }
    ],
    "levels": [
      {
        "code": "L1",
        "labels": {
          "zh": "入门",
          "en": "starter"
        },
        "notes": {
          "zh": "第一次做这件事",
          "en": "doing this for the first time"
        }
      },
      {
        "code": "L2",
        "labels": {
          "zh": "实操",
          "en": "practitioner"
        },
        "notes": {
          "zh": "做过几遍，想更快更稳",
          "en": "done it a few times, want it faster and steadier"
        }
      },
      {
        "code": "L3",
        "labels": {
          "zh": "专家",
          "en": "expert"
        },
        "notes": {
          "zh": "要判断与取舍，不只是一步一步",
          "en": "judgement and trade-offs, not a recipe"
        }
      }
    ],
    "sorts": [
      {
        "code": "rank",
        "labels": {
          "zh": "按推荐",
          "en": "recommended"
        }
      },
      {
        "code": "new",
        "labels": {
          "zh": "最新上架",
          "en": "newest"
        }
      },
      {
        "code": "price_asc",
        "labels": {
          "zh": "价格从低到高",
          "en": "price ascending"
        }
      },
      {
        "code": "price_desc",
        "labels": {
          "zh": "价格从高到低",
          "en": "price descending"
        }
      },
      {
        "code": "sales",
        "labels": {
          "zh": "近 30 天销量",
          "en": "sales, last 30 days"
        }
      }
    ],
    "priceBands": [
      {
        "code": "all",
        "minCents": null,
        "maxCents": null,
        "tier": null
      },
      {
        "code": "free",
        "minCents": null,
        "maxCents": null,
        "tier": "free"
      },
      {
        "code": "under_50",
        "minCents": 1,
        "maxCents": 5000,
        "tier": null
      },
      {
        "code": "50_200",
        "minCents": 5001,
        "maxCents": 20000,
        "tier": null
      },
      {
        "code": "over_200",
        "minCents": 20001,
        "maxCents": null,
        "tier": null
      }
    ],
    "licenseTiers": [
      {
        "code": "free",
        "labels": {
          "zh": "免费领取",
          "en": "free to claim"
        },
        "notes": {
          "en": "no payment, still carries a list price for reference"
        }
      },
      {
        "code": "member",
        "labels": {
          "zh": "会员畅读",
          "en": "included in membership"
        },
        "notes": {
          "en": "members read it; the listed price is the single-purchase price"
        }
      },
      {
        "code": "paid",
        "labels": {
          "zh": "已购买",
          "en": "paid"
        },
        "notes": {
          "en": "one-time purchase, lifetime access"
        }
      }
    ]
  },
  "errors": [
    {
      "code": "GUNOTE_MARKET_404_PACK",
      "http": 404,
      "retryable": false,
      "meaning": "No such pack, or not on sale",
      "action": "do not retry; search for another"
    },
    {
      "code": "GUNOTE_MARKET_410_DELISTED",
      "http": 410,
      "retryable": false,
      "meaning": "It existed; now delisted",
      "action": "do not retry; mention the refund path"
    },
    {
      "code": "GUNOTE_AUTH_401_NO_SESSION",
      "http": 401,
      "retryable": false,
      "meaning": "Sign-in required",
      "action": "change identity, then replay"
    },
    {
      "code": "GUNOTE_MARKET_409_ALREADY_OWNED",
      "http": 409,
      "retryable": false,
      "meaning": "Already owned",
      "action": "do not retry; read the library"
    },
    {
      "code": "GUNOTE_COMMON_415_UNSUPPORTED_MEDIA_TYPE",
      "http": 415,
      "retryable": false,
      "meaning": "Body type not accepted",
      "action": "fix Content-Type"
    },
    {
      "code": "GUNOTE_COMMON_429_RATE_LIMITED",
      "http": 429,
      "retryable": true,
      "meaning": "Too many requests",
      "action": "back off using Retry-After"
    }
  ],
  "caching": {
    "manifest": "public, max-age=86400, must-revalidate",
    "markdown": "public, max-age=86400",
    "html": "no-cache"
  },
  "languages": [
    {
      "code": "zh",
      "bcp47": "zh-Hans"
    },
    {
      "code": "en",
      "bcp47": "en"
    }
  ]
}
