@pitcher/cli-scripts 2.7.1 → 2.9.0

package/dist/src/mcp/tools/announcements.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { runAnnouncementsCreate, runAnnouncementsList } from '../../commands/announcements.js';
+export const announcementsTools = [
+    {
+        name: 'pitcher_announcements_create',
+        title: 'Create an announcement',
+        description: 'Create a wa-announcements appsDB record (title/body, optional media, CTA link, scheduling, group targeting). ' +
+            'Requires either fromFile (a JSON object with the announcement data) or both title and body. Additive.',
+        inputShape: {
+            instanceId: z.string().describe('Instance ID (required)'),
+            fromFile: z.string().optional().describe('Path to a JSON file with the announcement data object'),
+            title: z.string().optional().describe('Announcement title (overrides a matching fromFile key)'),
+            body: z.string().optional().describe('Announcement body HTML (overrides a matching fromFile key)'),
+            priority: z.string().optional().describe("Priority, e.g. 'normal' or 'important' (overrides a matching fromFile key)"),
+        },
+        run: runAnnouncementsCreate,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_announcements_list',
+        title: 'List announcements',
+        description: 'List wa-announcements appsDB records for an instance.',
+        inputShape: {
+            instanceId: z.string().describe('Instance ID (required)'),
+            limit: z.number().int().optional(),
+            offset: z.number().int().optional(),
+        },
+        run: runAnnouncementsList,
+        readOnly: true,
+    },
+];

package/dist/src/mcp/tools/canvases.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDescriptor } from './types.js';
+export declare const canvasesTools: ToolDescriptor[];

package/dist/src/mcp/tools/canvases.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { runCanvasesList, runCanvasesGet } from '../../commands/canvases.js';
+export const canvasesTools = [
+    {
+        name: 'pitcher_canvases_list',
+        title: 'List canvases',
+        description: 'List canvases (presentations, sections, blocks) in an instance. Use to discover canvas IDs before sharing or reading. Blocks are hidden unless isBlock is true.',
+        inputShape: {
+            instanceId: z.string().describe('Instance ID (required)'),
+            isTemplate: z.boolean().optional().describe('Only templates'),
+            isSection: z.boolean().optional().describe('Only sections'),
+            isBlock: z.boolean().optional().describe('Only blocks (hidden unless set)'),
+            tags: z.string().optional().describe('Comma-separated tags'),
+            idIn: z.string().optional().describe('Comma-separated canvas IDs'),
+            accessType: z.enum(['public', 'restricted', 'personal']).optional(),
+            page: z.number().int().optional(),
+            pageSize: z.number().int().optional().describe('Page size (max 500)'),
+        },
+        run: runCanvasesList,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_canvases_get',
+        title: 'Get a canvas',
+        description: 'Retrieve a single canvas by its ID.',
+        inputShape: { id: z.string().describe('Canvas ID') },
+        run: runCanvasesGet,
+        readOnly: true,
+    },
+];

package/dist/src/mcp/tools/devSync.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDescriptor } from './types.js';
+export declare const devSyncTools: ToolDescriptor[];

package/dist/src/mcp/tools/devSync.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { runDevSync, runRevert } from '../../commands/devSync.js';
+import { fail } from '../../core/envelope.js';
+import { createCliError } from '../../core/errors.js';
+// devSync.ts is legacy-shaped: `DevSyncOptions.fileId` is a required (non-optional)
+// string, unlike every other command's `CommonOpts & { field?: ... }` + in-run
+// VALIDATION-throw pattern. That mismatch means `runDevSync`/`runRevert` cannot be
+// assigned directly to `ToolDescriptor.run` (typed `Record<string, unknown> &
+// InjectedAuth`) — TS reports `fileId` as missing. These thin wrappers narrow the
+// runtime value (the MCP zod schema already guarantees it's a string) and forward
+// a properly-typed object literal, instead of casting the whole `opts` blob.
+function requireFileId(opts) {
+    return typeof opts.fileId === 'string' ? opts.fileId : undefined;
+}
+export const devSyncTools = [
+    {
+        name: 'pitcher_dev_sync',
+        title: 'Dev-sync an app (one-shot)',
+        description: 'One-time sync of a local app build (a folder with app.json, on the MCP server host — cwd or ./dist) ' +
+            'to S3 as a live dev override for an installed app file, for testing without publishing. ' +
+            'This is a single sync, not the continuous watcher — call again to re-sync after further changes. ' +
+            'Reversible with pitcher_dev_sync_revert.',
+        inputShape: {
+            fileId: z.string().describe('File ID of the installed app (pitcher_file.id) to override'),
+        },
+        run: (opts, deps) => {
+            const fileId = requireFileId(opts);
+            if (!fileId)
+                return Promise.resolve(fail(createCliError('VALIDATION', 'fileId is required')));
+            return runDevSync({ fileId, apiKey: opts.apiKey, org: opts.org }, deps);
+        },
+        wraps: runDevSync,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_dev_sync_revert',
+        title: 'Revert a dev-sync override',
+        description: 'Revert a dev-sync override on an installed app file, restoring its original published version.',
+        inputShape: {
+            fileId: z.string().describe('File ID of the installed app (pitcher_file.id) to revert'),
+        },
+        run: (opts, deps) => {
+            const fileId = requireFileId(opts);
+            if (!fileId)
+                return Promise.resolve(fail(createCliError('VALIDATION', 'fileId is required')));
+            return runRevert({ fileId, apiKey: opts.apiKey, org: opts.org }, deps);
+        },
+        wraps: runRevert,
+        readOnly: false,
+        write: true,
+    },
+];

