@teamso/teamso-mcp 0.0.0-stage → 1.2.1

package/dist/utils/dates.js

@@ -0,0 +1,102 @@
+import { ToolInputError } from './results.js';
+/**
+ * Teamso leave dates are Turkey wall-clock strings (`yyyy-MM-dd HH:mm`) that
+ * the API stores and returns unchanged. They are never converted to or from
+ * UTC here.
+ */
+const DATE_INPUT = /^(\d{4})-(\d{2})-(\d{2})(?:[ T](\d{2}):(\d{2})(?::\d{2}(?:\.\d+)?)?)?$/;
+const TIME = /^(\d{2}):(\d{2})/;
+export const DEFAULT_WORKDAY_START = '09:00';
+export const DEFAULT_WORKDAY_END = '18:00';
+/** Parses `yyyy-MM-dd`, `yyyy-MM-dd HH:mm` or `yyyy-MM-ddTHH:mm[:ss]`; throws a readable error otherwise. */
+export function parseWallClock(value, field) {
+    const match = DATE_INPUT.exec(value.trim());
+    if (!match) {
+        throw new ToolInputError(`\`${field}\` must be \`yyyy-MM-dd\` or \`yyyy-MM-dd HH:mm\` (Turkey local time), got "${value}".`);
+    }
+    const [, year, month, day, hour, minute] = match;
+    const calendar = new Date(Date.UTC(Number(year), Number(month) - 1, Number(day)));
+    if (calendar.getUTCFullYear() !== Number(year)
+        || calendar.getUTCMonth() !== Number(month) - 1
+        || calendar.getUTCDate() !== Number(day)) {
+        throw new ToolInputError(`\`${field}\` is not a real calendar date: "${value}".`);
+    }
+    if (hour !== undefined && (Number(hour) > 23 || Number(minute) > 59)) {
+        throw new ToolInputError(`\`${field}\` has an invalid time: "${value}".`);
+    }
+    return {
+        date: `${year}-${month}-${day}`,
+        time: hour !== undefined ? `${hour}:${minute}` : undefined,
+    };
+}
+export function formatWallClock(date, time) {
+    return `${date} ${time}`;
+}
+/** `HH:mm` from `HH:mm[:ss]`, or undefined. */
+export function toClockTime(value) {
+    if (!value)
+        return undefined;
+    const match = TIME.exec(value.trim());
+    if (!match)
+        return undefined;
+    return Number(match[1]) <= 23 && Number(match[2]) <= 59 ? `${match[1]}:${match[2]}` : undefined;
+}
+export const TEAMSO_TIME_ZONE = 'Europe/Istanbul';
+/** An ISO 8601 instant: a date-time with `Z` or a numeric UTC offset. */
+const ISO_INSTANT = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:?\d{2})$/i;
+const istanbulParts = new Intl.DateTimeFormat('en-CA', {
+    timeZone: TEAMSO_TIME_ZONE,
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    hourCycle: 'h23',
+});
+/**
+ * An instant (epoch millis or ISO string with an offset) as Turkey wall-clock
+ * parts. Wall-clock strings without an offset are not instants and return
+ * undefined, so they are never shifted.
+ */
+function istanbulWallClock(value) {
+    if (typeof value === 'string' && !ISO_INSTANT.test(value.trim()))
+        return undefined;
+    const instant = new Date(typeof value === 'number' ? value : value.trim());
+    if (Number.isNaN(instant.getTime()))
+        return undefined;
+    const parts = Object.fromEntries(istanbulParts.formatToParts(instant).map(part => [part.type, part.value]));
+    return {
+        date: `${parts.year}-${parts.month}-${parts.day}`,
+        time: `${parts.hour}:${parts.minute}`,
+    };
+}
+/**
+ * `yyyy-MM-dd` from an API date. Instants (epoch millis, ISO strings with an
+ * offset) are read on the Turkey calendar, so a midnight stored in either UTC
+ * or Turkey time lands on the intended day; wall-clock strings
+ * (`yyyy-MM-dd[ HH:mm]`) are taken as they are.
+ */
+export function toIsoDay(value) {
+    if (value === null || value === undefined || value === '')
+        return undefined;
+    const instant = istanbulWallClock(value);
+    if (instant)
+        return instant.date;
+    if (typeof value === 'number')
+        return undefined;
+    const match = /^(\d{4}-\d{2}-\d{2})/.exec(value.trim());
+    return match?.[1];
+}
+/**
+ * API date-time for display. Instants become Turkey wall clock
+ * (`yyyy-MM-dd HH:mm`), matching the leave dates; other strings are kept.
+ */
+export function toDisplayDateTime(value) {
+    if (value === null || value === undefined || value === '')
+        return undefined;
+    const instant = istanbulWallClock(value);
+    if (instant)
+        return formatWallClock(instant.date, instant.time);
+    return typeof value === 'string' ? value : undefined;
+}
+//# sourceMappingURL=dates.js.map

