@ttctl/mcp 0.0.0 → 0.1.0-rc.2

package/dist/tools/applications.js

@@ -0,0 +1,192 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { applications } from "@ttctl/core";
+import { z } from "zod";
+import { ttctlErrorToToolResponseOrNull } from "../errors.js";
+import { buildMcpDryRunPreview, dryRunMultiResponse, 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.");
+/**
+ * Register the three `ttctl_applications_*` MCP tools per the #15 spec.
+ * Tool names use the `ttctl_` prefix and the canonical CLI path joined
+ * with `_` per project naming policy:
+ *
+ *   - `ttctl_applications_list`
+ *   - `ttctl_applications_show`
+ *   - `ttctl_applications_stats`
+ *
+ * Each tool maps 1:1 to a CLI leaf — the schemas describe the same set
+ * of fields. The list tool's `keywords` and `statusGroups` mirror the
+ * `--keywords` / `--status-group` CLI flags.
+ *
+ * **Read-only** — per project non-goals (#15), no apply / withdraw /
+ * edit tools are exposed. `applications` is intentionally a smaller
+ * surface than the profile sub-domains.
+ *
+ * Dry-run path (issue #165): every tool accepts `dryRun?: boolean`.
+ * `list` and `show` emit the singular `{ preview }` envelope (one
+ * operation per call); `stats` emits the plural `{ previews: [...] }`
+ * envelope because the apply path fires 5 parallel `JobActivityItems`
+ * calls (one per STATUS_GROUPS member) — see {@link dryRunMultiResponse}.
+ */
+export function registerApplicationsTools(server, ctx) {
+    server.registerTool("ttctl_applications_list", {
+        title: "List activity items",
+        description: [
+            "List the signed-in user's Toptal Talent activity items.",
+            "Each row represents an application, availability request, interview, or engagement —",
+            "Toptal collapses these into a single 'TalentJobActivityItem' resource.",
+            "",
+            "Optional filters:",
+            "  - `keywords`: free-text search against indexed job fields",
+            "  - `statusGroups`: restrict to one or more JobActivityItemStatusGroupEnum values",
+            "",
+            "Example user prompts:",
+            '  - "Show me my recent Toptal applications."',
+            '  - "What active engagements do I have on Toptal?"',
+            '  - "List my archived Toptal job activity."',
+        ].join("\n"),
+        inputSchema: {
+            keywords: z.array(z.string()).optional().describe("Free-text keyword filter (AND across multiple)"),
+            statusGroups: z
+                .array(z.enum([...applications.STATUS_GROUPS]))
+                .optional()
+                .describe("Restrict to one or more JobActivityItemStatusGroupEnum values: ACTIVE_ENGAGEMENT, ARCHIVED, CLOSED_ENGAGEMENT, ON_CLIENT_REVIEW, ON_RECRUITER_REVIEW"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        const opts = {};
+        if (args.keywords !== undefined)
+            opts.keywords = args.keywords;
+        if (args.statusGroups !== undefined)
+            opts.statusGroups = args.statusGroups;
+        if (args.dryRun === true) {
+            const variables = {};
+            if (opts.keywords !== undefined)
+                variables["keywords"] = opts.keywords;
+            if (opts.statusGroups !== undefined)
+                variables["onlyStatusGroupFilter"] = opts.statusGroups;
+            return dryRunResponse(buildMcpDryRunPreview("JobActivityItems", "mobile-gateway", variables, auth.token));
+        }
+        try {
+            const items = await applications.list(auth.token, opts);
+            return successResponse(items);
+        }
+        catch (err) {
+            return mapApplicationsError(err);
+        }
+    });
+    server.registerTool("ttctl_applications_show", {
+        title: "Show one activity item",
+        description: [
+            "Fetch a single activity item by id (the row id, not the underlying job id).",
+            "Returns the full detail view: status, job metadata (title, description, commitment),",
+            "application info (id, requested rate), and engagement info (start date, commitment) where present.",
+            "",
+            "Example user prompts:",
+            '  - "Show me the details of activity item act_abc123."',
+            '  - "What does my application app_xyz look like?" (use the activity id, not the application id)',
+        ].join("\n"),
+        inputSchema: {
+            id: z.string().describe("Activity item id (the TalentJobActivityItem id)"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("JobActivityItem", "mobile-gateway", { id: args.id }, auth.token));
+        }
+        try {
+            const item = await applications.show(auth.token, args.id);
+            return successResponse(item);
+        }
+        catch (err) {
+            return mapApplicationsError(err);
+        }
+    });
+    server.registerTool("ttctl_applications_stats", {
+        title: "Per-status-group activity counts",
+        description: [
+            "Aggregate activity-item counts: returns per-status-group totals plus the overall sum.",
+            "",
+            "Issues 5 server calls in parallel (one per JobActivityItemStatusGroupEnum value).",
+            "Each count is server-provided (totalCount on JobActivityList) — no client-side aggregation.",
+            "",
+            "Example user prompts:",
+            '  - "How many Toptal applications do I have in each status?"',
+            '  - "Give me a breakdown of my Toptal activity by status group."',
+            '  - "What\'s my total activity count on Toptal?"',
+            "",
+            "Dry-run note: returns `{ ok: true, dryRun: true, previews: [...] }` (plural `previews`) — one `JobActivityItems` preview per status group (5 total), matching the 5 parallel calls the apply path fires.",
+        ].join("\n"),
+        inputSchema: { dryRun: DRY_RUN_FIELD },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            const previews = applications.STATUS_GROUPS.map((group) => buildMcpDryRunPreview("JobActivityItems", "mobile-gateway", { onlyStatusGroupFilter: [group] }, auth.token));
+            return dryRunMultiResponse(previews);
+        }
+        try {
+            const stats = await applications.stats(auth.token);
+            return successResponse(stats);
+        }
+        catch (err) {
+            return mapApplicationsError(err);
+        }
+    });
+}
+function successResponse(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+function mapApplicationsError(err) {
+    const typed = ttctlErrorToToolResponseOrNull(err);
+    if (typed !== null)
+        return typed;
+    if (err instanceof applications.ApplicationsError) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        `Error: ${err.message}`,
+                        "",
+                        err.code === "NOT_FOUND"
+                            ? "Recovery: Verify the activity id (use ttctl_applications_list to discover it)."
+                            : "Recovery: Adjust the tool input or retry; see the code below.",
+                        "",
+                        `(Code: ${err.code})`,
+                    ].join("\n"),
+                },
+            ],
+        };
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        isError: true,
+        content: [
+            {
+                type: "text",
+                text: [
+                    `Error: applications request failed: ${message}`,
+                    "",
+                    "Recovery: Retry; if the failure persists, file an issue.",
+                    "",
+                    "(Code: UNKNOWN)",
+                ].join("\n"),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=applications.js.map

package/dist/tools/applications.js.map

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

package/dist/tools/availability.d.ts

@@ -0,0 +1,33 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Register the `ttctl_availability_*` MCP tools per the #146 amended
+ * spec. Tool names use the `ttctl_` prefix and the canonical CLI path
+ * joined with `_`:
+ *
+ *   - `ttctl_availability_show`
+ *   - `ttctl_availability_working_hours_show`
+ *   - `ttctl_availability_working_hours_set`
+ *   - `ttctl_availability_allocated_hours_show`
+ *   - `ttctl_availability_allocated_hours_set`
+ *
+ * Each tool maps 1:1 to a CLI leaf — the schemas describe the same set
+ * of fields.
+ *
+ * **Vocabulary note** (parallel to the CLI surface): per-engagement
+ * "time off" is exposed via `ttctl_engagements_breaks_*` — there is no
+ * `ttctl_availability_time_off_*` surface (the underlying API is
+ * engagement-scoped and would only duplicate the engagements tools).
+ * "Lead time" / "minimum scheduling notice" is for booking pages
+ * (consultations), a separate surface not exposed in v1.
+ *
+ * Dry-run path (issue #165): every tool accepts `dryRun?: boolean`.
+ * Read tools build the `GetAvailability` preview at the MCP layer
+ * (same query underlies show + the two `*_show` filters, which apply
+ * client-side narrowing). The two `*_set` tools passthrough-forward
+ * `{ dryRun: true }` to the core (#164 already wired it through) and
+ * reformat the `{ kind: "preview", preview }` outcome as the uniform
+ * envelope.
+ */
+export declare function registerAvailabilityTools(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=availability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"availability.d.ts","sourceRoot":"","sources":["../../src/tools/availability.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,EAAyC,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AASnG;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CA+L/F"}

package/dist/tools/availability.js

@@ -0,0 +1,272 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { availability } 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.");
+/**
+ * Register the `ttctl_availability_*` MCP tools per the #146 amended
+ * spec. Tool names use the `ttctl_` prefix and the canonical CLI path
+ * joined with `_`:
+ *
+ *   - `ttctl_availability_show`
+ *   - `ttctl_availability_working_hours_show`
+ *   - `ttctl_availability_working_hours_set`
+ *   - `ttctl_availability_allocated_hours_show`
+ *   - `ttctl_availability_allocated_hours_set`
+ *
+ * Each tool maps 1:1 to a CLI leaf — the schemas describe the same set
+ * of fields.
+ *
+ * **Vocabulary note** (parallel to the CLI surface): per-engagement
+ * "time off" is exposed via `ttctl_engagements_breaks_*` — there is no
+ * `ttctl_availability_time_off_*` surface (the underlying API is
+ * engagement-scoped and would only duplicate the engagements tools).
+ * "Lead time" / "minimum scheduling notice" is for booking pages
+ * (consultations), a separate surface not exposed in v1.
+ *
+ * Dry-run path (issue #165): every tool accepts `dryRun?: boolean`.
+ * Read tools build the `GetAvailability` preview at the MCP layer
+ * (same query underlies show + the two `*_show` filters, which apply
+ * client-side narrowing). The two `*_set` tools passthrough-forward
+ * `{ dryRun: true }` to the core (#164 already wired it through) and
+ * reformat the `{ kind: "preview", preview }` outcome as the uniform
+ * envelope.
+ */
+export function registerAvailabilityTools(server, ctx) {
+    server.registerTool("ttctl_availability_show", {
+        title: "Show availability snapshot",
+        description: [
+            "Show the signed-in user's full availability snapshot — time zone,",
+            "daily working-hours window, flexible shift range, and viewer-scoped",
+            "allocated hours per week.",
+            "",
+            "Per-engagement time off (= engagement breaks) is NOT included; use",
+            "`ttctl_engagements_breaks_list` for that.",
+            "",
+            "Example user prompts:",
+            '  - "What is my current Toptal availability?"',
+            '  - "Show me my working hours and time zone."',
+            '  - "How many hours have I allocated for Toptal engagements?"',
+        ].join("\n"),
+        inputSchema: { dryRun: DRY_RUN_FIELD },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("GetAvailability", "mobile-gateway", {}, auth.token));
+        }
+        try {
+            const snap = await availability.show(auth.token);
+            return successResponse(snap);
+        }
+        catch (err) {
+            return mapAvailabilityError(err);
+        }
+    });
+    server.registerTool("ttctl_availability_working_hours_show", {
+        title: "Show working-hours subset",
+        description: [
+            "Show just the working-hours subset of availability — time zone +",
+            "daily window (workingTimeFrom/To) + flexible shift range",
+            "(availableShiftRangeFrom/To). Drops the allocatedHours field.",
+            "",
+            "Example user prompts:",
+            '  - "What are my Toptal working hours?"',
+            '  - "Show me my time-zone configuration."',
+            "",
+            "Dry-run note: the apply path issues `GetAvailability` (same query as `availability_show`) and narrows the result client-side — the preview reflects the wire call accordingly.",
+        ].join("\n"),
+        inputSchema: { dryRun: DRY_RUN_FIELD },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("GetAvailability", "mobile-gateway", {}, auth.token));
+        }
+        try {
+            const data = await availability.workingHours.show(auth.token);
+            return successResponse(data);
+        }
+        catch (err) {
+            return mapAvailabilityError(err);
+        }
+    });
+    server.registerTool("ttctl_availability_working_hours_set", {
+        title: "Update working hours",
+        description: [
+            "Update working hours: any subset of (time zone, daily window,",
+            "flexible shift range) via the UpdateWorkingHours mutation.",
+            "",
+            "All time fields are `HH:MM:SS` strings (e.g., `09:00:00`).",
+            "`timeZone` is an IANA zone identifier (e.g., `Europe/Berlin`).",
+            "",
+            "At least one field MUST be provided — empty change sets are",
+            "rejected pre-flight.",
+            "",
+            "**This is a write operation**: it modifies the user's availability",
+            "settings on the live Toptal Talent platform. Confirm with the user",
+            "before invoking.",
+            "",
+            "Example user prompts:",
+            '  - "Set my Toptal working hours to 9 AM through 5 PM."',
+            '  - "Change my time zone to Europe/Berlin."',
+            '  - "Update my flexible shift range to 7 AM - 7 PM."',
+        ].join("\n"),
+        inputSchema: {
+            timeZone: z
+                .string()
+                .optional()
+                .describe("IANA time-zone identifier (e.g., `Europe/Berlin`, `America/New_York`)"),
+            workingTimeFrom: z
+                .string()
+                .optional()
+                .describe("Daily working-hours window start, `HH:MM:SS` (e.g., `09:00:00`)"),
+            workingTimeTo: z.string().optional().describe("Daily working-hours window end, `HH:MM:SS` (e.g., `17:00:00`)"),
+            availableShiftRangeFrom: z.string().optional().describe("Flexible shift-range start, `HH:MM:SS`"),
+            availableShiftRangeTo: z.string().optional().describe("Flexible shift-range end, `HH:MM:SS`"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        try {
+            const input = {};
+            if (args.timeZone !== undefined)
+                input.timeZone = args.timeZone;
+            if (args.workingTimeFrom !== undefined)
+                input.workingTimeFrom = args.workingTimeFrom;
+            if (args.workingTimeTo !== undefined)
+                input.workingTimeTo = args.workingTimeTo;
+            if (args.availableShiftRangeFrom !== undefined)
+                input.availableShiftRangeFrom = args.availableShiftRangeFrom;
+            if (args.availableShiftRangeTo !== undefined)
+                input.availableShiftRangeTo = args.availableShiftRangeTo;
+            const outcome = await availability.workingHours.set(auth.token, input, { dryRun: args.dryRun ?? false });
+            if (outcome.kind === "preview")
+                return dryRunResponse(outcome.preview);
+            return successResponse(outcome.result);
+        }
+        catch (err) {
+            return mapAvailabilityError(err);
+        }
+    });
+    server.registerTool("ttctl_availability_allocated_hours_show", {
+        title: "Show allocated hours",
+        description: [
+            "Show the signed-in user's viewer-scoped allocated hours per week.",
+            "",
+            "Example user prompts:",
+            '  - "How many hours have I allocated for Toptal work?"',
+            '  - "Show my Toptal availability in hours per week."',
+            "",
+            "Dry-run note: the apply path issues `GetAvailability` and narrows the result client-side — the preview reflects the wire call accordingly.",
+        ].join("\n"),
+        inputSchema: { dryRun: DRY_RUN_FIELD },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("GetAvailability", "mobile-gateway", {}, auth.token));
+        }
+        try {
+            const data = await availability.allocatedHours.show(auth.token);
+            return successResponse(data);
+        }
+        catch (err) {
+            return mapAvailabilityError(err);
+        }
+    });
+    server.registerTool("ttctl_availability_allocated_hours_set", {
+        title: "Set allocated hours",
+        description: [
+            "Set the viewer-scoped allocated hours per week (non-negative",
+            "integer; the portal UI caps at 80 and the server validator",
+            "enforces the same range).",
+            "",
+            "This is a VIEWER-scoped value — it applies across all of the",
+            "viewer's active engagements, NOT per-engagement.",
+            "",
+            "**This is a write operation**: it modifies the user's availability",
+            "settings on the live Toptal Talent platform. Confirm with the user",
+            "before invoking.",
+            "",
+            "Example user prompts:",
+            '  - "Set my allocated Toptal hours to 40 per week."',
+            '  - "Update my Toptal allocated hours to 20."',
+        ].join("\n"),
+        inputSchema: {
+            hours: z.number().int().nonnegative().describe("Non-negative integer hours per week (portal UI caps at 80)"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        try {
+            const outcome = await availability.allocatedHours.set(auth.token, args.hours, { dryRun: args.dryRun ?? false });
+            if (outcome.kind === "preview")
+                return dryRunResponse(outcome.preview);
+            return successResponse(outcome.result);
+        }
+        catch (err) {
+            return mapAvailabilityError(err);
+        }
+    });
+}
+function successResponse(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+function mapAvailabilityError(err) {
+    const typed = ttctlErrorToToolResponseOrNull(err);
+    if (typed !== null)
+        return typed;
+    if (err instanceof availability.AvailabilityError) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: [`Error: ${err.message}`, "", recoveryForCode(err.code), "", `(Code: ${err.code})`].join("\n"),
+                },
+            ],
+        };
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        isError: true,
+        content: [
+            {
+                type: "text",
+                text: [
+                    `Error: availability request failed: ${message}`,
+                    "",
+                    "Recovery: Retry; if the failure persists, file an issue.",
+                    "",
+                    "(Code: UNKNOWN)",
+                ].join("\n"),
+            },
+        ],
+    };
+}
+function recoveryForCode(code) {
+    switch (code) {
+        case "NO_VIEWER_ROLE":
+            return "Recovery: Sign in as a Toptal Talent (the availability surface is talent-side).";
+        case "MUTATION_ERROR":
+            return "Recovery: The mutation was rejected by the server (often: malformed time string, unknown time-zone identifier, or out-of-range allocated hours). Check the message above and adjust the input.";
+        default:
+            return "Recovery: Adjust the tool input or retry; see the code below.";
+    }
+}
+//# sourceMappingURL=availability.js.map

