@energio/holded-mcp 1.0.0

package/dist/tools/projects/index.js

@@ -0,0 +1,15 @@
+/**
+ * Projects module tools registration
+ */
+import { registerProjectTools } from "./projects.js";
+import { registerTaskTools } from "./tasks.js";
+import { registerProjectTimeTrackingTools } from "./time-tracking.js";
+/**
+ * Register all projects-related tools
+ */
+export function registerProjectsTools(server) {
+    registerProjectTools(server);
+    registerTaskTools(server);
+    registerProjectTimeTrackingTools(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/projects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/projects/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,gCAAgC,EAAE,MAAM,oBAAoB,CAAC;AAEtE;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,gCAAgC,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC"}

package/dist/tools/projects/projects.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Project tools for Holded API
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Project } from "../../types.js";
+/**
+ * Format projects as markdown
+ */
+export declare function formatProjectsMarkdown(projects: Project[]): string;
+/**
+ * Format a single project as markdown
+ */
+export declare function formatProjectMarkdown(project: Project): string;
+/**
+ * Register all project-related tools
+ */
+export declare function registerProjectTools(server: McpServer): void;
+//# sourceMappingURL=projects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../../src/tools/projects/projects.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,OAAO,EAAkB,MAAM,gBAAgB,CAAC;AAazD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAuBlE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAmC9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0H5D"}

package/dist/tools/projects/projects.js

@@ -0,0 +1,203 @@
+/**
+ * Project tools for Holded API
+ */
+import { makeApiRequest, toStructuredContent } from "../../services/api.js";
+import { ResponseFormat } from "../../constants.js";
+import { ListProjectsInputSchema, CreateProjectInputSchema, GetProjectInputSchema, UpdateProjectInputSchema, DeleteProjectInputSchema, GetProjectSummaryInputSchema, } from "../../schemas/projects/projects.js";
+import { registerCrudTools } from "../factory.js";
+import { withErrorHandling } from "../utilities.js";
+/**
+ * Format projects as markdown
+ */
+export function formatProjectsMarkdown(projects) {
+    if (!projects.length) {
+        return "No projects found.";
+    }
+    const lines = ["# Projects", "", `Found ${projects.length} projects:`, ""];
+    for (const project of projects) {
+        lines.push(`## ${project.name}`);
+        lines.push(`- **ID**: ${project.id}`);
+        if (project.contactName)
+            lines.push(`- **Contact**: ${project.contactName}`);
+        // Handle status as number (API returns integer)
+        if (project.status !== undefined)
+            lines.push(`- **Status**: ${project.status}`);
+        // Use price (API field) or budget (legacy)
+        const budget = project.price ?? project.budget;
+        if (budget !== undefined)
+            lines.push(`- **Price/Budget**: ${budget}`);
+        // Task progress
+        if (project.numberOfTasks !== undefined) {
+            lines.push(`- **Tasks**: ${project.completedTasks || 0}/${project.numberOfTasks} completed`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a single project as markdown
+ */
+export function formatProjectMarkdown(project) {
+    const lines = [`# ${project.name}`, ""];
+    lines.push(`- **ID**: ${project.id}`);
+    // Use desc (API field) or description (legacy)
+    const description = project.desc || project.description;
+    if (description)
+        lines.push(`- **Description**: ${description}`);
+    if (project.contactName)
+        lines.push(`- **Contact**: ${project.contactName} (${project.contactId || "N/A"})`);
+    if (project.status !== undefined)
+        lines.push(`- **Status**: ${project.status}`);
+    // Use price (API field) or budget (legacy)
+    const budget = project.price ?? project.budget;
+    if (budget !== undefined)
+        lines.push(`- **Price/Budget**: ${budget}`);
+    // Use date (API field) or startDate (legacy)
+    const startDate = project.date || project.startDate;
+    if (startDate)
+        lines.push(`- **Start Date**: ${new Date(startDate * 1000).toLocaleDateString()}`);
+    // dueDate is the actual API field name
+    const endDate = project.dueDate || project.endDate;
+    if (endDate)
+        lines.push(`- **Due Date**: ${new Date(endDate * 1000).toLocaleDateString()}`);
+    if (project.billable !== undefined)
+        lines.push(`- **Billable**: ${project.billable ? "Yes" : "No"}`);
+    if (project.category !== undefined)
+        lines.push(`- **Category**: ${project.category}`);
+    // Task progress
+    if (project.numberOfTasks !== undefined) {
+        lines.push(`- **Tasks**: ${project.completedTasks || 0}/${project.numberOfTasks} completed`);
+    }
+    if (project.tags && project.tags.length > 0) {
+        lines.push(`- **Tags**: ${project.tags.join(", ")}`);
+    }
+    // Labels
+    if (project.labels && project.labels.length > 0) {
+        const labelNames = project.labels.map(l => l.name || l.labelName).filter(Boolean);
+        if (labelNames.length > 0) {
+            lines.push(`- **Labels**: ${labelNames.join(", ")}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Register all project-related tools
+ */
+export function registerProjectTools(server) {
+    // ── Standard CRUD via factory ───────────────────────────
+    registerCrudTools(server, {
+        module: "projects",
+        toolPrefix: "holded_projects",
+        resource: "project",
+        resourcePlural: "projects",
+        endpoint: "projects",
+        idParam: "project_id",
+        schemas: {
+            list: ListProjectsInputSchema,
+            get: GetProjectInputSchema,
+            create: CreateProjectInputSchema,
+            update: UpdateProjectInputSchema,
+            delete: DeleteProjectInputSchema,
+        },
+        titles: {
+            list: "List Holded Projects",
+            get: "Get Holded Project",
+            create: "Create Holded Project",
+            update: "Update Holded Project",
+            delete: "Delete Holded Project",
+        },
+        descriptions: {
+            list: `List all projects from Holded.
+
+Args:
+  - page (number): Page number for pagination (default: 1, max 500 items per page)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Array of projects with id, name, desc, status, price, contactId, contactName, date, dueDate,
+  category, lists, billable, numberOfTasks, completedTasks, labels, and linked documents.`,
+            get: `Get a specific project by ID from Holded.
+
+Args:
+  - project_id (string): The project ID to retrieve (required)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Project details including name, desc, status, price, date, dueDate, contactId, contactName,
+  category, lists, billable, numberOfTasks, completedTasks, labels, and linked documents.`,
+            create: `Create a new project in Holded.
+
+Args:
+  - name (string): Project name (required)
+
+Returns:
+  The created project with status, info, and assigned ID.`,
+            update: `Update an existing project in Holded.
+
+Args:
+  - project_id (string): The project ID to update (required)
+  - name (string): Project name
+
+Returns:
+  The updated project.`,
+            delete: `Delete a project from Holded.
+
+Args:
+  - project_id (string): The project ID to delete (required)
+
+Returns:
+  Confirmation of deletion.`,
+        },
+        formatters: {
+            list: formatProjectsMarkdown,
+            single: formatProjectMarkdown,
+        },
+    });
+    // ── Manual tools (non-standard endpoints) ───────────────
+    // Get Project Summary
+    server.registerTool("holded_projects_get_project_summary", {
+        title: "Get Holded Project Summary",
+        description: `Get a summary/overview of a project from Holded.
+
+Args:
+  - project_id (string): The project ID to get summary for (required)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Project summary including total hours, costs, revenue, and task statistics.`,
+        inputSchema: GetProjectSummaryInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const typedParams = params;
+        const summary = await makeApiRequest("projects", `projects/${typedParams.project_id}/summary`, "GET");
+        let textContent;
+        if (typedParams.response_format === ResponseFormat.MARKDOWN) {
+            const lines = [`# Project Summary`, ""];
+            lines.push(`- **Project ID**: ${summary.projectId}`);
+            if (summary.totalHours !== undefined)
+                lines.push(`- **Total Hours**: ${summary.totalHours}`);
+            if (summary.totalCost !== undefined)
+                lines.push(`- **Total Cost**: ${summary.totalCost}`);
+            if (summary.totalRevenue !== undefined)
+                lines.push(`- **Total Revenue**: ${summary.totalRevenue}`);
+            if (summary.tasksCompleted !== undefined)
+                lines.push(`- **Tasks Completed**: ${summary.tasksCompleted}`);
+            if (summary.tasksTotal !== undefined)
+                lines.push(`- **Total Tasks**: ${summary.tasksTotal}`);
+            textContent = lines.join("\n");
+        }
+        else {
+            textContent = JSON.stringify(summary, null, 2);
+        }
+        return {
+            content: [{ type: "text", text: textContent }],
+            structuredContent: toStructuredContent(summary),
+        };
+    }));
+}
+//# sourceMappingURL=projects.js.map

package/dist/tools/projects/projects.js.map

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

package/dist/tools/projects/tasks.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Task tools for Holded API
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Task } from "../../types.js";
+/**
+ * Format tasks as markdown
+ */
+export declare function formatTasksMarkdown(tasks: Task[]): string;
+/**
+ * Format a single task as markdown
+ */
+export declare function formatTaskMarkdown(task: Task): string;
+/**
+ * Register all task-related tools
+ */
+export declare function registerTaskTools(server: McpServer): void;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/tools/projects/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/tools/projects/tasks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAYtC;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAoBzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyHzD"}

package/dist/tools/projects/tasks.js

@@ -0,0 +1,154 @@
+/**
+ * Task tools for Holded API
+ */
+import { makeApiRequest, toStructuredContent } from "../../services/api.js";
+import { ListTasksInputSchema, CreateTaskInputSchema, GetTaskInputSchema, UpdateTaskInputSchema, DeleteTaskInputSchema, } from "../../schemas/projects/tasks.js";
+import { registerCrudTools } from "../factory.js";
+import { withErrorHandling } from "../utilities.js";
+/**
+ * Format tasks as markdown
+ */
+export function formatTasksMarkdown(tasks) {
+    if (!tasks.length) {
+        return "No tasks found.";
+    }
+    const lines = ["# Tasks", "", `Found ${tasks.length} tasks:`, ""];
+    for (const task of tasks) {
+        lines.push(`## ${task.name}`);
+        lines.push(`- **ID**: ${task.id}`);
+        if (task.projectId)
+            lines.push(`- **Project ID**: ${task.projectId}`);
+        if (task.status)
+            lines.push(`- **Status**: ${task.status}`);
+        if (task.priority)
+            lines.push(`- **Priority**: ${task.priority}`);
+        if (task.dueDate)
+            lines.push(`- **Due Date**: ${new Date(task.dueDate * 1000).toLocaleDateString()}`);
+        if (task.completed !== undefined)
+            lines.push(`- **Completed**: ${task.completed ? "Yes" : "No"}`);
+        if (task.assignedTo)
+            lines.push(`- **Assigned To**: ${task.assignedTo}`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a single task as markdown
+ */
+export function formatTaskMarkdown(task) {
+    return formatTasksMarkdown([task]);
+}
+/**
+ * Register all task-related tools
+ */
+export function registerTaskTools(server) {
+    // ── Standard CRUD via factory (list, get, update, delete) ─
+    registerCrudTools(server, {
+        module: "projects",
+        toolPrefix: "holded_projects",
+        resource: "task",
+        resourcePlural: "tasks",
+        endpoint: "tasks",
+        idParam: "task_id",
+        schemas: {
+            list: ListTasksInputSchema,
+            get: GetTaskInputSchema,
+            update: UpdateTaskInputSchema,
+            delete: DeleteTaskInputSchema,
+        },
+        titles: {
+            list: "List Holded Tasks",
+            get: "Get Holded Task",
+            update: "Update Holded Task",
+            delete: "Delete Holded Task",
+        },
+        descriptions: {
+            list: `List all tasks from Holded Projects.
+
+Args:
+  - page (number): Page number for pagination (default: 1, max 500 items per page)
+  - project_id (string): Filter by project ID (optional)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Array of tasks with id, name, status, priority, due date, and assignee.`,
+            get: `Get a specific task by ID from Holded Projects.
+
+Args:
+  - task_id (string): The task ID to retrieve (required)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Task details including name, status, priority, due date, and assignee.`,
+            update: `Update an existing task in Holded Projects.
+
+Note: The Holded API documentation does not explicitly document task updates.
+This tool supports updating the task name. Additional fields may be supported
+but are not officially documented.
+
+Args:
+  - task_id (string): The task ID to update (required)
+  - name (string): Task name (optional)
+
+Returns:
+  The updated task.`,
+            delete: `Delete a task from Holded Projects.
+
+Args:
+  - task_id (string): The task ID to delete (required)
+
+Returns:
+  Confirmation of deletion.`,
+        },
+        formatters: {
+            list: formatTasksMarkdown,
+            single: formatTaskMarkdown,
+        },
+        listQueryParams: (params) => {
+            const qp = {};
+            if (params.project_id)
+                qp.projectId = params.project_id;
+            return qp;
+        },
+    });
+    // ── Manual tool (needs snake_to_camel conversion) ───────
+    // Create Task
+    server.registerTool("holded_projects_create_task", {
+        title: "Create Holded Task",
+        description: `Create a new task in Holded Projects.
+
+According to Holded Projects API v1.2, task creation requires:
+  - name (string): Task name (required)
+  - project_id (string): Project ID to associate the task with (required)
+  - list_id (string): Task list/column ID within the project (required). Get available listIds from the project details.
+
+Returns:
+  The created task with its assigned ID.`,
+        inputSchema: CreateTaskInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { project_id, list_id, name } = params;
+        // Transform snake_case to camelCase for API
+        const requestData = {
+            name,
+            projectId: project_id,
+            listId: list_id,
+        };
+        const task = await makeApiRequest("projects", "tasks", "POST", requestData);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Task created successfully.\n\n${JSON.stringify(task, null, 2)}`,
+                },
+            ],
+            structuredContent: toStructuredContent(task),
+        };
+    }));
+}
+//# sourceMappingURL=tasks.js.map

package/dist/tools/projects/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../src/tools/projects/tasks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5E,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,GAEtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,EAAE,EAAE,SAAS,KAAK,CAAC,MAAM,SAAS,EAAE,EAAE,CAAC,CAAC;IAElE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACtE,IAAI,IAAI,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5D,IAAI,IAAI,CAAC,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClE,IAAI,IAAI,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;QACtG,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAClG,IAAI,IAAI,CAAC,UAAU;YAAE,KAAK,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACzE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAU;IAC3C,OAAO,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,6DAA6D;IAC7D,iBAAiB,CAAO,MAAM,EAAE;QAC9B,MAAM,EAAE,UAAU;QAClB,UAAU,EAAE,iBAAiB;QAC7B,QAAQ,EAAE,MAAM;QAChB,cAAc,EAAE,OAAO;QACvB,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE;YACP,IAAI,EAAE,oBAAoB;YAC1B,GAAG,EAAE,kBAAkB;YACvB,MAAM,EAAE,qBAAqB;YAC7B,MAAM,EAAE,qBAAqB;SAC9B;QACD,MAAM,EAAE;YACN,IAAI,EAAE,mBAAmB;YACzB,GAAG,EAAE,iBAAiB;YACtB,MAAM,EAAE,oBAAoB;YAC5B,MAAM,EAAE,oBAAoB;SAC7B;QACD,YAAY,EAAE;YACZ,IAAI,EAAE;;;;;;;;0EAQ8D;YACpE,GAAG,EAAE;;;;;;;yEAO8D;YACnE,MAAM,EAAE;;;;;;;;;;;oBAWM;YACd,MAAM,EAAE;;;;;;4BAMc;SACvB;QACD,UAAU,EAAE;YACV,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,kBAAkB;SAC3B;QACD,eAAe,EAAE,CAAC,MAAM,EAAE,EAAE;YAC1B,MAAM,EAAE,GAA4B,EAAE,CAAC;YACvC,IAAI,MAAM,CAAC,UAAU;gBAAE,EAAE,CAAC,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC;YACxD,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC,CAAC;IAEH,2DAA2D;IAE3D,cAAc;IACd,MAAM,CAAC,YAAY,CACjB,6BAA6B,EAC7B;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE;;;;;;;;yCAQsB;QACnC,WAAW,EAAE,qBAAqB;QAClC,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QACjC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAoC,CAAC;QAC3E,4CAA4C;QAC5C,MAAM,WAAW,GAAG;YAClB,IAAI;YACJ,SAAS,EAAE,UAAU;YACrB,MAAM,EAAE,OAAO;SAChB,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,cAAc,CAC/B,UAAU,EACV,OAAO,EACP,MAAM,EACN,WAAW,CACZ,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,iCAAiC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;iBACvE;aACF;YACD,iBAAiB,EAAE,mBAAmB,CAAC,IAAI,CAAC;SAC7C,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/projects/time-tracking.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Project Time Tracking tools for Holded API
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { TimeTracking } from "../../types.js";
+/**
+ * Format project time-trackings as markdown
+ */
+export declare function formatProjectTimeTrackingsMarkdown(times: TimeTracking[]): string;
+/**
+ * Register all project time-tracking-related tools
+ */
+export declare function registerProjectTimeTrackingTools(server: McpServer): void;
+//# sourceMappingURL=time-tracking.d.ts.map

package/dist/tools/projects/time-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-tracking.d.ts","sourceRoot":"","sources":["../../../src/tools/projects/time-tracking.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAiB9C;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,CAoBhF;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoUxE"}