@asnd/skill-creator 0.1.1 → 0.1.3

package/dist/commands/install.js

@@ -0,0 +1,229 @@
+import { existsSync } from 'node:fs';
+import { mkdir, readdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import { basename, dirname, extname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { assertValidCommandName, commandFileNameForAgent, commandFormatForAgent, isCommandAgentId, listCommandAgentIds, resolveAgentCommandDir, } from './agents.js';
+export async function runInstallCommand(argv) {
+    const args = await completeInteractiveOptions(parseInstallCommandArgs(argv));
+    if (args.help) {
+        printInstallCommandHelp();
+        return;
+    }
+    const source = args.source ?? bundledCommandSourcePath();
+    if (args.agent === undefined || args.scope === undefined) {
+        throw new Error('--agent and --scope are required when prompts are unavailable');
+    }
+    const templates = await loadCommandTemplates(source, args.name);
+    const targetDir = resolveAgentCommandDir(args.agent, args.scope);
+    await mkdir(targetDir, { recursive: true });
+    for (const template of templates) {
+        assertValidCommandName(template.name);
+        const targetPath = join(targetDir, commandFileNameForAgent(args.agent, template.name));
+        await assertWritableTarget(targetPath, args.force);
+        await writeFile(targetPath, renderCommandTemplate(args.agent, template), 'utf8');
+    }
+    const label = templates.length === 1 ? 'command' : 'commands';
+    console.log(`Installed ${label}: ${templates.map((template) => template.name).join(', ')}`);
+    console.log(`Agent: ${listCommandAgentIds().includes(args.agent) ? args.agent : String(args.agent)}`);
+    console.log(`Scope: ${args.scope}`);
+    console.log(`Path: ${targetDir}`);
+}
+function parseInstallCommandArgs(argv) {
+    const args = {
+        force: false,
+        yes: false,
+        help: false,
+    };
+    const positional = [];
+    const tokens = argv[0] === 'install' ? argv.slice(1) : argv;
+    for (let index = 0; index < tokens.length; index += 1) {
+        const token = tokens[index];
+        if (token === undefined)
+            continue;
+        switch (token) {
+            case '--help':
+            case '-h':
+                args.help = true;
+                break;
+            case '--source':
+                args.source = resolve(requireValue(tokens, ++index, token));
+                break;
+            case '--name':
+                args.name = requireValue(tokens, ++index, token);
+                break;
+            case '--agent':
+                args.agent = parseAgent(requireValue(tokens, ++index, token));
+                break;
+            case '--scope':
+                args.scope = parseScope(requireValue(tokens, ++index, token));
+                break;
+            case '--force':
+                args.force = true;
+                break;
+            case '--yes':
+            case '-y':
+                args.yes = true;
+                break;
+            case 'agent':
+                args.agent = parseAgent(requireValue(tokens, ++index, token));
+                break;
+            case 'scope':
+                args.scope = parseScope(requireValue(tokens, ++index, token));
+                break;
+            default:
+                if (token.startsWith('-'))
+                    throw new Error(`unknown command install option: ${token}`);
+                positional.push(token);
+        }
+    }
+    if (args.source === undefined && positional.length > 0)
+        args.source = resolve(positional[0]);
+    if (positional.length > 1)
+        throw new Error('only one command source may be provided');
+    return args;
+}
+async function completeInteractiveOptions(args) {
+    if (args.help || (args.agent !== undefined && args.scope !== undefined))
+        return args;
+    if (args.yes || !process.stdin.isTTY || !process.stdout.isTTY)
+        return args;
+    const readline = await import('node:readline/promises');
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        const completed = { ...args };
+        if (completed.agent === undefined) {
+            const agentChoices = listCommandAgentIds();
+            console.log(`Agents: ${agentChoices.join(', ')}`);
+            completed.agent = parseAgent(await rl.question('Agent to install command for: '));
+        }
+        if (completed.scope === undefined) {
+            completed.scope = parseScope(await rl.question('Install scope (project/global): '));
+        }
+        return completed;
+    }
+    finally {
+        rl.close();
+    }
+}
+async function loadCommandTemplates(source, name) {
+    const sourceStat = await stat(source);
+    if (sourceStat.isDirectory()) {
+        if (name !== undefined)
+            throw new Error('--name can only be used when --source is a file');
+        const entries = await readdir(source, { withFileTypes: true });
+        const files = entries
+            .filter((entry) => entry.isFile() && isMarkdownCommandFile(entry.name))
+            .map((entry) => entry.name)
+            .sort((left, right) => left.localeCompare(right));
+        if (files.length === 0)
+            throw new Error(`no markdown command files found in ${source}`);
+        return Promise.all(files.map(async (fileName) => ({
+            name: commandNameFromFileName(fileName),
+            content: await readFile(join(source, fileName), 'utf8'),
+            sourcePath: join(source, fileName),
+        })));
+    }
+    if (!sourceStat.isFile())
+        throw new Error(`command source is not a file or directory: ${source}`);
+    if (!isMarkdownCommandFile(basename(source))) {
+        throw new Error(`command source must be a markdown file: ${source}`);
+    }
+    const commandName = name ?? commandNameFromFileName(basename(source));
+    return [
+        {
+            name: commandName,
+            content: await readFile(source, 'utf8'),
+            sourcePath: source,
+        },
+    ];
+}
+function isMarkdownCommandFile(fileName) {
+    const lower = fileName.toLowerCase();
+    return lower.endsWith('.md') && lower !== 'readme.md';
+}
+function commandNameFromFileName(fileName) {
+    const lower = fileName.toLowerCase();
+    if (lower.endsWith('.prompt.md'))
+        return fileName.slice(0, -'.prompt.md'.length);
+    return fileName.slice(0, -extname(fileName).length);
+}
+async function assertWritableTarget(targetPath, force) {
+    if (!existsSync(targetPath))
+        return;
+    if (!force)
+        throw new Error(`command target already exists: ${targetPath}. Use --force to overwrite.`);
+    await rm(targetPath, { force: true });
+}
+function renderCommandTemplate(agent, template) {
+    if (commandFormatForAgent(agent) === 'gemini-toml')
+        return renderGeminiToml(template.content);
+    return template.content.endsWith('\n') ? template.content : `${template.content}\n`;
+}
+function renderGeminiToml(markdown) {
+    const parsed = parseMarkdownPrompt(markdown);
+    const prompt = renderGeminiPrompt(parsed.body);
+    const lines = [`prompt = ${JSON.stringify(prompt)}`];
+    if (parsed.description !== undefined)
+        lines.unshift(`description = ${JSON.stringify(parsed.description)}`);
+    return `${lines.join('\n')}\n`;
+}
+function renderGeminiPrompt(markdownPrompt) {
+    return markdownPrompt.replaceAll('$ARGUMENTS', '{{args}}').replaceAll('$@', '{{args}}');
+}
+function parseMarkdownPrompt(markdown) {
+    if (!markdown.startsWith('---\n'))
+        return { body: markdown.endsWith('\n') ? markdown : `${markdown}\n` };
+    const end = markdown.indexOf('\n---\n', 4);
+    if (end === -1)
+        return { body: markdown.endsWith('\n') ? markdown : `${markdown}\n` };
+    const frontmatter = markdown.slice(4, end);
+    const body = markdown.slice(end + '\n---\n'.length);
+    const descriptionLine = frontmatter
+        .split('\n')
+        .map((line) => line.trim())
+        .find((line) => line.startsWith('description:'));
+    const description = descriptionLine
+        ?.slice('description:'.length)
+        .trim()
+        .replace(/^['"]|['"]$/g, '');
+    return {
+        body: body.endsWith('\n') ? body : `${body}\n`,
+        ...(description === undefined || description.length === 0 ? {} : { description }),
+    };
+}
+function bundledCommandSourcePath() {
+    return join(dirname(fileURLToPath(import.meta.url)), '../..', 'prompts', 'skill-creator.md');
+}
+function parseAgent(value) {
+    if (isCommandAgentId(value))
+        return value;
+    throw new Error(`unknown command agent: ${value}. Valid agents: ${listCommandAgentIds().join(', ')}`);
+}
+function parseScope(value) {
+    if (value === 'project' || value === 'global')
+        return value;
+    throw new Error('--scope must be project or global');
+}
+function requireValue(argv, index, option) {
+    const value = argv[index];
+    if (value === undefined || value.startsWith('--'))
+        throw new Error(`missing value for ${option}`);
+    return value;
+}
+function printInstallCommandHelp() {
+    console.log(`npx @asnd/skill-creator command install --agent AGENT --scope project|global
+
+Options:
+  --source FILE|DIR     Markdown command file or directory of *.md command files (defaults to bundled /skill-creator command)
+  --name NAME           Override command name when --source is a file
+  --agent AGENT         Target agent, e.g. pi, claude-code, cursor, opencode
+  --scope SCOPE         Install scope: project|global
+  --force               Overwrite existing command files
+  --yes, -y             Non-interactive mode; requires --agent and --scope
+  --help, -h            Show this help
+`);
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

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

package/dist/core/cache.d.ts

@@ -0,0 +1,3 @@
+export declare function cacheKeyFor(config: Record<string, unknown>): string;
+export declare function loadCached<T = unknown>(cacheDir: string, key: string, ttlSeconds: number): Promise<T | null>;
+export declare function saveCache(cacheDir: string, key: string, data: unknown): Promise<void>;

package/dist/core/cache.js

@@ -0,0 +1,52 @@
+import * as cacache from 'cacache';
+import { createHash } from 'node:crypto';
+const CACHE_IGNORED_FIELDS = new Set([
+    'cacheTtl',
+    'cache_ttl',
+    'description',
+    'include',
+    'exclude',
+    'methods',
+]);
+export function cacheKeyFor(config) {
+    const normalized = normalizeConfig(config);
+    return createHash('sha256').update(JSON.stringify(normalized)).digest('hex').slice(0, 16);
+}
+export async function loadCached(cacheDir, key, ttlSeconds) {
+    try {
+        const info = await cacache.get.info(cacheDir, key);
+        if (info === null)
+            return null;
+        const ageSeconds = (Date.now() - info.time) / 1000;
+        if (ageSeconds >= ttlSeconds)
+            return null;
+        const entry = await cacache.get(cacheDir, key);
+        return JSON.parse(entry.data.toString('utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+export async function saveCache(cacheDir, key, data) {
+    await cacache.put(cacheDir, key, JSON.stringify(data));
+}
+function normalizeConfig(input) {
+    const output = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (CACHE_IGNORED_FIELDS.has(key))
+            continue;
+        if (key === 'authHeaders' || key === 'auth_headers') {
+            output[key] = normalizeAuthHeaders(value);
+        }
+        else {
+            output[key] = value;
+        }
+    }
+    return Object.fromEntries(Object.entries(output).sort(([a], [b]) => a.localeCompare(b)));
+}
+function normalizeAuthHeaders(value) {
+    if (!Array.isArray(value))
+        return value;
+    return [...value].sort((a, b) => JSON.stringify(a).localeCompare(JSON.stringify(b)));
+}
+//# sourceMappingURL=cache.js.map

package/dist/core/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/core/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,UAAU;IACV,WAAW;IACX,aAAa;IACb,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,UAAU,WAAW,CAAC,MAA+B;IACzD,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAgB,EAChB,GAAW,EACX,UAAkB;IAElB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACnD,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAE/B,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACnD,IAAI,UAAU,IAAI,UAAU;YAAE,OAAO,IAAI,CAAC;QAE1C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAM,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,GAAW,EAAE,IAAa;IAC1E,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,eAAe,CAAC,KAA8B;IACrD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5C,IAAI,GAAG,KAAK,aAAa,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;YACpD,MAAM,CAAC,GAAG,CAAC,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvF,CAAC"}

package/dist/core/coerce.d.ts

@@ -0,0 +1,8 @@
+import type { CliValueType, JsonSchema } from './types.js';
+export declare function schemaTypeToCliType(schema: JsonSchema): {
+    type: CliValueType;
+    suffix: string;
+};
+export declare function coerceAndValidateValue(value: unknown, schema?: JsonSchema, label?: string): unknown;
+export declare function validateValue(value: unknown, schema?: JsonSchema, label?: string): void;
+export declare function coerceValue(value: unknown, schema?: JsonSchema): unknown;

package/dist/core/coerce.js

@@ -0,0 +1,128 @@
+import { Ajv } from 'ajv';
+import addFormatsPlugin from 'ajv-formats';
+const ajv = new Ajv({ allErrors: true, strict: false });
+const addFormats = addFormatsPlugin;
+addFormats(ajv);
+const validatorCache = new WeakMap();
+export function schemaTypeToCliType(schema) {
+    switch (schema.type) {
+        case 'integer':
+            return { type: 'integer', suffix: '' };
+        case 'number':
+            return { type: 'number', suffix: '' };
+        case 'boolean':
+            return { type: 'boolean', suffix: '' };
+        case 'array':
+            return { type: 'string', suffix: ' (JSON array)' };
+        case 'object':
+            return { type: 'string', suffix: ' (JSON object)' };
+        default:
+            return { type: 'string', suffix: '' };
+    }
+}
+export function coerceAndValidateValue(value, schema = {}, label = 'value') {
+    const coerced = coerceValue(value, schema);
+    validateValue(coerced, schema, label);
+    return coerced;
+}
+export function validateValue(value, schema = {}, label = 'value') {
+    if (Object.keys(schema).length === 0)
+        return;
+    const validate = validatorFor(schema);
+    if (validate(value))
+        return;
+    throw new Error(`${label} failed validation: ${formatAjvErrors(validate.errors ?? [], label)}`);
+}
+function validatorFor(schema) {
+    const cached = validatorCache.get(schema);
+    if (cached !== undefined)
+        return cached;
+    const validate = ajv.compile(normalizeSchema(schema));
+    validatorCache.set(schema, validate);
+    return validate;
+}
+function normalizeSchema(schema) {
+    if (schema.nullable === true && typeof schema.type === 'string') {
+        return { ...schema, type: [schema.type, 'null'] };
+    }
+    return schema;
+}
+function formatAjvErrors(errors, label) {
+    return errors
+        .map((error) => {
+        const path = error.instancePath.length > 0 ? `${label}${error.instancePath}` : label;
+        return `${path} ${error.message ?? 'is invalid'}`;
+    })
+        .join('; ');
+}
+export function coerceValue(value, schema = {}) {
+    if (value === null || value === undefined)
+        return null;
+    switch (schema.type) {
+        case 'array':
+            return coerceArray(value, schema.items);
+        case 'object':
+            return coerceObject(value);
+        case 'boolean':
+            return Boolean(value);
+        case 'integer':
+            return typeof value === 'number' ? Math.trunc(value) : Number.parseInt(String(value), 10);
+        case 'number':
+            return typeof value === 'number' ? value : Number.parseFloat(String(value));
+        default:
+            return coerceSchemaless(value);
+    }
+}
+function coerceArray(value, itemSchema) {
+    if (Array.isArray(value))
+        return value;
+    if (typeof value !== 'string')
+        return value;
+    try {
+        const parsed = JSON.parse(value);
+        if (Array.isArray(parsed))
+            return parsed;
+    }
+    catch {
+        // Fall back to comma/single value handling below.
+    }
+    const values = value.includes(',') ? value.split(',').map((part) => part.trim()) : [value];
+    return values.map((item) => coerceItem(item, itemSchema?.type));
+}
+function coerceItem(value, type) {
+    switch (type) {
+        case 'integer':
+            return Number.parseInt(value, 10);
+        case 'number':
+            return Number.parseFloat(value);
+        case 'boolean':
+            return ['true', '1', 'yes'].includes(value.toLowerCase());
+        default:
+            return value;
+    }
+}
+function coerceObject(value) {
+    if (typeof value !== 'string')
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+function coerceSchemaless(value) {
+    if (typeof value !== 'string')
+        return value;
+    const trimmed = value.trim();
+    if (!trimmed || !['{', '['].includes(trimmed[0] ?? ''))
+        return value;
+    try {
+        const parsed = JSON.parse(trimmed);
+        return typeof parsed === 'object' && parsed !== null ? parsed : value;
+    }
+    catch {
+        return value;
+    }
+}
+//# sourceMappingURL=coerce.js.map

package/dist/core/coerce.js.map

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

package/dist/core/filter.d.ts

@@ -0,0 +1,7 @@
+import type { CommandDef } from './types.js';
+export type CommandFilters = {
+    include?: string[];
+    exclude?: string[];
+    methods?: string[];
+};
+export declare function filterCommands(commands: CommandDef[], filters?: CommandFilters): CommandDef[];

package/dist/core/filter.js

@@ -0,0 +1,16 @@
+import { minimatch } from 'minimatch';
+export function filterCommands(commands, filters = {}) {
+    let result = commands;
+    if (filters.methods?.length) {
+        const allowed = new Set(filters.methods.map((method) => method.toUpperCase()));
+        result = result.filter((command) => command.method === undefined || allowed.has(command.method.toUpperCase()));
+    }
+    if (filters.include?.length) {
+        result = result.filter((command) => filters.include?.some((pattern) => minimatch(command.name, pattern)) ?? false);
+    }
+    if (filters.exclude?.length) {
+        result = result.filter((command) => !(filters.exclude?.some((pattern) => minimatch(command.name, pattern)) ?? false));
+    }
+    return result;
+}
+//# sourceMappingURL=filter.js.map

package/dist/core/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/core/filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAUtC,MAAM,UAAU,cAAc,CAAC,QAAsB,EAAE,OAAO,GAAmB,EAAE;IACjF,IAAI,MAAM,GAAG,QAAQ,CAAC;IAEtB,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAC/E,MAAM,GAAG,MAAM,CAAC,MAAM,CACpB,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CACvF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC5B,MAAM,GAAG,MAAM,CAAC,MAAM,CACpB,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,CAC3F,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC5B,MAAM,GAAG,MAAM,CAAC,MAAM,CACpB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAC9F,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/listing.d.ts

@@ -0,0 +1,11 @@
+import type { CommandDef } from './types.js';
+import type { UsageStore } from './usage.js';
+export type SortMode = 'usage' | 'recent' | 'alpha' | 'default';
+export declare function sortCommands(commands: CommandDef[], sortMode: SortMode, sourceHash: string, usageStore: UsageStore): Promise<CommandDef[]>;
+export declare function resolveSortMode(explicitSort: SortMode | undefined, sourceHash: string, usageStore: UsageStore): Promise<SortMode>;
+export declare function applyListOptions(commands: CommandDef[], options: {
+    sourceHash: string;
+    sortMode?: SortMode;
+    top?: number;
+    usageStore: UsageStore;
+}): Promise<CommandDef[]>;

package/dist/core/listing.js

@@ -0,0 +1,31 @@
+export async function sortCommands(commands, sortMode, sourceHash, usageStore) {
+    if (sortMode === 'default')
+        return commands;
+    if (sortMode === 'alpha')
+        return [...commands].sort((a, b) => a.name.localeCompare(b.name));
+    const usage = (await usageStore.load())[sourceHash] ?? {};
+    if (Object.keys(usage).length === 0)
+        return commands;
+    if (sortMode === 'usage') {
+        return [...commands].sort((a, b) => {
+            const diff = (usage[usageKey(b)]?.count ?? 0) - (usage[usageKey(a)]?.count ?? 0);
+            return diff || 0;
+        });
+    }
+    return [...commands].sort((a, b) => (usage[usageKey(b)]?.lastUsed ?? '').localeCompare(usage[usageKey(a)]?.lastUsed ?? ''));
+}
+export async function resolveSortMode(explicitSort, sourceHash, usageStore) {
+    if (explicitSort !== undefined)
+        return explicitSort;
+    const usage = (await usageStore.load())[sourceHash] ?? {};
+    return Object.keys(usage).length > 0 ? 'usage' : 'default';
+}
+export async function applyListOptions(commands, options) {
+    const effectiveSort = await resolveSortMode(options.sortMode, options.sourceHash, options.usageStore);
+    const sorted = await sortCommands(commands, effectiveSort, options.sourceHash, options.usageStore);
+    return options.top === undefined ? sorted : sorted.slice(0, options.top);
+}
+function usageKey(command) {
+    return command.toolName ?? command.graphqlFieldName ?? command.name;
+}
+//# sourceMappingURL=listing.js.map

package/dist/core/listing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listing.js","sourceRoot":"","sources":["../../src/core/listing.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAsB,EACtB,QAAkB,EAClB,UAAkB,EAClB,UAAsB;IAEtB,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAE5F,MAAM,KAAK,GAAG,CAAC,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAErD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACjC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC;YACjF,OAAO,IAAI,IAAI,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACjC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC,CACvF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,YAAkC,EAClC,UAAkB,EAClB,UAAsB;IAEtB,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC;IACpD,MAAM,KAAK,GAAG,CAAC,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAC1D,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAsB,EACtB,OAKC;IAED,MAAM,aAAa,GAAG,MAAM,eAAe,CACzC,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,UAAU,CACnB,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,QAAQ,EACR,aAAa,EACb,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,UAAU,CACnB,CAAC;IACF,OAAO,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,QAAQ,CAAC,OAAmB;IACnC,OAAO,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;AACtE,CAAC"}

package/dist/core/names.d.ts

@@ -0,0 +1 @@
+export declare function toKebab(name: string): string;

package/dist/core/names.js

@@ -0,0 +1,7 @@
+export function toKebab(name) {
+    return name
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/_/g, '-')
+        .toLowerCase();
+}
+//# sourceMappingURL=names.js.map

package/dist/core/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../src/core/names.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI;SACR,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;SAClB,WAAW,EAAE,CAAC;AACnB,CAAC"}

package/dist/core/output.d.ts

@@ -0,0 +1,12 @@
+export type OutputOptions = {
+    pretty?: boolean;
+    raw?: boolean;
+    head?: number;
+    toon?: boolean;
+};
+export type FormattedOutput = {
+    stdout: string;
+    stderr: string;
+};
+export declare function applyHead<T>(data: T, n: number): T;
+export declare function formatOutput(data: unknown, options?: OutputOptions): FormattedOutput;

package/dist/core/output.js

@@ -0,0 +1,34 @@
+export function applyHead(data, n) {
+    if (Array.isArray(data))
+        return data.slice(0, n);
+    return data;
+}
+export function formatOutput(data, options = {}) {
+    if (options.raw) {
+        return {
+            stdout: `${typeof data === 'string' ? data : JSON.stringify(data)}\n`,
+            stderr: '',
+        };
+    }
+    let value = parseJsonStringIfPossible(data);
+    if (options.head !== undefined)
+        value = applyHead(value, options.head);
+    if (typeof value === 'string') {
+        return { stdout: `${value}\n`, stderr: '' };
+    }
+    return {
+        stdout: `${JSON.stringify(value, null, options.pretty ? 2 : 0)}\n`,
+        stderr: '',
+    };
+}
+function parseJsonStringIfPossible(data) {
+    if (typeof data !== 'string')
+        return data;
+    try {
+        return JSON.parse(data);
+    }
+    catch {
+        return data;
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/core/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/core/output.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,SAAS,CAAI,IAAO,EAAE,CAAS;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAM,CAAC;IACtD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAa,EAAE,OAAO,GAAkB,EAAE;IACrE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,OAAO;YACL,MAAM,EAAE,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI;YACrE,MAAM,EAAE,EAAE;SACX,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;QAClE,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,IAAa;IAC9C,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/core/secrets.d.ts

@@ -0,0 +1 @@
+export declare function resolveSecret(value: string): Promise<string>;

package/dist/core/secrets.js

@@ -0,0 +1,21 @@
+import { readFile } from 'node:fs/promises';
+export async function resolveSecret(value) {
+    if (value.startsWith('env:')) {
+        const name = value.slice(4);
+        const resolved = process.env[name];
+        if (resolved === undefined)
+            throw new Error(`environment variable ${JSON.stringify(name)} is not set`);
+        return resolved;
+    }
+    if (value.startsWith('file:')) {
+        const path = value.slice(5);
+        try {
+            return (await readFile(path, 'utf8')).replace(/\n$/, '');
+        }
+        catch {
+            throw new Error(`secret file not found: ${path}`);
+        }
+    }
+    return value;
+}
+//# sourceMappingURL=secrets.js.map

package/dist/core/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../../src/core/secrets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAa;IAC/C,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,QAAQ,KAAK,SAAS;YACxB,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7E,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}