wolfpack-mcp 1.0.93 → 1.0.95

package/README.md

@@ -355,6 +355,51 @@ Get a specific radar item.
 - `item_id` (required): UUID or reference number
 - `team_id` (optional): Required when using reference number
 
+### Tags
+
+Tags label work items, issues, wiki pages and journal entries, and are filed under nestable groups. Project admins define them; a key with `mcp:tags:manage` lets an admin's agent keep them in step with an external system (for example, one tag per CRM customer account keyed on `external_id`). There is no delete tool — archive instead (`update_tag` with `archived: true`); removing a tag outright is done in the browser.
+
+#### `list_tags`
+
+List a project's tags with id, name, colour, `externalId`, the group each is filed under and whether it is `archived`. Any key that can read a tagged module may list them.
+
+- `project_slug` (optional): Project slug
+
+#### `create_tag`
+
+- `name` (required): Tag name, unique within the project
+- `colour` (optional): Hex colour such as `#e879f9`
+- `group` (optional): Tag group name or id
+- `external_id` (optional): Id of this tag in the system that maintains it, unique within the project
+- `project_slug` (optional): Project slug
+
+#### `update_tag`
+
+Only the fields given change; pass `null` for `colour`, `group` or `external_id` to clear it. `archived: true` is the soft delete: the tag stays on the items that carry it and keeps its page, but no picker offers it and it cannot be applied; `archived: false` restores it. A sync uses this for accounts the source system has dropped.
+
+- `tag` (required): Tag id or current name
+- `name`, `colour`, `group`, `external_id`, `archived` (optional)
+- `project_slug` (optional): Project slug
+
+#### `list_tag_groups`
+
+List a project's tag groups with their parent and full path (e.g. `Customers › EMEA`).
+
+- `project_slug` (optional): Project slug
+
+#### `create_tag_group`
+
+- `name` (required): Group name, unique within the project
+- `parent` (optional): Parent group name or id
+- `project_slug` (optional): Project slug
+
+#### `update_tag_group`
+
+- `group` (required): Group id or current name
+- `name` (optional): New name
+- `parent` (optional): Parent group name or id, or `null` for the top level
+- `project_slug` (optional): Project slug
+
 ### Images
 
 #### `upload_image`

package/dist/agentBuilderTools.js

@@ -40,12 +40,25 @@ export const AGENT_BUILDER_TOOLS = [
     // ─── Group 1: Agent CRUD ─────────────────────────────────────────────────
     {
         name: 'list_agents',
-        description: 'List all agents in the organisation. Returns name, status, template, and assigned projects.',
-        inputSchema: { type: 'object', properties: { ...ORG_SLUG_PROP } },
+        description: 'List agents. Returns name, status, template, and assigned projects. ' +
+            'scope "org" (the default) lists the organisation\'s agents; scope "personal" lists your own ' +
+            'My Agents from My Space, which belong to no organisation. Call it twice to see both.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                scope: {
+                    type: 'string',
+                    enum: ['org', 'personal'],
+                    description: "Which agents to list: the organisation's (default) or your own personal ones.",
+                },
+                ...ORG_SLUG_PROP,
+            },
+        },
     },
     {
         name: 'get_agent',
-        description: 'Get full details for an agent including config, instructions, LLM model, and linked skills.',
+        description: 'Get full details for an agent including config, instructions, LLM model, and linked skills. ' +
+            'Takes an organisation agent or one of your own personal agents.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -57,7 +70,10 @@ export const AGENT_BUILDER_TOOLS = [
     },
     {
         name: 'create_agent',
-        description: 'Create a new agent from a container image. Use list_container_images to see available images.',
+        description: 'Create a new agent from a container image. Use list_container_images to see available images. ' +
+            'With personal=true, creates one of your own My Agents instead of an organisation agent: ' +
+            'it needs a handle, and only an image opened to personal use (list_container_images with ' +
+            'personal=true) qualifies.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -67,6 +83,14 @@ export const AGENT_BUILDER_TOOLS = [
                 },
                 name: { type: 'string', description: 'Display name for the agent' },
                 config: { type: 'object', description: 'Optional agent-specific configuration' },
+                personal: {
+                    type: 'boolean',
+                    description: 'Create one of your own personal agents (My Space > My Agents) rather than an organisation agent.',
+                },
+                handle: {
+                    type: 'string',
+                    description: 'Handle for a personal agent — it becomes "@<your username>/<handle>". Required with personal=true, ignored otherwise.',
+                },
                 ...ORG_SLUG_PROP,
             },
             required: ['container_image_id', 'name'],
