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.
- package/README.md +24 -2
- package/dist/agent/bundled-skills.d.ts +13 -0
- package/dist/agent/bundled-skills.js +95 -0
- package/dist/agent/images.d.ts +10 -0
- package/dist/agent/images.js +33 -0
- package/dist/agent/loop.d.ts +56 -0
- package/dist/agent/loop.js +155 -0
- package/dist/agent/skills.d.ts +20 -0
- package/dist/agent/skills.js +169 -0
- package/dist/agent/types.d.ts +132 -0
- package/dist/agent/types.js +12 -0
- package/dist/cli/agents.d.ts +8 -0
- package/dist/cli/agents.js +12 -0
- package/dist/cli/approval.d.ts +27 -0
- package/dist/cli/approval.js +62 -0
- package/dist/cli/catalog.d.ts +39 -0
- package/dist/cli/catalog.js +76 -0
- package/dist/cli/chat.d.ts +18 -0
- package/dist/cli/chat.js +733 -0
- package/dist/cli/clipboard.d.ts +9 -0
- package/dist/cli/clipboard.js +54 -0
- package/dist/cli/color.d.ts +42 -0
- package/dist/cli/color.js +176 -0
- package/dist/cli/config.d.ts +41 -0
- package/dist/cli/config.js +188 -0
- package/dist/cli/editor.d.ts +16 -0
- package/dist/cli/editor.js +77 -0
- package/dist/cli/keys.d.ts +18 -0
- package/dist/cli/keys.js +82 -0
- package/dist/cli/language.d.ts +1 -0
- package/dist/cli/language.js +105 -0
- package/dist/cli/limits.d.ts +13 -0
- package/dist/cli/limits.js +19 -0
- package/dist/cli/lines.d.ts +18 -0
- package/dist/cli/lines.js +80 -0
- package/dist/cli/models.d.ts +4 -0
- package/dist/cli/models.js +69 -0
- package/dist/cli/permissions.d.ts +25 -0
- package/dist/cli/permissions.js +30 -0
- package/dist/cli/plugins.d.ts +1 -0
- package/dist/cli/plugins.js +53 -0
- package/dist/cli/providers.d.ts +46 -0
- package/dist/cli/providers.js +76 -0
- package/dist/cli/terminal.d.ts +143 -0
- package/dist/cli/terminal.js +742 -0
- package/dist/cli/usage.d.ts +29 -0
- package/dist/cli/usage.js +75 -0
- package/dist/index.d.ts +11 -0
- package/dist/index.js +164 -0
- package/dist/language/catalog.d.ts +44 -0
- package/dist/language/catalog.js +100 -0
- package/dist/language/commonlisp-bundled.d.ts +11 -0
- package/dist/language/commonlisp-bundled.js +22 -0
- package/dist/language/commonlisp-dependencies.d.ts +16 -0
- package/dist/language/commonlisp-dependencies.js +68 -0
- package/dist/language/commonlisp-install.d.ts +14 -0
- package/dist/language/commonlisp-install.js +213 -0
- package/dist/language/commonlisp-reader.d.ts +17 -0
- package/dist/language/commonlisp-reader.js +47 -0
- package/dist/language/commonlisp-systems.d.ts +3 -0
- package/dist/language/commonlisp-systems.js +32 -0
- package/dist/language/commonlisp-tls.d.ts +10 -0
- package/dist/language/commonlisp-tls.js +51 -0
- package/dist/language/detect.d.ts +29 -0
- package/dist/language/detect.js +103 -0
- package/dist/language/grammars/LICENSE +24 -0
- package/dist/language/grammars/manifest.json +76 -0
- package/dist/language/grammars/tree-sitter-c.wasm +0 -0
- package/dist/language/grammars/tree-sitter-cpp.wasm +0 -0
- package/dist/language/grammars/tree-sitter-css.wasm +0 -0
- package/dist/language/grammars/tree-sitter-html.wasm +0 -0
- package/dist/language/grammars/tree-sitter-javascript.wasm +0 -0
- package/dist/language/grammars/tree-sitter-php.wasm +0 -0
- package/dist/language/grammars/tree-sitter-python.wasm +0 -0
- package/dist/language/grammars/tree-sitter-ruby.wasm +0 -0
- package/dist/language/grammars/tree-sitter-rust.wasm +0 -0
- package/dist/language/grammars/tree-sitter-swift.wasm +0 -0
- package/dist/language/grammars/tree-sitter-tsx.wasm +0 -0
- package/dist/language/grammars/tree-sitter-typescript.wasm +0 -0
- package/dist/language/install.d.ts +50 -0
- package/dist/language/install.js +293 -0
- package/dist/language/lsp/client.d.ts +97 -0
- package/dist/language/lsp/client.js +337 -0
- package/dist/language/lsp/pool.d.ts +67 -0
- package/dist/language/lsp/pool.js +122 -0
- package/dist/language/lsp/service.d.ts +46 -0
- package/dist/language/lsp/service.js +138 -0
- package/dist/language/native.d.ts +8 -0
- package/dist/language/native.js +100 -0
- package/dist/language/platform.d.ts +14 -0
- package/dist/language/platform.js +20 -0
- package/dist/language/positions.d.ts +20 -0
- package/dist/language/positions.js +46 -0
- package/dist/language/syntax/assets.d.ts +9 -0
- package/dist/language/syntax/assets.js +73 -0
- package/dist/language/syntax/parser.d.ts +24 -0
- package/dist/language/syntax/parser.js +144 -0
- package/dist/language/typescript-capability.d.ts +6 -0
- package/dist/language/typescript-capability.js +42 -0
- package/dist/lisp/config.d.ts +16 -0
- package/dist/lisp/config.js +159 -0
- package/dist/lisp/routing.d.ts +5 -0
- package/dist/lisp/routing.js +24 -0
- package/dist/lisp/runtime.d.ts +21 -0
- package/dist/lisp/runtime.js +83 -0
- package/dist/memory/kiokuko.d.ts +32 -0
- package/dist/memory/kiokuko.js +102 -0
- package/dist/memory/mcp.d.ts +38 -0
- package/dist/memory/mcp.js +211 -0
- package/dist/model/ai-sdk.d.ts +27 -0
- package/dist/model/ai-sdk.js +180 -0
- package/dist/model/chatgpt/login.d.ts +42 -0
- package/dist/model/chatgpt/login.js +180 -0
- package/dist/model/chatgpt/responses.d.ts +41 -0
- package/dist/model/chatgpt/responses.js +202 -0
- package/dist/model/chatgpt/tokens.d.ts +11 -0
- package/dist/model/chatgpt/tokens.js +50 -0
- package/dist/model/connection.d.ts +6 -0
- package/dist/model/connection.js +65 -0
- package/dist/model/context.d.ts +9 -0
- package/dist/model/context.js +69 -0
- package/dist/model/factory.d.ts +25 -0
- package/dist/model/factory.js +88 -0
- package/dist/model/fixed.d.ts +17 -0
- package/dist/model/fixed.js +41 -0
- package/dist/model/reasoning.d.ts +16 -0
- package/dist/model/reasoning.js +62 -0
- package/dist/plugins/api.d.ts +60 -0
- package/dist/plugins/api.js +1 -0
- package/dist/plugins/manager.d.ts +34 -0
- package/dist/plugins/manager.js +261 -0
- package/dist/plugins/package.d.ts +13 -0
- package/dist/plugins/package.js +99 -0
- package/dist/plugins/registry.d.ts +8 -0
- package/dist/plugins/registry.js +14 -0
- package/dist/session/store.d.ts +82 -0
- package/dist/session/store.js +285 -0
- package/dist/session/workspace.d.ts +19 -0
- package/dist/session/workspace.js +73 -0
- package/dist/subagents/processes.d.ts +18 -0
- package/dist/subagents/processes.js +73 -0
- package/dist/subagents/request.d.ts +4 -0
- package/dist/subagents/request.js +21 -0
- package/dist/subagents/service.d.ts +39 -0
- package/dist/subagents/service.js +352 -0
- package/dist/subagents/settings.d.ts +10 -0
- package/dist/subagents/settings.js +32 -0
- package/dist/subagents/types.d.ts +43 -0
- package/dist/subagents/types.js +1 -0
- package/dist/subagents/verification.d.ts +31 -0
- package/dist/subagents/verification.js +178 -0
- package/dist/tools/diff.d.ts +6 -0
- package/dist/tools/diff.js +82 -0
- package/dist/tools/edit.d.ts +3 -0
- package/dist/tools/edit.js +152 -0
- package/dist/tools/files.d.ts +6 -0
- package/dist/tools/files.js +96 -0
- package/dist/tools/formal.d.ts +8 -0
- package/dist/tools/formal.js +77 -0
- package/dist/tools/guard.d.ts +7 -0
- package/dist/tools/guard.js +48 -0
- package/dist/tools/job-tools.d.ts +19 -0
- package/dist/tools/job-tools.js +148 -0
- package/dist/tools/jobs.d.ts +77 -0
- package/dist/tools/jobs.js +181 -0
- package/dist/tools/language.d.ts +6 -0
- package/dist/tools/language.js +174 -0
- package/dist/tools/registry.d.ts +28 -0
- package/dist/tools/registry.js +105 -0
- package/dist/tools/run.d.ts +13 -0
- package/dist/tools/run.js +159 -0
- package/dist/tools/search.d.ts +2 -0
- package/dist/tools/search.js +156 -0
- package/dist/tools/shell-process.d.ts +115 -0
- package/dist/tools/shell-process.js +286 -0
- package/dist/tools/skills.d.ts +2 -0
- package/dist/tools/skills.js +46 -0
- package/dist/tools/web.d.ts +24 -0
- package/dist/tools/web.js +386 -0
- package/docs/ci-repair-20261116.md +30 -0
- package/docs/commonlisp-provider-migration.md +22 -0
- package/docs/commonlisp-qlot-recovery.md +28 -0
- package/docs/commonlisp-tls-recovery.md +28 -0
- package/docs/context-efficiency.md +100 -0
- package/docs/input.md +66 -0
- package/docs/languages.md +117 -0
- package/docs/models.md +85 -0
- package/docs/modkh-evidence.json +641 -0
- package/docs/modkh-failure-comparison.json +675 -0
- package/docs/modkh-namespace.md +39 -0
- package/docs/modkh-qlot-evidence.json +37 -0
- package/docs/modkh-verification.md +173 -0
- package/docs/modkh.md +124 -0
- package/docs/presets.md +19 -0
- package/docs/setup.md +112 -0
- package/docs/subagents.md +134 -0
- package/docs/web.md +57 -0
- package/experiments/presets/common-lisp.lisp +38 -0
- package/experiments/presets/css.lisp +38 -0
- package/experiments/presets/formal.lisp +7 -0
- package/experiments/presets/html.lisp +38 -0
- package/experiments/presets/js.lisp +38 -0
- package/experiments/presets/php.lisp +38 -0
- package/experiments/presets/svelte.lisp +38 -0
- package/experiments/presets/tailwindcss.lisp +24 -0
- package/experiments/presets/ts.lisp +38 -0
- package/package.json +49 -4
- package/plugins/modkh-explorer/index.mjs +3 -0
- package/plugins/modkh-explorer/plugin.json +1 -0
- package/plugins/modkh-worker/index.mjs +3 -0
- package/plugins/modkh-worker/plugin.json +1 -0
- package/skills/kiokuko-dsh/LICENSE +21 -0
- package/skills/kiokuko-dsh/coding-ideal-routine-skill/SKILL.md +106 -0
- package/skills/kiokuko-dsh/japanese-translation-for-oss-models/SKILL.md +65 -0
- package/skills/kiokuko-dsh/kiokuko-architecture/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-architecture/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-benchmark/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-benchmark/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-investigate/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-investigate/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-lisp/SKILL.md +390 -0
- package/skills/kiokuko-dsh/kiokuko-review/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-review/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-simple-work/SKILL.md +70 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/SKILL.md +79 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/boundaries-and-ownership.md +52 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/domain-and-types.md +48 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/effects-and-data.md +43 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/kiokuko-patterns.md +314 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/problem-shaping-and-language.md +90 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/protocols-and-idempotency.md +42 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/review-checklist.md +92 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/verification.md +45 -0
- package/skills/kiokuko-dsh/kiokuko-skill-authoring/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-skill-authoring/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-soul/SKILL.md +25 -0
- package/skills/kiokuko-dsh/kiokuko-technical-writing/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-technical-writing/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/SKILL.md +64 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/accessibility-and-navigation.md +31 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/async-recovery.md +49 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/forms-and-controls.md +35 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/interaction-feedback.md +34 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/responsive-and-platform.md +38 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/safety-and-review.md +43 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/ui-checklist.md +75 -0
- package/skills/kiokuko-dsh/kiokuko-verification/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-verification/references/cases.md +11 -0
- package/skills/kiokuko-dsh/manifest.json +168 -0
- package/skills/kiokuko-dsh/memory-reasoning/SKILL.md +44 -0
- package/skills/kiokuko-dsh/one-shot-software-completion/SKILL.md +113 -0
- package/skills/kiokuko-dsh/one-shot-software-completion/references/boundaries-and-lifecycle.md +70 -0
- package/skills/kiokuko-dsh/one-shot-software-completion/references/discovery-and-scope.md +71 -0
- package/skills/kiokuko-dsh/one-shot-software-completion/references/failure-recovery.md +43 -0
- package/skills/kiokuko-dsh/one-shot-software-completion/references/verification-and-completion.md +73 -0
- package/skills/kiokuko-dsh/veteran-programmer-skill/SKILL.md +66 -0
package/docs/input.md
ADDED
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# 入力欄・画像の貼り付け
|
|
2
|
+
|
|
3
|
+
## 複数行の入力
|
|
4
|
+
|
|
5
|
+
通常の対話入力欄は基本3行です(高さの足りない端末では画面内に収めます)。改行や折り返しに応じて広がります。起動画面では上下へ、会話中は履歴領域を確保しながら上へ広がります。画面の高さを超えた分は入力欄内でスクロールし、カーソル位置を表示します。
|
|
6
|
+
|
|
7
|
+
| 操作 | キー |
|
|
8
|
+
| --- | --- |
|
|
9
|
+
| 送信 | Enter |
|
|
10
|
+
| 改行 | Ctrl+J。端末が対応していればShift+Enter / Option+Enterも使用可能 |
|
|
11
|
+
| 行を移動 | ↑ / ↓ |
|
|
12
|
+
| 行頭・行末 | Home / End、Ctrl+A / Ctrl+E |
|
|
13
|
+
| 入力を消去 | Ctrl+U |
|
|
14
|
+
| Macでテキストを貼り付け | Cmd+V(端末の「ペースト」) |
|
|
15
|
+
| Macで画像を添付 | Ctrl+V |
|
|
16
|
+
| 最後の添付画像を削除・画像読込を中止 | Ctrl+X |
|
|
17
|
+
|
|
18
|
+
Cmd+VはmacOSの端末側が処理するショートカットです。MODKHではテキスト貼り付けを横取りしません。bracketed pasteに対応した端末では、貼り付けた改行を保ち、末尾に改行があっても自動送信しません。複数行の `/exit` などは会話本文として扱い、コマンドを実行しません。
|
|
19
|
+
|
|
20
|
+
プロバイダー検索、認証キー、承認の入力は従来どおり1行です。`MODKH_PLAIN=1` や非TTYの行入力モードでは、複数行エディター・クリップボード画像は使わず、従来の1行ずつの入力を維持します。
|
|
21
|
+
|
|
22
|
+
## Macで画像を送る
|
|
23
|
+
|
|
24
|
+
1. スクリーンショットや画像そのものをクリップボードへコピーします。
|
|
25
|
+
2. MODKHの会話入力欄で **Ctrl+V** を押します。
|
|
26
|
+
3. 「画像を読込中…」の後に **画像1枚** などの添付表示を確認します。
|
|
27
|
+
4. 必要なら説明を入力し、Enterで送信します。画像だけでも送信できます。
|
|
28
|
+
|
|
29
|
+
画像がない、読み取れない、大きすぎる場合は入力欄に理由を表示します。既存のテキストと他の添付画像は消しません。Ctrl+Xで最後の画像を削除できます。読込中の送信は行わず、完了後のEnterを待ちます。Ctrl+Cによる入力取消や終了時は、読込を中止し、遅れて届いた画像を追加しません。
|
|
30
|
+
|
|
31
|
+
画像貼り付けは現在macOSのみ対応しています。macOS標準のAppKitと `osascript` を使い、PNGまたはTIFFの画像データを読み取ります。TIFFはPNGに変換します。ファイルパスやURL、クリップボードのテキストを画像として読み込むことはありません。端末やOSの権限制限で失敗する場合もエラーとして表示します。
|
|
32
|
+
|
|
33
|
+
上限は **4枚、1枚5 MiB、4,000万画素**です。テキストは128 KiBまでです。上限超過を黙って切り捨てたり、画像を外してテキストだけ送信し直したりしません。
|
|
34
|
+
|
|
35
|
+
## モデル・保存先について
|
|
36
|
+
|
|
37
|
+
- **画像に対応したモデル**へ接続してください。MODKHはAI SDK / OpenAI互換APIおよびChatGPT Responses APIへ画像コンテンツとして渡します。個々の接続先が画像に対応するかはモデル次第です。
|
|
38
|
+
- 非対応モデルやAPIで拒否された場合は、そのエラーを表示します。別モデルへの自動切替や、画像を除いた自動再送はしません。`fixed/scripted` は動作確認用で、画像を理解するモデルではありません。
|
|
39
|
+
- 未接続時の画像や、`/connect` などの操作中の添付は保持します。画像は次の通常の会話送信で親モデルへ渡し、サブエージェントへ自動コピーしません。
|
|
40
|
+
- **送信した画像データもテキストと同じセッション履歴へ保存されます。** 再開時に読み戻せます。失敗した送信も履歴に残ります。機密画像を添付する場合は送信先と履歴の保存に注意してください。
|
|
41
|
+
- 画像の内容やbase64を端末のログに展開せず、添付枚数だけを表示します。画像を自動でメモリサービスへ渡すことはありません。
|
|
42
|
+
|
|
43
|
+
実端末でのCmd+VとCtrl+Vの挙動は、使用するターミナルのキー設定・クリップボードアクセス権にも依存します。
|
|
44
|
+
|
|
45
|
+
## トークン使用量の表示
|
|
46
|
+
|
|
47
|
+
モデルが使用量を返した場合、入力欄の下に1行で表示します。返さない場合は何も表示しません(推測値は出しません)。
|
|
48
|
+
|
|
49
|
+
```text
|
|
50
|
+
計 4.9M tok · cache 100% · 入 4.5M · 出 410k
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
- `計`: 入力+出力の合計。`入`: 入力トークン(プロバイダーがキャッシュ分を含めて数える場合はその値)。`出`: 出力トークン。
|
|
54
|
+
- `cache`: 入力のうちキャッシュから読んだ割合。入力が0のときは表示しません。キャッシュ読取りが入力に含まれない集計をする接続先では値の意味が変わります。
|
|
55
|
+
- 端末幅が足りないときは右側の項目から落として1行を保ちます。折り返して入力欄を押し下げません。
|
|
56
|
+
- 行入力モード(`MODKH_PLAIN=1`・非TTY)では、各応答の後に `(使用量: …)` として1行出します。
|
|
57
|
+
- 表示はセッション内の累計です。再起動すると0から数え直し、履歴の分は含みません。保存もしません。
|
|
58
|
+
|
|
59
|
+
## 処理中の状態と長い検索結果
|
|
60
|
+
|
|
61
|
+
- AI SDK経由では「モデル応答を待機中」「モデルが推論中」「ツール要求を受信中」を区別します。推論本文は表示・保存しません。1回のモデル応答は最大180秒で打ち切り、自動再送はしません。Ctrl+Cでも中止できます。
|
|
62
|
+
- `search_files` はGit管理下ではGitの除外設定を適用します。Git管理外では `.git`、`node_modules`、`.agenticreplay`、`dist` などの生成・管理ディレクトリを除外します。最大50件・出力16 KiBで、長い行は一致箇所の周辺だけを省略表示します。探索上限や読めなかったファイルも明示します。
|
|
63
|
+
- 長いツール結果はモデル入力に限って1件16 KiB、最近の本文を優先して合計128 KiBに制限します(省略注記やメッセージ構造は別)。省略は明示し、呼び出しIDと成功・失敗・結果不明の状態は保ちます。セッションの原記録は削除・上書きしません。
|
|
64
|
+
- この版以降はエラーの説明も状態イベントに最大2,048文字で残し、再開時に表示します。過去の版で保存されなかったAPIエラーの詳細は復元できません。
|
|
65
|
+
|
|
66
|
+
再開する場合は元の作業ディレクトリで `node dist/index.js chat --resume <セッションID>` を実行し、必要なら `/connect` で再接続します。ビルド更新は、すでに起動中のプロセスや別途インストールしたグローバル版へは自動反映されません。
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
# 言語解析(LSP・tree-sitter)
|
|
2
|
+
|
|
3
|
+
MODKHは対象ファイルの言語を検出し、必要な解析器だけを準備して、読み取り・編集・調査に使います。利用者が毎回「LSPを使って」と指示したり、言語ごとにインストールする必要はありません。
|
|
4
|
+
|
|
5
|
+
## 自動で起きること
|
|
6
|
+
|
|
7
|
+
| 契機 | 実行内容 |
|
|
8
|
+
| --- | --- |
|
|
9
|
+
| 対象ファイルの初回 `read_file` | 言語検出、構文解析、言語サーバーの準備要求、構造と診断を本文に付記 |
|
|
10
|
+
| `create_file` / `edit_file` 成功後 | 新内容で再解析し、LSPへ同期して診断を取得 |
|
|
11
|
+
| `code_outline` など | 構文構造・定義・参照・ホバーを取得 |
|
|
12
|
+
| セッション終了 | 起動した言語サーバーをすべて停止 |
|
|
13
|
+
|
|
14
|
+
解析は**補助情報**です。解析が失敗・タイムアウトしても、読み取りや編集の成否は変わりません。編集が成功したあとに解析だけが失敗しても、二重編集はしません。
|
|
15
|
+
|
|
16
|
+
初期値では、同時に起動する言語サーバーは3台までです。上限を超えると最も長く使っていないサーバーを停止します。
|
|
17
|
+
|
|
18
|
+
## 対応状況
|
|
19
|
+
|
|
20
|
+
実サーバー・実WASMで起動と診断を確認したものだけを「実証済み」としています。実証していないものは未検証です。
|
|
21
|
+
|
|
22
|
+
| 対象 | 構文解析(WASM同梱) | 言語サーバー | 実証状況 |
|
|
23
|
+
| --- | --- | --- | --- |
|
|
24
|
+
| TypeScript / JavaScript / TSX | あり | typescript-language-server(自動導入) | 実証済み(型エラー検出・編集後の解消・再利用) |
|
|
25
|
+
| CSS | あり | vscode-css-language-server(自動導入) | 実証済み(構文エラー検出) |
|
|
26
|
+
| HTML | あり | vscode-html-language-server(自動導入) | 起動・診断取得は実証済み。不正HTMLを診断0件とする仕様は実測どおり |
|
|
27
|
+
| Python | あり | basedpyright(自動導入) | 起動・診断は未実証 |
|
|
28
|
+
| Rust / C / C++ | あり | rust-analyzer / clangd(既存実行ファイルのみ) | 起動・診断は未実証。toolchainが無い場合は意味解析を縮退 |
|
|
29
|
+
| Ruby / Swift / PHP | あり | ruby-lsp / sourcekit-lsp / PHPantom(既存実行ファイルのみ) | 未実証。SDKやgemが無い場合は縮退 |
|
|
30
|
+
| Svelte | **なし** | svelte-language-server(自動導入) | 文法WASMが未収録のため構文解析は縮退。意味解析は未実証 |
|
|
31
|
+
| Tailwind CSS | ホスト言語の文法 | @tailwindcss/language-server(自動導入) | 未実証 |
|
|
32
|
+
| Common Lisp | **なし** | CL-LSP(既存実行ファイルのみ) | 未実証。マクロ展開や評価は行わない |
|
|
33
|
+
|
|
34
|
+
Svelte・Common Lisp は文法WASMを同梱していないため、`code_outline` などは「対象外」と理由を返します。本文の読み書きは通常どおりできます。
|
|
35
|
+
|
|
36
|
+
## 導入と保存先
|
|
37
|
+
|
|
38
|
+
- 解析器は `MODKH_HOME`(既定は `~/.config/modkh`)配下の `language/` に置きます。対象プロジェクトの依存・lockfileは変更しません。
|
|
39
|
+
- npm系は専用prefixと専用キャッシュへ導入し、`--ignore-scripts` で導入時のコード実行を避けます。プロジェクトや利用者のnpmキャッシュは変更しません。
|
|
40
|
+
- 導入先は一時領域に作り、検証後に原子的に公開します。同時導入はロックで排他します。
|
|
41
|
+
- 導入した版・取得元・検証時刻は `language/state.json` に記録します。毎起動時にlatestを取り直しません。
|
|
42
|
+
- 失敗はその言語だけの縮退です。記録した失敗を同じターンで無限に再試行しません。
|
|
43
|
+
|
|
44
|
+
### 操作コマンド
|
|
45
|
+
|
|
46
|
+
```sh
|
|
47
|
+
modkh language status # 検出・導入状態・文法の有無
|
|
48
|
+
modkh language install # すべての宣言済み言語を導入(手操作は通常不要)
|
|
49
|
+
modkh language install --detected # 検出した言語だけ
|
|
50
|
+
modkh language retry <id> # 失敗記録を消して再試行
|
|
51
|
+
modkh language update # 導入済みサーバーと文法を検証し直す
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
通常利用ではこれらは不要です。最初の読み取りで自動的に準備します。
|
|
55
|
+
|
|
56
|
+
## 設定
|
|
57
|
+
|
|
58
|
+
`config.json` の `language` で調整できます。不正な値は既定へ戻します。
|
|
59
|
+
|
|
60
|
+
```json
|
|
61
|
+
{
|
|
62
|
+
"language": {
|
|
63
|
+
"autoInstall": true,
|
|
64
|
+
"disabled": ["ruby"],
|
|
65
|
+
"installTimeoutMs": 180000,
|
|
66
|
+
"requestTimeoutMs": 20000,
|
|
67
|
+
"servers": {
|
|
68
|
+
"python": { "command": "/opt/homebrew/bin/pyright-langserver", "args": ["--stdio"] }
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
- `autoInstall: false` にすると自動導入しません。既存サーバーだけを使います。
|
|
75
|
+
- `servers` は言語ごとの明示指定です。指定した実行ファイルを優先します。
|
|
76
|
+
- `disabled` の言語は解析しません(本文操作は可能)。
|
|
77
|
+
|
|
78
|
+
## ツール
|
|
79
|
+
|
|
80
|
+
`search_files` は文字列検索として残ります。シンボル調査では次を優先します。
|
|
81
|
+
|
|
82
|
+
- `code_outline`: 関数・クラス等の構造と範囲(1開始の行・桁)
|
|
83
|
+
- `code_syntax_search`: 構文上の定義名の検索。意味上の参照ではない
|
|
84
|
+
- `code_definition` / `code_references` / `code_hover`: 位置的問い合わせ
|
|
85
|
+
- `code_diagnostics`: 現在の内容を同期して診断を取得
|
|
86
|
+
|
|
87
|
+
構文上の同名を、意味上の同一参照とは扱いません。
|
|
88
|
+
|
|
89
|
+
## 状態の区別
|
|
90
|
+
|
|
91
|
+
診断について次の3状態を混同しません。
|
|
92
|
+
|
|
93
|
+
- **診断0件**: サーバーが現在の版に対して「問題なし」を通知した
|
|
94
|
+
- **未通知**: まだ結果が来ていない(成功ではない)
|
|
95
|
+
- **古い版**: 通知された版が現在の内容より古い(現在の診断として返さない)
|
|
96
|
+
|
|
97
|
+
文書を変更したときは版を進め、古い版の診断は捨てます。同じ内容の再解析では版を進めません。
|
|
98
|
+
|
|
99
|
+
## 境界と制約
|
|
100
|
+
|
|
101
|
+
- 位置はLSP仕様のUTF-16単位です。UTF-8バイト位置とは異なります。CRLFも変換しません。
|
|
102
|
+
- サーバー発の `workspace/applyEdit` は適用しません。編集は必ず承認付きツール経由です。
|
|
103
|
+
- ファイルツールのルート制限は、外部LSPプロセス自体を隔離するものではありません。サーバーは利用者権限で動きます。
|
|
104
|
+
- 2 MiBを超えるファイルは解析しません(本文操作は可能)。
|
|
105
|
+
- XcodeやOS管理者権限が必要なSDKは自動取得しません。前提不足として表示します。
|
|
106
|
+
- 実端末・実サーバーでの検証はmacOS arm64が中心です。Linux等は別途検証が必要です。
|
|
107
|
+
|
|
108
|
+
## 検証
|
|
109
|
+
|
|
110
|
+
```sh
|
|
111
|
+
npm run typecheck
|
|
112
|
+
npm test
|
|
113
|
+
npm run build
|
|
114
|
+
sh scripts/acceptance.sh
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
`npm run build` は文法WASMを `dist/language/grammars/` へ同梱します(約20MB)。`scripts/acceptance.sh` は隔離環境へ配布物を導入し、空の管理領域からの自動導入、実際の型エラー診断、再利用時に再導入しないこと、修正後に診断が消えること、`language status` が状態を変更しないことを確認します。
|
package/docs/models.md
ADDED
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
# モデル接続と ChatGPT ログイン
|
|
2
|
+
|
|
3
|
+
## モデル参照と選択画面
|
|
4
|
+
|
|
5
|
+
`modkh` を起動し、`/connect` で OpenAI / OpenCode / Ollama Local / Ollama Cloud / OpenRouter / Infron / Hermes Agent を選ぶ。
|
|
6
|
+
TTYでは入力で検索、↑↓で選択、Enterで決定、Escで戻る。OpenAIではChatGPT OAuthとAPIキーを選べる。
|
|
7
|
+
APIキーは環境変数を優先し、未設定ならTTYで伏せ字入力できる。入力したキーは `keys.json`(0600)に保存し、次回起動時に再利用する。
|
|
8
|
+
`/models` は組み込み候補からの選択であり、利用可能なモデルの完全な一覧ではない。
|
|
9
|
+
|
|
10
|
+
`chat --model <provider>/<model>`、または `/connect <provider>/<model> [--base-url <url>]` で直接指定もできる。
|
|
11
|
+
接続に失敗しても別の接続先へ自動で切り替えない。モデルの選択だけではAPI到達や利用権限は検証されない。
|
|
12
|
+
|
|
13
|
+
## 選んだモデルの保存と次回起動
|
|
14
|
+
|
|
15
|
+
`/connect` や `/models` で接続したモデル(と `--base-url`)は `config.json` に保存され、次回の起動はそのモデルで開く。
|
|
16
|
+
`--model` を渡したときはそちらが優先。`--resume` はセッション自身の接続を最優先する。`fixed/*` は検証専用なので保存しない。
|
|
17
|
+
|
|
18
|
+
復元には認証情報も要る。TTYで入力したAPIキーは `keys.json`(0600)に保存され、次回起動時に自動で読まれる。
|
|
19
|
+
環境変数だけで接続した場合はキーが保存されないため、その環境変数を外した状態で起動すると復元できない。
|
|
20
|
+
そのときは「保存済みキーが無い」と表示するので、`/connect <provider>` で1度キーを保存すれば以降は自動で復元される。
|
|
21
|
+
|
|
22
|
+
`config.json` は一時ファイルに書いてから置き換えるため、強制終了で途中まで書かれた状態を残さない。
|
|
23
|
+
万一JSONが壊れていても `model` など復元に必要な値は読み取り、壊れた内容は `config.json.broken` に退避する。
|
|
24
|
+
手書きした未知のキーは保存時に保持される。
|
|
25
|
+
|
|
26
|
+
| Provider | 認証 | 既定URL・設定 |
|
|
27
|
+
| --- | --- | --- |
|
|
28
|
+
| `openai` | `OPENAI_API_KEY` | OpenAI API |
|
|
29
|
+
| `opencode` | `OPENCODE_API_KEY` | `https://opencode.ai/inference/openai/v1` / `OPENCODE_BASE_URL` |
|
|
30
|
+
| `ollama`(Local) | 不要 | `http://127.0.0.1:11434/v1` / `OLLAMA_BASE_URL` |
|
|
31
|
+
| `ollama-cloud` | `OLLAMA_API_KEY` | `https://ollama.com/v1` / `OLLAMA_CLOUD_BASE_URL` |
|
|
32
|
+
| `openrouter` | `OPENROUTER_API_KEY` | `https://openrouter.ai/api/v1` |
|
|
33
|
+
| `infron` | `INFRON_API_KEY` | `https://llm.onerouter.pro/v1` / `INFRON_BASE_URL` |
|
|
34
|
+
| `hermes` | `HERMES_API_KEY` | `http://127.0.0.1:8642/v1` / `HERMES_BASE_URL` |
|
|
35
|
+
| `chatgpt` | ChatGPT OAuth | `https://chatgpt.com/backend-api/codex/responses` |
|
|
36
|
+
|
|
37
|
+
既存の `anthropic` / `google` / `deepseek` / `groq` / `xai` / `lmstudio` も直接指定と `/models` から利用できる。
|
|
38
|
+
`compatible/<model> --base-url <url>` は任意のOpenAI互換API、`fixed/scripted` はオフライン検証専用。
|
|
39
|
+
|
|
40
|
+
HermesはモデルAPIではなく、サーバー側でツールを実行する別エージェント。
|
|
41
|
+
Hermes側の `API_SERVER_KEY` をMODKHの `HERMES_API_KEY` に指定する。
|
|
42
|
+
MODKHの個別承認やStopでリモートの副作用を制御・停止できる保証はないため、接続時に確認画面を出す。
|
|
43
|
+
|
|
44
|
+
## Ollama Local / Cloud
|
|
45
|
+
|
|
46
|
+
`/connect` には **Ollama Local** と **Ollama Cloud** を別々に表示する。
|
|
47
|
+
ローカルは従来どおり `/connect ollama`。クラウドは `/connect ollama-cloud` でキーとモデルを選ぶ。
|
|
48
|
+
`/models ollama-cloud/` でもクラウド候補に絞り込める。
|
|
49
|
+
|
|
50
|
+
クラウドの組み込み候補は `gemma4:31b`、`gpt-oss:120b`、`gpt-oss:20b`。
|
|
51
|
+
一覧外は直接入力できる。候補は固定リストで、モデルの利用可否は送信時に確認する。
|
|
52
|
+
[公式の直接接続手順](https://docs.ollama.com/api/openai-compatibility)に従い、
|
|
53
|
+
`https://ollama.com/v1` と `OLLAMA_API_KEY` を使う。ローカルOllamaのインストール・サインインは不要。
|
|
54
|
+
直接APIでは `:cloud` 接尾辞を付けず、[API一覧のモデル名](https://ollama.com/api/tags)をそのまま使う。
|
|
55
|
+
`OLLAMA_BASE_URL` はLocalだけ、`OLLAMA_CLOUD_BASE_URL` はCloudだけに適用する。
|
|
56
|
+
Cloudのキー未設定・通信失敗時にLocalへ自動で切り替えない。
|
|
57
|
+
|
|
58
|
+
## Sign in with ChatGPT
|
|
59
|
+
|
|
60
|
+
```sh
|
|
61
|
+
modkh auth login chatgpt
|
|
62
|
+
# またはMODKH内で /connect → OpenAI → ChatGPT
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
- PKCE (S256) とランダムなstateを使い、`https://auth.openai.com/oauth/authorize` で認証する。
|
|
66
|
+
- ローカルの `http://127.0.0.1:1455/auth/callback` を待ち受けてからブラウザを開く。
|
|
67
|
+
- 正しいパス・stateのコールバックだけを受理し、`/oauth/token` で一度だけ交換する。
|
|
68
|
+
- トークンを `$MODKH_HOME/chatgpt-auth.json`(既定 `~/.config/modkh/`)へ0600で保存した後、ブラウザに成功を表示する。
|
|
69
|
+
- ポート使用中、認証拒否、交換エラーは端末に表示する。他プロセスは停止しない。Ctrl+Cで中止でき、コールバックサーバーも閉じる。
|
|
70
|
+
- ブラウザが自動で開かなければ表示URLを手動で開く。SSH・コンテナではコールバックへ到達できる構成が必要。
|
|
71
|
+
- 期限切れの認証は次の送信前に更新する。更新失敗時は `/connect chatgpt` で再認証する。モデル要求を自動再送しない。
|
|
72
|
+
- ChatGPT用トークンはCodex Responsesへ送信する。通常のOpenAI APIキー用エンドポイントとは分離する。
|
|
73
|
+
`store: false`、フラットな `type: "function"` のツール定義を使う。
|
|
74
|
+
|
|
75
|
+
## 検証範囲と参照
|
|
76
|
+
|
|
77
|
+
実OAuthログインや有料モデルへのライブ送信は未検証。ローカルの偽HTTPサーバーで
|
|
78
|
+
PKCE・コールバック・交換・保存・キャンセル・ポート競合・期限切れ更新とCLI接続を検証する。
|
|
79
|
+
TTY入出力ストリームの統合テストに加え、`scripts/terminal-acceptance.py` は実PTYで操作する。
|
|
80
|
+
PTY権限のないサンドボックスでは後者を実行できない。
|
|
81
|
+
|
|
82
|
+
- [OpenAI CodexのOAuth実装](https://github.com/openai/codex/blob/main/codex-rs/login/src/server.rs)
|
|
83
|
+
- [OpenCode Console](https://opencode.ai/docs/console/models/)
|
|
84
|
+
- [Infron OpenAI-compatible API](https://infron.ai/docs/llm-apis/openai-compatible-api/overview)
|
|
85
|
+
- [Hermes Agent API server](https://hermes-agent.nousresearch.com/docs/user-guide/features/api-server)
|