kiokuko-dsh 0.1.0

package/dist/skills/providers/skills-sh-v1.js

@@ -0,0 +1,152 @@
+import { parseSkillsShV1AuditResponse, parseSkillsShV1CuratedResponse, parseSkillsShV1SearchResponse, readSkillProviderJson, SkillProviderError, verifiedOfficialRepositories } from './schema.js';
+import { validateSkillSearchScope } from '../query-builder.js';
+import { SkillSourceError } from '../source/errors.js';
+import { validateSkillCandidate } from '../source/snapshot-validator.js';
+import { isBearerToken, isTrustedSkillsShApiUrl, parseRetryAfterSeconds } from '../config.js';
+import { isExternalFetchFailure } from '../external-transport.js';
+function retryAfter(response) {
+    return parseRetryAfterSeconds(response.headers.get('retry-after'));
+}
+function providerUrl(value) {
+    if (!isTrustedSkillsShApiUrl(value))
+        throw new Error('skills.sh URL is invalid');
+    return new URL(value);
+}
+function responseFailure(response) {
+    if (response.status === 401)
+        return new SkillProviderError('registry_authentication_failed');
+    if (response.status === 429)
+        return new SkillProviderError('registry_rate_limited', retryAfter(response));
+    return new SkillProviderError('registry_unavailable');
+}
+export class SkillsShV1Provider {
+    id = 'skills-sh-v1';
+    authenticationFallback;
+    apiUrl;
+    #token;
+    fetchImpl;
+    timeoutMs;
+    officialRepositories;
+    constructor(options) {
+        const url = providerUrl(options.apiUrl ?? 'https://skills.sh');
+        if (!isBearerToken(options.token))
+            throw new Error('skills.sh token is invalid');
+        this.apiUrl = url;
+        this.#token = options.token;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+        this.timeoutMs = options.timeoutMs ?? 5_000;
+        this.officialRepositories = verifiedOfficialRepositories(options.officialRepositories ?? []);
+        if (!Number.isSafeInteger(this.timeoutMs) || this.timeoutMs < 1 || this.timeoutMs > 60_000)
+            throw new Error('skills.sh timeout is invalid');
+        if (options.authenticationFallback !== undefined)
+            this.authenticationFallback = options.authenticationFallback;
+    }
+    async search(input) {
+        const { query, owner } = validateSkillSearchScope(input.query, input.owner);
+        if (!Number.isSafeInteger(input.limit) || input.limit < 1 || input.limit > 20)
+            throw new SkillProviderError('registry_invalid_response');
+        const controller = new AbortController();
+        const onAbort = () => controller.abort(input.signal?.reason);
+        if (input.signal?.aborted)
+            controller.abort(input.signal.reason);
+        else
+            input.signal?.addEventListener('abort', onAbort, { once: true });
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        const url = new URL('/api/v1/skills/search', this.apiUrl);
+        url.searchParams.set('q', query);
+        url.searchParams.set('limit', String(input.limit));
+        if (owner)
+            url.searchParams.set('owner', owner);
+        try {
+            const response = await this.fetchImpl(url, { redirect: 'manual', headers: { accept: 'application/json', authorization: `Bearer ${this.#token}`, 'user-agent': 'kiokuko-skill-discovery' }, signal: controller.signal });
+            if (response.status !== 200)
+                throw responseFailure(response);
+            const body = await readSkillProviderJson(response);
+            return { provider: this.id, experimental: false, candidates: parseSkillsShV1SearchResponse(body, this.id, { query, limit: input.limit }, this.officialRepositories) };
+        }
+        catch (error) {
+            if (error instanceof SkillProviderError)
+                throw error;
+            if (input.signal?.aborted)
+                throw input.signal.reason;
+            if (isExternalFetchFailure(error))
+                throw new SkillProviderError('registry_unavailable');
+            throw error;
+        }
+        finally {
+            clearTimeout(timer);
+            input.signal?.removeEventListener('abort', onAbort);
+        }
+    }
+    async curated(signal) {
+        const controller = new AbortController();
+        const onAbort = () => controller.abort(signal?.reason);
+        if (signal?.aborted)
+            controller.abort(signal.reason);
+        else
+            signal?.addEventListener('abort', onAbort, { once: true });
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        const url = new URL('/api/v1/skills/curated', this.apiUrl);
+        try {
+            const response = await this.fetchImpl(url, { redirect: 'manual', headers: { accept: 'application/json', authorization: `Bearer ${this.#token}`, 'user-agent': 'kiokuko-skill-discovery' }, signal: controller.signal });
+            if (response.status !== 200)
+                throw responseFailure(response);
+            return parseSkillsShV1CuratedResponse(await readSkillProviderJson(response), this.id, this.officialRepositories);
+        }
+        catch (error) {
+            if (error instanceof SkillProviderError)
+                throw error;
+            if (signal?.aborted)
+                throw signal.reason;
+            if (isExternalFetchFailure(error))
+                throw new SkillProviderError('registry_unavailable');
+            throw error;
+        }
+        finally {
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', onAbort);
+        }
+    }
+    async audit(candidate, signal) {
+        let validatedCandidate;
+        try {
+            validatedCandidate = validateSkillCandidate(candidate);
+        }
+        catch (error) {
+            if (error instanceof SkillSourceError)
+                throw new SkillProviderError('registry_invalid_response');
+            throw error;
+        }
+        const source = validatedCandidate.source;
+        const path = `/api/v1/skills/audit/${[source, validatedCandidate.slug].join('/').split('/').map(encodeURIComponent).join('/')}`;
+        const controller = new AbortController();
+        const onAbort = () => controller.abort(signal?.reason);
+        if (signal?.aborted)
+            controller.abort(signal.reason);
+        else
+            signal?.addEventListener('abort', onAbort, { once: true });
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        const url = new URL(path, this.apiUrl);
+        try {
+            const response = await this.fetchImpl(url, { redirect: 'manual', headers: { accept: 'application/json', authorization: `Bearer ${this.#token}`, 'user-agent': 'kiokuko-skill-discovery' }, signal: controller.signal });
+            if (response.status !== 200)
+                throw responseFailure(response);
+            const body = await readSkillProviderJson(response);
+            return parseSkillsShV1AuditResponse(body, { source, slug: validatedCandidate.slug });
+        }
+        catch (error) {
+            if (error instanceof SkillProviderError)
+                throw error;
+            if (signal?.aborted)
+                throw signal.reason;
+            if (isExternalFetchFailure(error))
+                throw new SkillProviderError('registry_unavailable');
+            throw error;
+        }
+        finally {
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', onAbort);
+        }
+    }
+}
+//# sourceMappingURL=skills-sh-v1.js.map

