@asnd/skill-creator 0.1.2 → 0.1.3

package/dist/core/types.d.ts

@@ -0,0 +1,37 @@
+export type JsonSchema = {
+    type?: string;
+    format?: string;
+    description?: string;
+    enum?: unknown[];
+    items?: JsonSchema;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    [key: string]: unknown;
+};
+export type CliValueType = 'string' | 'integer' | 'number' | 'boolean';
+export type ParamLocation = 'path' | 'query' | 'header' | 'body' | 'file' | 'tool_input' | 'graphql_arg';
+export type ParamDef = {
+    /** kebab-case CLI flag name */
+    name: string;
+    /** original API/tool argument name */
+    originalName: string;
+    type: CliValueType;
+    required?: boolean;
+    description?: string;
+    choices?: unknown[];
+    location?: ParamLocation;
+    schema?: JsonSchema;
+};
+export type CommandDef = {
+    name: string;
+    description?: string;
+    params: ParamDef[];
+    hasBody?: boolean;
+    method?: string;
+    path?: string;
+    contentType?: string;
+    toolName?: string;
+    graphqlOperationType?: 'query' | 'mutation';
+    graphqlFieldName?: string;
+    graphqlReturnType?: unknown;
+};

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/core/usage.d.ts

@@ -0,0 +1,13 @@
+export type UsageEntry = {
+    count: number;
+    lastUsed: string;
+};
+export type UsageData = Record<string, Record<string, UsageEntry>>;
+export declare function sourceHashFor(source: string): string;
+export declare class UsageStore {
+    private readonly filePath;
+    constructor(filePath: string);
+    load(): Promise<UsageData>;
+    save(data: UsageData): Promise<void>;
+    record(sourceHash: string, toolName: string, now?: Date): Promise<void>;
+}

package/dist/core/usage.js

@@ -0,0 +1,33 @@
+import { createHash } from 'node:crypto';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+export function sourceHashFor(source) {
+    return createHash('sha256').update(source).digest('hex').slice(0, 16);
+}
+export class UsageStore {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    async load() {
+        try {
+            return JSON.parse(await readFile(this.filePath, 'utf8'));
+        }
+        catch {
+            return {};
+        }
+    }
+    async save(data) {
+        await mkdir(dirname(this.filePath), { recursive: true });
+        await writeFile(this.filePath, `${JSON.stringify(data, null, 2)}\n`);
+    }
+    async record(sourceHash, toolName, now = new Date()) {
+        const usage = await this.load();
+        usage[sourceHash] ??= {};
+        usage[sourceHash][toolName] ??= { count: 0, lastUsed: '' };
+        usage[sourceHash][toolName].count += 1;
+        usage[sourceHash][toolName].lastUsed = now.toISOString();
+        await this.save(usage);
+    }
+}
+//# sourceMappingURL=usage.js.map

package/dist/core/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/core/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,OAAO,UAAU;IACQ,QAAQ;IAArC,YAA6B,QAAgB;wBAAhB,QAAQ;IAAW,CAAC;IAEjD,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAc,CAAC;QACxE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAe;QACxB,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,QAAgB,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE;QACjE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QAC3D,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACvC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACzD,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;CACF"}

package/dist/graphql/execute.d.ts

@@ -0,0 +1,8 @@
+import type { CommandDef } from '../core/types.js';
+export type ExecuteGraphqlOptions = {
+    endpoint: string;
+    authHeaders?: Array<[string, string]>;
+    fields?: string;
+    selectionDepth?: number;
+};
+export declare function executeGraphql(command: CommandDef, values: Record<string, unknown>, options: ExecuteGraphqlOptions): Promise<unknown>;

package/dist/graphql/execute.js

