Packs

Reusable workflow/context は pack endpoint で扱います。

Create

POST /v1/packs
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "type": "context",
  "title": "Repo onboarding",
  "scope": { "type": "personal" },
  "blocks": [
    { "title": "Layout", "content": "apps/, server/, protobuf/" }
  ]
}

Workflow pack は steps、context pack は blocks を使います。

Workflow step の dueDate は future workflow run からの相対日数で、"7" のような string として保存されます。Calendar date ではありません。YYYY-MM-DD の deadline が必要な場合は task dueDate を使います。

Read

GET /v1/packs?reference=@repo-onboarding は default で outline data を返します。すべての nested content が必要なら full=true、一部だけなら blockIds / stepIds を渡します。

Pack reference には UUID、alias、share URL、hub URL を使えます。

POST /v1/packs/search は search call として credit を消費します。GET /v1/packs も outline、selected content、full content のいずれでも credit-gated です。大きな pack ではまず outline を読み、後続の agent context を小さく保てるように、必要な nested content だけを取得してください。

Update

Nested content update は operation array を使います。

PATCH /v1/packs?reference=@repo-onboarding
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "blocks": [
    { "op": "add", "title": "Local setup", "content": "npm install" },
    { "op": "update", "id": "b001", "content": "Updated" },
    { "op": "remove", "id": "b002" }
  ]
}

steps または blocks を省略すると nested content は変更されません。空配列は no-op です。すべて削除する場合は nested item ごとに remove operation を送ります。

Search filters

Pack search は type, query, page, scopes と、category, like, visibility, ownerId, minLikeCount, minDownloadCount, updatedAtFrom, updatedAtTo などの filter を受け取ります。