package/dist/utils/dates.js.map

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

package/dist/utils/format.d.ts

@@ -0,0 +1,8 @@
+/** Small Markdown helpers for the human-readable half of tool results. */
+export declare function markdownTable(headers: string[], rows: Array<Array<string | number | boolean | undefined | null>>): string;
+export declare function escapeCell(value: string | number | boolean | undefined | null): string;
+/** "1 day", "2.5 days". */
+export declare function formatDays(value: number): string;
+export declare function formatDateRange(start: string | undefined, end: string | undefined): string;
+export declare function codeList(values: string[]): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,GAAG,MAAM,CAKzH;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAGtF;AAED,2BAA2B;AAC3B,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG1F;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAEjD"}

package/dist/utils/format.js

@@ -0,0 +1,26 @@
+/** Small Markdown helpers for the human-readable half of tool results. */
+export function markdownTable(headers, rows) {
+    const head = `| ${headers.map(escapeCell).join(' | ')} |`;
+    const divider = `| ${headers.map(() => '---').join(' | ')} |`;
+    const body = rows.map(row => `| ${row.map(cell => escapeCell(cell)).join(' | ')} |`);
+    return [head, divider, ...body].join('\n');
+}
+export function escapeCell(value) {
+    if (value === undefined || value === null || value === '')
+        return '—';
+    return String(value).replace(/\|/g, '\\|').replace(/\r?\n/g, ' ');
+}
+/** "1 day", "2.5 days". */
+export function formatDays(value) {
+    const rounded = Math.round(value * 100) / 100;
+    return `${rounded} ${rounded === 1 ? 'day' : 'days'}`;
+}
+export function formatDateRange(start, end) {
+    if (start && end)
+        return `${start} → ${end}`;
+    return start ?? end ?? '—';
+}
+export function codeList(values) {
+    return values.length ? values.map(value => `\`${value}\``).join(', ') : '—';
+}
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,MAAM,UAAU,aAAa,CAAC,OAAiB,EAAE,IAAgE;IAC/G,MAAM,IAAI,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAC1D,MAAM,OAAO,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrF,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAmD;IAC5E,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IACtE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AACpE,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAC9C,OAAO,GAAG,OAAO,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAyB,EAAE,GAAuB;IAChF,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,GAAG,KAAK,MAAM,GAAG,EAAE,CAAC;IAC7C,OAAO,KAAK,IAAI,GAAG,IAAI,GAAG,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAgB;IACvC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9E,CAAC"}

package/dist/utils/help-search.d.ts

@@ -0,0 +1,25 @@
+import type { HelpArticle } from '../types.js';
+/**
+ * Query words folded to Turkish-insensitive form, stop words dropped and
+ * inflection suffixes stripped ("girilir" → "gir", "hedefi" → "hedef").
+ * Consonant softening is tolerated ("talebi" → "taleb" → "tale" also finds "talep").
+ */
+export declare function helpQueryStems(query: string): string[];
+/**
+ * Title match 10, summary 4, each body occurrence 1 (at most 3 per word), plus
+ * 4 per matched word so articles covering more of the query rank first.
+ * Overview articles carry the module name in their title, so they get a 15%
+ * penalty to let the task article win "how do I…" questions.
+ */
+export declare function scoreHelpArticle(article: HelpArticle, stems: string[]): number;
+export interface HelpSearchOptions {
+    module?: string;
+    role?: string;
+    limit: number;
+}
+export interface HelpSearchHit {
+    article: HelpArticle;
+    score: number;
+}
+export declare function searchHelpArticles(articles: HelpArticle[], query: string, options: HelpSearchOptions): HelpSearchHit[];
+//# sourceMappingURL=help-search.d.ts.map

