modkh 0.1.0 → 0.2.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 +42 -0
- package/dist/agent/bundled-skills.d.ts +1 -1
- package/dist/agent/bundled-skills.js +1 -1
- package/dist/agent/compaction.d.ts +53 -0
- package/dist/agent/compaction.js +191 -0
- package/dist/agent/loop.d.ts +55 -8
- package/dist/agent/loop.js +119 -7
- package/dist/agent/skills.d.ts +7 -1
- package/dist/agent/skills.js +26 -5
- package/dist/agent/types.d.ts +14 -9
- package/dist/cli/agenticreplay.d.ts +1 -0
- package/dist/cli/agenticreplay.js +66 -0
- package/dist/cli/answer-markdown.d.ts +3 -0
- package/dist/cli/answer-markdown.js +29 -0
- package/dist/cli/approval.d.ts +2 -0
- package/dist/cli/approval.js +35 -5
- package/dist/cli/catalog.d.ts +30 -32
- package/dist/cli/catalog.js +37 -67
- package/dist/cli/chat.js +406 -78
- package/dist/cli/clipboard.d.ts +2 -0
- package/dist/cli/clipboard.js +28 -0
- package/dist/cli/color.d.ts +20 -3
- package/dist/cli/color.js +87 -19
- package/dist/cli/compaction-settings.d.ts +21 -0
- package/dist/cli/compaction-settings.js +54 -0
- package/dist/cli/completion-art.d.ts +2 -0
- package/dist/cli/completion-art.js +62 -0
- package/dist/cli/config.d.ts +9 -0
- package/dist/cli/config.js +5 -1
- package/dist/cli/editor.d.ts +7 -0
- package/dist/cli/editor.js +43 -5
- package/dist/cli/file-mentions.d.ts +14 -0
- package/dist/cli/file-mentions.js +141 -0
- package/dist/cli/head-checks.d.ts +41 -0
- package/dist/cli/head-checks.js +146 -0
- package/dist/cli/initial-connection.d.ts +7 -0
- package/dist/cli/initial-connection.js +20 -0
- package/dist/cli/keys.d.ts +12 -1
- package/dist/cli/keys.js +29 -4
- package/dist/cli/model-catalog.d.ts +16 -0
- package/dist/cli/model-catalog.js +130 -0
- package/dist/cli/models.d.ts +2 -2
- package/dist/cli/models.js +51 -19
- package/dist/cli/official-models.d.ts +6 -0
- package/dist/cli/official-models.js +77 -0
- package/dist/cli/pdf.d.ts +8 -0
- package/dist/cli/pdf.js +71 -0
- package/dist/cli/providers.d.ts +6 -42
- package/dist/cli/providers.js +44 -38
- package/dist/cli/shell-display.d.ts +6 -0
- package/dist/cli/shell-display.js +35 -0
- package/dist/cli/stateright.d.ts +1 -0
- package/dist/cli/stateright.js +37 -0
- package/dist/cli/terminal-mouse.d.ts +21 -0
- package/dist/cli/terminal-mouse.js +51 -0
- package/dist/cli/terminal.d.ts +95 -7
- package/dist/cli/terminal.js +783 -108
- package/dist/cli/tool-display.d.ts +9 -0
- package/dist/cli/tool-display.js +87 -0
- package/dist/cli/transcript-selection.d.ts +22 -0
- package/dist/cli/transcript-selection.js +75 -0
- package/dist/cli/usage.d.ts +9 -16
- package/dist/cli/usage.js +60 -18
- package/dist/cli/waiting-nyan.d.ts +3 -0
- package/dist/cli/waiting-nyan.js +17 -0
- package/dist/cli/waiting-whales.d.ts +3 -0
- package/dist/cli/waiting-whales.js +24 -0
- package/dist/index.js +30 -8
- package/dist/language/commonlisp-install.d.ts +1 -0
- package/dist/language/commonlisp-install.js +3 -2
- package/dist/language/lsp/client.js +4 -1
- package/dist/language/lsp/pool.d.ts +8 -0
- package/dist/language/lsp/pool.js +21 -3
- package/dist/language/lsp/service.d.ts +8 -4
- package/dist/language/lsp/service.js +51 -15
- package/dist/language/syntax/parser.d.ts +10 -1
- package/dist/language/syntax/parser.js +34 -16
- package/dist/lisp/builtin-agents.d.ts +5 -0
- package/dist/lisp/builtin-agents.js +52 -0
- package/dist/lisp/config.d.ts +9 -0
- package/dist/lisp/config.js +50 -7
- package/dist/lisp/routing.js +2 -2
- package/dist/lisp/runtime.d.ts +5 -0
- package/dist/lisp/runtime.js +26 -2
- package/dist/model/ai-sdk.js +13 -8
- package/dist/model/chatgpt/login.js +1 -1
- package/dist/model/chatgpt/responses.js +56 -4
- package/dist/model/connection.js +2 -0
- package/dist/model/context-window.d.ts +3 -0
- package/dist/model/context-window.js +64 -0
- package/dist/model/context.d.ts +3 -1
- package/dist/model/context.js +24 -24
- package/dist/model/factory.d.ts +3 -1
- package/dist/model/factory.js +28 -27
- package/dist/model/harness-profile.d.ts +6 -0
- package/dist/model/harness-profile.js +23 -0
- package/dist/model/providers.d.ts +32 -0
- package/dist/model/providers.js +72 -0
- package/dist/model/reasoning.d.ts +3 -3
- package/dist/model/reasoning.js +30 -8
- package/dist/model/record-fetch.d.ts +2 -0
- package/dist/model/record-fetch.js +19 -0
- package/dist/plugins/manager.d.ts +2 -1
- package/dist/plugins/manager.js +21 -2
- package/dist/session/store.d.ts +11 -0
- package/dist/session/store.js +27 -1
- package/dist/subagents/head-assignment.d.ts +11 -0
- package/dist/subagents/head-assignment.js +47 -0
- package/dist/subagents/limits.d.ts +4 -0
- package/dist/subagents/limits.js +6 -0
- package/dist/subagents/request.js +18 -1
- package/dist/subagents/service.d.ts +36 -2
- package/dist/subagents/service.js +331 -38
- package/dist/subagents/types.d.ts +20 -0
- package/dist/subagents/verification.d.ts +5 -2
- package/dist/subagents/verification.js +59 -22
- package/dist/tools/browse.d.ts +13 -0
- package/dist/tools/browse.js +117 -0
- package/dist/tools/browser-capability.d.ts +3 -0
- package/dist/tools/browser-capability.js +29 -0
- package/dist/tools/formal-input.d.ts +6 -0
- package/dist/tools/formal-input.js +29 -0
- package/dist/tools/formal.d.ts +3 -2
- package/dist/tools/formal.js +54 -52
- package/dist/tools/jobs.d.ts +2 -0
- package/dist/tools/jobs.js +5 -0
- package/dist/tools/language.js +25 -27
- package/dist/tools/lean-proof.d.ts +38 -0
- package/dist/tools/lean-proof.js +83 -0
- package/dist/tools/registry.d.ts +5 -3
- package/dist/tools/registry.js +13 -5
- package/dist/tools/run.js +13 -9
- package/dist/tools/shell-process.js +17 -6
- package/dist/tools/stateright-runtime.d.ts +3 -0
- package/dist/tools/stateright-runtime.js +16 -0
- package/dist/tools/stateright.d.ts +3 -0
- package/dist/tools/stateright.js +78 -0
- package/dist/tools/web.js +7 -2
- package/dist/version.d.ts +2 -0
- package/dist/version.js +2 -0
- package/docs/commonlisp-build-output.md +14 -0
- package/docs/context-efficiency.md +25 -3
- package/docs/input.md +63 -3
- package/docs/languages.md +3 -3
- package/docs/models.md +30 -6
- package/docs/modkh.md +11 -7
- package/docs/presets.md +45 -0
- package/docs/setup.md +3 -16
- package/docs/stateright.md +45 -0
- package/docs/subagents.md +21 -3
- package/docs/web.md +1 -1
- package/experiments/presets/formal.lisp +15 -4
- package/experiments/presets/language-microagents.lisp +29 -0
- package/native/stateright/Cargo.lock +478 -0
- package/native/stateright/Cargo.toml +11 -0
- package/native/stateright/src/lib.rs +163 -0
- package/native/stateright/src/main.rs +38 -0
- package/package.json +10 -2
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import { type ExecutionReceipt } from '../lisp/runtime.ts';
|
|
2
|
+
export declare const leanProofDriver = "import Lean\nimport Lean.Replay\nopen Lean\n\ndef fromModule (env : Environment) (decl mod : Name) : Bool :=\n (env.getModuleIdxFor? decl).any fun idx => env.header.moduleNames[idx.toNat]? == some mod\n\ndef checkTarget (target : Name) : IO String := do\n initSearchPath (\u2190 getBuildDir)\n let base \u2190 importModules #[{ module := `Lean }, { module := `MoDKHTarget }] {}\n let loaded \u2190 importModules #[{ module := `Lean }, { module := `MoDKHTarget }, { module := `MoDKHProof }] {}\n let some (.defnInfo expected) := base.find? `modkhExpected | return \"invalid-contract\"\n if !fromModule base `modkhExpected `MoDKHTarget || expected.type != mkSort .zero || !expected.levelParams.isEmpty then\n return \"invalid-contract\"\n let some (.thmInfo theoremInfo) := loaded.find? target | return \"target-missing\"\n if !fromModule loaded target `MoDKHProof then return \"target-missing\"\n if !theoremInfo.levelParams.isEmpty then return \"unsupported-universes\"\n let additions := loaded.constants.fold (init := ({} : Std.HashMap Name ConstantInfo)) fun acc name info =>\n if base.contains name then acc else acc.insert name info\n let env \u2190 base.replay additions\n let proof : Declaration := .thmDecl {\n name := `_modkh.checked, levelParams := [], type := expected.value, value := mkConst target }\n match env.addDeclCore 0 proof none with\n | .error _ => return \"statement-mismatch\"\n | .ok env =>\n let (_, result) := ((CollectAxioms.collect `_modkh.checked).run env).run {}\n if result.axioms.any (fun ax => !([`propext, `Classical.choice, `Quot.sound].contains ax)) then\n return \"disallowed-axioms\"\n return \"proved\"\n\ndef main (args : List String) : IO UInt32 := do\n match args with\n | [target] =>\n IO.println (\u2190 checkTarget (target.splitOn \".\" |>.foldl Name.str .anonymous))\n return 0\n | _ => return 2\n";
|
|
3
|
+
export declare function boundLeanReceipt(receipt: ExecutionReceipt): ExecutionReceipt;
|
|
4
|
+
export declare function checkLeanProof(runtime: string, dir: string, contract: Buffer, theorem: string, options: {
|
|
5
|
+
inputDigest: string;
|
|
6
|
+
timeoutMs: number;
|
|
7
|
+
comparisonTimeoutMs: number;
|
|
8
|
+
signal?: AbortSignal;
|
|
9
|
+
}): Promise<{
|
|
10
|
+
readonly proofStatus: "unverified";
|
|
11
|
+
readonly code: "TARGET_CONTRACT_NOT_CHECKED";
|
|
12
|
+
readonly contractReceipt: ExecutionReceipt;
|
|
13
|
+
} | {
|
|
14
|
+
readonly contractReceipt: ExecutionReceipt;
|
|
15
|
+
readonly proofReceipt: ExecutionReceipt;
|
|
16
|
+
readonly proofStatus: "proved";
|
|
17
|
+
readonly code: "TARGET_PROVED";
|
|
18
|
+
} | {
|
|
19
|
+
readonly contractReceipt: ExecutionReceipt;
|
|
20
|
+
readonly proofReceipt: ExecutionReceipt;
|
|
21
|
+
readonly proofStatus: "rejected";
|
|
22
|
+
readonly code: string;
|
|
23
|
+
} | {
|
|
24
|
+
readonly contractReceipt: ExecutionReceipt;
|
|
25
|
+
readonly proofReceipt: ExecutionReceipt;
|
|
26
|
+
readonly proofStatus: "unverified";
|
|
27
|
+
readonly code: "INVALID_TARGET_CONTRACT";
|
|
28
|
+
} | {
|
|
29
|
+
readonly contractReceipt: ExecutionReceipt;
|
|
30
|
+
readonly proofReceipt: ExecutionReceipt;
|
|
31
|
+
readonly proofStatus: "unverified";
|
|
32
|
+
readonly code: "UNSUPPORTED_TARGET_UNIVERSES";
|
|
33
|
+
} | {
|
|
34
|
+
readonly contractReceipt: ExecutionReceipt;
|
|
35
|
+
readonly proofReceipt: ExecutionReceipt;
|
|
36
|
+
readonly proofStatus: "unverified";
|
|
37
|
+
readonly code: "PROOF_UNVERIFIED";
|
|
38
|
+
}>;
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { executeBounded, privateEnvironment } from "../lisp/runtime.js";
|
|
4
|
+
// Load data from compiled modules without enabling candidate initializers. Replay
|
|
5
|
+
// candidate declarations through the kernel before checking the expected type.
|
|
6
|
+
export const leanProofDriver = `import Lean
|
|
7
|
+
import Lean.Replay
|
|
8
|
+
open Lean
|
|
9
|
+
|
|
10
|
+
def fromModule (env : Environment) (decl mod : Name) : Bool :=
|
|
11
|
+
(env.getModuleIdxFor? decl).any fun idx => env.header.moduleNames[idx.toNat]? == some mod
|
|
12
|
+
|
|
13
|
+
def checkTarget (target : Name) : IO String := do
|
|
14
|
+
initSearchPath (← getBuildDir)
|
|
15
|
+
let base ← importModules #[{ module := \`Lean }, { module := \`MoDKHTarget }] {}
|
|
16
|
+
let loaded ← importModules #[{ module := \`Lean }, { module := \`MoDKHTarget }, { module := \`MoDKHProof }] {}
|
|
17
|
+
let some (.defnInfo expected) := base.find? \`modkhExpected | return "invalid-contract"
|
|
18
|
+
if !fromModule base \`modkhExpected \`MoDKHTarget || expected.type != mkSort .zero || !expected.levelParams.isEmpty then
|
|
19
|
+
return "invalid-contract"
|
|
20
|
+
let some (.thmInfo theoremInfo) := loaded.find? target | return "target-missing"
|
|
21
|
+
if !fromModule loaded target \`MoDKHProof then return "target-missing"
|
|
22
|
+
if !theoremInfo.levelParams.isEmpty then return "unsupported-universes"
|
|
23
|
+
let additions := loaded.constants.fold (init := ({} : Std.HashMap Name ConstantInfo)) fun acc name info =>
|
|
24
|
+
if base.contains name then acc else acc.insert name info
|
|
25
|
+
let env ← base.replay additions
|
|
26
|
+
let proof : Declaration := .thmDecl {
|
|
27
|
+
name := \`_modkh.checked, levelParams := [], type := expected.value, value := mkConst target }
|
|
28
|
+
match env.addDeclCore 0 proof none with
|
|
29
|
+
| .error _ => return "statement-mismatch"
|
|
30
|
+
| .ok env =>
|
|
31
|
+
let (_, result) := ((CollectAxioms.collect \`_modkh.checked).run env).run {}
|
|
32
|
+
if result.axioms.any (fun ax => !([\`propext, \`Classical.choice, \`Quot.sound].contains ax)) then
|
|
33
|
+
return "disallowed-axioms"
|
|
34
|
+
return "proved"
|
|
35
|
+
|
|
36
|
+
def main (args : List String) : IO UInt32 := do
|
|
37
|
+
match args with
|
|
38
|
+
| [target] =>
|
|
39
|
+
IO.println (← checkTarget (target.splitOn "." |>.foldl Name.str .anonymous))
|
|
40
|
+
return 0
|
|
41
|
+
| _ => return 2
|
|
42
|
+
`;
|
|
43
|
+
const rejections = new Map([
|
|
44
|
+
['target-missing', 'TARGET_THEOREM_MISSING'],
|
|
45
|
+
['statement-mismatch', 'TARGET_STATEMENT_MISMATCH'],
|
|
46
|
+
['disallowed-axioms', 'DISALLOWED_AXIOMS'],
|
|
47
|
+
]);
|
|
48
|
+
function cleanExit(receipt) {
|
|
49
|
+
return receipt.state === 'exited' && receipt.exitCode === 0 && receipt.cleanup === 'settled';
|
|
50
|
+
}
|
|
51
|
+
export function boundLeanReceipt(receipt) {
|
|
52
|
+
return { ...receipt, stdout: receipt.stdout.slice(0, 1024), stderr: receipt.stderr.slice(0, 1024) };
|
|
53
|
+
}
|
|
54
|
+
export async function checkLeanProof(runtime, dir, contract, theorem, options) {
|
|
55
|
+
const env = privateEnvironment(dir);
|
|
56
|
+
const processOptions = { inputDigest: options.inputDigest, signal: options.signal, cwd: dir, env, maxOutputBytes: 256 * 1024 };
|
|
57
|
+
fs.writeFileSync(path.join(dir, 'MoDKHTarget.lean'), contract, { flag: 'wx', mode: 0o600 });
|
|
58
|
+
const contractReceipt = boundLeanReceipt(await executeBounded(runtime, ['-DwarningAsError=true', '-o', 'MoDKHTarget.olean', 'MoDKHTarget.lean'], {
|
|
59
|
+
...processOptions, timeoutMs: options.timeoutMs,
|
|
60
|
+
}));
|
|
61
|
+
if (!cleanExit(contractReceipt)) {
|
|
62
|
+
return { proofStatus: 'unverified', code: 'TARGET_CONTRACT_NOT_CHECKED', contractReceipt };
|
|
63
|
+
}
|
|
64
|
+
fs.writeFileSync(path.join(dir, 'MoDKHCheck.lean'), leanProofDriver, { flag: 'wx', mode: 0o600 });
|
|
65
|
+
const proofRun = await executeBounded(runtime, ['--run', 'MoDKHCheck.lean', theorem], {
|
|
66
|
+
...processOptions, env: { ...env, LEAN_PATH: dir }, timeoutMs: options.comparisonTimeoutMs,
|
|
67
|
+
});
|
|
68
|
+
const proofReceipt = boundLeanReceipt(proofRun);
|
|
69
|
+
const receipts = { contractReceipt, proofReceipt };
|
|
70
|
+
const verdict = proofRun.stdout.trim();
|
|
71
|
+
if (cleanExit(proofReceipt)) {
|
|
72
|
+
if (verdict === 'proved')
|
|
73
|
+
return { proofStatus: 'proved', code: 'TARGET_PROVED', ...receipts };
|
|
74
|
+
const rejection = rejections.get(verdict);
|
|
75
|
+
if (rejection)
|
|
76
|
+
return { proofStatus: 'rejected', code: rejection, ...receipts };
|
|
77
|
+
if (verdict === 'invalid-contract')
|
|
78
|
+
return { proofStatus: 'unverified', code: 'INVALID_TARGET_CONTRACT', ...receipts };
|
|
79
|
+
if (verdict === 'unsupported-universes')
|
|
80
|
+
return { proofStatus: 'unverified', code: 'UNSUPPORTED_TARGET_UNIVERSES', ...receipts };
|
|
81
|
+
}
|
|
82
|
+
return { proofStatus: 'unverified', code: 'PROOF_UNVERIFIED', ...receipts };
|
|
83
|
+
}
|
package/dist/tools/registry.d.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { Tool, ToolCall, ToolContext, ToolResult } from '../agent/types.ts';
|
|
2
|
+
import { type BrowseTabs } from './browse.ts';
|
|
2
3
|
import type { JobRegistry } from './jobs.ts';
|
|
3
4
|
/**
|
|
4
5
|
* ツール名・引数形状・宣言外の引数を検証する。
|
|
@@ -6,7 +7,8 @@ import type { JobRegistry } from './jobs.ts';
|
|
|
6
7
|
*/
|
|
7
8
|
export declare class ToolRegistry {
|
|
8
9
|
private tools;
|
|
9
|
-
|
|
10
|
+
private readonly onExecute?;
|
|
11
|
+
constructor(tools: Tool[], onExecute?: () => void);
|
|
10
12
|
specs(): {
|
|
11
13
|
name: string;
|
|
12
14
|
description: string;
|
|
@@ -23,6 +25,6 @@ export declare class ToolRegistry {
|
|
|
23
25
|
executeOne(call: ToolCall, ctx: ToolContext): Promise<ToolResult>;
|
|
24
26
|
}
|
|
25
27
|
/** 初版が提供する5区分のツール群(作成/編集は別ツール)。 */
|
|
26
|
-
export declare function defaultTools(): Tool[];
|
|
28
|
+
export declare function defaultTools(tabs?: BrowseTabs): Tool[];
|
|
27
29
|
/** The same tools plus background execution, which needs a per-session job registry. */
|
|
28
|
-
export declare function defaultToolsWithJobs(jobs: JobRegistry): Tool[];
|
|
30
|
+
export declare function defaultToolsWithJobs(jobs: JobRegistry, tabs?: BrowseTabs): Tool[];
|
package/dist/tools/registry.js
CHANGED
|
@@ -5,6 +5,7 @@ import { createFileTool, editFileTool } from "./edit.js";
|
|
|
5
5
|
import { runCommandTool } from "./run.js";
|
|
6
6
|
import { jobTools } from "./job-tools.js";
|
|
7
7
|
import { webTools } from "./web.js";
|
|
8
|
+
import { browseTools } from "./browse.js";
|
|
8
9
|
import { skillTools } from "./skills.js";
|
|
9
10
|
/**
|
|
10
11
|
* ツール名・引数形状・宣言外の引数を検証する。
|
|
@@ -12,7 +13,9 @@ import { skillTools } from "./skills.js";
|
|
|
12
13
|
*/
|
|
13
14
|
export class ToolRegistry {
|
|
14
15
|
tools;
|
|
15
|
-
|
|
16
|
+
onExecute;
|
|
17
|
+
constructor(tools, onExecute) {
|
|
18
|
+
this.onExecute = onExecute;
|
|
16
19
|
this.tools = new Map();
|
|
17
20
|
for (const tool of tools) {
|
|
18
21
|
if (this.tools.has(tool.name))
|
|
@@ -73,6 +76,11 @@ export class ToolRegistry {
|
|
|
73
76
|
return { ...base, status: 'error', output: `[INVALID_ARGS] 未知の引数: ${unknown.join(', ')}` };
|
|
74
77
|
}
|
|
75
78
|
}
|
|
79
|
+
// Display observers must not affect whether an accepted tool runs.
|
|
80
|
+
try {
|
|
81
|
+
this.onExecute?.();
|
|
82
|
+
}
|
|
83
|
+
catch { /* advisory only */ }
|
|
76
84
|
try {
|
|
77
85
|
const output = await tool.execute(call.args, { ...ctx, callId: call.id });
|
|
78
86
|
if (typeof output === 'string')
|
|
@@ -96,10 +104,10 @@ export class ToolRegistry {
|
|
|
96
104
|
}
|
|
97
105
|
}
|
|
98
106
|
/** 初版が提供する5区分のツール群(作成/編集は別ツール)。 */
|
|
99
|
-
export function defaultTools() {
|
|
100
|
-
return [listFilesTool, searchFilesTool, readFileTool, createFileTool, editFileTool, runCommandTool, ...webTools, ...skillTools];
|
|
107
|
+
export function defaultTools(tabs) {
|
|
108
|
+
return [listFilesTool, searchFilesTool, readFileTool, createFileTool, editFileTool, runCommandTool, ...browseTools(tabs), ...webTools, ...skillTools];
|
|
101
109
|
}
|
|
102
110
|
/** The same tools plus background execution, which needs a per-session job registry. */
|
|
103
|
-
export function defaultToolsWithJobs(jobs) {
|
|
104
|
-
return [...defaultTools(), ...jobTools(jobs)];
|
|
111
|
+
export function defaultToolsWithJobs(jobs, tabs) {
|
|
112
|
+
return [...defaultTools(tabs), ...jobTools(jobs)];
|
|
105
113
|
}
|
package/dist/tools/run.js
CHANGED
|
@@ -3,6 +3,7 @@ import { ToolError } from "../agent/types.js";
|
|
|
3
3
|
import { resolveInRoot, assertRealInRoot } from "./guard.js";
|
|
4
4
|
import { describeShellResult, ShellProcess, SHELLS } from "./shell-process.js";
|
|
5
5
|
import { prepareCommand } from "./job-tools.js";
|
|
6
|
+
import { browserCapability } from "./browser-capability.js";
|
|
6
7
|
export { runShellProcess, runShell, describeShellResult, resolveShell, SHELLS, TextSink, ShellProcess } from "./shell-process.js";
|
|
7
8
|
const DEFAULT_TIMEOUT_MS = 120_000;
|
|
8
9
|
/** A single foreground call may run longer than the default, but never without a bound. */
|
|
@@ -66,7 +67,7 @@ const PARAMETERS = {
|
|
|
66
67
|
description: { type: 'string', description: '何をするコマンドか(5〜10語、命令形。例: "run unit tests")' },
|
|
67
68
|
command: { type: 'string', description: '実行するコマンド' },
|
|
68
69
|
cwd: { type: 'string', description: '作業ディレクトリ(ルート相対、既定はルート)' },
|
|
69
|
-
shell: { type: 'string', enum: [...SHELLS], description: '使用するシェル(既定 sh。bash
|
|
70
|
+
shell: { type: 'string', enum: [...SHELLS], description: '使用するシェル(既定 sh。bash は set -eou pipefail を先頭に追加する)' },
|
|
70
71
|
timeoutMs: { type: 'number', description: `制限時間(ミリ秒、既定 ${DEFAULT_TIMEOUT_MS}、上限 ${MAX_TIMEOUT_MS})` },
|
|
71
72
|
run_in_background: { type: 'boolean', description: 'true にすると即座に job_id を返し、結果は job_output で読む。長時間かかる処理で使う' },
|
|
72
73
|
},
|
|
@@ -79,15 +80,18 @@ const PARAMETERS = {
|
|
|
79
80
|
* caller can turn it off to keep the strict "a deadline is a failure" contract.
|
|
80
81
|
*/
|
|
81
82
|
export const DEFAULT_PROMOTE_ON_TIMEOUT = true;
|
|
83
|
+
const BACKGROUND_JOB_HELP = 'ジョブが終了すると通知が届きます。実行中に出力を確認するには job_output、中止するには job_kill に上のジョブIDを指定してください。';
|
|
82
84
|
export const runCommandTool = {
|
|
83
85
|
name: 'run_command',
|
|
84
86
|
operationIdentity: OPERATION_IDENTITY,
|
|
85
|
-
description
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
87
|
+
get description() {
|
|
88
|
+
return 'シェルコマンドを1回実行し、終了コード・stdout・stderr を返す。作業場所は作業ルート内に限る。'
|
|
89
|
+
+ '終了コードが0以外でも実行結果として返る(エラー扱いにはしない)。'
|
|
90
|
+
+ 'cd は次の呼び出しに引き継がれないので cwd を指定する。'
|
|
91
|
+
+ '確認は grep やテスト実行のように終了コードを見て判断する。'
|
|
92
|
+
+ 'run_in_background を true にすると待たずに job_id を返す。ビルドやテストの全体実行など、'
|
|
93
|
+
+ '制限時間に収まらない見込みの処理で使う。' + browserCapability();
|
|
94
|
+
},
|
|
91
95
|
parameters: PARAMETERS,
|
|
92
96
|
async execute(args, ctx) {
|
|
93
97
|
const prepared = await authorize(args, ctx);
|
|
@@ -99,7 +103,7 @@ export const runCommandTool = {
|
|
|
99
103
|
return [
|
|
100
104
|
`[job_id: ${view.id}] [status: ${view.status}]`,
|
|
101
105
|
`作業場所: ${view.cwd}`,
|
|
102
|
-
|
|
106
|
+
BACKGROUND_JOB_HELP,
|
|
103
107
|
].join('\n');
|
|
104
108
|
}
|
|
105
109
|
const timeoutMs = positiveInt(args.timeoutMs, 'timeoutMs', MAX_TIMEOUT_MS) ?? DEFAULT_TIMEOUT_MS;
|
|
@@ -140,7 +144,7 @@ export const runCommandTool = {
|
|
|
140
144
|
return [
|
|
141
145
|
`[job_id: ${outcome.view.id}] [status: ${outcome.view.status}]`,
|
|
142
146
|
`制限時間(${timeoutMs}ms)に達したためバックグラウンドジョブへ移した。コマンドは実行を続けている。`,
|
|
143
|
-
|
|
147
|
+
BACKGROUND_JOB_HELP,
|
|
144
148
|
].join('\n');
|
|
145
149
|
}
|
|
146
150
|
return describeShellResult(outcome.result);
|
|
@@ -115,14 +115,15 @@ export class ShellProcess {
|
|
|
115
115
|
promoteOnTimeout;
|
|
116
116
|
constructor(command, cwd, opts = {}) {
|
|
117
117
|
requireString(command, 'command');
|
|
118
|
-
|
|
118
|
+
const { name, file } = resolveShell(opts.shell);
|
|
119
|
+
this.shell = name;
|
|
119
120
|
const maxOutput = opts.maxOutputBytes ?? 32 * 1024;
|
|
120
121
|
this.out = new TextSink(Math.floor(maxOutput / 2));
|
|
121
122
|
this.err = new TextSink(Math.max(1, Math.ceil(maxOutput / 2)));
|
|
122
123
|
this.timeoutMs = opts.timeoutMs ?? 0;
|
|
123
124
|
this.promoteOnTimeout = opts.onTimeout !== undefined;
|
|
124
|
-
const
|
|
125
|
-
this.child = spawn(file, ['-c',
|
|
125
|
+
const script = name === 'bash' ? `set -eou pipefail\n${command}` : command;
|
|
126
|
+
this.child = spawn(file, ['-c', script], {
|
|
126
127
|
cwd,
|
|
127
128
|
...(opts.env === undefined ? {} : { env: opts.env }),
|
|
128
129
|
detached: true,
|
|
@@ -221,8 +222,12 @@ export class ShellProcess {
|
|
|
221
222
|
const reason = this.stopReason === 'timeout' ? `制限時間(${this.timeoutMs}ms)を超過した`
|
|
222
223
|
: this.stopReason === 'descendants' ? 'shell終了後に残った子処理を停止した'
|
|
223
224
|
: this.stopReason === 'killed' ? '停止を要求された' : 'コマンドを中断した';
|
|
224
|
-
//
|
|
225
|
-
|
|
225
|
+
// Confirmed descendant cleanup is a command lifecycle error the agent can repair.
|
|
226
|
+
// User cancellation and deadlines still make the command's effects uncertain.
|
|
227
|
+
const code = this.stopReason === 'descendants' ? 'RUN_FAILED' : 'ABORTED';
|
|
228
|
+
const guidance = this.stopReason === 'descendants'
|
|
229
|
+
? '。子処理の停止は確認済み。終了コードだけで成功と判断しない。出力と後片付けを確認し、必要な修正を行う。' : '';
|
|
230
|
+
this.fail(new ToolError(code, `${reason}(code=${this.code ?? '不明'} signal=${this.exitSignal ?? 'なし'})${guidance}\n${describeShellResult(result)}`));
|
|
226
231
|
}
|
|
227
232
|
else if (this.failure !== undefined || this.exitSignal !== null) {
|
|
228
233
|
// A signalled shell is an infrastructure stop, not an ordinary failure code.
|
|
@@ -234,8 +239,14 @@ export class ShellProcess {
|
|
|
234
239
|
}
|
|
235
240
|
/** Terminate the process group; the result rejects with the reason once the group is gone. */
|
|
236
241
|
stop(reason = 'killed') {
|
|
237
|
-
if (this.settled
|
|
242
|
+
if (this.settled)
|
|
238
243
|
return;
|
|
244
|
+
if (this.stopReason) {
|
|
245
|
+
// A real Stop during automatic cleanup must never become a recoverable error.
|
|
246
|
+
if (this.stopReason === 'descendants' && reason !== 'descendants')
|
|
247
|
+
this.stopReason = reason;
|
|
248
|
+
return;
|
|
249
|
+
}
|
|
239
250
|
this.stopReason = reason;
|
|
240
251
|
this.killGroup('SIGTERM');
|
|
241
252
|
// Do not clear escalation merely because the shell closed its pipes.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { configDir } from "../cli/config.js";
|
|
4
|
+
export function staterightRoot() { return path.join(configDir(), 'stateright'); }
|
|
5
|
+
/** Preserve stable symlink paths; never persist a resolved versioned executable. */
|
|
6
|
+
export function findStateright(explicit) {
|
|
7
|
+
const candidates = explicit ? [path.resolve(explicit)] : [path.join(staterightRoot(), 'bin', 'modkh-stateright'),
|
|
8
|
+
...(process.env.PATH ?? '').split(path.delimiter).filter(Boolean).map(dir => path.resolve(dir, 'modkh-stateright'))];
|
|
9
|
+
return candidates.find(file => { try {
|
|
10
|
+
fs.accessSync(file, fs.constants.X_OK);
|
|
11
|
+
return fs.statSync(file).isFile();
|
|
12
|
+
}
|
|
13
|
+
catch {
|
|
14
|
+
return false;
|
|
15
|
+
} });
|
|
16
|
+
}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { ToolError } from "../agent/types.js";
|
|
4
|
+
import { executeBounded, privateEnvironment, temporaryDirectory } from "../lisp/runtime.js";
|
|
5
|
+
import { snapshot } from "./formal-input.js";
|
|
6
|
+
import { findStateright } from "./stateright-runtime.js";
|
|
7
|
+
/** Check result identity and replay any counterexample before accepting a native receipt. */
|
|
8
|
+
function validReport(value, digest, bytes, exitCode) {
|
|
9
|
+
try {
|
|
10
|
+
const r = value;
|
|
11
|
+
const model = JSON.parse(bytes.toString('utf8'));
|
|
12
|
+
if (!r || r.schemaVersion !== 1 || r.verifier !== 'stateright' || r.inputSha256 !== digest
|
|
13
|
+
|| !Number.isSafeInteger(r.exploredStates) || Number(r.exploredStates) < 1 || Number(r.exploredStates) > model.states.length
|
|
14
|
+
|| !Array.isArray(r.violatedInvariants) || typeof r.deadlock !== 'boolean')
|
|
15
|
+
return false;
|
|
16
|
+
if (r.status === 'passed')
|
|
17
|
+
return exitCode === 0 && r.complete === true && r.counterexample === null
|
|
18
|
+
&& r.actions === null && r.violatedInvariants.length === 0 && !r.deadlock;
|
|
19
|
+
if (r.status !== 'failed' || exitCode !== 1 || r.complete !== false || !Array.isArray(r.counterexample) || !Array.isArray(r.actions))
|
|
20
|
+
return false;
|
|
21
|
+
const states = r.counterexample, actions = r.actions;
|
|
22
|
+
if (!states.length || !model.initial.includes(states[0]) || actions.length !== states.length - 1
|
|
23
|
+
|| states.some(s => typeof s !== 'string' || !model.states.includes(s)))
|
|
24
|
+
return false;
|
|
25
|
+
if (actions.some((action, i) => !model.transitions.some(t => t.from === states[i] && t.to === states[i + 1] && t.action === action)))
|
|
26
|
+
return false;
|
|
27
|
+
const last = states.at(-1);
|
|
28
|
+
const violations = model.invariants.filter(p => !p.allowedStates.includes(last)).map(p => p.name);
|
|
29
|
+
const deadlock = model.checkDeadlocks && !model.transitions.some(t => t.from === last);
|
|
30
|
+
return (violations.length > 0 || deadlock) && r.deadlock === deadlock
|
|
31
|
+
&& JSON.stringify(r.violatedInvariants) === JSON.stringify(violations);
|
|
32
|
+
}
|
|
33
|
+
catch {
|
|
34
|
+
return false;
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
export function staterightTool(settings) {
|
|
38
|
+
return {
|
|
39
|
+
name: 'verify_stateright',
|
|
40
|
+
description: 'Verify an explicit finite-state JSON model with Stateright. Input: schemaVersion:1, states:string[], initial:string[], transitions:{from,to,action}[], invariants:{name,allowedStates:string[]}[], checkDeadlocks:boolean. Report explored states and counterexample. No TLA+ parsing, temporal/fairness or implementation-equivalence claim.',
|
|
41
|
+
parameters: { type: 'object', properties: { path: { type: 'string', description: 'Workspace-relative model.json containing the states, transitions and invariants.' } }, required: ['path'], additionalProperties: false },
|
|
42
|
+
async execute(args, ctx) {
|
|
43
|
+
if (args.config !== undefined)
|
|
44
|
+
throw new ToolError('INVALID_ARGS', 'Stateright accepts one JSON model; migrate TLA/config inputs');
|
|
45
|
+
const source = snapshot(ctx.root, args.path, '.json');
|
|
46
|
+
const runtime = findStateright(settings.stateright);
|
|
47
|
+
if (!runtime)
|
|
48
|
+
throw new ToolError('NOT_EXECUTED', 'Stateright未導入。modkh stateright install で導入してください');
|
|
49
|
+
if (!await ctx.approval.approve({ kind: 'command', title: '前鬼: Stateright検証', detail: `${runtime}\n${source.relativePath}\nSHA-256: ${source.digest}`, signal: ctx.signal }))
|
|
50
|
+
throw new ToolError('DENIED', 'Verification not approved');
|
|
51
|
+
if (ctx.signal?.aborted)
|
|
52
|
+
throw new ToolError('NOT_EXECUTED', 'Verification aborted before launch');
|
|
53
|
+
const dir = temporaryDirectory('modkh-stateright-');
|
|
54
|
+
let settled = true;
|
|
55
|
+
try {
|
|
56
|
+
fs.writeFileSync(path.join(dir, 'model.json'), source.bytes, { flag: 'wx', mode: 0o600 });
|
|
57
|
+
const receipt = await executeBounded(runtime, ['--check', 'model.json'], { cwd: dir, env: privateEnvironment(dir), inputDigest: source.digest,
|
|
58
|
+
timeoutMs: Math.min(settings.timeoutMs ?? 30000, 30000), maxOutputBytes: 256 * 1024, signal: ctx.signal });
|
|
59
|
+
settled = receipt.cleanup === 'settled';
|
|
60
|
+
let result;
|
|
61
|
+
try {
|
|
62
|
+
result = JSON.parse(receipt.stdout);
|
|
63
|
+
}
|
|
64
|
+
catch { /* No result is not success. */ }
|
|
65
|
+
const valid = settled && receipt.state === 'exited' && validReport(result, source.digest, source.bytes, receipt.exitCode);
|
|
66
|
+
const status = valid ? result.status : 'unverified';
|
|
67
|
+
return { status: !settled || !['exited', 'not-started'].includes(receipt.state) ? 'unknown' : status === 'passed' ? 'ok' : 'error',
|
|
68
|
+
output: JSON.stringify({ verifier: 'stateright', status, modelPath: source.relativePath, hashes: { source: source.digest },
|
|
69
|
+
...(valid ? { result } : { code: 'STATERIGHT_UNVERIFIED' }), receipt,
|
|
70
|
+
scope: 'Only this explicit finite-state model and its invariants. No temporal/fairness, TLA+ compatibility or implementation-equivalence claim.' }) };
|
|
71
|
+
}
|
|
72
|
+
finally {
|
|
73
|
+
if (settled)
|
|
74
|
+
fs.rmSync(dir, { recursive: true, force: true });
|
|
75
|
+
}
|
|
76
|
+
},
|
|
77
|
+
};
|
|
78
|
+
}
|
package/dist/tools/web.js
CHANGED
|
@@ -211,11 +211,13 @@ export function createFetchUrlTool(options = {}) {
|
|
|
211
211
|
const target = parseTarget(args.url);
|
|
212
212
|
const maxBytes = Math.min(positiveInt(args.maxBytes, 'maxBytes', maxBytesLimit) ?? DEFAULT_MAX_BYTES, MAX_BYTES_LIMIT);
|
|
213
213
|
const timeoutMs = positiveInt(args.timeoutMs, 'timeoutMs', MAX_TIMEOUT_MS) ?? defaultTimeout;
|
|
214
|
-
|
|
214
|
+
let remainingMs = timeoutMs;
|
|
215
215
|
let url = target;
|
|
216
216
|
const hops = [];
|
|
217
217
|
for (let hop = 0;; hop++) {
|
|
218
|
-
await approveFetch(ctx, url, hop === 0 ? '外部URLの取得' : `転送 ${hop} 回目の取得先`, `本文上限 ${maxBytes} バイト /
|
|
218
|
+
await approveFetch(ctx, url, hop === 0 ? '外部URLの取得' : `転送 ${hop} 回目の取得先`, `本文上限 ${maxBytes} バイト / 通信時間の上限 ${timeoutMs}ms(承認待ちを除く)`);
|
|
219
|
+
const started = performance.now();
|
|
220
|
+
const { signal, timedOut } = signalFor(ctx, Math.ceil(remainingMs));
|
|
219
221
|
let response;
|
|
220
222
|
try {
|
|
221
223
|
response = await fetch(url, { method: 'GET', redirect: 'manual', signal, headers: { accept: 'text/html,application/json,text/plain;q=0.9,*/*;q=0.5' } });
|
|
@@ -243,6 +245,9 @@ export function createFetchUrlTool(options = {}) {
|
|
|
243
245
|
if (next.username || next.password)
|
|
244
246
|
throw new ToolError('FETCH_FAILED', '転送先のURLに資格情報が含まれる');
|
|
245
247
|
hops.push(`${response.status} ${url.href} → ${next.href}`);
|
|
248
|
+
remainingMs -= performance.now() - started;
|
|
249
|
+
if (remainingMs <= 0)
|
|
250
|
+
throw new ToolError('TIMEOUT', `通信時間が上限 ${timeoutMs}ms に達した: ${url.href}`);
|
|
246
251
|
url = next;
|
|
247
252
|
continue;
|
|
248
253
|
}
|
package/dist/version.js
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# CL-LSPビルド出力の上限修正(2026-11-16)
|
|
2
|
+
|
|
3
|
+
ユーザーの `last-failure.json` で、`bundled-runtime-install` のstderrが524,288バイトちょうどで途切れていた。従来の実行器は512 KiBを超えるとプロセス群を停止し、後始末を確認できなかった場合は元の停止原因をunknownで上書きしていた。
|
|
4
|
+
|
|
5
|
+
CL-LSPのbundled buildのみ、保持上限を16 MiB(16,777,216バイト)へ拡大し、超過時は末尾を保持して処理を続ける方式に変更。総出力量と省略の有無をreceiptに記録する。通常の検証コマンドは従来どおり超過で停止する。timeout/abortと終了処理の確認は両方式で維持。終了処理がunknownでも、元の停止原因をterminationReasonに保持する。
|
|
6
|
+
|
|
7
|
+
- 17 MiB超のstderrを出す実プロセスがexit0で完了し、末尾16 MiBと完了マーカーを保持する回帰試験に成功。
|
|
8
|
+
- 通常の出力量制限による停止、UTF-8境界、tail方式でもtimeoutすること、stderrが満杯でも最後のstdoutを取得できることを確認。
|
|
9
|
+
- 関連11試験成功。最終sourceの型検査・build・diff check成功。
|
|
10
|
+
- リポジトリ内の検証用snapshotから実CL-LSPを新しいprefix/cacheへ再ビルド。588,347バイトの出力を生成し、exit0・cleanup settled。生成ランチャーの `--help` も成功。LSP初期化・定義応答の検証とは別。
|
|
11
|
+
|
|
12
|
+
ログ:`.dkh-feasibility/build-output/`。実ビルド後に追加したstdout/stderr間の保持枠調整は、最終の実プロセス回帰試験で確認した。グローバルインストールと、以前cleanupがunknownだった試行の削除・プロセス操作は行っていない。
|
|
13
|
+
|
|
14
|
+
旧失敗記録が再試行を止める場合は、更新したグローバル版で `modkh language retry commonlisp` を実行してから導入する。commit・pushはしていない。
|
|
@@ -26,7 +26,7 @@ kiokuko-dshのスキル17件と参照資料を含む43ファイルを、原文
|
|
|
26
26
|
|
|
27
27
|
DSH固有の `kioku_*`、`lisp_*`、Akinator、Goal、lease、`coding_workflow`、`task_completion` はMODKHにはありません。注入時・参照読み取り時にMODKHの適用規則を付け、存在しないAPIの呼び出し・導入・完了待ちを禁止し、実際のMODKHツールと承認に従わせます。Lispワーカーや自動記憶保存そのものを移植したという意味ではありません。
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
本文を途中で切ると制約が落ちるため、予算に入らない本文は丸ごと省略して通知します。一度の選択で本文が完全一致する場合は重複を除きます。通常のCLI会話では、選んだ手順をsystem入力に一度だけ載せ、同じ起動中は本文を固定します。次の依頼で新たに選んだ手順は上限内で追加します。本文はセッション履歴に保存せず、再起動後は選び直します。表示のbytesは注入テキストのUTF-8サイズであり、トークン数ではありません。
|
|
30
30
|
|
|
31
31
|
### プロジェクト固有のスキル
|
|
32
32
|
|
|
@@ -58,9 +58,31 @@ AI SDK経由とChatGPT Responses経由の両方で、モデルに渡す投影だ
|
|
|
58
58
|
|
|
59
59
|
1. 連続して同じ行が現れる出力は、文字列と回数のJSONへ可逆変換します。改行・順序・末尾文字列を保持し、説明を含めてもUTF-8サイズが小さくなるときだけ採用します。対象は1,024〜2,000,000 UTF-16コード単位です。
|
|
60
60
|
2. それでも1件16 KiBの枠を超える場合、原文の先頭と末尾を残し、中間省略を明示します。圧縮JSONを途中で切ることはしません。
|
|
61
|
-
3.
|
|
61
|
+
3. 128 KiBの枠は保存されたツールメッセージごとに割り当てます。後続の結果を追加しても、すでに送信した結果の本文は変わりません。会話全体のサイズは履歴とともに増えます。
|
|
62
62
|
|
|
63
|
-
|
|
63
|
+
実プロバイダーのトークン数・キャッシュ・請求額の削減率は未測定です。文字数の削減率と料金の削減率は異なります。
|
|
64
|
+
|
|
65
|
+
`cache` の表示はプロバイダーが報告した値だけを使います。DeepSeek は `prompt_cache_hit_tokens` を報告するため、キャッシュ読取りは入力に含めた値として表示されます。
|
|
66
|
+
|
|
67
|
+
## プロバイダーのキャッシュを保つ入力の並び
|
|
68
|
+
|
|
69
|
+
DeepSeek などのプロバイダーは、直前のリクエストと先頭から一致する部分をキャッシュとして再利用します。一致は先頭から途切れるまでなので、変わらない内容を前に、ターンごとに変わる内容を後ろに置きます。
|
|
70
|
+
|
|
71
|
+
- system指示(基本方針と選択済みスキル)は起動中に固定し、毎回同じバイト列を送ります。
|
|
72
|
+
- 記憶の検索結果は、そのターンだけの参考データです。system の末尾に足すと、その位置から後ろの履歴全体がキャッシュミスになるため、最新の入力として末尾へ付け、セッション履歴には保存しません。
|
|
73
|
+
- ツール結果の投影は送信済みの本文を書き換えないため、履歴が伸びても既存部分の一致は保たれます。
|
|
74
|
+
|
|
75
|
+
計測例(DeepSeek のリクエスト本文を模した4ターン・各ターン5ステップ、ツール出力を含む約125万文字の送信)では、記憶を system に置くとキャッシュミス相当が23.1%、最新入力に置くと9.6%でした。文字数の比較であり、実プロバイダーの請求額やトークン数の削減率ではありません。
|
|
76
|
+
|
|
77
|
+
## 会話履歴の自動圧縮
|
|
78
|
+
|
|
79
|
+
通常のCLI会話では、直前の会話リクエストでプロバイダーが報告した入力トークン数が、選択中のモデルのコンテキスト長の75%に達すると、次の送信前に古い履歴を要約します。キャッシュ済みの入力も含みます。ツール呼び出し後も同じ条件で判定します。セッション累計、子エージェント、要約リクエストの使用量は加算しません。初回・再開直後・接続変更直後は最初の実測値を待ちます。次に追加する入力のトークン数は送信前には分からないため、大きな追加入力が上限を超えることはあります。
|
|
80
|
+
|
|
81
|
+
ChatGPTではローカルのCodexモデルカタログ、Google・Anthropicではモデル情報API、ローカルOllamaとLM Studioでは稼働中モデルの情報、OpenRouterなどの互換接続では接続先のモデル一覧から容量を取得します。容量を公開していない接続先では、`config.json` に `"modelContextWindows": {"compatible/my-model": 65536}` のようにトークン単位で指定できます。容量または入力トークン数が不明な間は自動圧縮を見送ります。
|
|
82
|
+
|
|
83
|
+
直近の履歴は `compactionKeepTurns`(既定6、1〜50)ターン残します。要約できる本文が送信本文の1/8に満たない場合は見送ります。要約に失敗した場合や短くならなかった場合は、要約対象がさらにその分増えるまで再試行を控えます。従来のバイト基準を明示的に使う場合は `compactionAutoBytes`(32 KiB〜8 MiBをバイト単位で指定)を設定します。この場合の1/8は設定したバイト数が基準です。0で自動圧縮を無効にできます。
|
|
84
|
+
|
|
85
|
+
元のメッセージとツール結果はセッションに残り、`--resume` 後も最後に保存した要約と直近の履歴をモデルへ渡します。固定応答モデル、Hermes Agent、子エージェントでは新たな自動圧縮を行いません。
|
|
64
86
|
|
|
65
87
|
## 参考実装と検証
|
|
66
88
|
|
package/docs/input.md
CHANGED
|
@@ -17,7 +17,23 @@
|
|
|
17
17
|
|
|
18
18
|
Cmd+VはmacOSの端末側が処理するショートカットです。MODKHではテキスト貼り付けを横取りしません。bracketed pasteに対応した端末では、貼り付けた改行を保ち、末尾に改行があっても自動送信しません。複数行の `/exit` などは会話本文として扱い、コマンドを実行しません。
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
操作の承認を求められたら、↑↓で「拒否」か「承認」を選び、Enterで確定します。初期選択は「拒否」です。表示から3分経つと自動で拒否します。行入力モードでは `y` と Enter で承認します。
|
|
21
|
+
|
|
22
|
+
プロバイダー検索と認証キーは1行で入力します。`MODKH_PLAIN=1` や非TTYの行入力モードでは、複数行エディター・クリップボード画像は使わず、従来の1行ずつの入力を維持します。
|
|
23
|
+
|
|
24
|
+
## `@` でローカルファイルを添付する
|
|
25
|
+
|
|
26
|
+
会話入力欄の先頭か空白の直後で `@` を入力すると、作業ルートのファイル・フォルダー候補が表示されます。`@src/` のようにパスを入力して絞り込み、**↑↓** で選び、**Tab** で補完します。フォルダーを補完すると、その中の候補が表示されます。**Esc** で候補を閉じられます。
|
|
27
|
+
|
|
28
|
+
```text
|
|
29
|
+
@src/main.ts と @"docs/画面 仕様.md" を比較して
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
直接入力もできます。空白を含むパスは二重引用符で囲んでください。候補表示とTab補完は対話端末のみですが、行入力モードでも入力したパスは使えます。`\@` と書けばファイル参照として扱われません。
|
|
33
|
+
|
|
34
|
+
Enterで送信したときにファイルの内容を読み込み、依頼文と一緒にモデルへ渡します。対象は作業ルート内のUTF-8テキスト(8件、合計128 KiBまで)です。PDFは `/pdf` を使ってください。ファイルを読み込めなければ送信を止め、対話端末では入力欄に依頼を戻します。
|
|
35
|
+
|
|
36
|
+
添付内容はセッション履歴にも保存されます。機密情報を含むファイルを指定するときは、モデルの送信先と履歴の保存に注意してください。
|
|
21
37
|
|
|
22
38
|
## Macで画像を送る
|
|
23
39
|
|
|
@@ -58,9 +74,53 @@ Cmd+VはmacOSの端末側が処理するショートカットです。MODKHで
|
|
|
58
74
|
|
|
59
75
|
## 処理中の状態と長い検索結果
|
|
60
76
|
|
|
61
|
-
-
|
|
77
|
+
- 対話画面では現在の状態と、その状態に入ってからの経過秒数を表示します。ChatGPT 接続ではサーバーが要求を受理すると表示が切り替わります。推論やツール要求の開始が届くとその状態に切り替わり、ツール名が分かれば実行前から表示します。Ctrl+Cで中止できます。
|
|
78
|
+
- 対話画面では回答が終わると、お祝いのAAが1枚出ます。10種類が一巡するたびに順番が変わります。中断やエラーのときは、その理由を表示します。
|
|
62
79
|
- `search_files` はGit管理下ではGitの除外設定を適用します。Git管理外では `.git`、`node_modules`、`.agenticreplay`、`dist` などの生成・管理ディレクトリを除外します。最大50件・出力16 KiBで、長い行は一致箇所の周辺だけを省略表示します。探索上限や読めなかったファイルも明示します。
|
|
63
|
-
- 長いツール結果はモデル入力に限って1件16 KiB
|
|
80
|
+
- 長いツール結果はモデル入力に限って1件16 KiB、ツールメッセージ1件の本文を合計128 KiBに制限します(省略注記やメッセージ構造は別)。省略は明示し、呼び出しIDと成功・失敗・結果不明の状態は保ちます。セッションの原記録は削除・上書きしません。
|
|
81
|
+
- 長い会話は、直近のターンを残してモデル入力だけを[自動圧縮](context-efficiency.md#会話履歴の自動圧縮)します。圧縮中は Ctrl+C で中止できます。
|
|
64
82
|
- この版以降はエラーの説明も状態イベントに最大2,048文字で残し、再開時に表示します。過去の版で保存されなかったAPIエラーの詳細は復元できません。
|
|
65
83
|
|
|
66
84
|
再開する場合は元の作業ディレクトリで `node dist/index.js chat --resume <セッションID>` を実行し、必要なら `/connect` で再接続します。ビルド更新は、すでに起動中のプロセスや別途インストールしたグローバル版へは自動反映されません。
|
|
85
|
+
|
|
86
|
+
## ツール表示と詳細
|
|
87
|
+
|
|
88
|
+
TUIでは操作名・対象・結果を短く表示します。作成するファイルの本文、長いJSON、読み込んだ手順の全文は通常表示に流しません。
|
|
89
|
+
コマンドの終了コード、失敗・未実行・結果不明、診断の要約は残します。
|
|
90
|
+
`/tools` で直近20件のツール履歴を表示し、`/tools <番号>` でその呼び出しの引数と結果を全文表示できます。
|
|
91
|
+
これは表示だけの整理です。モデルに渡す結果やセッション原記録はこの表示処理で省略しません。行入力モードは従来の出力を保ちます。
|
|
92
|
+
|
|
93
|
+
## browseによるブラウザ検証
|
|
94
|
+
|
|
95
|
+
PATH上に実行可能な `browse` がある場合、コマンドツールの説明にブラウザ操作の経路を追加します。
|
|
96
|
+
コマンド権限のある親・子エージェントに共通して適用し、権限のない担当にはコマンド権限を追加しません。
|
|
97
|
+
`browse --help` と `browse status --json` で使い方・接続状態を確認し、`browse execute` などで操作します。
|
|
98
|
+
プロジェクト内のPlaywrightパッケージがないことと、browse経由でブラウザ操作できないことを区別します。
|
|
99
|
+
実行ファイルの検出だけでは拡張機能の接続を保証せず、インストールやペアリングも自動では行いません。
|
|
100
|
+
|
|
101
|
+
### 使用中の表示
|
|
102
|
+
|
|
103
|
+
`browse` ツールの呼び出しが実行中の間、トークン使用量と言語サーバーの並びに `browse in use` を出します。
|
|
104
|
+
親・子・`/agents run` のどの経路でも同じ表示になります。呼び出しが終わると消えます。
|
|
105
|
+
|
|
106
|
+
- 表示は実行中かどうかだけで、接続状態や操作の成否は表しません。接続確認は `browse status --json` で行います。
|
|
107
|
+
- 端末が右欄を置けない幅・高さでは、入力欄下の状態行の末尾に `· browse in use` を付けます。
|
|
108
|
+
- 行入力モード(`MODKH_PLAIN=1`・非TTY)では、開始と終了を1回ずつ `(browse in use)` と `(browse 終了)` で出します。
|
|
109
|
+
- 表示はツールの権限・承認・記録を変えません。モデルに渡す結果も同じです。
|
|
110
|
+
|
|
111
|
+
## PDFを見ながら実装する
|
|
112
|
+
|
|
113
|
+
画像対応モデルに接続して、会話入力欄で次のように依頼します。行入力モードでも使えます。
|
|
114
|
+
|
|
115
|
+
```text
|
|
116
|
+
/pdf @docs/画面仕様.pdf
|
|
117
|
+
/pdf --pages 5-7 @"docs/画面 仕様.pdf" | この3ページにある入力項目と検証条件を反映して
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
対話端末で `/pdf @` と入力すると、作業ルート内のPDFとフォルダーが候補に出ます。**↑↓** で選び、**Tab** で補完します。空白を含むパスは `@"パス"` と指定します。`@` で指定すると `| 依頼文` を省略でき、省略時はPDFの要約を依頼します。従来の `/pdf パス | 依頼文` も使えます。
|
|
121
|
+
|
|
122
|
+
ページ番号は1から始まり、単独ページは `--pages 5` と指定します。範囲を省くと全ページが対象です。
|
|
123
|
+
|
|
124
|
+
PDFはローカルで変換します。macOSでは `brew install poppler`、Ubuntuでは `sudo apt install poppler-utils` で必要なコマンドを導入できます。選んだ各ページのテキストと、図・写真・配置を含むページ全体のPNGを親モデルに送り、会話履歴にも保存します。スキャンした資料はページ画像をモデルが読み取ります。
|
|
125
|
+
|
|
126
|
+
PDFは32 MiBまで。1回に送れるページ数は貼り付け済みの画像と合わせて4枚までで、超過時はページ範囲を指定し直せます。各ページの画像は長辺1600ピクセル、本文は1ページ32 KiBまでです。
|
package/docs/languages.md
CHANGED
|
@@ -79,12 +79,12 @@ modkh language update # 導入済みサーバーと文法を検証し
|
|
|
79
79
|
|
|
80
80
|
`search_files` は文字列検索として残ります。シンボル調査では次を優先します。
|
|
81
81
|
|
|
82
|
-
- `code_outline`:
|
|
83
|
-
- `code_syntax_search`:
|
|
82
|
+
- `code_outline`: 関数・クラスなどの一覧と宣言全体の範囲
|
|
83
|
+
- `code_syntax_search`: ファイル内の宣言名を部分一致で絞り、同名候補ごとに宣言全体の範囲を返す
|
|
84
84
|
- `code_definition` / `code_references` / `code_hover`: 位置的問い合わせ
|
|
85
85
|
- `code_diagnostics`: 現在の内容を同期して診断を取得
|
|
86
86
|
|
|
87
|
-
|
|
87
|
+
構文ツールの行と桁は1から数え、終了位置は範囲に含めません。編集時は、返された範囲で現行ソースを確認してから変更します。定義や参照の問い合わせには、行末の「名前位置」を言語サーバーのツールに渡せます。
|
|
88
88
|
|
|
89
89
|
## 状態の区別
|
|
90
90
|
|