@creeperhost/modlens-mcp 1.6.20 → 1.6.22

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.
Files changed (116) hide show
  1. package/ATTRIBUTION.md +8 -1
  2. package/README.md +77 -2
  3. package/RUNTIME.md +262 -0
  4. package/TESTING.md +8 -0
  5. package/dist/hosted-mod-license.d.ts +36 -0
  6. package/dist/hosted-mod-license.d.ts.map +1 -0
  7. package/dist/hosted-mod-license.js +65 -0
  8. package/dist/hosted-mod-license.js.map +1 -0
  9. package/dist/hosted-oauth.d.ts +36 -0
  10. package/dist/hosted-oauth.d.ts.map +1 -0
  11. package/dist/hosted-oauth.js +522 -0
  12. package/dist/hosted-oauth.js.map +1 -0
  13. package/dist/hosted-policy.d.ts +36 -0
  14. package/dist/hosted-policy.d.ts.map +1 -0
  15. package/dist/hosted-policy.js +354 -0
  16. package/dist/hosted-policy.js.map +1 -0
  17. package/dist/launcher.js +104 -89
  18. package/dist/launcher.js.map +1 -1
  19. package/dist/license-notices.d.ts +8 -0
  20. package/dist/license-notices.d.ts.map +1 -0
  21. package/dist/license-notices.js +10 -0
  22. package/dist/license-notices.js.map +1 -0
  23. package/dist/license-source-references.d.ts +12 -0
  24. package/dist/license-source-references.d.ts.map +1 -0
  25. package/dist/license-source-references.js +18 -0
  26. package/dist/license-source-references.js.map +1 -0
  27. package/dist/license-templates.d.ts +6 -0
  28. package/dist/license-templates.d.ts.map +1 -0
  29. package/dist/license-templates.js +55 -0
  30. package/dist/license-templates.js.map +1 -0
  31. package/dist/local-mod.d.ts +31 -0
  32. package/dist/local-mod.d.ts.map +1 -0
  33. package/dist/local-mod.js +71 -0
  34. package/dist/local-mod.js.map +1 -0
  35. package/dist/minecraft.d.ts +2 -0
  36. package/dist/minecraft.d.ts.map +1 -1
  37. package/dist/minecraft.js +16 -0
  38. package/dist/minecraft.js.map +1 -1
  39. package/dist/mod-license.d.ts +53 -0
  40. package/dist/mod-license.d.ts.map +1 -0
  41. package/dist/mod-license.js +617 -0
  42. package/dist/mod-license.js.map +1 -0
  43. package/dist/repositories/mcVersion.d.ts +1 -0
  44. package/dist/repositories/mcVersion.d.ts.map +1 -1
  45. package/dist/repositories/mcVersion.js +11 -0
  46. package/dist/repositories/mcVersion.js.map +1 -1
  47. package/dist/runtime/cli.d.ts +2 -0
  48. package/dist/runtime/cli.d.ts.map +1 -0
  49. package/dist/runtime/cli.js +163 -0
  50. package/dist/runtime/cli.js.map +1 -0
  51. package/dist/runtime/companion.d.ts +32 -0
  52. package/dist/runtime/companion.d.ts.map +1 -0
  53. package/dist/runtime/companion.js +135 -0
  54. package/dist/runtime/companion.js.map +1 -0
  55. package/dist/runtime/guidance.d.ts +73 -0
  56. package/dist/runtime/guidance.d.ts.map +1 -0
  57. package/dist/runtime/guidance.js +40 -0
  58. package/dist/runtime/guidance.js.map +1 -0
  59. package/dist/runtime/hub.d.ts +150 -0
  60. package/dist/runtime/hub.d.ts.map +1 -0
  61. package/dist/runtime/hub.js +561 -0
  62. package/dist/runtime/hub.js.map +1 -0
  63. package/dist/runtime/modlens-agent.jar +0 -0
  64. package/dist/runtime/protocol.d.ts +202 -0
  65. package/dist/runtime/protocol.d.ts.map +1 -0
  66. package/dist/runtime/protocol.js +91 -0
  67. package/dist/runtime/protocol.js.map +1 -0
  68. package/dist/runtime/requests.d.ts +367 -0
  69. package/dist/runtime/requests.d.ts.map +1 -0
  70. package/dist/runtime/requests.js +57 -0
  71. package/dist/runtime/requests.js.map +1 -0
  72. package/dist/server.js +186 -39
  73. package/dist/server.js.map +1 -1
  74. package/dist/tools/hosted-mc-index.d.ts +8 -0
  75. package/dist/tools/hosted-mc-index.d.ts.map +1 -0
  76. package/dist/tools/hosted-mc-index.js +92 -0
  77. package/dist/tools/hosted-mc-index.js.map +1 -0
  78. package/dist/tools/mc-fts.d.ts +2 -0
  79. package/dist/tools/mc-fts.d.ts.map +1 -1
  80. package/dist/tools/mc-fts.js +8 -0
  81. package/dist/tools/mc-fts.js.map +1 -1
  82. package/dist/tools/project.d.ts +7 -3
  83. package/dist/tools/project.d.ts.map +1 -1
  84. package/dist/tools/project.js +45 -3
  85. package/dist/tools/project.js.map +1 -1
  86. package/dist/tools/report-issue.d.ts +77 -0
  87. package/dist/tools/report-issue.d.ts.map +1 -0
  88. package/dist/tools/report-issue.js +92 -0
  89. package/dist/tools/report-issue.js.map +1 -0
  90. package/dist/tools/runtime.d.ts +6 -0
  91. package/dist/tools/runtime.d.ts.map +1 -0
  92. package/dist/tools/runtime.js +18 -0
  93. package/dist/tools/runtime.js.map +1 -0
  94. package/dist/tools/source.d.ts +1 -1
  95. package/dist/tools/source.d.ts.map +1 -1
  96. package/dist/tools/source.js +5 -1
  97. package/dist/tools/source.js.map +1 -1
  98. package/dist/tools/vanilla.d.ts +30 -1
  99. package/dist/tools/vanilla.d.ts.map +1 -1
  100. package/dist/tools/vanilla.js +184 -25
  101. package/dist/tools/vanilla.js.map +1 -1
  102. package/package.json +5 -1
  103. package/scripts/build-runtime-agent.mjs +64 -0
  104. package/scripts/fixtures/mod-license-corpus.json +154 -0
  105. package/scripts/gradle/modlens-runtime.init.gradle +17 -0
  106. package/scripts/runtime-test-client.mjs +36 -0
  107. package/scripts/test-hosted-oauth.mjs +186 -0
  108. package/scripts/test-hosted-policy.mjs +182 -0
  109. package/scripts/test-mod-licenses-live.mjs +86 -0
  110. package/scripts/test-package.mjs +44 -0
  111. package/scripts/test-project-http.mjs +46 -3
  112. package/scripts/test-runtime-gradle.mjs +107 -0
  113. package/scripts/test-runtime-minecraft.mjs +190 -0
  114. package/scripts/test-runtime-native.mjs +120 -0
  115. package/scripts/test-runtime-remote.mjs +209 -0
  116. package/scripts/update-license-templates.mjs +14 -0