package/dist/tools/availability.js.map

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

package/dist/tools/contracts.d.ts

@@ -0,0 +1,29 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Register the `ttctl_contracts_*` MCP tools (#195). Two read-only tools:
+ *
+ *   - `ttctl_contracts_list` — list talent-level contracts
+ *   - `ttctl_contracts_show` — show one contract by id
+ *
+ * The `<id>` argument is the `Contract.id` from `ttctl_contracts_list`.
+ *
+ * **Domain distinction**: this group surfaces talent-level legal
+ * documents (Toptal Direct, Master Service Agreement) via
+ * `viewer.contracts` on the portal surface. Engagement-attached
+ * commercial agreements (rates, hours, period for one project) live
+ * on a different surface — use `ttctl_engagements_show <engagement-id>`.
+ *
+ * **Dry-run path** (issue #165): both tools accept `dryRun?: boolean`.
+ * Read-only tools build the preview at the MCP layer via
+ * `buildMcpDryRunPreview` — `show` previews the same `GetContracts`
+ * operation as `list` (the apply path fetches the list and filters
+ * client-side; the dry-run reflects that wire call accurately).
+ *
+ * **Per CLAUDE.md schema/contract validation rule**: `GetContracts`
+ * is hand-authored against the portal surface; every projected field
+ * is `Unknown`-typed in the SDL → INFERRED. Live E2E coverage
+ * (`packages/e2e/src/35-contracts.e2e.test.ts`) is mandatory pre-merge.
+ */
+export declare function registerContractsTools(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/tools/contracts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,EAAyC,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AASnG;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CAgF5F"}