@codegame.dev/careerflow-mcp 1.1.0

package/dist/tools/projects.js

@@ -0,0 +1,138 @@
+import { z } from "zod";
+import { companyIdSchema, resolveCompanyId, safeHandler, textResult } from "../helpers.js";
+/**
+ * Project administration tools: creating and configuring projects, and
+ * managing who belongs to them. Everyday task tools already resolve
+ * project/board ids via list_projects/list_boards — these are for changing the
+ * projects themselves.
+ */
+export function registerProjectTools(server, client) {
+    server.registerTool("create_project", {
+        title: "Create a project",
+        description: "Create a project. 'special' projects carry a due date and completion/late bonuses; " +
+            "'normal' projects don't.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            name: z.string().min(1),
+            description: z.string().optional(),
+            type: z.enum(["normal", "special"]).optional().default("normal"),
+            due_date: z.string().optional().describe("Only meaningful for type 'special'."),
+            completion_bonus: z.number().optional(),
+            late_penalty: z.number().optional(),
+            priority: z.enum(["low", "medium", "high", "urgent"]).optional().default("medium"),
+            allow_editor_create_tasks: z.boolean().optional(),
+            is_manager: z.boolean().optional().describe("Add the caller as the project's manager immediately.")
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const response = await client.post("projects/create", {
+            company_id: companyId,
+            name: args.name,
+            description: args.description,
+            type: args.type,
+            due_date: args.due_date,
+            completion_bonus: args.completion_bonus,
+            late_penalty: args.late_penalty,
+            priority: args.priority,
+            allow_editor_create_tasks: args.allow_editor_create_tasks,
+            is_manager: args.is_manager
+        });
+        return textResult({ created: true, project: response.data });
+    }));
+    server.registerTool("update_project", {
+        title: "Update a project",
+        description: "Change a project's name, description, or (for 'special' projects) its due date and bonuses.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            project_id: z.number().int(),
+            name: z.string().min(1).optional(),
+            description: z.string().optional(),
+            due_date: z.string().optional(),
+            completion_bonus: z.number().optional(),
+            late_penalty: z.number().optional(),
+            priority: z.enum(["low", "medium", "high", "urgent"]).optional(),
+            allow_editor_create_tasks: z.boolean().optional()
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const response = await client.post("projects/edit", {
+            company_id: companyId,
+            id: args.project_id,
+            name: args.name,
+            description: args.description,
+            due_date: args.due_date,
+            completion_bonus: args.completion_bonus,
+            late_penalty: args.late_penalty,
+            priority: args.priority,
+            allow_editor_create_tasks: args.allow_editor_create_tasks
+        });
+        return textResult({ updated: true, project: response.data });
+    }));
+    server.registerTool("archive_project", {
+        title: "Archive or restore a project",
+        description: "Archive a project, or restore a previously archived one. Personal/inbox projects cannot be archived.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            project_id: z.number().int(),
+            restore: z.boolean().optional().default(false)
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const path = args.restore ? `projects/restore/${args.project_id}` : `projects/delete/${args.project_id}`;
+        await client.post(path, { company_id: companyId });
+        return textResult({ project_id: args.project_id, archived: !args.restore });
+    }));
+    server.registerTool("project_stats", {
+        title: "Get project statistics",
+        description: "Task-count breakdowns for a project: by board, due date, member, label, and priority.",
+        inputSchema: { company_id: companyIdSchema, project_id: z.number().int() }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const response = await client.get("projects/stats", {
+            company_id: companyId,
+            project_id: args.project_id
+        });
+        return textResult(response.data);
+    }));
+    server.registerTool("invite_project_member", {
+        title: "Invite or update a project member",
+        description: "Add a user to a project (or change their access level). Access levels: visitor (read-only), " +
+            "editor (can create/edit tasks), manager (full control). Omitting access removes the member.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            project_id: z.number().int(),
+            user_id: z.number().int(),
+            access: z.enum(["visitor", "editor", "manager"]).optional().describe("Omit to remove the member."),
+            comment: z.string().optional()
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const response = await client.post("projects/users/edit", {
+            company_id: companyId,
+            project_id: args.project_id,
+            user_id: args.user_id,
+            request_type: "intra-company",
+            type: args.access,
+            comment: args.comment
+        });
+        return textResult({ project_id: args.project_id, user_id: args.user_id, project_users: response.data });
+    }));
+    server.registerTool("authorize_project_member", {
+        title: "Accept or reject a project membership request",
+        description: "Approve or deny a pending request to join a project.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            project_user_id: z.number().int(),
+            status: z.enum(["accepted", "rejected"])
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const response = await client.post("projects/users/authorize", {
+            company_id: companyId,
+            project_user_id: args.project_user_id,
+            status: args.status
+        });
+        return textResult({ updated: true, project_user: response.data });
+    }));
+}
+//# sourceMappingURL=projects.js.map

