@modootoday/pmcp 0.17.3 → 0.18.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/plugins/marketplace.json +1 -1
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +60 -0
- package/README.md +29 -24
- package/dist/apply-4IGTXOCQ.js +242 -0
- package/dist/{attachment-tU5FZrgZ.d.ts → attachment-D84OGI6n.d.ts} +1 -1
- package/dist/available-DBSIVVJ6.js +73 -0
- package/dist/broadcast-3RY3OZGY.js +18 -0
- package/dist/chunk-25GHX674.js +1246 -0
- package/dist/chunk-2P4Z2NUX.js +28 -0
- package/dist/chunk-34DECPVC.js +22 -0
- package/dist/chunk-3NYG4SGU.js +45 -0
- package/dist/chunk-3PW4FI7U.js +32 -0
- package/dist/chunk-3Y3HDMHA.js +108 -0
- package/dist/chunk-47O3X4VS.js +113 -0
- package/dist/chunk-4NDEP7HU.js +26 -0
- package/dist/chunk-4VCC2NXE.js +104 -0
- package/dist/chunk-5OMOPUE6.js +39 -0
- package/dist/chunk-5QQWS4US.js +53 -0
- package/dist/chunk-5ZABTVSW.js +48 -0
- package/dist/chunk-65ZHM5RH.js +4985 -0
- package/dist/chunk-665TA55Z.js +419 -0
- package/dist/chunk-6STKGOCW.js +27 -0
- package/dist/chunk-6WXMJOMI.js +9 -0
- package/dist/chunk-73AKO4UL.js +24 -0
- package/dist/chunk-7BLPN3W6.js +31 -0
- package/dist/chunk-7DLZC73N.js +29 -0
- package/dist/chunk-7GBYECSK.js +72 -0
- package/dist/chunk-7TD53M7L.js +13 -0
- package/dist/chunk-A4PKLESO.js +112 -0
- package/dist/chunk-ABTJQ4QV.js +74 -0
- package/dist/chunk-BBTBJCFA.js +380 -0
- package/dist/chunk-BU65MNVU.js +13 -0
- package/dist/chunk-BVCTKPT3.js +83 -0
- package/dist/chunk-C4NHQGHL.js +142 -0
- package/dist/chunk-CJTKR6K6.js +1213 -0
- package/dist/chunk-DCU2EXQV.js +78 -0
- package/dist/chunk-DZ2MRTYT.js +135 -0
- package/dist/chunk-E2YOZ2FF.js +207 -0
- package/dist/chunk-E3DQB5LS.js +48 -0
- package/dist/chunk-E7OOHLQR.js +7 -0
- package/dist/chunk-EATCUWGG.js +66 -0
- package/dist/chunk-EIDIVIAD.js +33 -0
- package/dist/chunk-EJBZGIDK.js +1934 -0
- package/dist/chunk-ELAGZ635.js +252 -0
- package/dist/chunk-GZHHEHKY.js +44 -0
- package/dist/chunk-HDMBVLCZ.js +53 -0
- package/dist/chunk-HQOB7OQS.js +81 -0
- package/dist/chunk-IGYRMM62.js +28 -0
- package/dist/chunk-IJBSOWHK.js +86 -0
- package/dist/chunk-INT7QLEU.js +114 -0
- package/dist/chunk-J6QLLQVL.js +1025 -0
- package/dist/chunk-J7UYNJCR.js +9 -0
- package/dist/chunk-JEL35P7S.js +53 -0
- package/dist/chunk-JGJ4INEN.js +32 -0
- package/dist/chunk-JS5RTH4I.js +84 -0
- package/dist/chunk-JUXNIXN4.js +42 -0
- package/dist/chunk-JWRZDYB5.js +59 -0
- package/dist/chunk-KMXRRSKT.js +660 -0
- package/dist/chunk-LAZQBMAU.js +67 -0
- package/dist/chunk-LLBPVZXM.js +67 -0
- package/dist/chunk-LLT5FQBE.js +57 -0
- package/dist/chunk-LMT3PPXJ.js +17 -0
- package/dist/chunk-MM2Y43LC.js +87 -0
- package/dist/chunk-MPSQXSC6.js +346 -0
- package/dist/chunk-MVFH26QT.js +97 -0
- package/dist/chunk-MWFOUBFC.js +39 -0
- package/dist/chunk-N5AQ3PP7.js +211 -0
- package/dist/chunk-NQPURJT5.js +44 -0
- package/dist/chunk-NRBQK6UX.js +105 -0
- package/dist/chunk-NZS5CD72.js +333 -0
- package/dist/chunk-OEH47H6A.js +48 -0
- package/dist/chunk-OG7QR2DP.js +75 -0
- package/dist/chunk-OPYFEHKG.js +52 -0
- package/dist/chunk-P4N7DBD5.js +83 -0
- package/dist/chunk-PAX3QXX2.js +140 -0
- package/dist/chunk-PLX3BOOS.js +396 -0
- package/dist/chunk-PMJG2CXF.js +122 -0
- package/dist/chunk-PWSJJXLQ.js +643 -0
- package/dist/chunk-Q5H3L6Y4.js +23 -0
- package/dist/chunk-Q65R3XKX.js +155 -0
- package/dist/chunk-QEW4J3IZ.js +74 -0
- package/dist/chunk-QPL7E2HW.js +464 -0
- package/dist/chunk-R2GPCZUX.js +22 -0
- package/dist/chunk-R4L6LJJ2.js +778 -0
- package/dist/chunk-R5MT42JS.js +284 -0
- package/dist/chunk-RK4PYD7L.js +73 -0
- package/dist/chunk-RMATE45Z.js +197 -0
- package/dist/chunk-S3PIAMXV.js +230 -0
- package/dist/chunk-SG5TPMKH.js +93 -0
- package/dist/chunk-T3LKX23M.js +168 -0
- package/dist/chunk-T6GOWHK6.js +30 -0
- package/dist/chunk-TIA4SPU2.js +10 -0
- package/dist/chunk-TNCZ6444.js +57 -0
- package/dist/chunk-TVL5RTE6.js +269 -0
- package/dist/chunk-UOCLRM7P.js +151 -0
- package/dist/chunk-UPQTAHUK.js +189 -0
- package/dist/chunk-V4NPDK6X.js +14 -0
- package/dist/chunk-VJFEN6DJ.js +38 -0
- package/dist/chunk-WIW772I3.js +25 -0
- package/dist/chunk-XELAZAIM.js +136 -0
- package/dist/chunk-XNML2KIC.js +23 -0
- package/dist/chunk-XP2U3LO3.js +30 -0
- package/dist/chunk-YGOWIJPE.js +51 -0
- package/dist/chunk-YIXDHQYE.js +11 -0
- package/dist/chunk-YMHUM7AV.js +22 -0
- package/dist/chunk-YSAWTGNA.js +117 -0
- package/dist/chunk-Z4HRRXRF.js +478 -0
- package/dist/chunk-ZH6R642Z.js +102 -0
- package/dist/claude-U2JC2DNQ.js +77 -0
- package/dist/cli-VYCQJZ5X.js +41 -0
- package/dist/cli-ZTCBSDW4.js +46 -0
- package/dist/cli.js +144 -16160
- package/dist/completion-E7RRG3ZT.js +142 -0
- package/dist/config-DnpLL2kT.d.ts +46 -0
- package/dist/{service-qpCsOXkQ.d.ts → core-C1LPjxK6.d.ts} +2 -6
- package/dist/diagnostics-XXH4FLUG.js +93 -0
- package/dist/doctor-ZIOESU3N.js +538 -0
- package/dist/entry-ZNFCTDVE.js +305 -0
- package/dist/exec-mcp-X6372BLE.js +365 -0
- package/dist/harness-F2XFDYXF.js +177 -0
- package/dist/harness-egress-bridge.js +4 -4
- package/dist/harness-launch-gate.js +47 -940
- package/dist/harness-pane-runner.js +13 -80
- package/dist/harness-worker.js +21 -2703
- package/dist/hook-body.js +5221 -0
- package/dist/hook-spec-C5fWTSCH.d.ts +100 -0
- package/dist/hook.js +26 -0
- package/dist/hooks-FYE2L5RW.js +21 -0
- package/dist/host-GRY3VAHH.js +22 -0
- package/dist/host-X6BR6X4O.js +200 -0
- package/dist/host-run-GCA6H6SR.js +307 -0
- package/dist/http.d.ts +5 -42
- package/dist/http.js +21 -2234
- package/dist/import-mcp-2TTBPVLY.js +400 -0
- package/dist/index.d.ts +146 -168
- package/dist/index.js +133 -4911
- package/dist/init-627KFXTG.js +14 -0
- package/dist/install-GG7HHZK2.js +796 -0
- package/dist/invoke-LW22Z6ET.js +23 -0
- package/dist/list-MCP2FXUF.js +68 -0
- package/dist/list-NGMSQ5SH.js +65 -0
- package/dist/load-BEUBABtB.d.ts +21 -0
- package/dist/logout-6CSHUWWE.js +44 -0
- package/dist/logs-SPB6AANY.js +107 -0
- package/dist/mailbox/index.d.ts +10 -5
- package/dist/mailbox/index.js +53 -1572
- package/dist/mailbox-7BV54Q4R.js +285 -0
- package/dist/mailbox-GDJ7BWQN.js +189 -0
- package/dist/mainline-JQTTYJMI.js +639 -0
- package/dist/marketplace-G4VQET5W.js +191 -0
- package/dist/mcp-2DKVU3SW.js +15 -0
- package/dist/mcp-V23HC3LB.js +193 -0
- package/dist/models-ISU4DCMA.js +32 -0
- package/dist/opencode-CN7JLQYO.js +60 -0
- package/dist/pause-FFAYRBWI.js +18 -0
- package/dist/preview-DT7DWG5F.js +91 -0
- package/dist/project/hook-adapter.d.ts +6 -3
- package/dist/project/hook-adapter.js +66 -35
- package/dist/project-FY62G55N.js +70 -0
- package/dist/pty-XTJ4MIWK.js +94 -0
- package/dist/recovery-U6QB3PMT.js +100 -0
- package/dist/reindex-Y27QJFDB.js +22 -0
- package/dist/resume-UU4HZIUP.js +18 -0
- package/dist/run-HALGEJNJ.js +19 -0
- package/dist/run-OGA3P7FC.js +126 -0
- package/dist/serve-NBKT5BKY.js +104 -0
- package/dist/session-XM2CR425.js +159 -0
- package/dist/setup-DTKZLZUT.js +18 -0
- package/dist/start-login-UIQYQBMC.js +416 -0
- package/dist/status-A2OUTNGK.js +9 -0
- package/dist/status-H2VAHIDV.js +10 -0
- package/dist/status-NOOHW5WA.js +43 -0
- package/dist/status-VHODZPXB.js +55 -0
- package/dist/status-XQANBVXW.js +286 -0
- package/dist/stdio.d.ts +3 -13
- package/dist/stdio.js +16 -3186
- package/dist/sweep-64JDCGK6.js +18 -0
- package/dist/test-MKAXFJOL.js +561 -0
- package/dist/tools-gpHNq9Dh.d.ts +328 -0
- package/dist/tui-MWKAXE4K.js +153 -0
- package/dist/unbroadcast-KPUEFLZD.js +18 -0
- package/dist/validate-5GZ5YWNA.js +46 -0
- package/dist/worker-RQ575EJL.js +80 -0
- package/dist/worktree-create-PZSRB7PH.js +89 -0
- package/dist/worktree-list-JYB6VXLW.js +51 -0
- package/dist/worktree-sync-UF5CXPWV.js +30 -0
- package/docs/hooks/capabilities/antigravity.json +199 -0
- package/docs/hooks/capabilities/claude.json +179 -0
- package/docs/hooks/capabilities/codex.json +179 -0
- package/docs/hooks/capabilities/gemini.json +196 -0
- package/docs/hooks/capabilities/grok.json +192 -0
- package/docs/hooks/capabilities/opencode.json +184 -0
- package/docs/project-configuration.md +844 -4
- package/docs/terminal-harness.md +71 -28
- package/docs/terminal-workspace.md +91 -170
- package/gemini-extension.json +1 -1
- package/package.json +13 -1
- package/plugin.json +1 -1
- package/plugins/pmcp/.claude-plugin/plugin.json +4 -2
- package/plugins/pmcp/gemini-extension.json +1 -1
- package/plugins/pmcp/mod/commands.ts +72 -0
- package/plugins/pmcp/mod/contract.d.ts +39 -0
- package/plugins/pmcp/mod/draw.tsx +216 -0
- package/plugins/pmcp/mod/guard.ts +42 -0
- package/plugins/pmcp/mod/hooks.json +4 -0
- package/plugins/pmcp/mod/host.ts +46 -0
- package/plugins/pmcp/mod/model.ts +144 -0
- package/plugins/pmcp/mod/reader/index.ts +18 -0
- package/plugins/pmcp/mod/reader/read.ts +76 -0
- package/plugins/pmcp/mod/reader/settings.ts +54 -0
- package/plugins/pmcp/mod/reader/types.ts +38 -0
- package/plugins/pmcp/mod/register.tsx +73 -0
- package/plugins/pmcp/mod/sessions/format.ts +91 -0
- package/plugins/pmcp/mod/sessions/types.ts +162 -0
- package/plugins/pmcp/mod/snapshot.ts +75 -0
- package/plugins/pmcp/mod/spinner.tsx +30 -0
- package/plugins/pmcp/mod/state.ts +28 -0
- package/plugins/pmcp/plugin.json +1 -1
- package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +96 -0
- package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +100 -0
- package/plugins/pmcp/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
- package/plugins/pmcp/skills/package-skill-catalog/SKILL.md +51 -11
- package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +145 -0
- package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +104 -0
- package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +88 -0
- package/schema/catalog-v1.json +158 -0
- package/schema/library.json +164 -0
- package/schema/marketplace-manifest.json +130 -0
- package/schema/plugin-manifest.json +55 -0
- package/schema/skill-frontmatter.json +144 -0
- package/schema/skill-metadata-core.json +110 -0
- package/skills/agent-assets-migrate/SKILL.md +96 -0
- package/skills/headless-agents-ci-scaffold/SKILL.md +100 -0
- package/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
- package/skills/package-skill-catalog/SKILL.md +51 -11
- package/skills/pmcp-project-init/SKILL.md +145 -0
- package/skills/pmcp-sessions-and-git/SKILL.md +104 -0
- package/skills/skill-package-scaffold/SKILL.md +88 -0
- package/dist/config-BkSpjUG6.d.ts +0 -50
- package/dist/embed-DRROSD3F.d.ts +0 -53
- package/dist/hook-spec-PRSnYGLV.d.ts +0 -10
- package/dist/server-VWSY3Shw.d.ts +0 -543
- package/dist/tui-worker.js +0 -6549
- /package/dist/{tui-worker.d.ts → hook.d.ts} +0 -0
package/dist/index.d.ts
CHANGED
|
@@ -1,45 +1,48 @@
|
|
|
1
|
-
import {
|
|
2
|
-
export { A as ASSET_KINDS, d as AssetKind, B as BundleFile, e as
|
|
3
|
-
import { L as LoadEmbedderOptions } from './
|
|
4
|
-
export {
|
|
1
|
+
import { a as SkillEntry, E as Embedder, I as IntentCache, b as Ranking, S as SkillServerOptions, C as CatalogOptions, M as MetadataValue, c as SkillTools } from './tools-gpHNq9Dh.js';
|
|
2
|
+
export { A as ASSET_KINDS, d as AssetKind, B as BundleFile, e as COMPATIBILITY_MAX, f as CallResponse, g as CatalogItem, h as CatalogResponse, i as Classified, D as DEFAULT_FIND_LIMIT, j as DESCRIPTION_MAX, F as FileKind, k as FindOptions, l as FindResult, m as IntentCacheStats, K as KindFilter, n as MAX_SKILL_DEPTH, o as Match, p as MetadataLeaf, N as NAME_MAX, q as READ_BUDGET_BYTES, r as RUNTIMES, s as ReadResult, R as Runtime, t as SKIPPED_DIRS, u as SkillBundle, w as SkillFile, x as SkillFileContent, y as SkillFileListing, z as SkillFilters, G as bundleResponseSchema, H as bundleSkill, J as catalogResponseSchema, L as classify, O as cosine, P as createSkillTools, Q as describeResponseSchema, T as detectRuntime, U as find, V as findResultSchema, W as isUtf8Text, X as kindOf, Y as lexicalScore, Z as listSkillFiles, _ as mimeOf, $ as normaliseIntent, a0 as parseSkillFrontmatter, a1 as readSkillFile, a2 as runtimeOfClient, a3 as specProblems, v as verifiedRuntimesOf } from './tools-gpHNq9Dh.js';
|
|
3
|
+
import { E as EntryVectorStore, L as LoadEmbedderOptions } from './load-BEUBABtB.js';
|
|
4
|
+
export { l as loadEmbedder, r as readCatalog } from './load-BEUBABtB.js';
|
|
5
5
|
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';
|
|
6
|
-
import { P as ProjectConfig } from './config-
|
|
7
|
-
export { C as CONFIG_FILE, a as CatalogSection, b as ConfigError, E as EmbeddingSection, f as findConfig, r as readConfig } from './config-
|
|
8
|
-
import { S as ShellHookSpec } from './hook-spec-
|
|
6
|
+
import { P as ProjectConfig, V as ValidationSettings, F as Finding$1 } from './config-DnpLL2kT.js';
|
|
7
|
+
export { C as CONFIG_FILE, a as CatalogSection, b as ConfigError, E as EmbeddingSection, f as findConfig, r as readConfig } from './config-DnpLL2kT.js';
|
|
8
|
+
import { S as ShellHookSpec, a as HookSpecs } from './hook-spec-C5fWTSCH.js';
|
|
9
9
|
import { McpServer } from '@modelcontextprotocol/server';
|
|
10
|
-
import { M as MailboxService } from './
|
|
10
|
+
import { M as MailboxService } from './core-C1LPjxK6.js';
|
|
11
11
|
import 'zod';
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
13
|
+
declare function readFrontmatter(source: string): Record<string, string>;
|
|
14
|
+
declare function readBody(source: string): string;
|
|
15
|
+
|
|
16
|
+
declare function withoutBody({ path, ...rest }: SkillEntry): Omit<SkillEntry, "path">;
|
|
17
|
+
declare function displayPath(root: string, entry: SkillEntry): string;
|
|
18
|
+
|
|
19
|
+
declare function encodeEntries(embedder: Embedder, entries: readonly {
|
|
20
|
+
readonly name: string;
|
|
21
|
+
readonly description: string;
|
|
22
|
+
}[], previous?: ReadonlyMap<string, {
|
|
23
|
+
hash: string;
|
|
24
|
+
vector: Float32Array;
|
|
25
|
+
}>): Promise<Map<string, {
|
|
26
|
+
hash: string;
|
|
27
|
+
vector: Float32Array;
|
|
28
|
+
}>>;
|
|
29
|
+
|
|
30
|
+
declare function openEntryVectors(path: string, options?: {
|
|
31
|
+
readOnly?: boolean;
|
|
32
|
+
}): Promise<EntryVectorStore | null>;
|
|
33
|
+
|
|
34
|
+
declare const DESCRIBE_FILE_LIMIT = 200;
|
|
35
|
+
declare const CATALOG_PAGE_SIZE = 8;
|
|
36
|
+
declare const CATALOG_PAGE_MAX = 20;
|
|
21
37
|
|
|
22
38
|
interface IntentCacheOptions {
|
|
23
|
-
/** Database file. `:memory:` is accepted and is what the tests use. */
|
|
24
39
|
readonly path: string;
|
|
25
|
-
/** The embedder's identity. Rows from another model are never scored. */
|
|
26
40
|
readonly modelId: string;
|
|
27
|
-
/** Vector width. A row of a different width is a different model. */
|
|
28
41
|
readonly dims: number;
|
|
29
|
-
/** Rows kept. The least recently asked are dropped past this. */
|
|
30
42
|
readonly limit?: number;
|
|
31
|
-
/** Injected for tests. Real time otherwise. */
|
|
32
43
|
readonly now?: () => number;
|
|
33
44
|
}
|
|
34
45
|
declare const DEFAULT_INTENT_CACHE_LIMIT = 4096;
|
|
35
|
-
/**
|
|
36
|
-
* Opens the cache, or returns null when it cannot be opened.
|
|
37
|
-
*
|
|
38
|
-
* Null is the normal answer on a read-only volume, a locked file, a corrupt
|
|
39
|
-
* database, or a runtime with neither builtin: the caller embeds on demand
|
|
40
|
-
* instead. A cache that throws would turn a missing optimisation into a failed
|
|
41
|
-
* search, and an older runtime is that case rather than an error.
|
|
42
|
-
*/
|
|
43
46
|
declare function openIntentCache(options: IntentCacheOptions): Promise<IntentCache | null>;
|
|
44
47
|
|
|
45
48
|
interface SearchOptions extends LoadEmbedderOptions {
|
|
@@ -55,21 +58,18 @@ interface PreparedSearch {
|
|
|
55
58
|
}
|
|
56
59
|
declare function prepareSearch(catalog: CatalogOptions, options: SearchOptions): Promise<PreparedSearch>;
|
|
57
60
|
|
|
58
|
-
/** Why an asset was left out rather than served. */
|
|
59
61
|
interface Rejection {
|
|
60
62
|
readonly path: string;
|
|
61
63
|
readonly reason: string;
|
|
62
64
|
}
|
|
63
|
-
|
|
65
|
+
|
|
64
66
|
declare function readMetadata(source: string): Record<string, MetadataValue>;
|
|
65
|
-
/** The raw frontmatter text between the fences, for skill_describe. */
|
|
66
67
|
declare function readFrontmatterText(source: string): string;
|
|
67
|
-
|
|
68
|
+
|
|
68
69
|
declare function readMarketplace(dir: string, onReject?: (rejection: Rejection) => void): SkillEntry[];
|
|
69
|
-
|
|
70
|
+
|
|
70
71
|
declare const assetRoot: (entry: Pick<SkillEntry, "root" | "path">) => string;
|
|
71
72
|
|
|
72
|
-
/** What the projector writes. A path is unique across a plan and is the lock key. */
|
|
73
73
|
type Output = {
|
|
74
74
|
readonly kind: "link";
|
|
75
75
|
readonly path: string;
|
|
@@ -96,23 +96,110 @@ type Output = {
|
|
|
96
96
|
readonly content: string;
|
|
97
97
|
};
|
|
98
98
|
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
99
|
+
declare const MARKETPLACE_RUNTIMES: readonly ["claude", "codex"];
|
|
100
|
+
type MarketplaceRuntime = (typeof MARKETPLACE_RUNTIMES)[number];
|
|
101
|
+
type MarketplaceSource = {
|
|
102
|
+
readonly kind: "path";
|
|
103
|
+
readonly path: string;
|
|
104
|
+
} | {
|
|
105
|
+
readonly kind: "github";
|
|
106
|
+
readonly repo: string;
|
|
107
|
+
readonly ref?: string;
|
|
108
|
+
} | {
|
|
109
|
+
readonly kind: "builtin";
|
|
110
|
+
};
|
|
111
|
+
interface DeclaredPlugin {
|
|
112
|
+
readonly name: string;
|
|
113
|
+
readonly targets: readonly MarketplaceRuntime[];
|
|
114
|
+
}
|
|
115
|
+
interface DeclaredMarketplace {
|
|
116
|
+
readonly name: string;
|
|
117
|
+
readonly source: MarketplaceSource;
|
|
118
|
+
readonly catalog?: boolean;
|
|
119
|
+
readonly plugins: readonly DeclaredPlugin[];
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
interface UiSettings {
|
|
123
|
+
readonly stateDir?: string;
|
|
124
|
+
readonly sessionsPane: boolean;
|
|
125
|
+
readonly statusBand: boolean;
|
|
126
|
+
readonly commands: boolean;
|
|
127
|
+
readonly holdForeignEdits: boolean;
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
interface RunResult {
|
|
131
|
+
readonly missing: boolean;
|
|
132
|
+
readonly status: number | null;
|
|
133
|
+
readonly stdout: string;
|
|
134
|
+
}
|
|
135
|
+
type Runner = (command: string, args: readonly string[], cwd: string, env?: Readonly<Record<string, string | undefined>>) => RunResult;
|
|
136
|
+
type Status = "ok" | "fail" | "warn" | "skip";
|
|
137
|
+
interface Finding {
|
|
138
|
+
readonly tool: Tool | "project";
|
|
139
|
+
readonly check: string;
|
|
140
|
+
readonly status: Status;
|
|
141
|
+
readonly detail?: string;
|
|
142
|
+
}
|
|
143
|
+
interface DoctorOptions {
|
|
144
|
+
readonly env?: Readonly<Record<string, string | undefined>>;
|
|
145
|
+
readonly run: Runner;
|
|
146
|
+
readonly home: string;
|
|
147
|
+
readonly only?: ReadonlySet<Tool>;
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
declare const BUCKETS: readonly ["allow", "ask", "deny"];
|
|
151
|
+
type Bucket = (typeof BUCKETS)[number];
|
|
152
|
+
interface PermissionSpec {
|
|
153
|
+
readonly claude: Readonly<Partial<Record<Bucket, readonly string[]>>>;
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
interface HostBrowser {
|
|
157
|
+
readonly allowPrivate: readonly string[];
|
|
158
|
+
}
|
|
159
|
+
interface HostLaunch {
|
|
160
|
+
readonly name: string;
|
|
161
|
+
readonly argv: readonly string[];
|
|
162
|
+
}
|
|
163
|
+
interface HostDesktop {
|
|
164
|
+
readonly launch: readonly HostLaunch[];
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
declare const HOST_RUNTIMES: readonly ["claude", "codex", "gemini", "agy", "grok", "opencode"];
|
|
168
|
+
type HostRuntime = (typeof HOST_RUNTIMES)[number];
|
|
169
|
+
interface HostSession {
|
|
170
|
+
readonly name: string;
|
|
171
|
+
readonly runtime: HostRuntime;
|
|
172
|
+
readonly cwd: string;
|
|
173
|
+
readonly argv: readonly string[];
|
|
174
|
+
readonly labels: Readonly<Record<string, string>>;
|
|
175
|
+
readonly restart: "no" | "on-exit";
|
|
176
|
+
readonly maxRestarts: number;
|
|
177
|
+
}
|
|
178
|
+
interface HostAnswer {
|
|
179
|
+
readonly runtime: HostRuntime;
|
|
180
|
+
readonly dialog: string;
|
|
181
|
+
readonly options: readonly string[];
|
|
182
|
+
}
|
|
183
|
+
interface HostSpec {
|
|
184
|
+
readonly sessions: readonly HostSession[];
|
|
185
|
+
readonly answers: readonly HostAnswer[];
|
|
186
|
+
readonly mcpWrite: boolean;
|
|
187
|
+
readonly roots: readonly string[];
|
|
188
|
+
readonly browser: HostBrowser;
|
|
189
|
+
readonly desktop: HostDesktop;
|
|
190
|
+
}
|
|
103
191
|
|
|
104
192
|
declare const TOOLS: readonly ["claude", "codex", "gemini", "grok", "antigravity", "opencode"];
|
|
105
193
|
type Tool = (typeof TOOLS)[number];
|
|
194
|
+
|
|
106
195
|
type Invocation = "any" | "user";
|
|
107
196
|
interface PackageRulesSpec {
|
|
108
|
-
/** Path of the rule file inside each package, e.g. `.agent/rules/PACKAGE.RULE.md`. */
|
|
109
197
|
readonly file: string;
|
|
110
|
-
/** Subdirectory of `.claude/rules` the links go in. */
|
|
111
198
|
readonly dir: string;
|
|
112
|
-
/** Leading path segments dropped when a link name is derived. */
|
|
113
199
|
readonly strip: readonly string[];
|
|
114
200
|
}
|
|
115
201
|
interface McpServerSpec {
|
|
202
|
+
readonly auth?: "native" | "pmcp";
|
|
116
203
|
readonly mailbox?: boolean;
|
|
117
204
|
readonly command?: string;
|
|
118
205
|
readonly url?: string;
|
|
@@ -129,11 +216,13 @@ interface McpServerSpec {
|
|
|
129
216
|
readonly bearerTokenEnvVar?: string;
|
|
130
217
|
readonly native?: Partial<Record<Tool, Readonly<Record<string, number>>>>;
|
|
131
218
|
readonly targets?: readonly Tool[];
|
|
132
|
-
/** Tools the server should expose where a host can narrow them. */
|
|
133
219
|
readonly tools?: readonly string[];
|
|
134
220
|
}
|
|
135
221
|
interface ProjectSpec {
|
|
136
222
|
readonly hooks?: readonly ShellHookSpec[];
|
|
223
|
+
readonly hookBundle?: HookSpecs["bundle"];
|
|
224
|
+
readonly featureSources?: HookSpecs["sources"];
|
|
225
|
+
readonly deprecations?: readonly string[];
|
|
137
226
|
readonly root: string;
|
|
138
227
|
readonly tools: ReadonlySet<Tool>;
|
|
139
228
|
readonly skills: Readonly<Record<string, {
|
|
@@ -142,80 +231,39 @@ interface ProjectSpec {
|
|
|
142
231
|
readonly agents: Readonly<Record<string, Partial<Record<Tool, Record<string, unknown>>>>>;
|
|
143
232
|
readonly packageRules: PackageRulesSpec | null;
|
|
144
233
|
readonly mcp: Readonly<Record<string, McpServerSpec>>;
|
|
234
|
+
readonly marketplaces?: readonly DeclaredMarketplace[];
|
|
235
|
+
readonly uiClaude?: UiSettings;
|
|
236
|
+
readonly permissions?: PermissionSpec;
|
|
237
|
+
readonly host?: HostSpec;
|
|
145
238
|
}
|
|
146
239
|
declare function readSpec(config: ProjectConfig): ProjectSpec;
|
|
147
240
|
|
|
148
|
-
/**
|
|
149
|
-
* Every output the sources imply, read from disk but written nowhere. Sources:
|
|
150
|
-
* .agents/skills, .agents/agents, .agents/rules, package rule files, and pmcp.toml.
|
|
151
|
-
*/
|
|
152
|
-
|
|
153
241
|
declare function plan(spec: ProjectSpec, owned?: ReadonlyMap<string, string>): Output[];
|
|
154
242
|
|
|
155
|
-
/**
|
|
156
|
-
* Writes or checks a plan. The lock (pmcp.lock) records what this wrote, so a
|
|
157
|
-
* source removed later takes its outputs with it, and a file someone else wrote
|
|
158
|
-
* is never overwritten.
|
|
159
|
-
*/
|
|
160
|
-
|
|
161
|
-
declare const LOCK_FILE = "pmcp.lock";
|
|
162
243
|
interface ProjectResult {
|
|
163
244
|
readonly backup?: string;
|
|
164
|
-
/** 0 done or clean, 2 check found problems, 3 refused to overwrite. */
|
|
165
245
|
readonly code: 0 | 2 | 3;
|
|
166
246
|
readonly problems: readonly string[];
|
|
247
|
+
readonly warnings?: readonly string[];
|
|
167
248
|
readonly outputs: number;
|
|
168
249
|
readonly pruned: number;
|
|
169
250
|
}
|
|
170
|
-
|
|
251
|
+
|
|
171
252
|
declare function deadGlobs(root: string, outputs: readonly Output[]): string[];
|
|
253
|
+
|
|
254
|
+
declare const LOCK_FILE = "pmcp.lock";
|
|
255
|
+
|
|
172
256
|
declare function project(spec: ProjectSpec, options: {
|
|
173
257
|
readonly check: boolean;
|
|
174
258
|
}): ProjectResult;
|
|
175
259
|
|
|
176
|
-
|
|
177
|
-
* Asks each tool what it loads, through its own listing commands only: no
|
|
178
|
-
* model is called. A tool whose CLI is not installed is skipped, not failed.
|
|
179
|
-
*/
|
|
180
|
-
|
|
181
|
-
interface RunResult {
|
|
182
|
-
/** The executable was not found. */
|
|
183
|
-
readonly missing: boolean;
|
|
184
|
-
readonly status: number | null;
|
|
185
|
-
readonly stdout: string;
|
|
186
|
-
}
|
|
187
|
-
type Runner = (command: string, args: readonly string[], cwd: string, env?: Readonly<Record<string, string | undefined>>) => RunResult;
|
|
188
|
-
type Status = "ok" | "fail" | "skip";
|
|
189
|
-
interface Finding$1 {
|
|
190
|
-
readonly tool: Tool | "project";
|
|
191
|
-
readonly check: string;
|
|
192
|
-
readonly status: Status;
|
|
193
|
-
readonly detail?: string;
|
|
194
|
-
}
|
|
195
|
-
interface DoctorOptions {
|
|
196
|
-
readonly env?: Readonly<Record<string, string | undefined>>;
|
|
197
|
-
readonly run: Runner;
|
|
198
|
-
readonly home: string;
|
|
199
|
-
readonly only?: ReadonlySet<Tool>;
|
|
200
|
-
}
|
|
201
|
-
declare function doctor(spec: ProjectSpec, options: DoctorOptions): Finding$1[];
|
|
202
|
-
|
|
203
|
-
/**
|
|
204
|
-
* Links each package's path-scoped rule file into .claude/rules/<dir>/. One level
|
|
205
|
-
* down because Grok Build loads every top-level .claude/rules/*.md unscoped.
|
|
206
|
-
* Names already in use are kept, so moving the links renames nothing.
|
|
207
|
-
*/
|
|
260
|
+
declare function doctor(spec: ProjectSpec, options: DoctorOptions): Finding[];
|
|
208
261
|
|
|
209
262
|
declare class ProjectError extends Error {
|
|
210
263
|
constructor(message: string);
|
|
211
264
|
}
|
|
212
265
|
declare function deriveName(dir: string, strip: readonly string[]): string;
|
|
213
266
|
|
|
214
|
-
/**
|
|
215
|
-
* One catalog skill as the Skills extension (SEP-2640) describes it: frontmatter
|
|
216
|
-
* plus a complete manifest of its files with sha256 digests and sizes.
|
|
217
|
-
*/
|
|
218
|
-
|
|
219
267
|
interface SkillResource {
|
|
220
268
|
readonly uri: string;
|
|
221
269
|
readonly digest: string;
|
|
@@ -226,106 +274,36 @@ interface SkillExtensionEntry {
|
|
|
226
274
|
readonly frontmatter: Readonly<Record<string, unknown>>;
|
|
227
275
|
readonly resources: readonly SkillResource[];
|
|
228
276
|
}
|
|
229
|
-
/**
|
|
230
|
-
* The extension's entry, or null when the skill cannot be served under SEP-2640:
|
|
231
|
-
* not a directory with SKILL.md, frontmatter that breaks the Agent Skills
|
|
232
|
-
* specification, a name unlike its path, or over the per-skill limits. Such a
|
|
233
|
-
* skill stays reachable through the skill_* tools.
|
|
234
|
-
*/
|
|
235
277
|
declare function extensionEntry(entry: SkillEntry): SkillExtensionEntry | null;
|
|
236
278
|
|
|
237
|
-
/**
|
|
238
|
-
* The Skills extension's methods, skills/list and skills/get. Their files are
|
|
239
|
-
* served by the skill:// resources (resources.ts), which every surface shares.
|
|
240
|
-
*/
|
|
241
|
-
|
|
242
279
|
declare const SKILLS_EXTENSION = "io.modelcontextprotocol/skills";
|
|
243
280
|
interface SkillsExtensionOptions {
|
|
244
|
-
/**
|
|
245
|
-
* "public" when every caller sees the same catalog; "private" when the list is
|
|
246
|
-
* filtered per caller, as it is behind authorization.
|
|
247
|
-
*/
|
|
248
281
|
readonly cacheScope?: "public" | "private";
|
|
249
282
|
}
|
|
250
|
-
/** Declares the extension and its methods. Must run before the server connects. */
|
|
251
283
|
declare function registerSkillsExtension(server: McpServer, skills: () => readonly SkillEntry[], options?: SkillsExtensionOptions): void;
|
|
252
284
|
|
|
253
|
-
/**
|
|
254
|
-
* skill:// URIs for skill files. The authority names this server's namespace and
|
|
255
|
-
* resolves to nothing; the path is the catalog name, then the file inside it.
|
|
256
|
-
*/
|
|
257
|
-
|
|
258
285
|
declare const skillFileUri: (entry: Pick<SkillEntry, "name">, file?: string) => string;
|
|
259
|
-
/**
|
|
260
|
-
* The catalog entry and relative file a URI names, matched against the entries
|
|
261
|
-
* the caller may see. Names contain slashes, so the longest matching name wins.
|
|
262
|
-
*/
|
|
263
286
|
declare function resolveSkillFileUri(uri: string, entries: readonly SkillEntry[]): {
|
|
264
287
|
entry: SkillEntry;
|
|
265
288
|
file: string;
|
|
266
289
|
} | null;
|
|
267
290
|
|
|
268
|
-
/**
|
|
269
|
-
* The catalog, spoken over MCP: the skill_* tools, skill:// resources, the
|
|
270
|
-
* Skills extension and, when asked for, one prompt per skill.
|
|
271
|
-
*
|
|
272
|
-
* Thin on purpose: every decision is in createSkillTools and the modules under
|
|
273
|
-
* tools/ and files/; this file only composes them on one server.
|
|
274
|
-
*/
|
|
275
|
-
|
|
276
|
-
/** Reported to the host on connect. */
|
|
277
291
|
declare const SERVER_NAME = "pmcp";
|
|
278
|
-
declare const SERVER_VERSION = "0.
|
|
279
|
-
/**
|
|
280
|
-
* Registers the skill_* tools on a server.
|
|
281
|
-
*
|
|
282
|
-
* Exported separately from the stdio entry so a consumer already running an MCP
|
|
283
|
-
* server can add these to it rather than starting a second process.
|
|
284
|
-
*/
|
|
292
|
+
declare const SERVER_VERSION = "0.18.0";
|
|
285
293
|
declare function registerSkillTools(server: McpServer, tools: SkillTools): McpServer;
|
|
286
294
|
interface SkillMcpOptions extends SkillServerOptions {
|
|
287
295
|
readonly mailbox?: MailboxService;
|
|
288
|
-
/** One prompt per skill, for hosts that offer prompts as commands. Off by default. */
|
|
289
296
|
readonly prompts?: boolean;
|
|
290
297
|
readonly skillsExtension?: SkillsExtensionOptions;
|
|
291
298
|
}
|
|
292
|
-
/**
|
|
293
|
-
* A server with everything registered.
|
|
294
|
-
*
|
|
295
|
-
* The catalog is read on first use rather than here, so a host that connects
|
|
296
|
-
* and never asks pays nothing for the walk.
|
|
297
|
-
*/
|
|
298
299
|
declare function createSkillServer(options: SkillMcpOptions): McpServer;
|
|
299
300
|
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
interface Finding {
|
|
303
|
-
readonly path: string;
|
|
304
|
-
readonly reason: string;
|
|
305
|
-
/** error: the skill is left out or breaks a MUST; warning: served anyway. */
|
|
306
|
-
readonly level: "error" | "warning";
|
|
307
|
-
}
|
|
308
|
-
/** One skill directory, or the SKILL.md inside it. */
|
|
309
|
-
declare function validateSkillDir(dir: string): Finding[];
|
|
310
|
-
/** Every skill the catalog options reach, with what loading reported. */
|
|
311
|
-
declare function validateCatalog(options: CatalogOptions): Finding[];
|
|
312
|
-
|
|
313
|
-
/**
|
|
314
|
-
* skill:// resources: every file of every skill the caller may see. The tools,
|
|
315
|
-
* the Skills extension and resource links all resolve here, over the same
|
|
316
|
-
* caller-filtered catalog, so nothing a caller cannot list can be read.
|
|
317
|
-
*/
|
|
301
|
+
declare function validateSkillDir(dir: string, settings?: ValidationSettings): Finding$1[];
|
|
302
|
+
declare function validateCatalog(options: CatalogOptions, settings?: ValidationSettings): Finding$1[];
|
|
318
303
|
|
|
319
304
|
declare function registerSkillResources(server: McpServer, skills: () => readonly SkillEntry[]): void;
|
|
320
305
|
|
|
321
|
-
/**
|
|
322
|
-
* One prompt per skill, for hosts that offer prompts as commands: the Agent
|
|
323
|
-
* Skills "user-explicit activation" path. Off unless the host asks for it,
|
|
324
|
-
* because the list grows with the catalog.
|
|
325
|
-
*/
|
|
326
|
-
|
|
327
|
-
/** Prompt names travel into host command names, so they stay to a plain set. */
|
|
328
306
|
declare const promptName: (entry: Pick<SkillEntry, "name">) => string;
|
|
329
307
|
declare function registerSkillPrompts(server: McpServer, tools: SkillTools): void;
|
|
330
308
|
|
|
331
|
-
export { CatalogOptions, DEFAULT_INTENT_CACHE_LIMIT, Embedder, type Finding
|
|
309
|
+
export { CATALOG_PAGE_MAX, CATALOG_PAGE_SIZE, CatalogOptions, DEFAULT_INTENT_CACHE_LIMIT, DESCRIBE_FILE_LIMIT, Embedder, EntryVectorStore, type 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, Finding$1 as ValidationFinding, assetRoot, createSkillServer, deadGlobs, deriveName, displayPath, doctor, encodeEntries, extensionEntry, openEntryVectors, openIntentCache, plan, prepareSearch, project, promptName, readBody, readFrontmatter, readFrontmatterText, readMarketplace, readMetadata, readSpec, registerSkillPrompts, registerSkillResources, registerSkillTools, registerSkillsExtension, resolveSkillFileUri, skillFileUri, skillFileUri as skillUri, validateCatalog, validateSkillDir, withoutBody };
|