@anychat-ai/mcp 0.1.1 → 0.2.0

package/dist/tools/definition.js

@@ -11,45 +11,27 @@ const tool_1 = require("../tool");
  * (2026-08-09) — instruction blocks now live on each Playbook as
  * `procedures[]`.
  */
-const agentId = zod_1.z
-    .string()
-    .min(1)
-    .describe('Agent id (the friendly agent id, e.g. "acme-sales-bot")');
-const templateIdArg = (kind, example) => zod_1.z
-    .string()
-    .min(1)
-    .describe(`Catalog ${kind} template id, e.g. "${example}". Discover ids with the catalog tools.`);
+const agentId = zod_1.z.string().min(1);
+const templateIdArg = (kind, example) => zod_1.z.string().min(1).describe(`Catalog ${kind} template id, e.g. "${example}"`);
 const derivedFrom = zod_1.z
     .object({
-    templateId: zod_1.z.string().describe('Catalog template id this content was imported from'),
-    version: zod_1.z.string().describe('Template version at import time'),
+    templateId: zod_1.z.string(),
+    version: zod_1.z.string(),
 })
     .optional()
-    .describe('Provenance pointer for template-derived content (normally left to the API)');
+    .describe('Template provenance; set by import — normally omit');
 // ---------------------------------------------------------------------------
 // Identity
 // ---------------------------------------------------------------------------
 const identityFields = {
-    smallLogoUrl: zod_1.z.string().nullable().optional().describe('URL of the small/square logo'),
-    largeBannerUrl: zod_1.z
-        .string()
-        .nullable()
-        .optional()
-        .describe('URL of the wide banner image'),
-    brandColor: zod_1.z
-        .string()
-        .nullable()
-        .optional()
-        .describe('Brand color as hex, e.g. "#1a73e8"'),
-    contactEmail: zod_1.z.string().nullable().optional().describe('Business contact email'),
-    contactPhone: zod_1.z
-        .string()
-        .nullable()
-        .optional()
-        .describe('Business contact phone (E.164)'),
-    websiteUrl: zod_1.z.string().nullable().optional().describe('Business website URL'),
-    privacyPolicyUrl: zod_1.z.string().nullable().optional().describe('Privacy policy URL'),
-    termsOfServiceUrl: zod_1.z.string().nullable().optional().describe('Terms of service URL'),
+    smallLogoUrl: zod_1.z.string().nullable().optional().describe('Small/square logo URL'),
+    largeBannerUrl: zod_1.z.string().nullable().optional().describe('Wide banner image URL'),
+    brandColor: zod_1.z.string().nullable().optional().describe('Hex, e.g. "#1a73e8"'),
+    contactEmail: zod_1.z.string().nullable().optional(),
+    contactPhone: zod_1.z.string().nullable().optional().describe('E.164'),
+    websiteUrl: zod_1.z.string().nullable().optional(),
+    privacyPolicyUrl: zod_1.z.string().nullable().optional(),
+    termsOfServiceUrl: zod_1.z.string().nullable().optional(),
     contactAvailability: zod_1.z
         .string()
         .nullable()
@@ -59,22 +41,18 @@ const identityFields = {
         .string()
         .nullable()
         .optional()
-        .describe('Short agent-level "who is talking" line composed into every system prompt, e.g. "You are Acme Corp\'s sales development agent." Behavior lives in the Default Playbook, not here.'),
+        .describe('Short "who is talking" line in every system prompt, e.g. "You are Acme Corp\'s sales development agent." Behavior belongs in the Default Playbook.'),
 };
 // ---------------------------------------------------------------------------
 // Objectives
 // ---------------------------------------------------------------------------
 const objectiveItem = zod_1.z
     .object({
-    id: zod_1.z.string().describe('Short slug, unique within the agent, e.g. "qualify-lead"'),
-    name: zod_1.z.string().describe('Display name'),
-    description: zod_1.z
-        .string()
-        .optional()
-        .describe('Human-readable summary (operator-facing)'),
-    body: zod_1.z.string().describe('The prompt fragment the agent uses (LLM-facing)'),
-    priority: zod_1.z.number().describe('Rank; lower wins when objectives compete on a turn'),
-    derivedFrom,
+    id: zod_1.z.string().describe('Slug, unique within the agent, e.g. "qualify-lead"'),
+    name: zod_1.z.string(),
+    description: zod_1.z.string().optional().describe('Operator-facing summary'),
+    body: zod_1.z.string().describe('LLM-facing prompt fragment'),
+    priority: zod_1.z.number().describe('Rank; lower wins when objectives compete'),
 })
     .passthrough();
 // ---------------------------------------------------------------------------
@@ -82,14 +60,8 @@ const objectiveItem = zod_1.z
 // ---------------------------------------------------------------------------
 const guardrailListOp = zod_1.z
     .object({
-    add: zod_1.z
-        .array(zod_1.z.string())
-        .optional()
-        .describe('Strings to append (deduplicated against the current list)'),
-    remove: zod_1.z
-        .array(zod_1.z.string())
-        .optional()
-        .describe('Strings to remove (case-sensitive exact match)'),
+    add: zod_1.z.array(zod_1.z.string()).optional().describe('Append (deduplicated)'),
+    remove: zod_1.z.array(zod_1.z.string()).optional().describe('Remove (exact match)'),
 })
     .optional();
 // ---------------------------------------------------------------------------
@@ -100,39 +72,32 @@ const playbookOutreach = zod_1.z
     eligible: zod_1.z
         .boolean()
         .optional()
-        .describe('Offer this Playbook in the outreach send dialog (isOutbound: true implies eligibility)'),
+        .describe('Offer this Playbook in the outreach send dialog (implied by isOutbound)'),
     openingTemplateId: zod_1.z
         .string()
         .optional()
-        .describe("Id of one of the agent's message templates sent as the deterministic opening when an outreach send selects this Playbook. Must reference an existing message template."),
+        .describe('Existing message template id sent as the deterministic opening'),
     exclusive: zod_1.z
         .boolean()
         .optional()
-        .describe('Outreach-only: the runtime never offers it as a switch_playbook target; a conversation enters it only via an outreach send. Cannot be combined with isDefault.'),
+        .describe('Outreach-only: entered only via an outreach send, never by switch_playbook. Cannot be the default.'),
 })
     .describe('Playbook-first outreach binding');
 const playbookExamples = zod_1.z
     .array(zod_1.z.array(zod_1.z.object({
-    role: zod_1.z.enum(['user', 'agent']).describe('Who is speaking'),
-    content: zod_1.z.string().describe('Message text'),
+    role: zod_1.z.enum(['user', 'agent']),
+    content: zod_1.z.string(),
 })))
     .optional()
