@creeperhost/modlens-mcp 1.6.20 → 1.6.21

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 (91) hide show
  1. package/ATTRIBUTION.md +8 -1
  2. package/README.md +67 -0
  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-policy.d.ts +32 -0
  10. package/dist/hosted-policy.d.ts.map +1 -0
  11. package/dist/hosted-policy.js +257 -0
  12. package/dist/hosted-policy.js.map +1 -0
  13. package/dist/launcher.js +104 -89
  14. package/dist/launcher.js.map +1 -1
  15. package/dist/license-notices.d.ts +8 -0
  16. package/dist/license-notices.d.ts.map +1 -0
  17. package/dist/license-notices.js +10 -0
  18. package/dist/license-notices.js.map +1 -0
  19. package/dist/license-source-references.d.ts +12 -0
  20. package/dist/license-source-references.d.ts.map +1 -0
  21. package/dist/license-source-references.js +18 -0
  22. package/dist/license-source-references.js.map +1 -0
  23. package/dist/license-templates.d.ts +6 -0
  24. package/dist/license-templates.d.ts.map +1 -0
  25. package/dist/license-templates.js +55 -0
  26. package/dist/license-templates.js.map +1 -0
  27. package/dist/local-mod.d.ts +31 -0
  28. package/dist/local-mod.d.ts.map +1 -0
  29. package/dist/local-mod.js +71 -0
  30. package/dist/local-mod.js.map +1 -0
  31. package/dist/mod-license.d.ts +53 -0
  32. package/dist/mod-license.d.ts.map +1 -0
  33. package/dist/mod-license.js +617 -0
  34. package/dist/mod-license.js.map +1 -0
  35. package/dist/runtime/cli.d.ts +2 -0
  36. package/dist/runtime/cli.d.ts.map +1 -0
  37. package/dist/runtime/cli.js +163 -0
  38. package/dist/runtime/cli.js.map +1 -0
  39. package/dist/runtime/companion.d.ts +32 -0
  40. package/dist/runtime/companion.d.ts.map +1 -0
  41. package/dist/runtime/companion.js +135 -0
  42. package/dist/runtime/companion.js.map +1 -0
  43. package/dist/runtime/guidance.d.ts +73 -0
  44. package/dist/runtime/guidance.d.ts.map +1 -0
  45. package/dist/runtime/guidance.js +40 -0
  46. package/dist/runtime/guidance.js.map +1 -0
  47. package/dist/runtime/hub.d.ts +150 -0
  48. package/dist/runtime/hub.d.ts.map +1 -0
  49. package/dist/runtime/hub.js +561 -0
  50. package/dist/runtime/hub.js.map +1 -0
  51. package/dist/runtime/modlens-agent.jar +0 -0
  52. package/dist/runtime/protocol.d.ts +202 -0
  53. package/dist/runtime/protocol.d.ts.map +1 -0
  54. package/dist/runtime/protocol.js +91 -0
  55. package/dist/runtime/protocol.js.map +1 -0
  56. package/dist/runtime/requests.d.ts +367 -0
  57. package/dist/runtime/requests.d.ts.map +1 -0
  58. package/dist/runtime/requests.js +57 -0
  59. package/dist/runtime/requests.js.map +1 -0
  60. package/dist/server.js +125 -36
  61. package/dist/server.js.map +1 -1
  62. package/dist/tools/project.d.ts +7 -3
  63. package/dist/tools/project.d.ts.map +1 -1
  64. package/dist/tools/project.js +45 -3
  65. package/dist/tools/project.js.map +1 -1
  66. package/dist/tools/report-issue.d.ts +77 -0
  67. package/dist/tools/report-issue.d.ts.map +1 -0
  68. package/dist/tools/report-issue.js +92 -0
  69. package/dist/tools/report-issue.js.map +1 -0
  70. package/dist/tools/runtime.d.ts +6 -0
  71. package/dist/tools/runtime.d.ts.map +1 -0
  72. package/dist/tools/runtime.js +18 -0
  73. package/dist/tools/runtime.js.map +1 -0
  74. package/dist/tools/source.d.ts +1 -1
  75. package/dist/tools/source.d.ts.map +1 -1
  76. package/dist/tools/source.js +5 -1
  77. package/dist/tools/source.js.map +1 -1
  78. package/package.json +4 -1
  79. package/scripts/build-runtime-agent.mjs +64 -0
  80. package/scripts/fixtures/mod-license-corpus.json +154 -0
  81. package/scripts/gradle/modlens-runtime.init.gradle +17 -0
  82. package/scripts/runtime-test-client.mjs +36 -0
  83. package/scripts/test-hosted-policy.mjs +123 -0
  84. package/scripts/test-mod-licenses-live.mjs +86 -0
  85. package/scripts/test-package.mjs +44 -0
  86. package/scripts/test-project-http.mjs +46 -3
  87. package/scripts/test-runtime-gradle.mjs +107 -0
  88. package/scripts/test-runtime-minecraft.mjs +190 -0
  89. package/scripts/test-runtime-native.mjs +120 -0
  90. package/scripts/test-runtime-remote.mjs +209 -0
  91. 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"}