paperclip-mcp 1.0.0

package/dist/tools/approvals.js

@@ -0,0 +1,306 @@
+import { z } from "zod";
+import { validate, handleApiError } from "./validation.js";
+const ApprovalIdInput = z.object({
+    approvalId: z.string().min(1).describe("Approval UUID"),
+});
+const ListApprovalsInput = z.object({
+    status: z.string().optional().describe("Filter by status (e.g. 'pending,approved')"),
+});
+const CreateApprovalInput = z.object({
+    title: z.string().min(1).describe("Approval request title"),
+    description: z.string().optional().describe("Description / justification (markdown)"),
+    linkedIssueIds: z.array(z.string()).optional().describe("Issue UUIDs to link to this approval"),
+});
+const ApprovalCommentInput = z.object({
+    approvalId: z.string().min(1).describe("Approval UUID"),
+    body: z.string().min(1).describe("Comment body (markdown)"),
+});
+const RejectInput = z.object({
+    approvalId: z.string().min(1).describe("Approval UUID"),
+    reason: z.string().optional().describe("Reason for rejection"),
+});
+const RequestRevisionInput = z.object({
+    approvalId: z.string().min(1).describe("Approval UUID"),
+    feedback: z.string().optional().describe("Feedback on what needs to change"),
+});
+const ResubmitInput = z.object({
+    approvalId: z.string().min(1).describe("Approval UUID"),
+    comment: z.string().optional().describe("Summary of changes made"),
+});
+const CreateAgentHireInput = z.object({
+    name: z.string().min(1).describe("Agent display name"),
+    role: z.string().min(1).describe("Agent role (e.g. engineer, cto)"),
+    title: z.string().optional().describe("Job title"),
+    capabilities: z.string().optional().describe("Free-text capability description"),
+    goalId: z.string().optional().describe("Goal UUID to link the hire to"),
+    projectId: z.string().optional().describe("Project UUID to associate"),
+});
+export const approvalTools = [
+    {
+        name: "paperclip_list_approvals",
+        description: "List approval requests for the current company. Optionally filter by status (comma-separated).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                status: {
+                    type: "string",
+                    description: "Comma-separated status values (e.g. 'pending,approved')",
+                },
+            },
+            required: [],
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const input = validate(ListApprovalsInput, args);
+                const params = new URLSearchParams();
+                if (input.status)
+                    params.set("status", input.status);
+                const qs = params.toString();
+                const path = `/api/companies/${client.companyId}/approvals${qs ? `?${qs}` : ""}`;
+                const data = await client.get(path);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_get_approval",
+        description: "Get a single approval request by ID, including its status and linked issues.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                approvalId: { type: "string", description: "Approval UUID" },
+            },
+            required: ["approvalId"],
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { approvalId } = validate(ApprovalIdInput, args);
+                const data = await client.get(`/api/approvals/${approvalId}`);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_create_approval",
+        description: "Create a new approval request. Run ID header is injected automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                title: { type: "string", description: "Approval request title" },
+                description: { type: "string", description: "Description / justification (markdown)" },
+                linkedIssueIds: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Issue UUIDs to link to this approval",
+                },
+            },
+            required: ["title"],
+        },
+        annotations: { destructiveHint: false, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const input = validate(CreateApprovalInput, args);
+                const body = { title: input.title };
+                if (input.description !== undefined)
+                    body.description = input.description;
+                if (input.linkedIssueIds !== undefined)
+                    body.linkedIssueIds = input.linkedIssueIds;
+                const data = await client.post(`/api/companies/${client.companyId}/approvals`, body);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_approve",
+        description: "Approve an approval request. Run ID header is injected automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                approvalId: { type: "string", description: "Approval UUID" },
+            },
+            required: ["approvalId"],
+        },
+        annotations: { destructiveHint: true, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { approvalId } = validate(ApprovalIdInput, args);
+                const data = await client.post(`/api/approvals/${approvalId}/approve`);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_reject",
+        description: "Reject an approval request. Run ID header is injected automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                approvalId: { type: "string", description: "Approval UUID" },
+                reason: { type: "string", description: "Reason for rejection" },
+            },
+            required: ["approvalId"],
+        },
+        annotations: { destructiveHint: true, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { approvalId, reason } = validate(RejectInput, args);
+                const body = {};
+                if (reason !== undefined)
+                    body.reason = reason;
+                const data = await client.post(`/api/approvals/${approvalId}/reject`, body);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_request_revision",
+        description: "Request a revision on a pending approval. Run ID header is injected automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                approvalId: { type: "string", description: "Approval UUID" },
+                feedback: { type: "string", description: "Feedback on what needs to change" },
+            },
+            required: ["approvalId"],
+        },
+        annotations: { destructiveHint: false, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { approvalId, feedback } = validate(RequestRevisionInput, args);
+                const body = {};
+                if (feedback !== undefined)
+                    body.feedback = feedback;
+                const data = await client.post(`/api/approvals/${approvalId}/request-revision`, body);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_resubmit_approval",
+        description: "Resubmit an approval request after addressing revision feedback. Run ID header is injected automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                approvalId: { type: "string", description: "Approval UUID" },
+                comment: { type: "string", description: "Summary of changes made" },
+            },
+            required: ["approvalId"],
+        },
+        annotations: { destructiveHint: false, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { approvalId, comment } = validate(ResubmitInput, args);
+                const body = {};
+                if (comment !== undefined)
+                    body.comment = comment;
+                const data = await client.post(`/api/approvals/${approvalId}/resubmit`, body);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_list_approval_comments",
+        description: "List comments on an approval request.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                approvalId: { type: "string", description: "Approval UUID" },
+            },
+            required: ["approvalId"],
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { approvalId } = validate(ApprovalIdInput, args);
+                const data = await client.get(`/api/approvals/${approvalId}/comments`);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_add_approval_comment",
+        description: "Post a markdown comment on an approval request. Run ID header is injected automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                approvalId: { type: "string", description: "Approval UUID" },
+                body: { type: "string", description: "Comment body (markdown)" },
+            },
+            required: ["approvalId", "body"],
+        },
+        annotations: { destructiveHint: false, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { approvalId, body } = validate(ApprovalCommentInput, args);
+                const data = await client.post(`/api/approvals/${approvalId}/comments`, { body });
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_create_agent_hire",
+        description: "Create an agent hire request (triggers the approval and onboarding flow). Run ID header is injected automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Agent display name" },
+                role: { type: "string", description: "Agent role (e.g. engineer, cto)" },
+                title: { type: "string", description: "Job title" },
+                capabilities: { type: "string", description: "Free-text capability description" },
+                goalId: { type: "string", description: "Goal UUID to link the hire to" },
+                projectId: { type: "string", description: "Project UUID to associate" },
+            },
+            required: ["name", "role"],
+        },
+        annotations: { destructiveHint: false, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const input = validate(CreateAgentHireInput, args);
+                const body = { name: input.name, role: input.role };
+                if (input.title !== undefined)
+                    body.title = input.title;
+                if (input.capabilities !== undefined)
+                    body.capabilities = input.capabilities;
+                if (input.goalId !== undefined)
+                    body.goalId = input.goalId;
+                if (input.projectId !== undefined)
+                    body.projectId = input.projectId;
+                const data = await client.post(`/api/companies/${client.companyId}/agent-hires`, body);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+];
+//# sourceMappingURL=approvals.js.map

