@ttctl/mcp 0.0.0 → 0.1.0-rc.2

package/dist/tools/profile/employment.js

@@ -0,0 +1,254 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { parseDateInput, profile, splitParagraphs } from "@ttctl/core";
+import { z } from "zod";
+import { buildMcpDryRunPreview, dryRunResponse } from "../_shared.js";
+import { profileEmploymentRowOutputSchema, profileRowRemoveOutputSchema } from "../output-schemas.js";
+import { dateInput, jsonSuccess, presentToolError, textWithStructuredSuccess } 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 six `profile.employment.*` MCP tools on `server`.
+ *
+ * MCP tool names use ONLY the canonical `employment` form — the CLI
+ * alias `experience` (per #72) is CLI-only and never appears in the MCP
+ * catalog.
+ *
+ * The sixth tool (`employer_autocomplete`) is the catalog lookup leaf
+ * — it returns suggestions from the known-employer database, useful
+ * for resolving free-text employer names to canonical Toptal IDs
+ * before adding a new employment row.
+ *
+ * Dry-run path (issue #165): every tool accepts `dryRun?: boolean`. When
+ * `dryRun: true`, returns `{ ok: true, dryRun: true, preview }` via
+ * MCP-layer preview building. `show` previews `GET_WORK_EXPERIENCE` (the
+ * apply path lists then filters client-side; no per-id selector exists).
+ * `profileId` carries `DRY_RUN_PROFILE_ID_PLACEHOLDER` where the apply
+ * path resolves it via a sibling profile read.
+ */
+export function registerEmploymentTools(server, ctx) {
+    server.registerTool("ttctl_profile_employment_add", {
+        title: "Add employment entry",
+        description: "Add a new employment entry (company + role, with optional start/end years and `current` flag). Dates accept ISO-8601 (YYYY-MM-DD) or year-only (YYYY); year only is stored.",
+        inputSchema: {
+            company: z.string().min(1).describe("company / employer name"),
+            role: z.string().min(1).describe("job title (mapped to position)"),
+            from: dateInput.optional().describe("start date — ISO-8601 or year"),
+            to: dateInput.optional().describe("end date — ISO-8601 or year"),
+            current: z.boolean().optional().describe("mark as current position (no end date)"),
+            website: z.url().optional().describe("company website"),
+            description: z
+                .string()
+                .optional()
+                .describe("multi-paragraph description; split on blank lines into experienceItems"),
+            dryRun: DRY_RUN_FIELD,
+        },
+        outputSchema: profileEmploymentRowOutputSchema.shape,
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.employment.add");
+        if ("error" in auth)
+            return auth.error;
+        const fields = {
+            company: input.company,
+            position: input.role,
+        };
+        try {
+            if (input.from !== undefined)
+                fields.startDate = parseDateInput(input.from, "from").year;
+            if (input.to !== undefined)
+                fields.endDate = parseDateInput(input.to, "to").year;
+        }
+        catch (err) {
+            return presentToolError("profile.employment.add", err);
+        }
+        if (input.current === true)
+            fields.endDate = null;
+        if (input.website !== undefined) {
+            fields.companyWebsite = input.website;
+            fields.noWebsite = false;
+        }
+        if (input.description !== undefined) {
+            fields.experienceItems = splitParagraphs(input.description);
+        }
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("CreateEmployment", "talent-profile", { input: { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER, employment: fields } }, auth.token));
+        }
+        try {
+            const created = await profile.employment.add(auth.token, fields);
+            return jsonSuccess(created);
+        }
+        catch (err) {
+            return presentToolError("profile.employment.add", err);
+        }
+    });
+    server.registerTool("ttctl_profile_employment_update", {
+        title: "Update employment entry",
+        description: "Update an existing employment entry by id. At least one field must be supplied. `description` is multi-paragraph free-text and splits on blank lines.",
+        inputSchema: {
+            id: z.string().min(1).describe("employment id (V1-Employment-NNN)"),
+            company: z.string().optional(),
+            role: z.string().optional(),
+            from: dateInput.optional(),
+            to: dateInput.optional(),
+            current: z.boolean().optional(),
+            website: z.url().optional(),
+            description: z.string().optional(),
+            highlight: z.boolean().optional(),
+            dryRun: DRY_RUN_FIELD,
+        },
+        outputSchema: profileEmploymentRowOutputSchema.shape,
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.employment.update");
+        if ("error" in auth)
+            return auth.error;
+        const fields = {};
+        try {
+            if (input.from !== undefined)
+                fields.startDate = parseDateInput(input.from, "from").year;
+            if (input.to !== undefined)
+                fields.endDate = parseDateInput(input.to, "to").year;
+        }
+        catch (err) {
+            return presentToolError("profile.employment.update", err);
+        }
+        if (input.current === true)
+            fields.endDate = null;
+        if (input.company !== undefined)
+            fields.company = input.company;
+        if (input.role !== undefined)
+            fields.position = input.role;
+        if (input.website !== undefined) {
+            fields.companyWebsite = input.website;
+            fields.noWebsite = false;
+        }
+        if (input.description !== undefined) {
+            fields.experienceItems = splitParagraphs(input.description);
+        }
+        if (input.highlight !== undefined)
+            fields.highlight = input.highlight;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("UpdateEmployment", "talent-profile", { input: { employmentId: input.id, employment: fields } }, auth.token));
+        }
+        try {
+            const updated = await profile.employment.update(auth.token, input.id, fields);
+            return jsonSuccess(updated);
+        }
+        catch (err) {
+            return presentToolError("profile.employment.update", err);
+        }
+    });
+    server.registerTool("ttctl_profile_employment_remove", {
+        title: "Remove employment entry",
+        description: "Remove an employment entry by id.",
+        inputSchema: { id: z.string().min(1).describe("employment id"), dryRun: DRY_RUN_FIELD },
+        outputSchema: profileRowRemoveOutputSchema.shape,
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.employment.remove");
+        if ("error" in auth)
+            return auth.error;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("RemoveEmployment", "talent-profile", { input: { employmentId: input.id } }, auth.token));
+        }
+        try {
+            const id = await profile.employment.remove(auth.token, input.id);
+            return textWithStructuredSuccess(`Employment ${id} removed.`, { id, removed: true });
+        }
+        catch (err) {
+            return presentToolError("profile.employment.remove", err);
+        }
+    });
+    server.registerTool("ttctl_profile_employment_show", {
+        title: "Show employment entry",
+        description: "Show a single employment entry by id (returns the row as JSON). Note: the underlying wire call lists all rows and filters client-side; the dry-run preview emits `GET_WORK_EXPERIENCE` (the list query) accordingly.",
+        inputSchema: { id: z.string().min(1).describe("employment id"), dryRun: DRY_RUN_FIELD },
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.employment.show");
+        if ("error" in auth)
+            return auth.error;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("GET_WORK_EXPERIENCE", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER }, auth.token));
+        }
+        try {
+            const row = await profile.employment.show(auth.token, input.id);
+            return jsonSuccess(row);
+        }
+        catch (err) {
+            return presentToolError("profile.employment.show", err);
+        }
+    });
+    server.registerTool("ttctl_profile_employment_list", {
+        title: "List employment entries",
+        description: [
+            "List every employment entry on the signed-in user's Toptal profile, with each row's full per-item shape (mirrors `ttctl_profile_employment_show`).",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "What employment entries do I have on my Toptal profile?"',
+            '  - "Show me all my Toptal work experience."',
+            '  - "List my Toptal employment IDs so I can edit one."',
+        ].join("\n"),
+        inputSchema: { dryRun: DRY_RUN_FIELD },
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.employment.list");
+        if ("error" in auth)
+            return auth.error;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("GET_WORK_EXPERIENCE", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER }, auth.token));
+        }
+        try {
+            const rows = await profile.employment.list(auth.token);
+            return jsonSuccess(rows);
+        }
+        catch (err) {
+            return presentToolError("profile.employment.list", err);
+        }
+    });
+    server.registerTool("ttctl_profile_employment_highlight", {
+        title: "Toggle employment highlight",
+        description: "Toggle the highlight flag on an employment entry.",
+        inputSchema: {
+            id: z.string().min(1).describe("employment id"),
+            highlight: z.boolean().default(true),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.employment.highlight");
+        if ("error" in auth)
+            return auth.error;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("highlightEmployment", "talent-profile", { id: input.id, highlight: input.highlight }, auth.token));
+        }
+        try {
+            const result = await profile.employment.highlight(auth.token, input.id, input.highlight);
+            return jsonSuccess(result);
+        }
+        catch (err) {
+            return presentToolError("profile.employment.highlight", err);
+        }
+    });
+    server.registerTool("ttctl_profile_employment_employer_autocomplete", {
+        title: "Search employer catalog",
+        description: 'Search the known-employer catalog by name (e.g. "Google"). Returns up to `limit` suggestions with their canonical IDs.',
+        inputSchema: {
+            query: z.string().min(1).describe("search term"),
+            limit: z.number().int().min(1).max(50).default(10).describe("max results"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.employment.employer_autocomplete");
+        if ("error" in auth)
+            return auth.error;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("GET_EMPLOYERS_AUTOCOMPLETE", "talent-profile", { search: input.query, limit: input.limit }, auth.token));
+        }
+        try {
+            const suggestions = await profile.employment.employerAutocomplete(auth.token, input.query, input.limit);
+            return jsonSuccess(suggestions);
+        }
+        catch (err) {
+            return presentToolError("profile.employment.employer_autocomplete", err);
+        }
+    });
+}
+//# sourceMappingURL=employment.js.map

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

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

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