package/dist/tools/projects.js.map

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

package/dist/tools/tasks.js

@@ -0,0 +1,342 @@
+import { z } from "zod";
+import { boolParam, companyIdSchema, extractList, currentUserId, fetchTask, mergeTaskEdit, resolveCompanyId, safeHandler, summariseTask, textResult } from "../helpers.js";
+const prioritySchema = z.enum(["low", "medium", "high", "urgent"]);
+/**
+ * Task tools — the day-to-day surface for staff and supervisors.
+ *
+ * Every write goes through the same REST endpoints the web app uses, so the
+ * caller's existing project role still decides what actually succeeds; these
+ * tools add no privilege of their own.
+ */
+export function registerTaskTools(server, client) {
+    server.registerTool("list_my_tasks", {
+        title: "List my tasks",
+        description: "List tasks assigned to the authenticated user. Use this for 'what am I working on', " +
+            "'what's due', or 'what's overdue'. Returns open tasks by default.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            project_id: z.number().int().optional().describe("Restrict to one project."),
+            is_completed: z
+                .boolean()
+                .optional()
+                .describe("Filter by completion. Omit to return both open and completed tasks."),
+            is_overdue: z.boolean().optional().describe("Only tasks past their due date."),
+            search: z.string().optional().describe("Free-text match on the task title."),
+            limit: z.number().int().min(1).max(50).optional().default(20),
+            page: z.number().int().min(1).optional().default(1),
+            order_by: z.enum(["created", "updated", "num", "global_num"]).optional().default("updated"),
+            direction: z.enum(["asc", "desc"]).optional().default("desc")
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const myId = await currentUserId(client);
+        const response = await client.get("kanbans/tasks/search", {
+            company_id: companyId,
+            member_id: myId,
+            project_id: args.project_id,
+            is_completed: boolParam(args.is_completed),
+            is_overdue: boolParam(args.is_overdue),
+            search: args.search,
+            limit: args.limit,
+            page: args.page,
+            order_by: args.order_by,
+            direction: args.direction
+        });
+        const { items: tasks, total } = extractList(response.data, "tasks");
+        return textResult({ count: total ?? tasks.length, tasks: tasks.map(summariseTask) });
+    }));
+    server.registerTool("search_tasks", {
+        title: "Search tasks",
+        description: "Search tasks across a company or project, optionally filtered by assignee or supervisor. " +
+            "Supervisors use member_id to see one report's work, or supervisor_id to see a whole team's.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            project_id: z.number().int().optional(),
+            member_id: z.number().int().optional().describe("Only tasks assigned to this user id."),
+            supervisor_id: z
+                .number()
+                .int()
+                .optional()
+                .describe("Tasks belonging to everyone reporting to this supervisor id."),
+            search: z.string().optional(),
+            is_completed: z.boolean().optional(),
+            is_overdue: z.boolean().optional(),
+            review_status: z
+                .enum(["pending", "accepted"])
+                .optional()
+                .describe("Filter by review state; 'pending' finds work awaiting a supervisor's review."),
+            from_date: z.string().optional().describe("Lower date bound, YYYY-MM-DD."),
+            to_date: z.string().optional().describe("Upper date bound, YYYY-MM-DD."),
+            date_target: z
+                .enum(["created", "updated", "completion_date", "member_date"])
+                .optional()
+                .describe("Which date the from/to bounds apply to."),
+            limit: z.number().int().min(1).max(50).optional().default(20),
+            page: z.number().int().min(1).optional().default(1),
+            order_by: z.enum(["created", "updated", "num", "global_num"]).optional().default("updated"),
+            direction: z.enum(["asc", "desc"]).optional().default("desc")
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const response = await client.get("kanbans/tasks/search", {
+            company_id: companyId,
+            project_id: args.project_id,
+            member_id: args.member_id,
+            supervisor_id: args.supervisor_id,
+            search: args.search,
+            is_completed: boolParam(args.is_completed),
+            is_overdue: boolParam(args.is_overdue),
+            review_status: args.review_status,
+            from_date: args.from_date,
+            to_date: args.to_date,
+            date_target: args.date_target,
+            limit: args.limit,
+            page: args.page,
+            order_by: args.order_by,
+            direction: args.direction
+        });
+        const { items: tasks, total } = extractList(response.data, "tasks");
+        return textResult({ count: total ?? tasks.length, tasks: tasks.map(summariseTask) });
+    }));
+    server.registerTool("get_task", {
+        title: "Get a task",
+        description: "Fetch one task in full by its id, including members, labels and checklists.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            task_id: z.number().int().describe("The task id.")
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const task = await fetchTask(client, companyId, args.task_id);
+        return textResult(summariseTask(task));
+    }));
+    server.registerTool("create_task", {
+        title: "Create a task",
+        description: "Create a task on a board. Requires the project and board ids — use list_projects and " +
+            "list_boards first when they are not already known.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            project_id: z.number().int(),
+            board_id: z.number().int().describe("The board (column) the task is created in."),
+            title: z.string().min(1),
+            description: z.string().optional(),
+            assigned_user_id: z
+                .number()
+                .int()
+                .optional()
+                .describe("User to assign. Must already be an accepted member of the project."),
+            priority: prioritySchema.optional().default("medium"),
+            start_date: z.string().optional().describe("YYYY-MM-DD HH:MM:SS"),
+            due_date: z.string().optional().describe("YYYY-MM-DD HH:MM:SS"),
+            time_estimate_minutes: z.number().int().min(0).max(3600).optional()
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const response = await client.post("kanbans/tasks/create", {
+            company_id: companyId,
+            project_id: args.project_id,
+            board_id: args.board_id,
+            title: args.title,
+            description: args.description,
+            assigned_user_id: args.assigned_user_id,
+            priority: args.priority,
+            start_date: args.start_date,
+            due_date: args.due_date,
+            time_estimate_minutes: args.time_estimate_minutes
+        });
+        const task = response.data?.task;
+        return textResult({
+            created: true,
+            task: task ? summariseTask(task) : undefined
+        });
+    }));
+    server.registerTool("update_task", {
+        title: "Update a task",
+        description: "Change fields on an existing task. Only the fields passed are altered — the task is read " +
+            "first and unmentioned fields keep their current values.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            task_id: z.number().int(),
+            title: z.string().min(1).optional(),
+            description: z.string().optional(),
+            priority: prioritySchema.optional(),
+            start_date: z.string().nullable().optional().describe("YYYY-MM-DD HH:MM:SS, or null to clear."),
+            due_date: z.string().nullable().optional().describe("YYYY-MM-DD HH:MM:SS, or null to clear."),
+            time_estimate_minutes: z.number().int().min(0).nullable().optional()
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const current = await fetchTask(client, companyId, args.task_id);
+        const body = mergeTaskEdit(current, companyId, {
+            title: args.title,
+            description: args.description,
+            priority: args.priority,
+            start_date: args.start_date,
+            due_date: args.due_date,
+            time_estimate_minutes: args.time_estimate_minutes
+        });
+        const response = await client.post("kanbans/tasks/edit", body);
+        const task = response.data?.task;
+        return textResult({ updated: true, task: task ? summariseTask(task) : undefined });
+    }));
+    server.registerTool("complete_task", {
+        title: "Complete or reopen a task",
+        description: "Mark a task complete, or reopen it with completed=false. Other fields are preserved.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            task_id: z.number().int(),
+            completed: z.boolean().optional().default(true)
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const current = await fetchTask(client, companyId, args.task_id);
+        const body = mergeTaskEdit(current, companyId, {
+            is_completed: boolParam(args.completed ?? true)
+        });
+        await client.post("kanbans/tasks/edit", body);
+        return textResult({
+            task_id: args.task_id,
+            is_completed: args.completed ?? true,
+            title: current.title
+        });
+    }));
+    server.registerTool("assign_task", {
+        title: "Assign or unassign a task member",
+        description: "Add or remove a member on a task. The user must already be an accepted member of the " +
+            "task's project.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            task_id: z.number().int(),
+            user_id: z.number().int().describe("The user to assign or unassign."),
+            assign: z.boolean().optional().default(true).describe("true adds the member, false removes them.")
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const task = await fetchTask(client, companyId, args.task_id);
+        await client.post("kanbans/tasks/edit-member", {
+            company_id: companyId,
+            project_id: task.project_id,
+            board_id: task.board_id,
+            task_id: args.task_id,
+            user_id: args.user_id,
+            add: boolParam(args.assign ?? true)
+        });
+        return textResult({
+            task_id: args.task_id,
+            user_id: args.user_id,
+            assigned: args.assign ?? true
+        });
+    }));
+    server.registerTool("move_task", {
+        title: "Move a task to another board",
+        description: "Move a task to a different board (column), optionally in a different project — the usual " +
+            "way to advance work through a workflow.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            task_id: z.number().int(),
+            destination_board_id: z.number().int(),
+            destination_project_id: z.number().int().optional().describe("Defaults to the task's current project.")
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const task = await fetchTask(client, companyId, args.task_id);
+        await client.post("kanbans/tasks/move", {
+            company_id: companyId,
+            source_project_id: task.project_id,
+            source_board_id: task.board_id,
+            task_id: args.task_id,
+            destination_project_id: args.destination_project_id ?? task.project_id,
+            destination_board_id: args.destination_board_id,
+            // appended to the end of the destination board; the API renumbers
+            // the column afterwards, so a large sentinel is the documented way
+            // to say "put it last" without reading the board's current order
+            destination_num: 999999,
+            destination_global_num: 999999
+        });
+        return textResult({
+            task_id: args.task_id,
+            moved_to_board: args.destination_board_id,
+            title: task.title
+        });
+    }));
+    server.registerTool("review_task", {
+        title: "Review a task",
+        description: "Supervisor action: accept a completed task and score it 0-5, or send it back by setting " +
+            "review_status to 'pending'.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            task_id: z.number().int(),
+            review_status: z.enum(["pending", "accepted"]),
+            review_score: z.number().min(0).max(5).describe("Score from 0 to 5.")
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const task = await fetchTask(client, companyId, args.task_id);
+        await client.post("kanbans/tasks/review", {
+            company_id: companyId,
+            project_id: task.project_id,
+            board_id: task.board_id,
+            task_id: args.task_id,
+            review_status: args.review_status,
+            review_score: args.review_score
+        });
+        return textResult({
+            task_id: args.task_id,
+            review_status: args.review_status,
+            review_score: args.review_score
+        });
+    }));
+    server.registerTool("list_task_comments", {
+        title: "List task comments",
+        description: "Read the comment thread on a task.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            task_id: z.number().int(),
+            limit: z.number().int().min(1).max(50).optional().default(20),
+            page: z.number().int().min(1).optional().default(1)
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const task = await fetchTask(client, companyId, args.task_id);
+        const response = await client.get("kanbans/tasks/comments/search", {
+            company_id: companyId,
+            project_id: task.project_id,
+            board_id: task.board_id,
+            task_id: args.task_id,
+            limit: args.limit,
+            page: args.page
+        });
+        const { items: comments, total } = extractList(response.data, "task_comments");
+        return textResult({
+            count: total ?? comments.length,
+            comments: comments.map((c) => ({
+                id: c.id,
+                content: c.content,
+                user_id: c.user_id,
+                author: [c.firstname, c.lastname].filter(Boolean).join(" ") || undefined,
+                created: c.created
+            }))
+        });
+    }));
+    server.registerTool("add_task_comment", {
+        title: "Comment on a task",
+        description: "Post a comment to a task's thread.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            task_id: z.number().int(),
+            content: z.string().min(1).describe("The comment body.")
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const task = await fetchTask(client, companyId, args.task_id);
+        await client.post("kanbans/tasks/comments/add", {
+            company_id: companyId,
+            project_id: task.project_id,
+            board_id: task.board_id,
+            task_id: args.task_id,
+            content: args.content
+        });
+        return textResult({ task_id: args.task_id, commented: true });
+    }));
+}
+//# sourceMappingURL=tasks.js.map