package/dist/utils/help-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-search.d.ts","sourceRoot":"","sources":["../../src/utils/help-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA0B/C;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBtD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAiB9E;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,iBAAiB,GACzB,aAAa,EAAE,CASjB"}

package/dist/utils/help-search.js

@@ -0,0 +1,93 @@
+import { normalizeSearchText } from './text.js';
+/**
+ * Help-center search, ported from the API's `HowToMcpCatalog` so the hosted
+ * and local servers rank articles the same way.
+ */
+/** Question words that only blur the search. Already in normalized form. */
+const STOP_WORDS = new Set([
+    'nasil', 'ne', 'neden', 'nerede', 'hangi', 'bir', 've', 'ile', 'mi', 'mu', 'icin', 'bu', 'su', 'da', 'de',
+    'ben', 'benim', 'yapilir', 'yaparim', 'how', 'do', 'i', 'to', 'the', 'a', 'an', 'can', 'my', 'what',
+    'where', 'is', 'of', 'in',
+]);
+/** Normalized Turkish suffixes, longest first; at least three letters of stem remain. */
+const SUFFIXES = [
+    'lerinin', 'larinin', 'lerini', 'larini', 'leri', 'lari', 'ilir', 'ulur', 'ilen', 'ulan', 'mesi', 'masi',
+    'ler', 'lar', 'mek', 'mak', 'nin', 'nun', 'den', 'dan', 'ten', 'tan', 'dir', 'dur', 'in', 'un', 'si', 'su',
+    'de', 'da', 'te', 'ta', 'ye', 'ya', 'ir', 'ur', 'ar', 'er', 'me', 'ma', 'im', 'um', 'iz', 'uz', 'e', 'a',
+    'i', 'u',
+];
+const MAX_SUFFIX_PASSES = 3;
+const OVERVIEW_PENALTY = 0.85;
+/**
+ * Query words folded to Turkish-insensitive form, stop words dropped and
+ * inflection suffixes stripped ("girilir" → "gir", "hedefi" → "hedef").
+ * Consonant softening is tolerated ("talebi" → "taleb" → "tale" also finds "talep").
+ */
+export function helpQueryStems(query) {
+    const stems = [];
+    for (const word of normalizeSearchText(query).split(/[^\p{L}\p{N}]+/u)) {
+        if (word.length < 2 || STOP_WORDS.has(word))
+            continue;
+        let stem = word;
+        // Suffixes stack ("dönemini" = dönem+in+i), so strip up to three times.
+        for (let pass = 0; pass < MAX_SUFFIX_PASSES; pass++) {
+            const before = stem;
+            const suffix = SUFFIXES.find(candidate => stem.endsWith(candidate)
+                && stem.length - candidate.length >= 3);
+            if (suffix)
+                stem = stem.slice(0, stem.length - suffix.length);
+            if (stem === before)
+                break;
+        }
+        if (stem.length >= 4 && 'bcdg'.includes(stem[stem.length - 1]) && stem !== word) {
+            stem = stem.slice(0, -1);
+        }
+        stems.push(stem);
+    }
+    return stems;
+}
+/**
+ * Title match 10, summary 4, each body occurrence 1 (at most 3 per word), plus
+ * 4 per matched word so articles covering more of the query rank first.
+ * Overview articles carry the module name in their title, so they get a 15%
+ * penalty to let the task article win "how do I…" questions.
+ */
+export function scoreHelpArticle(article, stems) {
+    if (stems.length === 0)
+        return 0;
+    const title = normalizeSearchText(article.title);
+    const summary = normalizeSearchText(article.summary);
+    const body = normalizeSearchText(article.body);
+    let total = 0;
+    let matchedWords = 0;
+    for (const stem of stems) {
+        const score = (title.includes(stem) ? 10 : 0)
+            + (summary.includes(stem) ? 4 : 0)
+            + Math.min(3, occurrences(body, stem));
+        if (score > 0)
+            matchedWords++;
+        total += score;
+    }
+    if (total === 0)
+        return 0;
+    const score = total + matchedWords * 4;
+    return article.id.endsWith('.overview') ? Math.floor(score * OVERVIEW_PENALTY) : score;
+}
+export function searchHelpArticles(articles, query, options) {
+    const stems = helpQueryStems(query);
+    return articles
+        .filter(article => !options.module || article.dir === options.module)
+        .filter(article => !options.role || (article.roles ?? []).includes(options.role))
+        .map(article => ({ article, score: scoreHelpArticle(article, stems) }))
+        .filter(hit => hit.score > 0)
+        .sort((a, b) => b.score - a.score || (a.article.order ?? 0) - (b.article.order ?? 0))
+        .slice(0, options.limit);
+}
+function occurrences(haystack, needle) {
+    let count = 0;
+    for (let index = haystack.indexOf(needle); index >= 0; index = haystack.indexOf(needle, index + needle.length)) {
+        count++;
+    }
+    return count;
+}
+//# sourceMappingURL=help-search.js.map

