@askdkc/kiokuko 0.1.16 → 0.1.19

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":"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"}

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;AAgQD,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;YAUb,eAAe;IAkEvB,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAAY,CAAC,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC;CA6gBjJ;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAAY,GAAE,0BAA+B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAKxK"}