@@ -0,0 +1,30 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "../_shared.js";
+/**
+ * Register the six `profile.industries.*` MCP tools on `server`.
+ *
+ * Tools:
+ *   - ttctl_profile_industries_add
+ *   - ttctl_profile_industries_update
+ *   - ttctl_profile_industries_remove
+ *   - ttctl_profile_industries_show
+ *   - ttctl_profile_industries_list
+ *   - ttctl_profile_industries_autocomplete  (catalog lookup, distinct
+ *     from add — the autocomplete leaf returns suggestions from the
+ *     known-industry database; add does NOT consult the catalog)
+ *
+ * `show` is the per-id read companion of `list`, added in #342 to close
+ * the Class A surface-shape gap (the service exported a `show()` but
+ * neither CLI nor MCP exposed it). The underlying wire call is a true
+ * per-id `node()` lookup (`GetIndustryProfile`), distinct from the
+ * list-and-filter pattern used by `certifications.show` / `education.show` /
+ * `employment.show`.
+ *
+ * Dry-run path (issue #165): every tool accepts `dryRun?: boolean`.
+ * When `dryRun: true`, returns `{ ok: true, dryRun: true, preview }` via
+ * MCP-layer preview building. `profileId` carries
+ * `DRY_RUN_PROFILE_ID_PLACEHOLDER` where the apply path resolves it via
+ * a sibling profile read (`extractProfileId`).
+ */
+export declare function registerIndustriesTools(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=industries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"industries.d.ts","sourceRoot":"","sources":["../../../src/tools/profile/industries.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAyC,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAWpG;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CAgN7F"}

package/dist/tools/profile/industries.js

@@ -0,0 +1,196 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { z } from "zod";
+import { buildMcpDryRunPreview, dryRunResponse } from "../_shared.js";
+import { profileIndustriesRowOutputSchema } from "../output-schemas.js";
+import { jsonSuccess, presentToolError, textSuccess } 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 six `profile.industries.*` MCP tools on `server`.
+ *
+ * Tools:
+ *   - ttctl_profile_industries_add
+ *   - ttctl_profile_industries_update
+ *   - ttctl_profile_industries_remove
+ *   - ttctl_profile_industries_show
+ *   - ttctl_profile_industries_list
+ *   - ttctl_profile_industries_autocomplete  (catalog lookup, distinct
+ *     from add — the autocomplete leaf returns suggestions from the
+ *     known-industry database; add does NOT consult the catalog)
+ *
+ * `show` is the per-id read companion of `list`, added in #342 to close
+ * the Class A surface-shape gap (the service exported a `show()` but
+ * neither CLI nor MCP exposed it). The underlying wire call is a true
+ * per-id `node()` lookup (`GetIndustryProfile`), distinct from the
+ * list-and-filter pattern used by `certifications.show` / `education.show` /
+ * `employment.show`.
+ *
+ * Dry-run path (issue #165): every tool accepts `dryRun?: boolean`.
+ * When `dryRun: true`, returns `{ ok: true, dryRun: true, preview }` via
+ * MCP-layer preview building. `profileId` carries
+ * `DRY_RUN_PROFILE_ID_PLACEHOLDER` where the apply path resolves it via
+ * a sibling profile read (`extractProfileId`).
+ */
+export function registerIndustriesTools(server, ctx) {
+    server.registerTool("ttctl_profile_industries_add", {
+        title: "Add industry-profile entry",
+        description: "Add a new industry-profile entry to the user's profile (the user's authored domain-expertise entry). `name` becomes the title; `connection` becomes domainArea (the user's role within the industry, e.g. 'Backend' for the 'Healthcare' industry).",
+        inputSchema: {
+            name: z.string().min(1).describe("industry name (mapped to title)"),
+            connection: z.string().optional().describe("connection / role within the industry"),
+            about: z.string().optional().describe("longer-form description"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.industries.add");
+        if ("error" in auth)
+            return auth.error;
+        const fields = { title: input.name };
+        if (input.connection !== undefined)
+            fields.domainArea = input.connection;
+        if (input.about !== undefined)
+            fields.about = input.about;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("CreateIndustryProfile", "talent-profile", { input: { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER, industryProfile: fields } }, auth.token));
+        }
+        try {
+            const created = await profile.industries.add(auth.token, fields);
+            return jsonSuccess(created);
+        }
+        catch (err) {
+            return presentToolError("profile.industries.add", err);
+        }
+    });
+    server.registerTool("ttctl_profile_industries_update", {
+        title: "Update industry-profile entry",
+        description: "Update an existing industry-profile entry by id. At least one field must be supplied.",
+        inputSchema: {
+            id: z.string().min(1).describe("industry profile id"),
+            name: z.string().optional(),
+            connection: z.string().optional(),
+            about: z.string().optional(),
+            dryRun: DRY_RUN_FIELD,
+        },
+        outputSchema: profileIndustriesRowOutputSchema.shape,
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.industries.update");
+        if ("error" in auth)
+            return auth.error;
+        const fields = {};
+        if (input.name !== undefined)
+            fields.title = input.name;
+        if (input.connection !== undefined)
+            fields.domainArea = input.connection;
+        if (input.about !== undefined)
+            fields.about = input.about;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("UpdateIndustryProfile", "talent-profile", { input: { industryProfileId: input.id, industryProfile: fields } }, auth.token));
+        }
+        try {
+            const updated = await profile.industries.update(auth.token, input.id, fields);
+            return jsonSuccess(updated);
+        }
+        catch (err) {
+            return presentToolError("profile.industries.update", err);
+        }
+    });
+    server.registerTool("ttctl_profile_industries_remove", {
+        title: "Remove industry-profile entry",
+        description: "Remove an industry-profile entry by id.",
+        inputSchema: {
+            id: z.string().min(1).describe("industry profile id"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.industries.remove");
+        if ("error" in auth)
+            return auth.error;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("RemoveIndustryProfile", "talent-profile", { input: { industryProfileId: input.id } }, auth.token));
+        }
+        try {
+            const id = await profile.industries.remove(auth.token, input.id);
+            return textSuccess(`Industry ${id} removed.`);
+        }
+        catch (err) {
+            return presentToolError("profile.industries.remove", err);
+        }
+    });
+    server.registerTool("ttctl_profile_industries_show", {
+        title: "Show industry-profile entry",
+        description: "Show a single industry-profile entry by id (returns the row as JSON). Resolved via the `node()` GraphQL resolver — a true per-id lookup, distinct from certifications/education/employment `show` which list-and-filter client-side.",
+        inputSchema: { id: z.string().min(1).describe("industry profile id"), dryRun: DRY_RUN_FIELD },
+        outputSchema: profileIndustriesRowOutputSchema.shape,
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.industries.show");
+        if ("error" in auth)
+            return auth.error;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("GetIndustryProfile", "talent-profile", { id: input.id }, auth.token));
+        }
+        try {
+            const row = await profile.industries.show(auth.token, input.id);
+            return jsonSuccess(row);
+        }
+        catch (err) {
+            return presentToolError("profile.industries.show", err);
+        }
+    });
+    server.registerTool("ttctl_profile_industries_list", {
+        title: "List industry-profile entries",
+        description: "List the user's industry-profile entries (returns an array of rows as JSON).",
+        inputSchema: { dryRun: DRY_RUN_FIELD },
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.industries.list");
+        if ("error" in auth)
+            return auth.error;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("ListIndustryProfiles", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER }, auth.token));
+        }
+        try {
+            const rows = await profile.industries.list(auth.token);
+            return jsonSuccess(rows);
+        }
+        catch (err) {
+            return presentToolError("profile.industries.list", err);
+        }
+    });
+    server.registerTool("ttctl_profile_industries_autocomplete", {
+        title: "Search industries catalog",
+        description: 'Search the known-industries catalog by name (e.g. "Healthcare"). Returns up to `limit` suggestions with their canonical IDs. Distinct from `industries_add` — this is a lookup leaf, not a write.',
+        inputSchema: {
+            query: z.string().min(1).describe("search term"),
+            limit: z.number().int().min(1).max(50).default(10),
+            withoutIds: z
+                .array(z.string())
+                .optional()
+                .describe("exclude these industry IDs from the result (e.g. industries already on the profile)"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.industries.autocomplete");
+        if ("error" in auth)
+            return auth.error;
+        if (input.dryRun === true) {
+            const variables = { search: input.query, limit: input.limit };
+            if (input.withoutIds !== undefined)
+                variables["withoutIds"] = input.withoutIds;
+            return dryRunResponse(buildMcpDryRunPreview("GET_INDUSTRIES_FOR_AUTOCOMPLETE", "talent-profile", variables, auth.token));
+        }
+        try {
+            const opts = { limit: input.limit };
+            if (input.withoutIds !== undefined)
+                opts.withoutIds = input.withoutIds;
+            const suggestions = await profile.industries.autocomplete(auth.token, input.query, opts);
+            return jsonSuccess(suggestions);
+        }
+        catch (err) {
+            return presentToolError("profile.industries.autocomplete", err);
+        }
+    });
+}
+//# sourceMappingURL=industries.js.map

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

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

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

@@ -0,0 +1,22 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "../_shared.js";
+/**
+ * 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 declare function registerPortfolioTools(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=portfolio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"portfolio.d.ts","sourceRoot":"","sources":["../../../src/tools/profile/portfolio.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,EAAyC,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AASpG;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CA4T5F"}