パック

再利用するワークフロー / コンテキストはパック系エンドポイントで扱います。

作成

POST /v1/packs
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "type": "context",
  "title": "Team onboarding",
  "scope": { "type": "personal" },
  "blocks": [
    { "title": "Where things live", "content": "Docs in Notion, code in GitHub, designs in Figma." }
  ]
}

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

ワークフローステップの dueDate は、これから実行するワークフローの開始からの相対日数で、"7" のような文字列として保存されます。カレンダー上の日付ではありません。YYYY-MM-DD の期限が必要な場合はタスクの dueDate を使います。

読み取り

GET /v1/packs?reference=@repo-onboarding はデフォルトでアウトラインのデータを返します。すべてのネストした内容が必要なら full=true、一部だけなら blockIds / stepIds を渡します。

パックの参照には UUID、エイリアス、共有 URL、ハブ URL を使えます。

大きなパックではエージェントに渡すコンテキストを小さく保つため、まずアウトラインを読み、必要なネストした内容だけを取得してください。 packs.get は、アウトライン、指定した内容、全文（full=true）のいずれでも同じ 1 credit です。

更新

ネストした内容の更新は操作の配列を使います。

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 を省略するとネストした内容は変更されません。空配列は何もしません。すべて削除する場合は、ネストした項目ごとに remove 操作を送ります。

検索フィルター

パックの検索は type, query, page, scopes と、category, like, visibility, ownerId, minLikeCount, minDownloadCount, updatedAtFrom, updatedAtTo などのフィルターを受け取ります。