package/dist/utils/help-search.js.map

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

package/dist/utils/json-schema-dialect.d.ts

@@ -0,0 +1,12 @@
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+/**
+ * MCP SDK 1.30 still advertises Zod tool schemas as JSON Schema draft-07.
+ * Claude and other 2020-12-only clients reject those tools before dispatch.
+ * Rewrite the tools/list payload at the transport boundary instead of
+ * depending on an SDK target option that is not currently passed through.
+ */
+export declare const JSON_SCHEMA_2020_12 = "https://json-schema.org/draft/2020-12/schema";
+export declare function toJsonSchema2020_12<T>(schema: T): T;
+export declare function normalizeOutgoingMessage(message: unknown): unknown;
+export declare function withJsonSchema2020_12<T extends Transport>(transport: T): T;
+//# sourceMappingURL=json-schema-dialect.d.ts.map

package/dist/utils/json-schema-dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-dialect.d.ts","sourceRoot":"","sources":["../../src/utils/json-schema-dialect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE/E;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,iDAAiD,CAAC;AAgHlF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAMnD;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAmBlE;AAED,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,SAAS,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAK1E"}

package/dist/utils/json-schema-dialect.js

@@ -0,0 +1,146 @@
+/**
+ * MCP SDK 1.30 still advertises Zod tool schemas as JSON Schema draft-07.
+ * Claude and other 2020-12-only clients reject those tools before dispatch.
+ * Rewrite the tools/list payload at the transport boundary instead of
+ * depending on an SDK target option that is not currently passed through.
+ */
+export const JSON_SCHEMA_2020_12 = 'https://json-schema.org/draft/2020-12/schema';
+const DEFINITIONS_REF_PREFIX = '#/definitions/';
+const SCHEMA_MAP_KEYWORDS = new Set([
+    'properties',
+    'patternProperties',
+    '$defs',
+    'dependentSchemas',
+]);
+const DATA_KEYWORDS = new Set([
+    'enum',
+    'const',
+    'default',
+    'examples',
+    'required',
+    'dependentRequired',
+]);
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function convertSchemaMap(node) {
+    if (!isPlainObject(node))
+        return node;
+    const out = {};
+    for (const [name, subschema] of Object.entries(node)) {
+        out[name] = convertNode(subschema);
+    }
+    return out;
+}
+function convertNode(node) {
+    if (Array.isArray(node))
+        return node.map(convertNode);
+    if (!isPlainObject(node))
+        return node;
+    const hasTupleItems = Array.isArray(node.items);
+    const out = {};
+    for (const [key, value] of Object.entries(node)) {
+        switch (key) {
+            case '$schema':
+                break;
+            case 'definitions':
+                out.$defs = convertSchemaMap(value);
+                break;
+            case '$ref':
+                out.$ref = typeof value === 'string' && value.startsWith(DEFINITIONS_REF_PREFIX)
+                    ? `#/$defs/${value.slice(DEFINITIONS_REF_PREFIX.length)}`
+                    : value;
+                break;
+            case 'items':
+                if (hasTupleItems)
+                    out.prefixItems = value.map(convertNode);
+                else
+                    out.items = convertNode(value);
+                break;
+            case 'additionalItems':
+                if (hasTupleItems)
+                    out.items = convertNode(value);
+                break;
+            case 'dependencies': {
+                const dependentRequired = {};
+                const dependentSchemas = {};
+                if (isPlainObject(value)) {
+                    for (const [property, dependency] of Object.entries(value)) {
+                        if (Array.isArray(dependency))
+                            dependentRequired[property] = dependency;
+                        else
+                            dependentSchemas[property] = convertNode(dependency);
+                    }
+                }
+                if (Object.keys(dependentRequired).length > 0) {
+                    out.dependentRequired = dependentRequired;
+                }
+                if (Object.keys(dependentSchemas).length > 0) {
+                    out.dependentSchemas = dependentSchemas;
+                }
+                break;
+            }
+            case 'exclusiveMinimum':
+            case 'exclusiveMaximum': {
+                const bound = key === 'exclusiveMinimum' ? node.minimum : node.maximum;
+                if (value === true && typeof bound === 'number')
+                    out[key] = bound;
+                else if (value !== false)
+                    out[key] = convertNode(value);
+                break;
+            }
+            case 'minimum':
+                if (node.exclusiveMinimum === true)
+                    break;
+                out.minimum = convertNode(value);
+                break;
+            case 'maximum':
+                if (node.exclusiveMaximum === true)
+                    break;
+                out.maximum = convertNode(value);
+                break;
+            default:
+                if (DATA_KEYWORDS.has(key))
+                    out[key] = value;
+                else if (SCHEMA_MAP_KEYWORDS.has(key))
+                    out[key] = convertSchemaMap(value);
+                else
+                    out[key] = convertNode(value);
+        }
+    }
+    return out;
+}
+export function toJsonSchema2020_12(schema) {
+    if (!isPlainObject(schema))
+        return schema;
+    return {
+        $schema: JSON_SCHEMA_2020_12,
+        ...convertNode(schema),
+    };
+}
+export function normalizeOutgoingMessage(message) {
+    if (!isPlainObject(message))
+        return message;
+    const result = message.result;
+    if (!isPlainObject(result) || !Array.isArray(result.tools))
+        return message;
+    const tools = result.tools.map(tool => {
+        if (!isPlainObject(tool))
+            return tool;
+        const next = { ...tool };
+        if (isPlainObject(tool.inputSchema)) {
+            next.inputSchema = toJsonSchema2020_12(tool.inputSchema);
+        }
+        if (isPlainObject(tool.outputSchema)) {
+            next.outputSchema = toJsonSchema2020_12(tool.outputSchema);
+        }
+        return next;
+    });
+    return { ...message, result: { ...result, tools } };
+}
+export function withJsonSchema2020_12(transport) {
+    const originalSend = transport.send.bind(transport);
+    transport.send = (message, options) => originalSend(normalizeOutgoingMessage(message), options);
+    return transport;
+}
+//# sourceMappingURL=json-schema-dialect.js.map

