@modootoday/pmcp 0.9.2 → 0.11.0

package/dist/index.d.ts

@@ -1,8 +1,13 @@
-import { I as IntentCache, S as SkillServerOptions, a as SkillTools } from './server-C9eO6LMI.js';
-export { B as BundleFile, C as CATALOG_PAGE_MAX, b as CATALOG_PAGE_SIZE, c as CallResponse, d as CatalogItem, e as CatalogResponse, f as Classified, D as DEFAULT_FIND_LIMIT, g as DESCRIBE_FILE_LIMIT, E as Embedder, F as FileKind, h as FindOptions, i as FindResult, j as IntentCacheStats, K as KindFilter, M as Match, R as READ_BUDGET_BYTES, k as RUNTIMES, l as Ranking, m as ReadResult, n as Runtime, o as SkillBundle, p as SkillFile, q as SkillFileContent, r as SkillFileListing, s as SkillFilters, t as bundleResponseSchema, u as bundleSkill, v as catalogResponseSchema, w as classify, x as cosine, y as createSkillTools, z as describeResponseSchema, A as detectRuntime, G as find, H as findResultSchema, J as isUtf8Text, L as lexicalScore, N as listSkillFiles, O as mimeOf, P as normaliseIntent, Q as readSkillFile, T as runtimeOfClient, U as verifiedRuntimesOf } from './server-C9eO6LMI.js';
-import { S as SkillEntry, M as MetadataValue, C as CatalogOptions } from './catalog-BU5VLLyd.js';
-export { a as ASSET_KINDS, A as AssetKind, b as COMPATIBILITY_MAX, D as DESCRIPTION_MAX, c as MAX_SKILL_DEPTH, d as MetadataLeaf, N as NAME_MAX, e as SKIPPED_DIRS, f as displayPath, k as kindOf, g as parseSkillFrontmatter, r as readBody, h as readCatalog, i as readFrontmatter, s as specProblems, w as withoutBody } from './catalog-BU5VLLyd.js';
+import { I as IntentCache, R as Ranking, S as SkillServerOptions, E as Embedder, C as CatalogOptions, a as SkillEntry, M as MetadataValue, b as SkillTools } from './server-CwWcRjqz.js';
+export { A as ASSET_KINDS, c as AssetKind, B as BundleFile, d as CATALOG_PAGE_MAX, e as CATALOG_PAGE_SIZE, f as COMPATIBILITY_MAX, g as CallResponse, h as CatalogItem, i as CatalogResponse, j as Classified, D as DEFAULT_FIND_LIMIT, k as DESCRIBE_FILE_LIMIT, l as DESCRIPTION_MAX, F as FileKind, m as FindOptions, n as FindResult, o as IntentCacheStats, K as KindFilter, p as MAX_SKILL_DEPTH, q as Match, r as MetadataLeaf, N as NAME_MAX, s as READ_BUDGET_BYTES, t as RUNTIMES, u as ReadResult, v as Runtime, w as SKIPPED_DIRS, x as SkillBundle, y as SkillFile, z as SkillFileContent, G as SkillFileListing, H as SkillFilters, J as bundleResponseSchema, L as bundleSkill, O as catalogResponseSchema, P as classify, Q as cosine, T as createSkillTools, U as describeResponseSchema, V as detectRuntime, W as displayPath, X as find, Y as findResultSchema, Z as isUtf8Text, _ as kindOf, $ as lexicalScore, a0 as listSkillFiles, a1 as mimeOf, a2 as normaliseIntent, a3 as parseSkillFrontmatter, a4 as readBody, a5 as readCatalog, a6 as readFrontmatter, a7 as readSkillFile, a8 as runtimeOfClient, a9 as specProblems, aa as verifiedRuntimesOf, ab as withoutBody } from './server-CwWcRjqz.js';
+import { L as LoadEmbedderOptions } from './embed-BBhv3y5x.js';
+export { E as EntryVectorStore, e as encodeEntries, l as loadEmbedder, o as openEntryVectors } from './embed-BBhv3y5x.js';
+export { D as DEFAULT_MODEL_ID, a as EmbeddingModel, b as EncoderDtype, E as EncoderOptions, c as EncoderSpec, R as ResolvedEncoder, e as embeddingModels, d as encoderSpec, r as resolveEncoder } from './encoder-DGRy9skC.js';
+import { P as ProjectConfig } from './config-CJ43_oBS.js';
+export { C as CONFIG_FILE, a as CatalogSection, b as ConfigError, E as EmbeddingSection, f as findConfig, r as readConfig } from './config-CJ43_oBS.js';
+import { S as ShellHookSpec } from './hook-spec-PRSnYGLV.js';
 import { McpServer } from '@modelcontextprotocol/server';