@@ -0,0 +1,150 @@
1
+ import { type RuntimeCommand, type RuntimeMode } from "./protocol.js";
2
+ type Event = {
3
+ cursor: number;
4
+ sessionId: string;
5
+ time: number;
6
+ type: string;
7
+ data: Record<string, unknown>;
8
+ };
9
+ export declare const RUNTIME_HELP: {
10
+ target: string;
11
+ clientJvmOptions: string;
12
+ optional: boolean;
13
+ workflow: string[];
14
+ input: string;
15
+ monitoring: string;
16
+ heapAnalysis: string;
17
+ execution: string;
18
+ limits: string;
19
+ };
20
+ /** Local-only, opt-in bridge. Remote MCP clients never gain host process/filesystem control. */
21
+ export declare class RuntimeHub {
22
+ readonly root: string;
23
+ readonly agentJar: string;
24
+ private projects;
25
+ private sessions;
26
+ private journal;
27
+ private cursor;
28
+ private server?;
29
+ private endpoint;
30
+ private init?;
31
+ private waiters;
32
+ private children;
33
+ private persistence;
34
+ private monitor?;
35
+ private dirty;
36
+ private ownsLock;
37
+ private listening?;
38
+ constructor(root: string, agentJar?: string);
39
+ private assertLocal;
40
+ initialize(): Promise<void>;
41
+ /** Explicit CLI opt-in: keep a bridge ready even before the first project setup. */
42
+ startLocalCompanion(): Promise<void>;
43
+ private load;
44
+ private listen;
45
+ private openListener;
46
+ private safeDirectory;
47
+ private managedWrite;
48
+ private connection;
49
+ setup(directory: string, mode?: RuntimeMode, task?: string, hooks?: boolean): Promise<{
50
+ state: string;
51
+ projectId: string;
52
+ mcVersion: string;
53
+ mode: "interactive" | "observe" | "hidden";
54
+ runConfiguration: string;
55
+ vmOption: string;
56
+ vmOptions: string[];
57
+ manualLaunch: string;
58
+ next: string;
59
+ files: string[];
60
+ note: string;
61
+ }>;
62
+ private accept;
63
+ private add;
64
+ private saveEvents;
65
+ status(sessionId?: string): Promise<{
66
+ sessionId: string;
67
+ projectId: string;
68
+ status: string;
69
+ lastSeen: number;
70
+ pid: number;
71
+ javaVersion: string;
72
+ capabilities: Record<string, unknown>;
73
+ state: Record<string, unknown>;
74
+ metrics: Record<string, unknown>;
75
+ } | {
76
+ enabled: boolean;
77
+ agentPackaged: boolean;
78
+ projects: {
79
+ id: string;
80
+ directory: string;
81
+ mode: RuntimeMode;
82
+ task: string;
83
+ hooks: boolean;
84
+ }[];
85
+ help: {
86
+ target: string;
87
+ clientJvmOptions: string;
88
+ optional: boolean;
89
+ workflow: string[];
90
+ input: string;
91
+ monitoring: string;
92
+ heapAnalysis: string;
93
+ execution: string;
94
+ limits: string;
95
+ };
96
+ }>;
97
+ list(): Promise<{
98
+ sessionId: string;
99
+ projectId: string;
100
+ status: string;
101
+ lastSeen: number;
102
+ pid: number;
103
+ javaVersion: string;
104
+ capabilities: Record<string, unknown>;
105
+ state: Record<string, unknown>;
106
+ metrics: Record<string, unknown>;
107
+ }[]>;
108
+ private view;
109
+ private session;
110
+ events(after?: number, waitMs?: number, sessionId?: string): Promise<{
111
+ events: Event[];
112
+ nextCursor: number;
113
+ truncated: boolean;
114
+ }>;
115
+ command(sessionId: string, command: RuntimeCommand): Promise<unknown>;
116
+ launch(projectId: string, javaHome?: string): Promise<{
117
+ state: string;
118
+ pid: number | undefined;
119
+ projectId: string;
120
+ next: string;
121
+ }>;
122
+ artifact(sessionId: string, name: string): Promise<{
123
+ path: string;
124
+ note: string;
125
+ mimeType?: undefined;
126
+ data?: undefined;
127
+ text?: undefined;
128
+ } | {
129
+ path: string;
130
+ mimeType: string;
131
+ data: string;
132
+ note?: undefined;
133
+ text?: undefined;
134
+ } | {
135
+ path: string;
136
+ text: string;
137
+ note?: undefined;
138
+ mimeType?: undefined;
139
+ data?: undefined;
140
+ } | {
141
+ path: string;
142
+ note?: undefined;
143
+ mimeType?: undefined;
144
+ data?: undefined;
145
+ text?: undefined;
146
+ }>;
147
+ close(): Promise<void>;
148
+ }
149
+ export {};
150
+ //# sourceMappingURL=hub.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hub.d.ts","sourceRoot":"","sources":["../../src/runtime/hub.ts"],"names":[],"mappings":"AAMA,OAAO,EAIH,KAAK,cAAc,EACnB,KAAK,WAAW,EACnB,MAAM,eAAe,CAAC;AAYvB,KAAK,KAAK,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAmB9G,eAAO,MAAM,YAAY;;;;;;;;;;CAoBxB,CAAC;AAEF,gGAAgG;AAChG,qBAAa,UAAU;IAgBf,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,QAAQ;IAhBrB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,IAAI,CAAC,CAAgB;IAC7B,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAC,CAAgB;gBAErB,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAuD;IAG5E,OAAO,CAAC,WAAW;IAMb,UAAU;IAOhB,oFAAoF;IAC9E,mBAAmB;YAIX,IAAI;YAqBJ,MAAM;YAON,YAAY;YAqGZ,aAAa;YAeb,YAAY;YAUZ,UAAU;IAclB,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,WAA2B,EAAE,IAAI,SAAc,EAAE,KAAK,UAAO;;;;;;;;;;;;;IA2FlG,OAAO,CAAC,MAAM;IAmCd,OAAO,CAAC,GAAG;YAQG,UAAU;IAKlB,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM;;;;;;;;;;;;;;gBA1Y3B,MAAM;uBACC,MAAM;kBAEX,WAAW;kBACX,MAAM;mBACL,OAAO;;;;;;;;;;;;;;IAqZR,IAAI;;;;;;;;;;;IAIV,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,OAAO;IAKT,MAAM,CAAC,KAAK,SAAI,EAAE,MAAM,SAAI,EAAE,SAAS,CAAC,EAAE,MAAM;;;;;IAwBhD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc;IAoBlD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;;;;;;IAuD3C,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;IAkBxC,KAAK;CAiCd"}