predictable-ai 0.1.0

package/dist/generated/commands.json

@@ -0,0 +1,881 @@
+{
+  "$generated": "GENERATED FILE — DO NOT EDIT.  Source of truth: dashboard/src/lib/agent/manifest.ts Regenerate:      npm run generate:agent-surface   (from dashboard/) Guard:           npm run guard:agent-surface      (CI re-derives and diffs)",
+  "version": "0a7369628826adda",
+  "binary": "predictable",
+  "commands": [
+    {
+      "command": "whoami",
+      "verb": "whoami",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Identity, client scope and rep linkage — the token smoke-test verb.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/me"
+        }
+      ]
+    },
+    {
+      "command": "lists list",
+      "verb": "lists.list",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Enumerate the caller's clients, lists and counts.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/agent/lists"
+        }
+      ]
+    },
+    {
+      "command": "lists status",
+      "verb": "lists.status",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Latest base-search job and per-status candidate counts.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/lists/[id]/exa-agent/status"
+        },
+        {
+          "method": "GET",
+          "path": "/api/lists/[id]/exa-agent/counts"
+        }
+      ]
+    },
+    {
+      "command": "lists routing",
+      "verb": "lists.routing",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Routing-board counts for the list.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/lists/[id]/exa-agent/routing"
+        }
+      ]
+    },
+    {
+      "command": "candidates list",
+      "verb": "candidates.list",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Review-grid candidate rows by status.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/lists/[id]/exa-agent/candidates"
+        }
+      ]
+    },
+    {
+      "command": "accounts detail",
+      "verb": "accounts.detail",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "One candidate account with its columns and cells.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/lists/[id]/exa-agent/account"
+        }
+      ]
+    },
+    {
+      "command": "accounts list",
+      "verb": "accounts.list",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Routed and approved accounts for the list, with filter counts.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/companies/[icpId]"
+        },
+        {
+          "method": "GET",
+          "path": "/api/companies/[icpId]/filter-counts"
+        }
+      ]
+    },
+    {
+      "command": "contacts staged",
+      "verb": "contacts.staged",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Staged-contacts grid feed for the list.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/lists/[id]/exa-agent/contacts"
+        }
+      ]
+    },
+    {
+      "command": "contacts list",
+      "verb": "contacts.list",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Routed and global contacts for the list, with filter counts.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/contacts/[icpId]"
+        },
+        {
+          "method": "GET",
+          "path": "/api/contacts/[icpId]/filter-counts"
+        }
+      ]
+    },
+    {
+      "command": "contacts history",
+      "verb": "contacts.history",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Per-contact touch history and the bulk contact-to-last-sent map.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/contact/[id]/fit-detail"
+        },
+        {
+          "method": "GET",
+          "path": "/api/oneoff-sends/recent"
+        }
+      ]
+    },
+    {
+      "command": "dnc list",
+      "verb": "dnc.list",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Organization and person suppression entries for the client.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/organization-suppressions"
+        },
+        {
+          "method": "GET",
+          "path": "/api/person-suppressions"
+        }
+      ]
+    },
+    {
+      "command": "dnc status",
+      "verb": "dnc.status",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Suppression-CSV pipeline status, unresolved queue and reconciliations.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/suppression-imports"
+        },
+        {
+          "method": "GET",
+          "path": "/api/suppression-imports/[id]/unresolved"
+        },
+        {
+          "method": "GET",
+          "path": "/api/suppression-reconciliations"
+        }
+      ]
+    },
+    {
+      "command": "runs list",
+      "verb": "runs.list",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Run history for the list and per-item outcomes for one run.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/lists/[id]/exa-agent/runs"
+        },
+        {
+          "method": "GET",
+          "path": "/api/lists/[id]/exa-agent/runs/[jobId]"
+        }
+      ]
+    },
+    {
+      "command": "source status",
+      "verb": "source.status",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Contact-sourcing job status — the poll target for contacts.source.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/lists/[id]/exa-agent/contact-source/status"
+        }
+      ]
+    },
+    {
+      "command": "sequences list",
+      "verb": "sequences.list",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Sequences for the list with enrollment counts and reply stats.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/icps/[id]/sequences"
+        }
+      ]
+    },
+    {
+      "command": "sequences get",
+      "verb": "sequences.get",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "One sequence with its steps and status.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/icps/[id]/sequences/[seqId]"
+        }
+      ]
+    },
+    {
+      "command": "replies list",
+      "verb": "replies.list",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Replies for the list. Always ICP-anchored — bare GET /api/replies is off the allowlist.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/replies/[icpId]"
+        }
+      ]
+    },
+    {
+      "command": "replies thread",
+      "verb": "replies.thread",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Full reply thread for client-side CRM glue.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/replies/threads/[thread_id]"
+        }
+      ]
+    },
+    {
+      "command": "stats usage",
+      "verb": "stats.usage",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Plan, current-period usage and tiers for the client.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/billing/usage"
+        }
+      ]
+    },
+    {
+      "command": "stats pipeline",
+      "verb": "stats.pipeline",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Pipeline metrics and home-section counts for the list.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/pipeline/[icpId]"
+        },
+        {
+          "method": "GET",
+          "path": "/api/counts/[icpId]"
+        }
+      ]
+    },
+    {
+      "command": "campaigns instantly",
+      "verb": "campaigns.instantly",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Instantly campaigns for the list and per-campaign details.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/instantly/campaigns"
+        },
+        {
+          "method": "GET",
+          "path": "/api/instantly-campaigns/[id]/details"
+        }
+      ]
+    },
+    {
+      "command": "export accounts",
+      "verb": "export.accounts",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Accounts CSV export, suppression-filtered or reporting-history.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/export/[icpId]"
+        }
+      ]
+    },
+    {
+      "command": "export campaign",
+      "verb": "export.campaign",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "The D2-A campaign bundle: accounts, contacts, sequence, events, replies and stats as files.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/icps/[id]/sequences"
+        },
+        {
+          "method": "GET",
+          "path": "/api/contacts/[icpId]"
+        },
+        {
+          "method": "GET",
+          "path": "/api/replies/[icpId]"
+        },
+        {
+          "method": "GET",
+          "path": "/api/agent/lists/[id]/events"
+        },
+        {
+          "method": "GET",
+          "path": "/api/export/[icpId]"
+        },
+        {
+          "method": "GET",
+          "path": "/api/billing/usage"
+        }
+      ]
+    },
+    {
+      "command": "activity tail",
+      "verb": "activity.tail",
+      "pack": "read",
+      "paid": false,
+      "quote": false,
+      "summary": "Tail the companion activity feed for the list.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/lists/[id]/exa-agent/activity"
+        }
+      ]
+    },
+    {
+      "command": "lists create",
+      "verb": "lists.create",
+      "pack": "build",
+      "paid": false,
+      "quote": false,
+      "summary": "Create a list with its must-haves and nice-to-haves.",
+      "guidance": "Criteria coaching: keep 2–3 must-haves — more densify the synthesized query past its 2-to-4 structural-qualifier cap and multiply per-account columns, which collapses recall. Move the rest to nice-to-haves; they become enrichment columns you fill and filter on after the run. Do not restate the search query as a must-have, and remember disqualifiers (\"not a subsidiary\") are high-value. Show the draft and the quote before spending. Full guide: agent://guide, or `predictable guide criteria`.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/onboard"
+        }
+      ]
+    },
+    {
+      "command": "search estimate",
+      "verb": "search.estimate",
+      "pack": "build",
+      "paid": false,
+      "quote": false,
+      "summary": "Client-safe target and credit estimate for a base search.",
+      "guidance": "Criteria coaching: keep 2–3 must-haves — more densify the synthesized query past its 2-to-4 structural-qualifier cap and multiply per-account columns, which collapses recall. Move the rest to nice-to-haves; they become enrichment columns you fill and filter on after the run. Do not restate the search query as a must-have, and remember disqualifiers (\"not a subsidiary\") are high-value. Show the draft and the quote before spending. Full guide: agent://guide, or `predictable guide criteria`.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/lists/[id]/exa-agent/base-search"
+        }
+      ]
+    },
+    {
+      "command": "search run",
+      "verb": "search.run",
+      "pack": "build",
+      "paid": true,
+      "quote": true,
+      "summary": "Run the base search. Preview mints the quote; the run consumes it.",
+      "guidance": "Criteria coaching: keep 2–3 must-haves — more densify the synthesized query past its 2-to-4 structural-qualifier cap and multiply per-account columns, which collapses recall. Move the rest to nice-to-haves; they become enrichment columns you fill and filter on after the run. Do not restate the search query as a must-have, and remember disqualifiers (\"not a subsidiary\") are high-value. Show the draft and the quote before spending. Full guide: agent://guide, or `predictable guide criteria`.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/base-search/preview"
+        },
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/base-search"
+        }
+      ]
+    },
+    {
+      "command": "alumni estimate",
+      "verb": "alumni.estimate",
+      "pack": "build",
+      "paid": false,
+      "quote": false,
+      "summary": "People-count probe and rate estimate for an alumni pull.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/alumni-estimate"
+        }
+      ]
+    },
+    {
+      "command": "alumni pull",
+      "verb": "alumni.pull",
+      "pack": "build",
+      "paid": true,
+      "quote": true,
+      "summary": "Run an alumni search job. Preview mints the quote; the pull consumes it.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/alumni-pull/preview"
+        },
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/alumni-pull"
+        }
+      ]
+    },
+    {
+      "command": "columns manage",
+      "verb": "columns.manage",
+      "pack": "build",
+      "paid": false,
+      "quote": false,
+      "summary": "Read, create, edit and delete column definitions. Definitions cost nothing.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/lists/[id]/exa-agent/columns"
+        },
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/columns"
+        },
+        {
+          "method": "PATCH",
+          "path": "/api/lists/[id]/exa-agent/columns/[columnId]"
+        },
+        {
+          "method": "DELETE",
+          "path": "/api/lists/[id]/exa-agent/columns/[columnId]"
+        }
+      ]
+    },
+    {
+      "command": "columns assist",
+      "verb": "columns.assist",
+      "pack": "build",
+      "paid": false,
+      "quote": false,
+      "summary": "Synthesize a column prompt or infer its type. Persists nothing.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/column-prompt"
+        },
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/column-type"
+        }
+      ]
+    },
+    {
+      "command": "columns fill",
+      "verb": "columns.fill",
+      "pack": "build",
+      "paid": true,
+      "quote": true,
+      "summary": "Fill a column across candidates. Preview snapshots the workset; the fill consumes it.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/columns/[columnId]/fill/preview"
+        },
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/columns/[columnId]/fill"
+        }
+      ]
+    },
+    {
+      "command": "contacts source",
+      "verb": "contacts.source",
+      "pack": "build",
+      "paid": true,
+      "quote": true,
+      "summary": "Source contacts for staged accounts. Preview is the one server-side spend authorization.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/contact-source/preview"
+        },
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/contact-source"
+        },
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/contact-source/retry"
+        },
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/contact-source/reset"
+        }
+      ]
+    },
+    {
+      "command": "emails enrich",
+      "verb": "emails.enrich",
+      "pack": "build",
+      "paid": true,
+      "quote": true,
+      "summary": "Enrich staged contacts with email addresses. Quote-mandatory for every principal.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/email-enrichment/preview"
+        },
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/email-enrichment"
+        }
+      ]
+    },
+    {
+      "command": "import csv",
+      "verb": "import.csv",
+      "pack": "build",
+      "paid": false,
+      "quote": false,
+      "summary": "Staged CSV ingest: create a session, stage rows, commit quarantined, then release.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/agent/import-sessions"
+        },
+        {
+          "method": "GET",
+          "path": "/api/agent/import-sessions/[sessionId]"
+        },
+        {
+          "method": "POST",
+          "path": "/api/agent/import-sessions/[sessionId]/rows"
+        },
+        {
+          "method": "POST",
+          "path": "/api/agent/import-sessions/[sessionId]/commit"
+        },
+        {
+          "method": "POST",
+          "path": "/api/agent/import-sessions/[sessionId]/release"
+        }
+      ]
+    },
+    {
+      "command": "dnc add",
+      "verb": "dnc.add",
+      "pack": "build",
+      "paid": false,
+      "quote": false,
+      "summary": "Add or reactivate organization and person suppression entries.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/organization-suppressions"
+        },
+        {
+          "method": "PATCH",
+          "path": "/api/organization-suppressions"
+        },
+        {
+          "method": "POST",
+          "path": "/api/person-suppressions"
+        },
+        {
+          "method": "PATCH",
+          "path": "/api/person-suppressions"
+        }
+      ]
+    },
+    {
+      "command": "dnc import",
+      "verb": "dnc.import",
+      "pack": "build",
+      "paid": false,
+      "quote": false,
+      "summary": "Run the suppression-CSV pipeline: upload then confirm.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/suppression-imports"
+        },
+        {
+          "method": "POST",
+          "path": "/api/suppression-imports/[id]"
+        }
+      ]
+    },
+    {
+      "command": "accounts verdict",
+      "verb": "accounts.verdict",
+      "pack": "build",
+      "paid": false,
+      "quote": false,
+      "summary": "Record include or exclude verdicts on accounts.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/feedback/[icpId]"
+        }
+      ]
+    },
+    {
+      "command": "candidates discard",
+      "verb": "candidates.discard",
+      "pack": "build",
+      "paid": false,
+      "quote": false,
+      "summary": "Discard or restore a candidate. Free and reversible.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/discard"
+        }
+      ]
+    },
+    {
+      "command": "contacts route",
+      "verb": "contacts.route",
+      "pack": "route",
+      "paid": false,
+      "quote": false,
+      "summary": "Promote selected staged contacts.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/contact-route"
+        }
+      ]
+    },
+    {
+      "command": "contacts enroll",
+      "verb": "contacts.enroll",
+      "pack": "route",
+      "paid": false,
+      "quote": false,
+      "summary": "Enroll contacts into a sequence, optionally from a future start time.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/contact-enroll"
+        }
+      ]
+    },
+    {
+      "command": "push run",
+      "verb": "push.run",
+      "pack": "route",
+      "paid": false,
+      "quote": false,
+      "summary": "The one final execution. Gated server-side on NEXT_PUBLIC_EXA_AGENT_PROMOTE_AT_PUSH — the file existing is not the surface being live (§10k).",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/push"
+        }
+      ]
+    },
+    {
+      "command": "push instantly",
+      "verb": "push.instantly",
+      "pack": "route",
+      "paid": false,
+      "quote": false,
+      "summary": "Route staged contacts into an Instantly campaign.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/route-instantly"
+        }
+      ]
+    },
+    {
+      "command": "push ctd",
+      "verb": "push.ctd",
+      "pack": "route",
+      "paid": false,
+      "quote": false,
+      "summary": "Route staged contacts through the CTD action.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/route-ctd"
+        }
+      ]
+    },
+    {
+      "command": "destination map",
+      "verb": "destination.map",
+      "pack": "route",
+      "paid": false,
+      "quote": false,
+      "summary": "Read, write or clear the list destination map. Executes nothing.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/lists/[id]/exa-agent/destination-map"
+        },
+        {
+          "method": "PUT",
+          "path": "/api/lists/[id]/exa-agent/destination-map"
+        },
+        {
+          "method": "DELETE",
+          "path": "/api/lists/[id]/exa-agent/destination-map"
+        }
+      ]
+    },
+    {
+      "command": "autoroute rules",
+      "verb": "autoroute.rules",
+      "pack": "route",
+      "paid": false,
+      "quote": false,
+      "summary": "Declare auto-route rules. Declaration only — the outbox processor enrolls.",
+      "routes": [
+        {
+          "method": "GET",
+          "path": "/api/lists/[id]/exa-agent/auto-route-rules"
+        },
+        {
+          "method": "POST",
+          "path": "/api/lists/[id]/exa-agent/auto-route-rules"
+        },
+        {
+          "method": "PATCH",
+          "path": "/api/lists/[id]/exa-agent/auto-route-rules"
+        }
+      ]
+    },
+    {
+      "command": "sequences create",
+      "verb": "sequences.create",
+      "pack": "route",
+      "paid": false,
+      "quote": false,
+      "summary": "Create a sequence. Drafts only.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/icps/[id]/sequences"
+        }
+      ]
+    },
+    {
+      "command": "sequences edit",
+      "verb": "sequences.edit",
+      "pack": "route",
+      "paid": false,
+      "quote": false,
+      "summary": "Edit sequence steps, name or daily cap. Live edits are forward-only.",
+      "routes": [
+        {
+          "method": "PATCH",
+          "path": "/api/icps/[id]/sequences/[seqId]"
+        }
+      ]
+    },
+    {
+      "command": "sequences publish",
+      "verb": "sequences.publish",
+      "pack": "route",
+      "paid": false,
+      "quote": false,
+      "summary": "Publish a draft sequence live.",
+      "routes": [
+        {
+          "method": "PATCH",
+          "path": "/api/icps/[id]/sequences/[seqId]"
+        }
+      ]
+    },
+    {
+      "command": "sequences lifecycle",
+      "verb": "sequences.lifecycle",
+      "pack": "route",
+      "paid": false,
+      "quote": false,
+      "summary": "Clone, pause, resume or stop a sequence, or remove one enrollment.",
+      "routes": [
+        {
+          "method": "POST",
+          "path": "/api/icps/[id]/sequences/[seqId]/clone"
+        },
+        {
+          "method": "POST",
+          "path": "/api/icps/[id]/sequences/[seqId]/pause"
+        },
+        {
+          "method": "POST",
+          "path": "/api/icps/[id]/sequences/[seqId]/resume"
+        },
+        {
+          "method": "POST",
+          "path": "/api/icps/[id]/sequences/[seqId]/stop"
+        },
+        {
+          "method": "DELETE",
+          "path": "/api/icps/[id]/sequences/[seqId]/enrollments/[enrollmentId]"
+        }
+      ]
+    }
+  ],
+  "guideTopics": [
+    "criteria"
+  ]
+}