+import { M as MailboxService } from './service-qpCsOXkQ.js';
 import 'zod';
 
 /**
@@ -37,6 +42,19 @@ declare const DEFAULT_INTENT_CACHE_LIMIT = 4096;
  */
 declare function openIntentCache(options: IntentCacheOptions): Promise<IntentCache | null>;
 
+interface SearchOptions extends LoadEmbedderOptions {
+    readonly indexPath: string;
+    readonly modelId?: string;
+    readonly embedder?: Embedder;
+    readonly loadCatalog?: (options: CatalogOptions) => SkillEntry[];
+}
+interface PreparedSearch {
+    readonly ranking: Ranking;
+    readonly reason?: "index_missing" | "index_unavailable" | "index_stale" | "encoder_unavailable" | "vector_mismatch";
+    readonly options: Pick<SkillServerOptions, "embedder" | "vectors" | "loadCatalog">;
+}
+declare function prepareSearch(catalog: CatalogOptions, options: SearchOptions): Promise<PreparedSearch>;
+
 /**
  * Assets laid out as an agent plugin marketplace: a directory holding
  * `.claude-plugin/marketplace.json`, whose plugins keep skills, commands,
@@ -58,44 +76,6 @@ declare function readMarketplace(dir: string, onReject?: (rejection: Rejection)
 /** The directory or single file an entry's describe and read may open. */
 declare const assetRoot: (entry: Pick<SkillEntry, "root" | "path">) => string;
 