@@ -798,8 +822,19 @@ export const AGENT_BUILDER_TOOLS = [
     // ─── Group 7: Discovery ───────────────────────────────────────────────────
     {
         name: 'list_container_images',
-        description: 'List agent-capable container images assigned to the organisation. Use image IDs when calling create_agent.',
-        inputSchema: { type: 'object', properties: { ...ORG_SLUG_PROP } },
+        description: 'List agent-capable container images assigned to the organisation. Use image IDs when calling create_agent. ' +
+            'With personal=true, lists the images a personal agent may run instead — the bring-your-own-token ' +
+            'images opened to personal use, which are not an organisation catalogue.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                personal: {
+                    type: 'boolean',
+                    description: 'List the images available to personal agents rather than the organisation catalogue.',
+                },
+                ...ORG_SLUG_PROP,
+            },
+        },
     },
     {
         name: 'list_llm_models',
@@ -837,8 +872,10 @@ export async function handleAgentBuilderTool(name, args, client) {
         }
         // ─── Agent CRUD ────────────────────────────────────────────────────────
         case 'list_agents': {
-            const parsed = z.object({ org_slug: orgSlugField }).parse(args);
-            const agents = await client.listAgents(resolveOrg(parsed));
+            const parsed = z
+                .object({ scope: z.enum(['org', 'personal']).optional(), org_slug: orgSlugField })
+                .parse(args);
+            const agents = await client.listAgents(resolveOrg(parsed), parsed.scope);
             return { content: [{ type: 'text', text: text(agents) }] };
         }
         case 'get_agent': {
@@ -854,13 +891,21 @@ export async function handleAgentBuilderTool(name, args, client) {
                 container_image_id: z.string(),
                 name: z.string(),
                 config: z.record(z.unknown()).optional(),
+                personal: z.boolean().optional(),
+                handle: z.string().optional(),
                 org_slug: orgSlugField,
+            })
+                .refine((v) => !v.personal || !!v.handle, {
+                message: 'handle is required with personal=true',
+                path: ['handle'],
             })
                 .parse(args);
             const agent = await client.createAgent({
                 containerImageId: parsed.container_image_id,
                 name: parsed.name,
                 config: parsed.config,
+                personal: parsed.personal,
+                handleName: parsed.handle,
             }, resolveOrg(parsed));
             return {
                 content: [
@@ -1427,8 +1472,10 @@ export async function handleAgentBuilderTool(name, args, client) {
         }
         // ─── Discovery ────────────────────────────────────────────────────────────
         case 'list_container_images': {
-            const parsed = z.object({ org_slug: orgSlugField }).parse(args);
-            const images = await client.listContainerImages(resolveOrg(parsed));
+            const parsed = z
+                .object({ personal: z.boolean().optional(), org_slug: orgSlugField })
+                .parse(args);
+            const images = await client.listContainerImages(resolveOrg(parsed), parsed.personal);
             return { content: [{ type: 'text', text: text(images) }] };
         }
         case 'list_llm_models': {

package/dist/agentBuilderTools.test.js

@@ -144,3 +144,51 @@ describe('schedule pre-flight over MCP (#2083)', () => {
         expect(Object.keys(properties)).not.toContain('scheduling_enabled');
     });
 });
+// #2273 — My Agents reached over MCP. There is no second tool set: a personal
+// agent is addressed by the same tools and the same agent_id as an org one, so
+// what these cover is the three tools that had to learn the difference.
+describe('personal agents over MCP (#2273)', () => {
+    function fake(method, result) {
+        const fn = vi.fn().mockResolvedValue(result);
+        return { client: { [method]: fn }, fn };
+    }
+    it('list_agents offers both scopes and defaults to neither being sent', async () => {
+        const scope = toolNamed('list_agents').inputSchema.properties.scope;
+        expect(scope.enum).toEqual(['org', 'personal']);
+        const { client, fn } = fake('listAgents', []);
+        await handleAgentBuilderTool('list_agents', {}, client);
+        expect(fn.mock.calls[0][1]).toBeUndefined();
+    });
+    it('list_agents passes the personal scope through', async () => {
+        const { client, fn } = fake('listAgents', [{ id: 'agent-1' }]);
+        await handleAgentBuilderTool('list_agents', { scope: 'personal' }, client);
+        expect(fn.mock.calls[0][1]).toBe('personal');
+    });
+    it('create_agent sends the personal flag and the handle', async () => {
+        const { client, fn } = fake('createAgent', { userId: 'agent_1' });
+        await handleAgentBuilderTool('create_agent', {
+            container_image_id: 'image-1',
+            name: 'Raiven',
+            personal: true,
+            handle: 'raiven',
+        }, client);
+        expect(fn.mock.calls[0][0]).toMatchObject({ personal: true, handleName: 'raiven' });
+    });
+    // A personal agent's handle is required, so say so here rather than spending a
+    // round trip to learn it from the backend.
+    it('create_agent refuses personal without a handle', async () => {
+        const { client, fn } = fake('createAgent', { userId: 'agent_1' });
+        await expect(handleAgentBuilderTool('create_agent', { container_image_id: 'image-1', name: 'Raiven', personal: true }, client)).rejects.toThrow('handle is required with personal=true');
+        expect(fn).not.toHaveBeenCalled();
+    });
+    it('create_agent stays organisational when the flag is left off', async () => {
+        const { client, fn } = fake('createAgent', { userId: 'agent_1' });
+        await handleAgentBuilderTool('create_agent', { container_image_id: 'image-1', name: 'Scout' }, client);
+        expect(fn.mock.calls[0][0].personal).toBeUndefined();
+    });
+    it('list_container_images asks for the personal catalogue', async () => {
+        const { client, fn } = fake('listContainerImages', []);
+        await handleAgentBuilderTool('list_container_images', { personal: true }, client);
+        expect(fn.mock.calls[0][1]).toBe(true);
+    });
+});

package/dist/client.js

@@ -525,6 +525,28 @@ export class WolfpackClient {
         const query = params.toString();
         return this.api.get(`/tags${query ? `?${query}` : ''}`);
     }
+    async createTag(input, teamSlug) {
+        return this.api.post('/tags', { ...input, teamSlug });
+    }
+    async updateTag(tag, input, teamSlug) {
+        return this.api.patch(`/tags/${encodeURIComponent(tag)}`, { ...input, teamSlug });
+    }
+    async listTagGroups(teamSlug) {
+        const params = new URLSearchParams();
+        if (teamSlug)
+            params.append('teamSlug', teamSlug);
+        const query = params.toString();
+        return this.api.get(`/tag-groups${query ? `?${query}` : ''}`);
+    }
+    async createTagGroup(input, teamSlug) {
+        return this.api.post('/tag-groups', { ...input, teamSlug });
+    }
+    async updateTagGroup(group, input, teamSlug) {
+        return this.api.patch(`/tag-groups/${encodeURIComponent(group)}`, {
+            ...input,
+            teamSlug,
+        });
+    }
     /**
      * Upload an image and get back a URL that can be used in markdown content.
      */
@@ -651,8 +673,9 @@ export class WolfpackClient {
         return response.organisations;
     }
     // ─── Agent Builder: Agent CRUD ─────────────────────────────────────────────
-    async listAgents(orgSlug) {
-        return this.api.get(this.withOrgSlug('/agents', orgSlug));
+    async listAgents(orgSlug, scope) {
+        const path = scope === 'personal' ? '/agents?scope=personal' : '/agents';
+        return this.api.get(this.withOrgSlug(path, orgSlug));
     }
     async getAgent(agentId, orgSlug) {
         try {
@@ -844,8 +867,11 @@ export class WolfpackClient {
         }
     }
     // ─── Agent Builder: Discovery ──────────────────────────────────────────────
-    async listContainerImages(orgSlug) {
-        return this.api.get(this.withOrgSlug('/agent-builder/container-images', orgSlug));
+    async listContainerImages(orgSlug, personal) {
+        const path = personal
+            ? '/agent-builder/container-images?personal=true'
+            : '/agent-builder/container-images';
+        return this.api.get(this.withOrgSlug(path, orgSlug));
     }
     async listLlmModels(orgSlug) {
         return this.api.get(this.withOrgSlug('/agent-builder/llm-models', orgSlug));

package/dist/index.js

@@ -600,6 +600,59 @@ const ListTagsSchema = z.object({
         .optional()
         .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
 });
+const CreateTagSchema = z.object({
+    project_slug: z
+        .string()
+        .optional()
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+    name: z.string().describe('Tag name, unique within the project'),
+    colour: z.string().optional().describe('Hex colour such as #e879f9'),
+    group: z.string().optional().describe('Tag group name or id to file the tag under'),
+    external_id: z
+        .string()
+        .optional()
+        .describe('Id of this tag in the system that maintains it, unique within the project'),
+});
+const UpdateTagSchema = z.object({
+    project_slug: z
+        .string()
+        .optional()
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+    tag: z.string().describe('Tag id or current name'),
+    name: z.string().optional().describe('New name'),
+    colour: z.string().nullable().optional().describe('Hex colour, or null to clear'),
+    group: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Tag group name or id, or null to move the tag out of its group'),
+    external_id: z.string().nullable().optional().describe('External id, or null to clear'),
+    archived: z
+        .boolean()
+        .optional()
+        .describe('true archives the tag (soft delete), false restores it'),
+});
+const CreateTagGroupSchema = z.object({
+    project_slug: z
+        .string()
+        .optional()
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+    name: z.string().describe('Group name, unique within the project'),
+    parent: z.string().optional().describe('Parent group name or id'),
+});
+const UpdateTagGroupSchema = z.object({
+    project_slug: z
+        .string()
+        .optional()
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+    group: z.string().describe('Group id or current name'),
+    name: z.string().optional().describe('New name'),
+    parent: z
+        .string()
+        .nullable()
+        .optional()
+        .describe('Parent group name or id, or null for the top level'),
+});
 // Team member schemas
 const ListTeamMembersSchema = z.object({
     project_slug: z
@@ -814,6 +867,9 @@ class WolfpackMCPServer {
                             'assigned_to_id you pass; the response says so when this applies. ' +
                             'AGENTS: when more than one item is claimable, the response also states the order to take ' +
                             'them in (bug fixes first, then higher priority, then oldest) and which to pull next. ' +
+                            'AGENTS: blockedBy on each item names the prerequisites of it that have not finished. An item ' +
+                            'with a non-empty blockedBy is NOT claimable however approved it is — take the work it names ' +
+                            'first; the response says so too. ' +
                             'TERMINOLOGY: "board" and "kanban" are synonymous - both refer to the Kanban board of work items. ' +
                             'The board has columns: "new" (to do), "doing" (in progress), "review" (pending review), "ready" (code done, awaiting deployment), "blocked", "completed" (deployed). ' +
                             'The "backlog" or "pending" status represents items not yet on the board. ' +
@@ -1937,8 +1993,23 @@ class WolfpackMCPServer {
                     // Tag tools
                     {
                         name: 'list_tags',
-                        description: 'List all tags available in a project. Returns tag names and colours. ' +
-                            'Work items are tagged by name via update_work_item.',
+                        description: 'List all tags of a project: id, name, colour, external id, the group each is filed under, and whether it is archived. ' +
+                            'Items are tagged by name via update_work_item / update_issue; archived tags cannot be applied. ' +
+                            'A sync from an external system (e.g. a CRM) keys on externalId.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                            },
+                        },
+                    },
+                    {
+                        name: 'create_tag',
+                        description: 'Create a tag in a project. Project admins only (mcp:tags:manage). ' +
+                            'Set external_id when the tag mirrors a record in another system, so a later sync can find it by id rather than name.',
                         inputSchema: {
                             type: 'object',
                             properties: {
@@ -1946,7 +2017,99 @@ class WolfpackMCPServer {
                                     type: 'string',
                                     description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
                                 },
+                                name: { type: 'string', description: 'Tag name, unique within the project' },
+                                colour: { type: 'string', description: 'Hex colour such as #e879f9 (optional)' },
+                                group: {
+                                    type: 'string',
+                                    description: 'Tag group name or id to file the tag under (optional, see list_tag_groups)',
+                                },
+                                external_id: {
+                                    type: 'string',
+                                    description: 'Id of this tag in the system that maintains it, unique within the project (optional)',
+                                },
                             },
+                            required: ['name'],
+                        },
+                    },
+                    {
+                        name: 'update_tag',
+                        description: 'Rename, recolour, regroup, re-key or archive a tag. Project admins only (mcp:tags:manage). ' +
+                            'Only the fields given change; pass null for colour, group or external_id to clear it. ' +
+                            'archived: true is the soft delete — the tag stays on the items that carry it but no picker offers it; archived: false restores it.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                                tag: { type: 'string', description: 'Tag id or current name' },
+                                name: { type: 'string', description: 'New name' },
+                                colour: { type: ['string', 'null'], description: 'Hex colour, or null to clear' },
+                                group: {
+                                    type: ['string', 'null'],
+                                    description: 'Tag group name or id, or null to move the tag out of its group',
+                                },
+                                external_id: {
+                                    type: ['string', 'null'],
+                                    description: 'External id, or null to clear',
+                                },
+                                archived: {
+                                    type: 'boolean',
+                                    description: 'true archives the tag (soft delete), false restores it',
+                                },
+                            },
+                            required: ['tag'],
+                        },
+                    },
+                    {
+                        name: 'list_tag_groups',
+                        description: 'List the tag groups of a project with their parent and full path (groups nest, e.g. "Customers › EMEA").',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                            },
+                        },
+                    },
+                    {
+                        name: 'create_tag_group',
+                        description: 'Create a tag group, optionally inside a parent group. Project admins only (mcp:tags:manage).',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                                name: { type: 'string', description: 'Group name, unique within the project' },
+                                parent: { type: 'string', description: 'Parent group name or id (optional)' },
+                            },
+                            required: ['name'],
+                        },
+                    },
+                    {
+                        name: 'update_tag_group',
+                        description: 'Rename a tag group or move it under another parent. Project admins only (mcp:tags:manage). ' +
+                            'Pass parent: null for the top level.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                                group: { type: 'string', description: 'Group id or current name' },
+                                name: { type: 'string', description: 'New name' },
+                                parent: {
+                                    type: ['string', 'null'],
+                                    description: 'Parent group name or id, or null for the top level',
+                                },
+                            },
+                            required: ['group'],
                         },
                     },
                     // Team member tools
@@ -3086,6 +3249,52 @@ class WolfpackMCPServer {
                             content: [{ type: 'text', text: JSON.stringify(tags, null, 2) }],
                         };
                     }
