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,16 @@
1
+ import type { LocalDefinition, PluginDescriptor } from '../plugins/api.ts';
2
+ export interface SessionDefinition {
3
+ descriptor: PluginDescriptor;
4
+ definition: LocalDefinition;
5
+ }
6
+ export interface LispConfiguration {
7
+ digest: string;
8
+ entries: SessionDefinition[];
9
+ }
10
+ export declare const REQUIRED_SKILLS: readonly ["kiokuko-single-purpose-functions", "one-shot-software-completion"];
11
+ export declare function validateDefinitions(raw: unknown, digest: string): SessionDefinition[];
12
+ export declare function loadLispConfiguration(file: string, trustedDigest: string, options?: {
13
+ sbcl?: string;
14
+ signal?: AbortSignal;
15
+ timeoutMs?: number;
16
+ }): Promise<LispConfiguration>;
@@ -0,0 +1,159 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { readBundledSkill, MODKH_SKILL_BINDING } from "../agent/bundled-skills.js";
4
+ import { executeBounded, privateEnvironment, temporaryDirectory, sha256 } from "./runtime.js";
5
+ const TOOLS = new Set(['code_outline', 'code_definition', 'code_references', 'code_diagnostics', 'code_hover', 'edit_file', 'verify_tla', 'verify_lean']);
6
+ const LANGUAGES = new Set(['php', 'common-lisp', 'js', 'ts', 'svelte', 'tailwindcss', 'html', 'css', 'tla', 'lean']);
7
+ const KINDS = new Set(['outline', 'definition', 'references', 'diagnostics', 'hover', 'edit', 'verify']);
8
+ export const REQUIRED_SKILLS = ['kiokuko-single-purpose-functions', 'one-shot-software-completion'];
9
+ function string(value, name, max) {
10
+ if (typeof value !== 'string' || !value.trim() || Buffer.byteLength(value) > max || /[\x00-\x08\x0b\x0c\x0e-\x1f]/.test(value))
11
+ throw new Error(`Invalid ${name}`);
12
+ return value;
13
+ }
14
+ function paths(value) {
15
+ if (!Array.isArray(value) || !value.length || value.length > 128 || !value.every(v => typeof v === 'string' && v.length < 1024 && !path.isAbsolute(v) && !v.split(/[\\/]/).some((p) => !p || p === '.' || p === '..')))
16
+ throw new Error('Invalid verification manifest paths');
17
+ if (new Set(value).size !== value.length)
18
+ throw new Error('Duplicate manifest path');
19
+ return [...value];
20
+ }
21
+ export function validateDefinitions(raw, digest) {
22
+ if (!Array.isArray(raw) || raw.length > 64)
23
+ throw new Error('Expected at most 64 definitions');
24
+ const ids = new Set();
25
+ const skills = REQUIRED_SKILLS.map(name => `\n\n--- ${name} (full SKILL.md) ---\n${readBundledSkill(name, 'SKILL.md', false)}`).join('');
26
+ return raw.map(row => {
27
+ if (!row || typeof row !== 'object' || Array.isArray(row))
28
+ throw new Error('Invalid definition');
29
+ const allowed = ['id', 'title', 'tool', 'language', 'task-kind', 'instruction', 'max-turns', 'enabled', 'workflow', 'check', 'sources', 'protected'];
30
+ if (Object.keys(row).some(key => !allowed.includes(key)))
31
+ throw new Error('Unknown definition field');
32
+ const id = string(row.id, 'id', 64);
33
+ if (!/^micro-[a-z0-9]+(?:-[a-z0-9]+)*$/.test(id) || ids.has(id))
34
+ throw new Error('Duplicate or unsafe microagent ID');
35
+ ids.add(id);
36
+ const tool = string(row.tool, 'tool', 64);
37
+ if (!TOOLS.has(tool))
38
+ throw new Error(`Unknown tool: ${tool}`);
39
+ const language = row.language ?? '';
40
+ const taskKind = row['task-kind'] ?? '';
41
+ if (language && !LANGUAGES.has(language))
42
+ throw new Error('Unknown language');
43
+ if (taskKind && !KINDS.has(taskKind))
44
+ throw new Error('Unknown task kind');
45
+ const maxTurns = row['max-turns'] ?? 4;
46
+ if (!Number.isInteger(maxTurns) || maxTurns < 1 || maxTurns > 32)
47
+ throw new Error('max-turns must be 1..32');
48
+ if (typeof row.enabled !== 'boolean')
49
+ throw new Error('Invalid enabled flag');
50
+ if (row.workflow && row.workflow !== 'edit-verify')
51
+ throw new Error('Unknown workflow');
52
+ if ((tool === 'edit_file') !== (row.workflow === 'edit-verify'))
53
+ throw new Error('edit_file requires edit-verify workflow');
54
+ if (row.check && row.workflow !== 'edit-verify')
55
+ throw new Error('Only edit workflows accept checks');
56
+ const instruction = string(row.instruction, 'instruction', 8192);
57
+ const definition = {
58
+ system: `MoDKH microagent ${id}. ${row.workflow ? 'Edit only the explicit owner-approved source snapshots. Never change the verifier.' : 'Observe only using your assigned tools.'} Host/parent owns final acceptance. Skills do not add tools or authority. Unread references are not evidence.\n${MODKH_SKILL_BINDING}\n${instruction}${skills}`,
59
+ tools: tool === 'edit_file' ? ['read_file', 'edit_file'] : [tool],
60
+ skillPolicy: 'none', maxTurns, requireAllTools: true,
61
+ ...(language === 'tailwindcss' ? { languageServer: 'tailwind' } : {}),
62
+ ...(row.workflow ? { workflow: 'edit-verify' } : {}),
63
+ };
64
+ if (row.check)
65
+ definition.verificationCommand = string(row.check, 'check', 4096);
66
+ if (row.sources || row.protected) {
67
+ definition.verificationManifest = { sources: paths(row.sources), protected: paths(row.protected) };
68
+ if (definition.verificationManifest.sources.some(p => definition.verificationManifest.protected.includes(p)))
69
+ throw new Error('Source and verifier paths overlap');
70
+ }
71
+ return { descriptor: { apiVersion: 1, id, version: 'session', title: row.title ? string(row.title, 'title', 256) : id,
72
+ description: instruction, kind: 'local', entry: '', digest, builtin: false,
73
+ capabilities: [...definition.tools], enabled: row.enabled && (tool !== 'edit_file' || !!(definition.verificationCommand && definition.verificationManifest)), language, taskKind }, definition };
74
+ });
75
+ }
76
+ // This is Common Lisp evaluated by SBCL, not an S-expression parser in JavaScript.
77
+ const DRIVER = String.raw `
78
+ (defpackage :modkh (:use :cl) (:export :defmicroagent :register-agent :disable-agent :remove-agent :list-agents :set-agent-check))
79
+ (in-package :modkh)
80
+ (defvar *agents* (make-hash-table :test 'equal))
81
+ (defun agent-id (id) (string-downcase (string id)))
82
+ (defun register-agent (id &rest fields)
83
+ (setf id (agent-id id))
84
+ (when (gethash id *agents*) (error "Duplicate agent: ~a" id))
85
+ (unless (evenp (length fields)) (error "Odd keyword list"))
86
+ (loop for (key value) on fields by #'cddr
87
+ unless (member key '(:title :tool :language :task-kind :instruction :max-turns :workflow)) do (error "Unknown field: ~a" key))
88
+ (let ((keys (loop for (key value) on fields by #'cddr collect key)))
89
+ (unless (= (length keys) (length (remove-duplicates keys))) (error "Duplicate field")))
90
+ (when (>= (hash-table-count *agents*) 64) (error "Too many agents"))
91
+ (setf (gethash id *agents*) (append (list :id id :enabled t) fields)) id)
92
+ (defmacro defmicroagent (id &rest fields) (list* 'register-agent (list 'quote id) fields))
93
+ (defun disable-agent (id) (let ((row (gethash (agent-id id) *agents*))) (unless row (error "Unknown agent")) (setf (getf row :enabled) nil)))
94
+ (defun remove-agent (id) (remhash (agent-id id) *agents*))
95
+ (defun list-agents () (loop for row being the hash-values of *agents* collect (copy-tree row)))
96
+ (defun set-agent-check (id command &key sources protected)
97
+ (let ((row (gethash (agent-id id) *agents*)))
98
+ (unless row (error "Unknown agent"))
99
+ (setf (getf row :check) command (getf row :sources) sources (getf row :protected) protected
100
+ (gethash (agent-id id) *agents*) row)))
101
+ (defun json-string (value out)
102
+ (write-char #\" out)
103
+ (loop for c across value do
104
+ (case c (#\" (write-string "\\\"" out)) (#\\ (write-string "\\\\" out))
105
+ (#\Newline (write-string "\\n" out)) (#\Return (write-string "\\r" out)) (#\Tab (write-string "\\t" out))
106
+ (otherwise (if (< (char-code c) 32) (format out "\\u~4,'0x" (char-code c)) (write-char c out)))))
107
+ (write-char #\" out))
108
+ (defun json-value (value out)
109
+ (cond ((null value) (write-string "null" out)) ((eq value t) (write-string "true" out))
110
+ ((stringp value) (json-string value out)) ((integerp value) (princ value out))
111
+ ((listp value) (write-char #\[ out) (loop for v in value for i from 0 do (when (> i 0) (write-char #\, out)) (json-value v out)) (write-char #\] out))
112
+ (t (error "Non-JSON value"))))
113
+ (let ((protocol *standard-output*))
114
+ (let ((*standard-output* (make-broadcast-stream)) (*trace-output* (make-broadcast-stream))
115
+ (*error-output* (make-broadcast-stream)) (*terminal-io* (make-two-way-stream (make-string-input-stream "") (make-broadcast-stream))))
116
+ (load "input.lisp" :verbose nil :print nil))
117
+ (write-char #\[ protocol)
118
+ (loop for row being the hash-values of *agents* for i from 0 do
119
+ (when (> i 0) (write-char #\, protocol)) (write-char #\{ protocol)
120
+ (loop for (key value) on row by #'cddr for j from 0 do
121
+ (when (> j 0) (write-char #\, protocol)) (json-string (string-downcase (symbol-name key)) protocol) (write-char #\: protocol)
122
+ (if (eq key :enabled) (write-string (if value "true" "false") protocol) (json-value value protocol)))
123
+ (write-char #\} protocol))
124
+ (write-char #\] protocol) (finish-output protocol))
125
+ `;
126
+ export async function loadLispConfiguration(file, trustedDigest, options = {}) {
127
+ if (!/^[a-f0-9]{64}$/.test(trustedDigest))
128
+ throw new Error('Explicit --trust-lisp-sha256 required');
129
+ const fd = fs.openSync(file, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW);
130
+ let bytes;
131
+ try {
132
+ const stat = fs.fstatSync(fd);
133
+ if (!stat.isFile() || stat.size > 64 * 1024)
134
+ throw new Error('Lisp input must be a file of at most 64 KiB');
135
+ bytes = fs.readFileSync(fd);
136
+ }
137
+ finally {
138
+ fs.closeSync(fd);
139
+ }
140
+ if (bytes.length > 64 * 1024 || sha256(bytes) !== trustedDigest)
141
+ throw new Error('Lisp trust digest mismatch; not evaluated');
142
+ const dir = temporaryDirectory('modkh-lisp-');
143
+ let settled = true;
144
+ try {
145
+ fs.writeFileSync(path.join(dir, 'input.lisp'), bytes, { flag: 'wx', mode: 0o600 });
146
+ fs.writeFileSync(path.join(dir, 'driver.lisp'), DRIVER, { flag: 'wx', mode: 0o600 });
147
+ const receipt = await executeBounded(options.sbcl ?? 'sbcl', ['--noinform', '--no-sysinit', '--no-userinit', '--disable-debugger', '--script', 'driver.lisp'], {
148
+ cwd: dir, env: privateEnvironment(dir), inputDigest: trustedDigest, timeoutMs: Math.min(options.timeoutMs ?? 10000, 10000), signal: options.signal,
149
+ });
150
+ settled = receipt.cleanup === 'settled';
151
+ if (receipt.state !== 'exited' || receipt.exitCode !== 0)
152
+ throw new Error(`Lisp evaluation ${receipt.state}/${receipt.exitCode}: ${receipt.stderr.slice(0, 4096)}`);
153
+ return { digest: trustedDigest, entries: validateDefinitions(JSON.parse(receipt.stdout), trustedDigest) };
154
+ }
155
+ finally {
156
+ if (settled)
157
+ fs.rmSync(dir, { recursive: true, force: true });
158
+ }
159
+ }
@@ -0,0 +1,5 @@
1
+ import type { PluginDescriptor } from '../plugins/api.ts';
2
+ import type { DelegationRequest } from '../subagents/types.ts';
3
+ /** Conservative opt-in rules, never described as LLM judgment. Ambiguity delegates nothing. */
4
+ export declare function routeIntent(task: string, available: PluginDescriptor[]): DelegationRequest | undefined;
5
+ export declare function routeRole(language: string, taskKind: string, task: string, available: PluginDescriptor[]): DelegationRequest | undefined;
@@ -0,0 +1,24 @@
1
+ const EXT = { php: 'php', lisp: 'common-lisp', cl: 'common-lisp', asd: 'common-lisp', js: 'js', mjs: 'js', ts: 'ts', mts: 'ts', svelte: 'svelte', html: 'html', css: 'css', tla: 'tla', lean: 'lean' };
2
+ /** Conservative opt-in rules, never described as LLM judgment. Ambiguity delegates nothing. */
3
+ export function routeIntent(task, available) {
4
+ if (/\b(if|unless|not|don't|without|maybe|or)\b|しない|するな|不要|なら|場合|もし|または|https?:|\.\.|[\\]/i.test(task))
5
+ return;
6
+ const files = [...task.matchAll(/(?:^|\s|`)([A-Za-z0-9_-]+(?:\/[A-Za-z0-9_.-]+)*\.[a-z]+)(?=$|\s|`|[、。])/g)].map(m => m[1]);
7
+ if (files.length !== 1)
8
+ return;
9
+ const language = EXT[files[0].split('.').at(-1)];
10
+ if (!language)
11
+ return;
12
+ const rules = [['outline', /\b(outline|structure)\b|構造/], ['definition', /\bdefinition\b|定義/], ['references', /\breferences\b|参照/], ['diagnostics', /\bdiagnostics\b|診断/], ['hover', /\bhover\b|ホバー/], ['edit', /\b(edit|fix|change)\b|修正|編集/], ['verify', /\bverify\b|検証/]];
13
+ const kinds = rules.filter(([, re]) => re.test(task));
14
+ if (kinds.length !== 1)
15
+ return;
16
+ const matches = available.filter(d => d.language === language && d.taskKind === kinds[0][0]);
17
+ if (matches.length !== 1)
18
+ return;
19
+ return { pluginId: matches[0].id, task, ...(kinds[0][0] === 'edit' ? { targetPaths: files } : {}) };
20
+ }
21
+ export function routeRole(language, taskKind, task, available) {
22
+ const matches = available.filter(d => d.language === language && d.taskKind === taskKind);
23
+ return matches.length === 1 && taskKind !== 'edit' ? { pluginId: matches[0].id, task } : undefined;
24
+ }
@@ -0,0 +1,21 @@
1
+ export declare const sha256: (bytes: string | Buffer) => string;
2
+ export interface ExecutionReceipt {
3
+ state: 'exited' | 'aborted' | 'timed-out' | 'not-started' | 'output-limit' | 'unknown';
4
+ exitCode: number | null;
5
+ signal: string | null;
6
+ stdout: string;
7
+ stderr: string;
8
+ inputDigest: string;
9
+ cleanup: 'settled' | 'unknown';
10
+ }
11
+ export declare function privateEnvironment(home: string): NodeJS.ProcessEnv;
12
+ export declare function temporaryDirectory(prefix: string): string;
13
+ /** shell:false, bounded pipes and owned POSIX process group. Escaped sessions are not a sandbox. */
14
+ export declare function executeBounded(command: string, args: string[], options: {
15
+ cwd: string;
16
+ env: NodeJS.ProcessEnv;
17
+ inputDigest: string;
18
+ timeoutMs: number;
19
+ maxOutputBytes?: number;
20
+ signal?: AbortSignal;
21
+ }): Promise<ExecutionReceipt>;
@@ -0,0 +1,83 @@
1
+ import fs from 'node:fs';
2
+ import os from 'node:os';
3
+ import path from 'node:path';
4
+ import { spawn } from 'node:child_process';
5
+ import { StringDecoder } from 'node:string_decoder';
6
+ import { createHash } from 'node:crypto';
7
+ export const sha256 = (bytes) => createHash('sha256').update(bytes).digest('hex');
8
+ export function privateEnvironment(home) {
9
+ return { PATH: process.env.PATH ?? '/usr/bin:/bin', LANG: process.env.LANG ?? 'C.UTF-8',
10
+ HOME: home, TMPDIR: home, XDG_CONFIG_HOME: home, XDG_CACHE_HOME: home,
11
+ XDG_DATA_HOME: home, XDG_STATE_HOME: home,
12
+ ...(process.env.SBCL_HOME ? { SBCL_HOME: process.env.SBCL_HOME } : {}) };
13
+ }
14
+ export function temporaryDirectory(prefix) { return fs.mkdtempSync(path.join(os.tmpdir(), prefix)); }
15
+ /** shell:false, bounded pipes and owned POSIX process group. Escaped sessions are not a sandbox. */
16
+ export function executeBounded(command, args, options) {
17
+ const base = { state: 'not-started', exitCode: null, signal: null, stdout: '', stderr: '', inputDigest: options.inputDigest, cleanup: 'settled' };
18
+ if (options.signal?.aborted)
19
+ return Promise.resolve(base);
20
+ if (process.platform === 'win32')
21
+ return Promise.resolve({ ...base, stderr: 'POSIX process groups required' });
22
+ return new Promise(resolve => {
23
+ const child = spawn(command, args, { cwd: options.cwd, env: options.env, shell: false, detached: true, stdio: ['ignore', 'pipe', 'pipe'] });
24
+ let closed = false, finished = false, bytes = 0;
25
+ const decoders = { stdout: new StringDecoder('utf8'), stderr: new StringDecoder('utf8') };
26
+ let stopped;
27
+ let poll, deadline;
28
+ const alive = () => {
29
+ if (!child.pid)
30
+ return false;
31
+ try {
32
+ process.kill(-child.pid, 0);
33
+ return true;
34
+ }
35
+ catch (e) {
36
+ return e.code !== 'ESRCH';
37
+ }
38
+ };
39
+ const kill = () => { if (child.pid) {
40
+ try {
41
+ process.kill(-child.pid, 'SIGKILL');
42
+ }
43
+ catch { /* checked at settlement */ }
44
+ } };
45
+ const finish = (unknown = false) => {
46
+ if (finished || (!unknown && (!closed || alive())))
47
+ return;
48
+ finished = true;
49
+ clearTimeout(timer);
50
+ clearTimeout(deadline);
51
+ clearInterval(poll);
52
+ options.signal?.removeEventListener('abort', abort);
53
+ child.stdout?.destroy();
54
+ child.stderr?.destroy();
55
+ resolve({ ...base, state: unknown ? 'unknown' : stopped ?? (base.exitCode === null ? 'not-started' : 'exited'), cleanup: unknown ? 'unknown' : 'settled' });
56
+ };
57
+ const stop = (state) => {
58
+ stopped ??= state;
59
+ kill();
60
+ poll ??= setInterval(() => finish(), 20);
61
+ deadline ??= setTimeout(() => finish(true), 3000);
62
+ };
63
+ const abort = () => stop('aborted');
64
+ const timer = setTimeout(() => stop('timed-out'), options.timeoutMs);
65
+ options.signal?.addEventListener('abort', abort, { once: true });
66
+ if (options.signal?.aborted)
67
+ abort();
68
+ const append = (key, data) => {
69
+ const budget = options.maxOutputBytes ?? 256 * 1024;
70
+ const room = Math.max(0, budget - bytes);
71
+ base[key] += decoders[key].write(data.subarray(0, room));
72
+ bytes += data.length;
73
+ if (bytes > budget)
74
+ stop('output-limit');
75
+ };
76
+ child.stdout?.on('data', (data) => append('stdout', data));
77
+ child.stderr?.on('data', (data) => append('stderr', data));
78
+ child.on('error', error => { base.stderr = error.message.slice(0, 4096); });
79
+ child.on('exit', () => { if (alive())
80
+ stop('unknown'); });
81
+ child.on('close', (code, signal) => { closed = true; base.stdout += decoders.stdout.end(); base.stderr += decoders.stderr.end(); base.exitCode = code; base.signal = signal; finish(); });
82
+ });
83
+ }
@@ -0,0 +1,32 @@
1
+ import { type McpOptions } from './mcp.ts';
2
+ export interface MemoryPolicy {
3
+ globalRead: boolean;
4
+ globalWrite: boolean;
5
+ projects: {
6
+ id: string;
7
+ name: string;
8
+ read: boolean;
9
+ }[];
10
+ raw: string;
11
+ }
12
+ export interface CaptureProposal {
13
+ title: string;
14
+ body: string;
15
+ }
16
+ /** unknownは送信済み・結果不明。保存の自動再送をしてはいけない。 */
17
+ export type CaptureOutcome = 'saved' | 'declined' | 'unavailable' | 'unknown';
18
+ export type KiokukoMemoryOptions = McpOptions;
19
+ export interface KiokukoMemory {
20
+ /** memory_policy の取得。接続不能や無効は null(コーディングは続く)。 */
21
+ policy(signal?: AbortSignal): Promise<MemoryPolicy | null>;
22
+ /** policy が読み取りを許可したグローバル/プロジェクトだけを検索する。 */
23
+ recall(query: string, projectId?: string, signal?: AbortSignal): Promise<string | null>;
24
+ /** 表示した提案そのものが承認され、Stopされていない場合だけ保存を送信する。 */
25
+ captureIfApproved(proposal: CaptureProposal, confirm: (display: string) => Promise<boolean>, signal?: AbortSignal): Promise<CaptureOutcome>;
26
+ close(): Promise<void>;
27
+ }
28
+ /**
29
+ * Kiokuko 本体メモリへの接続。既定は無効。
30
+ * 補助機能の障害は本作業へthrowせず、利用不可と保存結果不明を区別する。
31
+ */
32
+ export declare function openKiokukoMemory(enabled: boolean, options?: Partial<KiokukoMemoryOptions>): KiokukoMemory;
@@ -0,0 +1,102 @@
1
+ import { McpStdioClient, McpRequestError } from "./mcp.js";
2
+ const DEFAULT_COMMAND = 'kiokuko';
3
+ const DEFAULT_ARGS = ['mcp', '--profile', 'chatgpt-memory'];
4
+ function disabled() {
5
+ return {
6
+ async policy() { return null; },
7
+ async recall() { return null; },
8
+ async captureIfApproved() { return 'declined'; },
9
+ async close() { },
10
+ };
11
+ }
12
+ /**
13
+ * Kiokuko 本体メモリへの接続。既定は無効。
14
+ * 補助機能の障害は本作業へthrowせず、利用不可と保存結果不明を区別する。
15
+ */
16
+ export function openKiokukoMemory(enabled, options) {
17
+ if (!enabled)
18
+ return disabled();
19
+ const client = new McpStdioClient({
20
+ ...options,
21
+ command: options?.command ?? DEFAULT_COMMAND,
22
+ args: options?.args ?? DEFAULT_ARGS,
23
+ });
24
+ let policy = null;
25
+ const getPolicy = async (signal) => {
26
+ if (signal?.aborted)
27
+ return null;
28
+ if (policy !== null)
29
+ return policy;
30
+ if (!(await client.connect(signal))) {
31
+ if (client.lastError && !signal?.aborted)
32
+ process.stderr.write(`modkh memory: ${client.lastError}\n`);
33
+ return null;
34
+ }
35
+ try {
36
+ const raw = await client.callTool('memory_policy', {}, signal);
37
+ const parsed = JSON.parse(raw);
38
+ if (signal?.aborted)
39
+ return null;
40
+ policy = {
41
+ globalRead: parsed.global?.read === true,
42
+ globalWrite: parsed.global?.write === true,
43
+ projects: (parsed.projects ?? []).map((p) => ({ id: p.id, name: p.name, read: p.read === true })),
44
+ raw,
45
+ };
46
+ return policy;
47
+ }
48
+ catch (e) {
49
+ client.lastError = `memory_policy の取得に失敗した: ${e.message}`;
50
+ return null;
51
+ }
52
+ };
53
+ return {
54
+ policy: getPolicy,
55
+ async recall(query, projectId, signal) {
56
+ const p = await getPolicy(signal);
57
+ if (p === null || signal?.aborted)
58
+ return null;
59
+ const readable = projectId === undefined
60
+ ? p.globalRead : p.projects.some((project) => project.id === projectId && project.read);
61
+ if (!readable)
62
+ return null;
63
+ try {
64
+ const args = { query };
65
+ if (projectId !== undefined)
66
+ args['project'] = projectId;
67
+ return await client.callTool('memory_recall', args, signal);
68
+ }
69
+ catch (e) {
70
+ client.lastError = `memory_recall に失敗した: ${e.message}`;
71
+ return null;
72
+ }
73
+ },
74
+ async captureIfApproved(proposal, confirm, signal) {
75
+ // 呼出元がawait中にオブジェクトを変更しても、承認内容を変えない。
76
+ const snapshot = { title: proposal.title, body: proposal.body };
77
+ if (signal?.aborted)
78
+ return 'declined';
79
+ try {
80
+ const p = await getPolicy(signal);
81
+ if (signal?.aborted)
82
+ return 'declined';
83
+ if (p === null || !p.globalWrite)
84
+ return 'unavailable';
85
+ const display = [
86
+ 'メモリ保存の提案(保存先: グローバルのみ)',
87
+ `タイトル: ${snapshot.title}`, '本文:', snapshot.body,
88
+ ].join('\n');
89
+ if (!(await confirm(display)) || signal?.aborted)
90
+ return 'declined';
91
+ await client.callTool('memory_capture', snapshot, signal);
92
+ return 'saved';
93
+ }
94
+ catch (e) {
95
+ if (e instanceof McpRequestError && e.outcomeUnknown)
96
+ return 'unknown';
97
+ return signal?.aborted ? 'declined' : 'unavailable';
98
+ }
99
+ },
100
+ async close() { await client.close(); },
101
+ };
102
+ }
@@ -0,0 +1,38 @@
1
+ export interface McpOptions {
2
+ command: string;
3
+ args?: string[];
4
+ /** 子プロセスへ渡す追加環境変数(検証用)。 */
5
+ env?: Record<string, string>;
6
+ connectTimeoutMs?: number;
7
+ callTimeoutMs?: number;
8
+ }
9
+ /** 応答を失った要求は、サーバー側で実行済みの可能性がある。 */
10
+ export declare class McpRequestError extends Error {
11
+ readonly outcomeUnknown: boolean;
12
+ constructor(message: string, outcomeUnknown: boolean);
13
+ }
14
+ /** newline-delimited JSON-RPC 2.0。要求の再送は行わない。 */
15
+ export declare class McpStdioClient {
16
+ private child;
17
+ private connecting;
18
+ private stopping;
19
+ private closed;
20
+ private nextId;
21
+ private pending;
22
+ private readonly connectTimeoutMs;
23
+ private readonly callTimeoutMs;
24
+ private readonly opts;
25
+ lastError: string | null;
26
+ constructor(opts: McpOptions);
27
+ connect(signal?: AbortSignal): Promise<boolean>;
28
+ private start;
29
+ listTools(signal?: AbortSignal): Promise<{
30
+ name: string;
31
+ description?: string;
32
+ }[]>;
33
+ callTool(name: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<string>;
34
+ private request;
35
+ private failAll;
36
+ close(): Promise<void>;
37
+ private stopChild;
38
+ }