@asnd/skill-creator 0.1.1 → 0.1.3

package/dist/mcp/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/mcp/http.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAEnG,OAAO,EAAE,iBAAiB,EAAgB,MAAM,YAAY,CAAC;AAS7D,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,gBAAgB,GAA6C,EAAE;IAE/D,MAAM,OAAO,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IACnD,OAAO,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACnD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QACxC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACjC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5E,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAW,EACX,QAAgB,EAChB,IAA6B,EAC7B,gBAAgB,GAA6C,EAAE;IAE/D,MAAM,OAAO,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IACnD,OAAO,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACnD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1E,OAAO,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,GAAW,EACX,OAAiC,EACjC,EAAkC;IAElC,IAAI,OAAO,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,OAAO,MAAM,oBAAoB,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QACtF,CAAC;QAAC,OAAO,eAAe,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,OAAO,MAAM,oBAAoB,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YAC/E,CAAC;YAAC,OAAO,QAAQ,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CACb,mDAAmD,WAAW,CAAC,eAAe,CAAC,KAAK,WAAW,CAAC,QAAQ,CAAC,GAAG,CAC7G,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,GAAW,EACX,OAAiC,EACjC,EAAkC;IAElC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAEhD,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,GAAW,EAAE,OAAiC;IACrE,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,OAAO,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;QAChC,MAAM,gBAAgB,GAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CACrD,KAAK,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACxF,OAAO,IAAI,kBAAkB,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE;YAC1C,eAAe,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE;YAC5C,WAAW,EAAE,EAAE,OAAO,EAAE;SACzB,CAAyB,CAAC;IAC7B,CAAC;IAED,OAAO,IAAI,6BAA6B,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE;QACrD,WAAW,EAAE,EAAE,OAAO,EAAE;KACzB,CAAyB,CAAC;AAC7B,CAAC;AAED,SAAS,gBAAgB,CACvB,gBAA0D;IAE1D,IAAI,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO;QACL,OAAO,EAAE,gBAAgB,CAAC,OAAO,IAAI,EAAE;QACvC,SAAS,EAAE,gBAAgB,CAAC,SAAS,IAAI,MAAM;KAChD,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,OAAgC;IACvD,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/mcp/stdio.d.ts

@@ -0,0 +1,9 @@
+export type McpTool = {
+    name: string;
+    description?: string;
+    inputSchema?: unknown;
+};
+export declare function listStdioTools(commandLine: string): Promise<McpTool[]>;
+export declare function callStdioTool(commandLine: string, toolName: string, args: Record<string, unknown>): Promise<unknown>;
+export declare function splitCommandLine(commandLine: string): string[];
+export declare function extractMcpContent(content: unknown): unknown;

package/dist/mcp/stdio.js