-/**
- * `pmcp.toml`, the project's one record of where its catalog lives.
- *
- * Paths in it are relative to the file, so the same file works from any
- * directory a host starts pmcp in. Only `[catalog]` is read here; the other
- * sections belong to the projector and are kept as given.
- */
-declare const CONFIG_FILE = "pmcp.toml";
-/** What `[catalog]` may say. Each mirrors the repeatable CLI flag of the same meaning. */
-interface CatalogSection {
-    readonly roots?: readonly string[];
-    readonly scopes?: readonly string[];
-    readonly workspaces?: readonly string[];
-    readonly packages?: readonly string[];
-    readonly marketplaces?: readonly string[];
-}
-interface ProjectConfig {
-    /** Absolute path of the file read. */
-    readonly path: string;
-    /** Its directory; every relative path in the file resolves against it. */
-    readonly dir: string;
-    /** `[catalog]` with paths already absolute. */
-    readonly catalog: CatalogSection;
-    /** The whole document, for sections this module does not interpret. */
-    readonly raw: Readonly<Record<string, unknown>>;
-}
-declare class ConfigError extends Error {
-    constructor(path: string, message: string);
-}
-/** The nearest pmcp.toml at or above start, or null when there is none. */
-declare function findConfig(start: string): string | null;
-/**
- * Reads and checks one file. An unknown key under `[catalog]` is an error
- * rather than ignored, for the same reason an unknown flag is: a misspelt
- * `workspace = [...]` must not look like it worked.
- */
-declare function readConfig(path: string): ProjectConfig;
-
 /** What the projector writes. A path is unique across a plan and is the lock key. */
 type Output = {
     readonly kind: "link";
@@ -113,6 +93,7 @@ type Output = {
     readonly file: string;
     readonly key: readonly string[];
     readonly value: unknown;
+    readonly managed?: readonly unknown[];
 }
 /** A marked block inside a text file other content shares. path = file#pmcp */
  | {
@@ -139,13 +120,27 @@ interface PackageRulesSpec {
     readonly strip: readonly string[];
 }
 interface McpServerSpec {
-    readonly command: string;
+    readonly mailbox?: boolean;
+    readonly command?: string;
+    readonly url?: string;
     readonly args: readonly string[];
     readonly env: Readonly<Record<string, string>>;
+    readonly envVars?: readonly string[];
+    readonly envFrom?: Readonly<Record<string, {
+        readonly file: string;
+        readonly pointer: string;
+    }>>;
+    readonly cwd?: string;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly headerEnv?: Readonly<Record<string, string>>;
+    readonly bearerTokenEnvVar?: string;
+    readonly native?: Partial<Record<Tool, Readonly<Record<string, number>>>>;
+    readonly targets?: readonly Tool[];
     /** Tools the server should expose where a host can narrow them. */
     readonly tools?: readonly string[];
 }
 interface ProjectSpec {
+    readonly hooks?: readonly ShellHookSpec[];
     readonly root: string;
     readonly tools: ReadonlySet<Tool>;
     readonly skills: Readonly<Record<string, {
@@ -172,6 +167,7 @@ declare function plan(spec: ProjectSpec, owned?: ReadonlyMap<string, string>): O
 
 declare const LOCK_FILE = "pmcp.lock";
 interface ProjectResult {
+    readonly backup?: string;
     /** 0 done or clean, 2 check found problems, 3 refused to overwrite. */
     readonly code: 0 | 2 | 3;
     readonly problems: readonly string[];
@@ -195,7 +191,7 @@ interface RunResult {
     readonly status: number | null;
     readonly stdout: string;
 }
-type Runner = (command: string, args: readonly string[], cwd: string) => RunResult;
+type Runner = (command: string, args: readonly string[], cwd: string, env?: Readonly<Record<string, string | undefined>>) => RunResult;
 type Status = "ok" | "fail" | "skip";
 interface Finding$1 {
     readonly tool: Tool | "project";
@@ -204,6 +200,7 @@ interface Finding$1 {
     readonly detail?: string;
 }
 interface DoctorOptions {
+    readonly env?: Readonly<Record<string, string | undefined>>;
     readonly run: Runner;
     readonly home: string;
     readonly only?: ReadonlySet<Tool>;
@@ -285,7 +282,7 @@ declare function resolveSkillFileUri(uri: string, entries: readonly SkillEntry[]
 
 /** Reported to the host on connect. */
 declare const SERVER_NAME = "pmcp";
-declare const SERVER_VERSION = "0.9.2";
+declare const SERVER_VERSION = "0.11.0";
 /**
  * Registers the skill_* tools on a server.
  *
@@ -294,6 +291,7 @@ declare const SERVER_VERSION = "0.9.2";
  */
 declare function registerSkillTools(server: McpServer, tools: SkillTools): McpServer;
 interface SkillMcpOptions extends SkillServerOptions {
+    readonly mailbox?: MailboxService;
     /** One prompt per skill, for hosts that offer prompts as commands. Off by default. */
     readonly prompts?: boolean;
     readonly skillsExtension?: SkillsExtensionOptions;
@@ -337,4 +335,4 @@ declare function registerSkillResources(server: McpServer, skills: () => readonl
 declare const promptName: (entry: Pick<SkillEntry, "name">) => string;
 declare function registerSkillPrompts(server: McpServer, tools: SkillTools): void;
 
-export { CONFIG_FILE, CatalogOptions, type CatalogSection, ConfigError, DEFAULT_INTENT_CACHE_LIMIT, type Finding$1 as Finding, IntentCache, type IntentCacheOptions, LOCK_FILE, type McpServerSpec, MetadataValue, type Output, type PackageRulesSpec, type ProjectConfig, ProjectError, type ProjectResult, type ProjectSpec, type Rejection, type Runner, SERVER_NAME, SERVER_VERSION, SKILLS_EXTENSION, SkillEntry, type SkillExtensionEntry, type SkillMcpOptions, type SkillResource, SkillServerOptions, SkillTools, TOOLS, type Tool, type Finding as ValidationFinding, assetRoot, createSkillServer, deadGlobs, deriveName, doctor, extensionEntry, findConfig, openIntentCache, plan, project, promptName, readConfig, readFrontmatterText, readMarketplace, readMetadata, readSpec, registerSkillPrompts, registerSkillResources, registerSkillTools, registerSkillsExtension, resolveSkillFileUri, skillFileUri, skillFileUri as skillUri, validateCatalog, validateSkillDir };
+export { CatalogOptions, DEFAULT_INTENT_CACHE_LIMIT, Embedder, type Finding$1 as Finding, IntentCache, type IntentCacheOptions, LOCK_FILE, LoadEmbedderOptions, type McpServerSpec, MetadataValue, type Output, type PackageRulesSpec, type PreparedSearch, ProjectConfig, ProjectError, type ProjectResult, type ProjectSpec, Ranking, type Rejection, type Runner, SERVER_NAME, SERVER_VERSION, SKILLS_EXTENSION, type SearchOptions, SkillEntry, type SkillExtensionEntry, type SkillMcpOptions, type SkillResource, SkillServerOptions, SkillTools, TOOLS, type Tool, type Finding as ValidationFinding, assetRoot, createSkillServer, deadGlobs, deriveName, doctor, extensionEntry, openIntentCache, plan, prepareSearch, project, promptName, readFrontmatterText, readMarketplace, readMetadata, readSpec, registerSkillPrompts, registerSkillResources, registerSkillTools, registerSkillsExtension, resolveSkillFileUri, skillFileUri, skillFileUri as skillUri, validateCatalog, validateSkillDir };