@voxos-ai/clink-mcp-server 0.4.0

package/dist/tools/add_checkpoint.js

@@ -0,0 +1,108 @@
+/**
+ * add_checkpoint tool - Add a checkpoint to an existing milestone
+ */
+import { addCheckpoint } from '../client.js';
+import { ClinkApiError } from '../types.js';
+export const definition = {
+    name: 'add_checkpoint',
+    description: 'Add a new checkpoint to an existing milestone. Optionally specify a position to insert at, or it will be appended at the end.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            milestone_id: {
+                type: 'string',
+                description: 'The milestone ID',
+            },
+            title: {
+                type: 'string',
+                description: 'Checkpoint title',
+            },
+            description: {
+                type: 'string',
+                description: 'Checkpoint description (optional)',
+            },
+            requires_consensus: {
+                type: 'boolean',
+                description: 'If true, requires group vote before completion (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.',
+            },
+            position: {
+                type: 'number',
+                description: 'Position to insert at (1-based). If not provided, appends at end.',
+            },
+            git_branch_url: {
+                type: 'string',
+                description: 'Git branch URL (full URL)',
+            },
+            git_pr_url: {
+                type: 'string',
+                description: 'Git pull request URL (full URL)',
+            },
+            git_commit_url: {
+                type: 'string',
+                description: 'Git commit URL (full URL)',
+            },
+        },
+        required: ['milestone_id', 'title'],
+    },
+};
+export async function handler(args) {
+    try {
+        const { milestone_id, title, description, requires_consensus, depends_on, position, git_branch_url, git_pr_url, git_commit_url } = args;
+        if (!milestone_id) {
+            return 'Please provide a milestone_id.';
+        }
+        if (!title) {
+            return 'Please provide a checkpoint title.';
+        }
+        const milestone = await addCheckpoint(milestone_id, {
+            title,
+            description,
+            requires_consensus,
+            depends_on,
+            position,
+            git_branch_url,
+            git_pr_url,
+            git_commit_url,
+        });
+        // Find the newly added checkpoint
+        const actualPosition = position || milestone.total_checkpoints;
+        const newCheckpoint = milestone.checkpoints?.find(cp => cp.order === actualPosition);
+        let output = `Checkpoint added at position ${actualPosition}!\n\n`;
+        output += `Milestone: ${milestone.title}\n`;
+        output += `Progress: ${milestone.progress}\n\n`;
+        if (newCheckpoint) {
+            output += `New checkpoint:\n`;
+            output += `  ${newCheckpoint.order}. ${newCheckpoint.title}`;
+            if (newCheckpoint.requires_proposal_id)
+                output += ' [requires consensus]';
+            if (newCheckpoint.depends_on && newCheckpoint.depends_on.length > 0) {
+                output += ` [depends on: ${newCheckpoint.depends_on.join(', ')}]`;
+            }
+            output += '\n';
+            if (newCheckpoint.git_branch_url)
+                output += `     Branch: ${newCheckpoint.git_branch_url}\n`;
+            if (newCheckpoint.git_pr_url)
+                output += `     PR: ${newCheckpoint.git_pr_url}\n`;
+            if (newCheckpoint.git_commit_url)
+                output += `     Commit: ${newCheckpoint.git_commit_url}\n`;
+        }
+        output += `\nAll checkpoints:\n`;
+        for (const cp of milestone.checkpoints || []) {
+            const statusIcon = cp.status === 'completed' ? '[done]' : '[pending]';
+            output += `  ${cp.order}. ${cp.title} ${statusIcon}\n`;
+        }
+        return output;
+    }
+    catch (error) {
+        if (error instanceof ClinkApiError) {
+            return `Error: ${error.message}`;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=add_checkpoint.js.map

package/dist/tools/add_checkpoint.js.map

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

package/dist/tools/archive_project.d.ts

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

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

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

package/dist/tools/archive_project.js

@@ -0,0 +1,44 @@
+/**
+ * archive_project tool - Archive a project
+ */
+import { archiveProject } from '../client.js';
+import { ClinkApiError } from '../types.js';
+export const definition = {
+    name: 'archive_project',
+    description: 'Archive a project. Archived projects are hidden from default views but can be reopened later. Cannot archive the default project.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            project_id: {
+                type: 'string',
+                description: 'The project ID',
+            },
+        },
+        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 archiveProject(project_id);
+        let output = `Project archived!\n\n`;
+        output += `Title: ${project.title}\n`;
+        output += `ID: ${project.project_id}\n`;
+        output += `Status: ${project.status}\n`;
+        if (project.archived_at) {
+            output += `Archived at: ${new Date(project.archived_at).toLocaleString()}\n`;
+        }
+        output += `\nUse reopen_project to restore this project if needed.`;
+        return output;
+    }
+    catch (error) {
+        if (error instanceof ClinkApiError) {
+            return `Error: ${error.message}`;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=archive_project.js.map

package/dist/tools/archive_project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive_project.js","sourceRoot":"","sources":["../../src/tools/archive_project.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,mIAAmI;IAChJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gBAAgB;aAC9B;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;CACF,CAAC;AAMF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAwB;IACpD,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,cAAc,CAAC,UAAU,CAAC,CAAC;QAEjD,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,yDAAyD,CAAC;QAEpE,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/cast_vote.d.ts

@@ -0,0 +1,38 @@
+/**
+ * cast_vote tool - Cast a vote on a proposal
+ */
+export declare const definition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            proposal_id: {
+                type: string;
+                description: string;
+            };
+            vote: {
+                type: string;
+                description: string;
+            };
+            comment: {
+                type: string;
+                description: string;
+            };
+            hil_expiry_seconds: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+interface CastVoteArgs {
+    proposal_id: string;
+    vote: string;
+    comment?: string;
+    hil_expiry_seconds?: number;
+}
+export declare function handler(args: CastVoteArgs): Promise<string>;
+export {};
+//# sourceMappingURL=cast_vote.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cast_vote.d.ts","sourceRoot":"","sources":["../../src/tools/cast_vote.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;CAyBtB,CAAC;AAEF,UAAU,YAAY;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAyHjE"}

package/dist/tools/cast_vote.js

@@ -0,0 +1,148 @@
+/**
+ * cast_vote tool - Cast a vote on a proposal
+ */
+import { castVote, getProposal } from '../client.js';
+import { ClinkApiError, isHILRequired } from '../types.js';
+export const definition = {
+    name: 'cast_vote',
+    description: 'Cast a vote on a proposal. For yes/no proposals, vote "yes" or "no". For single choice, vote with the option name. Include a comment to explain your reasoning.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            proposal_id: {
+                type: 'string',
+                description: 'The proposal ID',
+            },
+            vote: {
+                type: 'string',
+                description: 'Your vote: "yes" or "no" for yes_no proposals, option name for single choice, comma-separated preferences for ranked',
+            },
+            comment: {
+                type: 'string',
+                description: 'Optional comment explaining your vote',
+            },
+            hil_expiry_seconds: {
+                type: 'number',
+                description: 'Optional: Custom expiry time for HIL verification email link in seconds (min 60, max 172800 = 48 hours). Default is 300 (5 minutes).',
+            },
+        },
+        required: ['proposal_id', 'vote'],
+    },
+};
+export async function handler(args) {
+    try {
+        const { proposal_id, vote, comment, hil_expiry_seconds } = args;
+        if (!proposal_id) {
+            return 'Please provide a proposal_id.';
+        }
+        if (!vote) {
+            // Get proposal to show valid options
+            try {
+                const proposal = await getProposal(proposal_id);
+                if (proposal.voting_type === 'yes_no') {
+                    return 'Please provide your vote: "yes" or "no"';
+                }
+                else {
+                    return `Please provide your vote. Options: ${proposal.options?.join(', ')}`;
+                }
+            }
+            catch {
+                return 'Please provide your vote.';
+            }
+        }
+        const response = await castVote(proposal_id, { vote, comment, hil_expiry_seconds });
+        // Check if HIL verification is required
+        if (isHILRequired(response)) {
+            const isPending = response.verification_status === 'pending';
+            const wasExpired = response.previous_verification_expired;
+            let output;
+            if (isPending) {
+                // Existing verification already in progress
+                output = `⏳ Human-in-the-Loop verification already pending.\n\n`;
+                output += `A verification email was already sent and is awaiting human approval.\n`;
+                output += `No new email was sent.\n\n`;
+                output += `Vote: ${vote}\n`;
+                if (comment) {
+                    output += `Comment: ${comment}\n`;
+                }
+                output += `\nVerification ID: ${response.verification_id}\n`;
+                if (response.expires_at) {
+                    output += `Expires at: ${new Date(response.expires_at).toLocaleString()}\n`;
+                }
+            }
+            else if (wasExpired) {
+                // Previous verification expired, new one sent
+                output = `⏳ Previous verification expired - new email sent.\n\n`;
+                output += `The previous verification link expired without being used.\n`;
+                output += `A new verification email has been sent to the designated approver.\n\n`;
+                output += `Vote: ${vote}\n`;
+                if (comment) {
+                    output += `Comment: ${comment}\n`;
+                }
+                output += `\nVerification ID: ${response.verification_id}\n`;
+                if (response.expires_in_seconds) {
+                    output += `Expires in: ${Math.floor(response.expires_in_seconds / 60)} minutes\n`;
+                }
+                if (response.sent_to && response.sent_to.length > 0) {
+                    output += `Email sent to: ${response.sent_to.join(', ')}\n`;
+                }
+            }
+            else {
+                // New verification created
+                output = `⏳ Human-in-the-Loop verification required.\n\n`;
+                output += `A verification email has been sent to the designated approver.\n`;
+                output += `Your vote will be recorded once they verify via the email link.\n\n`;
+                output += `Vote: ${vote}\n`;
+                if (comment) {
+                    output += `Comment: ${comment}\n`;
+                }
+                output += `\nVerification ID: ${response.verification_id}\n`;
+                if (response.expires_in_seconds) {
+                    output += `Expires in: ${Math.floor(response.expires_in_seconds / 60)} minutes\n`;
+                }
+                if (response.sent_to && response.sent_to.length > 0) {
+                    output += `Email sent to: ${response.sent_to.join(', ')}\n`;
+                }
+            }
+            output += `\nUse list_pending_verifications to see all pending HIL verifications.`;
+            return output;
+        }
+        // Normal vote recording - cast to proposal type
+        const proposal = response;
+        let output = `Vote recorded!\n\n`;
+        output += `Proposal: ${proposal.title}\n`;
+        output += `Your vote: ${vote}\n`;
+        if (comment) {
+            output += `Comment: ${comment}\n`;
+        }
+        // Show current tally
+        if (proposal.tally) {
+            output += `\nCurrent tally:\n`;
+            for (const [option, count] of Object.entries(proposal.tally)) {
+                output += `  ${option}: ${count}\n`;
+            }
+        }
+        output += `\nTotal votes: ${proposal.vote_count}`;
+        return output;
+    }
+    catch (error) {
+        if (error instanceof ClinkApiError) {
+            // Handle specific error cases
+            if (error.statusCode === 409) {
+                return `Error: You have already voted on this proposal. Each member can only vote once.`;
+            }
+            if (error.message.includes('finalized')) {
+                return 'Error: Voting has closed on this proposal.';
+            }
+            if (error.message.includes('deadline')) {
+                return 'Error: The voting deadline has passed.';
+            }
+            if (error.message.includes('Invalid vote')) {
+                return `Error: ${error.message}`;
+            }
+            return `Error: ${error.message}`;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=cast_vote.js.map

package/dist/tools/cast_vote.js.map

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

package/dist/tools/check_inbox.d.ts

@@ -0,0 +1,39 @@
+/**
+ * check_inbox tool - Check for pending clinks with claim/ack support
+ */
+export declare const definition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            status: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            for_me: {
+                type: string;
+                description: string;
+            };
+            claim: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+interface CheckInboxArgs {
+    status?: 'pending' | 'claimed' | 'completed' | 'all';
+    for_me?: boolean;
+    claim?: boolean;
+    limit?: number;
+}
+export declare function handler(args: CheckInboxArgs): Promise<string>;
+export {};
+//# sourceMappingURL=check_inbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check_inbox.d.ts","sourceRoot":"","sources":["../../src/tools/check_inbox.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BtB,CAAC;AAEF,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,KAAK,CAAC;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAoBD,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA4DnE"}

package/dist/tools/check_inbox.js

@@ -0,0 +1,99 @@
+/**
+ * check_inbox tool - Check for pending clinks with claim/ack support
+ */
+import { checkInbox } from '../client.js';
+import { ClinkApiError } from '../types.js';
+export const definition = {
+    name: 'check_inbox',
+    description: 'Check your inbox for pending clinks. By default shows clinks addressed to you or unaddressed. Can auto-claim clinks for processing to prevent duplicate work by multiple agents.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            status: {
+                type: 'string',
+                enum: ['pending', 'claimed', 'completed', 'all'],
+                description: 'Filter by clink status. Default: pending (actionable items)',
+            },
+            for_me: {
+                type: 'boolean',
+                description: 'Only show clinks addressed to you or unaddressed (default: true)',
+            },
+            claim: {
+                type: 'boolean',
+                description: 'Auto-claim pending clinks returned. Use this when you intend to process the clinks immediately.',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum clinks to return (default: 10)',
+            },
+        },
+        required: [],
+    },
+};
+function formatClink(clink) {
+    const time = new Date(clink.created_at).toLocaleTimeString();
+    const group = clink.group_slug || clink.group_name || clink.group_id;
+    const preview = clink.content.substring(0, 100) + (clink.content.length > 100 ? '...' : '');
+    let line = `[${time}] ${clink.sender_name} in ${group}: ${preview}`;
+    if (clink.status === 'claimed') {
+        line += ` [CLAIMED by ${clink.claimed_by}]`;
+    }
+    else if (clink.status === 'completed') {
+        line += ` [COMPLETED]`;
+    }
+    line += `\n  ID: ${clink.clink_id}`;
+    return line;
+}
+export async function handler(args) {
+    try {
+        const response = await checkInbox({
+            status: args.status || 'pending',
+            forMe: args.for_me !== false,
+            claim: args.claim || false,
+            limit: args.limit || 10,
+        });
+        const { clinks, count, claimed_count } = response;
+        if (count === 0) {
+            const statusText = args.status || 'pending';
+            if (statusText === 'pending') {
+                return 'No pending clinks in your inbox.';
+            }
+            return `No ${statusText} clinks found.`;
+        }
+        // Group by sender for summary
+        const bySender = new Map();
+        const byGroup = new Map();
+        for (const clink of clinks) {
+            bySender.set(clink.sender_name, (bySender.get(clink.sender_name) || 0) + 1);
+            const groupKey = clink.group_slug || clink.group_name || clink.group_id;
+            byGroup.set(groupKey, (byGroup.get(groupKey) || 0) + 1);
+        }
+        const senderSummary = Array.from(bySender.entries())
+            .map(([name, c]) => `${name} (${c})`)
+            .join(', ');
+        const groupSummary = Array.from(byGroup.entries())
+            .map(([name, c]) => `${name}: ${c}`)
+            .join(', ');
+        // Format clinks
+        const formattedClinks = clinks.map(formatClink);
+        let header = `${count} clink(s)`;
+        if (args.claim && claimed_count && claimed_count > 0) {
+            header += ` (${claimed_count} claimed for processing)`;
+        }
+        let output = `${header}\n\nFrom: ${senderSummary}\nIn: ${groupSummary}\n\nClinks:\n${formattedClinks.join('\n\n')}`;
+        if (args.claim && claimed_count && claimed_count > 0) {
+            output += `\n\nClaimed ${claimed_count} clink(s). Use complete_clink when done processing.`;
+        }
+        else if (!args.claim && clinks.some(c => c.status === 'pending')) {
+            output += '\n\nTip: Use claim=true to claim clinks, or use claim_clink on specific clink IDs.';
+        }
+        return output;
+    }
+    catch (error) {
+        if (error instanceof ClinkApiError) {
+            return `Error: ${error.message}`;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=check_inbox.js.map

package/dist/tools/check_inbox.js.map

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

package/dist/tools/claim_clink.d.ts

@@ -0,0 +1,28 @@
+/**
+ * claim_clink tool - Claim a clink for processing
+ */
+export declare const definition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            clink_id: {
+                type: string;
+                description: string;
+            };
+            timeout_seconds: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+interface ClaimClinkArgs {
+    clink_id: string;
+    timeout_seconds?: number;
+}
+export declare function handler(args: ClaimClinkArgs): Promise<string>;
+export {};
+//# sourceMappingURL=claim_clink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claim_clink.d.ts","sourceRoot":"","sources":["../../src/tools/claim_clink.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;CAiBtB,CAAC;AAEF,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BnE"}

package/dist/tools/claim_clink.js

@@ -0,0 +1,51 @@
+/**
+ * claim_clink tool - Claim a clink for processing
+ */
+import { claimClink } from '../client.js';
+import { ClinkApiError } from '../types.js';
+export const definition = {
+    name: 'claim_clink',
+    description: 'Claim a clink to indicate you are processing it. This prevents other workers/agents from processing the same clink. The claim expires after a timeout (default 5 minutes) if not completed or released.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            clink_id: {
+                type: 'string',
+                description: 'The clink ID to claim',
+            },
+            timeout_seconds: {
+                type: 'number',
+                description: 'How long to hold the claim in seconds (default: 300 = 5 minutes)',
+            },
+        },
+        required: ['clink_id'],
+    },
+};
+export async function handler(args) {
+    try {
+        const { clink_id, timeout_seconds } = args;
+        if (!clink_id) {
+            return 'Please provide a clink_id to claim.';
+        }
+        const clink = await claimClink(clink_id, {
+            timeoutSeconds: timeout_seconds,
+        });
+        const expiresAt = clink.claim_expires_at
+            ? new Date(clink.claim_expires_at).toLocaleTimeString()
+            : 'unknown';
+        return `Clink claimed successfully!\n\nClink ID: ${clink.clink_id}\nStatus: ${clink.status}\nClaim expires at: ${expiresAt}\n\nUse complete_clink when done processing, or release_clink to give up the claim.`;
+    }
+    catch (error) {
+        if (error instanceof ClinkApiError) {
+            if (error.statusCode === 409) {
+                return `Clink already claimed by another user. Try a different clink or wait for the claim to expire.`;
+            }
+            if (error.statusCode === 404) {
+                return `Clink not found: ${args.clink_id}`;
+            }
+            return `Error: ${error.message}`;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=claim_clink.js.map

package/dist/tools/claim_clink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim_clink.js","sourceRoot":"","sources":["../../src/tools/claim_clink.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,yMAAyM;IACtN,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uBAAuB;aACrC;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kEAAkE;aAChF;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB;CACF,CAAC;AAOF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAoB;IAChD,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;QAE3C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,qCAAqC,CAAC;QAC/C,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE;YACvC,cAAc,EAAE,eAAe;SAChC,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,KAAK,CAAC,gBAAgB;YACtC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,kBAAkB,EAAE;YACvD,CAAC,CAAC,SAAS,CAAC;QAEd,OAAO,4CAA4C,KAAK,CAAC,QAAQ,aAAa,KAAK,CAAC,MAAM,uBAAuB,SAAS,qFAAqF,CAAC;IAClN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC7B,OAAO,+FAA+F,CAAC;YACzG,CAAC;YACD,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC7B,OAAO,oBAAoB,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7C,CAAC;YACD,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}