package/dist/src/mcp/tools/dsr.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDescriptor } from './types.js';
+export declare const dsrTools: ToolDescriptor[];

package/dist/src/mcp/tools/dsr.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import { runDsrCreate, runDsrBindLanding } from '../../commands/dsr.js';
+const AUTH_STRATEGIES = [
+    'none', 'any_email', 'specified_emails', 'specified_domains', 'verified_emails', 'verified_domains',
+];
+export const dsrTools = [
+    {
+        name: 'pitcher_dsr_create',
+        title: 'Create and share a DSR',
+        description: 'Create a Digital Sales Room (a canvas share link) and get a clickable link back. Source is a canvas (canvasId) OR files (shareboxFileIds) - exactly one. Optional email/domain gating and a bound landing-page template. Never hard-fails once a link exists: a failed landing bind returns the link with a warning. Additive.',
+        inputShape: {
+            instanceId: z.string().optional().describe('Instance ID (required for the shareboxFileIds source)'),
+            canvasId: z.string().optional().describe('Canvas to share (exactly one of canvasId / shareboxFileIds)'),
+            shareboxFileIds: z.array(z.string()).optional().describe('File IDs to build a share from (exactly one of canvasId / shareboxFileIds)'),
+            canvasName: z.string().optional().describe('Name for the ShareBox-built canvas'),
+            accountId: z.string().optional(),
+            templateId: z.string().optional(),
+            authStrategy: z.enum(AUTH_STRATEGIES).optional().describe('Access gating (server default any_email)'),
+            allowedEmails: z.array(z.string()).optional().describe('Required for specified_emails / verified_emails'),
+            allowedDomains: z.array(z.string()).optional().describe('Required for specified_domains / verified_domains'),
+            validUntil: z.string().optional().describe('Expiry, ISO datetime'),
+            allowForward: z.boolean().optional(),
+            allowDownload: z.boolean().optional(),
+            tags: z.array(z.string()).optional(),
+            landingTemplateId: z.string().optional().describe('Bind a landing-page template (discover via pitcher_dsr_landing_list)'),
+            landingContext: z.string().optional().describe('Landing-page merge fields, a JSON object as a string'),
+            configFile: z.string().optional().describe('Path on the MCP server host to a full {source,security,landing} spec JSON; mutually exclusive with the individual flags'),
+        },
+        run: runDsrCreate,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_dsr_bind_landing',
+        title: 'Bind a DSR landing page',
+        description: 'Attach, re-brand, or unbind a landing-page template on an existing DSR share. Use landingTemplateId "none" to unbind. Requires an editor-level key (hard-fails AUTH otherwise).',
+        inputShape: {
+            id: z.string().describe('Shared-link ID'),
+            landingTemplateId: z.string().describe('Landing template ID, or "none" to unbind'),
+            landingContext: z.string().optional().describe('Landing-page merge fields, a JSON object as a string'),
+            instanceId: z.string().optional(),
+        },
+        run: runDsrBindLanding,
+        readOnly: false,
+        write: true,
+    },
+];