-    .describe('Example exchanges — an array of conversations, each an array of turns');
+    .describe('Example conversations, each an array of turns');
 const playbookProcedure = zod_1.z
     .object({
-    id: zod_1.z.string().describe('Short slug, unique within the Playbook'),
-    name: zod_1.z.string().describe('Display name'),
+    id: zod_1.z.string().describe('Slug, unique within the Playbook'),
+    name: zod_1.z.string(),
     description: zod_1.z.string().optional().describe('Operator-facing summary'),
     body: zod_1.z.string().describe('LLM-facing instruction block'),
-    requiredTools: zod_1.z
-        .array(zod_1.z.string())
-        .optional()
-        .describe('Capability actions (catalog tool ids) the procedure uses'),
-    config: zod_1.z
-        .record(zod_1.z.string(), zod_1.z.any())
-        .optional()
-        .describe('Procedure-specific configuration'),
-    derivedFrom,
+    requiredTools: zod_1.z.array(zod_1.z.string()).optional().describe('Catalog tool ids it uses'),
+    config: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
 })
     .passthrough();
 const playbookContentFields = {
@@ -140,58 +105,57 @@ const playbookContentFields = {
     whenToUse: zod_1.z
         .string()
         .optional()
-        .describe('LLM-facing activation context — when the runtime should switch into this Playbook'),
+        .describe('LLM-facing activation context — when to switch into this Playbook'),
     examples: playbookExamples,
-    toolRefs: zod_1.z
-        .array(zod_1.z.string())
-        .optional()
-        .describe('Catalog tool ids this Playbook may invoke'),
+    toolRefs: zod_1.z.array(zod_1.z.string()).optional().describe('Catalog tool ids it may invoke'),
     messageTemplateRefs: zod_1.z
         .array(zod_1.z.string())
         .optional()
-        .describe('Ids of message templates this Playbook may deploy'),
+        .describe('Message template ids it may deploy'),
     isDefault: zod_1.z
         .boolean()
         .optional()
-        .describe('Make this the Default Playbook (exactly one per agent — setting true clears the previous default). Prefer set_default_playbook.'),
+        .describe('Make this the Default Playbook (exactly one per agent). Prefer set_default_playbook.'),
     isOutbound: zod_1.z
         .boolean()
         .optional()
-        .describe('Make this the outreach default (at most one per agent — setting true clears the previous one)'),
+        .describe('Make this the outreach default (at most one per agent)'),
 };
 // ---------------------------------------------------------------------------
 // Message templates
 // ---------------------------------------------------------------------------
 const messageTemplateFields = {
-    name: zod_1.z.string().min(1).describe('Display name'),
+    name: zod_1.z.string().min(1),
     description: zod_1.z.string().optional().describe('Operator-facing description'),
     body: zod_1.z
         .string()
-        .describe('Message text with {slot} placeholders, e.g. "Hi {person.firstName | \\"there\\"} — thanks for stopping by {agent.companyName}." Slots read from person.* (firstName, lastName, fullName, email, phone, company, title, productInterest, source, customFields.<key>) and agent.* (name, companyName, companyDescription, contactEmail, contactPhone, websiteUrl). Inline fallback after a pipe: a quoted literal, or omit-sentence / omit-message / block-send. Bodies with unknown slots are rejected.'),
+        .describe('Text with {slot} placeholders, e.g. "Hi {person.firstName | \\"there\\"} — thanks for stopping by {agent.companyName}." Slots: person.* (firstName, lastName, fullName, email, phone, company, title, productInterest, source, customFields.<key>), agent.* (name, companyName, companyDescription, contactEmail, contactPhone, websiteUrl). Fallback after a pipe: quoted literal, omit-sentence, omit-message or block-send. Unknown slots are rejected.'),
     defaultOnMissingSlot: zod_1.z
         .enum(['omit-sentence', 'omit-message', 'block-send'])
         .optional()
-        .describe('Policy for slots that are missing and have no inline fallback'),
+        .describe('Policy for missing slots without an inline fallback'),
 };
 exports.definitionTools = [
     // ---- Identity -----------------------------------------------------------
     (0, tool_1.defineTool)({
         name: 'get_identity',
         title: 'Get agent identity',
-        description: "Read the agent's Identity — logos, brand color, contact email/phone, website, policy URLs, contact availability and the identityPreamble. This is the single source of truth for brand contact info and seeds new channel bindings. Maps to GET /v1/orgs/{org}/agents/{agent}/identity.",
+        description: "Read the agent's Identity — logos, brand color, contact email/phone, website, policy URLs, contact availability, identityPreamble. Source of truth for brand contact info; seeds new channel bindings. Maps to GET /v1/orgs/{org}/agents/{agent}/identity.",
         kind: 'read',
         scope: 'agents:read',
         roleFloor: 'viewer',
+        profile: 'core',
         input: { agentId },
         run: async ({ client }, { agentId }) => client.get(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/identity`)),
     }),
     (0, tool_1.defineTool)({
         name: 'update_identity',
         title: 'Update agent identity',
-        description: 'Update only the Identity fields you send (others are left as-is; send null to clear a field). Returns the full identity. Edits do not propagate to existing channel bindings. Maps to PATCH /v1/orgs/{org}/agents/{agent}/identity.',
+        description: 'Update only the Identity fields you send (null clears a field). Returns the full identity. Does not propagate to existing channel bindings. Maps to PATCH /v1/orgs/{org}/agents/{agent}/identity.',
         kind: 'write',
         scope: 'agents:write',
         roleFloor: 'editor',
+        profile: 'core',
         input: { agentId, ...identityFields },
         run: async ({ client }, { agentId, ...body }) => client.patch(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/identity`), body),
     }),
@@ -203,20 +167,22 @@ exports.definitionTools = [
         kind: 'read',
         scope: 'agents:read',
         roleFloor: 'viewer',
+        profile: 'core',
         input: { agentId },
         run: async ({ client }, { agentId }) => client.get(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/personality`)),
     }),
     (0, tool_1.defineTool)({
         name: 'set_personality',
         title: 'Set agent personality',
-        description: "Replace the agent's Personality wholesale (`text` is required; omitted fields are dropped). Read it first with get_personality if you only want to tweak wording. Returns the saved personality. Maps to PUT /v1/orgs/{org}/agents/{agent}/personality.",
+        description: "Replace the agent's Personality wholesale (`text` required; omitted fields dropped) — read first with get_personality to tweak wording. Maps to PUT /v1/orgs/{org}/agents/{agent}/personality.",
         kind: 'write',
         scope: 'agents:write',
         roleFloor: 'editor',
+        profile: 'core',
         input: {
             agentId,
-            text: zod_1.z.string().describe('The prompt fragment the agent uses (voice and tone)'),
-            description: zod_1.z.string().optional().describe('Human-readable summary'),
+            text: zod_1.z.string().describe('Voice/tone prompt fragment'),
+            description: zod_1.z.string().optional().describe('Operator-facing summary'),
             derivedFrom,
         },
         run: async ({ client }, { agentId, ...body }) => client.put(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/personality`), body),
@@ -224,7 +190,7 @@ exports.definitionTools = [
     (0, tool_1.defineTool)({
         name: 'import_personality_template',
         title: 'Import personality template',
-        description: 'Copy a system Personality Template from the catalog onto the agent, replacing the current personality and stamping derivedFrom (edit freely afterward). Returns the imported personality. Maps to POST /v1/orgs/{org}/agents/{agent}/personality/import.',
+        description: 'Copy a catalog Personality Template onto the agent, replacing the current personality and stamping derivedFrom (edit freely afterward). Maps to POST /v1/orgs/{org}/agents/{agent}/personality/import.',
         kind: 'write',
         scope: 'templates:apply',
         roleFloor: 'editor',
@@ -238,42 +204,39 @@ exports.definitionTools = [
     (0, tool_1.defineTool)({
         name: 'get_objectives',
         title: 'Get agent objectives',
-        description: "List the agent's Objectives — ranked SMART-style goals ({ id, name, description?, body, priority, derivedFrom? }; lower priority wins). Returns { data: AgentObjective[] }. Maps to GET /v1/orgs/{org}/agents/{agent}/objectives.",
+        description: "List the agent's Objectives — ranked goals { id, name, description?, body, priority, derivedFrom? } (lower priority wins). Maps to GET /v1/orgs/{org}/agents/{agent}/objectives.",
         kind: 'read',
         scope: 'agents:read',
         roleFloor: 'viewer',
+        profile: 'core',
         input: { agentId },
         run: async ({ client }, { agentId }) => client.get(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/objectives`)),
     }),
     (0, tool_1.defineTool)({
         name: 'set_objectives',
         title: 'Set agent objectives',
-        description: 'Replace the full Objectives list — send every objective you want to keep (read with get_objectives first; anything omitted is removed). Use this to add, edit, reorder or delete objectives. Returns { data: AgentObjective[] }. Maps to PUT /v1/orgs/{org}/agents/{agent}/objectives.',
+        description: 'Replace the full Objectives list — send every objective to keep (read with get_objectives first; omitted ones are removed). Use to add, edit, reorder or delete. Maps to PUT /v1/orgs/{org}/agents/{agent}/objectives.',
         kind: 'write',
         scope: 'agents:write',
         roleFloor: 'editor',
+        profile: 'core',
         input: {
             agentId,
-            objectives: zod_1.z
-                .array(objectiveItem)
-                .describe('The complete ordered list of objectives for the agent'),
+            objectives: zod_1.z.array(objectiveItem).describe('Complete ordered list'),
         },
         run: async ({ client }, { agentId, objectives }) => client.put(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/objectives`), { objectives }),
     }),
     (0, tool_1.defineTool)({
         name: 'import_objective_template',
         title: 'Import objective template',
-        description: 'Append one objective derived from a system Objective Template in the catalog (re-importing the same template replaces that objective in place). `priority` defaults to end of list + 1. Returns { data: AgentObjective[] }. Maps to POST /v1/orgs/{org}/agents/{agent}/objectives/import.',
+        description: 'Append one objective from a catalog Objective Template (re-importing the same template replaces that objective in place). Returns the full list. Maps to POST /v1/orgs/{org}/agents/{agent}/objectives/import.',
         kind: 'write',
         scope: 'templates:apply',
         roleFloor: 'editor',
         input: {
             agentId,
             templateId: templateIdArg('objective', '@anychat/objective-template.qualify-lead'),
-            priority: zod_1.z
-                .number()
-                .optional()
-                .describe('Priority for the imported objective (lower wins); default end of list + 1'),
+            priority: zod_1.z.number().optional().describe('Lower wins; default end of list + 1'),
         },
         run: async ({ client }, { agentId, templateId, priority }) => client.post(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/objectives/import`), priority === undefined ? { templateId } : { templateId, priority }),
     }),
@@ -285,64 +248,54 @@ exports.definitionTools = [
         kind: 'read',
         scope: 'agents:read',
         roleFloor: 'viewer',
+        profile: 'core',
         input: { agentId },
         run: async ({ client }, { agentId }) => client.get(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/guardrails`)),
     }),
     (0, tool_1.defineTool)({
         name: 'set_guardrails',
         title: 'Set agent guardrails',
-        description: 'Replace the Guardrails block wholesale — send every list you want to keep (read with get_guardrails first; omitted lists are cleared). For incremental add/remove prefer update_guardrails. Returns the saved guardrails. Maps to PUT /v1/orgs/{org}/agents/{agent}/guardrails.',
+        description: 'Replace the Guardrails wholesale — send every list to keep (omitted lists are cleared). For incremental add/remove prefer update_guardrails. Maps to PUT /v1/orgs/{org}/agents/{agent}/guardrails.',
         kind: 'write',
         scope: 'agents:write',
         roleFloor: 'editor',
+        profile: 'core',
         input: {
             agentId,
-            topicsToAvoid: zod_1.z
-                .array(zod_1.z.string())
-                .optional()
-                .describe('Topics the agent must not discuss'),
-            claimsNotToMake: zod_1.z
-                .array(zod_1.z.string())
-                .optional()
-                .describe('Claims the agent must never make'),
-            requiredDisclaimers: zod_1.z
-                .array(zod_1.z.string())
-                .optional()
-                .describe('Disclaimers the agent must include where relevant'),
-            additionalRules: zod_1.z
-                .string()
-                .optional()
-                .describe('Free-form hard rules that do not fit the lists'),
+            topicsToAvoid: zod_1.z.array(zod_1.z.string()).optional(),
+            claimsNotToMake: zod_1.z.array(zod_1.z.string()).optional(),
+            requiredDisclaimers: zod_1.z.array(zod_1.z.string()).optional(),
+            additionalRules: zod_1.z.string().optional().describe('Free-form hard rules'),
             derivedFromTemplates: zod_1.z
                 .array(zod_1.z.string())
                 .optional()
-                .describe('Back-links to imported guardrail template ids (normally managed by import)'),
+                .describe('Imported guardrail template ids (normally managed by import)'),
         },
         run: async ({ client }, { agentId, ...body }) => client.put(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/guardrails`), body),
     }),
     (0, tool_1.defineTool)({
         name: 'update_guardrails',
         title: 'Update agent guardrails',
-        description: 'Incrementally edit Guardrails: per list send { add?: string[], remove?: string[] } (adds dedupe; removes are exact-match), and/or set `additionalRules` to a new string. Lists you omit are untouched. Returns the saved guardrails. Maps to PATCH /v1/orgs/{org}/agents/{agent}/guardrails.',
+        description: 'Incrementally edit Guardrails: per list send { add?, remove? }, and/or set `additionalRules`. Omitted lists are untouched. Maps to PATCH /v1/orgs/{org}/agents/{agent}/guardrails.',
         kind: 'write',
         scope: 'agents:write',
         roleFloor: 'editor',
         input: {
             agentId,
-            topicsToAvoid: guardrailListOp.describe('Add/remove operations for topicsToAvoid'),
-            claimsNotToMake: guardrailListOp.describe('Add/remove operations for claimsNotToMake'),
-            requiredDisclaimers: guardrailListOp.describe('Add/remove operations for requiredDisclaimers'),
+            topicsToAvoid: guardrailListOp,
+            claimsNotToMake: guardrailListOp,
+            requiredDisclaimers: guardrailListOp,
             additionalRules: zod_1.z
                 .string()
                 .optional()
-                .describe('New value for the free-form rules (replaces the whole string; "" clears)'),
+                .describe('Replaces the whole string; "" clears'),
         },
         run: async ({ client }, { agentId, ...body }) => client.patch(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/guardrails`), body),
     }),
     (0, tool_1.defineTool)({
         name: 'import_guardrail_template',
         title: 'Import guardrail template',
-        description: "Merge a system Guardrail Template from the catalog into the agent's existing lists (deduplicated, order preserved — import accumulates rather than replaces) and append the template id to derivedFromTemplates. Returns the saved guardrails. Maps to POST /v1/orgs/{org}/agents/{agent}/guardrails/import.",
+        description: "Merge a catalog Guardrail Template into the agent's lists (deduplicated, accumulates rather than replaces) and record it in derivedFromTemplates. Maps to POST /v1/orgs/{org}/agents/{agent}/guardrails/import.",
         kind: 'write',
         scope: 'templates:apply',
         roleFloor: 'editor',
@@ -356,40 +309,40 @@ exports.definitionTools = [
     (0, tool_1.defineTool)({
         name: 'list_playbooks',
         title: 'List playbooks',
-        description: "List all of the agent's Playbooks (named modes of operation) with full bodies, procedures, flags and outreach binding. Exactly one has isDefault: true and at most one isOutbound: true. Returns { data: AgentPlaybook[] }. Maps to GET /v1/orgs/{org}/agents/{agent}/playbooks.",
+        description: "List the agent's Playbooks (named modes of operation) with bodies, procedures, flags and outreach binding. Exactly one isDefault, at most one isOutbound. Maps to GET /v1/orgs/{org}/agents/{agent}/playbooks.",
         kind: 'read',
         scope: 'agents:read',
         roleFloor: 'viewer',
+        profile: 'core',
         input: { agentId },
         run: async ({ client }, { agentId }) => client.get(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/playbooks`)),
     }),
     (0, tool_1.defineTool)({
         name: 'get_playbook',
         title: 'Get playbook',
-        description: 'Read one Playbook by id, including its body, whenToUse, examples, procedures[], toolRefs, messageTemplateRefs, isDefault/isOutbound and outreach binding. Maps to GET /v1/orgs/{org}/agents/{agent}/playbooks/{playbookId}.',
+        description: 'Read one Playbook: body, whenToUse, examples, procedures[], toolRefs, messageTemplateRefs, isDefault/isOutbound, outreach binding. Maps to GET /v1/orgs/{org}/agents/{agent}/playbooks/{playbookId}.',
         kind: 'read',
         scope: 'agents:read',
         roleFloor: 'viewer',
+        profile: 'core',
         input: {
             agentId,
-            playbookId: zod_1.z.string().min(1).describe('Playbook id (short slug)'),
+            playbookId: zod_1.z.string().min(1),
         },
         run: async ({ client }, { agentId, playbookId }) => client.get(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/playbooks/${encodeURIComponent(playbookId)}`)),
     }),
     (0, tool_1.defineTool)({
         name: 'create_playbook',
         title: 'Create playbook',
-        description: 'Create a new Playbook on the agent (id is slugified from name when omitted). Invariants are enforced on every write: exactly one Default Playbook, at most one outreach default (isOutbound); an outreach-exclusive Playbook cannot be the default. To add procedures[] use update_playbook after creating. Returns the created Playbook. Maps to POST /v1/orgs/{org}/agents/{agent}/playbooks.',
+        description: 'Create a Playbook (id slugified from name when omitted). Invariants: exactly one Default Playbook, at most one isOutbound; an outreach-exclusive Playbook cannot be default. Add procedures[] with update_playbook afterwards. Maps to POST /v1/orgs/{org}/agents/{agent}/playbooks.',
         kind: 'write',
         scope: 'agents:write',
         roleFloor: 'editor',
+        profile: 'core',
         input: {
             agentId,
-            id: zod_1.z
-                .string()
-                .optional()
-                .describe('Short slug for the Playbook; slugified from name when omitted'),
-            name: zod_1.z.string().min(1).describe('Display name'),
+            id: zod_1.z.string().optional().describe('Slug; slugified from name when omitted'),
+            name: zod_1.z.string().min(1),
             body: zod_1.z.string().describe('LLM-facing instructional body'),
             ...playbookContentFields,
             outreach: playbookOutreach.optional(),
@@ -399,20 +352,21 @@ exports.definitionTools = [
     (0, tool_1.defineTool)({
         name: 'update_playbook',
         title: 'Update playbook',
-        description: 'Update only the Playbook fields you send (PATCH semantics). Arrays (examples, procedures, toolRefs, messageTemplateRefs) are replaced whole when sent; `outreach` as an object replaces the binding, `outreach: null` clears it. Setting isDefault/isOutbound true moves that flag here (invariants enforced). Returns the updated Playbook. Maps to PATCH /v1/orgs/{org}/agents/{agent}/playbooks/{playbookId}.',
+        description: 'Update only the Playbook fields you send. Arrays (examples, procedures, toolRefs, messageTemplateRefs) are replaced whole; `outreach` object replaces the binding, null clears it. Setting isDefault/isOutbound true moves that flag here. Maps to PATCH /v1/orgs/{org}/agents/{agent}/playbooks/{playbookId}.',
         kind: 'write',
         scope: 'agents:write',
         roleFloor: 'editor',
+        profile: 'core',
         input: {
             agentId,
-            playbookId: zod_1.z.string().min(1).describe('Playbook id (short slug)'),
-            name: zod_1.z.string().min(1).optional().describe('Display name'),
+            playbookId: zod_1.z.string().min(1),
+            name: zod_1.z.string().min(1).optional(),
             body: zod_1.z.string().optional().describe('LLM-facing instructional body'),
             ...playbookContentFields,
             procedures: zod_1.z
                 .array(playbookProcedure)
                 .optional()
-                .describe('Playbook-owned instruction blocks (replaces the whole list). Each needs id + name; body defaults to "".'),
+                .describe('Playbook-owned instruction blocks (replaces the whole list)'),
             outreach: playbookOutreach.nullable().optional(),
         },
         run: async ({ client }, { agentId, playbookId, ...body }) => client.patch(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/playbooks/${encodeURIComponent(playbookId)}`), body),
@@ -420,13 +374,14 @@ exports.definitionTools = [
     (0, tool_1.defineTool)({
         name: 'delete_playbook',
         title: 'Delete playbook',
-        description: 'Delete a Playbook from the agent. Deleting the Default Playbook promotes the first remaining one to default; deleting the last one leaves the agent with no playbooks. Irreversible. Maps to DELETE /v1/orgs/{org}/agents/{agent}/playbooks/{playbookId}.',
+        description: 'Delete a Playbook. Deleting the Default promotes the first remaining one. Irreversible. Maps to DELETE /v1/orgs/{org}/agents/{agent}/playbooks/{playbookId}.',
         kind: 'destructive',
         scope: 'agents:write',
         roleFloor: 'editor',
+        profile: 'core',
         input: {
             agentId,
-            playbookId: zod_1.z.string().min(1).describe('Playbook id (short slug)'),
+            playbookId: zod_1.z.string().min(1),
         },
         run: async ({ client }, { agentId, playbookId }) => {
             await client.delete(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/playbooks/${encodeURIComponent(playbookId)}`));
@@ -436,20 +391,21 @@ exports.definitionTools = [
     (0, tool_1.defineTool)({
         name: 'set_default_playbook',
         title: 'Set default playbook',
-        description: "Atomically make this Playbook the agent's Default Playbook (clears isDefault on the others). Rejected for outreach-exclusive Playbooks. Returns the updated Playbook. Maps to POST /v1/orgs/{org}/agents/{agent}/playbooks/{playbookId}/_setDefault.",
+        description: "Atomically make this Playbook the agent's Default (clears isDefault on the others). Rejected for outreach-exclusive Playbooks. Maps to POST /v1/orgs/{org}/agents/{agent}/playbooks/{playbookId}/_setDefault.",
         kind: 'write',
         scope: 'agents:write',
         roleFloor: 'editor',
+        profile: 'core',
         input: {
             agentId,
-            playbookId: zod_1.z.string().min(1).describe('Playbook id (short slug)'),
+            playbookId: zod_1.z.string().min(1),
         },
         run: async ({ client }, { agentId, playbookId }) => client.post(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/playbooks/${encodeURIComponent(playbookId)}/_setDefault`)),
     }),
     (0, tool_1.defineTool)({
         name: 'import_playbook_template',
         title: 'Import playbook template',
-        description: 'Copy a catalog Playbook Template onto the agent (procedures materialized from the template, derivedFrom stamped; re-importing the same template replaces that Playbook in place, never as default). Returns the full { data: AgentPlaybook[] } list. Maps to POST /v1/orgs/{org}/agents/{agent}/playbooks/import.',
+        description: 'Copy a catalog Playbook Template onto the agent (procedures materialized, derivedFrom stamped; re-importing replaces that Playbook in place, never as default). Returns the full list. Maps to POST /v1/orgs/{org}/agents/{agent}/playbooks/import.',
         kind: 'write',
         scope: 'templates:apply',
         roleFloor: 'editor',
@@ -463,36 +419,36 @@ exports.definitionTools = [
     (0, tool_1.defineTool)({
         name: 'list_message_templates',
         title: 'List message templates',
-        description: "List the agent's Message templates — operator-authored canned messages with {slot} placeholders, used as outreach greetings and playbook openings. Returns { data: AgentMessageTemplate[] }. Maps to GET /v1/orgs/{org}/agents/{agent}/message-templates.",
+        description: "List the agent's Message templates — canned messages with {slot} placeholders used as outreach greetings and playbook openings. Maps to GET /v1/orgs/{org}/agents/{agent}/message-templates.",
         kind: 'read',
         scope: 'agents:read',
         roleFloor: 'viewer',
+        profile: 'core',
         input: { agentId },
         run: async ({ client }, { agentId }) => client.get(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/message-templates`)),
     }),
     (0, tool_1.defineTool)({
         name: 'get_message_template',
         title: 'Get message template',
-        description: 'Read one Message template by id ({ id, name, description?, body, defaultOnMissingSlot? }). Maps to GET /v1/orgs/{org}/agents/{agent}/message-templates/{templateId}.',
+        description: 'Read one Message template ({ id, name, description?, body, defaultOnMissingSlot? }). Maps to GET /v1/orgs/{org}/agents/{agent}/message-templates/{templateId}.',
         kind: 'read',
         scope: 'agents:read',
         roleFloor: 'viewer',
-        input: { agentId, templateId: zod_1.z.string().min(1).describe('Message template id') },
+        profile: 'core',
+        input: { agentId, templateId: zod_1.z.string().min(1) },
         run: async ({ client }, { agentId, templateId }) => client.get(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/message-templates/${encodeURIComponent(templateId)}`)),
     }),
     (0, tool_1.defineTool)({
         name: 'upsert_message_template',
         title: 'Create or replace message template',
-        description: "Create a Message template with a stable id you choose, or replace an existing one wholesale (name and body required; omitted optional fields are cleared). The body's slots are validated on write. Returns the saved template. Maps to PUT /v1/orgs/{org}/agents/{agent}/message-templates/{templateId}.",
+        description: 'Create a Message template with an id you choose, or replace an existing one wholesale (name and body required; omitted optional fields are cleared). Slots are validated on write. Maps to PUT /v1/orgs/{org}/agents/{agent}/message-templates/{templateId}.',
         kind: 'write',
         scope: 'agents:write',
         roleFloor: 'editor',
+        profile: 'core',
         input: {
             agentId,
-            templateId: zod_1.z
-                .string()
-                .min(1)
-                .describe('Message template id (short slug, e.g. "outreach-greeting")'),
+            templateId: zod_1.z.string().min(1).describe('Slug, e.g. "outreach-greeting"'),
             ...messageTemplateFields,
         },
         run: async ({ client }, { agentId, templateId, ...body }) => client.put(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/message-templates/${encodeURIComponent(templateId)}`), body),
@@ -500,11 +456,12 @@ exports.definitionTools = [
     (0, tool_1.defineTool)({
         name: 'delete_message_template',
         title: 'Delete message template',
-        description: 'Delete a Message template from the agent. Playbooks or outreach config referencing it will no longer resolve their opening/greeting. Irreversible. Maps to DELETE /v1/orgs/{org}/agents/{agent}/message-templates/{templateId}.',
+        description: 'Delete a Message template. Playbooks or outreach config referencing it lose their opening/greeting. Irreversible. Maps to DELETE /v1/orgs/{org}/agents/{agent}/message-templates/{templateId}.',
         kind: 'destructive',
         scope: 'agents:write',
         roleFloor: 'editor',
-        input: { agentId, templateId: zod_1.z.string().min(1).describe('Message template id') },
+        profile: 'core',
+        input: { agentId, templateId: zod_1.z.string().min(1) },
         run: async ({ client }, { agentId, templateId }) => {
             await client.delete(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/message-templates/${encodeURIComponent(templateId)}`));
             return { ok: true, deleted: templateId };
@@ -513,17 +470,14 @@ exports.definitionTools = [
     (0, tool_1.defineTool)({
         name: 'preview_message_template',
         title: 'Preview message template',
-        description: 'Render a Message template against a real Person of this agent and return what would be sent: { renderedText (null when block-send fired), missingSlots[{ path, action }], blocked }. Sends nothing. Maps to GET /v1/orgs/{org}/agents/{agent}/message-templates/{templateId}/preview?personId=….',
+        description: 'Render a Message template against a real Person and return what would be sent: { renderedText (null when block-send fired), missingSlots[{ path, action }], blocked }. Sends nothing. Maps to GET /v1/orgs/{org}/agents/{agent}/message-templates/{templateId}/preview?personId=….',
         kind: 'read',
         scope: 'agents:read',
         roleFloor: 'viewer',
         input: {
             agentId,
-            templateId: zod_1.z.string().min(1).describe('Message template id'),
-            personId: zod_1.z
-                .string()
-                .min(1)
-                .describe('Id of a Person belonging to this agent to render the slots from'),
+            templateId: zod_1.z.string().min(1),
+            personId: zod_1.z.string().min(1).describe('A Person of this agent to render slots from'),
         },
         run: async ({ client }, { agentId, templateId, personId }) => client.get(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/message-templates/${encodeURIComponent(templateId)}/preview`), { personId }),
     }),