@ttctl/mcp 0.1.0-rc.1 → 0.1.0-rc.3

package/dist/tools/output-schemas.d.ts

@@ -1,115 +0,0 @@
-import { z } from "zod";
-/**
- * MCP `outputSchema` definitions for the top-10 write-capable tools
- * (#226). Each schema mirrors the TypeScript return type from
- * `@ttctl/core` so LLM clients reading the tool registry can validate
- * the structured payload they receive.
- *
- * Each schema describes the SUCCESS-path payload only. Dry-run responses
- * use the uniform `{ ok, dryRun, preview }` envelope advertised via the
- * tool description (see `_shared.ts` § `dryRunResponse`) and intentionally
- * carry NO `structuredContent` — the SDK skips `outputSchema` validation
- * when `structuredContent` is absent (per `@modelcontextprotocol/sdk`
- * `_validateOutput`), so dry-run paths bypass success-shape validation
- * cleanly.
- *
- * The MCP SDK's `normalizeObjectSchema` accepts only ZodObject shapes for
- * `outputSchema`; unions and discriminated unions are silently dropped.
- * Therefore each schema below is a single `z.object()` describing the
- * apply-path payload — sufficient for the AC ("LLM clients can validate
- * tool output against the schema").
- */
-/**
- * Shape returned by `profile.basic.set()` on the apply path —
- * mirrors `UpdateProfileResult` from `@ttctl/core`.
- */
-export declare const profileBasicUpdateOutputSchema: z.ZodObject<{
-    profile: z.ZodObject<{
-        id: z.ZodString;
-        about: z.ZodNullable<z.ZodString>;
-        quote: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>;
-    notice: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>;
-/**
- * Shape returned by `profile.basic.photoUpload()` — mirrors `PhotoUrl`
- * from `@ttctl/core`.
- */
-export declare const profileBasicPhotoUploadOutputSchema: z.ZodObject<{
-    default: z.ZodNullable<z.ZodString>;
-    original: z.ZodNullable<z.ZodString>;
-    small: z.ZodNullable<z.ZodString>;
-    cropped: z.ZodNullable<z.ZodObject<{
-        x: z.ZodNumber;
-        y: z.ZodNumber;
-        width: z.ZodNumber;
-        height: z.ZodNumber;
-    }, z.core.$strip>>;
-    isResolutionSatisfied: z.ZodBoolean;
-}, z.core.$strip>;
-/**
- * Shape returned by `profile.resume.upload()` — mirrors
- * `UploadResumeResult` from `@ttctl/core`.
- */
-export declare const profileResumeUploadOutputSchema: z.ZodObject<{
-    success: z.ZodBoolean;
-}, z.core.$strip>;
-/**
- * Shape returned by `profile.education.add()` / `update()` — mirrors
- * `Education` from `@ttctl/core`.
- */
-export declare const profileEducationRowOutputSchema: z.ZodObject<{
-    id: z.ZodString;
-    institution: z.ZodString;
-    degree: z.ZodString;
-    fieldOfStudy: z.ZodNullable<z.ZodString>;
-    location: z.ZodNullable<z.ZodString>;
-    title: z.ZodNullable<z.ZodString>;
-    yearFrom: z.ZodNullable<z.ZodNumber>;
-    yearTo: z.ZodNullable<z.ZodNumber>;
-    highlight: z.ZodBoolean;
-}, z.core.$strip>;
-/**
- * Shape returned by the `*_remove` tools' structured-content slot —
- * `{ id, removed: true }`. The `text` content slot retains the
- * human-readable confirmation; `structuredContent` exposes a typed
- * acknowledgment.
- */
-export declare const profileRowRemoveOutputSchema: z.ZodObject<{
-    id: z.ZodString;
-    removed: z.ZodLiteral<true>;
-}, z.core.$strip>;
-/**
- * Shape returned by `profile.employment.add()` / `update()` — mirrors
- * `Employment` from `@ttctl/core`.
- */
-export declare const profileEmploymentRowOutputSchema: z.ZodObject<{
-    id: z.ZodString;
-    company: z.ZodString;
-    position: z.ZodString;
-    companyWebsite: z.ZodNullable<z.ZodString>;
-    noWebsite: z.ZodBoolean;
-    startDate: z.ZodNullable<z.ZodNumber>;
-    endDate: z.ZodNullable<z.ZodNumber>;
-    experienceItems: z.ZodNullable<z.ZodArray<z.ZodString>>;
-    highlight: z.ZodBoolean;
-    showViaToptal: z.ZodBoolean;
-    toptalRelated: z.ZodBoolean;
-}, z.core.$strip>;
-/**
- * Shape returned by `profile.industries.update()` — mirrors
- * `IndustryProfile` from `@ttctl/core`.
- */
-export declare const profileIndustriesRowOutputSchema: z.ZodObject<{
-    id: z.ZodString;
-    title: z.ZodString;
-    about: z.ZodNullable<z.ZodString>;
-    domainArea: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>;
-/**
- * Tool names (frozen) that the test suite asserts must carry a populated
- * `outputSchema`. Adding a new write-capable tool: append its name here
- * and define the schema above.
- */
-export declare const TOOLS_WITH_OUTPUT_SCHEMA: readonly ["ttctl_profile_basic_update", "ttctl_profile_basic_photo_upload", "ttctl_profile_resume_upload", "ttctl_profile_education_add", "ttctl_profile_education_update", "ttctl_profile_education_remove", "ttctl_profile_employment_add", "ttctl_profile_employment_update", "ttctl_profile_employment_remove", "ttctl_profile_industries_update"];
-//# sourceMappingURL=output-schemas.d.ts.map

package/dist/tools/output-schemas.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"output-schemas.d.ts","sourceRoot":"","sources":["../../src/tools/output-schemas.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;GAGG;AACH,eAAO,MAAM,8BAA8B;;;;;;;iBAOzC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mCAAmC;;;;;;;;;;;iBAa9C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,+BAA+B;;iBAE1C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;iBAU1C,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B;;;iBAGvC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;iBAY3C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gCAAgC;;;;;iBAK3C,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,wVAW3B,CAAC"}

package/dist/tools/output-schemas.js

@@ -1,130 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-only
-// Copyright (C) 2026 Oleksii PELYKH
-import { z } from "zod";
-/**
- * MCP `outputSchema` definitions for the top-10 write-capable tools
- * (#226). Each schema mirrors the TypeScript return type from
- * `@ttctl/core` so LLM clients reading the tool registry can validate
- * the structured payload they receive.
- *
- * Each schema describes the SUCCESS-path payload only. Dry-run responses
- * use the uniform `{ ok, dryRun, preview }` envelope advertised via the
- * tool description (see `_shared.ts` § `dryRunResponse`) and intentionally
- * carry NO `structuredContent` — the SDK skips `outputSchema` validation
- * when `structuredContent` is absent (per `@modelcontextprotocol/sdk`
- * `_validateOutput`), so dry-run paths bypass success-shape validation
- * cleanly.
- *
- * The MCP SDK's `normalizeObjectSchema` accepts only ZodObject shapes for
- * `outputSchema`; unions and discriminated unions are silently dropped.
- * Therefore each schema below is a single `z.object()` describing the
- * apply-path payload — sufficient for the AC ("LLM clients can validate
- * tool output against the schema").
- */
-/**
- * Shape returned by `profile.basic.set()` on the apply path —
- * mirrors `UpdateProfileResult` from `@ttctl/core`.
- */
-export const profileBasicUpdateOutputSchema = z.object({
-    profile: z.object({
-        id: z.string(),
-        about: z.string().nullable(),
-        quote: z.string().nullable(),
-    }),
-    notice: z.string().nullable(),
-});
-/**
- * Shape returned by `profile.basic.photoUpload()` — mirrors `PhotoUrl`
- * from `@ttctl/core`.
- */
-export const profileBasicPhotoUploadOutputSchema = z.object({
-    default: z.string().nullable(),
-    original: z.string().nullable(),
-    small: z.string().nullable(),
-    cropped: z
-        .object({
-        x: z.number(),
-        y: z.number(),
-        width: z.number(),
-        height: z.number(),
-    })
-        .nullable(),
-    isResolutionSatisfied: z.boolean(),
-});
-/**
- * Shape returned by `profile.resume.upload()` — mirrors
- * `UploadResumeResult` from `@ttctl/core`.
- */
-export const profileResumeUploadOutputSchema = z.object({
-    success: z.boolean(),
-});
-/**
- * Shape returned by `profile.education.add()` / `update()` — mirrors
- * `Education` from `@ttctl/core`.
- */
-export const profileEducationRowOutputSchema = z.object({
-    id: z.string(),
-    institution: z.string(),
-    degree: z.string(),
-    fieldOfStudy: z.string().nullable(),
-    location: z.string().nullable(),
-    title: z.string().nullable(),
-    yearFrom: z.number().nullable(),
-    yearTo: z.number().nullable(),
-    highlight: z.boolean(),
-});
-/**
- * Shape returned by the `*_remove` tools' structured-content slot —
- * `{ id, removed: true }`. The `text` content slot retains the
- * human-readable confirmation; `structuredContent` exposes a typed
- * acknowledgment.
- */
-export const profileRowRemoveOutputSchema = z.object({
-    id: z.string(),
-    removed: z.literal(true),
-});
-/**
- * Shape returned by `profile.employment.add()` / `update()` — mirrors
- * `Employment` from `@ttctl/core`.
- */
-export const profileEmploymentRowOutputSchema = z.object({
-    id: z.string(),
-    company: z.string(),
-    position: z.string(),
-    companyWebsite: z.string().nullable(),
-    noWebsite: z.boolean(),
-    startDate: z.number().nullable(),
-    endDate: z.number().nullable(),
-    experienceItems: z.array(z.string()).nullable(),
-    highlight: z.boolean(),
-    showViaToptal: z.boolean(),
-    toptalRelated: z.boolean(),
-});
-/**
- * Shape returned by `profile.industries.update()` — mirrors
- * `IndustryProfile` from `@ttctl/core`.
- */
-export const profileIndustriesRowOutputSchema = z.object({
-    id: z.string(),
-    title: z.string(),
-    about: z.string().nullable(),
-    domainArea: z.string().nullable(),
-});
-/**
- * Tool names (frozen) that the test suite asserts must carry a populated
- * `outputSchema`. Adding a new write-capable tool: append its name here
- * and define the schema above.
- */
-export const TOOLS_WITH_OUTPUT_SCHEMA = [
-    "ttctl_profile_basic_update",
-    "ttctl_profile_basic_photo_upload",
-    "ttctl_profile_resume_upload",
-    "ttctl_profile_education_add",
-    "ttctl_profile_education_update",
-    "ttctl_profile_education_remove",
-    "ttctl_profile_employment_add",
-    "ttctl_profile_employment_update",
-    "ttctl_profile_employment_remove",
-    "ttctl_profile_industries_update",
-];
-//# sourceMappingURL=output-schemas.js.map

package/dist/tools/output-schemas.js.map

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