@modootoday/pmcp 0.7.1 → 0.8.1

package/dist/server-B9GDPRoE.d.ts

@@ -1,217 +0,0 @@
-import { S as SkillEntry, C as CatalogOptions, A as AssetKind } from './catalog-5v7jrGwP.js';
-
-/**
- * The intent key and the cache contract.
- *
- * Separate from the sqlite implementation so that ranking, which needs the key
- * and the interface, does not pull a bun-only module into a consumer running
- * under node. Only `cache.ts` requires bun.
- */
-interface IntentCacheStats {
-    readonly hits: number;
-    readonly misses: number;
-    /** Rows found for the key but written by a different model. */
-    readonly mismatched: number;
-    readonly rows: number;
-    /** Which sqlite builtin answered, or absent when there is no cache. */
-    readonly provider?: string;
-}
-interface IntentCache {
-    /** The cached vector for an intent, or null when nothing usable is stored. */
-    get(intent: string): Float32Array | null;
-    put(intent: string, vector: Float32Array): void;
-    stats(): IntentCacheStats;
-    close(): void;
-}
-/**
- * Same question, differently typed. Case, punctuation and spacing only — the
- * key has to survive a caller writing "How do I wire X?" and "how do i wire x".
- */
-declare function normaliseIntent(intent: string): string;
-
-/**
- * Ranking an intent against skill descriptions.
- *
- * Semantic when an embedder is supplied, lexical otherwise, and the answer says
- * which. A caller that cannot tell the two apart cannot tell a degraded server
- * from a working one.
- */
-
-type Ranking = "semantic" | "lexical";
-interface Match {
-    readonly name: string;
-    readonly package: string;
-    readonly description: string;
-    readonly score: number;
-}
-interface FindResult {
-    readonly ranking: Ranking;
-    readonly matches: readonly Match[];
-}
-/**
- * The encoder, supplied by the caller. There is no default and no bundled
- * model: which model runs decides what the scores mean, so it is the consuming
- * repository's declaration rather than this package's.
- */
-interface Embedder {
-    readonly modelId: string;
-    readonly dims: number;
-    /** Encodes an intent, the query side. */
-    embed(text: string): Promise<Float32Array>;
-    /** Encodes a description, for models that write the two sides differently. */
-    embedPassage?(text: string): Promise<Float32Array>;
-}
-interface FindOptions {
-    readonly entries: readonly SkillEntry[];
-    readonly intent: string;
-    readonly limit?: number;
-    readonly embedder?: Embedder;
-    readonly cache?: IntentCache;
-    /** Precomputed description vectors, keyed by skill name. */
-    readonly vectors?: ReadonlyMap<string, Float32Array>;
-}
-declare const DEFAULT_FIND_LIMIT = 5;
-/**
- * Token overlap and bigram Dice, averaged. Deterministic and dependency-free:
- * this is the answer when there is no model, so it must never be the thing
- * that fails.
- */
-declare function lexicalScore(intent: string, description: string): number;
-/** Cosine over two equal-width vectors. Zero when either has no magnitude. */
-declare function cosine(a: Float32Array, b: Float32Array): number;
-/**
- * Ranked matches, and which ranking produced them.
- *
- * Returns rather than loads: a search verb that also acts cannot be used to
- * look, and the whole reason this server exists is that looking should be
- * cheap.
- */
-declare function find(options: FindOptions): Promise<FindResult>;
-
-/**
- * The five tools, and nothing else.
- *
- * The point of the server is that a session's startup cost does not grow with
- * the number of skills installed: the host lists five tools whatever the
- * catalog holds, and a body is read only when one is asked for.
- */
-
-/** Largest file skill_read returns. A skill needing more should split it. */
-declare const READ_BUDGET_BYTES: number;
-/** How many files skill_describe lists before saying the rest were cut. */
-declare const DESCRIBE_FILE_LIMIT = 200;
-declare const CATALOG_PAGE_SIZE = 8;
-declare const CATALOG_PAGE_MAX = 20;
-/** A kind filter value: one kind, or every kind. */
-type KindFilter = AssetKind | "any";
-/**
- * Equality filters over catalog fields. Unset keys match everything except
- * kind, which defaults to skill so a search for a skill never returns a hook.
- */
-interface SkillFilters {
-    readonly kind?: KindFilter;
-    readonly tier?: string;
-    readonly package?: string;
-    readonly level?: string;
-    readonly domain?: string;
-    readonly medium?: string;
-}
-type ReadResult = {
-    readonly ok: true;
-    readonly name: string;
-    readonly path: string;
-    readonly bytes: number;
-    readonly sha256: string;
-    readonly text: string;
-} | {
-    readonly ok: false;
-    readonly error: string;
-    readonly detail: string;
-};
-interface SkillServerOptions extends CatalogOptions {
-    readonly embedder?: Embedder;
-    readonly cache?: IntentCache;
-    readonly vectors?: ReadonlyMap<string, Float32Array>;
-    /** Injected for tests. Reads the catalog off disk otherwise. */
-    readonly loadCatalog?: (options: CatalogOptions) => SkillEntry[];
-}
-interface CatalogResponse {
-    readonly count: number;
-    readonly page: number;
-    readonly totalPages: number;
-    readonly hasNext: boolean;
-    readonly packages: readonly {
-        readonly package: string;
-        readonly skills: readonly CatalogItem[];
-    }[];
-}
-/** One catalog line. `kind` appears only for an asset that is not a skill. */
-interface CatalogItem {
-    readonly name: string;
-    readonly description: string;
-    readonly tier?: string;
-    readonly kind?: AssetKind;
-}
-interface CallResponse {
-    readonly name: string;
-    readonly body: string;
-    /** Files the skill carries besides its body, for skill_read. */
-    readonly files: readonly {
-        path: string;
-        bytes: number;
-        sha256: string;
-    }[];
-    readonly filesTruncated: boolean;
-}
-/**
- * The catalog, the search and the read, as plain functions.
- *
- * Separate from the MCP wiring so they can be exercised without a transport,
- * and so a consumer that wants them from a hook or a script is not made to
- * speak a protocol to get them.
- */
-declare function createSkillTools(options: SkillServerOptions): {
-    /**
-     * Grouped, and without bodies. The cheap overview and the search's miss
-     * path. Paged by package so a large catalog never arrives in one answer.
-     */
-    catalog(request?: {
-        page?: number;
-        pageSize?: number;
-        tier?: string;
-        kind?: KindFilter;
-    }): CatalogResponse;
-    /** Ranked names. Returns; never loads a body. */
-    find(intent: string, limit?: number, filters?: SkillFilters): Promise<FindResult>;
-    /** Every property of one skill and the files it carries, without bodies. */
-    describe(name: string): {
-        name: string;
-        kind: "agent" | "skill" | "hook" | "mcp";
-        package: string;
-        description: string;
-        tier: string | undefined;
-        metadata: Readonly<Record<string, string | readonly string[]>>;
-        frontmatter: string;
-        files: {
-            path: string;
-            bytes: number;
-            sha256: string;
-        }[];
-        filesTruncated: boolean;
-    } | null;
-    /**
-     * One file inside a skill's directory. Paths that leave the directory,
-     * directly or through a link, are refused; nothing is ever executed.
-     */
-    read(name: string, path?: string): ReadResult;
-    /** One body, at the moment it is needed. */
-    call(name: string): CallResponse | null;
-    /** Drops the memoised catalog, so the next call re-reads the tree. */
-    refresh(): void;
-    entries: () => Omit<SkillEntry, "path">[];
-    /** The catalog with paths, for the Skills extension. The same array until refresh. */
-    skills: () => readonly SkillEntry[];
-};
-type SkillTools = ReturnType<typeof createSkillTools>;
-
-export { CATALOG_PAGE_MAX as C, DEFAULT_FIND_LIMIT as D, type Embedder as E, type FindOptions as F, type IntentCache as I, type KindFilter as K, type Match as M, READ_BUDGET_BYTES as R, type SkillServerOptions as S, type SkillTools as a, CATALOG_PAGE_SIZE as b, type CallResponse as c, type CatalogItem as d, type CatalogResponse as e, DESCRIBE_FILE_LIMIT as f, type FindResult as g, type IntentCacheStats as h, type Ranking as i, type ReadResult as j, type SkillFilters as k, cosine as l, createSkillTools as m, find as n, lexicalScore as o, normaliseIntent as p };