@dench.com/cli 3.5.6-staging.344 → 3.6.0-staging.356

package/lib/app-sdk-catalog.generated.ts

@@ -83,6 +83,23 @@ export type AppSdkScope = (typeof APP_SDK_SCOPES)[number];
 
 /** Every public /api/v1 operation reachable through dench.api.call. */
 export const APP_SDK_OPERATIONS: readonly AppSdkOperationInfo[] = [
+  {"id":"campaigns.drafts.create","group":"campaigns","summary":"Create an idempotent empty campaign draft with the caller's available sender pools. Does not launch or send.","cli":"dench campaign draft","method":"POST","path":"/campaigns/drafts","permission":"campaigns:write","pathParams":[]},
+  {"id":"campaigns.audience.search","group":"campaigns","summary":"Search people by filters without adding CRM records or campaign recipients. Search credits apply; this is not a free provider preview.","cli":"dench campaign search","method":"POST","path":"/campaigns/audience/search","permission":"campaigns:write","pathParams":[]},
+  {"id":"campaigns.people.addFromSearch","group":"campaigns","summary":"Search and add up to 50 people to an existing campaign. New identities become Leads. Search credits apply; use nextPageToken for another page.","cli":"dench campaign add --search","method":"POST","path":"/campaigns/{sequenceId}/people/search","permission":"campaigns:write","pathParams":["sequenceId"]},
+  {"id":"campaigns.people.addBatch","group":"campaigns","summary":"Add up to 50 selected recipients without another search. Deduplicates, applies suppression, and preserves the campaign's launch state.","cli":"dench campaign add --people-file","method":"POST","path":"/campaigns/{sequenceId}/people/batch","permission":"campaigns:write","pathParams":["sequenceId"]},
+  {"id":"campaigns.sources.get","group":"campaigns","summary":"Read a campaign's saved signal source, targeting and schedule.","cli":"dench campaign sources get","method":"GET","path":"/campaigns/{sequenceId}/sources","permission":"campaigns:read","pathParams":["sequenceId"]},
+  {"id":"campaigns.sources.signals","group":"campaigns","summary":"Read signal choices, suggested terms and current source configuration.","cli":"dench campaign sources signals","method":"GET","path":"/campaigns/{sequenceId}/sources/signals","permission":"campaigns:read","pathParams":["sequenceId"]},
+  {"id":"campaigns.sources.update","group":"campaigns","summary":"Update source cadence, pause/resume, targeting, signals or terms. Active sources may perform billable future work.","cli":"dench campaign sources set","method":"PATCH","path":"/campaigns/{sequenceId}/sources","permission":"campaigns:write","pathParams":["sequenceId"]},
+  {"id":"campaigns.sources.preview","group":"campaigns","summary":"Preview a signal source using its current audience. Provider credits may apply; does not enroll people.","cli":"dench campaign sources preview","method":"POST","path":"/campaigns/{sequenceId}/sources/preview","permission":"campaigns:write","pathParams":["sequenceId"]},
+  {"id":"campaigns.builder.profile","group":"campaigns","summary":"Read the company profile and suggested campaign audience.","cli":"dench campaign builder profile","method":"GET","path":"/campaigns/builder/profile","permission":"campaigns:read","pathParams":[]},
+  {"id":"campaigns.builder.save","group":"campaigns","summary":"Save a signal campaign's audience, signals and terms idempotently. Does not start a build.","cli":"dench campaign builder save","method":"POST","path":"/campaigns/builder/drafts","permission":"campaigns:write","pathParams":[]},
+  {"id":"campaigns.builder.get","group":"campaigns","summary":"Read signal build progress, preview people, messages and errors.","cli":"dench campaign builder get","method":"GET","path":"/campaigns/builder/drafts/{draftId}","permission":"campaigns:read","pathParams":["draftId"]},
+  {"id":"campaigns.builder.build","group":"campaigns","summary":"Start the same billable signal/audience/message build used by the UI; poll the draft for progress.","cli":"dench campaign builder build","method":"POST","path":"/campaigns/builder/drafts/{draftId}/build","permission":"campaigns:write","pathParams":["draftId"]},
+  {"id":"campaigns.builder.create","group":"campaigns","summary":"Create a campaign from a reviewed signal draft. Does not launch the campaign.","cli":"dench campaign builder create","method":"POST","path":"/campaigns/builder/drafts/{draftId}/create","permission":"campaigns:write","pathParams":["draftId"]},
+  {"id":"campaigns.builder.opener","group":"campaigns","summary":"Edit or reset one preview person's opening line before creating the campaign.","cli":"dench campaign builder opener","method":"PUT","path":"/campaigns/builder/drafts/{draftId}/people/{leadId}/opener","permission":"campaigns:write","pathParams":["draftId","leadId"]},
+  {"id":"campaigns.builder.autofill","group":"campaigns","summary":"Turn an audience description into targeting filters. AI credits apply.","cli":"dench campaign builder autofill","method":"POST","path":"/campaigns/builder/autofill","permission":"campaigns:write","pathParams":[]},
+  {"id":"campaigns.builder.terms","group":"campaigns","summary":"Suggest signal terms for the selected audience. AI credits apply.","cli":"dench campaign builder terms","method":"POST","path":"/campaigns/builder/terms","permission":"campaigns:write","pathParams":[]},
+  {"id":"campaigns.builder.estimate","group":"campaigns","summary":"Estimate audience or weekly signal volume using the UI's cached estimator. Provider credits may apply.","cli":"dench campaign builder estimate","method":"POST","path":"/campaigns/builder/estimate","permission":"campaigns:write","pathParams":[]},
   {"id":"commands.list","group":"meta","summary":"List all CLI/API operations and parity classifications.","cli":"dench help","method":"GET","path":"/commands","permission":null,"pathParams":[]},
   {"id":"auth.signin.create","group":"auth","summary":"Create an agent sign-in request.","cli":"dench signin","method":"POST","path":"/auth/signin-requests","permission":"auth:write","pathParams":[]},
   {"id":"auth.signin.poll","group":"auth","summary":"Poll an agent sign-in request until approval.","cli":"dench signin","method":"POST","path":"/auth/signin-requests/{requestId}/poll","permission":"auth:write","pathParams":["requestId"]},
@@ -330,23 +347,42 @@ export const APP_SDK_OPERATIONS: readonly AppSdkOperationInfo[] = [
   {"id":"email.sequence.enrollment.resume","group":"email","summary":"Resume one paused enrollment.","cli":"dench email sequence enrollment resume","method":"POST","path":"/email/sequences/enrollments/{enrollmentId}/resume","permission":"email:write","pathParams":["enrollmentId"]},
   {"id":"email.sequence.enrollment.stop","group":"email","summary":"Stop one enrollment (no further steps send).","cli":"dench email sequence enrollment stop","method":"POST","path":"/email/sequences/enrollments/{enrollmentId}/stop","permission":"email:write","pathParams":["enrollmentId"]},
   {"id":"campaigns.accounts.linkedin","group":"campaigns","summary":"Discover LinkedIn sender ids, labels, availability and remaining capacity visible to the acting workspace member. Never returns provider credentials.","cli":"dench campaign accounts","method":"GET","path":"/campaigns/accounts/linkedin","permission":"campaigns:read","pathParams":[]},
+  {"id":"campaigns.accounts.email","group":"campaigns","summary":"Discover the mailboxes the acting workspace member can send campaign email from: ids for emailMailboxAccountIds, status, warm-up state and when it is done, the daily cold-email cap and what is left today. Never returns provider credentials.","cli":"dench campaign accounts","method":"GET","path":"/campaigns/accounts/email","permission":"campaigns:read","pathParams":[]},
   {"id":"campaigns.list","group":"campaigns","summary":"List outreach campaigns (archived ones on request).","cli":"dench campaign list","method":"GET","path":"/campaigns","permission":"campaigns:read","pathParams":[]},
   {"id":"campaigns.create","group":"campaigns","summary":"Create a draft outreach campaign with email and LinkedIn sender pools and a business-hours send window in the given timezone.","cli":"dench campaign create","method":"POST","path":"/campaigns","permission":"campaigns:write","pathParams":[]},
+  {"id":"campaigns.duplicate","group":"campaigns","summary":"Copy a campaign into a new draft named \"<name> copy\": the same steps, schedule, sender pools and personalized lines, its lead source paused, and no people. To reach more than 300 people, duplicate and add the next page of the search to the copy.","cli":"dench campaign duplicate","method":"POST","path":"/campaigns/{sequenceId}/duplicate","permission":"campaigns:write","pathParams":["sequenceId"]},
   {"id":"campaigns.get","group":"campaigns","summary":"Read a campaign: settings, steps, people, their current step and hold, last touches, linked leads.","cli":"dench campaign get","method":"GET","path":"/campaigns/{sequenceId}","permission":"campaigns:read","pathParams":["sequenceId"]},
   {"id":"campaigns.analytics","group":"campaigns","summary":"Campaign funnel: enrolled, contacted, invited, accepted, messaged, replied, opens and clicks.","cli":"dench campaign get","method":"GET","path":"/campaigns/{sequenceId}/analytics","permission":"campaigns:read","pathParams":["sequenceId"]},
   {"id":"campaigns.live","group":"campaigns","summary":"What the campaign is doing now, what comes next and when, and why it is holding.","cli":"dench campaign get","method":"GET","path":"/campaigns/{sequenceId}/live","permission":"campaigns:read","pathParams":["sequenceId"]},
+  {"id":"campaigns.pipeline","group":"campaigns","summary":"Where a campaign's people sit in the workspace's lead pipeline right now: each lead Status in order with how many enrolled leads are at it, and how many have no lead or a status outside the pipeline.","cli":"dench campaign pipeline","method":"GET","path":"/campaigns/{sequenceId}/pipeline","permission":"campaigns:read","pathParams":["sequenceId"]},
   {"id":"campaigns.update","group":"campaigns","summary":"Change a campaign's name, sender pools, send windows, daily email cap, stop-on-reply, start or end. Works until archived; existing conversations keep their assigned sender.","cli":"dench campaign set","method":"PATCH","path":"/campaigns/{sequenceId}","permission":"campaigns:write","pathParams":["sequenceId"]},
-  {"id":"campaigns.steps.replace","group":"campaigns","summary":"Replace every step of a draft campaign (email, wait, LinkedIn visit, connection request, message). Configure sender pools on the campaign; step sender ids are legacy-only.","cli":"dench campaign steps set","method":"PUT","path":"/campaigns/{sequenceId}/steps","permission":"campaigns:write","pathParams":["sequenceId"]},
+  {"id":"campaigns.steps.replace","group":"campaigns","summary":"Replace every step of a draft campaign (email, wait, LinkedIn visit, connection request, message, post reaction, InMail). Steps are checked first: a field the step type would drop, missing text or {TOKEN} single braces are rejected, not saved. Configure sender pools on the campaign; step sender ids are legacy-only.","cli":"dench campaign steps set","method":"PUT","path":"/campaigns/{sequenceId}/steps","permission":"campaigns:write","pathParams":["sequenceId"]},
+  {"id":"campaigns.steps.update","group":"campaigns","summary":"Edit the text, waits and conditions of a launched (or paused) campaign's steps in place. Each step keeps its id, type and place; pass the stepId and the updatedAt you read, and only the fields you change. Messages already sent or being prepared keep their text; drafts use campaigns.steps.replace.","cli":"dench campaign steps edit","method":"PATCH","path":"/campaigns/{sequenceId}/steps","permission":"campaigns:write","pathParams":["sequenceId"]},
+  {"id":"campaigns.personalization.get","group":"campaigns","summary":"Read a campaign's personalized lines (written for each person): their {{keys}} for steps, instructions and fallbacks, how many people have them, and the cost per person.","cli":"dench campaign personalize get","method":"GET","path":"/campaigns/{sequenceId}/personalization","permission":"campaigns:read","pathParams":["sequenceId"]},
+  {"id":"campaigns.personalization.set","group":"campaigns","summary":"Define up to 5 personalized lines (each used as {{key}} in steps) and what you sell. Saving starts writing missing lines for up to 100 people, about 3 cents a person; for more it returns needsConfirm and writes nothing until campaigns.personalization.write is confirmed.","cli":"dench campaign personalize set","method":"PUT","path":"/campaigns/{sequenceId}/personalization","permission":"campaigns:write","pathParams":["sequenceId"]},
+  {"id":"campaigns.personalization.clear","group":"campaigns","summary":"Turn off a campaign's personalized lines and cancel the ones not yet written. Refused while a step still uses one of the {{keys}}.","cli":"dench campaign personalize clear","method":"DELETE","path":"/campaigns/{sequenceId}/personalization","permission":"campaigns:write","pathParams":["sequenceId"]},
+  {"id":"campaigns.personalization.write","group":"campaigns","summary":"Write personalized lines for the people missing them (mode missing) or rewrite everyone's (mode all). Rewriting everyone or more than 100 people returns needsConfirm and the estimate until called with confirmed: true.","cli":"dench campaign personalize write","method":"POST","path":"/campaigns/{sequenceId}/personalization/write","permission":"campaigns:write","pathParams":["sequenceId"]},
+  {"id":"campaigns.personalization.edit","group":"campaigns","summary":"Set one person's personalized line by hand; an empty value undoes the edit. Braces are removed and text past the line's length is cut.","cli":"dench campaign personalize edit","method":"PUT","path":"/campaigns/people/{enrollmentId}/personalization","permission":"campaigns:write","pathParams":["enrollmentId"]},
+  {"id":"campaigns.personalization.rewrite","group":"campaigns","summary":"Write a fresh personalized line for one person: one key, or all of their lines when key is left out. About 3 cents.","cli":"dench campaign personalize rewrite","method":"POST","path":"/campaigns/people/{enrollmentId}/personalization/rewrite","permission":"campaigns:write","pathParams":["enrollmentId"]},
   {"id":"campaigns.people.addFromCrm","group":"campaigns","summary":"Add CRM records (up to 100 ids per call) to a campaign; returns how many were added and why others were skipped.","cli":"dench campaign add","method":"POST","path":"/campaigns/{sequenceId}/people","permission":"campaigns:write","pathParams":["sequenceId"]},
   {"id":"campaigns.people.add","group":"campaigns","summary":"Add one person by email and/or LinkedIn profile URL.","cli":"dench campaign add --name","method":"POST","path":"/campaigns/{sequenceId}/person","permission":"campaigns:write","pathParams":["sequenceId"]},
-  {"id":"campaigns.launch.preview","group":"campaigns","summary":"Launch readiness: blockers grouped by problem, warnings, and the fingerprint `launch` requires.","cli":"dench campaign launch","method":"GET","path":"/campaigns/{sequenceId}/launch","permission":"campaigns:read","pathParams":["sequenceId"]},
+  {"id":"campaigns.preview","group":"campaigns","summary":"Show the message one person gets at one email or LinkedIn step, with their fields and personalized lines filled in: subject, body, sender, recipient, merge fields still missing, warnings, and why the step would be skipped. Nothing is sent, prepared or charged.","cli":"dench campaign preview","method":"GET","path":"/campaigns/{sequenceId}/preview","permission":"campaigns:read","pathParams":["sequenceId"]},
+  {"id":"campaigns.launch.preview","group":"campaigns","summary":"Launch readiness without launching: blockers grouped by problem, warnings, and the fingerprint `launch` requires.","cli":"dench campaign launch --check","method":"GET","path":"/campaigns/{sequenceId}/launch","permission":"campaigns:read","pathParams":["sequenceId"]},
   {"id":"campaigns.launch","group":"campaigns","summary":"Launch a ready draft. Pass the fingerprint from the preview and acknowledge the LinkedIn notice when LinkedIn steps exist.","cli":"dench campaign launch","method":"POST","path":"/campaigns/{sequenceId}/launch","permission":"campaigns:write","pathParams":["sequenceId"]},
   {"id":"campaigns.pause","group":"campaigns","summary":"Pause an active campaign.","cli":"dench campaign pause","method":"POST","path":"/campaigns/{sequenceId}/pause","permission":"campaigns:write","pathParams":["sequenceId"]},
   {"id":"campaigns.resume","group":"campaigns","summary":"Resume a paused campaign.","cli":"dench campaign resume","method":"POST","path":"/campaigns/{sequenceId}/resume","permission":"campaigns:write","pathParams":["sequenceId"]},
-  {"id":"campaigns.archive","group":"campaigns","summary":"Archive a campaign and stop everyone still in flight.","cli":"dench campaign archive","method":"POST","path":"/campaigns/{sequenceId}/archive","permission":"campaigns:write","pathParams":["sequenceId"]},
+  {"id":"campaigns.archive","group":"campaigns","summary":"Archive a campaign and stop everyone still in flight. This is the app's Delete: campaigns are never erased, and their people, leads and activity stay.","cli":"dench campaign archive","method":"POST","path":"/campaigns/{sequenceId}/archive","permission":"campaigns:write","pathParams":["sequenceId"]},
   {"id":"campaigns.events","group":"campaigns","summary":"The campaign's activity log, newest first (sent, accepted, replied, skipped, failed, paused, stopped).","cli":"dench campaign events","method":"GET","path":"/campaigns/{sequenceId}/events","permission":"campaigns:read","pathParams":["sequenceId"]},
   {"id":"campaigns.people.stop","group":"campaigns","summary":"Stop one person: nothing more is sent to them from this campaign.","cli":"dench campaign stop","method":"POST","path":"/campaigns/people/{enrollmentId}/stop","permission":"campaigns:write","pathParams":["enrollmentId"]},
   {"id":"campaigns.people.resume","group":"campaigns","summary":"Resume one paused person in an active campaign.","cli":"dench campaign resume-person","method":"POST","path":"/campaigns/people/{enrollmentId}/resume","permission":"campaigns:write","pathParams":["enrollmentId"]},
+  {"id":"campaigns.people.setEmail","group":"campaigns","summary":"Give a person in a draft campaign a new or corrected email address; their linked CRM record gets it too. Only before launch; another person in the campaign can't share it.","cli":"dench campaign person set --email","method":"PUT","path":"/campaigns/people/{enrollmentId}/email","permission":"campaigns:write","pathParams":["enrollmentId"]},
+  {"id":"campaigns.people.setLinkedin","group":"campaigns","summary":"Give a person in a draft campaign a new or corrected LinkedIn profile URL; their linked CRM record gets it too. Only before launch.","cli":"dench campaign person set --linkedin-url","method":"PUT","path":"/campaigns/people/{enrollmentId}/linkedin","permission":"campaigns:write","pathParams":["enrollmentId"]},
+  {"id":"campaigns.people.setField","group":"campaigns","summary":"Fill or fix one {{merge field}} for a person in a draft campaign, e.g. a missing Company that blocks launch; a matching column on their CRM record is updated too. Only before launch; written personalized lines are not merge fields and can't be set here.","cli":"dench campaign person set --field","method":"PUT","path":"/campaigns/people/{enrollmentId}/fields","permission":"campaigns:write","pathParams":["enrollmentId"]},
+  {"id":"campaigns.people.resumeAll","group":"campaigns","summary":"Resume every paused person in an active campaign at once, e.g. after a sending account is reconnected. Returns how many were resumed.","cli":"dench campaign resume-person --all","method":"POST","path":"/campaigns/{sequenceId}/people/resume","permission":"campaigns:write","pathParams":["sequenceId"]},
+  {"id":"campaigns.people.sync","group":"campaigns","summary":"Fill each unfinished person's empty email, LinkedIn URL, name and merge fields from their linked CRM record, e.g. after enriching the records. Never overwrites a value the campaign already has; returns how many people changed.","cli":"dench campaign sync","method":"POST","path":"/campaigns/{sequenceId}/people/sync","permission":"campaigns:write","pathParams":["sequenceId"]},
+  {"id":"campaigns.people.forRecord","group":"campaigns","summary":"The campaigns a CRM record (a person or a lead) is in, newest first, with the person's status in each and the accounts that send to them.","cli":"dench campaign where","method":"GET","path":"/campaigns/by-record/{entryId}","permission":"campaigns:read","pathParams":["entryId"]},
+  {"id":"campaigns.people.timeline","group":"campaigns","summary":"Everything a campaign did for one person, step by step: what was sent (subject and text), whether it was opened or clicked, what was skipped and why, waits, failures and retries.","cli":"dench campaign person show","method":"GET","path":"/campaigns/people/{enrollmentId}/timeline","permission":"campaigns:read","pathParams":["enrollmentId"]},
+  {"id":"campaigns.people.remove","group":"campaigns","summary":"Remove a person who was never contacted from a draft campaign. Frees their place in the 300-person cap and keeps the draft launchable; stop anyone already contacted instead.","cli":"dench campaign remove","method":"DELETE","path":"/campaigns/people/{enrollmentId}","permission":"campaigns:write","pathParams":["enrollmentId"]},
   {"id":"cron.list","group":"routines","summary":"List routines.","cli":"dench cron list","method":"GET","path":"/routines","permission":"cron:schedule","pathParams":[]},
   {"id":"cron.history","group":"routines","summary":"List routine run history.","cli":"dench cron history","method":"GET","path":"/routines/history","permission":"cron:schedule","pathParams":[]},
   {"id":"cron.get","group":"routines","summary":"Get a routine.","cli":"dench cron get","method":"GET","path":"/routines/{jobId}","permission":"cron:schedule","pathParams":["jobId"]},
@@ -382,7 +418,7 @@ export const APP_SDK_OPERATIONS: readonly AppSdkOperationInfo[] = [
   {"id":"web.brandSearch","group":"gateway","summary":"Autocomplete brand names.","cli":"dench web brand-search","method":"POST","path":"/context/brand-search","permission":"web:read","pathParams":[]},
   {"id":"image.generate","group":"gateway","summary":"Generate an image through the Dench gateway.","cli":"dench image generate","method":"POST","path":"/images/generations","permission":"image:write","pathParams":[]},
   {"id":"image.edit","group":"gateway","summary":"Edit an image through the Dench gateway.","cli":"dench image edit","method":"POST","path":"/images/edits","permission":"image:write","pathParams":[]},
-  {"id":"integrations.list","group":"gateway","summary":"List every connected integration — Composio apps plus the Gmail, Outlook, Calendar, LinkedIn and Slack connections Dench brokers itself (Slack rows report source: dench).","cli":"dench integrations","method":"GET","path":"/integrations","permission":"integrations:read","pathParams":[]},
+  {"id":"integrations.list","group":"gateway","summary":"List every connected integration — connected apps plus the Gmail, Outlook, Calendar, LinkedIn and Slack connections Dench provides itself (Slack rows report source: dench).","cli":"dench integrations","method":"GET","path":"/integrations","permission":"integrations:read","pathParams":[]},
   {"id":"apps.list","group":"apps","summary":"List installed App Store apps in the workspace.","cli":"dench apps list","method":"GET","path":"/apps","permission":"apps:read","pathParams":[]},
   {"id":"apps.gallery","group":"apps","summary":"List Discover listings — Official (Dench) + Community shelves.","cli":"dench apps gallery","method":"GET","path":"/apps/gallery","permission":"apps:read","pathParams":[]},
   {"id":"apps.create","group":"apps","summary":"Scaffold and register a new App Store app.","cli":"dench apps create","method":"POST","path":"/apps","permission":"apps:write","pathParams":[]},
@@ -396,9 +432,9 @@ export const APP_SDK_OPERATIONS: readonly AppSdkOperationInfo[] = [
   {"id":"apps.webhooks.poll","group":"apps","summary":"Read events an app webhook received since a timestamp.","cli":"dench apps webhooks poll","method":"GET","path":"/apps/{slug}/webhooks/{hookName}/events","permission":"webhooks:receive","pathParams":["slug","hookName"]},
   {"id":"apps.webhooks.delete","group":"apps","summary":"Remove an app webhook and every event it stored.","cli":"dench apps webhooks delete","method":"DELETE","path":"/apps/{slug}/webhooks/{hookName}","permission":"webhooks:receive","pathParams":["slug","hookName"]},
   {"id":"tool.status","group":"gateway","summary":"List connected tool accounts.","cli":"dench tool status","method":"GET","path":"/tools/status","permission":"integrations:read","pathParams":[]},
-  {"id":"tool.connect","group":"gateway","summary":"Create a tool OAuth connection link. Slack is in-house, never Composio: for toolkit slack the CLI prints the first-party install URL (/api/slack/install?slug=<workspace>, org admin) instead of calling this endpoint.","cli":"dench tool connect","method":"POST","path":"/tools/connections","permission":"integrations:write","pathParams":[]},
+  {"id":"tool.connect","group":"gateway","summary":"Create a tool OAuth connection link. Slack is in-house, never a third-party connection: for toolkit slack the CLI prints the first-party install URL (/api/slack/install?slug=<workspace>, org admin) instead of calling this endpoint.","cli":"dench tool connect","method":"POST","path":"/tools/connections","permission":"integrations:write","pathParams":[]},
   {"id":"tool.search","group":"gateway","summary":"Search for external tool actions.","cli":"dench tool search","method":"POST","path":"/tools/search","permission":"integrations:read","pathParams":[]},
-  {"id":"tool.run","group":"gateway","summary":"Run an external tool action. SLACK_* slugs (SLACK_SEND_MESSAGE with Block Kit blocks/buttons, SLACK_FETCH_HISTORY, SLACK_LIST_CHANNELS, …) run through Dench's in-house Slack app install — any channel in the connected workspace — and are always preferred over Composio Slack.","cli":"dench tool run","method":"POST","path":"/tools/run","permission":"integrations:write","pathParams":[]},
+  {"id":"tool.run","group":"gateway","summary":"Run an external tool action. SLACK_* slugs (SLACK_SEND_MESSAGE with Block Kit blocks/buttons, SLACK_FETCH_HISTORY, SLACK_LIST_CHANNELS, …) run through Dench's in-house Slack app install — any channel in the connected workspace — and are always preferred over any third-party Slack connection.","cli":"dench tool run","method":"POST","path":"/tools/run","permission":"integrations:write","pathParams":[]},
   {"id":"tool.disconnect","group":"gateway","summary":"Disconnect an external tool account.","cli":"dench tool disconnect","method":"DELETE","path":"/tools/connections/{connectionId}","permission":"integrations:write","pathParams":["connectionId"]},
   {"id":"tool.labels.list","group":"gateway","summary":"List human names given to connected accounts.","cli":"dench tool labels","method":"GET","path":"/tools/labels","permission":"integrations:read","pathParams":[]},
   {"id":"tool.label.set","group":"gateway","summary":"Name a connected account, or clear its name with an empty string.","cli":"dench tool label","method":"PUT","path":"/tools/connections/{connectionId}/label","permission":"integrations:write","pathParams":["connectionId"]},
@@ -525,12 +561,52 @@ export const APP_SDK_METHODS: Readonly<Record<string, AppSdkMethodInfo>> = {
   "lists.get": {"kind":"op","permission":"lists:read","op":"lists.get","doc":"One saved list with its rows."},
   "lists.rename": {"kind":"op","permission":"lists:write","op":"lists.rename","doc":"Rename a list."},
   "lists.delete": {"kind":"op","permission":"lists:write","op":"lists.delete","doc":"Delete a list."},
+  "campaigns.create": {"kind":"op","permission":"campaigns:write","op":"campaigns.create","doc":"Create a draft campaign."},
+  "campaigns.draft": {"kind":"op","permission":"campaigns:write","op":"campaigns.drafts.create","doc":"Create an idempotent draft with available sender pools."},
+  "campaigns.search": {"kind":"op","permission":"campaigns:write","op":"campaigns.audience.search","doc":"Search people without enrolling them. Search credits apply."},
+  "campaigns.addPeople": {"kind":"op","permission":"campaigns:write","op":"campaigns.people.addBatch","doc":"Add up to 50 selected recipients without running another search."},
+  "campaigns.addFromSearch": {"kind":"op","permission":"campaigns:write","op":"campaigns.people.addFromSearch","doc":"Search and add up to 50 people to an existing campaign."},
+  "campaigns.sources": {"kind":"op","permission":"campaigns:read","op":"campaigns.sources.get","doc":"Read the campaign's lead source."},
+  "campaigns.sourceSignals": {"kind":"op","permission":"campaigns:read","op":"campaigns.sources.signals","doc":"Read signal choices and suggestions."},
+  "campaigns.updateSources": {"kind":"op","permission":"campaigns:write","op":"campaigns.sources.update","doc":"Update targeting, signals, cadence or source status."},
+  "campaigns.previewSignal": {"kind":"op","permission":"campaigns:write","op":"campaigns.sources.preview","doc":"Preview a signal without enrolling people. Provider credits may apply."},
+  "campaigns.profile": {"kind":"op","permission":"campaigns:read","op":"campaigns.builder.profile","doc":"Read suggested campaign targeting."},
+  "campaigns.saveDraft": {"kind":"op","permission":"campaigns:write","op":"campaigns.builder.save","doc":"Save signal-draft targeting and choices."},
+  "campaigns.getDraft": {"kind":"op","permission":"campaigns:read","op":"campaigns.builder.get","doc":"Read preview people, messages and build progress."},
+  "campaigns.buildDraft": {"kind":"op","permission":"campaigns:write","op":"campaigns.builder.build","doc":"Start a billable signal draft build."},
+  "campaigns.createFromDraft": {"kind":"op","permission":"campaigns:write","op":"campaigns.builder.create","doc":"Create a campaign from a reviewed signal draft, without launching."},
+  "campaigns.setDraftOpener": {"kind":"op","permission":"campaigns:write","op":"campaigns.builder.opener","doc":"Edit a preview person's opening line."},
+  "campaigns.autofill": {"kind":"op","permission":"campaigns:write","op":"campaigns.builder.autofill","doc":"Translate a description into targeting. AI credits apply."},
+  "campaigns.suggestTerms": {"kind":"op","permission":"campaigns:write","op":"campaigns.builder.terms","doc":"Suggest signal terms. AI credits apply."},
+  "campaigns.estimate": {"kind":"op","permission":"campaigns:write","op":"campaigns.builder.estimate","doc":"Estimate audience or signal volume."},
+  "campaigns.mailboxes": {"kind":"op","permission":"campaigns:read","op":"campaigns.accounts.email","doc":"Mailboxes campaigns can send from, with warm-up and daily cap."},
+  "campaigns.linkedinAccounts": {"kind":"op","permission":"campaigns:read","op":"campaigns.accounts.linkedin","doc":"LinkedIn accounts campaigns can send from, with capacity."},
   "campaigns.list": {"kind":"op","permission":"campaigns:read","op":"campaigns.list","doc":"LinkedIn / multi-channel outreach campaigns."},
   "campaigns.get": {"kind":"op","permission":"campaigns:read","op":"campaigns.get","doc":"One campaign."},
+  "campaigns.setSteps": {"kind":"op","permission":"campaigns:write","op":"campaigns.steps.replace","doc":"Replace every step of a draft campaign."},
+  "campaigns.editSteps": {"kind":"op","permission":"campaigns:write","op":"campaigns.steps.update","doc":"Edit launched steps in place by stepId and updatedAt."},
+  "campaigns.duplicate": {"kind":"op","permission":"campaigns:write","op":"campaigns.duplicate","doc":"Copy a campaign into a new draft without its people."},
   "campaigns.analytics": {"kind":"op","permission":"campaigns:read","op":"campaigns.analytics","doc":"Campaign funnel numbers."},
   "campaigns.events": {"kind":"op","permission":"campaigns:read","op":"campaigns.events","doc":"Campaign event log."},
   "campaigns.pause": {"kind":"op","permission":"campaigns:write","op":"campaigns.pause","doc":"Pause a campaign."},
   "campaigns.resume": {"kind":"op","permission":"campaigns:write","op":"campaigns.resume","doc":"Resume a campaign."},
+  "campaigns.archive": {"kind":"op","permission":"campaigns:write","op":"campaigns.archive","doc":"Archive (the app's Delete) a campaign; nothing is erased."},
+  "campaigns.previewMessage": {"kind":"op","permission":"campaigns:read","op":"campaigns.preview","doc":"The message one person gets at one step, fields filled in. Sends nothing."},
+  "campaigns.personalization": {"kind":"op","permission":"campaigns:read","op":"campaigns.personalization.get","doc":"Personalized lines, their {{keys}} and how many are written."},
+  "campaigns.setPersonalization": {"kind":"op","permission":"campaigns:write","op":"campaigns.personalization.set","doc":"Define up to 5 personalized lines. Writing them costs credits."},
+  "campaigns.clearPersonalization": {"kind":"op","permission":"campaigns:write","op":"campaigns.personalization.clear","doc":"Turn personalized lines off."},
+  "campaigns.writeLines": {"kind":"op","permission":"campaigns:write","op":"campaigns.personalization.write","doc":"Write missing (or all) personalized lines. Costs credits."},
+  "campaigns.editLine": {"kind":"op","permission":"campaigns:write","op":"campaigns.personalization.edit","doc":"Set one person's personalized line by hand."},
+  "campaigns.rewriteLine": {"kind":"op","permission":"campaigns:write","op":"campaigns.personalization.rewrite","doc":"Write a fresh line for one person. Costs credits."},
+  "campaigns.syncPeople": {"kind":"op","permission":"campaigns:write","op":"campaigns.people.sync","doc":"Fill people's empty contact details from their CRM records."},
+  "campaigns.resumeAllPeople": {"kind":"op","permission":"campaigns:write","op":"campaigns.people.resumeAll","doc":"Resume every paused person in an active campaign."},
+  "campaigns.setPersonEmail": {"kind":"op","permission":"campaigns:write","op":"campaigns.people.setEmail","doc":"Fix a draft person's email address."},
+  "campaigns.setPersonLinkedin": {"kind":"op","permission":"campaigns:write","op":"campaigns.people.setLinkedin","doc":"Fix a draft person's LinkedIn profile URL."},
+  "campaigns.setPersonField": {"kind":"op","permission":"campaigns:write","op":"campaigns.people.setField","doc":"Fill one {{merge field}} for a draft person."},
+  "campaigns.pipeline": {"kind":"op","permission":"campaigns:read","op":"campaigns.pipeline","doc":"Where the campaign's people sit in the lead pipeline."},
+  "campaigns.campaignsForRecord": {"kind":"op","permission":"campaigns:read","op":"campaigns.people.forRecord","doc":"The campaigns a CRM record is in, with its status in each."},
+  "campaigns.personTimeline": {"kind":"op","permission":"campaigns:read","op":"campaigns.people.timeline","doc":"Everything a campaign did for one person, step by step."},
+  "campaigns.removePerson": {"kind":"op","permission":"campaigns:write","op":"campaigns.people.remove","doc":"Remove a never-contacted person from a draft campaign."},
   "email.send": {"kind":"op","permission":"email:write","op":"email.send","doc":"Send one email from a verified identity."},
   "email.messages": {"kind":"op","permission":"email:read","op":"email.message.list","doc":"Sent messages."},
   "email.message": {"kind":"op","permission":"email:read","op":"email.message.get","doc":"One sent message with delivery events."},

package/lib/app-sdk-surface.ts

@@ -629,6 +629,126 @@ export const APP_SDK_SURFACE: AppSdkSurface = {
   },
 
   campaigns: {
+    create: {
+      op: "campaigns.create",
+      doc: "Create a draft campaign.",
+      args: `opts: ${A("campaigns.create")}`,
+      returns: R("campaigns.create"),
+    },
+    draft: {
+      op: "campaigns.drafts.create",
+      doc: "Create an idempotent draft with available sender pools.",
+      args: `opts: ${A("campaigns.drafts.create")}`,
+      returns: R("campaigns.drafts.create"),
+    },
+    search: {
+      op: "campaigns.audience.search",
+      doc: "Search people without enrolling them. Search credits apply.",
+      args: `opts: ${A("campaigns.audience.search")}`,
+      returns: R("campaigns.audience.search"),
+    },
+    addPeople: {
+      op: "campaigns.people.addBatch",
+      doc: "Add up to 50 selected recipients without running another search.",
+      args: `opts: ${A("campaigns.people.addBatch")}`,
+      returns: R("campaigns.people.addBatch"),
+    },
+    addFromSearch: {
+      op: "campaigns.people.addFromSearch",
+      doc: "Search and add up to 50 people to an existing campaign.",
+      args: `opts: ${A("campaigns.people.addFromSearch")}`,
+      returns: R("campaigns.people.addFromSearch"),
+    },
+    sources: {
+      op: "campaigns.sources.get",
+      doc: "Read the campaign's lead source.",
+      args: "sequenceId: string",
+      returns: R("campaigns.sources.get"),
+    },
+    sourceSignals: {
+      op: "campaigns.sources.signals",
+      doc: "Read signal choices and suggestions.",
+      args: "sequenceId: string",
+      returns: R("campaigns.sources.signals"),
+    },
+    updateSources: {
+      op: "campaigns.sources.update",
+      doc: "Update targeting, signals, cadence or source status.",
+      args: `opts: ${A("campaigns.sources.update")}`,
+      returns: R("campaigns.sources.update"),
+    },
+    previewSignal: {
+      op: "campaigns.sources.preview",
+      doc: "Preview a signal without enrolling people. Provider credits may apply.",
+      args: `opts: ${A("campaigns.sources.preview")}`,
+      returns: R("campaigns.sources.preview"),
+    },
+    profile: {
+      op: "campaigns.builder.profile",
+      doc: "Read suggested campaign targeting.",
+      args: "",
+      returns: R("campaigns.builder.profile"),
+    },
+    saveDraft: {
+      op: "campaigns.builder.save",
+      doc: "Save signal-draft targeting and choices.",
+      args: `opts: ${A("campaigns.builder.save")}`,
+      returns: R("campaigns.builder.save"),
+    },
+    getDraft: {
+      op: "campaigns.builder.get",
+      doc: "Read preview people, messages and build progress.",
+      args: "draftId: string",
+      returns: R("campaigns.builder.get"),
+    },
+    buildDraft: {
+      op: "campaigns.builder.build",
+      doc: "Start a billable signal draft build.",
+      args: "draftId: string",
+      returns: R("campaigns.builder.build"),
+    },
+    createFromDraft: {
+      op: "campaigns.builder.create",
+      doc: "Create a campaign from a reviewed signal draft, without launching.",
+      args: `opts: ${A("campaigns.builder.create")}`,
+      returns: R("campaigns.builder.create"),
+    },
+    setDraftOpener: {
+      op: "campaigns.builder.opener",
+      doc: "Edit a preview person's opening line.",
+      args: `opts: ${A("campaigns.builder.opener")}`,
+      returns: R("campaigns.builder.opener"),
+    },
+    autofill: {
+      op: "campaigns.builder.autofill",
+      doc: "Translate a description into targeting. AI credits apply.",
+      args: `opts: ${A("campaigns.builder.autofill")}`,
+      returns: R("campaigns.builder.autofill"),
+    },
+    suggestTerms: {
+      op: "campaigns.builder.terms",
+      doc: "Suggest signal terms. AI credits apply.",
+      args: `opts: ${A("campaigns.builder.terms")}`,
+      returns: R("campaigns.builder.terms"),
+    },
+    estimate: {
+      op: "campaigns.builder.estimate",
+      doc: "Estimate audience or signal volume.",
+      args: `opts: ${A("campaigns.builder.estimate")}`,
+      returns: R("campaigns.builder.estimate"),
+    },
+    mailboxes: {
+      op: "campaigns.accounts.email",
+      doc: "Mailboxes campaigns can send from, with warm-up and daily cap.",
+      args: "",
+      returns: R("campaigns.accounts.email"),
+    },
+    linkedinAccounts: {
+      op: "campaigns.accounts.linkedin",
+      doc: "LinkedIn accounts campaigns can send from, with capacity.",
+      args: "",
+      returns: R("campaigns.accounts.linkedin"),
+    },
     list: {
       op: "campaigns.list",
       doc: "LinkedIn / multi-channel outreach campaigns.",
@@ -641,6 +761,24 @@ export const APP_SDK_SURFACE: AppSdkSurface = {
       args: "sequenceId: string",
       returns: R("campaigns.get"),
     },
+    setSteps: {
+      op: "campaigns.steps.replace",
+      doc: "Replace every step of a draft campaign.",
+      args: `opts: ${A("campaigns.steps.replace")}`,
+      returns: R("campaigns.steps.replace"),
+    },
+    editSteps: {
+      op: "campaigns.steps.update",
+      doc: "Edit launched steps in place by stepId and updatedAt.",
+      args: `opts: ${A("campaigns.steps.update")}`,
+      returns: R("campaigns.steps.update"),
+    },
+    duplicate: {
+      op: "campaigns.duplicate",
+      doc: "Copy a campaign into a new draft without its people.",
+      args: "sequenceId: string",
+      returns: R("campaigns.duplicate"),
+    },
     analytics: {
       op: "campaigns.analytics",
       doc: "Campaign funnel numbers.",
@@ -665,6 +803,108 @@ export const APP_SDK_SURFACE: AppSdkSurface = {
       args: "sequenceId: string",
       returns: R("campaigns.resume"),
     },
+    archive: {
+      op: "campaigns.archive",
+      doc: "Archive (the app's Delete) a campaign; nothing is erased.",
+      args: "sequenceId: string",
+      returns: R("campaigns.archive"),
+    },
+    previewMessage: {
+      op: "campaigns.preview",
+      doc: "The message one person gets at one step, fields filled in. Sends nothing.",
+      args: "sequenceId: string, enrollmentId: string, stepId: string",
+      returns: R("campaigns.preview"),
+    },
+    personalization: {
+      op: "campaigns.personalization.get",
+      doc: "Personalized lines, their {{keys}} and how many are written.",
+      args: "sequenceId: string",
+      returns: R("campaigns.personalization.get"),
+    },
+    setPersonalization: {
+      op: "campaigns.personalization.set",
+      doc: "Define up to 5 personalized lines. Writing them costs credits.",
+      args: `opts: ${A("campaigns.personalization.set")}`,
+      returns: R("campaigns.personalization.set"),
+    },
+    clearPersonalization: {
+      op: "campaigns.personalization.clear",
+      doc: "Turn personalized lines off.",
+      args: "sequenceId: string",
+      returns: R("campaigns.personalization.clear"),
+    },
+    writeLines: {
+      op: "campaigns.personalization.write",
+      doc: "Write missing (or all) personalized lines. Costs credits.",
+      args: `opts: ${A("campaigns.personalization.write")}`,
+      returns: R("campaigns.personalization.write"),
+    },
+    editLine: {
+      op: "campaigns.personalization.edit",
+      doc: "Set one person's personalized line by hand.",
+      args: "enrollmentId: string, key: string, value: string",
+      returns: R("campaigns.personalization.edit"),
+    },
+    rewriteLine: {
+      op: "campaigns.personalization.rewrite",
+      doc: "Write a fresh line for one person. Costs credits.",
+      args: "enrollmentId: string, key?: string",
+      returns: R("campaigns.personalization.rewrite"),
+    },
+    syncPeople: {
+      op: "campaigns.people.sync",
+      doc: "Fill people's empty contact details from their CRM records.",
+      args: "sequenceId: string",
+      returns: R("campaigns.people.sync"),
+    },
+    resumeAllPeople: {
+      op: "campaigns.people.resumeAll",
+      doc: "Resume every paused person in an active campaign.",
+      args: "sequenceId: string",
+      returns: R("campaigns.people.resumeAll"),
+    },
+    setPersonEmail: {
+      op: "campaigns.people.setEmail",
+      doc: "Fix a draft person's email address.",
+      args: "enrollmentId: string, email: string",
+      returns: R("campaigns.people.setEmail"),
+    },
+    setPersonLinkedin: {
+      op: "campaigns.people.setLinkedin",
+      doc: "Fix a draft person's LinkedIn profile URL.",
+      args: "enrollmentId: string, linkedinProfileUrl: string",
+      returns: R("campaigns.people.setLinkedin"),
+    },
+    setPersonField: {
+      op: "campaigns.people.setField",
+      doc: "Fill one {{merge field}} for a draft person.",
+      args: "enrollmentId: string, key: string, value: string",
+      returns: R("campaigns.people.setField"),
+    },
+    pipeline: {
+      op: "campaigns.pipeline",
+      doc: "Where the campaign's people sit in the lead pipeline.",
+      args: "sequenceId: string",
+      returns: R("campaigns.pipeline"),
+    },
+    campaignsForRecord: {
+      op: "campaigns.people.forRecord",
+      doc: "The campaigns a CRM record is in, with its status in each.",
+      args: "entryId: string",
+      returns: R("campaigns.people.forRecord"),
+    },
+    personTimeline: {
+      op: "campaigns.people.timeline",
+      doc: "Everything a campaign did for one person, step by step.",
+      args: "enrollmentId: string",
+      returns: R("campaigns.people.timeline"),
+    },
+    removePerson: {
+      op: "campaigns.people.remove",
+      doc: "Remove a never-contacted person from a draft campaign.",
+      args: "enrollmentId: string",
+      returns: R("campaigns.people.remove"),
+    },
   },
 
   email: {