@@ -0,0 +1,67 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import stringArgv from 'string-argv';
+export async function listStdioTools(commandLine) {
+    return withStdioClient(commandLine, 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 callStdioTool(commandLine, toolName, args) {
+    return withStdioClient(commandLine, async (client) => {
+        const result = await client.callTool({ name: toolName, arguments: args });
+        return extractMcpContent(result.content);
+    });
+}
+async function withStdioClient(commandLine, fn) {
+    const [command, ...args] = splitCommandLine(commandLine);
+    if (command === undefined)
+        throw new Error('--mcp-stdio command cannot be empty');
+    const client = new Client({ name: 'skill-creator', version: '0.1.0' });
+    const transport = new StdioClientTransport({ command, args, stderr: 'pipe' });
+    await client.connect(transport);
+    try {
+        return await fn(client);
+    }
+    finally {
+        await client.close();
+    }
+}
+export function splitCommandLine(commandLine) {
+    return stringArgv(commandLine);
+}
+export function extractMcpContent(content) {
+    if (!Array.isArray(content))
+        return content;
+    const parts = content
+        .map((part) => extractContentPart(part))
+        .filter((part) => part !== undefined);
+    if (parts.length === 0)
+        return '';
+    if (parts.every((part) => typeof part === 'string'))
+        return parts.join('\n');
+    return parts;
+}
+function extractContentPart(part) {
+    if (!isObject(part))
+        return undefined;
+    if (part.type === 'text' && typeof part.text === 'string')
+        return part.text;
+    if (typeof part.data === 'string')
+        return part.data;
+    if (part.type === 'resource' && isObject(part.resource)) {
+        if (typeof part.resource.text === 'string')
+            return part.resource.text;
+        if (typeof part.resource.blob === 'string')
+            return part.resource.blob;
+    }
+    return part;
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=stdio.js.map

package/dist/mcp/stdio.js.map

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

package/dist/openapi/execute.d.ts

@@ -0,0 +1,12 @@
+import type { CommandDef } from '../core/types.js';
+export type ExecuteOpenApiOptions = {
+    baseUrl: string;
+    authHeaders?: Array<[string, string]>;
+    stdinBody?: unknown;
+};
+export declare function executeOpenApi(command: CommandDef, values: Record<string, unknown>, options: ExecuteOpenApiOptions): Promise<{
+    status: number;
+    ok: boolean;
+    text: string;
+    contentType: string;
+}>;

package/dist/openapi/execute.js

@@ -0,0 +1,44 @@
+import ky from 'ky';
+import { collectOpenApiParams } from './params.js';
+export async function executeOpenApi(command, values, options) {
+    const collected = collectOpenApiParams(command, values, {
+        stdinBody: options.stdinBody,
+    });
+    const url = buildUrl(options.baseUrl, collected.path, collected.queryParams);
+    const method = (command.method ?? 'get').toUpperCase();
+    const headers = {
+        ...Object.fromEntries(options.authHeaders ?? []),
+        ...collected.headers,
+    };
+    const body = method !== 'GET' && collected.body !== null ? JSON.stringify(collected.body) : undefined;
+    if (body !== undefined)
+        headers['Content-Type'] ??= 'application/json';
+    const response = await ky(url, {
+        method,
+        headers,
+        ...(body === undefined ? {} : { body }),
+        throwHttpErrors: false,
+    });
+    return {
+        status: response.status,
+        ok: response.ok,
+        text: await response.text(),
+        contentType: response.headers.get('content-type') ?? '',
+    };
+}
+function buildUrl(baseUrl, path, queryParams) {
+    const url = new URL(`${baseUrl.replace(/\/$/, '')}${path}`);
+    for (const [key, value] of Object.entries(queryParams)) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                url.searchParams.append(key, String(item));
+        }
+        else {
+            url.searchParams.set(key, String(value));
+        }
+    }
+    return url.toString();
+}
+//# sourceMappingURL=execute.js.map

package/dist/openapi/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/openapi/execute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAIpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAQnD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAmB,EACnB,MAA+B,EAC/B,OAA8B;IAE9B,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE;QACtD,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACvD,MAAM,OAAO,GAA2B;QACtC,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;QAChD,GAAG,SAAS,CAAC,OAAO;KACrB,CAAC;IAEF,MAAM,IAAI,GACR,MAAM,KAAK,KAAK,IAAI,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3F,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,cAAc,CAAC,KAAK,kBAAkB,CAAC;IAEvE,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,GAAG,EAAE;QAC7B,MAAM;QACN,OAAO;QACP,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACvC,eAAe,EAAE,KAAK;KACvB,CAAC,CAAC;IACH,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE;QAC3B,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe,EAAE,IAAY,EAAE,WAAoC;IACnF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACvD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QACpD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC"}

package/dist/openapi/extract.d.ts

@@ -0,0 +1,2 @@
+import type { CommandDef } from '../core/types.js';
+export declare function extractOpenApiCommands(spec: unknown): CommandDef[];

package/dist/openapi/extract.js

@@ -0,0 +1,123 @@
+import { schemaTypeToCliType } from '../core/coerce.js';
+import { toKebab } from '../core/names.js';
+const HTTP_METHODS = new Set(['get', 'post', 'put', 'delete', 'patch']);
+export function extractOpenApiCommands(spec) {
+    const commands = [];
+    const seenNames = new Map();
+    const paths = isObject(spec) && isObject(spec.paths) ? spec.paths : {};
+    for (const [path, methods] of Object.entries(paths)) {
+        if (!isObject(methods))
+            continue;
+        for (const [method, operation] of Object.entries(methods)) {
+            if (!HTTP_METHODS.has(method) || !isObject(operation))
+                continue;
+            let name = operation.operationId !== undefined
+                ? toKebab(String(operation.operationId))
+                : fallbackName(method, path);
+            const seen = seenNames.get(name) ?? 0;
+            seenNames.set(name, seen + 1);
+            if (seen > 0)
+                name = `${name}-${method}`;
+            const params = extractParameters(operation);
+            const body = extractRequestBodyParams(operation);
+            params.push(...body.params);
+            commands.push({
+                name,
+                description: String(operation.summary ?? operation.description ?? `${method.toUpperCase()} ${path}`),
+                params,
+                hasBody: body.params.length > 0,
+                method,
+                path,
+                ...(body.contentType === undefined ? {} : { contentType: body.contentType }),
+            });
+        }
+    }
+    return commands;
+}
+function extractParameters(operation) {
+    const rawParams = Array.isArray(operation.parameters) ? operation.parameters : [];
+    return rawParams.filter(isObject).map((param) => {
+        const schema = getSchema(param.schema);
+        const { type, suffix } = schemaTypeToCliType(schema);
+        const choices = Array.isArray(schema.enum) ? { choices: schema.enum } : {};
+        return {
+            name: toKebab(String(param.name)),
+            originalName: String(param.name),
+            type,
+            required: Boolean(param.required),
+            description: `${String(param.description ?? param.name)}${suffix}`,
+            ...choices,
+            location: normalizeLocation(param.in),
+            schema,
+        };
+    });
+}
+function extractRequestBodyParams(operation) {
+    const requestBody = isObject(operation.requestBody) ? operation.requestBody : undefined;
+    const content = requestBody !== undefined && isObject(requestBody.content) ? requestBody.content : {};
+    const multipartSchema = getContentSchema(content, 'multipart/form-data');
+    const jsonSchema = getContentSchema(content, 'application/json');
+    const multipartProps = getProperties(multipartSchema);
+    const hasBinary = Object.values(multipartProps).some((schema) => schema.format === 'binary');
+    let schema = {};
+    let contentType;
+    if (hasBinary) {
+        schema = multipartSchema;
+        contentType = 'multipart/form-data';
+    }
+    else if (Object.keys(getProperties(jsonSchema)).length > 0) {
+        schema = jsonSchema;
+    }
+    else if (Object.keys(multipartProps).length > 0) {
+        schema = multipartSchema;
+        contentType = 'multipart/form-data';
+    }
+    const required = new Set(Array.isArray(schema.required) ? schema.required : []);
+    const properties = getProperties(schema);
+    const params = Object.entries(properties).map(([propName, propSchema]) => {
+        const isBinary = contentType === 'multipart/form-data' && propSchema.format === 'binary';
+        const { type, suffix } = isBinary
+            ? { type: 'string', suffix: ' (file path)' }
+            : schemaTypeToCliType(propSchema);
+        const choices = Array.isArray(propSchema.enum) ? { choices: propSchema.enum } : {};
+        return {
+            name: toKebab(propName),
+            originalName: propName,
+            type,
+            required: required.has(propName),
+            description: `${String(propSchema.description ?? propName)}${suffix}`,
+            ...choices,
+            location: isBinary ? 'file' : 'body',
+            schema: propSchema,
+        };
+    });
+    return contentType === undefined ? { params } : { params, contentType };
+}
+function getContentSchema(content, contentType) {
+    const item = content[contentType];
+    return isObject(item) ? getSchema(item.schema) : {};
+}
+function getProperties(schema) {
+    return isObject(schema.properties)
+        ? Object.fromEntries(Object.entries(schema.properties).filter((entry) => isObject(entry[1])))
+        : {};
+}
+function getSchema(value) {
+    return isObject(value) ? value : {};
+}
+function normalizeLocation(value) {
+    return value === 'path' || value === 'header' || value === 'body' || value === 'file'
+        ? value
+        : 'query';
+}
+function fallbackName(method, path) {
+    const slug = path
+        .replace(/^\/+|\/+$/g, '')
+        .replace(/[{}]/g, '')
+        .replace(/\//g, '-');
+    return slug ? `${method}-${slug}` : method;
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=extract.js.map

package/dist/openapi/extract.js.map

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

package/dist/openapi/load.d.ts

@@ -0,0 +1,11 @@
+export type LoadOpenApiOptions = {
+    authHeaders?: Array<[string, string]>;
+    cacheDir?: string;
+    cacheKey?: string;
+    ttlSeconds?: number;
+    refresh?: boolean;
+};
+export type OpenApiSpec = Record<string, unknown> & {
+    paths: Record<string, unknown>;
+};
+export declare function loadOpenApiSpec(source: string, options?: LoadOpenApiOptions): Promise<OpenApiSpec>;

package/dist/openapi/load.js

@@ -0,0 +1,52 @@
+import ky from 'ky';
+import { readFile } from 'node:fs/promises';
+import YAML from 'yaml';
+import { cacheKeyFor, loadCached, saveCache } from '../core/cache.js';
+import { resolveRefs } from './refs.js';
+export async function loadOpenApiSpec(source, options = {}) {
+    const isUrl = source.startsWith('http://') || source.startsWith('https://');
+    const ttlSeconds = options.ttlSeconds ?? 3600;
+    const key = options.cacheKey ?? cacheKeyFor({ source, authHeaders: options.authHeaders ?? [] });
+    if (isUrl && options.cacheDir !== undefined && !options.refresh) {
+        const cached = await loadCached(options.cacheDir, key, ttlSeconds);
+        if (cached !== null)
+            return cached;
+    }
+    const raw = isUrl
+        ? await fetchRemoteSpec(source, options.authHeaders ?? [])
+        : await readFile(source, 'utf8');
+    const parsed = parseSpec(raw);
+    const spec = await resolveRefs(parsed);
+    if (!isOpenApiSpec(spec)) {
+        throw new Error("spec must contain 'paths'");
+    }
+    if (isUrl && options.cacheDir !== undefined) {
+        await saveCache(options.cacheDir, key, spec);
+    }
+    return spec;
+}
+async function fetchRemoteSpec(source, authHeaders) {
+    const response = await ky.get(source, {
+        headers: Object.fromEntries(authHeaders),
+        throwHttpErrors: false,
+    });
+    if (!response.ok)
+        throw new Error(`failed to fetch spec: HTTP ${response.status}`);
+    return response.text();
+}
+function parseSpec(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return YAML.parse(raw);
+    }
+}
+function isOpenApiSpec(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        !Array.isArray(value) &&
+        'paths' in value &&
+        typeof value.paths === 'object');
+}
+//# sourceMappingURL=load.js.map

package/dist/openapi/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/openapi/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAcxC,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,OAAO,GAAuB,EAAE;IAEhC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;IAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,IAAI,WAAW,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC,CAAC;IAEhG,IAAI,KAAK,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAChE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAc,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;QAChF,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;IACrC,CAAC;IAED,MAAM,GAAG,GAAG,KAAK;QACf,CAAC,CAAC,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;QAC1D,CAAC,CAAC,MAAM,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;IAEvC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5C,MAAM,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,MAAc,EACd,WAAoC;IAEpC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE;QACpC,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC;QACxC,eAAe,EAAE,KAAK;KACvB,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnF,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACpC,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,OAAO,IAAI,KAAK;QAChB,OAAQ,KAA6B,CAAC,KAAK,KAAK,QAAQ,CACzD,CAAC;AACJ,CAAC"}

package/dist/openapi/params.d.ts

@@ -0,0 +1,12 @@
+import type { CommandDef } from '../core/types.js';
+export type CollectedOpenApiParams = {
+    path: string;
+    queryParams: Record<string, unknown>;
+    headers: Record<string, string>;
+    body: Record<string, unknown> | unknown[] | string | number | boolean | null;
+    files: Record<string, unknown> | null;
+};
+export type CollectOpenApiOptions = {
+    stdinBody?: unknown;
+};
+export declare function collectOpenApiParams(command: CommandDef, values: Record<string, unknown>, options?: CollectOpenApiOptions): CollectedOpenApiParams;

package/dist/openapi/params.js

@@ -0,0 +1,47 @@
+import { coerceAndValidateValue } from '../core/coerce.js';
+export function collectOpenApiParams(command, values, options = {}) {
+    let path = command.path ?? '';
+    const queryParams = {};
+    const headers = {};
+    let body = null;
+    const files = null;
+    for (const param of command.params) {
+        if (param.location !== 'path')
+            continue;
+        const value = values[param.name];
+        if (value !== undefined && value !== null) {
+            path = path.replace(`{${param.originalName}}`, encodeURIComponent(String(value)));
+        }
+    }
+    for (const param of command.params) {
+        const value = values[param.name];
+        if (value === undefined || value === null)
+            continue;
+        if (param.location === 'query') {
+            queryParams[param.originalName] = coerceAndValidateValue(value, param.schema ?? {}, `--${param.name}`);
+        }
+        else if (param.location === 'header') {
+            headers[param.originalName] = String(value);
+        }
+    }
+    const method = command.method?.toLowerCase() ?? 'get';
+    if (method !== 'get') {
+        if (options.stdinBody !== undefined) {
+            body = options.stdinBody;
+        }
+        else {
+            const collectedBody = {};
+            for (const param of command.params) {
+                if (param.location !== 'body')
+                    continue;
+                const value = values[param.name];
+                if (value !== undefined && value !== null) {
+                    collectedBody[param.originalName] = coerceAndValidateValue(value, param.schema ?? {}, `--${param.name}`);
+                }
+            }
+            body = Object.keys(collectedBody).length > 0 ? collectedBody : null;
+        }
+    }
+    return { path, queryParams, headers, body, files };
+}
+//# sourceMappingURL=params.js.map

package/dist/openapi/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../src/openapi/params.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAc3D,MAAM,UAAU,oBAAoB,CAClC,OAAmB,EACnB,MAA+B,EAC/B,OAAO,GAA0B,EAAE;IAEnC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IAC9B,MAAM,WAAW,GAA4B,EAAE,CAAC;IAChD,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,IAAI,GAAmC,IAAI,CAAC;IAChD,MAAM,KAAK,GAAmC,IAAI,CAAC;IAEnD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM;YAAE,SAAS;QACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,YAAY,GAAG,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QAEpD,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAC/B,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,sBAAsB,CACtD,KAAK,EACL,KAAK,CAAC,MAAM,IAAI,EAAE,EAClB,KAAK,KAAK,CAAC,IAAI,EAAE,CAClB,CAAC;QACJ,CAAC;aAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACvC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;IACtD,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,GAAG,OAAO,CAAC,SAA2C,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,MAAM,aAAa,GAA4B,EAAE,CAAC;YAClD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnC,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM;oBAAE,SAAS;gBACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAC1C,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,sBAAsB,CACxD,KAAK,EACL,KAAK,CAAC,MAAM,IAAI,EAAE,EAClB,KAAK,KAAK,CAAC,IAAI,EAAE,CAClB,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACrD,CAAC"}

package/dist/openapi/refs.d.ts

@@ -0,0 +1 @@
+export declare function resolveRefs<T>(input: T): Promise<T>;

package/dist/openapi/refs.js

@@ -0,0 +1,8 @@
+import $RefParser from '@apidevtools/json-schema-ref-parser';
+export async function resolveRefs(input) {
+    return (await $RefParser.dereference(input, {
+        mutateInputSchema: false,
+        dereference: { circular: 'ignore' },
+    }));
+}
+//# sourceMappingURL=refs.js.map

package/dist/openapi/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../src/openapi/refs.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,qCAAqC,CAAC;AAE7D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,KAAQ;IAC3C,OAAO,CAAC,MAAM,UAAU,CAAC,WAAW,CAAC,KAAe,EAAE;QACpD,iBAAiB,EAAE,KAAK;QACxB,WAAW,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;KACpC,CAAC,CAAM,CAAC;AACX,CAAC"}

package/dist/skills/agents.d.ts

@@ -0,0 +1,77 @@
+export type AgentId = keyof typeof AGENT_INSTALL_TARGETS;
+export type InstallScope = 'project' | 'global';
+export type AgentInstallTarget = {
+    displayName: string;
+    projectDir: string;
+    globalDir: (home: string, configHome: string) => string;
+};
+export declare const AGENT_INSTALL_TARGETS: {
+    readonly pi: {
+        readonly displayName: 'Pi';
+        readonly projectDir: '.pi/skills';
+        readonly globalDir: (home: string) => string;
+    };
+    readonly universal: {
+        readonly displayName: 'Universal (.agents)';
+        readonly projectDir: '.agents/skills';
+        readonly globalDir: (_home: string, configHome: string) => string;
+    };
+    readonly codex: {
+        readonly displayName: 'Codex';
+        readonly projectDir: '.agents/skills';
+        readonly globalDir: (home: string) => string;
+    };
+    readonly 'claude-code': {
+        readonly displayName: 'Claude Code';
+        readonly projectDir: '.claude/skills';
+        readonly globalDir: (home: string) => string;
+    };
+    readonly cursor: {
+        readonly displayName: 'Cursor';
+        readonly projectDir: '.agents/skills';
+        readonly globalDir: (home: string) => string;
+    };
+    readonly opencode: {
+        readonly displayName: 'OpenCode';
+        readonly projectDir: '.agents/skills';
+        readonly globalDir: (_home: string, configHome: string) => string;
+    };
+    readonly 'gemini-cli': {
+        readonly displayName: 'Gemini CLI';
+        readonly projectDir: '.agents/skills';
+        readonly globalDir: (home: string) => string;
+    };
+    readonly amp: {
+        readonly displayName: 'Amp';
+        readonly projectDir: '.agents/skills';
+        readonly globalDir: (_home: string, configHome: string) => string;
+    };
+    readonly 'github-copilot': {
+        readonly displayName: 'GitHub Copilot';
+        readonly projectDir: '.agents/skills';
+        readonly globalDir: (home: string) => string;
+    };
+    readonly goose: {
+        readonly displayName: 'Goose';
+        readonly projectDir: '.goose/skills';
+        readonly globalDir: (_home: string, configHome: string) => string;
+    };
+    readonly cline: {
+        readonly displayName: 'Cline';
+        readonly projectDir: '.agents/skills';
+        readonly globalDir: (home: string) => string;
+    };
+    readonly windsurf: {
+        readonly displayName: 'Windsurf';
+        readonly projectDir: '.windsurf/skills';
+        readonly globalDir: (home: string) => string;
+    };
+};
+export declare function listAgentIds(): AgentId[];
+export declare function isAgentId(value: string): value is AgentId;
+export declare function resolveAgentSkillDir(agent: AgentId, scope: InstallScope, options?: {
+    cwd?: string;
+    home?: string;
+    configHome?: string;
+}): string;
+export declare function assertValidSkillName(name: string): void;

package/dist/skills/agents.js

@@ -0,0 +1,85 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+// Agent skill locations adapted from vercel-labs/skills (MIT):
+// https://github.com/vercel-labs/skills
+export const AGENT_INSTALL_TARGETS = {
+    pi: {
+        displayName: 'Pi',
+        projectDir: '.pi/skills',
+        globalDir: (home) => join(home, '.pi/agent/skills'),
+    },
+    universal: {
+        displayName: 'Universal (.agents)',
+        projectDir: '.agents/skills',
+        globalDir: (_home, configHome) => join(configHome, 'agents/skills'),
+    },
+    codex: {
+        displayName: 'Codex',
+        projectDir: '.agents/skills',
+        globalDir: (home) => join(process.env.CODEX_HOME?.trim() || join(home, '.codex'), 'skills'),
+    },
+    'claude-code': {
+        displayName: 'Claude Code',
+        projectDir: '.claude/skills',
+        globalDir: (home) => join(process.env.CLAUDE_CONFIG_DIR?.trim() || join(home, '.claude'), 'skills'),
+    },
+    cursor: {
+        displayName: 'Cursor',
+        projectDir: '.agents/skills',
+        globalDir: (home) => join(home, '.cursor/skills'),
+    },
+    opencode: {
+        displayName: 'OpenCode',
+        projectDir: '.agents/skills',
+        globalDir: (_home, configHome) => join(configHome, 'opencode/skills'),
+    },
+    'gemini-cli': {
+        displayName: 'Gemini CLI',
+        projectDir: '.agents/skills',
+        globalDir: (home) => join(home, '.gemini/skills'),
+    },
+    amp: {
+        displayName: 'Amp',
+        projectDir: '.agents/skills',
+        globalDir: (_home, configHome) => join(configHome, 'agents/skills'),
+    },
+    'github-copilot': {
+        displayName: 'GitHub Copilot',
+        projectDir: '.agents/skills',
+        globalDir: (home) => join(home, '.copilot/skills'),
+    },
+    goose: {
+        displayName: 'Goose',
+        projectDir: '.goose/skills',
+        globalDir: (_home, configHome) => join(configHome, 'goose/skills'),
+    },
+    cline: {
+        displayName: 'Cline',
+        projectDir: '.agents/skills',
+        globalDir: (home) => join(home, '.agents/skills'),
+    },
+    windsurf: {
+        displayName: 'Windsurf',
+        projectDir: '.windsurf/skills',
+        globalDir: (home) => join(home, '.codeium/windsurf/skills'),
+    },
+};
+export function listAgentIds() {
+    return Object.keys(AGENT_INSTALL_TARGETS);
+}
+export function isAgentId(value) {
+    return value in AGENT_INSTALL_TARGETS;
+}
+export function resolveAgentSkillDir(agent, scope, options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const home = options.home ?? homedir();
+    const configHome = options.configHome ?? process.env.XDG_CONFIG_HOME ?? join(home, '.config');
+    const target = AGENT_INSTALL_TARGETS[agent];
+    return scope === 'project' ? join(cwd, target.projectDir) : target.globalDir(home, configHome);
+}
+export function assertValidSkillName(name) {
+    if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(name) || name.length > 64) {
+        throw new Error('--name must be 1-64 characters and contain only lowercase letters, numbers, and single hyphens');
+    }
+}
+//# sourceMappingURL=agents.js.map