package/dist/tools/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EACN,SAAS,EACT,eAAe,EACf,WAAW,EACX,aAAa,EACb,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,UAAU,EACV,MAAM,eAAe,CAAA;AAEtB,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;AAElE;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,MAAwB;IAC5E,MAAM,CAAC,YAAY,CAClB,eAAe,EACf;QACC,KAAK,EAAE,eAAe;QACtB,WAAW,EACV,sFAAsF;YACtF,mEAAmE;QACpE,WAAW,EAAE;YACZ,UAAU,EAAE,eAAe;YAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YAC5E,YAAY,EAAE,CAAC;iBACb,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,qEAAqE,CAAC;YACjF,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;YAC9E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YAC5E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YACnD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;YAC3F,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;SAC7D;KACD,EACD,WAAW,CAAC,KAAK,EAAE,IAAS,EAAE,EAAE;QAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QAC3D,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAA;QAExC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAoC,sBAAsB,EAAE;YAC5F,UAAU,EAAE,SAAS;YACrB,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,YAAY,EAAE,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC;YAC1C,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC;YACtC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;SACzB,CAAC,CAAA;QAEF,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACnE,OAAO,UAAU,CAAC,EAAE,KAAK,EAAE,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;IACrF,CAAC,CAAC,CACF,CAAA;IAED,MAAM,CAAC,YAAY,CAClB,cAAc,EACd;QACC,KAAK,EAAE,cAAc;QACrB,WAAW,EACV,2FAA2F;YAC3F,6FAA6F;QAC9F,WAAW,EAAE;YACZ,UAAU,EAAE,eAAe;YAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;YACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YACvF,aAAa,EAAE,CAAC;iBACd,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CAAC,8DAA8D,CAAC;YAC1E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC7B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YACpC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAClC,aAAa,EAAE,CAAC;iBACd,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;iBAC7B,QAAQ,EAAE;iBACV,QAAQ,CAAC,8EAA8E,CAAC;YAC1F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YAC1E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YACxE,WAAW,EAAE,CAAC;iBACZ,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,aAAa,CAAC,CAAC;iBAC9D,QAAQ,EAAE;iBACV,QAAQ,CAAC,yCAAyC,CAAC;YACrD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YACnD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;YAC3F,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;SAC7D;KACD,EACD,WAAW,CAAC,KAAK,EAAE,IAAS,EAAE,EAAE;QAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QAC3D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAoC,sBAAsB,EAAE;YAC5F,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC;YAC1C,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC;YACtC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;SACzB,CAAC,CAAA;QAEF,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACnE,OAAO,UAAU,CAAC,EAAE,KAAK,EAAE,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;IACrF,CAAC,CAAC,CACF,CAAA;IAED,MAAM,CAAC,YAAY,CAClB,UAAU,EACV;QACC,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,6EAA6E;QAC1F,WAAW,EAAE;YACZ,UAAU,EAAE,eAAe;YAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;SAClD;KACD,EACD,WAAW,CAAC,KAAK,EAAE,IAAS,EAAE,EAAE;QAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QAC3D,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAC7D,OAAO,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAA;IACvC,CAAC,CAAC,CACF,CAAA;IAED,MAAM,CAAC,YAAY,CAClB,aAAa,EACb;QACC,KAAK,EAAE,eAAe;QACtB,WAAW,EACV,uFAAuF;YACvF,oDAAoD;QACrD,WAAW,EAAE;YACZ,UAAU,EAAE,eAAe;YAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;YAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,gBAAgB,EAAE,CAAC;iBACjB,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CAAC,oEAAoE,CAAC;YAChF,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;YACrD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YACjE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YAC/D,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;SACnE;KACD,EACD,WAAW,CAAC,KAAK,EAAE,IAAS,EAAE,EAAE;QAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QAC3D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAiC,sBAAsB,EAAE;YAC1F,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;SACjD,CAAC,CAAA;QAEF,MAAM,IAAI,GAAI,QAAQ,CAAC,IAAuC,EAAE,IAAI,CAAA;QACpE,OAAO,UAAU,CAAC;YACjB,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC5C,CAAC,CAAA;IACH,CAAC,CAAC,CACF,CAAA;IAED,MAAM,CAAC,YAAY,CAClB,aAAa,EACb;QACC,KAAK,EAAE,eAAe;QACtB,WAAW,EACV,2FAA2F;YAC3F,yDAAyD;QAC1D,WAAW,EAAE;YACZ,UAAU,EAAE,eAAe;YAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;YACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;YACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;YAC/F,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;YAC7F,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;SACpE;KACD,EACD,WAAW,CAAC,KAAK,EAAE,IAAS,EAAE,EAAE;QAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QAC3D,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAEhE,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE;YAC9C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;SACjD,CAAC,CAAA;QAEF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAiC,oBAAoB,EAAE,IAAI,CAAC,CAAA;QAC9F,MAAM,IAAI,GAAI,QAAQ,CAAC,IAAuC,EAAE,IAAI,CAAA;QACpE,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAA;IACnF,CAAC,CAAC,CACF,CAAA;IAED,MAAM,CAAC,YAAY,CAClB,eAAe,EACf;QACC,KAAK,EAAE,2BAA2B;QAClC,WAAW,EAAE,sFAAsF;QACnG,WAAW,EAAE;YACZ,UAAU,EAAE,eAAe;YAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;YACzB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;SAC/C;KACD,EACD,WAAW,CAAC,KAAK,EAAE,IAAS,EAAE,EAAE;QAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QAC3D,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAEhE,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE;YAC9C,YAAY,EAAE,SAAS,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;SAC/C,CAAC,CAAA;QAEF,MAAM,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAA;QAC7C,OAAO,UAAU,CAAC;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;YACpC,KAAK,EAAE,OAAO,CAAC,KAAK;SACpB,CAAC,CAAA;IACH,CAAC,CAAC,CACF,CAAA;IAED,MAAM,CAAC,YAAY,CAClB,aAAa,EACb;QACC,KAAK,EAAE,kCAAkC;QACzC,WAAW,EACV,uFAAuF;YACvF,iBAAiB;QAClB,WAAW,EAAE;YACZ,UAAU,EAAE,eAAe;YAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;YACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;YACrE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;SAClG;KACD,EACD,WAAW,CAAC,KAAK,EAAE,IAAS,EAAE,EAAE;QAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QAC3D,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAE7D,MAAM,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;YAC9C,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;SACnC,CAAC,CAAA;QAEF,OAAO,UAAU,CAAC;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;SAC7B,CAAC,CAAA;IACH,CAAC,CAAC,CACF,CAAA;IAED,MAAM,CAAC,YAAY,CAClB,WAAW,EACX;QACC,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACV,2FAA2F;YAC3F,yCAAyC;QAC1C,WAAW,EAAE;YACZ,UAAU,EAAE,eAAe;YAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;YACzB,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;YACtC,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;SACvG;KACD,EACD,WAAW,CAAC,KAAK,EAAE,IAAS,EAAE,EAAE;QAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QAC3D,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAE7D,MAAM,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;YACvC,UAAU,EAAE,SAAS;YACrB,iBAAiB,EAAE,IAAI,CAAC,UAAU;YAClC,eAAe,EAAE,IAAI,CAAC,QAAQ;YAC9B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,sBAAsB,EAAE,IAAI,CAAC,sBAAsB,IAAI,IAAI,CAAC,UAAU;YACtE,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,kEAAkE;YAClE,mEAAmE;YACnE,iEAAiE;YACjE,eAAe,EAAE,MAAM;YACvB,sBAAsB,EAAE,MAAM;SAC9B,CAAC,CAAA;QAEF,OAAO,UAAU,CAAC;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,cAAc,EAAE,IAAI,CAAC,oBAAoB;YACzC,KAAK,EAAE,IAAI,CAAC,KAAK;SACjB,CAAC,CAAA;IACH,CAAC,CAAC,CACF,CAAA;IAED,MAAM,CAAC,YAAY,CAClB,aAAa,EACb;QACC,KAAK,EAAE,eAAe;QACtB,WAAW,EACV,0FAA0F;YAC1F,6BAA6B;QAC9B,WAAW,EAAE;YACZ,UAAU,EAAE,eAAe;YAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;YACzB,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YAC9C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;SACrE;KACD,EACD,WAAW,CAAC,KAAK,EAAE,IAAS,EAAE,EAAE;QAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QAC3D,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAE7D,MAAM,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE;YACzC,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,YAAY,EAAE,IAAI,CAAC,YAAY;SAC/B,CAAC,CAAA;QAEF,OAAO,UAAU,CAAC;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,YAAY,EAAE,IAAI,CAAC,YAAY;SAC/B,CAAC,CAAA;IACH,CAAC,CAAC,CACF,CAAA;IAED,MAAM,CAAC,YAAY,CAClB,oBAAoB,EACpB;QACC,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,oCAAoC;QACjD,WAAW,EAAE;YACZ,UAAU,EAAE,eAAe;YAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;YACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;SACnD;KACD,EACD,WAAW,CAAC,KAAK,EAAE,IAAS,EAAE,EAAE;QAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QAC3D,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAE7D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAuC,+BAA+B,EAAE;YACxG,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;SACf,CAAC,CAAA;QAEF,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;QAC9E,OAAO,UAAU,CAAC;YACjB,KAAK,EAAE,KAAK,IAAI,QAAQ,CAAC,MAAM;YAC/B,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAsB,EAAE,EAAE,CAAC,CAAC;gBACnD,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS;gBACxE,OAAO,EAAE,CAAC,CAAC,OAAO;aAClB,CAAC,CAAC;SACH,CAAC,CAAA;IACH,CAAC,CAAC,CACF,CAAA;IAED,MAAM,CAAC,YAAY,CAClB,kBAAkB,EAClB;QACC,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,oCAAoC;QACjD,WAAW,EAAE;YACZ,UAAU,EAAE,eAAe;YAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;YACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;SACxD;KACD,EACD,WAAW,CAAC,KAAK,EAAE,IAAS,EAAE,EAAE;QAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QAC3D,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAE7D,MAAM,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE;YAC/C,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;SACrB,CAAC,CAAA;QAEF,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC9D,CAAC,CAAC,CACF,CAAA;AACF,CAAC"}