package/dist/src/mcp/tools/dsrLanding.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDescriptor } from './types.js';
+export declare const dsrLandingTools: ToolDescriptor[];

package/dist/src/mcp/tools/dsrLanding.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { runDsrLandingCreate, runDsrLandingSetDefault, runDsrLandingList } from '../../commands/dsrLanding.js';
+export const dsrLandingTools = [
+    {
+        name: 'pitcher_dsr_landing_create',
+        title: 'Create a DSR landing template',
+        description: 'Create a DSR (Digital Sales Room) landing-page template from HTML (must contain the data-pitcher-email-gate ' +
+            'marker) and optional CSS/merge-schema/thumbnail. Optionally set it as the instance default in the same call. Additive.',
+        inputShape: {
+            instanceId: z.string().describe('Instance ID (required)'),
+            name: z.string().describe('Template name (required)'),
+            htmlFile: z.string().describe('Path to the landing HTML (required; must contain data-pitcher-email-gate)'),
+            cssFile: z.string().optional().describe('Path to a CSS file for the template'),
+            mergeSchema: z.string().optional().describe('Merge schema JSON array as a string'),
+            thumbnailUrl: z.string().optional().describe('Thumbnail image URL'),
+            language: z.string().optional().describe('Language code (max 10 chars)'),
+            default: z.boolean().optional().describe('Also set this template as the instance-scope default after creating it'),
+        },
+        run: runDsrLandingCreate,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_dsr_landing_set_default',
+        title: 'Set default DSR landing template',
+        description: 'Set an existing DSR landing-page template as the instance-scope default.',
+        inputShape: {
+            instanceId: z.string().describe('Instance ID (required)'),
+            id: z.string().describe('Template ID (required)'),
+        },
+        run: runDsrLandingSetDefault,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_dsr_landing_list',
+        title: 'List DSR landing templates',
+        description: 'List DSR (Digital Sales Room) landing-page templates in an instance.',
+        inputShape: {
+            instanceId: z.string().describe('Instance ID (required)'),
+        },
+        run: runDsrLandingList,
+        readOnly: true,
+    },
+];

package/dist/src/mcp/tools/emailTemplate.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDescriptor } from './types.js';
+export declare const emailTemplateTools: ToolDescriptor[];

package/dist/src/mcp/tools/emailTemplate.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import { runEmailTemplateCreate, runEmailTemplateList, runEmailTemplateGet } from '../../commands/emailTemplate.js';
+export const emailTemplateTools = [
+    {
+        name: 'pitcher_email_template_create',
+        title: 'Create an email template',
+        description: 'Create an HTML email template for the emails app (Rep Triggered Emails). Additive.',
+        inputShape: {
+            instanceId: z.string().describe('Instance ID (required)'),
+            name: z.string().describe('Template name (required)'),
+            bodyFile: z.string().optional().describe('Path to an HTML file (inline CSS) used as the template body'),
+            subject: z.string().optional().describe('Email subject (supports {{tokens}})'),
+            tags: z.string().optional().describe('Tags JSON object as a string'),
+            metadata: z.string().optional().describe('Metadata JSON object as a string'),
+        },
+        run: runEmailTemplateCreate,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_email_template_list',
+        title: 'List email templates',
+        description: 'List HTML email templates for the emails app in an instance. Filter by name, status, category, or target.',
+        inputShape: {
+            instanceId: z.string().describe('Instance ID (required)'),
+            name: z.string().optional().describe('Case-insensitive substring filter, matched against name OR subject'),
+            status: z.string().optional().describe('Status filter'),
+            category: z.string().optional().describe('Category filter'),
+            target: z.string().optional().describe('Target filter'),
+            limit: z.number().int().optional(),
+            offset: z.number().int().optional(),
+        },
+        run: runEmailTemplateList,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_email_template_get',
+        title: 'Get an email template',
+        description: 'Retrieve a single HTML email template by its ID.',
+        inputShape: {
+            instanceId: z.string().describe('Instance ID (required)'),
+            id: z.string().describe('Template ID (required)'),
+        },
+        run: runEmailTemplateGet,
+        readOnly: true,
+    },
+];

package/dist/src/mcp/tools/files.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDescriptor } from './types.js';
+export declare const filesTools: ToolDescriptor[];