package/dist/skills/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/skills/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAWjC,+DAA+D;AAC/D,wCAAwC;AACxC,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,EAAE,EAAE;QACF,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,YAAY;QACxB,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC;KAC5D;IACD,SAAS,EAAE;QACT,WAAW,EAAE,qBAAqB;QAClC,UAAU,EAAE,gBAAgB;QAC5B,SAAS,EAAE,CAAC,KAAa,EAAE,UAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC;KACpF;IACD,KAAK,EAAE;QACL,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,gBAAgB;QAC5B,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACzE;IACD,aAAa,EAAE;QACb,WAAW,EAAE,aAAa;QAC1B,UAAU,EAAE,gBAAgB;QAC5B,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC;KACjF;IACD,MAAM,EAAE;QACN,WAAW,EAAE,QAAQ;QACrB,UAAU,EAAE,gBAAgB;QAC5B,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC;KAC1D;IACD,QAAQ,EAAE;QACR,WAAW,EAAE,UAAU;QACvB,UAAU,EAAE,gBAAgB;QAC5B,SAAS,EAAE,CAAC,KAAa,EAAE,UAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC;KACtF;IACD,YAAY,EAAE;QACZ,WAAW,EAAE,YAAY;QACzB,UAAU,EAAE,gBAAgB;QAC5B,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC;KAC1D;IACD,GAAG,EAAE;QACH,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,gBAAgB;QAC5B,SAAS,EAAE,CAAC,KAAa,EAAE,UAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC;KACpF;IACD,gBAAgB,EAAE;QAChB,WAAW,EAAE,gBAAgB;QAC7B,UAAU,EAAE,gBAAgB;QAC5B,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC;KAC3D;IACD,KAAK,EAAE;QACL,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,eAAe;QAC3B,SAAS,EAAE,CAAC,KAAa,EAAE,UAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC;KACnF;IACD,KAAK,EAAE;QACL,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,gBAAgB;QAC5B,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC;KAC1D;IACD,QAAQ,EAAE;QACR,WAAW,EAAE,UAAU;QACvB,UAAU,EAAE,kBAAkB;QAC9B,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,0BAA0B,CAAC;KACpE;CACoD,CAAC;AAExD,MAAM,UAAU,YAAY;IAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAc,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK,IAAI,qBAAqB,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAc,EACd,KAAmB,EACnB,OAAO,GAAyD,EAAE;IAElE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC9F,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAE5C,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CACb,gGAAgG,CACjG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/skills/generate.d.ts

@@ -0,0 +1 @@
+export declare function runGenerate(argv: string[]): Promise<void>;