@voxos-ai/clink-mcp-server 0.4.0

package/dist/tools/release_clink.d.ts

@@ -0,0 +1,23 @@
+/**
+ * release_clink tool - Release a claimed clink without completing
+ */
+export declare const definition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            clink_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+interface ReleaseClinkArgs {
+    clink_id: string;
+}
+export declare function handler(args: ReleaseClinkArgs): Promise<string>;
+export {};
+//# sourceMappingURL=release_clink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"release_clink.d.ts","sourceRoot":"","sources":["../../src/tools/release_clink.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAatB,CAAC;AAEF,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBrE"}

package/dist/tools/release_clink.js

@@ -0,0 +1,42 @@
+/**
+ * release_clink tool - Release a claimed clink without completing
+ */
+import { releaseClink } from '../client.js';
+import { ClinkApiError } from '../types.js';
+export const definition = {
+    name: 'release_clink',
+    description: 'Release a claimed clink without completing it. The clink returns to the pending queue for another worker to process. Use this when you cannot complete the task.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            clink_id: {
+                type: 'string',
+                description: 'The clink ID to release',
+            },
+        },
+        required: ['clink_id'],
+    },
+};
+export async function handler(args) {
+    try {
+        const { clink_id } = args;
+        if (!clink_id) {
+            return 'Please provide a clink_id to release.';
+        }
+        const clink = await releaseClink(clink_id);
+        return `Clink released successfully!\n\nClink ID: ${clink.clink_id}\nStatus: ${clink.status}\n\nThe clink is now available for other workers to claim.`;
+    }
+    catch (error) {
+        if (error instanceof ClinkApiError) {
+            if (error.statusCode === 403) {
+                return `Cannot release: This clink is claimed by another user.`;
+            }
+            if (error.statusCode === 400) {
+                return `Cannot release: ${error.message}`;
+            }
+            return `Error: ${error.message}`;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=release_clink.js.map

package/dist/tools/release_clink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release_clink.js","sourceRoot":"","sources":["../../src/tools/release_clink.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,kKAAkK;IAC/K,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yBAAyB;aACvC;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB;CACF,CAAC;AAMF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAsB;IAClD,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAE1B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,uCAAuC,CAAC;QACjD,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;QAE3C,OAAO,6CAA6C,KAAK,CAAC,QAAQ,aAAa,KAAK,CAAC,MAAM,4DAA4D,CAAC;IAC1J,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC7B,OAAO,wDAAwD,CAAC;YAClE,CAAC;YACD,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC7B,OAAO,mBAAmB,KAAK,CAAC,OAAO,EAAE,CAAC;YAC5C,CAAC;YACD,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/tools/reopen_milestone.d.ts

@@ -0,0 +1,23 @@
+/**
+ * reopen_milestone tool - Re-open a closed milestone
+ */
+export declare const definition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            milestone_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+interface ReopenMilestoneArgs {
+    milestone_id: string;
+}
+export declare function handler(args: ReopenMilestoneArgs): Promise<string>;
+export {};
+//# sourceMappingURL=reopen_milestone.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reopen_milestone.d.ts","sourceRoot":"","sources":["../../src/tools/reopen_milestone.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAatB,CAAC;AAEF,UAAU,mBAAmB;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCxE"}

package/dist/tools/reopen_milestone.js

@@ -0,0 +1,54 @@
+/**
+ * reopen_milestone tool - Re-open a closed milestone
+ */
+import { reopenMilestone } from '../client.js';
+import { ClinkApiError } from '../types.js';
+export const definition = {
+    name: 'reopen_milestone',
+    description: 'Re-open a closed milestone. This allows adding new checkpoints or completing remaining ones.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            milestone_id: {
+                type: 'string',
+                description: 'The milestone ID to reopen',
+            },
+        },
+        required: ['milestone_id'],
+    },
+};
+export async function handler(args) {
+    try {
+        const { milestone_id } = args;
+        if (!milestone_id) {
+            return 'Please provide a milestone_id.';
+        }
+        const milestone = await reopenMilestone(milestone_id);
+        let output = `Milestone reopened!\n\n`;
+        output += `Title: ${milestone.title}\n`;
+        output += `Status: ${milestone.status}\n`;
+        output += `Progress: ${milestone.progress}\n\n`;
+        output += `Checkpoints:\n`;
+        for (const cp of milestone.checkpoints || []) {
+            const statusIcon = cp.status === 'completed' ? '[done]' : '[pending]';
+            let annotations = [];
+            if (cp.requires_proposal_id)
+                annotations.push('requires consensus');
+            if (cp.depends_on && cp.depends_on.length > 0)
+                annotations.push(`depends on: ${cp.depends_on.join(', ')}`);
+            const annotationStr = annotations.length > 0 ? ` [${annotations.join('; ')}]` : '';
+            output += `  ${cp.order}. ${cp.title} ${statusIcon}${annotationStr}\n`;
+        }
+        return output;
+    }
+    catch (error) {
+        if (error instanceof ClinkApiError) {
+            if (error.message.includes('not closed')) {
+                return `Error: This milestone is not closed. Only closed milestones can be reopened.`;
+            }
+            return `Error: ${error.message}`;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=reopen_milestone.js.map

package/dist/tools/reopen_milestone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reopen_milestone.js","sourceRoot":"","sources":["../../src/tools/reopen_milestone.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,8FAA8F;IAC3G,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;aAC1C;SACF;QACD,QAAQ,EAAE,CAAC,cAAc,CAAC;KAC3B;CACF,CAAC;AAMF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAyB;IACrD,IAAI,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;QAE9B,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,gCAAgC,CAAC;QAC1C,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,YAAY,CAAC,CAAC;QAEtD,IAAI,MAAM,GAAG,yBAAyB,CAAC;QACvC,MAAM,IAAI,UAAU,SAAS,CAAC,KAAK,IAAI,CAAC;QACxC,MAAM,IAAI,WAAW,SAAS,CAAC,MAAM,IAAI,CAAC;QAC1C,MAAM,IAAI,aAAa,SAAS,CAAC,QAAQ,MAAM,CAAC;QAEhD,MAAM,IAAI,gBAAgB,CAAC;QAC3B,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,UAAU,GAAG,EAAE,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC;YACtE,IAAI,WAAW,GAAG,EAAE,CAAC;YACrB,IAAI,EAAE,CAAC,oBAAoB;gBAAE,WAAW,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACpE,IAAI,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;gBAAE,WAAW,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC3G,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACnF,MAAM,IAAI,KAAK,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,KAAK,IAAI,UAAU,GAAG,aAAa,IAAI,CAAC;QACzE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACzC,OAAO,8EAA8E,CAAC;YACxF,CAAC;YACD,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/tools/reopen_project.d.ts

@@ -0,0 +1,23 @@
+/**
+ * reopen_project tool - Reopen a completed or archived project
+ */
+export declare const definition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            project_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+interface ReopenProjectArgs {
+    project_id: string;
+}
+export declare function handler(args: ReopenProjectArgs): Promise<string>;
+export {};
+//# sourceMappingURL=reopen_project.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reopen_project.d.ts","sourceRoot":"","sources":["../../src/tools/reopen_project.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAatB,CAAC;AAEF,UAAU,iBAAiB;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BtE"}

package/dist/tools/reopen_project.js

@@ -0,0 +1,44 @@
+/**
+ * reopen_project tool - Reopen a completed or archived project
+ */
+import { reopenProject } from '../client.js';
+import { ClinkApiError } from '../types.js';
+export const definition = {
+    name: 'reopen_project',
+    description: 'Re-open a completed or archived project. This allows adding new milestones or continuing work.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            project_id: {
+                type: 'string',
+                description: 'The project ID to reopen',
+            },
+        },
+        required: ['project_id'],
+    },
+};
+export async function handler(args) {
+    try {
+        const { project_id } = args;
+        if (!project_id) {
+            return 'Please provide a project_id.';
+        }
+        const project = await reopenProject(project_id);
+        let output = `Project reopened!\n\n`;
+        output += `Title: ${project.title}\n`;
+        output += `ID: ${project.project_id}\n`;
+        output += `Status: ${project.status}\n`;
+        if (project.reopened_at) {
+            output += `Reopened at: ${new Date(project.reopened_at).toLocaleString()}\n`;
+        }
+        output += `\nYou can now add milestones or continue work on this project.`;
+        return output;
+    }
+    catch (error) {
+        if (error instanceof ClinkApiError) {
+            return `Error: ${error.message}`;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=reopen_project.js.map

package/dist/tools/reopen_project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reopen_project.js","sourceRoot":"","sources":["../../src/tools/reopen_project.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,gGAAgG;IAC7G,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0BAA0B;aACxC;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;CACF,CAAC;AAMF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAuB;IACnD,IAAI,CAAC;QACH,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAE5B,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,8BAA8B,CAAC;QACxC,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;QAEhD,IAAI,MAAM,GAAG,uBAAuB,CAAC;QACrC,MAAM,IAAI,UAAU,OAAO,CAAC,KAAK,IAAI,CAAC;QACtC,MAAM,IAAI,OAAO,OAAO,CAAC,UAAU,IAAI,CAAC;QACxC,MAAM,IAAI,WAAW,OAAO,CAAC,MAAM,IAAI,CAAC;QACxC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,MAAM,IAAI,gBAAgB,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,cAAc,EAAE,IAAI,CAAC;QAC/E,CAAC;QACD,MAAM,IAAI,gEAAgE,CAAC;QAE3E,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/tools/send_clink.d.ts

@@ -0,0 +1,33 @@
+/**
+ * send_clink tool - Send a clink to a group
+ */
+export declare const definition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            group: {
+                type: string;
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+            for: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+interface SendClinkArgs {
+    group: string;
+    content: string;
+    for?: string;
+}
+export declare function handler(args: SendClinkArgs): Promise<string>;
+export {};
+//# sourceMappingURL=send_clink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"send_clink.d.ts","sourceRoot":"","sources":["../../src/tools/send_clink.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CAqBtB,CAAC;AAEF,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAyClE"}

package/dist/tools/send_clink.js

@@ -0,0 +1,64 @@
+/**
+ * send_clink tool - Send a clink to a group
+ */
+import { sendClink, resolveGroup } from '../client.js';
+import { ClinkApiError } from '../types.js';
+export const definition = {
+    name: 'send_clink',
+    description: 'Send a clink to a Clink group. Clinks are visible to all group members. Optionally address the clink to a specific recipient.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            group: {
+                type: 'string',
+                description: 'The group slug (e.g., "backend-team") or group ID',
+            },
+            content: {
+                type: 'string',
+                description: 'The clink content (max 4096 characters)',
+            },
+            for: {
+                type: 'string',
+                description: 'Optional: specific recipient (user_id or agent_profile_id). If set, only they see it in their inbox.',
+            },
+        },
+        required: ['group', 'content'],
+    },
+};
+export async function handler(args) {
+    try {
+        const { group, content } = args;
+        if (!group || !content) {
+            return 'Please provide both a group and content for the clink.';
+        }
+        if (content.length > 4096) {
+            return `Clink too long (${content.length} chars). Maximum is 4096 characters.`;
+        }
+        // Resolve group slug to ID if needed
+        const groupId = await resolveGroup(group);
+        const clink = await sendClink(groupId, content, {
+            forRecipient: args.for,
+        });
+        const timestamp = new Date(clink.created_at).toLocaleString();
+        let output = `Clink sent successfully!\n\nSent at: ${timestamp}\nTo group: ${group}`;
+        if (args.for) {
+            output += `\nFor: ${args.for}`;
+        }
+        output += `\nStatus: ${clink.status}`;
+        output += `\nContent: ${content.substring(0, 200)}${content.length > 200 ? '...' : ''}`;
+        return output;
+    }
+    catch (error) {
+        if (error instanceof ClinkApiError) {
+            if (error.statusCode === 403) {
+                return `You don't have permission to send clinks to this group. Make sure you're a member.`;
+            }
+            if (error.statusCode === 404) {
+                return `Group not found: "${args.group}". Use list_groups to see available groups.`;
+            }
+            return `Error: ${error.message}`;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=send_clink.js.map

package/dist/tools/send_clink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send_clink.js","sourceRoot":"","sources":["../../src/tools/send_clink.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,+HAA+H;IAC5I,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mDAAmD;aACjE;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sGAAsG;aACpH;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;KAC/B;CACF,CAAC;AAQF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAmB;IAC/C,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEhC,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YACvB,OAAO,wDAAwD,CAAC;QAClE,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YAC1B,OAAO,mBAAmB,OAAO,CAAC,MAAM,sCAAsC,CAAC;QACjF,CAAC;QAED,qCAAqC;QACrC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;QAE1C,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE;YAC9C,YAAY,EAAE,IAAI,CAAC,GAAG;SACvB,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,cAAc,EAAE,CAAC;QAE9D,IAAI,MAAM,GAAG,wCAAwC,SAAS,eAAe,KAAK,EAAE,CAAC;QACrF,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,UAAU,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,CAAC;QACD,MAAM,IAAI,aAAa,KAAK,CAAC,MAAM,EAAE,CAAC;QACtC,MAAM,IAAI,cAAc,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAExF,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC7B,OAAO,oFAAoF,CAAC;YAC9F,CAAC;YACD,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC7B,OAAO,qBAAqB,IAAI,CAAC,KAAK,6CAA6C,CAAC;YACtF,CAAC;YACD,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/tools/submit_feedback.d.ts

@@ -0,0 +1,38 @@
+/**
+ * submit_feedback tool - Submit feedback to help improve Clink
+ *
+ * This tool allows agents to submit feedback directly to Voxos to help
+ * improve Clink services. Requires an API key with feedback permission enabled.
+ */
+import { FeedbackCategory } from '../types.js';
+export declare const definition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            category: {
+                type: string;
+                enum: FeedbackCategory[];
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+            tool: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+interface SubmitFeedbackArgs {
+    category: string;
+    content: string;
+    tool?: string;
+}
+export declare function handler(args: SubmitFeedbackArgs): Promise<string>;
+export {};
+//# sourceMappingURL=submit_feedback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"submit_feedback.d.ts","sourceRoot":"","sources":["../../src/tools/submit_feedback.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAiB,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAI9D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;CA8BtB,CAAC;AAEF,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyDvE"}

package/dist/tools/submit_feedback.js

@@ -0,0 +1,93 @@
+/**
+ * submit_feedback tool - Submit feedback to help improve Clink
+ *
+ * This tool allows agents to submit feedback directly to Voxos to help
+ * improve Clink services. Requires an API key with feedback permission enabled.
+ */
+import { submitFeedback } from '../client.js';
+import { ClinkApiError } from '../types.js';
+const VALID_CATEGORIES = ['bug', 'feature', 'improvement', 'other'];
+export const definition = {
+    name: 'submit_feedback',
+    description: `Submit feedback to help improve Clink. This allows you to report bugs, request features, or suggest improvements directly to Voxos.
+
+**Important:** Requires an API key with feedback permission enabled. If you get a permission error, ask the user to create a new API key with feedback permission enabled in the Clink dashboard.
+
+Categories:
+- bug: Report something that isn't working correctly
+- feature: Request a new capability or feature
+- improvement: Suggest enhancements to existing features
+- other: General feedback that doesn't fit other categories`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            category: {
+                type: 'string',
+                enum: VALID_CATEGORIES,
+                description: 'The type of feedback: bug, feature, improvement, or other',
+            },
+            content: {
+                type: 'string',
+                description: 'The feedback content. Be specific and include relevant context (max 8192 characters)',
+            },
+            tool: {
+                type: 'string',
+                description: 'Optional: The tool or feature this feedback relates to',
+            },
+        },
+        required: ['category', 'content'],
+    },
+};
+export async function handler(args) {
+    try {
+        const { category, content, tool } = args;
+        // Validate category
+        if (!category || !VALID_CATEGORIES.includes(category)) {
+            return `Invalid category "${category}". Must be one of: ${VALID_CATEGORIES.join(', ')}`;
+        }
+        // Validate content
+        if (!content || content.trim().length === 0) {
+            return 'Please provide feedback content.';
+        }
+        if (content.length > 8192) {
+            return `Feedback too long (${content.length} characters). Maximum is 8192 characters.`;
+        }
+        // Build context
+        const context = {};
+        if (tool) {
+            context.tool = tool;
+        }
+        // Submit feedback
+        const result = await submitFeedback({
+            category: category,
+            content: content.trim(),
+            context: Object.keys(context).length > 0 ? context : undefined,
+        });
+        const time = new Date(result.submitted_at).toLocaleString();
+        return `Feedback submitted successfully!
+
+ID: ${result.feedback_id}
+Category: ${result.category}
+Submitted: ${time}
+
+Thank you for helping improve Clink! Your feedback will be reviewed by the Voxos team.`;
+    }
+    catch (error) {
+        if (error instanceof ClinkApiError) {
+            if (error.statusCode === 403) {
+                return `Permission denied: ${error.message}
+
+To submit feedback, you need an API key with feedback permission enabled. Ask the user to:
+1. Go to the Clink dashboard (https://app.clink.voxos.ai)
+2. Create a new API key with "Allow feedback submission" enabled
+3. Update the CLINK_API_KEY environment variable`;
+            }
+            if (error.statusCode === 429) {
+                return `Rate limit reached: ${error.message}`;
+            }
+            return `Error: ${error.message}`;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=submit_feedback.js.map

package/dist/tools/submit_feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit_feedback.js","sourceRoot":"","sources":["../../src/tools/submit_feedback.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAoB,MAAM,aAAa,CAAC;AAE9D,MAAM,gBAAgB,GAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;AAExF,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;;4DAQ6C;IAC1D,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EAAE,2DAA2D;aACzE;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sFAAsF;aACpG;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wDAAwD;aACtE;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;KAClC;CACF,CAAC;AAQF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAwB;IACpD,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzC,oBAAoB;QACpB,IAAI,CAAC,QAAQ,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAA4B,CAAC,EAAE,CAAC;YAC1E,OAAO,qBAAqB,QAAQ,sBAAsB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1F,CAAC;QAED,mBAAmB;QACnB,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5C,OAAO,kCAAkC,CAAC;QAC5C,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YAC1B,OAAO,sBAAsB,OAAO,CAAC,MAAM,2CAA2C,CAAC;QACzF,CAAC;QAED,gBAAgB;QAChB,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACtB,CAAC;QAED,kBAAkB;QAClB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;YAClC,QAAQ,EAAE,QAA4B;YACtC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;YACvB,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;SAC/D,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,cAAc,EAAE,CAAC;QAE5D,OAAO;;MAEL,MAAM,CAAC,WAAW;YACZ,MAAM,CAAC,QAAQ;aACd,IAAI;;uFAEsE,CAAC;IACtF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC7B,OAAO,sBAAsB,KAAK,CAAC,OAAO;;;;;iDAKD,CAAC;YAC5C,CAAC;YACD,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC7B,OAAO,uBAAuB,KAAK,CAAC,OAAO,EAAE,CAAC;YAChD,CAAC;YACD,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/tools/update_checkpoint.d.ts

@@ -0,0 +1,63 @@
+/**
+ * update_checkpoint tool - Update a checkpoint's metadata
+ */
+export declare const definition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            milestone_id: {
+                type: string;
+                description: string;
+            };
+            order: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            depends_on: {
+                type: string;
+                items: {
+                    oneOf: {
+                        type: string;
+                    }[];
+                };
+                description: string;
+            };
+            git_branch_url: {
+                type: string;
+                description: string;
+            };
+            git_pr_url: {
+                type: string;
+                description: string;
+            };
+            git_commit_url: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+interface UpdateCheckpointArgs {
+    milestone_id: string;
+    order: number;
+    title?: string;
+    description?: string;
+    depends_on?: (number | string)[];
+    git_branch_url?: string;
+    git_pr_url?: string;
+    git_commit_url?: string;
+}
+export declare function handler(args: UpdateCheckpointArgs): Promise<string>;
+export {};
+//# sourceMappingURL=update_checkpoint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update_checkpoint.d.ts","sourceRoot":"","sources":["../../src/tools/update_checkpoint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CtB,CAAC;AAEF,UAAU,oBAAoB;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoDzE"}

package/dist/tools/update_checkpoint.js

@@ -0,0 +1,105 @@
+/**
+ * update_checkpoint tool - Update a checkpoint's metadata
+ */
+import { updateCheckpoint } from '../client.js';
+import { ClinkApiError } from '../types.js';
+export const definition = {
+    name: 'update_checkpoint',
+    description: 'Update a checkpoint\'s title, description, dependencies, or git references (branch URL, PR URL, commit URL).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            milestone_id: {
+                type: 'string',
+                description: 'The milestone ID',
+            },
+            order: {
+                type: 'number',
+                description: 'The checkpoint order number (1-based)',
+            },
+            title: {
+                type: 'string',
+                description: 'New checkpoint title (optional)',
+            },
+            description: {
+                type: 'string',
+                description: 'New checkpoint description (optional)',
+            },
+            depends_on: {
+                type: 'array',
+                items: {
+                    oneOf: [{ type: 'number' }, { type: 'string' }],
+                },
+                description: 'Dependencies. Use number for same-milestone (e.g., 1), or "milestone_id:order" for cross-milestone (e.g., "ms_abc123:4"). Same-milestone deps must reference earlier checkpoints. Cross-milestone deps are validated for cycles.',
+            },
+            git_branch_url: {
+                type: 'string',
+                description: 'Git branch URL (full URL, e.g., https://github.com/org/repo/tree/feature/auth)',
+            },
+            git_pr_url: {
+                type: 'string',
+                description: 'Git pull request URL (full URL, e.g., https://github.com/org/repo/pull/123)',
+            },
+            git_commit_url: {
+                type: 'string',
+                description: 'Git commit URL (full URL, e.g., https://github.com/org/repo/commit/abc123)',
+            },
+        },
+        required: ['milestone_id', 'order'],
+    },
+};
+export async function handler(args) {
+    try {
+        const { milestone_id, order, title, description, depends_on, git_branch_url, git_pr_url, git_commit_url } = args;
+        if (!milestone_id) {
+            return 'Please provide a milestone_id.';
+        }
+        if (!order || order < 1) {
+            return 'Please provide a valid checkpoint order (1 or greater).';
+        }
+        // Build updates object
+        const updates = {};
+        if (title !== undefined)
+            updates.title = title;
+        if (description !== undefined)
+            updates.description = description;
+        if (depends_on !== undefined)
+            updates.depends_on = depends_on;
+        if (git_branch_url !== undefined)
+            updates.git_branch_url = git_branch_url;
+        if (git_pr_url !== undefined)
+            updates.git_pr_url = git_pr_url;
+        if (git_commit_url !== undefined)
+            updates.git_commit_url = git_commit_url;
+        if (Object.keys(updates).length === 0) {
+            return 'Please provide at least one field to update (title, description, depends_on, git_branch_url, git_pr_url, git_commit_url).';
+        }
+        const milestone = await updateCheckpoint(milestone_id, order, updates);
+        const updatedCheckpoint = milestone.checkpoints?.find(cp => cp.order === order);
+        let output = `Checkpoint ${order} updated!\n\n`;
+        output += `Milestone: ${milestone.title}\n`;
+        output += `Progress: ${milestone.progress}\n\n`;
+        if (updatedCheckpoint) {
+            output += `Updated checkpoint:\n`;
+            output += `  Title: ${updatedCheckpoint.title}\n`;
+            output += `  Description: ${updatedCheckpoint.description || '(none)'}\n`;
+            if (updatedCheckpoint.depends_on && updatedCheckpoint.depends_on.length > 0) {
+                output += `  Dependencies: ${updatedCheckpoint.depends_on.join(', ')}\n`;
+            }
+            if (updatedCheckpoint.git_branch_url)
+                output += `  Branch: ${updatedCheckpoint.git_branch_url}\n`;
+            if (updatedCheckpoint.git_pr_url)
+                output += `  PR: ${updatedCheckpoint.git_pr_url}\n`;
+            if (updatedCheckpoint.git_commit_url)
+                output += `  Commit: ${updatedCheckpoint.git_commit_url}\n`;
+        }
+        return output;
+    }
+    catch (error) {
+        if (error instanceof ClinkApiError) {
+            return `Error: ${error.message}`;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=update_checkpoint.js.map