modkh 0.0.0-stage → 0.1.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.
Files changed (256) hide show
  1. package/README.md +24 -2
  2. package/dist/agent/bundled-skills.d.ts +13 -0
  3. package/dist/agent/bundled-skills.js +95 -0
  4. package/dist/agent/images.d.ts +10 -0
  5. package/dist/agent/images.js +33 -0
  6. package/dist/agent/loop.d.ts +56 -0
  7. package/dist/agent/loop.js +155 -0
  8. package/dist/agent/skills.d.ts +20 -0
  9. package/dist/agent/skills.js +169 -0
  10. package/dist/agent/types.d.ts +132 -0
  11. package/dist/agent/types.js +12 -0
  12. package/dist/cli/agents.d.ts +8 -0
  13. package/dist/cli/agents.js +12 -0
  14. package/dist/cli/approval.d.ts +27 -0
  15. package/dist/cli/approval.js +62 -0
  16. package/dist/cli/catalog.d.ts +39 -0
  17. package/dist/cli/catalog.js +76 -0
  18. package/dist/cli/chat.d.ts +18 -0
  19. package/dist/cli/chat.js +733 -0
  20. package/dist/cli/clipboard.d.ts +9 -0
  21. package/dist/cli/clipboard.js +54 -0
  22. package/dist/cli/color.d.ts +42 -0
  23. package/dist/cli/color.js +176 -0
  24. package/dist/cli/config.d.ts +41 -0
  25. package/dist/cli/config.js +188 -0
  26. package/dist/cli/editor.d.ts +16 -0
  27. package/dist/cli/editor.js +77 -0
  28. package/dist/cli/keys.d.ts +18 -0
  29. package/dist/cli/keys.js +82 -0
  30. package/dist/cli/language.d.ts +1 -0
  31. package/dist/cli/language.js +105 -0
  32. package/dist/cli/limits.d.ts +13 -0
  33. package/dist/cli/limits.js +19 -0
  34. package/dist/cli/lines.d.ts +18 -0
  35. package/dist/cli/lines.js +80 -0
  36. package/dist/cli/models.d.ts +4 -0
  37. package/dist/cli/models.js +69 -0
  38. package/dist/cli/permissions.d.ts +25 -0
  39. package/dist/cli/permissions.js +30 -0
  40. package/dist/cli/plugins.d.ts +1 -0
  41. package/dist/cli/plugins.js +53 -0
  42. package/dist/cli/providers.d.ts +46 -0
  43. package/dist/cli/providers.js +76 -0
  44. package/dist/cli/terminal.d.ts +143 -0
  45. package/dist/cli/terminal.js +742 -0
  46. package/dist/cli/usage.d.ts +29 -0
  47. package/dist/cli/usage.js +75 -0
  48. package/dist/index.d.ts +11 -0
  49. package/dist/index.js +164 -0
  50. package/dist/language/catalog.d.ts +44 -0
  51. package/dist/language/catalog.js +100 -0
  52. package/dist/language/commonlisp-bundled.d.ts +11 -0
  53. package/dist/language/commonlisp-bundled.js +22 -0
  54. package/dist/language/commonlisp-dependencies.d.ts +16 -0
  55. package/dist/language/commonlisp-dependencies.js +68 -0
  56. package/dist/language/commonlisp-install.d.ts +14 -0
  57. package/dist/language/commonlisp-install.js +213 -0
  58. package/dist/language/commonlisp-reader.d.ts +17 -0
  59. package/dist/language/commonlisp-reader.js +47 -0
  60. package/dist/language/commonlisp-systems.d.ts +3 -0
  61. package/dist/language/commonlisp-systems.js +32 -0
  62. package/dist/language/commonlisp-tls.d.ts +10 -0
  63. package/dist/language/commonlisp-tls.js +51 -0
  64. package/dist/language/detect.d.ts +29 -0
  65. package/dist/language/detect.js +103 -0
  66. package/dist/language/grammars/LICENSE +24 -0
  67. package/dist/language/grammars/manifest.json +76 -0
  68. package/dist/language/grammars/tree-sitter-c.wasm +0 -0
  69. package/dist/language/grammars/tree-sitter-cpp.wasm +0 -0
  70. package/dist/language/grammars/tree-sitter-css.wasm +0 -0
  71. package/dist/language/grammars/tree-sitter-html.wasm +0 -0
  72. package/dist/language/grammars/tree-sitter-javascript.wasm +0 -0
  73. package/dist/language/grammars/tree-sitter-php.wasm +0 -0
  74. package/dist/language/grammars/tree-sitter-python.wasm +0 -0
  75. package/dist/language/grammars/tree-sitter-ruby.wasm +0 -0
  76. package/dist/language/grammars/tree-sitter-rust.wasm +0 -0
  77. package/dist/language/grammars/tree-sitter-swift.wasm +0 -0
  78. package/dist/language/grammars/tree-sitter-tsx.wasm +0 -0
  79. package/dist/language/grammars/tree-sitter-typescript.wasm +0 -0
  80. package/dist/language/install.d.ts +50 -0
  81. package/dist/language/install.js +293 -0
  82. package/dist/language/lsp/client.d.ts +97 -0
  83. package/dist/language/lsp/client.js +337 -0
  84. package/dist/language/lsp/pool.d.ts +67 -0
  85. package/dist/language/lsp/pool.js +122 -0
  86. package/dist/language/lsp/service.d.ts +46 -0
  87. package/dist/language/lsp/service.js +138 -0
  88. package/dist/language/native.d.ts +8 -0
  89. package/dist/language/native.js +100 -0
  90. package/dist/language/platform.d.ts +14 -0
  91. package/dist/language/platform.js +20 -0
  92. package/dist/language/positions.d.ts +20 -0
  93. package/dist/language/positions.js +46 -0
  94. package/dist/language/syntax/assets.d.ts +9 -0
  95. package/dist/language/syntax/assets.js +73 -0
  96. package/dist/language/syntax/parser.d.ts +24 -0
  97. package/dist/language/syntax/parser.js +144 -0
  98. package/dist/language/typescript-capability.d.ts +6 -0
  99. package/dist/language/typescript-capability.js +42 -0
  100. package/dist/lisp/config.d.ts +16 -0
  101. package/dist/lisp/config.js +159 -0
  102. package/dist/lisp/routing.d.ts +5 -0
  103. package/dist/lisp/routing.js +24 -0
  104. package/dist/lisp/runtime.d.ts +21 -0
  105. package/dist/lisp/runtime.js +83 -0
  106. package/dist/memory/kiokuko.d.ts +32 -0
  107. package/dist/memory/kiokuko.js +102 -0
  108. package/dist/memory/mcp.d.ts +38 -0
  109. package/dist/memory/mcp.js +211 -0
  110. package/dist/model/ai-sdk.d.ts +27 -0
  111. package/dist/model/ai-sdk.js +180 -0
  112. package/dist/model/chatgpt/login.d.ts +42 -0
  113. package/dist/model/chatgpt/login.js +180 -0
  114. package/dist/model/chatgpt/responses.d.ts +41 -0
  115. package/dist/model/chatgpt/responses.js +202 -0
  116. package/dist/model/chatgpt/tokens.d.ts +11 -0
  117. package/dist/model/chatgpt/tokens.js +50 -0
  118. package/dist/model/connection.d.ts +6 -0
  119. package/dist/model/connection.js +65 -0
  120. package/dist/model/context.d.ts +9 -0
  121. package/dist/model/context.js +69 -0
  122. package/dist/model/factory.d.ts +25 -0
  123. package/dist/model/factory.js +88 -0
  124. package/dist/model/fixed.d.ts +17 -0
  125. package/dist/model/fixed.js +41 -0
  126. package/dist/model/reasoning.d.ts +16 -0
  127. package/dist/model/reasoning.js +62 -0
  128. package/dist/plugins/api.d.ts +60 -0
  129. package/dist/plugins/api.js +1 -0
  130. package/dist/plugins/manager.d.ts +34 -0
  131. package/dist/plugins/manager.js +261 -0
  132. package/dist/plugins/package.d.ts +13 -0
  133. package/dist/plugins/package.js +99 -0
  134. package/dist/plugins/registry.d.ts +8 -0
  135. package/dist/plugins/registry.js +14 -0
  136. package/dist/session/store.d.ts +82 -0
  137. package/dist/session/store.js +285 -0
  138. package/dist/session/workspace.d.ts +19 -0
  139. package/dist/session/workspace.js +73 -0
  140. package/dist/subagents/processes.d.ts +18 -0
  141. package/dist/subagents/processes.js +73 -0
  142. package/dist/subagents/request.d.ts +4 -0
  143. package/dist/subagents/request.js +21 -0
  144. package/dist/subagents/service.d.ts +39 -0
  145. package/dist/subagents/service.js +352 -0
  146. package/dist/subagents/settings.d.ts +10 -0
  147. package/dist/subagents/settings.js +32 -0
  148. package/dist/subagents/types.d.ts +43 -0
  149. package/dist/subagents/types.js +1 -0
  150. package/dist/subagents/verification.d.ts +31 -0
  151. package/dist/subagents/verification.js +178 -0
  152. package/dist/tools/diff.d.ts +6 -0
  153. package/dist/tools/diff.js +82 -0
  154. package/dist/tools/edit.d.ts +3 -0
  155. package/dist/tools/edit.js +152 -0
  156. package/dist/tools/files.d.ts +6 -0
  157. package/dist/tools/files.js +96 -0
  158. package/dist/tools/formal.d.ts +8 -0
  159. package/dist/tools/formal.js +77 -0
  160. package/dist/tools/guard.d.ts +7 -0
  161. package/dist/tools/guard.js +48 -0
  162. package/dist/tools/job-tools.d.ts +19 -0
  163. package/dist/tools/job-tools.js +148 -0
  164. package/dist/tools/jobs.d.ts +77 -0
  165. package/dist/tools/jobs.js +181 -0
  166. package/dist/tools/language.d.ts +6 -0
  167. package/dist/tools/language.js +174 -0
  168. package/dist/tools/registry.d.ts +28 -0
  169. package/dist/tools/registry.js +105 -0
  170. package/dist/tools/run.d.ts +13 -0
  171. package/dist/tools/run.js +159 -0
  172. package/dist/tools/search.d.ts +2 -0
  173. package/dist/tools/search.js +156 -0
  174. package/dist/tools/shell-process.d.ts +115 -0
  175. package/dist/tools/shell-process.js +286 -0
  176. package/dist/tools/skills.d.ts +2 -0
  177. package/dist/tools/skills.js +46 -0
  178. package/dist/tools/web.d.ts +24 -0
  179. package/dist/tools/web.js +386 -0
  180. package/docs/ci-repair-20261116.md +30 -0
  181. package/docs/commonlisp-provider-migration.md +22 -0
  182. package/docs/commonlisp-qlot-recovery.md +28 -0
  183. package/docs/commonlisp-tls-recovery.md +28 -0
  184. package/docs/context-efficiency.md +100 -0
  185. package/docs/input.md +66 -0
  186. package/docs/languages.md +117 -0
  187. package/docs/models.md +85 -0
  188. package/docs/modkh-evidence.json +641 -0
  189. package/docs/modkh-failure-comparison.json +675 -0
  190. package/docs/modkh-namespace.md +39 -0
  191. package/docs/modkh-qlot-evidence.json +37 -0
  192. package/docs/modkh-verification.md +173 -0
  193. package/docs/modkh.md +124 -0
  194. package/docs/presets.md +19 -0
  195. package/docs/setup.md +112 -0
  196. package/docs/subagents.md +134 -0
  197. package/docs/web.md +57 -0
  198. package/experiments/presets/common-lisp.lisp +38 -0
  199. package/experiments/presets/css.lisp +38 -0
  200. package/experiments/presets/formal.lisp +7 -0
  201. package/experiments/presets/html.lisp +38 -0
  202. package/experiments/presets/js.lisp +38 -0
  203. package/experiments/presets/php.lisp +38 -0
  204. package/experiments/presets/svelte.lisp +38 -0
  205. package/experiments/presets/tailwindcss.lisp +24 -0
  206. package/experiments/presets/ts.lisp +38 -0
  207. package/package.json +49 -4
  208. package/plugins/modkh-explorer/index.mjs +3 -0
  209. package/plugins/modkh-explorer/plugin.json +1 -0
  210. package/plugins/modkh-worker/index.mjs +3 -0
  211. package/plugins/modkh-worker/plugin.json +1 -0
  212. package/skills/kiokuko-dsh/LICENSE +21 -0
  213. package/skills/kiokuko-dsh/coding-ideal-routine-skill/SKILL.md +106 -0
  214. package/skills/kiokuko-dsh/japanese-translation-for-oss-models/SKILL.md +65 -0
  215. package/skills/kiokuko-dsh/kiokuko-architecture/SKILL.md +20 -0
  216. package/skills/kiokuko-dsh/kiokuko-architecture/references/cases.md +11 -0
  217. package/skills/kiokuko-dsh/kiokuko-benchmark/SKILL.md +20 -0
  218. package/skills/kiokuko-dsh/kiokuko-benchmark/references/cases.md +11 -0
  219. package/skills/kiokuko-dsh/kiokuko-investigate/SKILL.md +20 -0
  220. package/skills/kiokuko-dsh/kiokuko-investigate/references/cases.md +11 -0
  221. package/skills/kiokuko-dsh/kiokuko-lisp/SKILL.md +390 -0
  222. package/skills/kiokuko-dsh/kiokuko-review/SKILL.md +20 -0
  223. package/skills/kiokuko-dsh/kiokuko-review/references/cases.md +11 -0
  224. package/skills/kiokuko-dsh/kiokuko-simple-work/SKILL.md +70 -0
  225. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/SKILL.md +79 -0
  226. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/boundaries-and-ownership.md +52 -0
  227. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/domain-and-types.md +48 -0
  228. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/effects-and-data.md +43 -0
  229. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/kiokuko-patterns.md +314 -0
  230. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/problem-shaping-and-language.md +90 -0
  231. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/protocols-and-idempotency.md +42 -0
  232. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/review-checklist.md +92 -0
  233. package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/verification.md +45 -0
  234. package/skills/kiokuko-dsh/kiokuko-skill-authoring/SKILL.md +20 -0
  235. package/skills/kiokuko-dsh/kiokuko-skill-authoring/references/cases.md +11 -0
  236. package/skills/kiokuko-dsh/kiokuko-soul/SKILL.md +25 -0
  237. package/skills/kiokuko-dsh/kiokuko-technical-writing/SKILL.md +20 -0
  238. package/skills/kiokuko-dsh/kiokuko-technical-writing/references/cases.md +11 -0
  239. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/SKILL.md +64 -0
  240. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/accessibility-and-navigation.md +31 -0
  241. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/async-recovery.md +49 -0
  242. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/forms-and-controls.md +35 -0
  243. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/interaction-feedback.md +34 -0
  244. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/responsive-and-platform.md +38 -0
  245. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/safety-and-review.md +43 -0
  246. package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/ui-checklist.md +75 -0
  247. package/skills/kiokuko-dsh/kiokuko-verification/SKILL.md +20 -0
  248. package/skills/kiokuko-dsh/kiokuko-verification/references/cases.md +11 -0
  249. package/skills/kiokuko-dsh/manifest.json +168 -0
  250. package/skills/kiokuko-dsh/memory-reasoning/SKILL.md +44 -0
  251. package/skills/kiokuko-dsh/one-shot-software-completion/SKILL.md +113 -0
  252. package/skills/kiokuko-dsh/one-shot-software-completion/references/boundaries-and-lifecycle.md +70 -0
  253. package/skills/kiokuko-dsh/one-shot-software-completion/references/discovery-and-scope.md +71 -0
  254. package/skills/kiokuko-dsh/one-shot-software-completion/references/failure-recovery.md +43 -0
  255. package/skills/kiokuko-dsh/one-shot-software-completion/references/verification-and-completion.md +73 -0
  256. package/skills/kiokuko-dsh/veteran-programmer-skill/SKILL.md +66 -0