package/dist/utils/json-schema-dialect.js.map

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

package/dist/utils/results.d.ts

@@ -0,0 +1,27 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const ACCESS_TOKEN_URL = "https://teamso.com/dashboard/mcp-access";
+/** Invalid tool input or a business rule the user has to fix; its message is shown as-is. */
+export declare class ToolInputError extends Error {
+    constructor(message: string);
+}
+export interface NextAction {
+    tool: string;
+    arguments: Record<string, unknown>;
+    reason: string;
+}
+/** Successful tool result: concise Markdown for the reader, typed data for chaining. */
+export declare function toolResult(text: string, structuredContent: Record<string, unknown>): CallToolResult;
+/** Failed tool result (`isError: true`) with an actionable explanation. */
+export declare function errorResult(message: string): CallToolResult;
+export interface ApiErrorHints {
+    /** Text per `message_code` or API `message` (e.g. `OTP_NOT_DONE`, `NOT_AUTHORIZED_TO_APPROVE`). */
+    byCode?: Record<string, string>;
+    /** What the caller needs when the API answers 403 `ACCESS_DENIED`. */
+    forbidden?: string;
+    /** Text for a missing record (`ITEM_NOT_FOUND`, `USER_NOT_FOUND`, HTTP 404). */
+    notFound?: string;
+}
+/** Turns any failure into an `isError` result that tells the assistant what to do next. */
+export declare function apiErrorResult(error: unknown, hints?: ApiErrorHints): CallToolResult;
+export declare function describeError(error: unknown, hints?: ApiErrorHints): string;
+//# sourceMappingURL=results.d.ts.map

package/dist/utils/results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../src/utils/results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,eAAO,MAAM,gBAAgB,4CAA4C,CAAC;AAE1E,6FAA6F;AAC7F,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAKnG;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAK3D;AAED,MAAM,WAAW,aAAa;IAC5B,mGAAmG;IACnG,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,GAAE,aAAkB,GAAG,cAAc,CAExF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,GAAE,aAAkB,GAAG,MAAM,CAoD/E"}