@@ -0,0 +1,133 @@
+import { Kind, OperationTypeNode, parse, print, } from 'graphql';
+import { ClientError, GraphQLClient } from 'graphql-request';
+import { coerceAndValidateValue } from '../core/coerce.js';
+import { buildGraphqlSelectionSet } from './extract.js';
+export async function executeGraphql(command, values, options) {
+    const fieldName = command.graphqlFieldName ?? command.name;
+    const variables = collectVariables(command, values);
+    const query = buildGraphqlOperation(command, fieldName, variables, options.fields, options.selectionDepth ?? 2);
+    const client = new GraphQLClient(options.endpoint, {
+        headers: Object.fromEntries(options.authHeaders ?? []),
+    });
+    try {
+        const data = await client.request(query, variables);
+        if (!isRecord(data))
+            return data;
+        return data[fieldName];
+    }
+    catch (error) {
+        throw normalizeGraphqlRequestError(error);
+    }
+}
+function collectVariables(command, values) {
+    const variables = {};
+    for (const param of command.params) {
+        const value = values[param.name] ?? values[param.originalName];
+        if (value !== undefined) {
+            variables[param.originalName] = coerceAndValidateValue(value, param.schema ?? {}, `--${param.name}`);
+        }
+    }
+    return variables;
+}
+function buildGraphqlOperation(command, fieldName, variables, fields, selectionDepth) {
+    const activeParams = command.params.filter((param) => param.required || variables[param.originalName] !== undefined);
+    const variableDefinitions = activeParams.map((param) => ({
+        kind: Kind.VARIABLE_DEFINITION,
+        variable: {
+            kind: Kind.VARIABLE,
+            name: { kind: Kind.NAME, value: param.originalName },
+        },
+        type: parseGraphqlType(graphqlParamType(param)),
+    }));
+    const selectionSet = buildSelectionSetNode(command, fields, selectionDepth);
+    const field = {
+        kind: Kind.FIELD,
+        name: { kind: Kind.NAME, value: fieldName },
+        arguments: activeParams.map((param) => ({
+            kind: Kind.ARGUMENT,
+            name: { kind: Kind.NAME, value: param.originalName },
+            value: {
+                kind: Kind.VARIABLE,
+                name: { kind: Kind.NAME, value: param.originalName },
+            },
+        })),
+        ...(selectionSet === undefined ? {} : { selectionSet }),
+    };
+    const operation = {
+        kind: Kind.OPERATION_DEFINITION,
+        operation: command.graphqlOperationType === 'mutation'
+            ? OperationTypeNode.MUTATION
+            : OperationTypeNode.QUERY,
+        name: { kind: Kind.NAME, value: commandName(command) },
+        ...(variableDefinitions.length === 0 ? {} : { variableDefinitions }),
+        selectionSet: { kind: Kind.SELECTION_SET, selections: [field] },
+    };
+    const document = { kind: Kind.DOCUMENT, definitions: [operation] };
+    return print(document);
+}
+function buildSelectionSetNode(command, fields, selectionDepth) {
+    if (command.graphqlReturnType === undefined)
+        return undefined;
+    const selectionSet = buildGraphqlSelectionSet(command.graphqlReturnType, fields, selectionDepth);
+    if (selectionSet.length === 0)
+        return undefined;
+    return parseSelectionSet(selectionSet);
+}
+function parseGraphqlType(type) {
+    const operation = parseSingleOperation(`query __Type($value: ${type}) { __typename }`);
+    const variable = operation.variableDefinitions?.[0];
+    if (variable === undefined)
+        throw new Error(`invalid GraphQL variable type: ${type}`);
+    return variable.type;
+}
+function parseSelectionSet(selectionSet) {
+    const operation = parseSingleOperation(`query __Selection { _selection ${selectionSet} }`);
+    const selection = operation.selectionSet.selections[0];
+    if (selection?.kind !== Kind.FIELD || selection.selectionSet === undefined) {
+        throw new Error('invalid GraphQL selection set');
+    }
+    return selection.selectionSet;
+}
+function parseSingleOperation(source) {
+    const document = parse(source);
+    const definition = document.definitions[0];
+    if (definition?.kind !== Kind.OPERATION_DEFINITION) {
+        throw new Error('failed to build GraphQL operation');
+    }
+    return definition;
+}
+function graphqlParamType(param) {
+    const type = param.schema?.graphqlType;
+    return typeof type === 'string' ? type : jsonSchemaToGraphqlType(param.schema?.type);
+}
+function jsonSchemaToGraphqlType(type) {
+    switch (type) {
+        case 'integer':
+            return 'Int';
+        case 'number':
+            return 'Float';
+        case 'boolean':
+            return 'Boolean';
+        default:
+            return 'String';
+    }
+}
+function commandName(command) {
+    return `${command.graphqlOperationType ?? 'query'}_${command.graphqlFieldName ?? command.name}`.replace(/[^_0-9A-Za-z]/g, '_');
+}
+function normalizeGraphqlRequestError(error) {
+    if (error instanceof ClientError) {
+        if (error.response.errors !== undefined && error.response.errors.length > 0) {
+            return new Error(`GraphQL error: ${formatGraphqlErrors(error.response.errors)}`);
+        }
+        return new Error(`GraphQL HTTP ${error.response.status}: ${JSON.stringify(error.response, null, 0)}`);
+    }
+    return error instanceof Error ? error : new Error(String(error));
+}
+function formatGraphqlErrors(errors) {
+    return errors.map((error) => error.message ?? 'unknown error').join('; ');
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=execute.js.map

package/dist/graphql/execute.js.map

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

package/dist/graphql/extract.d.ts

@@ -0,0 +1,6 @@
+import { type GraphQLInputType, type GraphQLOutputType, type GraphQLSchema, type GraphQLType } from 'graphql';
+import type { CommandDef, JsonSchema } from '../core/types.js';
+export declare function extractGraphqlCommands(schema: GraphQLSchema): CommandDef[];
+export declare function buildGraphqlSelectionSet(type: GraphQLOutputType, fields?: string, depth?: number): string;
+export declare function graphqlInputTypeToJsonSchema(type: GraphQLInputType): JsonSchema;
+export declare function graphqlTypeToString(type: GraphQLType): string;

package/dist/graphql/extract.js

@@ -0,0 +1,109 @@
+import { getNamedType, isEnumType, isInputObjectType, isInterfaceType, isListType, isNonNullType, isObjectType, isScalarType, } from 'graphql';
+import { schemaTypeToCliType } from '../core/coerce.js';
+import { toKebab } from '../core/names.js';
+export function extractGraphqlCommands(schema) {
+    const commands = [];
+    addRootFields(commands, schema.getQueryType()?.getFields(), 'query');
+    addRootFields(commands, schema.getMutationType()?.getFields(), 'mutation');
+    return commands;
+}
+export function buildGraphqlSelectionSet(type, fields, depth = 2) {
+    if (fields !== undefined && fields.trim().length > 0)
+        return `{ ${fields.trim()} }`;
+    return buildDefaultSelectionSet(type, depth, new Set());
+}
+function addRootFields(commands, fields, operationType) {
+    if (fields === undefined)
+        return;
+    for (const field of Object.values(fields)) {
+        const description = optionalString(field.description);
+        commands.push({
+            name: toKebab(field.name),
+            ...(description === undefined ? {} : { description }),
+            params: field.args.map((arg) => graphqlArgToParam(arg.name, arg.type, optionalString(arg.description))),
+            graphqlOperationType: operationType,
+            graphqlFieldName: field.name,
+            graphqlReturnType: field.type,
+        });
+    }
+}
+function graphqlArgToParam(name, type, description) {
+    const schema = graphqlInputTypeToJsonSchema(type);
+    const cliType = schemaTypeToCliType(schema).type;
+    return {
+        name: toKebab(name),
+        originalName: name,
+        type: cliType,
+        required: isNonNullType(type),
+        ...(description === undefined ? {} : { description }),
+        location: 'graphql_arg',
+        schema,
+    };
+}
+export function graphqlInputTypeToJsonSchema(type) {
+    if (isNonNullType(type)) {
+        return { ...graphqlInputTypeToJsonSchema(type.ofType), graphqlType: graphqlTypeToString(type) };
+    }
+    if (isListType(type)) {
+        return {
+            type: 'array',
+            items: graphqlInputTypeToJsonSchema(type.ofType),
+            graphqlType: graphqlTypeToString(type),
+        };
+    }
+    const namedType = getNamedType(type);
+    const base = { graphqlType: graphqlTypeToString(type) };
+    if (isEnumType(namedType)) {
+        return { ...base, type: 'string', enum: namedType.getValues().map((value) => value.name) };
+    }
+    if (isInputObjectType(namedType))
+        return { ...base, type: 'object' };
+    if (isScalarType(namedType)) {
+        switch (namedType.name) {
+            case 'Int':
+                return { ...base, type: 'integer' };
+            case 'Float':
+                return { ...base, type: 'number' };
+            case 'Boolean':
+                return { ...base, type: 'boolean' };
+            default:
+                return { ...base, type: 'string' };
+        }
+    }
+    return { ...base, type: 'string' };
+}
+export function graphqlTypeToString(type) {
+    if (isNonNullType(type))
+        return `${graphqlTypeToString(type.ofType)}!`;
+    if (isListType(type))
+        return `[${graphqlTypeToString(type.ofType)}]`;
+    return getNamedType(type).name;
+}
+function optionalString(value) {
+    return value ?? undefined;
+}
+function buildDefaultSelectionSet(type, depth, seenTypes) {
+    const namedType = getNamedType(type);
+    if (isScalarType(namedType) || isEnumType(namedType))
+        return '';
+    if (depth <= 0)
+        return '';
+    if (!isObjectType(namedType) && !isInterfaceType(namedType))
+        return '{ __typename }';
+    if (seenTypes.has(namedType.name))
+        return '';
+    const nextSeen = new Set(seenTypes);
+    nextSeen.add(namedType.name);
+    const selections = Object.values(namedType.getFields())
+        .filter((field) => field.args.length === 0)
+        .map((field) => {
+        const fieldNamedType = getNamedType(field.type);
+        if (isScalarType(fieldNamedType) || isEnumType(fieldNamedType))
+            return field.name;
+        const nested = buildDefaultSelectionSet(field.type, depth - 1, nextSeen);
+        return nested ? `${field.name} ${nested}` : '';
+    })
+        .filter((field) => field.length > 0);
+    return selections.length === 0 ? '' : `{ ${selections.join(' ')} }`;
+}
+//# sourceMappingURL=extract.js.map

package/dist/graphql/extract.js.map

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

package/dist/graphql/load.d.ts

@@ -0,0 +1,11 @@
+import { type GraphQLSchema } from 'graphql';
+export type LoadGraphqlOptions = {
+    authHeaders?: Array<[string, string]>;
+    cacheDir?: string;
+    cacheKey?: string;
+    ttlSeconds?: number;
+    refresh?: boolean;
+    schemaSource?: string;
+    onWarning?: (message: string) => void;
+};
+export declare function loadGraphqlSchema(endpoint: string, options?: LoadGraphqlOptions): Promise<GraphQLSchema>;

package/dist/graphql/load.js

@@ -0,0 +1,95 @@
+import { GraphQLFileLoader } from '@graphql-tools/graphql-file-loader';
+import { JsonFileLoader } from '@graphql-tools/json-file-loader';
+import { loadSchema } from '@graphql-tools/load';
+import { UrlLoader } from '@graphql-tools/url-loader';
+import { buildClientSchema, buildSchema, getIntrospectionQuery, introspectionFromSchema, } from 'graphql';
+import { GraphQLClient } from 'graphql-request';
+import ky from 'ky';
+import { readFile } from 'node:fs/promises';
+import { cacheKeyFor, loadCached, saveCache } from '../core/cache.js';
+export async function loadGraphqlSchema(endpoint, options = {}) {
+    const authHeaders = options.authHeaders ?? [];
+    if (options.schemaSource !== undefined) {
+        return loadProvidedGraphqlSchema(options.schemaSource, authHeaders);
+    }
+    const cacheKey = `graphql-${options.cacheKey ?? cacheKeyFor({ endpoint, authHeaders: options.authHeaders ?? [] })}`;
+    const ttlSeconds = options.ttlSeconds ?? 3600;
+    if (options.cacheDir !== undefined && !options.refresh) {
+        const cached = await loadCached(options.cacheDir, cacheKey, ttlSeconds);
+        if (cached !== null)
+            return buildClientSchema(cached);
+    }
+    try {
+        const schema = await loadRemoteGraphqlSchema(endpoint, authHeaders);
+        if (options.cacheDir !== undefined) {
+            await saveCache(options.cacheDir, cacheKey, introspectionFromSchema(schema));
+        }
+        return schema;
+    }
+    catch (error) {
+        if (options.cacheDir !== undefined) {
+            const stale = await loadCached(options.cacheDir, cacheKey, Number.POSITIVE_INFINITY);
+            if (stale !== null) {
+                options.onWarning?.(`Warning: using stale cached GraphQL schema because introspection failed: ${formatError(error)}`);
+                return buildClientSchema(stale);
+            }
+        }
+        throw new Error(`GraphQL introspection is disabled or unavailable. Provide a schema with --graphql-schema ./schema.graphql or --graphql-schema ./introspection.json. (${formatError(error)})`);
+    }
+}
+async function loadRemoteGraphqlSchema(endpoint, authHeaders) {
+    const client = new GraphQLClient(endpoint, {
+        headers: Object.fromEntries(authHeaders),
+    });
+    const introspection = await client.request(getIntrospectionQuery());
+    return buildClientSchema(introspection);
+}
+async function loadProvidedGraphqlSchema(source, authHeaders) {
+    try {
+        const schema = await loadSchema(source, {
+            loaders: [new UrlLoader(), new GraphQLFileLoader(), new JsonFileLoader()],
+            headers: Object.fromEntries(authHeaders),
+        });
+        return buildClientSchema(introspectionFromSchema(schema));
+    }
+    catch {
+        return loadProvidedGraphqlSchemaFallback(source, authHeaders);
+    }
+}
+async function loadProvidedGraphqlSchemaFallback(source, authHeaders) {
+    const text = await readSchemaSource(source, authHeaders);
+    const trimmed = text.trim();
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        const parsed = JSON.parse(trimmed);
+        return buildClientSchema(extractIntrospection(parsed));
+    }
+    return buildSchema(text);
+}
+async function readSchemaSource(source, authHeaders) {
+    if (source.startsWith('http://') || source.startsWith('https://')) {
+        const response = await ky.get(source, {
+            headers: Object.fromEntries(authHeaders),
+            throwHttpErrors: false,
+        });
+        if (!response.ok)
+            throw new Error(`failed to fetch GraphQL schema: HTTP ${response.status}`);
+        return response.text();
+    }
+    return readFile(source, 'utf8');
+}
+function extractIntrospection(value) {
+    if (!isRecord(value))
+        throw new Error('GraphQL schema JSON must be an object');
+    if (isRecord(value.data))
+        return extractIntrospection(value.data);
+    if (isRecord(value.__schema))
+        return value;
+    throw new Error('GraphQL schema JSON must contain an introspection __schema object');
+}
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=load.js.map

