kiokuko-dsh 0.1.0

package/dist/skills/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/skills/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGpD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiD;IACnE,SAAS,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;CAQjM"}

package/dist/skills/cache.js

@@ -0,0 +1,19 @@
+import { cacheKey } from './providers/schema.js';
+export class SkillDiscoveryCache {
+    flights = new Map();
+    async getOrLoad(input) {
+        const key = cacheKey(input);
+        const existingFlight = this.flights.get(key);
+        if (existingFlight)
+            return { result: await existingFlight, hit: true };
+        const flight = input.loader();
+        this.flights.set(key, flight);
+        try {
+            return { result: await flight, hit: false };
+        }
+        finally {
+            this.flights.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/skills/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/skills/cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,OAAO,mBAAmB;IACb,OAAO,GAAG,IAAI,GAAG,EAAsC,CAAC;IACzE,KAAK,CAAC,SAAS,CAAC,KAAyH;QACvI,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,cAAc;YAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QACvE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC;YAAC,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;QAAC,CAAC;gBAAS,CAAC;YAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;IAC5F,CAAC;CACF"}

package/dist/skills/candidate-ranking.d.ts

@@ -0,0 +1,15 @@
+import type { SkillCandidate, SkillRequirement } from './types.js';
+import type { TaskProfile } from '../akinator/types.js';
+export interface RankedSkillCandidate {
+    candidate: SkillCandidate;
+    score: number;
+    reasons: string[];
+}
+export declare function rankSkillCandidates(input: {
+    candidates: SkillCandidate[];
+    requirement: SkillRequirement;
+    task: string;
+    profile: TaskProfile;
+    mode?: 'official' | 'community';
+}): RankedSkillCandidate[];
+//# sourceMappingURL=candidate-ranking.d.ts.map

package/dist/skills/candidate-ranking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-ranking.d.ts","sourceRoot":"","sources":["../../src/skills/candidate-ranking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,cAAc,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAmBD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IAAE,UAAU,EAAE,cAAc,EAAE,CAAC;IAAC,WAAW,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAC;IAAC,IAAI,CAAC,EAAE,UAAU,GAAG,WAAW,CAAA;CAAE,GAAG,oBAAoB,EAAE,CA4BvM"}

package/dist/skills/candidate-ranking.js

@@ -0,0 +1,52 @@
+import { compareCanonicalStrings } from '../serialization/validate.js';
+function norm(value) { return value.normalize('NFKC').toLowerCase(); }
+const GENERIC_CANDIDATE_TOKENS = new Set(['best', 'code', 'guide', 'guidance', 'helper', 'practice', 'practices', 'skill', 'tools', 'writer']);
+function tokens(value) {
+    return new Set((norm(value).match(/[\p{L}\p{N}][\p{L}\p{N}.-]*/gu) ?? [])
+        .flatMap((token) => token.split(/[.-]/u))
+        .filter((token) => token.length > 2));
+}
+function isTaskRelevant(candidate, requirement, task, profile) {
+    const scopeTokens = tokens([task, profile.target ?? '', profile.expected ?? '', profile.constraints ?? ''].join(' '));
+    const requirementTokens = tokens([requirement.id, requirement.technology, ...requirement.aliases].join(' '));
+    const candidateTokens = tokens(`${candidate.name} ${candidate.slug}`);
+    return [...candidateTokens].some((token) => !requirementTokens.has(token) && !GENERIC_CANDIDATE_TOKENS.has(token) && scopeTokens.has(token));
+}
+export function rankSkillCandidates(input) {
+    return input.candidates.map((candidate) => {
+        const reasons = [];
+        const source = norm(candidate.source);
+        const exactRepository = input.requirement.repositories.some((repository) => norm(repository) === source);
+        const ownerMatch = input.requirement.owners.some((owner) => source.startsWith(`${norm(owner)}/`));
+        const exactTechnology = [candidate.name, candidate.slug].some((value) => input.requirement.aliases.some((alias) => norm(value) === norm(alias)));
+        const taskRelevance = isTaskRelevant(candidate, input.requirement, input.task, input.profile);
+        if (exactRepository)
+            reasons.push('exact_repository');
+        if (candidate.officialStatus === 'curated')
+            reasons.push('curated_first_party');
+        if (candidate.officialStatus === 'catalog-verified')
+            reasons.push('catalog_verified');
+        if (ownerMatch || candidate.officialStatus === 'owner-verified')
+            reasons.push('official_owner');
+        if (exactTechnology)
+            reasons.push('exact_technology');
+        if (taskRelevance)
+            reasons.push('task_relevance');
+        if (candidate.auditStatus === 'passed')
+            reasons.push('audit_passed');
+        if (!candidate.duplicate)
+            reasons.push('not_duplicate');
+        const score = (exactRepository ? 1000 : 0)
+            + (candidate.officialStatus === 'curated' ? 800 : 0)
+            + (candidate.officialStatus === 'catalog-verified' ? 750 : 0)
+            + (ownerMatch || candidate.officialStatus === 'owner-verified' ? 600 : 0)
+            + (exactTechnology ? 300 : 0)
+            + (taskRelevance ? 100 : 0)
+            + (candidate.auditStatus === 'passed' ? 50 : 0)
+            + (candidate.duplicate ? -1000 : 0)
+            + Math.log1p(Math.max(0, candidate.installs));
+        return { candidate, score, reasons };
+    }).filter((item) => input.mode === 'community' || ['curated', 'catalog-verified', 'owner-verified'].includes(item.candidate.officialStatus))
+        .sort((left, right) => right.score - left.score || compareCanonicalStrings(left.candidate.id, right.candidate.id));
+}
+//# sourceMappingURL=candidate-ranking.js.map

package/dist/skills/candidate-ranking.js.map

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

package/dist/skills/chunking.d.ts

@@ -0,0 +1,11 @@
+import type { PreparedSkillDocument } from './types.js';
+export declare const MAX_SKILL_CHUNK_CHARS = 8000;
+export declare const MAX_SKILL_CHUNKS = 64;
+export declare function chunkSkillMarkdown(input: {
+    skillName: string;
+    sourcePath: string;
+    markdown: string;
+    summary?: string | null;
+    stripFrontmatter: boolean;
+}): PreparedSkillDocument[];
+//# sourceMappingURL=chunking.d.ts.map

package/dist/skills/chunking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunking.d.ts","sourceRoot":"","sources":["../../src/skills/chunking.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,eAAO,MAAM,qBAAqB,OAAQ,CAAC;AAC3C,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAoQnC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAA;CAAE,GAAG,qBAAqB,EAAE,CAuBlL"}

package/dist/skills/chunking.js

@@ -0,0 +1,291 @@
+import { canonicalContentHash } from '../serialization/validate.js';
+import { skillSourceFailure } from './source/errors.js';
+export const MAX_SKILL_CHUNK_CHARS = 8_000;
+export const MAX_SKILL_CHUNKS = 64;
+const MAX_HEADING_COMPONENT_CHARS = 200;
+const HEADING_SEPARATOR = ' › ';
+const INVALID_UNICODE = /[\p{Cs}\uFFFD]/u;
+function codePointLength(value) {
+    return Array.from(value).length;
+}
+function validateInputText(value, identity = false) {
+    if (typeof value !== 'string'
+        || INVALID_UNICODE.test(value)
+        || identity && (value.length === 0 || value !== value.trim() || /[\p{Cc}\p{Cf}]/u.test(value))) {
+        skillSourceFailure('skill_validation_failed');
+    }
+}
+function withoutSkillFrontmatter(markdown, stripFrontmatter) {
+    if (!stripFrontmatter)
+        return markdown;
+    const match = /^---\r?\n(?<frontmatter>[\s\S]*?)\r?\n---(?:\r?\n|$)/u.exec(markdown);
+    if (!match?.groups?.frontmatter || !/^\s*name\s*:/mu.test(match.groups.frontmatter))
+        skillSourceFailure('skill_validation_failed');
+    return markdown.slice(match[0].length);
+}
+function sourceLines(value) {
+    const lines = [];
+    let start = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        const character = value[index];
+        if (character !== '\n' && character !== '\r')
+            continue;
+        const ending = character === '\r' && value[index + 1] === '\n' ? '\r\n' : character;
+        const content = value.slice(start, index);
+        lines.push({ content, ending, raw: `${content}${ending}` });
+        if (ending.length === 2)
+            index += 1;
+        start = index + 1;
+    }
+    if (start < value.length) {
+        const content = value.slice(start);
+        lines.push({ content, ending: '', raw: content });
+    }
+    return lines;
+}
+function openingFence(line) {
+    // CommonMark allows at most three literal spaces before a fence marker.
+    const match = /^ {0,3}(?<marker>`{3,}|~{3,})(?<info>.*)$/u.exec(line);
+    const marker = match?.groups?.marker;
+    if (!marker)
+        return null;
+    const character = marker[0];
+    if (character === '`' && (match.groups?.info ?? '').includes('`'))
+        return null;
+    return { character, length: marker.length };
+}
+function closesFence(line, fence) {
+    const match = /^ {0,3}(?<marker>`+|~+)[ \t]*$/u.exec(line);
+    const marker = match?.groups?.marker;
+    return marker !== undefined && marker[0] === fence.character && marker.length >= fence.length;
+}
+function hasUnsupportedContainerFence(line) {
+    let remaining = line;
+    let container = false;
+    while (true) {
+        const quote = /^ {0,3}>[ \t]?/u.exec(remaining);
+        if (quote !== null) {
+            remaining = remaining.slice(quote[0].length);
+            container = true;
+            continue;
+        }
+        const list = /^ {0,3}(?:[*+-]|\d{1,9}[.)])[ \t]+/u.exec(remaining);
+        if (list !== null) {
+            remaining = remaining.slice(list[0].length);
+            container = true;
+            continue;
+        }
+        break;
+    }
+    return container && /^[ \t]*(?:`{3,}|~{3,})/u.test(remaining);
+}
+function startsListItem(line) {
+    return /^ {0,3}(?:[*+-]|\d{1,9}[.)])(?:[ \t]+|$)/u.test(line);
+}
+function hasAmbiguousListFence(line) {
+    let column = 0;
+    let index = 0;
+    while (index < line.length) {
+        if (line[index] === ' ')
+            column += 1;
+        else if (line[index] === '\t')
+            column += 4 - (column % 4);
+        else
+            break;
+        index += 1;
+    }
+    if (column < 4)
+        return false;
+    const content = line.slice(index);
+    return /^(?:`{3,}|~{3,})/u.test(content) || hasUnsupportedContainerFence(content);
+}
+function heading(line) {
+    const match = /^ {0,3}(?<marker>#{1,6})(?:[ \t]+(?<text>.*)|[ \t]*)$/u.exec(line);
+    const marker = match?.groups?.marker;
+    if (!marker)
+        return null;
+    const text = (match.groups?.text ?? '')
+        .replace(/[ \t]+#+[ \t]*$/u, '')
+        .trim();
+    if (text.length === 0)
+        skillSourceFailure('skill_validation_failed');
+    if (codePointLength(text) > MAX_HEADING_COMPONENT_CHARS)
+        skillSourceFailure('skill_too_large');
+    return { level: marker.length, text };
+}
+function hierarchyTitle(hierarchy) {
+    return hierarchy.length === 0 ? 'Overview' : hierarchy.join(HEADING_SEPARATOR);
+}
+function sections(markdown) {
+    if (markdown.trim().length === 0)
+        skillSourceFailure('skill_validation_failed');
+    const output = [];
+    const headingStack = [];
+    let hierarchy = [];
+    let body = [];
+    let startsWithHeading = false;
+    let fence = null;
+    let possibleListContext = false;
+    const flush = () => {
+        if (body.length > 0)
+            output.push({ hierarchy: [...hierarchy], body: body.join(''), startsWithHeading });
+        body = [];
+        startsWithHeading = false;
+    };
+    for (const line of sourceLines(markdown)) {
+        // A container-aware parser is required to prove that these blocks stay
+        // indivisible. Reject them instead of treating their markers as prose.
+        if (fence === null && hasUnsupportedContainerFence(line.content)) {
+            skillSourceFailure('skill_validation_failed');
+        }
+        // Four-or-more spaces are root-level indented code, but can be a fenced
+        // block relative to an earlier list marker. Without a full list parser the
+        // construct stays ambiguous after list syntax appears, so reject it.
+        if (fence === null && possibleListContext && hasAmbiguousListFence(line.content)) {
+            skillSourceFailure('skill_validation_failed');
+        }
+        const nextHeading = fence === null ? heading(line.content) : null;
+        if (nextHeading !== null) {
+            flush();
+            headingStack.length = nextHeading.level;
+            headingStack[nextHeading.level - 1] = nextHeading.text;
+            hierarchy = headingStack.filter((value) => value !== undefined);
+            body.push(line.raw);
+            startsWithHeading = true;
+            continue;
+        }
+        body.push(line.raw);
+        if (fence === null) {
+            if (startsListItem(line.content))
+                possibleListContext = true;
+            fence = openingFence(line.content);
+        }
+        else if (closesFence(line.content, fence)) {
+            fence = null;
+        }
+    }
+    if (fence !== null)
+        skillSourceFailure('skill_validation_failed');
+    flush();
+    if (output.map((section) => section.body).join('') !== markdown)
+        skillSourceFailure('skill_validation_failed');
+    return output;
+}
+function preferredBoundary(value, limit) {
+    const whitespace = value.slice(0, limit).lastIndexOf(' ');
+    return whitespace >= Math.floor(limit / 2) ? whitespace + 1 : limit;
+}
+function splitPlainLine(line, limit) {
+    const content = Array.from(line.content);
+    const ending = Array.from(line.ending);
+    if (ending.length > limit)
+        skillSourceFailure('skill_too_large');
+    const parts = [];
+    let remaining = content;
+    while (remaining.length + ending.length > limit) {
+        let boundary;
+        if (remaining.length > limit) {
+            boundary = preferredBoundary(remaining, limit);
+        }
+        else {
+            boundary = remaining.length;
+        }
+        if (boundary < 1 || boundary > limit)
+            skillSourceFailure('skill_too_large');
+        parts.push(remaining.slice(0, boundary).join(''));
+        remaining = remaining.slice(boundary);
+    }
+    const finalPart = `${remaining.join('')}${line.ending}`;
+    if (finalPart.length > 0)
+        parts.push(finalPart);
+    if (parts.join('') !== line.raw || parts.some((part) => codePointLength(part) > limit)) {
+        skillSourceFailure('skill_validation_failed');
+    }
+    return parts;
+}
+function splitSection(section, limit) {
+    if (limit < 1)
+        skillSourceFailure('skill_too_large');
+    if (codePointLength(section.body) <= limit)
+        return [section.body];
+    const parts = [];
+    const lines = sourceLines(section.body);
+    let current = '';
+    const flush = () => {
+        if (current.length > 0)
+            parts.push(current);
+        current = '';
+    };
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index];
+        const fence = openingFence(line.content);
+        if (fence !== null) {
+            flush();
+            let block = line.raw;
+            let closed = false;
+            while (++index < lines.length) {
+                const next = lines[index];
+                block += next.raw;
+                if (closesFence(next.content, fence)) {
+                    closed = true;
+                    break;
+                }
+            }
+            if (!closed)
+                skillSourceFailure('skill_validation_failed');
+            if (codePointLength(block) > limit)
+                skillSourceFailure('skill_too_large');
+            parts.push(block);
+            continue;
+        }
+        if (section.startsWithHeading && index === 0 && codePointLength(line.raw) > limit) {
+            skillSourceFailure('skill_too_large');
+        }
+        if (codePointLength(current) + codePointLength(line.raw) <= limit) {
+            current += line.raw;
+            continue;
+        }
+        flush();
+        if (codePointLength(line.raw) <= limit) {
+            current = line.raw;
+            continue;
+        }
+        const lineParts = splitPlainLine(line, limit);
+        parts.push(...lineParts.slice(0, -1));
+        current = lineParts.at(-1) ?? '';
+    }
+    flush();
+    if (parts.join('') !== section.body || parts.some((part) => codePointLength(part) > limit)) {
+        skillSourceFailure('skill_validation_failed');
+    }
+    return parts;
+}
+export function chunkSkillMarkdown(input) {
+    validateInputText(input.skillName, true);
+    validateInputText(input.sourcePath, true);
+    validateInputText(input.markdown);
+    if (input.summary !== undefined && input.summary !== null)
+        validateInputText(input.summary);
+    if (typeof input.stripFrontmatter !== 'boolean')
+        skillSourceFailure('skill_validation_failed');
+    const markdown = withoutSkillFrontmatter(input.markdown, input.stripFrontmatter);
+    const result = [];
+    for (const section of sections(markdown)) {
+        const title = `${input.skillName} — ${hierarchyTitle(section.hierarchy)}`;
+        const bodyLimit = MAX_SKILL_CHUNK_CHARS - codePointLength(title) - 2;
+        for (const body of splitSection(section, bodyLimit)) {
+            const content = `${title}\n\n${body}`;
+            if (codePointLength(content) > MAX_SKILL_CHUNK_CHARS)
+                skillSourceFailure('skill_too_large');
+            result.push({ sourcePath: input.sourcePath, chunkIndex: result.length, title, body: content, summary: input.summary ?? null, contentHash: canonicalContentHash({ title, body: content, sourcePath: input.sourcePath }), primary: result.length === 0 });
+        }
+    }
+    // Removing each exact `${title}\n\n` prefix and joining by chunkIndex must
+    // reproduce the post-frontmatter Markdown byte-for-byte.
+    if (result.length === 0)
+        skillSourceFailure('skill_validation_failed');
+    if (result.length > MAX_SKILL_CHUNKS)
+        skillSourceFailure('skill_too_large');
+    return result.map((item, index) => ({ ...item, chunkIndex: index, primary: index === 0 }));
+}
+//# sourceMappingURL=chunking.js.map

package/dist/skills/chunking.js.map

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

package/dist/skills/config.d.ts

@@ -0,0 +1,19 @@
+import type { SkillDiscoveryMode } from './types.js';
+export declare const SKILL_DISCOVERY_ENV = "KIOKUKO_SKILL_DISCOVERY";
+export declare const MAX_BEARER_TOKEN_CHARS = 4096;
+/** RFC 6750 b64token characters, bounded to keep header construction predictable. */
+export declare function isBearerToken(value: unknown): value is string;
+/** Authenticated registry traffic is never sent to a configurable or local origin. */
+export declare function isTrustedSkillsShApiUrl(value: string): boolean;
+/** Parse only positive delta-seconds or canonical IMF-fixdate HTTP dates. */
+export declare function parseRetryAfterSeconds(value: string | null, now?: number): number | null;
+export declare function isSkillDiscoveryMode(value: unknown): value is SkillDiscoveryMode;
+export declare function normalizeSkillDiscoveryMode(value: unknown): SkillDiscoveryMode;
+export interface SkillDiscoveryConfig {
+    mode: SkillDiscoveryMode;
+    apiUrl: string;
+    v1Token: string | null;
+    githubToken: string | null;
+}
+export declare function readSkillDiscoveryConfig(env?: NodeJS.ProcessEnv): SkillDiscoveryConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/skills/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/skills/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGrD,eAAO,MAAM,mBAAmB,4BAA4B,CAAC;AAC7D,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAI5C,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAK7D;AAED,sFAAsF;AACtF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAe9D;AAED,6EAA6E;AAC7E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,SAAa,GAAG,MAAM,GAAG,IAAI,CAU5F;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAI9E;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAiCD,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,oBAAoB,CAYnG"}

package/dist/skills/config.js

@@ -0,0 +1,103 @@
+import { KiokukoError } from '../errors.js';
+export const SKILL_DISCOVERY_ENV = 'KIOKUKO_SKILL_DISCOVERY';
+export const MAX_BEARER_TOKEN_CHARS = 4_096;
+const BEARER_TOKEN = /^[A-Za-z0-9\-._~+/]+=*$/u;
+const TRUSTED_SKILLS_SH_ORIGIN = 'https://skills.sh';
+/** RFC 6750 b64token characters, bounded to keep header construction predictable. */
+export function isBearerToken(value) {
+    return typeof value === 'string'
+        && value.length >= 1
+        && value.length <= MAX_BEARER_TOKEN_CHARS
+        && BEARER_TOKEN.test(value);
+}
+/** Authenticated registry traffic is never sent to a configurable or local origin. */
+export function isTrustedSkillsShApiUrl(value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch (error) {
+        if (error instanceof TypeError)
+            return false;
+        throw error;
+    }
+    return url.origin === TRUSTED_SKILLS_SH_ORIGIN
+        && url.protocol === 'https:'
+        && !url.port
+        && !url.username
+        && !url.password
+        && !url.hash
+        && !url.search
+        && url.pathname === '/';
+}
+/** Parse only positive delta-seconds or canonical IMF-fixdate HTTP dates. */
+export function parseRetryAfterSeconds(value, now = Date.now()) {
+    if (value === null)
+        return null;
+    if (/^\d+$/u.test(value)) {
+        const seconds = Number(value);
+        return Number.isSafeInteger(seconds) && seconds > 0 ? seconds : null;
+    }
+    const timestamp = Date.parse(value);
+    if (!Number.isFinite(timestamp) || new Date(timestamp).toUTCString() !== value)
+        return null;
+    const seconds = Math.ceil((timestamp - now) / 1_000);
+    return seconds > 0 ? seconds : null;
+}
+export function isSkillDiscoveryMode(value) {
+    return value === 'off' || value === 'official' || value === 'community';
+}
+export function normalizeSkillDiscoveryMode(value) {
+    if (value === undefined)
+        return 'official';
+    if (isSkillDiscoveryMode(value))
+        return value;
+    throw new KiokukoError('VALIDATION_ERROR', `${SKILL_DISCOVERY_ENV} must be off, official, or community`);
+}
+function normalizeApiUrl(value) {
+    if (value !== undefined && value.trim().length === 0) {
+        throw new KiokukoError('VALIDATION_ERROR', 'KIOKUKO_SKILLS_API_URL must not be empty when set');
+    }
+    const apiUrl = value ?? 'https://skills.sh';
+    if (apiUrl !== apiUrl.trim())
+        throw new KiokukoError('VALIDATION_ERROR', 'KIOKUKO_SKILLS_API_URL is invalid');
+    let parsed;
+    try {
+        parsed = new URL(apiUrl);
+    }
+    catch {
+        throw new KiokukoError('VALIDATION_ERROR', 'KIOKUKO_SKILLS_API_URL is invalid');
+    }
+    const allowedProtocol = parsed.protocol === 'https:'
+        || parsed.protocol === 'http:' && ['localhost', '127.0.0.1'].includes(parsed.hostname);
+    if (!allowedProtocol
+        || parsed.username
+        || parsed.password
+        || parsed.hash
+        || parsed.search
+        || parsed.pathname !== '/') {
+        throw new KiokukoError('VALIDATION_ERROR', 'KIOKUKO_SKILLS_API_URL is invalid');
+    }
+    return apiUrl;
+}
+function normalizeOptionalToken(value, name) {
+    if (value === undefined)
+        return null;
+    if (!isBearerToken(value))
+        throw new KiokukoError('VALIDATION_ERROR', `${name} is invalid`);
+    return value;
+}
+export function readSkillDiscoveryConfig(env = process.env) {
+    const apiUrl = normalizeApiUrl(env.KIOKUKO_SKILLS_API_URL);
+    const v1Token = normalizeOptionalToken(env.KIOKUKO_SKILLS_V1_TOKEN, 'KIOKUKO_SKILLS_V1_TOKEN');
+    if (v1Token !== null && !isTrustedSkillsShApiUrl(apiUrl)) {
+        throw new KiokukoError('VALIDATION_ERROR', 'KIOKUKO_SKILLS_API_URL is invalid for authenticated discovery');
+    }
+    return {
+        mode: normalizeSkillDiscoveryMode(env[SKILL_DISCOVERY_ENV]),
+        apiUrl,
+        v1Token,
+        githubToken: normalizeOptionalToken(env.KIOKUKO_GITHUB_TOKEN, 'KIOKUKO_GITHUB_TOKEN'),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/skills/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/skills/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,CAAC,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;AAC7D,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AAC5C,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAChD,MAAM,wBAAwB,GAAG,mBAAmB,CAAC;AAErD,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ;WAC3B,KAAK,CAAC,MAAM,IAAI,CAAC;WACjB,KAAK,CAAC,MAAM,IAAI,sBAAsB;WACtC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QAAC,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC;IAC7B,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,YAAY,SAAS;YAAE,OAAO,KAAK,CAAC;QAC7C,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,KAAK,wBAAwB;WACzC,GAAG,CAAC,QAAQ,KAAK,QAAQ;WACzB,CAAC,GAAG,CAAC,IAAI;WACT,CAAC,GAAG,CAAC,QAAQ;WACb,CAAC,GAAG,CAAC,QAAQ;WACb,CAAC,GAAG,CAAC,IAAI;WACT,CAAC,GAAG,CAAC,MAAM;WACX,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC;AAC5B,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,sBAAsB,CAAC,KAAoB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAC3E,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC5F,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACrD,OAAO,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,WAAW,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IAC3C,IAAI,oBAAoB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,GAAG,mBAAmB,sCAAsC,CAAC,CAAC;AAC3G,CAAC;AASD,SAAS,eAAe,CAAC,KAAyB;IAChD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,mDAAmD,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,IAAI,mBAAmB,CAAC;IAC5C,IAAI,MAAM,KAAK,MAAM,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,mCAAmC,CAAC,CAAC;IAC9G,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,mCAAmC,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,KAAK,QAAQ;WAC/C,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzF,IAAI,CAAC,eAAe;WACf,MAAM,CAAC,QAAQ;WACf,MAAM,CAAC,QAAQ;WACf,MAAM,CAAC,IAAI;WACX,MAAM,CAAC,MAAM;WACb,MAAM,CAAC,QAAQ,KAAK,GAAG,EAAE,CAAC;QAC7B,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,mCAAmC,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAyB,EAAE,IAAY;IACrE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,GAAG,IAAI,aAAa,CAAC,CAAC;IAC5F,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC3E,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,sBAAsB,CAAC,GAAG,CAAC,uBAAuB,EAAE,yBAAyB,CAAC,CAAC;IAC/F,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,+DAA+D,CAAC,CAAC;IAC9G,CAAC;IACD,OAAO;QACL,IAAI,EAAE,2BAA2B,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAC3D,MAAM;QACN,OAAO;QACP,WAAW,EAAE,sBAAsB,CAAC,GAAG,CAAC,oBAAoB,EAAE,sBAAsB,CAAC;KACtF,CAAC;AACJ,CAAC"}

package/dist/skills/discovery-service.d.ts

@@ -0,0 +1,26 @@
+import { SkillDiscoveryCache } from './cache.js';
+import type { DiscoverSkillsInput, SkillDiscoverySummary, SkillRegistryProvider, SkillSourceFetcher } from './types.js';
+import type { SqliteDatabase } from '../db/adapter.js';
+export interface SkillDiscoveryDependencies {
+    provider?: SkillRegistryProvider;
+    sourceFetcher?: SkillSourceFetcher;
+    cache?: SkillDiscoveryCache;
+    fetchImpl?: typeof fetch;
+    now?: () => string;
+    /** Revalidate caller-owned state inside the import write transaction. */
+    assertBeforePersist?: () => void;
+}
+export declare class SkillDiscoveryService {
+    private readonly cache;
+    private readonly provider;
+    private readonly sourceFetcher;
+    private readonly sourceFlights;
+    private readonly now;
+    private readonly assertBeforePersist;
+    constructor(dependencies?: SkillDiscoveryDependencies);
+    private fetchSnapshot;
+    private searchWithCache;
+    discover(database: SqliteDatabase, input: DiscoverSkillsInput, modeOverride?: DiscoverSkillsInput['mode']): Promise<SkillDiscoverySummary>;
+}
+export declare function discoverSkills(database: SqliteDatabase, input: DiscoverSkillsInput, dependencies?: SkillDiscoveryDependencies): Promise<SkillDiscoverySummary>;
+//# sourceMappingURL=discovery-service.d.ts.map

package/dist/skills/discovery-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-service.d.ts","sourceRoot":"","sources":["../../src/skills/discovery-service.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIjD,OAAO,KAAK,EAAE,mBAAmB,EAA2D,qBAAqB,EAAuD,qBAAqB,EAAoC,kBAAkB,EAA2B,MAAM,YAAY,CAAC;AACjS,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAWvD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;CAClC;AAiQD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgF;IAC9G,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA2B;gBACnD,YAAY,GAAE,0BAA+B;YAS3C,aAAa;YAWb,eAAe;IAmEvB,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAAY,CAAC,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAghBjJ;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAAY,GAAE,0BAA+B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAKxK"}