@modootoday/pmcp 0.17.4 → 0.18.2
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 +2 -2
- package/.mcp.json +1 -1
- package/CHANGELOG.md +152 -0
- package/CONTRIBUTING.md +71 -0
- package/README.md +98 -201
- package/SECURITY.md +17 -1
- package/dist/apply-JUTGS5WZ.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-CBMVOV3G.js +18 -0
- package/dist/chunk-26WLNWDG.js +93 -0
- package/dist/chunk-2FIV63WC.js +252 -0
- package/dist/chunk-2P4Z2NUX.js +28 -0
- package/dist/chunk-34DECPVC.js +22 -0
- package/dist/chunk-3FCFAQDG.js +42 -0
- package/dist/chunk-3IDXEV5E.js +1934 -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-5OMOPUE6.js +39 -0
- package/dist/chunk-5QQWS4US.js +53 -0
- package/dist/chunk-5ZABTVSW.js +48 -0
- package/dist/chunk-65KAQSJP.js +7 -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-7DLZC73N.js +29 -0
- package/dist/chunk-7GBYECSK.js +72 -0
- package/dist/chunk-7HFIGCSL.js +419 -0
- package/dist/chunk-7TD53M7L.js +13 -0
- package/dist/chunk-7UCZAN4J.js +778 -0
- package/dist/chunk-A4PKLESO.js +112 -0
- package/dist/chunk-A7VF7A35.js +1025 -0
- package/dist/chunk-ABTJQ4QV.js +74 -0
- package/dist/chunk-AJ4VXM2U.js +349 -0
- package/dist/chunk-BBTBJCFA.js +380 -0
- package/dist/chunk-BU65MNVU.js +13 -0
- package/dist/chunk-C4NHQGHL.js +142 -0
- package/dist/chunk-CJTKR6K6.js +1213 -0
- package/dist/chunk-D77IRGHO.js +1246 -0
- package/dist/chunk-DCU2EXQV.js +78 -0
- package/dist/chunk-DMZHQZ7P.js +104 -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-EATCUWGG.js +66 -0
- package/dist/chunk-EAWPJHJ7.js +155 -0
- package/dist/chunk-EIDIVIAD.js +33 -0
- package/dist/chunk-F5QYZK7E.js +396 -0
- package/dist/chunk-F5XMGOOX.js +28 -0
- package/dist/chunk-FENOGX3U.js +31 -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-I2ZP2PSA.js +211 -0
- package/dist/chunk-IG33DXLT.js +151 -0
- package/dist/chunk-IJBSOWHK.js +86 -0
- package/dist/chunk-INT7QLEU.js +114 -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-JWRZDYB5.js +59 -0
- package/dist/chunk-KMXRRSKT.js +660 -0
- package/dist/chunk-LBXO4VPG.js +73 -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-LMUBBIE2.js +83 -0
- package/dist/chunk-LTZH5E3G.js +479 -0
- package/dist/chunk-LW4TG7EL.js +39 -0
- package/dist/chunk-MPSQXSC6.js +346 -0
- package/dist/chunk-MVFH26QT.js +97 -0
- package/dist/chunk-NLEXKE7U.js +67 -0
- package/dist/chunk-NQPURJT5.js +44 -0
- package/dist/chunk-NRBQK6UX.js +105 -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-PKODFR5F.js +102 -0
- package/dist/chunk-PMJG2CXF.js +122 -0
- package/dist/chunk-Q5H3L6Y4.js +23 -0
- package/dist/chunk-QEF7EK3T.js +28 -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-R5MT42JS.js +284 -0
- package/dist/chunk-RMATE45Z.js +197 -0
- package/dist/chunk-RPQOBHVU.js +87 -0
- package/dist/chunk-S3PIAMXV.js +230 -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-TXQ7L33K.js +45 -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-VMHUEOT5.js +643 -0
- package/dist/chunk-VRPMYPZU.js +4985 -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-YSAWTGNA.js +117 -0
- package/dist/claude-U2JC2DNQ.js +77 -0
- package/dist/cli-MI4ZCAZ3.js +41 -0
- package/dist/cli-ZN7ZVDEZ.js +46 -0
- package/dist/cli.js +144 -16197
- package/dist/completion-ILSRB3LW.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-XKXVVQWH.js +93 -0
- package/dist/doctor-O2E63YGO.js +538 -0
- package/dist/entry-X6CSYQRQ.js +305 -0
- package/dist/exec-mcp-2PMWBPD7.js +365 -0
- package/dist/harness-L2KSI2ZB.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 +5222 -0
- package/dist/hook-spec-C5fWTSCH.d.ts +100 -0
- package/dist/hook.js +26 -0
- package/dist/hooks-BHTA44X7.js +21 -0
- package/dist/host-UIZAXXQH.js +22 -0
- package/dist/host-UWK754BW.js +210 -0
- package/dist/host-run-BI2OTZDZ.js +307 -0
- package/dist/http.d.ts +5 -42
- package/dist/http.js +21 -2234
- package/dist/import-mcp-GPKJI7DI.js +400 -0
- package/dist/index.d.ts +146 -168
- package/dist/index.js +133 -4948
- package/dist/init-3C2Y7BNJ.js +14 -0
- package/dist/install-GG7HHZK2.js +796 -0
- package/dist/invoke-44CJRVMK.js +23 -0
- package/dist/list-MCP2FXUF.js +68 -0
- package/dist/list-WL6L4J5H.js +65 -0
- package/dist/load-BEUBABtB.d.ts +21 -0
- package/dist/logout-F5EJ5MOU.js +44 -0
- package/dist/logs-TBUA4UWU.js +107 -0
- package/dist/mailbox/index.d.ts +10 -5
- package/dist/mailbox/index.js +53 -1572
- package/dist/mailbox-BMTZOSZ7.js +285 -0
- package/dist/mailbox-GDJ7BWQN.js +189 -0
- package/dist/mainline-KAD2ERLP.js +639 -0
- package/dist/marketplace-G4VQET5W.js +191 -0
- package/dist/mcp-235QZN2A.js +15 -0
- package/dist/mcp-FJ2UQ4RH.js +193 -0
- package/dist/models-ISU4DCMA.js +32 -0
- package/dist/opencode-CN7JLQYO.js +60 -0
- package/dist/pause-7LILUVGL.js +18 -0
- package/dist/preview-DT7DWG5F.js +91 -0
- package/dist/project/hook-adapter.d.ts +5 -2
- package/dist/project/hook-adapter.js +41 -27
- package/dist/project-5YV5CUEG.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-26VFAAMH.js +18 -0
- package/dist/run-3AXTZSR7.js +126 -0
- package/dist/run-3SOVRQIA.js +19 -0
- package/dist/serve-DQMKTFIV.js +104 -0
- package/dist/session-XM2CR425.js +159 -0
- package/dist/setup-DTKZLZUT.js +18 -0
- package/dist/start-login-YTZV6KMF.js +416 -0
- package/dist/status-A2OUTNGK.js +9 -0
- package/dist/status-H2VAHIDV.js +10 -0
- package/dist/status-MROQ7WR7.js +43 -0
- package/dist/status-RO55QPKV.js +55 -0
- package/dist/status-UME2L33L.js +286 -0
- package/dist/stdio.d.ts +3 -13
- package/dist/stdio.js +16 -3186
- package/dist/sweep-35LGQTTO.js +18 -0
- package/dist/test-AGZOJLRZ.js +561 -0
- package/dist/tools-gpHNq9Dh.d.ts +328 -0
- package/dist/tui-G5LLWCSV.js +153 -0
- package/dist/unbroadcast-5QNGAJR2.js +18 -0
- package/dist/validate-IU52H2IC.js +46 -0
- package/dist/worker-QZ5T6LJD.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/authoring.md +82 -0
- package/docs/browser-and-desktop.md +46 -0
- package/docs/commands.md +325 -0
- package/docs/compare.md +35 -0
- package/docs/compatibility.md +55 -0
- package/docs/embeddings.md +1 -1
- package/docs/getting-started.md +105 -0
- package/docs/git-workflow.md +60 -0
- package/docs/glossary.md +31 -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/hooks.md +264 -0
- package/docs/install.md +72 -0
- package/docs/library-skills.md +132 -0
- package/docs/mailbox.md +16 -5
- package/docs/project-configuration.md +540 -58
- package/docs/sessions.md +64 -0
- package/docs/skills.md +4 -45
- package/docs/terminal-harness.md +92 -44
- package/docs/terminal-workspace.md +81 -169
- package/gemini-extension.json +2 -2
- package/mcp.json +1 -1
- package/package.json +16 -2
- package/plugin.json +2 -2
- package/plugins/pmcp/.claude-plugin/plugin.json +4 -2
- package/plugins/pmcp/.mcp.json +1 -1
- package/plugins/pmcp/gemini-extension.json +2 -2
- package/plugins/pmcp/mcp.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 +2 -2
- package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +96 -0
- package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +101 -0
- package/plugins/pmcp/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
- package/plugins/pmcp/skills/package-skill-catalog/SKILL.md +51 -15
- package/plugins/pmcp/skills/pmcp-browser/SKILL.md +27 -0
- package/plugins/pmcp/skills/pmcp-desktop/SKILL.md +25 -0
- package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +153 -0
- package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +96 -0
- package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +89 -0
- package/schema/catalog-v1.json +187 -0
- package/schema/library.json +196 -0
- package/schema/marketplace-manifest.json +144 -0
- package/schema/plugin-manifest.json +59 -0
- package/schema/skill-frontmatter.json +170 -0
- package/schema/skill-metadata-core.json +131 -0
- package/skills/agent-assets-migrate/SKILL.md +96 -0
- package/skills/headless-agents-ci-scaffold/SKILL.md +101 -0
- package/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
- package/skills/package-skill-catalog/SKILL.md +51 -15
- package/skills/pmcp-browser/SKILL.md +27 -0
- package/skills/pmcp-desktop/SKILL.md +25 -0
- package/skills/pmcp-project-init/SKILL.md +153 -0
- package/skills/pmcp-sessions-and-git/SKILL.md +96 -0
- package/skills/skill-package-scaffold/SKILL.md +89 -0
- package/dist/config-BkSpjUG6.d.ts +0 -50
- package/dist/embed-DRROSD3F.d.ts +0 -53
- package/dist/hook-spec-CSJJySsH.d.ts +0 -11
- package/dist/server-VWSY3Shw.d.ts +0 -543
- package/dist/tui-worker.js +0 -6549
- package/docs/manual-library-skills.md +0 -74
- /package/dist/{tui-worker.d.ts → hook.d.ts} +0 -0
|
@@ -0,0 +1,284 @@
|
|
|
1
|
+
import {
|
|
2
|
+
globalDir
|
|
3
|
+
} from "./chunk-RMATE45Z.js";
|
|
4
|
+
import {
|
|
5
|
+
publicMarketplaceRoot
|
|
6
|
+
} from "./chunk-73AKO4UL.js";
|
|
7
|
+
import {
|
|
8
|
+
ArgumentError,
|
|
9
|
+
one
|
|
10
|
+
} from "./chunk-A4PKLESO.js";
|
|
11
|
+
|
|
12
|
+
// src/commands/remote-options.ts
|
|
13
|
+
import { dirname, join as join2, resolve } from "path";
|
|
14
|
+
import { existsSync, readFileSync as readFileSync3 } from "fs";
|
|
15
|
+
|
|
16
|
+
// src/remote/catalog.ts
|
|
17
|
+
import { readFileSync as readFileSync2, statSync } from "fs";
|
|
18
|
+
import semver from "semver";
|
|
19
|
+
import { z } from "zod";
|
|
20
|
+
|
|
21
|
+
// src/remote/catalog-cache.ts
|
|
22
|
+
import { mkdirSync, readFileSync, renameSync, writeFileSync } from "fs";
|
|
23
|
+
import { join } from "path";
|
|
24
|
+
var MAX_CACHE_BYTES = 8 * 1024 * 1024;
|
|
25
|
+
function memoryCatalogCache() {
|
|
26
|
+
const held = /* @__PURE__ */ new Map();
|
|
27
|
+
return {
|
|
28
|
+
read: (origin) => held.get(origin) ?? null,
|
|
29
|
+
write: (origin, entry2) => {
|
|
30
|
+
held.set(origin, entry2);
|
|
31
|
+
}
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
function fileCatalogCache(dir) {
|
|
35
|
+
const path = join(dir, "catalog-cache.json");
|
|
36
|
+
return {
|
|
37
|
+
read(origin) {
|
|
38
|
+
try {
|
|
39
|
+
const raw = readFileSync(path, "utf8");
|
|
40
|
+
if (raw.length > MAX_CACHE_BYTES) return null;
|
|
41
|
+
const held = JSON.parse(raw);
|
|
42
|
+
if (typeof held !== "object" || held === null) return null;
|
|
43
|
+
const record = held;
|
|
44
|
+
if (record["origin"] !== origin) return null;
|
|
45
|
+
const etag = record["etag"];
|
|
46
|
+
const body = record["body"];
|
|
47
|
+
if (typeof etag !== "string" || typeof body !== "string") return null;
|
|
48
|
+
return { etag, body };
|
|
49
|
+
} catch {
|
|
50
|
+
return null;
|
|
51
|
+
}
|
|
52
|
+
},
|
|
53
|
+
write(origin, entry2) {
|
|
54
|
+
try {
|
|
55
|
+
if (entry2.body.length > MAX_CACHE_BYTES) return;
|
|
56
|
+
mkdirSync(dir, { recursive: true });
|
|
57
|
+
const temporary = `${path}.${String(process.pid)}`;
|
|
58
|
+
writeFileSync(
|
|
59
|
+
temporary,
|
|
60
|
+
`${JSON.stringify({ origin, etag: entry2.etag, body: entry2.body })}
|
|
61
|
+
`,
|
|
62
|
+
{ mode: 384 }
|
|
63
|
+
);
|
|
64
|
+
renameSync(temporary, path);
|
|
65
|
+
} catch {
|
|
66
|
+
return;
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
// src/remote/catalog.ts
|
|
73
|
+
var npmName = z.string().max(214).regex(/^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/u);
|
|
74
|
+
var version = z.string().refine(
|
|
75
|
+
(value) => semver.valid(value) !== null && semver.valid(value) === value.split("+")[0]
|
|
76
|
+
);
|
|
77
|
+
var target = z.object({
|
|
78
|
+
packageName: npmName,
|
|
79
|
+
range: z.string().min(1).refine((value) => semver.validRange(value) !== null),
|
|
80
|
+
verifiedVersions: z.array(version).min(1)
|
|
81
|
+
}).refine(
|
|
82
|
+
(value) => value.verifiedVersions.every((item) => semver.satisfies(item, value.range))
|
|
83
|
+
);
|
|
84
|
+
var deliveryName = npmName.refine(
|
|
85
|
+
(value) => value.startsWith("@modootoday/pmcp-")
|
|
86
|
+
);
|
|
87
|
+
var entry = z.object({
|
|
88
|
+
productId: z.string().min(1),
|
|
89
|
+
title: z.string().min(1),
|
|
90
|
+
summary: z.string().min(1),
|
|
91
|
+
delivery: z.object({
|
|
92
|
+
packageName: deliveryName,
|
|
93
|
+
version,
|
|
94
|
+
integrity: z.string().regex(/^sha512-[A-Za-z0-9+/]{86}==$/u)
|
|
95
|
+
}),
|
|
96
|
+
skillRevision: z.number().int().positive(),
|
|
97
|
+
contentDigest: z.string().regex(/^sha256:[a-f0-9]{64}$/u),
|
|
98
|
+
evidence: z.object({
|
|
99
|
+
verifiedOn: z.string().regex(/^\d{4}-\d{2}-\d{2}$/u).optional(),
|
|
100
|
+
examplesExecuted: z.number().int().positive()
|
|
101
|
+
}),
|
|
102
|
+
// Keep previews optional so older published snapshots remain readable.
|
|
103
|
+
preview: z.object({
|
|
104
|
+
headings: z.array(z.string().min(1)),
|
|
105
|
+
example: z.string().min(1)
|
|
106
|
+
}).optional(),
|
|
107
|
+
// Keep standing optional so older catalog entries remain compatible.
|
|
108
|
+
line: z.object({
|
|
109
|
+
major: z.number().int().nonnegative(),
|
|
110
|
+
status: z.enum(["active", "frozen", "recalled"]),
|
|
111
|
+
recall: z.object({
|
|
112
|
+
advisoryUrl: z.string().url(),
|
|
113
|
+
severity: z.enum(["high", "critical"]),
|
|
114
|
+
summary: z.string().min(1),
|
|
115
|
+
reverifyAt: version.optional()
|
|
116
|
+
}).optional()
|
|
117
|
+
}).optional(),
|
|
118
|
+
targets: z.array(target).min(1)
|
|
119
|
+
});
|
|
120
|
+
var responseSchema = z.object({
|
|
121
|
+
schemaVersion: z.literal(1),
|
|
122
|
+
requestId: z.string().min(1),
|
|
123
|
+
catalog: z.object({
|
|
124
|
+
revision: z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/u),
|
|
125
|
+
publishedAt: z.string().datetime(),
|
|
126
|
+
entries: z.array(entry)
|
|
127
|
+
})
|
|
128
|
+
});
|
|
129
|
+
var MAX_CATALOG_BYTES = 5 * 1024 * 1024;
|
|
130
|
+
var DEFAULT_API_ORIGIN = "https://api.pmcp.build";
|
|
131
|
+
function parseCatalog(value) {
|
|
132
|
+
const parsed = responseSchema.safeParse(value);
|
|
133
|
+
if (!parsed.success)
|
|
134
|
+
throw new Error("the service returned an invalid catalog");
|
|
135
|
+
const identities = /* @__PURE__ */ new Set();
|
|
136
|
+
for (const entry2 of parsed.data.catalog.entries) {
|
|
137
|
+
const identity = JSON.stringify([entry2.productId, entry2.skillRevision]);
|
|
138
|
+
if (identities.has(identity))
|
|
139
|
+
throw new Error("the catalog contains duplicate revisions");
|
|
140
|
+
identities.add(identity);
|
|
141
|
+
}
|
|
142
|
+
return parsed.data.catalog;
|
|
143
|
+
}
|
|
144
|
+
function catalogEndpoint(origin) {
|
|
145
|
+
const url = new URL(origin);
|
|
146
|
+
if (url.protocol !== "https:" || url.username || url.password || url.search || url.hash || url.pathname !== "/") {
|
|
147
|
+
throw new Error(
|
|
148
|
+
"the API origin must be an HTTPS origin without credentials or a path"
|
|
149
|
+
);
|
|
150
|
+
}
|
|
151
|
+
return new URL("/v1/catalog", url).href;
|
|
152
|
+
}
|
|
153
|
+
function readCatalogFile(path) {
|
|
154
|
+
const stat = statSync(path);
|
|
155
|
+
if (!stat.isFile() || stat.size > MAX_CATALOG_BYTES)
|
|
156
|
+
throw new Error("catalog file exceeds the supported size");
|
|
157
|
+
const bytes = readFileSync2(path);
|
|
158
|
+
if (bytes.byteLength > MAX_CATALOG_BYTES)
|
|
159
|
+
throw new Error("catalog file exceeds the supported size");
|
|
160
|
+
return parseCatalog(JSON.parse(bytes.toString("utf8")));
|
|
161
|
+
}
|
|
162
|
+
async function fetchCatalog(origin, fetcher = fetch, cache = memoryCatalogCache()) {
|
|
163
|
+
const held = cache.read(origin);
|
|
164
|
+
if (held) {
|
|
165
|
+
try {
|
|
166
|
+
return await request(origin, fetcher, held, cache);
|
|
167
|
+
} catch (error) {
|
|
168
|
+
if (!(error instanceof StaleCacheError)) throw error;
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
return await request(origin, fetcher, null, cache);
|
|
172
|
+
}
|
|
173
|
+
var StaleCacheError = class extends Error {
|
|
174
|
+
};
|
|
175
|
+
async function request(origin, fetcher, held, cache) {
|
|
176
|
+
const response = await fetcher(catalogEndpoint(origin), {
|
|
177
|
+
method: "GET",
|
|
178
|
+
headers: held ? { accept: "application/json", "if-none-match": held.etag } : { accept: "application/json" },
|
|
179
|
+
redirect: "error",
|
|
180
|
+
signal: AbortSignal.timeout(15e3)
|
|
181
|
+
});
|
|
182
|
+
if (response.status === 304) {
|
|
183
|
+
if (!held) throw new Error("catalog answered 304 to an unconditional read");
|
|
184
|
+
try {
|
|
185
|
+
return parseCatalog(JSON.parse(held.body));
|
|
186
|
+
} catch {
|
|
187
|
+
throw new StaleCacheError("the held catalog no longer parses");
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
if (!response.ok)
|
|
191
|
+
throw new Error(`catalog request failed (${response.status})`);
|
|
192
|
+
if (!response.headers.get("content-type")?.toLowerCase().startsWith("application/json")) {
|
|
193
|
+
throw new Error("catalog response is not JSON");
|
|
194
|
+
}
|
|
195
|
+
if (!response.body) throw new Error("catalog response has no body");
|
|
196
|
+
const reader = response.body.getReader();
|
|
197
|
+
const chunks = [];
|
|
198
|
+
let size = 0;
|
|
199
|
+
try {
|
|
200
|
+
for (; ; ) {
|
|
201
|
+
const { done, value } = await reader.read();
|
|
202
|
+
if (done) break;
|
|
203
|
+
size += value.byteLength;
|
|
204
|
+
if (size > MAX_CATALOG_BYTES)
|
|
205
|
+
throw new Error("catalog response exceeds the supported size");
|
|
206
|
+
chunks.push(value);
|
|
207
|
+
}
|
|
208
|
+
} finally {
|
|
209
|
+
await reader.cancel().catch(() => void 0);
|
|
210
|
+
reader.releaseLock();
|
|
211
|
+
}
|
|
212
|
+
const bytes = new Uint8Array(size);
|
|
213
|
+
let offset = 0;
|
|
214
|
+
for (const chunk of chunks) {
|
|
215
|
+
bytes.set(chunk, offset);
|
|
216
|
+
offset += chunk.byteLength;
|
|
217
|
+
}
|
|
218
|
+
const text = new TextDecoder().decode(bytes);
|
|
219
|
+
const catalog = parseCatalog(JSON.parse(text));
|
|
220
|
+
const tag = response.headers.get("etag");
|
|
221
|
+
if (tag !== null && tag !== "")
|
|
222
|
+
cache.write(origin, { etag: tag, body: text });
|
|
223
|
+
return catalog;
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
// src/commands/remote-options.ts
|
|
227
|
+
function catalogProvider(context) {
|
|
228
|
+
const given = one(context.args, "provider");
|
|
229
|
+
if (given !== void 0 && given !== "public" && given !== "hosted")
|
|
230
|
+
throw new ArgumentError("Choose --provider public or hosted");
|
|
231
|
+
const givenApi = one(context.args, "api");
|
|
232
|
+
const api = givenApi ?? context.env.PMCP_API_ORIGIN;
|
|
233
|
+
if (given === "public" && givenApi)
|
|
234
|
+
throw new ArgumentError(
|
|
235
|
+
"The public provider does not accept a hosted API origin"
|
|
236
|
+
);
|
|
237
|
+
return given ?? (api ? "hosted" : "public");
|
|
238
|
+
}
|
|
239
|
+
function projectFrom(context) {
|
|
240
|
+
const explicit = one(context.args, "project");
|
|
241
|
+
if (explicit) return resolve(context.cwd, explicit);
|
|
242
|
+
let directory = resolve(context.cwd);
|
|
243
|
+
for (; ; ) {
|
|
244
|
+
if (existsSync(join2(directory, "package.json"))) return directory;
|
|
245
|
+
if (existsSync(join2(directory, ".git")) || dirname(directory) === directory)
|
|
246
|
+
throw new ArgumentError(
|
|
247
|
+
"No project package.json found; provide --project"
|
|
248
|
+
);
|
|
249
|
+
directory = dirname(directory);
|
|
250
|
+
}
|
|
251
|
+
}
|
|
252
|
+
function apiOrigin(context) {
|
|
253
|
+
return one(context.args, "api") ?? context.env["PMCP_API_ORIGIN"] ?? DEFAULT_API_ORIGIN;
|
|
254
|
+
}
|
|
255
|
+
async function remoteCatalog(context) {
|
|
256
|
+
const provider = catalogProvider(context);
|
|
257
|
+
const file = one(context.args, "catalog");
|
|
258
|
+
if (file) {
|
|
259
|
+
if (one(context.args, "api"))
|
|
260
|
+
throw new Error("choose --catalog or --api, not both");
|
|
261
|
+
return readCatalogFile(resolve(context.cwd, file));
|
|
262
|
+
}
|
|
263
|
+
if (provider === "public") {
|
|
264
|
+
const catalog = JSON.parse(
|
|
265
|
+
readFileSync3(join2(publicMarketplaceRoot(), "docs/catalog.json"), "utf8")
|
|
266
|
+
);
|
|
267
|
+
return parseCatalog({
|
|
268
|
+
schemaVersion: 1,
|
|
269
|
+
requestId: "bundled-public",
|
|
270
|
+
catalog
|
|
271
|
+
});
|
|
272
|
+
}
|
|
273
|
+
return fetchCatalog(apiOrigin(context), fetch, fileCatalogCache(globalDir()));
|
|
274
|
+
}
|
|
275
|
+
|
|
276
|
+
export {
|
|
277
|
+
DEFAULT_API_ORIGIN,
|
|
278
|
+
catalogEndpoint,
|
|
279
|
+
catalogProvider,
|
|
280
|
+
projectFrom,
|
|
281
|
+
apiOrigin,
|
|
282
|
+
remoteCatalog
|
|
283
|
+
};
|
|
284
|
+
//# sourceMappingURL=chunk-R5MT42JS.js.map
|
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
// src/remote/session/storage.ts
|
|
2
|
+
import {
|
|
3
|
+
chmodSync,
|
|
4
|
+
closeSync,
|
|
5
|
+
fchmodSync,
|
|
6
|
+
mkdirSync,
|
|
7
|
+
openSync,
|
|
8
|
+
readFileSync,
|
|
9
|
+
rmSync,
|
|
10
|
+
writeSync
|
|
11
|
+
} from "fs";
|
|
12
|
+
import { homedir } from "os";
|
|
13
|
+
import { join } from "path";
|
|
14
|
+
function globalDir(home = homedir(), env = process.env) {
|
|
15
|
+
const xdg = env["XDG_CONFIG_HOME"];
|
|
16
|
+
return xdg !== void 0 && xdg !== "" ? join(xdg, "pmcp") : join(home, ".pmcp");
|
|
17
|
+
}
|
|
18
|
+
var sessionPath = (home) => join(globalDir(home), "session.json");
|
|
19
|
+
function readSession(home) {
|
|
20
|
+
try {
|
|
21
|
+
return JSON.parse(readFileSync(sessionPath(home), "utf8"));
|
|
22
|
+
} catch {
|
|
23
|
+
return null;
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
function writeSession(session, home) {
|
|
27
|
+
const path = sessionPath(home);
|
|
28
|
+
const directory = globalDir(home);
|
|
29
|
+
mkdirSync(directory, { recursive: true, mode: 448 });
|
|
30
|
+
chmodSync(directory, 448);
|
|
31
|
+
const fd = openSync(path, "w", 384);
|
|
32
|
+
try {
|
|
33
|
+
fchmodSync(fd, 384);
|
|
34
|
+
writeSync(fd, `${JSON.stringify(session, null, 2)}
|
|
35
|
+
`);
|
|
36
|
+
} finally {
|
|
37
|
+
closeSync(fd);
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
function clearSession(home) {
|
|
41
|
+
try {
|
|
42
|
+
rmSync(sessionPath(home));
|
|
43
|
+
} catch {
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
// src/remote/session/_shared.ts
|
|
48
|
+
var DEVICE_GRANT = "urn:ietf:params:oauth:grant-type:device_code";
|
|
49
|
+
var form = (fields) => new URLSearchParams(fields).toString();
|
|
50
|
+
var FORM_HEADERS = {
|
|
51
|
+
"content-type": "application/x-www-form-urlencoded"
|
|
52
|
+
};
|
|
53
|
+
|
|
54
|
+
// src/remote/session/discovery.ts
|
|
55
|
+
function validateIssuerUrl(value, issuer) {
|
|
56
|
+
const url = new URL(value);
|
|
57
|
+
if (url.protocol !== "https:" || url.origin !== new URL(issuer).origin || url.username || url.password || url.hash) {
|
|
58
|
+
throw new Error("OAuth endpoint must stay on the issuer origin");
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
async function discover(issuer, fetcher) {
|
|
62
|
+
const base = issuer.replace(/\/+$/, "");
|
|
63
|
+
const source = new URL(base);
|
|
64
|
+
if (source.protocol !== "https:" || source.username || source.password || source.search || source.hash) {
|
|
65
|
+
throw new Error("the issuer must be a plain HTTPS origin");
|
|
66
|
+
}
|
|
67
|
+
const res = await fetcher(`${base}/.well-known/oauth-authorization-server`);
|
|
68
|
+
if (!res.ok)
|
|
69
|
+
throw new Error(`issuer did not answer discovery (${res.status})`);
|
|
70
|
+
const body = await res.json();
|
|
71
|
+
if (!body.token_endpoint || !body.device_authorization_endpoint) {
|
|
72
|
+
throw new Error("issuer advertises no device grant");
|
|
73
|
+
}
|
|
74
|
+
for (const endpoint of [
|
|
75
|
+
body.token_endpoint,
|
|
76
|
+
body.device_authorization_endpoint,
|
|
77
|
+
body.revocation_endpoint
|
|
78
|
+
]) {
|
|
79
|
+
if (endpoint !== void 0) validateIssuerUrl(endpoint, base);
|
|
80
|
+
}
|
|
81
|
+
const grants = body.grant_types_supported ?? [];
|
|
82
|
+
if (grants.length > 0 && !grants.includes(DEVICE_GRANT)) {
|
|
83
|
+
throw new Error("issuer does not support the device grant");
|
|
84
|
+
}
|
|
85
|
+
return body;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
// src/remote/session/tokens.ts
|
|
89
|
+
async function revoke(metadata, session, clientId, fetcher) {
|
|
90
|
+
if (!metadata.revocation_endpoint) return false;
|
|
91
|
+
validateIssuerUrl(metadata.revocation_endpoint, session.issuer);
|
|
92
|
+
let revoked = true;
|
|
93
|
+
const tokens = [session.refreshToken, session.accessToken].filter(
|
|
94
|
+
(token) => typeof token === "string" && token !== ""
|
|
95
|
+
);
|
|
96
|
+
for (const token of tokens) {
|
|
97
|
+
try {
|
|
98
|
+
const res = await fetcher(metadata.revocation_endpoint, {
|
|
99
|
+
method: "POST",
|
|
100
|
+
headers: FORM_HEADERS,
|
|
101
|
+
body: form({ token, client_id: clientId })
|
|
102
|
+
});
|
|
103
|
+
if (!res.ok) revoked = false;
|
|
104
|
+
} catch {
|
|
105
|
+
revoked = false;
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
return revoked;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
// src/remote/session/device.ts
|
|
112
|
+
async function startDevice(metadata, request, fetcher, now = Date.now) {
|
|
113
|
+
const res = await fetcher(metadata.device_authorization_endpoint, {
|
|
114
|
+
method: "POST",
|
|
115
|
+
headers: FORM_HEADERS,
|
|
116
|
+
body: form({
|
|
117
|
+
client_id: request.clientId,
|
|
118
|
+
resource: request.resource,
|
|
119
|
+
scope: request.scope
|
|
120
|
+
})
|
|
121
|
+
});
|
|
122
|
+
const body = await res.json();
|
|
123
|
+
if (!res.ok) {
|
|
124
|
+
throw new Error(
|
|
125
|
+
String(body["error"] ?? `device request failed (${res.status})`)
|
|
126
|
+
);
|
|
127
|
+
}
|
|
128
|
+
const deviceCode = body["device_code"];
|
|
129
|
+
const userCode = body["user_code"];
|
|
130
|
+
const verificationUri = body["verification_uri"];
|
|
131
|
+
if (typeof deviceCode !== "string" || typeof userCode !== "string" || typeof verificationUri !== "string") {
|
|
132
|
+
throw new Error("device response is missing a field");
|
|
133
|
+
}
|
|
134
|
+
const interval = Number(body["interval"] ?? 5);
|
|
135
|
+
const expires = Number(body["expires_in"] ?? 600);
|
|
136
|
+
const complete = body["verification_uri_complete"];
|
|
137
|
+
return {
|
|
138
|
+
deviceCode,
|
|
139
|
+
userCode,
|
|
140
|
+
verificationUri,
|
|
141
|
+
...typeof complete === "string" ? { verificationUriComplete: complete } : {},
|
|
142
|
+
intervalMs: (Number.isFinite(interval) ? interval : 5) * 1e3,
|
|
143
|
+
expiresAt: now() + (Number.isFinite(expires) ? expires : 600) * 1e3
|
|
144
|
+
};
|
|
145
|
+
}
|
|
146
|
+
async function pollOnce(metadata, request, fetcher, now = Date.now) {
|
|
147
|
+
const res = await fetcher(metadata.token_endpoint, {
|
|
148
|
+
method: "POST",
|
|
149
|
+
headers: FORM_HEADERS,
|
|
150
|
+
body: form({
|
|
151
|
+
grant_type: DEVICE_GRANT,
|
|
152
|
+
device_code: request.deviceCode,
|
|
153
|
+
client_id: request.clientId
|
|
154
|
+
})
|
|
155
|
+
});
|
|
156
|
+
const body = await res.json();
|
|
157
|
+
if (res.ok) {
|
|
158
|
+
const token = body["access_token"];
|
|
159
|
+
if (typeof token !== "string")
|
|
160
|
+
throw new Error("token response has no token");
|
|
161
|
+
const expiresIn = Number(body["expires_in"]);
|
|
162
|
+
const refresh3 = body["refresh_token"];
|
|
163
|
+
const scope = body["scope"];
|
|
164
|
+
return {
|
|
165
|
+
kind: "granted",
|
|
166
|
+
session: {
|
|
167
|
+
issuer: request.issuer,
|
|
168
|
+
accessToken: token,
|
|
169
|
+
...typeof refresh3 === "string" ? { refreshToken: refresh3 } : {},
|
|
170
|
+
...Number.isFinite(expiresIn) ? { expiresAt: now() + expiresIn * 1e3 } : {},
|
|
171
|
+
...typeof scope === "string" ? { scope } : {}
|
|
172
|
+
}
|
|
173
|
+
};
|
|
174
|
+
}
|
|
175
|
+
switch (body["error"]) {
|
|
176
|
+
case "authorization_pending":
|
|
177
|
+
return { kind: "pending" };
|
|
178
|
+
case "slow_down":
|
|
179
|
+
return { kind: "slow_down" };
|
|
180
|
+
case "expired_token":
|
|
181
|
+
return { kind: "expired" };
|
|
182
|
+
default:
|
|
183
|
+
return { kind: "denied" };
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
export {
|
|
188
|
+
globalDir,
|
|
189
|
+
readSession,
|
|
190
|
+
writeSession,
|
|
191
|
+
clearSession,
|
|
192
|
+
discover,
|
|
193
|
+
revoke,
|
|
194
|
+
startDevice,
|
|
195
|
+
pollOnce
|
|
196
|
+
};
|
|
197
|
+
//# sourceMappingURL=chunk-RMATE45Z.js.map
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
import {
|
|
2
|
+
createSkillServer
|
|
3
|
+
} from "./chunk-D77IRGHO.js";
|
|
4
|
+
import {
|
|
5
|
+
attachMailbox
|
|
6
|
+
} from "./chunk-HDMBVLCZ.js";
|
|
7
|
+
|
|
8
|
+
// src/stdio.ts
|
|
9
|
+
import { serveStdio } from "@modelcontextprotocol/server/stdio";
|
|
10
|
+
function resolveRoots(argv, cwd) {
|
|
11
|
+
const given = argv.filter((arg) => !arg.startsWith("-"));
|
|
12
|
+
return given.length > 0 ? given : [`${cwd}/node_modules`];
|
|
13
|
+
}
|
|
14
|
+
function serve(catalog, serving = {}) {
|
|
15
|
+
const options = {
|
|
16
|
+
...catalog,
|
|
17
|
+
...serving,
|
|
18
|
+
onReject: ({ path, reason }) => process.stderr.write(`pmcp: skipped ${path}: ${reason}
|
|
19
|
+
`),
|
|
20
|
+
onWarning: ({ path, reason }) => process.stderr.write(`pmcp: warning ${path}: ${reason}
|
|
21
|
+
`)
|
|
22
|
+
};
|
|
23
|
+
return serveStdio(() => createSkillServer(options), {
|
|
24
|
+
// Keep diagnostics on stderr because stdout carries the MCP protocol.
|
|
25
|
+
onerror: (error) => process.stderr.write(`pmcp: ${error.message}
|
|
26
|
+
`)
|
|
27
|
+
});
|
|
28
|
+
}
|
|
29
|
+
async function serveWithMailbox(catalog, mailbox, serving = {}) {
|
|
30
|
+
let stop;
|
|
31
|
+
const attachment = await attachMailbox({
|
|
32
|
+
...mailbox,
|
|
33
|
+
onExpired: () => {
|
|
34
|
+
process.stderr.write("pmcp: mailbox attachment expired or superseded\n");
|
|
35
|
+
void stop?.().catch(() => {
|
|
36
|
+
process.exitCode = 1;
|
|
37
|
+
});
|
|
38
|
+
}
|
|
39
|
+
});
|
|
40
|
+
let handle;
|
|
41
|
+
try {
|
|
42
|
+
handle = serve(catalog, { ...serving, mailbox: attachment.service });
|
|
43
|
+
} catch (error) {
|
|
44
|
+
await attachment.close();
|
|
45
|
+
throw error;
|
|
46
|
+
}
|
|
47
|
+
let shutdown;
|
|
48
|
+
const onExit = () => {
|
|
49
|
+
void stop().catch(() => {
|
|
50
|
+
process.exitCode = 1;
|
|
51
|
+
});
|
|
52
|
+
};
|
|
53
|
+
stop = () => {
|
|
54
|
+
if (shutdown) return shutdown;
|
|
55
|
+
process.removeListener("SIGINT", onExit);
|
|
56
|
+
process.removeListener("SIGTERM", onExit);
|
|
57
|
+
process.stdin.removeListener("end", onExit);
|
|
58
|
+
shutdown = (async () => {
|
|
59
|
+
try {
|
|
60
|
+
await handle.close();
|
|
61
|
+
} finally {
|
|
62
|
+
await attachment.close();
|
|
63
|
+
}
|
|
64
|
+
})();
|
|
65
|
+
return shutdown;
|
|
66
|
+
};
|
|
67
|
+
process.once("SIGINT", onExit);
|
|
68
|
+
process.once("SIGTERM", onExit);
|
|
69
|
+
process.stdin.once("end", onExit);
|
|
70
|
+
return stop;
|
|
71
|
+
}
|
|
72
|
+
function main(argv = process.argv.slice(2)) {
|
|
73
|
+
const scopeArg = argv.find((arg) => arg.startsWith("--scope="));
|
|
74
|
+
const scopes = scopeArg ? scopeArg.slice("--scope=".length).split(",") : [];
|
|
75
|
+
serve({
|
|
76
|
+
roots: resolveRoots(argv, process.cwd()),
|
|
77
|
+
...scopes.length > 0 ? { scopes } : {}
|
|
78
|
+
});
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
export {
|
|
82
|
+
resolveRoots,
|
|
83
|
+
serve,
|
|
84
|
+
serveWithMailbox,
|
|
85
|
+
main
|
|
86
|
+
};
|
|
87
|
+
//# sourceMappingURL=chunk-RPQOBHVU.js.map
|