package/dist/tools/time.js

@@ -0,0 +1,129 @@
+import { z } from "zod";
+import { companyIdSchema, currentUserId, extractList, fetchTask, resolveCompanyId, safeHandler, textResult } from "../helpers.js";
+const userIdSchema = z.number().int().optional().describe("Whose time this is. Defaults to the authenticated user.");
+/** The API expects local-time "YYYY-MM-DD HH:MM:SS", not an ISO-8601 string. */
+function formatApiDate(date) {
+    const pad = (n) => String(n).padStart(2, "0");
+    return (`${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ` +
+        `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`);
+}
+/**
+ * Time-tracking tools.
+ *
+ * Timers and manual entries both belong to the calling user; the API takes the
+ * user from the token, so none of these tools accept a user id.
+ */
+export function registerTimeTools(server, client) {
+    server.registerTool("start_timer", {
+        title: "Start a task timer",
+        description: "Start tracking time against a task for the authenticated user.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            task_id: z.number().int(),
+            user_id: userIdSchema
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const task = await fetchTask(client, companyId, args.task_id);
+        await client.post("kanbans/tasks/times/start-timer", {
+            company_id: companyId,
+            project_id: task.project_id,
+            board_id: task.board_id,
+            task_id: args.task_id,
+            user_id: args.user_id ?? (await currentUserId(client))
+        });
+        return textResult({ task_id: args.task_id, title: task.title, timer: "started" });
+    }));
+    server.registerTool("stop_timer", {
+        title: "Stop a task timer",
+        description: "Stop the running timer on a task and record the elapsed time.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            task_id: z.number().int(),
+            user_id: userIdSchema
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const task = await fetchTask(client, companyId, args.task_id);
+        await client.post("kanbans/tasks/times/stop-timer", {
+            company_id: companyId,
+            project_id: task.project_id,
+            board_id: task.board_id,
+            task_id: args.task_id,
+            user_id: args.user_id ?? (await currentUserId(client))
+        });
+        return textResult({ task_id: args.task_id, title: task.title, timer: "stopped" });
+    }));
+    server.registerTool("log_time", {
+        title: "Log time on a task",
+        description: "Record a block of time already spent on a task, for work done away from a running timer.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            task_id: z.number().int(),
+            duration_minutes: z.number().int().min(1).describe("Minutes spent."),
+            date: z.string().optional().describe("When the work happened, YYYY-MM-DD HH:MM:SS. Defaults to now."),
+            comment: z.string().optional().describe("What the time was spent on."),
+            user_id: userIdSchema
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const task = await fetchTask(client, companyId, args.task_id);
+        await client.post("kanbans/tasks/times/add", {
+            company_id: companyId,
+            project_id: task.project_id,
+            board_id: task.board_id,
+            task_id: args.task_id,
+            user_id: args.user_id ?? (await currentUserId(client)),
+            duration_minutes: args.duration_minutes,
+            // the endpoint requires a date; "when it happened" defaults to now so
+            // a caller logging time they just spent does not have to supply one
+            date: args.date ?? formatApiDate(new Date()),
+            comment: args.comment
+        });
+        return textResult({
+            task_id: args.task_id,
+            title: task.title,
+            logged_minutes: args.duration_minutes
+        });
+    }));
+    server.registerTool("list_task_time", {
+        title: "List time entries on a task",
+        description: "Show the time entries recorded against a task, and who logged them.",
+        inputSchema: {
+            company_id: companyIdSchema,
+            task_id: z.number().int(),
+            from_date: z.string().optional().describe("Lower bound, YYYY-MM-DD."),
+            to_date: z.string().optional().describe("Upper bound, YYYY-MM-DD."),
+            limit: z.number().int().min(1).max(50).optional().default(25),
+            page: z.number().int().min(1).optional().default(1)
+        }
+    }, safeHandler(async (args) => {
+        const companyId = resolveCompanyId(client, args.company_id);
+        const task = await fetchTask(client, companyId, args.task_id);
+        const response = await client.get("kanbans/tasks/times/search", {
+            company_id: companyId,
+            project_id: task.project_id,
+            board_id: task.board_id,
+            task_id: args.task_id,
+            from_date: args.from_date,
+            to_date: args.to_date,
+            limit: args.limit,
+            page: args.page
+        });
+        const { items: times, total } = extractList(response.data, "task_times");
+        return textResult({
+            count: total ?? times.length,
+            total_minutes: times.reduce((sum, t) => sum + (Number(t.duration_minutes) || 0), 0),
+            entries: times.map((t) => ({
+                id: t.id,
+                user_id: t.user_id,
+                user: [t.firstname, t.lastname].filter(Boolean).join(" ") || undefined,
+                duration_minutes: t.duration_minutes,
+                date: t.date,
+                comment: t.comment || undefined,
+                status: t.status || undefined
+            }))
+        });
+    }));
+}
+//# sourceMappingURL=time.js.map