package/dist/skills/providers/skills-sh-v1.js.map

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

package/dist/skills/query-builder.d.ts

@@ -0,0 +1,18 @@
+import type { TaskProfile } from '../akinator/types.js';
+import type { SkillRequirement } from './types.js';
+export declare const MAX_QUERIES_PER_TASK = 3;
+export declare const MAX_QUERY_CHARS = 80;
+export declare const MIN_QUERY_CHARS = 2;
+export declare const MAX_SEARCH_RESULTS = 20;
+export declare function buildSkillQueries(input: {
+    requirements: SkillRequirement[];
+    profile?: TaskProfile;
+    mode?: 'official' | 'community';
+}): string[];
+export declare function validateSkillQuery(value: unknown): string;
+export declare function validateSkillOwner(value: unknown): string;
+export declare function validateSkillSearchScope(queryValue: unknown, ownerValue?: unknown): {
+    query: string;
+    owner?: string;
+};
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/skills/query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../../src/skills/query-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAuCrC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAAC,IAAI,CAAC,EAAE,UAAU,GAAG,WAAW,CAAA;CAAE,GAAG,MAAM,EAAE,CAW/I;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQzD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOzD;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAUrH"}

package/dist/skills/query-builder.js

@@ -0,0 +1,93 @@
+import { KiokukoError } from '../errors.js';
+import { findSecret } from '../memory/secrets.js';
+import { OFFICIAL_TECHNOLOGIES, technologyDefinition } from './official-catalog.js';
+export const MAX_QUERIES_PER_TASK = 3;
+export const MAX_QUERY_CHARS = 80;
+export const MIN_QUERY_CHARS = 2;
+export const MAX_SEARCH_RESULTS = 20;
+const TASK_SUFFIXES = new Map([
+    ['build', 'testing'],
+    ['debug', 'debug'],
+    ['review', 'review'],
+]);
+function normalize(value) {
+    return value.normalize('NFKC').toLowerCase().replace(/\s+/gu, ' ').trim();
+}
+const CATALOG_QUERIES = new Set(OFFICIAL_TECHNOLOGIES.flatMap((definition) => [definition.id, ...definition.queries]).map(normalize));
+const ALLOWED_QUERIES = new Set([
+    ...CATALOG_QUERIES,
+    ...OFFICIAL_TECHNOLOGIES.flatMap((definition) => [...TASK_SUFFIXES.values()].map((suffix) => `${normalize(definition.id)} ${suffix}`)),
+]);
+const VERIFIED_OWNERS = new Set(OFFICIAL_TECHNOLOGIES.flatMap((definition) => definition.owners).map(normalize));
+function sameNormalizedSet(actual, expected) {
+    const left = [...new Set(actual.map(normalize))].sort();
+    const right = [...new Set(expected.map(normalize))].sort();
+    return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function validatedDefinition(requirement) {
+    const definition = technologyDefinition(normalize(requirement.id));
+    if (definition === undefined
+        || normalize(requirement.technology) !== normalize(definition.id)
+        || !sameNormalizedSet(requirement.queries, definition.queries)
+        || !sameNormalizedSet(requirement.owners, definition.owners)
+        || !sameNormalizedSet(requirement.repositories, definition.repositories)) {
+        throw new KiokukoError('VALIDATION_ERROR', 'Skill requirement is not from the official catalog');
+    }
+    for (const query of requirement.queries)
+        validateSkillQuery(query);
+    for (const owner of requirement.owners)
+        validateSkillOwner(owner);
+    return definition;
+}
+export function buildSkillQueries(input) {
+    const queries = [];
+    for (const requirement of input.requirements) {
+        const definition = validatedDefinition(requirement);
+        for (const query of definition.queries)
+            queries.push(validateSkillQuery(query));
+        const suffix = input.profile?.taskType === null || input.profile?.taskType === undefined
+            ? undefined
+            : TASK_SUFFIXES.get(input.profile.taskType);
+        if (suffix !== undefined)
+            queries.push(validateSkillQuery(`${definition.id} ${suffix}`));
+    }
+    return [...new Set(queries)].slice(0, MAX_QUERIES_PER_TASK);
+}
+export function validateSkillQuery(value) {
+    if (typeof value !== 'string')
+        throw new KiokukoError('VALIDATION_ERROR', 'Skill query is invalid');
+    const secret = findSecret(value);
+    if (secret)
+        throw new KiokukoError('SECURITY_REJECTION', 'Skill query resembles a secret and was not sent', { kind: secret.kind });
+    if (/[\\/]/u.test(value) || value.includes('..'))
+        throw new KiokukoError('VALIDATION_ERROR', 'Skill query is invalid');
+    const query = normalize(value);
+    if (query.length < MIN_QUERY_CHARS || query.length > MAX_QUERY_CHARS || !ALLOWED_QUERIES.has(query))
+        throw new KiokukoError('VALIDATION_ERROR', 'Skill query is invalid');
+    return query;
+}
+export function validateSkillOwner(value) {
+    if (typeof value !== 'string')
+        throw new KiokukoError('VALIDATION_ERROR', 'Skill owner is invalid');
+    const secret = findSecret(value);
+    if (secret)
+        throw new KiokukoError('SECURITY_REJECTION', 'Skill owner resembles a secret and was not sent', { kind: secret.kind });
+    const owner = normalize(value);
+    if (!/^[a-z0-9_.-]{1,100}$/u.test(owner) || owner === '.' || owner === '..' || !VERIFIED_OWNERS.has(owner))
+        throw new KiokukoError('VALIDATION_ERROR', 'Skill owner is invalid');
+    return owner;
+}
+export function validateSkillSearchScope(queryValue, ownerValue) {
+    const query = validateSkillQuery(queryValue);
+    if (ownerValue === undefined)
+        return { query };
+    const owner = validateSkillOwner(ownerValue);
+    const matchingDefinitions = OFFICIAL_TECHNOLOGIES.filter((definition) => {
+        const id = normalize(definition.id);
+        return definition.queries.map(normalize).includes(query) || query === id || [...TASK_SUFFIXES.values()].some((suffix) => query === `${id} ${suffix}`);
+    });
+    if (!matchingDefinitions.some((definition) => definition.owners.map(normalize).includes(owner)))
+        throw new KiokukoError('VALIDATION_ERROR', 'Skill owner is invalid for the query');
+    return { query, owner };
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/skills/query-builder.js.map

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

package/dist/skills/source/errors.d.ts

@@ -0,0 +1,9 @@
+export type SkillSourceFailureCode = 'source_missing' | 'source_rate_limited' | 'source_unavailable' | 'candidate_not_found_at_source' | 'source_tree_truncated' | 'skill_disabled_for_model_invocation' | 'skill_secret_detected' | 'skill_too_large' | 'skill_validation_failed' | 'skill_blocked';
+/** A bounded, externally safe failure produced by source retrieval or validation. */
+export declare class SkillSourceError extends Error {
+    readonly code: SkillSourceFailureCode;
+    readonly retryAfterSeconds: number | null;
+    constructor(code: SkillSourceFailureCode, retryAfterSeconds?: number | null);
+}
+export declare function skillSourceFailure(code: SkillSourceFailureCode): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/skills/source/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/skills/source/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAC9B,gBAAgB,GAChB,qBAAqB,GACrB,oBAAoB,GACpB,+BAA+B,GAC/B,uBAAuB,GACvB,qCAAqC,GACrC,uBAAuB,GACvB,iBAAiB,GACjB,yBAAyB,GACzB,eAAe,CAAC;AAEpB,qFAAqF;AACrF,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;gBAE9B,IAAI,EAAE,sBAAsB,EAAE,iBAAiB,GAAE,MAAM,GAAG,IAAW;CAMlF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,KAAK,CAEtE"}

package/dist/skills/source/errors.js

@@ -0,0 +1,15 @@
+/** A bounded, externally safe failure produced by source retrieval or validation. */
+export class SkillSourceError extends Error {
+    code;
+    retryAfterSeconds;
+    constructor(code, retryAfterSeconds = null) {
+        super(code);
+        this.name = 'SkillSourceError';
+        this.code = code;
+        this.retryAfterSeconds = retryAfterSeconds;
+    }
+}
+export function skillSourceFailure(code) {
+    throw new SkillSourceError(code);
+}
+//# sourceMappingURL=errors.js.map

package/dist/skills/source/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/skills/source/errors.ts"],"names":[],"mappings":"AAYA,qFAAqF;AACrF,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAyB;IAC7B,iBAAiB,CAAgB;IAE1C,YAAY,IAA4B,EAAE,oBAAmC,IAAI;QAC/E,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAAC,IAA4B;IAC7D,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/skills/source/frontmatter.d.ts

@@ -0,0 +1,9 @@
+export interface SkillFrontmatter {
+    name: string;
+    description: string | null;
+    disableModelInvocation: boolean;
+}
+export declare const MAX_FRONTMATTER_BYTES = 8192;
+export declare function validSkillFrontmatterName(value: unknown): value is string;
+export declare function parseSkillFrontmatter(content: string): SkillFrontmatter;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/skills/source/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../src/skills/source/frontmatter.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED,eAAO,MAAM,qBAAqB,OAAQ,CAAC;AAO3C,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEzE;AAoBD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CA4CvE"}

package/dist/skills/source/frontmatter.js

@@ -0,0 +1,77 @@
+import { isMap, isPair, isScalar, parseDocument, Scalar } from 'yaml';
+import { skillSourceFailure } from './errors.js';
+export const MAX_FRONTMATTER_BYTES = 8_192;
+const NAME = /^[A-Za-z0-9][A-Za-z0-9 ._:@+/-]{0,200}$/u;
+const INVALID_UNICODE = /[\p{Cs}\uFFFD]/u;
+const INVALID_DESCRIPTION_CHARACTERS = /[\p{Cc}\p{Cf}\p{Cs}\uFFFD]/u;
+const FRONTMATTER_FIELDS = new Set(['name', 'description', 'disable-model-invocation']);
+export function validSkillFrontmatterName(value) {
+    return typeof value === 'string' && NAME.test(value) && !INVALID_UNICODE.test(value);
+}
+function validationFailure() {
+    return skillSourceFailure('skill_validation_failed');
+}
+function containsPhysicalLineBreak(source, node) {
+    if (node.range === undefined || node.range === null)
+        validationFailure();
+    return /[\r\n]/u.test(source.slice(node.range[0], node.range[1]));
+}
+function validScalarNode(source, node) {
+    return isScalar(node)
+        && node.tag === undefined
+        && node.anchor === undefined
+        && node.type !== Scalar.BLOCK_FOLDED
+        && node.type !== Scalar.BLOCK_LITERAL
+        && !containsPhysicalLineBreak(source, node);
+}
+export function parseSkillFrontmatter(content) {
+    if (typeof content !== 'string'
+        || INVALID_UNICODE.test(content)
+        || Buffer.byteLength(content, 'utf8') > 150_000)
+        validationFailure();
+    const match = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/u.exec(content);
+    if (!match)
+        validationFailure();
+    const source = match[1];
+    if (Buffer.byteLength(source, 'utf8') > MAX_FRONTMATTER_BYTES)
+        validationFailure();
+    const document = parseDocument(source, {
+        keepSourceTokens: true,
+        merge: false,
+        resolveKnownTags: false,
+        schema: 'core',
+        strict: true,
+        uniqueKeys: true,
+    });
+    if (document.errors.length > 0 || document.warnings.length > 0
+        || !isMap(document.contents)
+        || document.contents.flow === true
+        || document.contents.tag !== undefined
+        || document.contents.anchor !== undefined)
+        validationFailure();
+    const fields = new Map();
+    for (const pair of document.contents.items) {
+        if (!isPair(pair)
+            || !validScalarNode(source, pair.key)
+            || pair.key.type !== Scalar.PLAIN
+            || typeof pair.key.value !== 'string'
+            || !FRONTMATTER_FIELDS.has(pair.key.value)
+            || fields.has(pair.key.value)
+            || !validScalarNode(source, pair.value))
+            validationFailure();
+        fields.set(pair.key.value, pair.value.value);
+    }
+    const name = fields.get('name');
+    if (!validSkillFrontmatterName(name))
+        validationFailure();
+    const description = fields.get('description');
+    if (description !== undefined && (typeof description !== 'string'
+        || description.length > 2_000
+        || INVALID_DESCRIPTION_CHARACTERS.test(description)))
+        validationFailure();
+    const disabled = fields.get('disable-model-invocation');
+    if (disabled !== undefined && typeof disabled !== 'boolean')
+        validationFailure();
+    return { name, description: description ?? null, disableModelInvocation: disabled ?? false };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/skills/source/frontmatter.js.map

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

package/dist/skills/source/github-fetcher.d.ts

@@ -0,0 +1,20 @@
+import type { SkillCandidate, SkillSnapshot, SkillSourceFetcher, SkillSourceFetchRequest } from '../types.js';
+export { SkillSourceError } from './errors.js';
+export type { SkillSourceFailureCode } from './errors.js';
+export interface GitHubSkillSourceFetcherOptions {
+    fetchImpl?: typeof fetch;
+    token?: string | null;
+    timeoutMs?: number;
+}
+export declare class GitHubSkillSourceFetcher implements SkillSourceFetcher {
+    #private;
+    private readonly fetchImpl;
+    private readonly timeoutMs;
+    constructor(options?: GitHubSkillSourceFetcherOptions);
+    private request;
+    private text;
+    private responseText;
+    private json;
+    fetch(input: SkillCandidate, request: SkillSourceFetchRequest, signal?: AbortSignal): Promise<SkillSnapshot>;
+}
+//# sourceMappingURL=github-fetcher.d.ts.map

package/dist/skills/source/github-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-fetcher.d.ts","sourceRoot":"","sources":["../../../src/skills/source/github-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAU9G,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,WAAW,+BAA+B;IAC9C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiGD,qBAAa,wBAAyB,YAAW,kBAAkB;;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IAEzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBACvB,OAAO,GAAE,+BAAoC;YAO3C,OAAO;YAkBP,IAAI;YAIJ,YAAY;YAuBZ,IAAI;IAeZ,KAAK,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,uBAAuB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;CA6EnH"}