package/dist/src/mcp/tools/files.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { runFilesList, runFilesGet, runFilesCreate, runFilesUpdate } from '../../commands/files.js';
+export const filesTools = [
+    {
+        name: 'pitcher_files_list',
+        title: 'List files',
+        description: 'List content files in an instance. Filter by tags or specific IDs.',
+        inputShape: {
+            instanceId: z.string().describe('Instance ID (required)'),
+            idIn: z.string().optional().describe('Comma-separated file IDs'),
+            tags: z.string().optional().describe('Comma-separated tags'),
+            page: z.number().int().optional(),
+            pageSize: z.number().int().optional(),
+        },
+        run: runFilesList,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_files_get',
+        title: 'Get a file',
+        description: 'Retrieve a single file by its ID.',
+        inputShape: { id: z.string().describe('File ID') },
+        run: runFilesGet,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_files_create',
+        title: 'Create a file',
+        description: 'Create a content file in an instance, from a local file path (on the server host) or a source URL. Additive.',
+        inputShape: {
+            instanceId: z.string().describe('Instance ID (required)'),
+            name: z.string().optional().describe('File name'),
+            folderId: z.string().optional().describe('Destination folder'),
+            filePath: z.string().optional().describe('Local file path to upload (on the MCP server host)'),
+            sourceUrl: z.string().optional().describe('Link/WEB file source URL'),
+            accessType: z.enum(['public', 'restricted', 'personal']).optional(),
+            tags: z.string().optional().describe('Comma-separated tags'),
+            metadata: z.string().optional().describe('metadata JSON object as a string'),
+            appMetadata: z.string().optional().describe('app_metadata JSON object as a string'),
+        },
+        run: runFilesCreate,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_files_update',
+        title: 'Update a file',
+        description: 'Update a file by ID (name, folder, access, tags, metadata). filePath or sourceUrl replaces/overwrites the file binary; metadata is deep-merged.',
+        inputShape: {
+            id: z.string().describe('File ID'),
+            instanceId: z.string().optional().describe('Instance ID (required only with filePath)'),
+            name: z.string().optional(),
+            folderId: z.string().optional(),
+            filePath: z.string().optional().describe('Local file path to replace the binary (on the MCP server host)'),
+            sourceUrl: z.string().optional(),
+            accessType: z.enum(['public', 'restricted', 'personal']).optional(),
+            tags: z.string().optional().describe('Comma-separated tags'),
+            metadata: z.string().optional().describe('metadata JSON object as a string (deep-merged)'),
+            appMetadata: z.string().optional().describe('app_metadata JSON object as a string (deep-merged)'),
+        },
+        run: runFilesUpdate,
+        readOnly: false,
+        write: true,
+    },
+];

package/dist/src/mcp/tools/folders.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDescriptor } from './types.js';
+export declare const foldersTools: ToolDescriptor[];

package/dist/src/mcp/tools/folders.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { runFoldersList, runFoldersGet, runFoldersCreate, runFoldersUpdate } from '../../commands/folders.js';
+export const foldersTools = [
+    {
+        name: 'pitcher_folders_list',
+        title: 'List folders',
+        description: 'List folders in an instance. Use to discover folder IDs before creating content or browsing structure.',
+        inputShape: {
+            instanceId: z.string().describe('Instance ID (required)'),
+            page: z.number().int().optional(),
+            pageSize: z.number().int().optional().describe('Page size (max 500)'),
+        },
+        run: runFoldersList,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_folders_get',
+        title: 'Get a folder',
+        description: 'Retrieve a single folder by its ID, or the instance root folder via root + instanceId.',
+        inputShape: {
+            id: z.string().optional().describe('Folder ID (omit and set root=true for the instance root)'),
+            root: z.boolean().optional().describe('Fetch the instance root folder'),
+            instanceId: z.string().optional().describe('Instance ID (required with root)'),
+        },
+        run: runFoldersGet,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_folders_create',
+        title: 'Create a folder',
+        description: 'Create a folder under a parent folder in an instance. Additive.',
+        inputShape: {
+            name: z.string().describe('Folder name (required)'),
+            parentFolderId: z.string().describe('Parent folder ID (required)'),
+            accessType: z.enum(['public', 'restricted', 'personal']).optional(),
+            rules: z.string().optional().describe('Smart-folder rules JSON array as a string'),
+        },
+        run: runFoldersCreate,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_folders_update',
+        title: 'Update a folder',
+        description: 'Update an existing folder by ID (name, access type, or smart-folder rules; rules replace existing).',
+        inputShape: {
+            id: z.string().describe('Folder ID'),
+            name: z.string().optional().describe('Folder name'),
+            accessType: z.enum(['public', 'restricted', 'personal']).optional(),
+            rules: z.string().optional().describe('Smart-folder rules JSON array as a string (replaces existing)'),
+        },
+        run: runFoldersUpdate,
+        readOnly: false,
+        write: true,
+    },
+];

