@ttctl/mcp 0.0.0 → 0.1.0-rc.2

package/dist/tools/timesheet.js

@@ -0,0 +1,257 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { timesheet } from "@ttctl/core";
+import { z } from "zod";
+import { ttctlErrorToToolResponseOrNull } from "../errors.js";
+import { buildMcpDryRunPreview, dryRunResponse } from "./_shared.js";
+const DRY_RUN_FIELD = z
+    .boolean()
+    .optional()
+    .describe("Preview the request without executing. Returns `{ ok: true, dryRun: true, preview }` with operationName + variables + redacted bearer header. Default: false.");
+/**
+ * Placeholder cycle id used in the `timesheet_submit` dry-run preview
+ * when the caller omits `id` (auto-resolve at apply time). Apply path
+ * resolves the real id via {@link timesheet.resolveCurrentCycle};
+ * dry-run skips that prefetch and stamps this sentinel value into the
+ * preview's `variables.id` so the wire-shape is honest about the
+ * pending resolution.
+ */
+const SUBMIT_AUTO_RESOLVE_PLACEHOLDER = "<auto-resolved-at-apply-time>";
+/**
+ * Register the `ttctl_timesheet_*` MCP tools per the #13 spec. Tool
+ * names use the `ttctl_` prefix and the canonical CLI path joined
+ * with `_`:
+ *
+ *   - `ttctl_timesheet_list`
+ *   - `ttctl_timesheet_show`
+ *   - `ttctl_timesheet_submit`
+ *
+ * Each tool maps 1:1 to a CLI leaf — schemas describe the same set of
+ * fields. Identity model:
+ *
+ *   - `BillingCycle.id`     — the "timesheet id" returned by
+ *                              `timesheet_list` and consumed by
+ *                              `timesheet_show` / `timesheet_submit`.
+ *   - `JobActivityItem.id`  — the "engagement id" exposed by
+ *                              `engagements_list`. Passed via
+ *                              `engagement` to scope.
+ *
+ * Submit is destructive — its tool description explicitly warns
+ * humans, and per #13 the CLI gates on `--confirm` / TTY interactive
+ * confirm. The MCP side has no analogous gate (LLM clients are
+ * expected to confirm with the human before invoking write tools)
+ * but the description and rationale are surfaced verbatim.
+ */
+export function registerTimesheetTools(server, ctx) {
+    server.registerTool("ttctl_timesheet_list", {
+        title: "List timesheet billing cycles",
+        description: [
+            "List the signed-in user's Toptal Talent timesheet billing cycles.",
+            "A timesheet is a per-billing-cycle bucket of time entries that the",
+            "talent submits for client billing.",
+            "",
+            "Default scope: viewer-wide pending timesheets (what currently needs",
+            "submission). Pass `engagement` (jobActivityItem.id from",
+            "`engagements_list`) to scope to one engagement (returns ALL cycles for",
+            "that engagement, regardless of submission state).",
+            "",
+            "Example user prompts:",
+            '  - "Show my pending Toptal timesheets."',
+            '  - "What timesheets do I need to submit?"',
+            '  - "List all timesheets for engagement act_xyz."',
+        ].join("\n"),
+        inputSchema: {
+            engagement: z
+                .string()
+                .optional()
+                .describe("Scope to one engagement (jobActivityItem.id from `engagements_list`). Omit for viewer-wide pending."),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        const opts = {};
+        if (args.engagement !== undefined)
+            opts.engagement = args.engagement;
+        if (args.dryRun === true) {
+            // Apply path picks PendingTimesheets (no engagement) or
+            // Timesheets($jobActivityItemId) (engagement scoped); mirror
+            // that branch in the preview so callers see the exact wire
+            // operation that would fire.
+            if (opts.engagement === undefined) {
+                return dryRunResponse(buildMcpDryRunPreview("PendingTimesheets", "mobile-gateway", {}, auth.token));
+            }
+            return dryRunResponse(buildMcpDryRunPreview("Timesheets", "mobile-gateway", { jobActivityItemId: opts.engagement }, auth.token));
+        }
+        try {
+            const items = await timesheet.list(auth.token, opts);
+            return successResponse(items);
+        }
+        catch (err) {
+            return mapTimesheetError(err);
+        }
+    });
+    server.registerTool("ttctl_timesheet_show", {
+        title: "Show one timesheet by id",
+        description: [
+            "Fetch a single timesheet's full detail by BillingCycle.id (the id",
+            "returned by `ttctl_timesheet_list`). Returns the cycle metadata",
+            "(week range, hours, submission state), the engagement+job reference,",
+            "the rate agreement snapshot, the comment (if any), and the per-day",
+            "time entries (`timesheetRecords`).",
+            "",
+            "Example user prompts:",
+            '  - "Show me the details of timesheet bc_abc123."',
+            '  - "What did I log for the May 1-15 cycle on engagement act_xyz?"',
+        ].join("\n"),
+        inputSchema: {
+            id: z.string().describe("Timesheet id (BillingCycle.id from `timesheet_list`)"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("TimesheetDetails", "mobile-gateway", { id: args.id }, auth.token));
+        }
+        try {
+            const item = await timesheet.show(auth.token, args.id);
+            return successResponse(item);
+        }
+        catch (err) {
+            return mapTimesheetError(err);
+        }
+    });
+    server.registerTool("ttctl_timesheet_submit", {
+        title: "Submit a timesheet for billing (DESTRUCTIVE — one-way)",
+        description: [
+            "Submit a timesheet (BillingCycle.id) for billing. The submission is",
+            "one-way at the wire level — once submitted, the timesheet enters",
+            "Toptal's billing pipeline and cannot be retracted from this CLI.",
+            "",
+            "**This is a write operation**. Confirm with the user BEFORE invoking,",
+            "including the cycle id, week range, and hours about to be submitted.",
+            "",
+            "`id` is optional: omitted, the tool resolves the single currently-pending",
+            "cycle whose submission window contains 'now'. If zero or multiple",
+            "cycles match, the tool returns a structured error so the LLM can",
+            "disambiguate before retrying with an explicit id.",
+            "",
+            "Optional `engagement` (jobActivityItem.id) scopes the auto-resolve to",
+            "one engagement — useful when the user has multiple parallel",
+            "engagements with overlapping current cycles.",
+            "",
+            "**`dryRun` caveat**: when `id` is omitted AND `dryRun: true`, the preview",
+            "stamps the literal placeholder string `<auto-resolved-at-apply-time>`",
+            "into `variables.id` — the apply path's auto-resolve read is SKIPPED on",
+            "dry-run (no wire call). Operation name, surface, header redaction, and",
+            "variable shape are verbatim; only the cycle-id VALUE is deferred. Do NOT",
+            "treat the placeholder as a real BillingCycle id.",
+            "",
+            "Example user prompts:",
+            '  - "Submit my current Toptal timesheet."',
+            '  - "Submit timesheet bc_abc123."',
+            '  - "Submit my pending timesheet for engagement act_xyz."',
+        ].join("\n"),
+        inputSchema: {
+            id: z
+                .string()
+                .optional()
+                .describe("Timesheet id (BillingCycle.id) to submit. Omit for current-pending auto-resolve."),
+            engagement: z
+                .string()
+                .optional()
+                .describe("Scope auto-resolve to one engagement (jobActivityItem.id). Ignored when `id` is supplied."),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            // Apply path optionally pre-fetches PendingTimesheets to auto-resolve
+            // the cycle id when none is supplied. Dry-run SKIPS that prefetch
+            // (per the same "no wire call" semantics engagements.breaks.add
+            // applies for its engagement-id translation) and stamps a placeholder
+            // string into the SubmitTimesheet preview's `variables.id`. The
+            // wire SHAPE (operationName, surface, variables key names, redacted
+            // headers) is verbatim; only the cycle-id VALUE is deferred to apply.
+            const variables = { id: args.id ?? SUBMIT_AUTO_RESOLVE_PLACEHOLDER };
+            return dryRunResponse(buildMcpDryRunPreview("SubmitTimesheet", "mobile-gateway", variables, auth.token));
+        }
+        try {
+            let cycleId;
+            if (args.id !== undefined) {
+                cycleId = args.id;
+            }
+            else {
+                const resolveOpts = {};
+                if (args.engagement !== undefined)
+                    resolveOpts.engagement = args.engagement;
+                const resolution = await timesheet.resolveCurrentCycle(auth.token, resolveOpts);
+                if (resolution.kind === "none") {
+                    return errorResponse("NO_CURRENT_CYCLE", "No billing cycle is currently in its submission window.", "Run `ttctl_timesheet_list` to see what's pending, or specify an id explicitly.");
+                }
+                if (resolution.kind === "multiple") {
+                    const lines = resolution.candidates.map((c) => {
+                        const client = c.engagement.job.client?.fullName ?? "(no client)";
+                        const title = c.engagement.job.title ?? "(untitled)";
+                        return `  - ${c.id} (${client} — ${title}, ${c.startDate} → ${c.endDate})`;
+                    });
+                    return errorResponse("MULTIPLE_CURRENT_CYCLES", `${resolution.candidates.length.toString()} cycles match the current submission window — specify one explicitly.`, `Candidates:\n${lines.join("\n")}`);
+                }
+                cycleId = resolution.cycle.id;
+            }
+            const updated = await timesheet.submit(auth.token, cycleId);
+            return successResponse(updated);
+        }
+        catch (err) {
+            return mapTimesheetError(err);
+        }
+    });
+}
+function successResponse(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+function errorResponse(code, message, recovery) {
+    return {
+        isError: true,
+        content: [
+            {
+                type: "text",
+                text: [`Error: ${message}`, "", `Recovery: ${recovery}`, "", `(Code: ${code})`].join("\n"),
+            },
+        ],
+    };
+}
+function mapTimesheetError(err) {
+    const typed = ttctlErrorToToolResponseOrNull(err);
+    if (typed !== null)
+        return typed;
+    if (err instanceof timesheet.TimesheetError) {
+        return errorResponse(err.code, err.message, recoveryForCode(err.code));
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return errorResponse("UNKNOWN", `timesheet request failed: ${message}`, "Retry; if the failure persists, file an issue.");
+}
+function recoveryForCode(code) {
+    switch (code) {
+        case "NOT_FOUND":
+            return "Verify the id (use `ttctl_timesheet_list` to discover billing-cycle ids).";
+        case "NO_ENGAGEMENT":
+            return "The activity item exists but isn't an engagement — only engagement-bearing rows have timesheets.";
+        case "NO_CURRENT_CYCLE":
+            return "No cycle is currently in its submission window. Run `ttctl_timesheet_list` to see what's pending.";
+        case "MULTIPLE_CURRENT_CYCLES":
+            return "Multiple cycles overlap — specify the cycle id explicitly via `id`.";
+        case "MUTATION_ERROR":
+            return "The server rejected the submission (often: missing required hours, deadline passed, or already submitted). Inspect the message above.";
+        default:
+            return "Adjust the tool input or retry; see the code below.";
+    }
+}
+//# sourceMappingURL=timesheet.js.map

package/dist/tools/timesheet.js.map

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

package/package.json

@@ -1,9 +1,11 @@
 {
   "name": "@ttctl/mcp",
-  "version": "0.0.0",
-  "description": "TTCtl MCP server exposing Toptal Talent operations to AI assistants — placeholder reservation; real release in development",
+  "version": "0.1.0-rc.2",
+  "description": "TTCtl MCP server exposing Toptal Talent operations to AI assistants",
   "type": "module",
-  "main": "./index.js",
+  "engines": {
+    "node": ">=22.19.0"
+  },
   "license": "AGPL-3.0-only",
   "author": "Alexey Pelykh (https://github.com/alexey-pelykh)",
   "homepage": "https://github.com/alexey-pelykh/ttctl/tree/main/packages/mcp",
@@ -11,20 +13,38 @@
   "funding": "https://github.com/sponsors/alexey-pelykh",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alexey-pelykh/ttctl.git",
+    "url": "https://github.com/alexey-pelykh/ttctl.git",
     "directory": "packages/mcp"
   },
-  "keywords": [
-    "toptal-talent",
-    "mcp",
-    "placeholder"
-  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "files": [
-    "index.js",
-    "README.md",
-    "LICENSE"
+    "dist"
   ],
   "publishConfig": {
     "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^25",
+    "eslint": "^10.3.0",
+    "typescript": "~6.0.3",
+    "vitest": "^4.1.1"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0",
+    "zod": "^4.4.3",
+    "@ttctl/core": "^0.1.0-rc.2"
+  },
+  "scripts": {
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "lint": "eslint src/",
+    "dev": "tsc --watch"
   }
-}
+}

package/index.js

@@ -1,7 +0,0 @@
-// @ttctl/mcp placeholder — name reservation only.
-// The real release is in development at https://github.com/alexey-pelykh/ttctl
-console.log(
-  "@ttctl/mcp: this is a placeholder reservation, not a functional release.\n" +
-    "The real MCP server is in development. See:\n" +
-    "  https://github.com/alexey-pelykh/ttctl",
-);