package/dist/tools/approvals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../../src/tools/approvals.ts"],"names":[],"mappings":"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"}

package/dist/tools/attachments.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "./index.js";
+export declare const attachmentTools: ToolDefinition[];
+//# sourceMappingURL=attachments.d.ts.map

package/dist/tools/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../src/tools/attachments.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAsBjD,eAAO,MAAM,eAAe,EAAE,cAAc,EAuG3C,CAAC"}

package/dist/tools/attachments.js

@@ -0,0 +1,125 @@
+import { z } from "zod";
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+import { validate, IssueIdSchema, handleApiError } from "./validation.js";
+const ListAttachmentsInput = IssueIdSchema;
+const UploadAttachmentInput = z.object({
+    issueId: z.string().min(1).describe("Issue ID or identifier (e.g. PAP-22)"),
+    filePath: z.string().min(1).describe("Absolute path to the local file to upload"),
+    filename: z
+        .string()
+        .optional()
+        .describe("Override filename in the upload (defaults to basename of filePath)"),
+    mimeType: z
+        .string()
+        .optional()
+        .describe("MIME type of the file (e.g. text/plain, application/pdf)"),
+});
+const AttachmentIdInput = z.object({
+    attachmentId: z.string().min(1).describe("Attachment UUID"),
+});
+export const attachmentTools = [
+    {
+        name: "paperclip_list_attachments",
+        description: "List all attachments on an issue.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                issueId: { type: "string", description: "Issue ID or identifier (e.g. PAP-22)" },
+            },
+            required: ["issueId"],
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { issueId } = validate(ListAttachmentsInput, args);
+                const data = await client.get(`/api/issues/${issueId}/attachments`);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_upload_attachment",
+        description: "Upload a local file as an attachment to an issue. Provide the absolute file path. Run ID header is injected automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                issueId: { type: "string", description: "Issue ID or identifier (e.g. PAP-22)" },
+                filePath: { type: "string", description: "Absolute path to the local file to upload" },
+                filename: {
+                    type: "string",
+                    description: "Override filename in the upload (defaults to basename of filePath)",
+                },
+                mimeType: {
+                    type: "string",
+                    description: "MIME type of the file (e.g. text/plain, application/pdf)",
+                },
+            },
+            required: ["issueId", "filePath"],
+        },
+        annotations: { destructiveHint: false, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { issueId, filePath, filename, mimeType } = validate(UploadAttachmentInput, args);
+                const fileBuffer = await readFile(filePath);
+                const uploadName = filename ?? basename(filePath);
+                const form = new FormData();
+                const blob = new Blob([fileBuffer], { type: mimeType ?? "application/octet-stream" });
+                form.append("file", blob, uploadName);
+                const data = await client.postForm(`/api/companies/${client.companyId}/issues/${issueId}/attachments`, form);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_download_attachment",
+        description: "Download the content of an attachment by ID. Returns the content as base64.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                attachmentId: { type: "string", description: "Attachment UUID" },
+            },
+            required: ["attachmentId"],
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { attachmentId } = validate(AttachmentIdInput, args);
+                const data = await client.get(`/api/attachments/${attachmentId}/content`);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_delete_attachment",
+        description: "Delete an attachment from an issue. Run ID header is injected automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                attachmentId: { type: "string", description: "Attachment UUID" },
+            },
+            required: ["attachmentId"],
+        },
+        annotations: { destructiveHint: true, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { attachmentId } = validate(AttachmentIdInput, args);
+                const data = await client.delete(`/api/attachments/${attachmentId}`);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+];
+//# sourceMappingURL=attachments.js.map