package/dist/src/mcp/tools/groups.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDescriptor } from './types.js';
+export declare const groupsTools: ToolDescriptor[];

package/dist/src/mcp/tools/groups.js

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import { runGroupsList, runGroupsGet, runGroupsCreate, runGroupsAddUser, runGroupsListUsers, } from '../../commands/groups.js';
+export const groupsTools = [
+    {
+        name: 'pitcher_groups_list',
+        title: 'List content-distribution groups',
+        description: 'List content-distribution groups. Filter by instance.',
+        inputShape: {
+            instanceId: z.string().optional().describe('Filter by instance'),
+            page: z.number().int().optional().describe('Page number'),
+            pageSize: z.number().int().optional().describe('Page size (max 500)'),
+        },
+        run: runGroupsList,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_groups_get',
+        title: 'Get a group',
+        description: 'Retrieve a single content-distribution group by its ID.',
+        inputShape: { id: z.string().describe('Group ID') },
+        run: runGroupsGet,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_groups_create',
+        title: 'Create a group',
+        description: 'Create a content-distribution group in an instance. Additive.',
+        inputShape: {
+            instanceId: z.string().describe('Instance ID (required)'),
+            name: z.string().describe('Group name (required)'),
+        },
+        run: runGroupsCreate,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_groups_add_user',
+        title: 'Add a user to a group',
+        description: 'Add a user to a content-distribution group. Rejected on auto-login-managed groups.',
+        inputShape: {
+            groupId: z.string().describe('Group ID (required)'),
+            userId: z.string().describe('User ID (integer, required)'),
+        },
+        run: runGroupsAddUser,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_groups_list_users',
+        title: "List a group's members",
+        description: "List a content-distribution group's members.",
+        inputShape: {
+            groupId: z.string().describe('Group whose members to list (required)'),
+            page: z.number().int().optional().describe('Page number'),
+            pageSize: z.number().int().optional().describe('Page size (max 500)'),
+        },
+        run: runGroupsListUsers,
+        readOnly: true,
+    },
+];

package/dist/src/mcp/tools/instances.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDescriptor } from './types.js';
+export declare const instancesTools: ToolDescriptor[];

package/dist/src/mcp/tools/instances.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { runInstancesList, runInstancesInfo } from '../../commands/instances.js';
+export const instancesTools = [
+    {
+        name: 'pitcher_instances_list',
+        title: 'List instances',
+        description: 'Discover Pitcher instances in the org. Use to resolve instance names to instance IDs.' +
+            ' Output may include raw instance settings/metadata (potentially integration credentials) - treat as sensitive.',
+        inputShape: {
+            region: z.string().optional().describe('Filter by region'),
+            storageRegion: z.string().optional().describe('Filter by storage region'),
+            environment: z.string().optional().describe('Filter by environment'),
+            page: z.number().int().optional(),
+            pageSize: z.number().int().optional().describe('Page size (max 500)'),
+        },
+        run: runInstancesList,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_instances_info',
+        title: 'Get an instance',
+        description: 'Retrieve details for a single instance by its ID.' +
+            ' Output may include raw instance settings/metadata (potentially integration credentials) - treat as sensitive.',
+        inputShape: { id: z.string().describe('Instance ID') },
+        run: runInstancesInfo,
+        readOnly: true,
+    },
+];

package/dist/src/mcp/tools/invitations.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDescriptor } from './types.js';
+export declare const invitationsTools: ToolDescriptor[];

package/dist/src/mcp/tools/invitations.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { runInvitationsList, runInvitationsGet } from '../../commands/invitations.js';
+export const invitationsTools = [
+    {
+        name: 'pitcher_invitations_list',
+        title: 'List invitations',
+        description: 'List pending user invitations in the org.',
+        inputShape: {
+            page: z.number().int().optional().describe('Page number'),
+            pageSize: z.number().int().optional().describe('Page size (max 500)'),
+        },
+        run: runInvitationsList,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_invitations_get',
+        title: 'Get an invitation',
+        description: 'Retrieve a single pending invitation by ID.',
+        inputShape: { id: z.string().describe('Invitation ID') },
+        run: runInvitationsGet,
+        readOnly: true,
+    },
+];