@@ -0,0 +1,62 @@
1
+ /**
2
+ * `/reasoning` のレベルと、各プロバイダーへの変換。
3
+ * 対応していないレベル・プロバイダーは「送らない」を返す仕様(既定の初期値に任せる)。
4
+ */
5
+ export const REASONING_LEVELS = ['off', 'minimal', 'low', 'medium', 'high'];
6
+ export function parseReasoningLevel(value) {
7
+ if (typeof value !== 'string')
8
+ return null;
9
+ const normalized = value.trim().toLowerCase();
10
+ if (REASONING_LEVELS.includes(normalized))
11
+ return normalized;
12
+ return null;
13
+ }
14
+ /** Anthropic の思考バジェット。最小1024推奨を守る。 */
15
+ const ANTHROPIC_BUDGET = { low: 2048, medium: 8192, high: 16384 };
16
+ const GOOGLE_BUDGET = { off: 0, low: 2048, medium: 8192, high: 24576 };
17
+ /**
18
+ * プロバイダー名 → providerOptions。off は openai 系では送らない(省略 = 初期値)、
19
+ * google では thinkingBudget:0 で無効化を明示する。chatgpt/deepseek/fixed は対象外。
20
+ * unknown レベルは必ず undefined(誤ったパラメーターをそのまま送らない)。
21
+ */
22
+ export function reasoningProviderOptions(provider, level) {
23
+ if (level === null || typeof level !== 'string')
24
+ return undefined;
25
+ const parsed = parseReasoningLevel(level);
26
+ if (!parsed)
27
+ return undefined;
28
+ const eff = parsed === 'off' ? undefined : parsed === 'minimal' ? 'minimal' : parsed;
29
+ switch (provider) {
30
+ case 'openai':
31
+ return eff === undefined ? undefined : { openai: { reasoningEffort: eff } };
32
+ case 'anthropic': {
33
+ const budget = ANTHROPIC_BUDGET[parsed];
34
+ if (!budget)
35
+ return undefined;
36
+ return { anthropic: { thinking: { type: 'enabled', budgetTokens: budget } } };
37
+ }
38
+ case 'google': {
39
+ const budget = GOOGLE_BUDGET[parsed];
40
+ if (budget === undefined && parsed !== 'off')
41
+ return undefined;
42
+ return { google: { thinkingConfig: { thinkingBudget: budget ?? 0 } } };
43
+ }
44
+ // ChatGPT(Responses直送・CLI側で付与)と fixed/deepseek はパス。
45
+ case 'chatgpt':
46
+ case 'deepseek':
47
+ case 'fixed':
48
+ return undefined;
49
+ default: {
50
+ // OpenAI互換系(ollama / openrouter / compatible など)は
51
+ // providerOptions[プロバイダー名] → reasoning_effort として送受される。
52
+ return eff === undefined ? undefined : { [provider]: { reasoningEffort: eff } };
53
+ }
54
+ }
55
+ }
56
+ /** Responses(Codex) API の reasoning effort。off と未知のレベルはキー自体を送らない。 */
57
+ export function responsesReasoningEffort(level) {
58
+ const parsed = parseReasoningLevel(level);
59
+ if (!parsed || parsed === 'off')
60
+ return undefined;
61
+ return parsed;
62
+ }
@@ -0,0 +1,60 @@
1
+ export interface PluginManifest {
2
+ apiVersion: 1;
3
+ id: string;
4
+ version: string;
5
+ title: string;
6
+ description: string;
7
+ kind: 'local' | 'external';
8
+ entry: string;
9
+ }
10
+ export interface LocalDefinition {
11
+ system: string;
12
+ tools: string[];
13
+ skillPolicy?: 'none';
14
+ maxTurns?: number;
15
+ requireAllTools?: boolean;
16
+ languageServer?: 'tailwind';
17
+ workflow?: 'edit-verify';
18
+ verificationCommand?: string;
19
+ verificationManifest?: {
20
+ sources: string[];
21
+ protected: string[];
22
+ };
23
+ }
24
+ export interface ExternalRequest {
25
+ task: string;
26
+ context?: string;
27
+ }
28
+ export interface ProcessRequest {
29
+ command: string;
30
+ args: string[];
31
+ }
32
+ export interface ProcessResult {
33
+ status: 'ok' | 'error' | 'unknown' | 'not-executed';
34
+ output: string;
35
+ cleanup: 'settled' | 'unknown';
36
+ }
37
+ export interface ExternalHost {
38
+ readonly signal: AbortSignal;
39
+ run(request: ProcessRequest): Promise<ProcessResult>;
40
+ }
41
+ export interface ExternalRun {
42
+ result: Promise<{
43
+ text: string;
44
+ }>;
45
+ stop(): Promise<void>;
46
+ }
47
+ export interface LocalPlugin {
48
+ define(): LocalDefinition;
49
+ }
50
+ export interface ExternalPlugin {
51
+ start(request: ExternalRequest, host: ExternalHost): ExternalRun | Promise<ExternalRun>;
52
+ }
53
+ export interface PluginDescriptor extends PluginManifest {
54
+ capabilities?: string[];
55
+ language?: string;
56
+ taskKind?: string;
57
+ digest: string;
58
+ enabled: boolean;
59
+ builtin: boolean;
60
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,34 @@
1
+ import type { PackageSnapshot } from './package.ts';
2
+ import type { SessionDefinition } from '../lisp/config.ts';
3
+ import type { PluginDescriptor } from './api.ts';
4
+ import { SubagentRegistry } from './registry.ts';
5
+ export interface PluginLease {
6
+ descriptor: PluginDescriptor;
7
+ module: Record<string, unknown>;
8
+ release(): void;
9
+ }
10
+ export declare class PluginLoadInterrupted extends Error {
11
+ }
12
+ export declare class PluginManager {
13
+ readonly home: string;
14
+ readonly builtinDir: string;
15
+ constructor(home?: string, builtinDir?: string);
16
+ private sessionEntries;
17
+ registerSessionDefinitions(entries: SessionDefinition[], sourceDigest: string): void;
18
+ private base;
19
+ private packagePath;
20
+ private catalog;
21
+ /** Single writer for registration and lease admission; fail closed after a crashed writer. */
22
+ private transaction;
23
+ private save;
24
+ discover(): {
25
+ registry: SubagentRegistry;
26
+ diagnostics: string[];
27
+ };
28
+ preview(directory: string): PackageSnapshot;
29
+ /** Called only after the human approves the displayed exact package digest. */
30
+ install(directory: string, approvedDigest: string): PluginDescriptor;
31
+ setEnabled(id: string, enabled: boolean): void;
32
+ remove(id: string): void;
33
+ acquire(id: string, digest: string, signal?: AbortSignal): Promise<PluginLease>;
34
+ }
@@ -0,0 +1,261 @@
1
+ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
2
+ if (typeof path === "string" && /^\.\.?\//.test(path)) {
3
+ return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
4
+ return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
5
+ });
6
+ }
7
+ return path;
8
+ };
9
+ import fs from 'node:fs';
10
+ import path from 'node:path';
11
+ import { fileURLToPath, pathToFileURL } from 'node:url';
12
+ import { randomUUID } from 'node:crypto';
13
+ import { configDir } from "../cli/config.js";
14
+ import { fields, inspectPackage, object, pluginId } from "./package.js";
15
+ import { SubagentRegistry } from "./registry.js";
16
+ const EMPTY = () => ({ version: 1, plugins: Object.create(null), disabledBuiltins: [] });
17
+ export class PluginLoadInterrupted extends Error {
18
+ }
19
+ async function importWithSignal(url, signal) {
20
+ if (!signal)
21
+ return import(__rewriteRelativeImportExtension(url));
22
+ let abort = () => { };
23
+ const interrupted = new Promise((_resolve, reject) => {
24
+ abort = () => reject(new PluginLoadInterrupted('Plugin import interrupted; module effects and cleanup remain unknown'));
25
+ if (signal.aborted)
26
+ abort();
27
+ else
28
+ signal.addEventListener('abort', abort, { once: true });
29
+ });
30
+ try {
31
+ return await Promise.race([import(__rewriteRelativeImportExtension(url)), interrupted]);
32
+ }
33
+ finally {
34
+ signal.removeEventListener('abort', abort);
35
+ }
36
+ }
37
+ export class PluginManager {
38
+ home;
39
+ builtinDir;
40
+ constructor(home = configDir(), builtinDir = fileURLToPath(new URL('../../plugins/', import.meta.url))) {
41
+ this.home = path.resolve(home);
42
+ this.builtinDir = builtinDir;
43
+ }
44
+ sessionEntries;
45
+ registerSessionDefinitions(entries, sourceDigest) {
46
+ if (this.sessionEntries)
47
+ throw new Error('Session definitions already registered; no implicit reload');
48
+ const registry = new SubagentRegistry();
49
+ for (const entry of entries) {
50
+ if (entry.descriptor.digest !== sourceDigest || !entry.descriptor.id.startsWith('micro-'))
51
+ throw new Error('Invalid session definition');
52
+ registry.register(entry.descriptor);
53
+ }
54
+ this.sessionEntries = structuredClone(entries);
55
+ }
56
+ base() { return path.join(this.home, 'plugins'); }
57
+ packagePath(id, digest) { return path.join(this.base(), 'packages', id, digest); }
58
+ catalog() {
59
+ const file = path.join(this.base(), 'catalog.json');
60
+ if (!fs.existsSync(file))
61
+ return EMPTY();
62
+ const stat = fs.lstatSync(file);
63
+ if (!stat.isFile() || stat.size > 1024 * 1024)
64
+ throw new Error('Invalid plugin catalog');
65
+ const raw = object(JSON.parse(fs.readFileSync(file, 'utf8')));
66
+ fields(raw, ['version', 'plugins', 'disabledBuiltins']);
67
+ if (raw.version !== 1 || !Array.isArray(raw.disabledBuiltins) || raw.disabledBuiltins.length > 1000)
68
+ throw new Error('Invalid plugin catalog version');
69
+ const result = EMPTY();
70
+ for (const [id, value] of Object.entries(object(raw.plugins))) {
71
+ pluginId(id);
72
+ if (id.startsWith('modkh-'))
73
+ throw new Error('Reserved plugin ID');
74
+ const row = object(value);
75
+ fields(row, ['digest', 'enabled']);
76
+ if (typeof row.digest !== 'string' || !/^[a-f0-9]{64}$/.test(row.digest) || typeof row.enabled !== 'boolean')
77
+ throw new Error('Invalid plugin catalog entry');
78
+ result.plugins[id] = { digest: row.digest, enabled: row.enabled };
79
+ }
80
+ result.disabledBuiltins = raw.disabledBuiltins.map(pluginId);
81
+ return result;
82
+ }
83
+ /** Single writer for registration and lease admission; fail closed after a crashed writer. */
84
+ transaction(action) {
85
+ fs.mkdirSync(this.base(), { recursive: true, mode: 0o700 });
86
+ const lock = path.join(this.base(), 'catalog.lock');
87
+ const fd = fs.openSync(lock, 'wx', 0o600);
88
+ try {
89
+ return action();
90
+ }
91
+ finally {
92
+ fs.closeSync(fd);
93
+ fs.unlinkSync(lock);
94
+ }
95
+ }
96
+ save(catalog) {
97
+ const temp = path.join(this.base(), `catalog-${randomUUID()}.tmp`);
98
+ fs.writeFileSync(temp, `${JSON.stringify(catalog, null, 2)}\n`, { flag: 'wx', mode: 0o600, flush: true });
99
+ fs.renameSync(temp, path.join(this.base(), 'catalog.json'));
100
+ }
101
+ discover() {
102
+ const registry = new SubagentRegistry();
103
+ const diagnostics = [];
104
+ if (this.sessionEntries) {
105
+ for (const entry of this.sessionEntries)
106
+ registry.register(structuredClone(entry.descriptor));
107
+ return { registry, diagnostics };
108
+ }
109
+ let catalog;
110
+ try {
111
+ catalog = this.catalog();
112
+ }
113
+ catch (e) {
114
+ return { registry, diagnostics: [`Plugin settings unavailable: ${String(e)}`] };
115
+ }
116
+ try {
117
+ for (const id of fs.readdirSync(this.builtinDir).sort()) {
118
+ try {
119
+ const snapshot = inspectPackage(path.join(this.builtinDir, id));
120
+ if (!snapshot.manifest.id.startsWith('modkh-') || snapshot.manifest.id !== id)
121
+ throw new Error('Invalid built-in ID');
122
+ registry.register({ ...snapshot.manifest, digest: snapshot.digest, enabled: !catalog.disabledBuiltins.includes(id), builtin: true });
123
+ }
124
+ catch (e) {
125
+ diagnostics.push(`${id}: ${String(e)}`);
126
+ }
127
+ }
128
+ }
129
+ catch (e) {
130
+ diagnostics.push(`Built-in plugins unavailable: ${String(e)}`);
131
+ }
132
+ for (const [id, row] of Object.entries(catalog.plugins)) {
133
+ try {
134
+ const snapshot = inspectPackage(this.packagePath(id, row.digest));
135
+ if (snapshot.digest !== row.digest || snapshot.manifest.id !== id)
136
+ throw new Error('Plugin digest mismatch; not loaded');
137
+ registry.register({ ...snapshot.manifest, digest: row.digest, enabled: row.enabled, builtin: false });
138
+ }
139
+ catch (e) {
140
+ diagnostics.push(`${id}: ${String(e)}`);
141
+ }
142
+ }
143
+ return { registry, diagnostics };
144
+ }
145
+ preview(directory) {
146
+ const snapshot = inspectPackage(path.resolve(directory));
147
+ if (snapshot.manifest.id.startsWith('modkh-'))
148
+ throw new Error('modkh- IDs are reserved');
149
+ return snapshot;
150
+ }
151
+ /** Called only after the human approves the displayed exact package digest. */
152
+ install(directory, approvedDigest) {
153
+ const snapshot = this.preview(directory);
154
+ if (snapshot.digest !== approvedDigest)
155
+ throw new Error('Plugin changed after trust confirmation');
156
+ return this.transaction(() => {
157
+ const catalog = this.catalog();
158
+ const id = snapshot.manifest.id;
159
+ if (Object.hasOwn(catalog.plugins, id))
160
+ throw new Error(`Duplicate plugin: ${id}. Remove its registration before replacing it.`);
161
+ const destination = this.packagePath(id, snapshot.digest);
162
+ if (!fs.existsSync(destination)) {
163
+ const staging = `${destination}.staging-${randomUUID()}`;
164
+ fs.mkdirSync(staging, { recursive: true, mode: 0o700 });
165
+ for (const [relative, bytes] of snapshot.files) {
166
+ const file = path.join(staging, relative);
167
+ fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
168
+ fs.writeFileSync(file, bytes, { flag: 'wx', mode: 0o600, flush: true });
169
+ }
170
+ if (inspectPackage(staging).digest !== snapshot.digest)
171
+ throw new Error('Staged plugin digest mismatch');
172
+ fs.renameSync(staging, destination);
173
+ // Interrupted staging directories are retained for inspection, never loaded.
174
+ }
175
+ if (inspectPackage(destination).digest !== snapshot.digest)
176
+ throw new Error('Installed plugin digest mismatch');
177
+ catalog.plugins[id] = { digest: snapshot.digest, enabled: true };
178
+ this.save(catalog);
179
+ return { ...snapshot.manifest, digest: snapshot.digest, enabled: true, builtin: false };
180
+ });
181
+ }
182
+ setEnabled(id, enabled) {
183
+ pluginId(id);
184
+ this.transaction(() => {
185
+ const catalog = this.catalog();
186
+ if (id.startsWith('modkh-')) {
187
+ if (!this.discover().registry.get(id))
188
+ throw new Error(`Unknown plugin: ${id}`);
189
+ catalog.disabledBuiltins = catalog.disabledBuiltins.filter(value => value !== id);
190
+ if (!enabled)
191
+ catalog.disabledBuiltins.push(id);
192
+ }
193
+ else {
194
+ const row = catalog.plugins[id];
195
+ if (!row)
196
+ throw new Error(`Unknown plugin: ${id}`);
197
+ // Enabling a corrupted package is not a new trust decision.
198
+ if (enabled && inspectPackage(this.packagePath(id, row.digest)).digest !== row.digest)
199
+ throw new Error('Plugin digest mismatch');
200
+ row.enabled = enabled;
201
+ }
202
+ this.save(catalog);
203
+ });
204
+ }
205
+ remove(id) {
206
+ pluginId(id);
207
+ this.transaction(() => {
208
+ if (id.startsWith('modkh-'))
209
+ throw new Error('Built-in plugins can be disabled, not removed');
210
+ const catalog = this.catalog();
211
+ if (!catalog.plugins[id])
212
+ throw new Error(`Unknown plugin: ${id}`);
213
+ const leases = path.join(this.base(), 'leases', id);
214
+ if (fs.existsSync(leases) && fs.readdirSync(leases).length)
215
+ throw new Error('Plugin is in use or has an unreconciled lease; stop/reconcile it before removing');
216
+ delete catalog.plugins[id];
217
+ this.save(catalog);
218
+ // Retain immutable packages for audit. Removal unregisters; it never prunes history.
219
+ });
220
+ }
221
+ async acquire(id, digest, signal) {
222
+ signal?.throwIfAborted();
223
+ pluginId(id);
224
+ if (this.sessionEntries) {
225
+ const entry = this.sessionEntries.find(e => e.descriptor.id === id);
226
+ if (!entry?.descriptor.enabled || entry.descriptor.digest !== digest)
227
+ throw new Error('Session agent unavailable or digest mismatch');
228
+ return { descriptor: structuredClone(entry.descriptor), module: { define: () => structuredClone(entry.definition) }, release() { } };
229
+ }
230
+ const admitted = this.transaction(() => {
231
+ const descriptor = this.discover().registry.get(id);
232
+ if (!descriptor?.enabled)
233
+ throw new Error(`Plugin unavailable or disabled: ${id}`);
234
+ if (descriptor.digest !== digest)
235
+ throw new Error('Plugin changed before dispatch');
236
+ const directory = descriptor.builtin ? path.join(this.builtinDir, id) : this.packagePath(id, digest);
237
+ const leases = path.join(this.base(), 'leases', id);
238
+ fs.mkdirSync(leases, { recursive: true, mode: 0o700 });
239
+ const lease = path.join(leases, `${randomUUID()}.json`);
240
+ fs.writeFileSync(lease, JSON.stringify({ pid: process.pid, digest }), { flag: 'wx', mode: 0o600, flush: true });
241
+ return { descriptor: { ...descriptor }, directory, lease };
242
+ });
243
+ let released = false;
244
+ const release = () => { if (!released) {
245
+ fs.unlinkSync(admitted.lease);
246
+ released = true;
247
+ } };
248
+ try {
249
+ if (inspectPackage(admitted.directory).digest !== digest)
250
+ throw new Error('Plugin changed before import');
251
+ const module = await importWithSignal(`${pathToFileURL(path.join(admitted.directory, admitted.descriptor.entry)).href}?digest=${digest}`, signal);
252
+ return { descriptor: admitted.descriptor, module, release };
253
+ }
254
+ catch (e) {
255
+ // A cancelled dynamic import cannot be unloaded; retain its lease for inspection.
256
+ if (!(e instanceof PluginLoadInterrupted))
257
+ release();
258
+ throw e;
259
+ }
260
+ }
261
+ }
@@ -0,0 +1,13 @@
1
+ import type { PluginManifest } from './api.ts';
2
+ export declare function object(value: unknown): Record<string, unknown>;
3
+ export declare function text(value: unknown, name: string, max?: number): string;
4
+ export declare function fields(value: Record<string, unknown>, names: string[]): void;
5
+ export declare function pluginId(value: unknown): string;
6
+ export declare function parseManifest(value: unknown): PluginManifest;
7
+ export interface PackageSnapshot {
8
+ manifest: PluginManifest;
9
+ digest: string;
10
+ files: Map<string, Buffer>;
11
+ }
12
+ /** Bounded, deterministic package capture. No executable code is imported here. */
13
+ export declare function inspectPackage(directory: string): PackageSnapshot;
@@ -0,0 +1,99 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { createHash } from 'node:crypto';
4
+ export function object(value) {
5
+ if (!value || typeof value !== 'object' || Array.isArray(value))
6
+ throw new Error('JSON object required');
7
+ return value;
8
+ }
9
+ export function text(value, name, max = 4096) {
10
+ if (typeof value !== 'string' || !value.trim() || Buffer.byteLength(value) > max || /[\u0000-\u0008\u000b-\u001f\u007f]/.test(value))
11
+ throw new Error(`Invalid ${name}`);
12
+ return value;
13
+ }
14
+ export function fields(value, names) {
15
+ for (const name of Object.keys(value))
16
+ if (!names.includes(name))
17
+ throw new Error(`Unknown field: ${name}`);
18
+ }
19
+ export function pluginId(value) {
20
+ const id = text(value, 'plugin ID', 64);
21
+ if (!/^[a-z][a-z0-9-]*$/.test(id))
22
+ throw new Error('Invalid plugin ID');
23
+ return id;
24
+ }
25
+ export function parseManifest(value) {
26
+ const m = object(value);
27
+ fields(m, ['apiVersion', 'id', 'version', 'title', 'description', 'kind', 'entry']);
28
+ if (m.apiVersion !== 1)
29
+ throw new Error('Unsupported plugin API version');
30
+ if (m.kind !== 'local' && m.kind !== 'external')
31
+ throw new Error('Invalid plugin kind');
32
+ const entry = text(m.entry, 'entry', 512);
33
+ if (!/^\.\//.test(entry) || entry.includes('\\') || entry.split('/').includes('..') || !/\.(?:mjs|js)$/.test(entry))
34
+ throw new Error('Entry must be a relative ESM file inside the package');
35
+ return { apiVersion: 1, id: pluginId(m.id), version: text(m.version, 'version', 128), title: text(m.title, 'title', 256), description: text(m.description, 'description'), kind: m.kind, entry };
36
+ }
37
+ /** Bounded, deterministic package capture. No executable code is imported here. */
38
+ export function inspectPackage(directory) {
39
+ if (!fs.lstatSync(directory).isDirectory())
40
+ throw new Error('Plugin root must be a real directory');
41
+ const files = new Map();
42
+ let bytes = 0;
43
+ let entries = 0;
44
+ function visit(relative, depth) {
45
+ if (depth > 32)
46
+ throw new Error('Plugin directory depth exceeds 32');
47
+ for (const name of fs.readdirSync(path.join(directory, relative)).sort()) {
48
+ if (++entries > 1000)
49
+ throw new Error('Plugin exceeds 1000 entries');
50
+ const rel = relative ? `${relative}/${name}` : name;
51
+ const full = path.join(directory, rel);
52
+ const stat = fs.lstatSync(full);
53
+ if (stat.isSymbolicLink())
54
+ throw new Error('Plugin symlinks are not allowed');
55
+ if (stat.isDirectory()) {
56
+ visit(rel, depth + 1);
57
+ continue;
58
+ }
59
+ if (!stat.isFile())
60
+ throw new Error('Plugin contains a non-regular file');
61
+ bytes += stat.size;
62
+ if (bytes > 10 * 1024 * 1024 || (rel === 'plugin.json' && stat.size > 65536))
63
+ throw new Error('Plugin size limit exceeded');
64
+ const fd = fs.openSync(full, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW);
65
+ try {
66
+ const current = fs.fstatSync(fd);
67
+ if (!current.isFile() || current.ino !== stat.ino || current.dev !== stat.dev || current.size !== stat.size)
68
+ throw new Error('Plugin changed during capture');
69
+ // Never read an unbounded growing file after the initial size check.
70
+ const data = Buffer.alloc(stat.size);
71
+ let offset = 0;
72
+ while (offset < data.length) {
73
+ const count = fs.readSync(fd, data, offset, data.length - offset, offset);
74
+ if (!count)
75
+ throw new Error('Plugin changed during capture');
76
+ offset += count;
77
+ }
78
+ const end = fs.fstatSync(fd);
79
+ if (end.size !== stat.size || end.mtimeMs !== current.mtimeMs || end.ctimeMs !== current.ctimeMs)
80
+ throw new Error('Plugin changed during capture');
81
+ files.set(rel, data);
82
+ }
83
+ finally {
84
+ fs.closeSync(fd);
85
+ }
86
+ }
87
+ }
88
+ visit('', 0);
89
+ const manifestBytes = files.get('plugin.json');
90
+ if (!manifestBytes)
91
+ throw new Error('Missing plugin.json');
92
+ const manifest = parseManifest(JSON.parse(manifestBytes.toString('utf8')));
93
+ if (!files.has(manifest.entry.slice(2)))
94
+ throw new Error('Missing plugin entry');
95
+ const hash = createHash('sha256');
96
+ for (const [name, data] of files)
97
+ hash.update(JSON.stringify([name, data.length])).update(data);
98
+ return { manifest, digest: hash.digest('hex'), files };
99
+ }
@@ -0,0 +1,8 @@
1
+ import type { PluginDescriptor } from './api.ts';
2
+ /** Registration ownership is exact: an old disposer cannot remove a replacement. */
3
+ export declare class SubagentRegistry {
4
+ private entries;
5
+ register(descriptor: PluginDescriptor): () => void;
6
+ list(): PluginDescriptor[];
7
+ get(id: string): Readonly<PluginDescriptor> | undefined;
8
+ }
@@ -0,0 +1,14 @@
1
+ /** Registration ownership is exact: an old disposer cannot remove a replacement. */
2
+ export class SubagentRegistry {
3
+ entries = new Map();
4
+ register(descriptor) {
5
+ if (this.entries.has(descriptor.id))
6
+ throw new Error(`Duplicate plugin: ${descriptor.id}`);
7
+ const entry = Object.freeze(structuredClone(descriptor));
8
+ this.entries.set(entry.id, entry);
9
+ return () => { if (this.entries.get(entry.id) === entry)
10
+ this.entries.delete(entry.id); };
11
+ }
12
+ list() { return [...this.entries.values()].map(d => structuredClone(d)); }
13
+ get(id) { const value = this.entries.get(id); return value ? structuredClone(value) : undefined; }
14
+ }
@@ -0,0 +1,82 @@
1
+ import type { AgentMessage, ToolResult } from '../agent/types.ts';
2
+ import type { DelegationRecord } from '../subagents/types.ts';
3
+ export type SessionStatus = 'active' | 'complete' | 'interrupted' | 'error' | 'turn-limit';
4
+ /** JSONL の1行目。セッションの基本情報。seq は同ディレクトリ内の作成順(一覧の決定的並び替え用)。 */
5
+ export interface SessionHeader {
6
+ type: 'session';
7
+ version?: 2;
8
+ parentSessionId?: string;
9
+ rootSessionId?: string;
10
+ id: string;
11
+ createdAt: string;
12
+ cwd: string;
13
+ model: string;
14
+ seq: number;
15
+ }
16
+ export interface MemoryObservation {
17
+ stage: 'retrieved' | 'supplied' | 'unavailable' | 'capture';
18
+ content?: string;
19
+ outcome?: string;
20
+ elapsedMs?: number;
21
+ }
22
+ export interface SessionSummary {
23
+ id: string;
24
+ createdAt: string;
25
+ cwd: string;
26
+ model: string;
27
+ status: SessionStatus;
28
+ seq: number;
29
+ }
30
+ /** 既定の保存先。MODKH_HOME で差し替え可能(検証用)。 */
31
+ export declare function defaultSessionDir(): string;
32
+ /**
33
+ * JSONL セッションストア。1行1イベント。append で追記し、読み込みで再構築する。
34
+ * ステータスはイベントとして追記し、最後のものが有効。完了と中断を区別する。
35
+ */
36
+ export declare class SessionStore {
37
+ private readonly dir;
38
+ constructor(dir?: string);
39
+ create(cwd: string, model: string, child?: {
40
+ id: string;
41
+ parentSessionId: string;
42
+ rootSessionId: string;
43
+ }): Session;
44
+ load(id: string): Session;
45
+ list(): SessionSummary[];
46
+ private fileOf;
47
+ }
48
+ export declare class Session {
49
+ messages: AgentMessage[];
50
+ status: SessionStatus;
51
+ lastError?: string;
52
+ id: string;
53
+ /** ヘッダの作成時刻(ワークスペース記録に使う)。古いファイルは作成時刻がない。 */
54
+ createdAt: string;
55
+ cwd: string;
56
+ model: string;
57
+ private file;
58
+ modelBaseUrl?: string;
59
+ private persistedCount;
60
+ private version;
61
+ parentSessionId?: string;
62
+ rootSessionId?: string;
63
+ private delegationLog;
64
+ private constructor();
65
+ static fromText(id: string, file: string, text: string): Session;
66
+ private recoverPending;
67
+ append(msg: AgentMessage): void;
68
+ /**
69
+ * ループが配列へ直接追加したメッセージをファイルへ追記する(メモリには既にある)。
70
+ * 既存呼び出しのindex引数は互換用。保存済み位置はSession自身が追跡し、二重追記しない。
71
+ */
72
+ persistFrom(_index: number): void;
73
+ recordMemory(observation: MemoryObservation): void;
74
+ setConnection(model: string, baseUrl?: string): void;
75
+ setStatus(status: SessionStatus, diagnostic?: string): void;
76
+ delegations(): DelegationRecord[];
77
+ private acceptDelegation;
78
+ recordDelegation(record: DelegationRecord): void;
79
+ /** 結果不明のツール呼び出し(中断の痕跡)。再開時の表示と再実行禁止の根拠に使う。 */
80
+ unknownToolResults(): ToolResult[];
81
+ private write;
82
+ }