package/dist/tools/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../src/tools/attachments.ts"],"names":[],"mappings":"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"}

package/dist/tools/comments.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "./index.js";
+export declare const commentTools: ToolDefinition[];
+//# sourceMappingURL=comments.d.ts.map

package/dist/tools/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../src/tools/comments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAcjD,eAAO,MAAM,YAAY,EAAE,cAAc,EA4DxC,CAAC"}

package/dist/tools/comments.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import { validate, handleApiError } from "./validation.js";
+const ListCommentsInput = z.object({
+    issueId: z.string().min(1),
+    after: z.string().optional(),
+    order: z.enum(["asc", "desc"]).optional(),
+});
+const AddCommentInput = z.object({
+    issueId: z.string().min(1),
+    body: z.string().min(1),
+});
+export const commentTools = [
+    {
+        name: "paperclip_list_comments",
+        description: "List comments for an issue. Supports cursor-based incremental fetching via the `after` parameter.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                issueId: { type: "string", description: "Issue ID or identifier (e.g. PAP-21)" },
+                after: {
+                    type: "string",
+                    description: "Comment ID cursor — returns only comments posted after this ID",
+                },
+                order: {
+                    type: "string",
+                    enum: ["asc", "desc"],
+                    description: "Sort order (default: asc)",
+                },
+            },
+            required: ["issueId"],
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const input = validate(ListCommentsInput, args);
+                const params = new URLSearchParams();
+                if (input.after)
+                    params.set("after", input.after);
+                if (input.order)
+                    params.set("order", input.order);
+                const qs = params.toString();
+                const path = `/api/issues/${input.issueId}/comments${qs ? `?${qs}` : ""}`;
+                const data = await client.get(path);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+    {
+        name: "paperclip_add_comment",
+        description: "Post a markdown comment on an issue. Run ID header is injected automatically for audit trail.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                issueId: { type: "string", description: "Issue ID or identifier (e.g. PAP-21)" },
+                body: { type: "string", description: "Comment body (markdown)" },
+            },
+            required: ["issueId", "body"],
+        },
+        annotations: { destructiveHint: false, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                const { issueId, body } = validate(AddCommentInput, args);
+                const data = await client.post(`/api/issues/${issueId}/comments`, { body });
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+];
+//# sourceMappingURL=comments.js.map

package/dist/tools/comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../src/tools/comments.ts"],"names":[],"mappings":"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"}

package/dist/tools/dashboard.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "./index.js";
+export declare const dashboardTools: ToolDefinition[];
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/tools/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/tools/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,eAAO,MAAM,cAAc,EAAE,cAAc,EAqB1C,CAAC"}

package/dist/tools/dashboard.js

@@ -0,0 +1,24 @@
+import { validate, NoInput, handleApiError } from "./validation.js";
+export const dashboardTools = [
+    {
+        name: "paperclip_get_dashboard",
+        description: "Return the company-level health summary including active goals, projects, issues by status, and agent workload.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+        async handler(args, client) {
+            try {
+                validate(NoInput, args);
+                const data = await client.get(`/api/companies/${client.companyId}/dashboard`);
+                return { content: [{ type: "text", text: JSON.stringify(data) }] };
+            }
+            catch (err) {
+                return handleApiError(err);
+            }
+        },
+    },
+];
+//# sourceMappingURL=dashboard.js.map

package/dist/tools/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/tools/dashboard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEpE,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EACT,iHAAiH;QACnH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;QACzD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM;YACxB,IAAI,CAAC;gBACH,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACxB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAU,kBAAkB,MAAM,CAAC,SAAS,YAAY,CAAC,CAAC;gBACvF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACrE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;KACF;CACF,CAAC"}

package/dist/tools/documents.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "./index.js";
+export declare const documentTools: ToolDefinition[];
+//# sourceMappingURL=documents.d.ts.map

package/dist/tools/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAwBjD,eAAO,MAAM,aAAa,EAAE,cAAc,EA+HzC,CAAC"}