package/dist/src/mcp/tools/memberships.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDescriptor } from './types.js';
+export declare const membershipsTools: ToolDescriptor[];

package/dist/src/mcp/tools/memberships.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import { runMembershipsList, runMembershipsAdd, runMembershipsSetRole } from '../../commands/memberships.js';
+export const membershipsTools = [
+    {
+        name: 'pitcher_memberships_list',
+        title: 'List instance memberships',
+        description: 'List instance memberships. Filter by instance or user to discover membership IDs before set-role.',
+        inputShape: {
+            instanceId: z.string().optional().describe('Filter by instance'),
+            userId: z.string().optional().describe('Filter by user (integer id)'),
+            page: z.number().int().optional().describe('Page number'),
+            pageSize: z.number().int().optional().describe('Page size (max 500)'),
+        },
+        run: runMembershipsList,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_memberships_add',
+        title: 'Add a member',
+        description: "Add a user to an instance as 'member' (role is always 'member' — this endpoint never accepts a " +
+            "caller-supplied role). Use pitcher_memberships_set_role to change the role afterward.",
+        inputShape: {
+            instanceId: z.string().describe('Instance ID (required)'),
+            userId: z.string().describe('User ID (integer, required)'),
+        },
+        run: runMembershipsAdd,
+        readOnly: false,
+        write: true,
+    },
+    {
+        name: 'pitcher_memberships_set_role',
+        title: 'Set a membership role',
+        description: "Change a membership's role via the validating next-core endpoint. Requires an org-admin key. " +
+            "--role is the SHORT role name (e.g. 'editor') from pitcher_roles_list, not a prefixed key.",
+        inputShape: {
+            membershipId: z.string().describe('Membership row ID (integer, required)'),
+            role: z.string().describe('Short role name, e.g. editor (required)'),
+            scope: z
+                .enum(['instance', 'organization'])
+                .optional()
+                .describe('Scope of the role assignment (default instance)'),
+        },
+        run: runMembershipsSetRole,
+        readOnly: false,
+        write: true,
+    },
+];

package/dist/src/mcp/tools/metadataTemplate.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDescriptor } from './types.js';
+export declare const metadataTemplateTools: ToolDescriptor[];

package/dist/src/mcp/tools/metadataTemplate.js

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { runMetadataTemplateList, runMetadataTemplateGet, runMetadataTemplateUpsert, } from '../../commands/metadataTemplate.js';
+export const metadataTemplateTools = [
+    {
+        name: 'pitcher_metadata_template_list',
+        title: 'List metadata templates',
+        description: "List an instance's metadata-field schema(s) (metadata templates).",
+        inputShape: {
+            instanceId: z.string().describe('Instance ID (required)'),
+            page: z.number().int().optional().describe('Page number'),
+            pageSize: z.number().int().optional().describe('Page size (max 500)'),
+        },
+        run: runMetadataTemplateList,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_metadata_template_get',
+        title: 'Get a metadata template',
+        description: 'Retrieve a single metadata template by its ID (ULID).',
+        inputShape: { id: z.string().describe('Metadata template ID (ULID)') },
+        run: runMetadataTemplateGet,
+        readOnly: true,
+    },
+    {
+        name: 'pitcher_metadata_template_upsert',
+        title: 'Upsert a metadata template',
+        description: "Upsert an instance's metadata-field schema. Merges the incoming sections by section 'label' — a " +
+            'section whose label matches an existing one is replaced, other sections are preserved. Cannot remove ' +
+            'a section or field. Pass exactly one of sections or sectionsFile. Requires an instance- or org-admin key.',
+        inputShape: {
+            instanceId: z.string().describe('Instance ID (required)'),
+            sections: z.string().optional().describe('Sections JSON array (inline)'),
+            sectionsFile: z
+                .string()
+                .optional()
+                .describe('Path to a JSON file (on the MCP server host) with the sections array'),
+        },
+        run: runMetadataTemplateUpsert,
+        readOnly: false,
+        write: true,
+    },
+];

package/dist/src/mcp/tools/org.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDescriptor } from './types.js';
+export declare const orgTools: ToolDescriptor[];