@ttctl/mcp 0.0.0 → 0.1.0-rc.1

package/dist/tools/profile/portfolio.js

@@ -0,0 +1,341 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { z } from "zod";
+import { ttctlErrorToToolResponseOrNull } from "../../errors.js";
+import { UPLOAD_CATEGORIES, decodeFileUploadInput, fileUploadInputSchema } from "../file-upload.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 eight `ttctl_profile_portfolio_*` MCP tools per the #75
+ * spec. Tool names use the canonical sub-domain `portfolio` (NOT the CLI
+ * alias `projects`) per project policy.
+ *
+ * Each tool maps 1:1 to a CLI leaf — the schemas describe the same set
+ * of fields, with file-upload tools accepting the dual `filePath` /
+ * `content` (base64) input per the spec.
+ *
+ * Dry-run path (issue #165): every tool accepts `dryRun?: boolean`. When
+ * `dryRun: true`, returns the uniform `{ ok: true, dryRun: true, preview }`
+ * envelope via MCP-layer preview building. For `upload_cover` /
+ * `upload_file`, the dry-run path emits the GraphQL operations envelope
+ * only (`file: null` placeholder) — the multipart binary body is NOT
+ * enumerated, mirroring the `profile.resume.upload` convention.
+ * `profileId` carries `DRY_RUN_PROFILE_ID_PLACEHOLDER` where the apply
+ * path resolves it via a sibling profile read.
+ */
+export function registerPortfolioTools(server, ctx) {
+    server.registerTool("ttctl_profile_portfolio_list", {
+        title: "List portfolio items",
+        description: "List the signed-in user's portfolio items (id, title, link, highlight, etc).",
+        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("getPortfolioItems", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER }, auth.token));
+        }
+        try {
+            const items = await profile.portfolio.list(auth.token);
+            return successResponse(items);
+        }
+        catch (err) {
+            return mapPortfolioError(err);
+        }
+    });
+    server.registerTool("ttctl_profile_portfolio_add", {
+        title: "Create a portfolio item",
+        description: "Create a new portfolio item. `title` is required; other fields are optional. Use `ttctl_profile_portfolio_upload_cover` first if you want to attach a cover image, then pass the resulting `coverImageCacheName` via the `coverImage` field on a follow-up `update` call (or supply via the underlying GraphQL input — currently the cover-then-create flow is two-step).",
+        inputSchema: {
+            title: z.string().describe("Portfolio item title"),
+            description: z.string().optional().describe("Long-form description of the item"),
+            link: z.string().optional().describe("Primary URL for the item"),
+            websiteUrl: z.string().optional().describe("Public website URL associated with the item"),
+            accomplishment: z.string().optional().describe("Short accomplishment summary"),
+            clientOrCompanyName: z.string().optional().describe("Client or company name"),
+            publicationPermit: z.boolean().optional().describe("Whether the user has permission to publish this item"),
+            toptalRelated: z.boolean().optional().describe("Whether the work is Toptal-related"),
+            showViaToptal: z.boolean().optional().describe("Whether the item should be visible via Toptal"),
+            highlight: z.boolean().optional().describe("Whether to mark this item as a highlight"),
+            industryIds: z
+                .array(z.string())
+                .min(1)
+                .describe('Catalog Industry ids (at least one required). Discover via `ttctl_profile_industries_autocomplete` or `ttctl profile industries autocomplete "<query>"`.'),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        const baseInput = buildPortfolioInput(args);
+        // industryIds is required by the schema (zod `.min(1)`); cast through
+        // the narrowed add-input type so the type-narrowed `add()` accepts it.
+        const input = { ...baseInput, industryIds: args.industryIds };
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("createPortfolioItem", "talent-profile", { input: { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER, portfolioItem: input } }, auth.token));
+        }
+        try {
+            const items = await profile.portfolio.add(auth.token, input);
+            return successResponse(items);
+        }
+        catch (err) {
+            return mapPortfolioError(err);
+        }
+    });
+    server.registerTool("ttctl_profile_portfolio_update", {
+        title: "Update a portfolio item",
+        description: "Update fields on an existing portfolio item by id. Only supplied fields are updated.",
+        inputSchema: {
+            id: z.string().describe("Id of the portfolio item to update"),
+            title: z.string().optional().describe("Portfolio item title"),
+            description: z.string().optional().describe("Long-form description of the item"),
+            link: z.string().optional().describe("Primary URL for the item"),
+            websiteUrl: z.string().optional().describe("Public website URL associated with the item"),
+            accomplishment: z.string().optional().describe("Short accomplishment summary"),
+            clientOrCompanyName: z.string().optional().describe("Client or company name"),
+            publicationPermit: z.boolean().optional().describe("Whether the user has permission to publish this item"),
+            toptalRelated: z.boolean().optional().describe("Whether the work is Toptal-related"),
+            showViaToptal: z.boolean().optional().describe("Whether the item should be visible via Toptal"),
+            highlight: z.boolean().optional().describe("Whether to mark this item as a highlight"),
+            industryIds: z
+                .array(z.string())
+                .min(1)
+                .optional()
+                .describe("Catalog Industry ids — when supplied, replaces the item's industry set (partial update)."),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        const { id, ...rest } = args;
+        const changes = buildPortfolioInput(rest);
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("updatePortfolioItem", "talent-profile", { input: { portfolioItemId: id, portfolioItem: changes } }, auth.token));
+        }
+        try {
+            const items = await profile.portfolio.update(auth.token, id, changes);
+            return successResponse(items);
+        }
+        catch (err) {
+            return mapPortfolioError(err);
+        }
+    });
+    server.registerTool("ttctl_profile_portfolio_remove", {
+        title: "Remove a portfolio item",
+        description: "Remove a portfolio item by id.",
+        inputSchema: {
+            id: z.string().describe("Id of the portfolio item to remove"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("removePortfolioItem", "talent-profile", { input: { portfolioItemId: args.id } }, auth.token));
+        }
+        try {
+            const items = await profile.portfolio.remove(auth.token, args.id);
+            return successResponse(items);
+        }
+        catch (err) {
+            return mapPortfolioError(err);
+        }
+    });
+    server.registerTool("ttctl_profile_portfolio_reorder", {
+        title: "Reorder a portfolio item",
+        description: "Move a portfolio item to an absolute 0-based position. To compute relative-to-neighbour positions, list portfolio items first to find indices.",
+        inputSchema: {
+            id: z.string().describe("Id of the portfolio item to move"),
+            position: z.number().int().min(0).describe("Absolute 0-based position to move the item to"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("changePortfolioItemPosition", "talent-profile", { input: { portfolioItemId: args.id, position: args.position } }, auth.token));
+        }
+        try {
+            const items = await profile.portfolio.reorder(auth.token, args.id, args.position);
+            return successResponse(items);
+        }
+        catch (err) {
+            return mapPortfolioError(err);
+        }
+    });
+    server.registerTool("ttctl_profile_portfolio_highlight", {
+        title: "Toggle highlight on a portfolio item",
+        description: "Set or clear the `highlight` flag on a portfolio item.",
+        inputSchema: {
+            id: z.string().describe("Id of the portfolio item"),
+            highlight: z.boolean().default(true).describe("`true` to set highlight, `false` to clear"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("highlightPortfolioItem", "talent-profile", { id: args.id, highlight: args.highlight }, auth.token));
+        }
+        try {
+            const result = await profile.portfolio.highlight(auth.token, args.id, args.highlight);
+            return successResponse(result);
+        }
+        catch (err) {
+            return mapPortfolioError(err);
+        }
+    });
+    server.registerTool("ttctl_profile_portfolio_upload_cover", {
+        title: "Upload a portfolio cover image",
+        description: "Upload a cover image for the user's portfolio. Supply EITHER `filePath` (server-relative; preferred when the host has filesystem access — Claude Desktop, Claude Code) OR `content` (base64-encoded; for web-hosted clients without filesystem access). Returns `coverImageCacheName` and `coverImageUrl`; pass the cache name into a subsequent portfolio-add or portfolio-update call's `coverImage` field to bind the cover to a specific item. Server requires the image to be at least 750x500 px and under 5 MB.",
+        inputSchema: {
+            ...fileUploadInputSchema,
+            cropX: z.number().int().nonnegative().optional().describe("crop origin x (px). Default: 0 (whole image)."),
+            cropY: z.number().int().nonnegative().optional().describe("crop origin y (px). Default: 0 (whole image)."),
+            cropW: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe("crop width (px). Default: PNG image width if detectable, otherwise oversized (server clamps)."),
+            cropH: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe("crop height (px). Default: PNG image height if detectable, otherwise oversized (server clamps)."),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("uploadPortfolioCover", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER, transformation: null, file: null }, auth.token));
+        }
+        const decoded = decodeFileUploadInput(args, UPLOAD_CATEGORIES.portfolioCover);
+        if ("isError" in decoded)
+            return decoded;
+        // Build the transformation only when ALL four crop fields are
+        // supplied; the service auto-defaults when omitted.
+        const transformation = args.cropX !== undefined && args.cropY !== undefined && args.cropW !== undefined && args.cropH !== undefined
+            ? { cropX: args.cropX, cropY: args.cropY, cropW: args.cropW, cropH: args.cropH }
+            : undefined;
+        try {
+            const result = await profile.portfolio.uploadCover(auth.token, decoded, transformation);
+            return successResponse(result);
+        }
+        catch (err) {
+            return mapPortfolioError(err);
+        }
+    });
+    server.registerTool("ttctl_profile_portfolio_upload_file", {
+        title: "Upload a portfolio attachment file",
+        description: "Upload an arbitrary attachment file for the user's portfolio. Supply EITHER `filePath` (preferred when the host has filesystem access) OR `content` (base64). Returns `fileCacheName` and `fileUrl`.",
+        inputSchema: { ...fileUploadInputSchema, dryRun: DRY_RUN_FIELD },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("uploadPortfolioFile", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER, file: null }, auth.token));
+        }
+        const decoded = decodeFileUploadInput(args, UPLOAD_CATEGORIES.portfolioFile);
+        if ("isError" in decoded)
+            return decoded;
+        try {
+            const result = await profile.portfolio.uploadFile(auth.token, decoded);
+            return successResponse(result);
+        }
+        catch (err) {
+            return mapPortfolioError(err);
+        }
+    });
+}
+function successResponse(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+/**
+ * Filter `undefined` values out of the optional-fields map so the
+ * resulting `PortfolioItemInput` satisfies `exactOptionalPropertyTypes`
+ * (which rejects `string | undefined` where `string` is expected).
+ *
+ * Zod's optional fields surface as `T | undefined` at the inferred type
+ * level; the service layer uses pure-optional `T?` keys. This helper
+ * bridges the two.
+ */
+function buildPortfolioInput(args) {
+    const out = {};
+    if (args.title !== undefined)
+        out.title = args.title;
+    if (args.description !== undefined)
+        out.description = args.description;
+    if (args.link !== undefined)
+        out.link = args.link;
+    if (args.websiteUrl !== undefined)
+        out.websiteUrl = args.websiteUrl;
+    if (args.accomplishment !== undefined)
+        out.accomplishment = args.accomplishment;
+    if (args.clientOrCompanyName !== undefined)
+        out.clientOrCompanyName = args.clientOrCompanyName;
+    if (args.publicationPermit !== undefined)
+        out.publicationPermit = args.publicationPermit;
+    if (args.toptalRelated !== undefined)
+        out.toptalRelated = args.toptalRelated;
+    if (args.showViaToptal !== undefined)
+        out.showViaToptal = args.showViaToptal;
+    if (args.highlight !== undefined)
+        out.highlight = args.highlight;
+    if (args.industryIds !== undefined)
+        out.industryIds = args.industryIds;
+    return out;
+}
+function mapPortfolioError(err) {
+    const typed = ttctlErrorToToolResponseOrNull(err);
+    if (typed !== null)
+        return typed;
+    if (err instanceof profile.portfolio.PortfolioError) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        `Error: ${err.message}`,
+                        "",
+                        "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: portfolio request failed: ${message}`,
+                    "",
+                    "Recovery: Retry; if the failure persists, file an issue.",
+                    "",
+                    "(Code: UNKNOWN)",
+                ].join("\n"),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=portfolio.js.map

package/dist/tools/profile/portfolio.js.map

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

package/dist/tools/profile/resume.d.ts

@@ -0,0 +1,16 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "../_shared.js";
+/**
+ * Register the two `ttctl_profile_resume_*` MCP tools.
+ *
+ * Tool names use the canonical sub-domain `resume` (NOT the CLI alias
+ * `cv`) per project policy.
+ *
+ * Dry-run path (issue #165): both tools accept `dryRun?: boolean`. On
+ * `dryRun: true` they return the uniform `{ ok, dryRun, preview }`
+ * envelope describing the GraphQL operations envelope (multipart binary
+ * body is not enumerated for `upload` — only the operations envelope
+ * with `input.file = null` per the wire shape that core sends).
+ */
+export declare function registerResumeTools(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=resume.d.ts.map

package/dist/tools/profile/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../../src/tools/profile/resume.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,EAAuD,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAUlH;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CAmDzF"}

package/dist/tools/profile/resume.js

@@ -0,0 +1,107 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { z } from "zod";
+import { ttctlErrorToToolResponseOrNull } from "../../errors.js";
+import { UPLOAD_CATEGORIES, decodeFileUploadInput, fileUploadInputSchema } from "../file-upload.js";
+import { buildMcpDryRunPreview, dryRunResponse, jsonResponse } from "../_shared.js";
+import { profileResumeUploadOutputSchema } from "../output-schemas.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 two `ttctl_profile_resume_*` MCP tools.
+ *
+ * Tool names use the canonical sub-domain `resume` (NOT the CLI alias
+ * `cv`) per project policy.
+ *
+ * Dry-run path (issue #165): both tools accept `dryRun?: boolean`. On
+ * `dryRun: true` they return the uniform `{ ok, dryRun, preview }`
+ * envelope describing the GraphQL operations envelope (multipart binary
+ * body is not enumerated for `upload` — only the operations envelope
+ * with `input.file = null` per the wire shape that core sends).
+ */
+export function registerResumeTools(server, ctx) {
+    server.registerTool("ttctl_profile_resume_upload", {
+        title: "Upload a resume file",
+        description: "Upload the user's resume (PDF or DOCX). Supply EITHER `filePath` (server-relative; preferred when the host has filesystem access — Claude Desktop, Claude Code) OR `content` (base64-encoded; for web-hosted clients without filesystem access). Returns `{ success: true }` on a server-confirmed success. Pass `dryRun: true` to preview the GraphQL operations envelope without firing.",
+        inputSchema: { ...fileUploadInputSchema, dryRun: DRY_RUN_FIELD },
+        outputSchema: profileResumeUploadOutputSchema.shape,
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("uploadResume", "talent-profile", { input: { file: null } }, auth.token));
+        }
+        const decoded = decodeFileUploadInput(args, UPLOAD_CATEGORIES.resume);
+        if ("isError" in decoded)
+            return decoded;
+        try {
+            const result = await profile.resume.upload(auth.token, decoded);
+            return jsonResponse(result);
+        }
+        catch (err) {
+            return mapResumeError(err);
+        }
+    });
+    server.registerTool("ttctl_profile_resume_cancel_upload", {
+        title: "Cancel an in-flight resume upload",
+        description: "Cancel any in-flight resume upload, clearing half-uploaded server-side state. Idempotent — returns success even when no upload is in flight. Pass `dryRun: true` to preview the request without firing.",
+        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("cancelResumeUpload", "talent-profile", { input: {} }, auth.token));
+        }
+        try {
+            const result = await profile.resume.cancelUpload(auth.token);
+            return jsonResponse(result);
+        }
+        catch (err) {
+            return mapResumeError(err);
+        }
+    });
+}
+function mapResumeError(err) {
+    const typed = ttctlErrorToToolResponseOrNull(err);
+    if (typed !== null)
+        return typed;
+    if (err instanceof profile.resume.ResumeError) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        `Error: ${err.message}`,
+                        "",
+                        "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: resume request failed: ${message}`,
+                    "",
+                    "Recovery: Retry; if the failure persists, file an issue.",
+                    "",
+                    "(Code: UNKNOWN)",
+                ].join("\n"),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=resume.js.map