+                    case 'create_tag': {
+                        const parsed = CreateTagSchema.parse(args);
+                        const tag = await this.client.createTag({
+                            name: parsed.name,
+                            colour: parsed.colour,
+                            group: parsed.group,
+                            externalId: parsed.external_id,
+                        }, parsed.project_slug || this.client.getProjectSlug() || undefined);
+                        return {
+                            content: [{ type: 'text', text: JSON.stringify(tag, null, 2) }],
+                        };
+                    }
+                    case 'update_tag': {
+                        const parsed = UpdateTagSchema.parse(args);
+                        const tag = await this.client.updateTag(parsed.tag, {
+                            name: parsed.name,
+                            colour: parsed.colour,
+                            group: parsed.group,
+                            externalId: parsed.external_id,
+                            archived: parsed.archived,
+                        }, parsed.project_slug || this.client.getProjectSlug() || undefined);
+                        return {
+                            content: [{ type: 'text', text: JSON.stringify(tag, null, 2) }],
+                        };
+                    }
+                    case 'list_tag_groups': {
+                        const parsed = ListTagsSchema.parse(args);
+                        const groups = await this.client.listTagGroups(parsed.project_slug || this.client.getProjectSlug() || undefined);
+                        return {
+                            content: [{ type: 'text', text: JSON.stringify(groups, null, 2) }],
+                        };
+                    }
+                    case 'create_tag_group': {
+                        const parsed = CreateTagGroupSchema.parse(args);
+                        const group = await this.client.createTagGroup({ name: parsed.name, parent: parsed.parent }, parsed.project_slug || this.client.getProjectSlug() || undefined);
+                        return {
+                            content: [{ type: 'text', text: JSON.stringify(group, null, 2) }],
+                        };
+                    }
+                    case 'update_tag_group': {
+                        const parsed = UpdateTagGroupSchema.parse(args);
+                        const group = await this.client.updateTagGroup(parsed.group, { name: parsed.name, parent: parsed.parent }, parsed.project_slug || this.client.getProjectSlug() || undefined);
+                        return {
+                            content: [{ type: 'text', text: JSON.stringify(group, null, 2) }],
+                        };
+                    }
                     // Team member handlers
                     case 'list_team_members': {
                         const parsed = ListTeamMembersSchema.parse(args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wolfpack-mcp",
-  "version": "1.0.93",
+  "version": "1.0.95",
   "description": "MCP server for Wolfpack AI-enhanced software delivery tools",
   "main": "dist/index.js",
   "type": "module",
@@ -45,9 +45,9 @@
     "@eslint/js": "^9.17.0",
     "@types/node": "^22.12.0",
     "eslint": "^9.17.0",
-    "tsx": "^4.20.0",
+    "tsx": "^4.23.12",
     "typescript": "^5.7.3",
-    "typescript-eslint": "^8.21.0",
-    "vitest": "^4.0.16"
+    "typescript-eslint": "^8.68.0",
+    "vitest": "^4.1.11"
   }
 }