package/dist/graphql/load.js.map

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

package/dist/mcp/extract.d.ts

@@ -0,0 +1,8 @@
+import type { CommandDef } from '../core/types.js';
+type McpToolLike = {
+    name: string;
+    description?: string;
+    inputSchema?: unknown;
+};
+export declare function extractMcpCommands(tools: McpToolLike[]): CommandDef[];
+export {};

package/dist/mcp/extract.js

@@ -0,0 +1,40 @@
+import { schemaTypeToCliType } from '../core/coerce.js';
+import { toKebab } from '../core/names.js';
+export function extractMcpCommands(tools) {
+    return tools.map((tool) => {
+        const schema = isJsonSchema(tool.inputSchema) ? tool.inputSchema : {};
+        const required = new Set(Array.isArray(schema.required) ? schema.required : []);
+        const properties = getProperties(schema);
+        const params = Object.entries(properties).map(([name, propSchema]) => {
+            const { type, suffix } = schemaTypeToCliType(propSchema);
+            const choices = Array.isArray(propSchema.enum) ? { choices: propSchema.enum } : {};
+            return {
+                name: toKebab(name),
+                originalName: name,
+                type,
+                required: required.has(name),
+                description: `${String(propSchema.description ?? name)}${suffix}`,
+                ...choices,
+                location: 'tool_input',
+                schema: propSchema,
+            };
+        });
+        return {
+            name: toKebab(tool.name),
+            description: tool.description ?? '',
+            params,
+            hasBody: params.length > 0,
+            toolName: tool.name,
+        };
+    });
+}
+function getProperties(schema) {
+    const properties = schema.properties;
+    if (typeof properties !== 'object' || properties === null || Array.isArray(properties))
+        return {};
+    return Object.fromEntries(Object.entries(properties).filter((entry) => isJsonSchema(entry[1])));
+}
+function isJsonSchema(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=extract.js.map

package/dist/mcp/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/mcp/extract.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAQ3C,MAAM,UAAU,kBAAkB,CAAC,KAAoB;IACrD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAc,EAAE;QACpC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAChF,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,EAAY,EAAE;YAC7E,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;YACzD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnF,OAAO;gBACL,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC;gBACnB,YAAY,EAAE,IAAI;gBAClB,IAAI;gBACJ,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;gBAC5B,WAAW,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,MAAM,EAAE;gBACjE,GAAG,OAAO;gBACV,QAAQ,EAAE,YAAY;gBACtB,MAAM,EAAE,UAAU;aACnB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YACxB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YACnC,MAAM;YACN,OAAO,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC;YAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI;SACpB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,MAAkB;IACvC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IAClG,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAiC,EAAE,CACzE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACvB,CACF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/mcp/http.d.ts

@@ -0,0 +1,8 @@
+import { type McpTool } from './stdio.js';
+export type McpHttpTransport = 'auto' | 'streamable' | 'sse';
+export type McpHttpOptions = {
+    headers?: Array<[string, string]>;
+    transport?: McpHttpTransport;
+};
+export declare function listHttpTools(url: string, optionsOrHeaders?: McpHttpOptions | Array<[string, string]>): Promise<McpTool[]>;
+export declare function callHttpTool(url: string, toolName: string, args: Record<string, unknown>, optionsOrHeaders?: McpHttpOptions | Array<[string, string]>): Promise<unknown>;

package/dist/mcp/http.js

@@ -0,0 +1,80 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { extractMcpContent } from './stdio.js';
+export async function listHttpTools(url, optionsOrHeaders = {}) {
+    const options = normalizeOptions(optionsOrHeaders);
+    return withHttpClient(url, options, async (client) => {
+        const result = await client.listTools();
+        return result.tools.map((tool) => ({
+            name: tool.name,
+            ...(tool.description === undefined ? {} : { description: tool.description }),
+            inputSchema: tool.inputSchema,
+        }));
+    });
+}
+export async function callHttpTool(url, toolName, args, optionsOrHeaders = {}) {
+    const options = normalizeOptions(optionsOrHeaders);
+    return withHttpClient(url, options, async (client) => {
+        const result = await client.callTool({ name: toolName, arguments: args });
+        return extractMcpContent(result.content);
+    });
+}
+async function withHttpClient(url, options, fn) {
+    if (options.transport === 'auto') {
+        try {
+            return await withSingleHttpClient(url, { ...options, transport: 'streamable' }, fn);
+        }
+        catch (streamableError) {
+            try {
+                return await withSingleHttpClient(url, { ...options, transport: 'sse' }, fn);
+            }
+            catch (sseError) {
+                throw new Error(`failed to connect using streamable HTTP or SSE (${formatError(streamableError)}; ${formatError(sseError)})`);
+            }
+        }
+    }
+    return withSingleHttpClient(url, options, fn);
+}
+async function withSingleHttpClient(url, options, fn) {
+    const client = new Client({ name: 'skill-creator', version: '0.1.0' });
+    const transport = createTransport(url, options);
+    await client.connect(transport);
+    try {
+        return await fn(client);
+    }
+    finally {
+        await client.close();
+    }
+}
+function createTransport(url, options) {
+    const headers = Object.fromEntries(options.headers);
+    if (options.transport === 'sse') {
+        const fetchWithHeaders = (input, init) => fetch(input, { ...init, headers: { ...headers, ...headersToObject(init?.headers) } });
+        return new SSEClientTransport(new URL(url), {
+            eventSourceInit: { fetch: fetchWithHeaders },
+            requestInit: { headers },
+        });
+    }
+    return new StreamableHTTPClientTransport(new URL(url), {
+        requestInit: { headers },
+    });
+}
+function normalizeOptions(optionsOrHeaders) {
+    if (Array.isArray(optionsOrHeaders)) {
+        return { headers: optionsOrHeaders, transport: 'auto' };
+    }
+    return {
+        headers: optionsOrHeaders.headers ?? [],
+        transport: optionsOrHeaders.transport ?? 'auto',
+    };
+}
+function headersToObject(headers) {
+    if (headers === undefined)
+        return {};
+    return Object.fromEntries(new Headers(headers).entries());
+}
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=http.js.map