package/dist/tools/profile/resume.js.map

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

package/dist/tools/profile/shared.d.ts

@@ -0,0 +1,85 @@
+import { z } from "zod";
+import type { ToolErrorResponse } from "../../errors.js";
+/**
+ * Zod schema for sub-domain `--from` / `--to` / `--issued` / `--expires` /
+ * other date-flavored flags. Accepts ISO-8601 (`YYYY-MM-DD`) or year-only
+ * (`YYYY`); semantic validation (real calendar dates, year range) happens
+ * later inside `parseDateInput` from `@ttctl/core`. Hoisted here so the
+ * four sub-domain tool files share a single source of truth.
+ */
+export declare const dateInput: z.ZodString;
+/**
+ * MCP tool-result success shape. Mirrors the SDK-side `CallToolResult`
+ * (which is inferred from a `z.core.$loose` schema and therefore carries
+ * an `[x: string]: unknown` index signature) — kept loose so the helper
+ * return type composes cleanly with the SDK's `ToolCallback`.
+ *
+ * `structuredContent` is populated by {@link jsonSuccess} so tools that
+ * declare an `outputSchema` (#226) get SDK-validated structured payload
+ * alongside the `text` slot.
+ */
+export interface ToolSuccessResponse {
+    [x: string]: unknown;
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    structuredContent?: Record<string, unknown>;
+}
+/**
+ * Render a JSON-serialized success response. Tools return structured data
+ * as JSON in the `text` content field — MCP-aware LLM clients can parse
+ * it; non-aware clients see human-readable JSON. The same payload is
+ * mirrored into `structuredContent` so tools declaring an `outputSchema`
+ * (#226) get SDK-validated structured output without per-tool plumbing.
+ *
+ * `structuredContent` is populated only when `payload` is an object —
+ * the MCP SDK's `structuredContent` slot expects an object shape, and
+ * array / primitive payloads stay in the `text` slot only.
+ */
+export declare function jsonSuccess(payload: unknown): ToolSuccessResponse;
+/**
+ * Render a plain-text success response (useful for verbs like `remove` /
+ * `highlight` whose output is a confirmation, not structured data). Use
+ * {@link textWithStructuredSuccess} when the tool also declares an
+ * `outputSchema` requiring a typed acknowledgment.
+ */
+export declare function textSuccess(text: string): ToolSuccessResponse;
+/**
+ * Render a confirmation line as the `text` content slot while also
+ * publishing a typed acknowledgment via `structuredContent`. Used by
+ * `*_remove` tools (#226) where the human-readable text stays for
+ * compatibility and the structured payload matches the tool's declared
+ * `outputSchema`.
+ */
+export declare function textWithStructuredSuccess(text: string, structuredContent: Record<string, unknown>): ToolSuccessResponse;
+/**
+ * Map a domain error from any sub-domain into an MCP tool-error response.
+ *
+ * Routes through three branches:
+ * - `TtctlError` subclasses → uniform Error/Recovery/Code blocks
+ * - `profile.basic.ProfileError` → `(<CODE>): <message>` line
+ * - anything else → generic `text: <message>`
+ *
+ * `commandLabel` (e.g. `"profile.education.add"`) prefixes the error
+ * line for sub-domain disambiguation.
+ */
+export declare function presentToolError(commandLabel: string, err: unknown): ToolErrorResponse;
+/**
+ * Resolve the auth-token path from `.ttctl.yaml` for an MCP tool. On
+ * `ConfigError`, returns the rendered tool-error response; on success,
+ * returns `{ token }`. The two-shape return lets the caller branch with
+ * `if ("error" in r) return r.error` instead of carrying try/catch.
+ *
+ * Post-#113: the resolver is a factory closure over the config path
+ * captured at MCP server startup. Per-call reads always target that path;
+ * env-var shifts during the session do NOT retarget the read.
+ */
+export type AuthResolution = {
+    token: string;
+} | {
+    error: ToolErrorResponse;
+};
+export type CommandLabelTokenResolver = (commandLabel: string) => Promise<AuthResolution>;
+export declare function createTokenResolver(configPath: string): CommandLabelTokenResolver;
+//# sourceMappingURL=shared.d.ts.map

package/dist/tools/profile/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/tools/profile/shared.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,aAEuE,CAAC;AAE9F;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACrB,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,CAQjE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAE7D;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,mBAAmB,CAKrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,iBAAiB,CAmBtF;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAE9E,MAAM,MAAM,yBAAyB,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAE1F,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,yBAAyB,CAmCjF"}