@wootsup/yt-builder-mcp 1.11.0 → 2.0.0

package/dist/tools/skill/builders.js

@@ -0,0 +1,81 @@
+import { honestTableResult } from '../budgeted-table.js';
+import { z } from 'zod';
+import { getTopicContent, listTopics } from '../../skill-topics.js';
+import { SITE_ID_SCHEMA } from '../shared-schemas.js';
+import { defineTool, readOnly, structuredResult, } from '../tool-builder.js';
+import { unknownNameResult } from '../../sites/unknown-name-result.js';
+const TOPIC_TABLE_COLUMNS = [
+    { key: 'slug', label: 'SLUG', width: 52 },
+    { key: 'bytes', label: 'BYTES', width: 8 },
+    { key: 'heading', label: 'HEADING', width: 48 },
+];
+const TOPIC_OMITTED_FIELDS = ['parts', 'oversized_note'];
+export function buildSkillTools() {
+    return [
+        defineTool({
+            name: 'yootheme_builder_get_skill',
+            description: 'Read a chapter of the full workflow guide. Without `topic`: the list of ' +
+                'available topics, each with the SIZE of what it returns. With `topic`: that ' +
+                'chapter. The connect-time `instructions` carry only a short preamble — this ' +
+                'is how you reach the rest. ' +
+                'A long chapter is served in PARTS: its row lists their slugs, and asking for ' +
+                'the parent returns the chapter intro plus that list. A row carrying ' +
+                '`oversized_note` is served whole and is large — read the note before asking ' +
+                'for it.',
+            inputSchema: {
+                site_id: SITE_ID_SCHEMA,
+                topic: z
+                    .string()
+                    .min(1)
+                    .max(64)
+                    .optional()
+                    .describe('Topic slug from the topic list (e.g. "gateway-routing"). Omit to list ' +
+                    'every available topic.'),
+            },
+            annotations: readOnly('Skill Guide'),
+            handler: async ({ topic }) => {
+                if (topic === undefined) {
+                    const topics = listTopics();
+                    const tableRows = topics.map((t) => ({
+                        slug: t.slug,
+                        bytes: t.bytes,
+                        heading: t.heading,
+                    }));
+                    const toolkitResult = honestTableResult(tableRows, {
+                        columns: TOPIC_TABLE_COLUMNS,
+                        omittedFields: TOPIC_OMITTED_FIELDS,
+                        header: (count) => `${String(count)} skill topics`,
+                        footer: 'Call again with { topic: "<slug>" } for that chapter. A row with '
+                            + '`parts` is served in pieces — ask for a part.',
+                    });
+                    return structuredResult(toolkitResult, {
+                        topics: topics.map((t) => ({
+                            slug: t.slug,
+                            heading: t.heading,
+                            bytes: t.bytes,
+                            ...(t.parts !== undefined ? { parts: t.parts } : {}),
+                            ...(t.oversized_note !== undefined ? { oversized_note: t.oversized_note } : {}),
+                        })),
+                        hint: 'Call again with { topic: "<slug>" } for that chapter. A row with '
+                            + '`parts` is served in pieces — ask for a part, not the parent, unless '
+                            + 'you want the intro plus the map.',
+                    });
+                }
+                const content = getTopicContent(topic);
+                if (content === undefined) {
+                    return unknownNameResult({
+                        argument: 'topic',
+                        value: topic,
+                        available: listTopics().map((t) => t.slug),
+                        code: 'unknown_topic',
+                        error: `Unknown topic "${topic}".`,
+                        hint: 'Call yootheme_builder_get_skill with no arguments to see every ' +
+                            'available topic slug.',
+                    });
+                }
+                return { content: [{ type: 'text', text: content }] };
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=builders.js.map

package/dist/tools/skill/builders.js.map

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

package/dist/tools/sources/builders.d.ts

@@ -1,13 +1,3 @@
-/**
- * Source-tool builders — pure `defineTool` factory list.
- *
- * Split out of `src/tools/sources.ts` (Wave G.4.0b). See `./handlers.ts`
- * for the handler bodies.
- *
- * @license MIT
- */
-import type { ClientPool } from '../../sites/client-pool.js';
 import { type AnyToolDefinition } from '../tool-builder.js';
-import { type SourcesHandlerDeps } from './handlers.js';
-export declare function buildSourcesTools(pool: ClientPool, deps?: Partial<SourcesHandlerDeps>): readonly AnyToolDefinition[];
+export declare function buildSourcesTools(): readonly AnyToolDefinition[];
 //# sourceMappingURL=builders.d.ts.map

package/dist/tools/sources/builders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/sources/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,EAMH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAIH,KAAK,kBAAkB,EAM1B,MAAM,eAAe,CAAC;AAQvB,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,SAAS,iBAAiB,EAAE,CAiiB9B"}
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/sources/builders.ts"],"names":[],"mappings":"AAgBA,OAAO,EAKH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAC;AAkB5B,wBAAgB,iBAAiB,IAAI,SAAS,iBAAiB,EAAE,CA+pBhE"}