package/dist/utils/results.js

@@ -0,0 +1,88 @@
+import { TeamsoApiError } from '../client.js';
+export const ACCESS_TOKEN_URL = 'https://teamso.com/dashboard/mcp-access';
+/** Invalid tool input or a business rule the user has to fix; its message is shown as-is. */
+export class ToolInputError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ToolInputError';
+    }
+}
+/** Successful tool result: concise Markdown for the reader, typed data for chaining. */
+export function toolResult(text, structuredContent) {
+    return {
+        content: [{ type: 'text', text }],
+        structuredContent,
+    };
+}
+/** Failed tool result (`isError: true`) with an actionable explanation. */
+export function errorResult(message) {
+    return {
+        content: [{ type: 'text', text: `## Error\n\n${message}` }],
+        isError: true,
+    };
+}
+/** Turns any failure into an `isError` result that tells the assistant what to do next. */
+export function apiErrorResult(error, hints = {}) {
+    return errorResult(describeError(error, hints));
+}
+export function describeError(error, hints = {}) {
+    if (error instanceof ToolInputError)
+        return error.message;
+    if (!(error instanceof TeamsoApiError)) {
+        if (error instanceof Error && (error.name === 'TimeoutError' || error.name === 'AbortError')) {
+            return 'The request to Teamso timed out or was cancelled. Try again in a moment.';
+        }
+        return error instanceof Error ? error.message : String(error);
+    }
+    const codes = [error.apiMessage, error.messageCode].filter((code) => Boolean(code));
+    for (const code of codes) {
+        const hint = hints.byCode?.[code];
+        if (hint)
+            return `${hint}\n\n${errorReference(error)}`;
+    }
+    if (error.status === 401) {
+        return 'Teamso rejected the access token (it is invalid, expired, revoked, or its owner is inactive). '
+            + `Create a new personal access token at ${ACCESS_TOKEN_URL} and update \`TEAMSO_ACCESS_TOKEN\`.\n\n`
+            + errorReference(error);
+    }
+    if (error.status === 403 && error.messageCode === 'IP_NOT_ALLOWED') {
+        return 'Your company only allows Teamso access from approved IP addresses, and this request came from '
+            + 'an address outside that list. Ask your Teamso administrator to allow it.\n\n'
+            + errorReference(error);
+    }
+    if (error.status === 403 || error.messageCode === 'PERMISSION_DENIED') {
+        const need = hints.forbidden ? ` ${hints.forbidden}` : '';
+        return `Your Teamso account is not allowed to do this.${need} `
+            + 'Ask your Teamso administrator if you need access.\n\n'
+            + errorReference(error);
+    }
+    if (error.status === 404 || error.messageCode === 'ITEM_NOT_FOUND' || error.messageCode === 'USER_NOT_FOUND') {
+        const text = hints.notFound ?? 'Teamso could not find that record, or it is not visible to you.';
+        return `${text}\n\n${errorReference(error)}`;
+    }
+    if (error.status === 429) {
+        return 'Too many requests to Teamso. Wait a minute and try again.\n\n' + errorReference(error);
+    }
+    if (error.status >= 500) {
+        return 'Teamso could not complete the request because of a server error. Try again later.\n\n'
+            + errorReference(error);
+    }
+    if (error.messageCode === 'CREDIT_INSUFFICIENT') {
+        return 'Your company does not have enough digital (SMS) credit for this step. '
+            + 'Ask your Teamso administrator to top up credits.\n\n'
+            + errorReference(error);
+    }
+    const detail = typeof error.result === 'string' && error.result !== error.apiMessage
+        ? ` (${error.result})`
+        : '';
+    return `${error.apiMessage ?? 'The request failed.'}${detail}\n\n${errorReference(error)}`;
+}
+function errorReference(error) {
+    const parts = [`HTTP ${error.status}`];
+    if (error.messageCode)
+        parts.push(`\`${error.messageCode}\``);
+    if (error.apiMessage && error.apiMessage !== error.messageCode)
+        parts.push(error.apiMessage);
+    return `_Teamso API: ${parts.join(' · ')}_`;
+}
+//# sourceMappingURL=results.js.map

package/dist/utils/results.js.map

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