aiterm-mcp 0.63.14 → 0.63.15
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/CHANGELOG.md +6 -1
- package/README.ja.md +3 -1
- package/README.md +3 -1
- package/dist/agent-screen-observation.js +12 -3
- package/docs/DESIGN.md +4 -3
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [0.63.15] - 2026-11-07
|
|
11
|
+
|
|
12
|
+
- Accept readiness after consecutive idle observations span the existing five-second stabilization window, with at least two positive frames. Fast reads retain the eleven-sample path; slow reads no longer exhaust the deadline solely while collecting eleven frames. Non-idle and lost settled evidence reset the window; existing deadlines, modal/native checks and settled-turn shortcut remain unchanged. No caller/schema change or RPC-timeout extension.
|
|
13
|
+
|
|
10
14
|
## [0.63.14] - 2026-11-07
|
|
11
15
|
|
|
12
16
|
- Give Codex conversation resume a 50-second default readiness budget so redraw and stable-sample checks have time to complete after partial history rendering. Explicit deadlines, native/conversation checks and ordinary dispatch defaults are preserved. Eligible failed-native recovery uses the same budget; no caller schema or replay behavior changes.
|
|
@@ -3071,7 +3075,8 @@ prototype (preserved under `prototype/python/` as the porting source and referen
|
|
|
3071
3075
|
`ubuntu-latest` for Node 18/20/22, publishing to npm on `v*` tags with
|
|
3072
3076
|
provenance.
|
|
3073
3077
|
|
|
3074
|
-
[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.63.
|
|
3078
|
+
[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.63.15...HEAD
|
|
3079
|
+
[0.63.15]: https://github.com/kitepon/aiterm-mcp/compare/v0.63.14...v0.63.15
|
|
3075
3080
|
[0.63.14]: https://github.com/kitepon/aiterm-mcp/compare/v0.63.13...v0.63.14
|
|
3076
3081
|
[0.63.13]: https://github.com/kitepon/aiterm-mcp/compare/v0.63.12...v0.63.13
|
|
3077
3082
|
[0.63.12]: https://github.com/kitepon/aiterm-mcp/compare/v0.63.11...v0.63.12
|
package/README.ja.md
CHANGED
|
@@ -215,7 +215,7 @@ runtime-error store は canonical dotagents config の `collection.enabled: true
|
|
|
215
215
|
場合だけ収集し、既定OFF、network送信は行いません。tag起点CIのnpm provenance(OIDC Trusted
|
|
216
216
|
Publishing)で公開し、GitHub Release が Official MCP Registry を再登録します。
|
|
217
217
|
|
|
218
|
-
**状態:** 開発継続中 · 現行公開版 **v0.63.
|
|
218
|
+
**状態:** 開発継続中 · 現行公開版 **v0.63.15** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
|
|
219
219
|
|
|
220
220
|
### 更新と巻き戻し
|
|
221
221
|
|
|
@@ -593,6 +593,8 @@ Claude Code初回起動の文字表示テーマ選択では、画面で選択済
|
|
|
593
593
|
入力受付の待ちは30秒。混んだ端末でagentの画面がまだ描かれていない間に切れた時だけ、起動から50秒まで待つ。
|
|
594
594
|
それでも描かれなければ、今までと同じく未送信(`initial_prompt=not_sent`)で返り、sessionは残る。
|
|
595
595
|
Codexの会話復帰は、画面の一部が先に描かれていても、連続安定確認を含めて既定50秒待つ。呼出元が明示した期限を優先する。新規起動と復帰後の通常dispatchの既定値は従来どおり。この予算は準備段階だけに適用し、RPC全体の所要時間を保証しない。
|
|
596
|
+
通常の安定確認は連続11回、または2回以上の連続した入力待ち観測が既定5秒を隔てて成立すれば通る。観測が遅い時も期限を延ばさず、最初と最後の読取完了時刻を使う。最初の読取自身の時間は期間へ含めない。完了済みturnの既存の2回確認は保持する。
|
|
597
|
+
入力待ち予算は`pty_send`全体の上限ではなく、送信順の待ち・復帰・dispatchは別の段階。MCP要求の取消しだけではnative入力の取消しを保証しない。時間切れの送信結果は不明として保持し、本文を再送しない。
|
|
596
598
|
WindowsのCodexもhook確認を認識し、npm shim経由の起動を一つのharnessとして識別する。
|
|
597
599
|
初手の`initial_prompt.status`は`not_requested`/`not_sent`/`submitted_unconfirmed`/`started`を区別する。
|
|
598
600
|
未送信の失敗もsession付きstructuredContentを保持する。
|
package/README.md
CHANGED
|
@@ -227,7 +227,7 @@ collection is off by default and performs no network I/O. It ships via
|
|
|
227
227
|
tag-triggered CI with npm provenance (OIDC Trusted Publishing); the GitHub
|
|
228
228
|
Release re-registers the Official MCP Registry entry.
|
|
229
229
|
|
|
230
|
-
**Status:** actively maintained · current public release **v0.63.
|
|
230
|
+
**Status:** actively maintained · current public release **v0.63.15** · runs on Linux · WSL2 · macOS · native Windows (tmux on POSIX, the tmux-CLI-compatible [psmux](https://github.com/psmux/psmux) on native Windows — no WSL required) · MIT · see the [CHANGELOG](CHANGELOG.md).
|
|
231
231
|
|
|
232
232
|
### Update and rollback
|
|
233
233
|
|
|
@@ -632,6 +632,8 @@ The input-readiness wait is 30 seconds. Only when it expires while the agent has
|
|
|
632
632
|
waits up to 50 seconds from startup. If nothing is drawn by then, it still returns `initial_prompt=not_sent` and keeps the session.
|
|
633
633
|
Codex conversation resume uses a 50-second default readiness budget, including stable samples, even after a partial redraw. Explicit caller timeouts take precedence. Fresh launch and subsequent ordinary dispatch keep their existing defaults; this phase budget does not bound the entire RPC.
|
|
634
634
|
Positive readiness deadlines are checked again after screen and transcript reads; a late ready or busy result cannot authorize input.
|
|
635
|
+
Readiness normally needs eleven consecutive idle observations or at least two consecutive idle observations spanning the same five-second stabilization window. Slow native reads therefore need fewer observations without a longer deadline; the first read's own duration does not count toward that window. Established settled turns keep their existing two-observation shortcut.
|
|
636
|
+
These are readiness-phase budgets, not a maximum for the whole `pty_send` RPC. Lock waiting, resume and dispatch are separate phases. MCP request cancellation does not certify that native input was cancelled; preserve a timed-out send as unknown and do not replay it.
|
|
635
637
|
A prompt-free launch without this option retains `startup.status="not_checked"`. `initial_prompt.status` distinguishes
|
|
636
638
|
`not_requested`, `not_sent`, `submitted_unconfirmed`, and `started`. Failure responses retain structured session information.
|
|
637
639
|
WindowsのCodexもhook確認を認識し、npm shim経由の起動を一つのharnessとして識別する。
|
|
@@ -16,9 +16,9 @@ const LAUNCH_ECHO_TAIL_CHARS = 24;
|
|
|
16
16
|
const LAUNCH_ECHO_MIN_CHARS = 8;
|
|
17
17
|
export const AGENT_TUI_READY_POLL_MS = 500;
|
|
18
18
|
const AGENT_TUI_READY_STABLE_SAMPLES = 11;
|
|
19
|
-
// 上の11
|
|
19
|
+
// 上の11回・5秒の安定期間は、起動途中の一瞬だけの入力欄を採らないための確かめ(ADR 0014)。席のharnessが自分の記録で
|
|
20
20
|
// 「この起動でturnを1つ終えていて、次のturnを始めていない」と示している時は起動の途中ではないので、短い間隔で
|
|
21
|
-
// 続けて確かめるだけで送る(ADR 0097
|
|
21
|
+
// 続けて確かめるだけで送る(ADR 0097)。記録で示せない時は、連続11回または2回以上で5秒の期間を確認する。
|
|
22
22
|
const AGENT_TUI_SETTLED_STABLE_SAMPLES = 2;
|
|
23
23
|
const AGENT_TUI_SETTLED_POLL_MS = 100;
|
|
24
24
|
// submit座礁観測(dispatch後にcomposerへ送信textが残存していないかの有界チェック)
|
|
@@ -123,6 +123,7 @@ export async function waitAgentTuiReadyImpl(kind, sample, sleepFn, opts = {}) {
|
|
|
123
123
|
const firstDrawDeadline = timeoutMs >= AGENT_TUI_READY_TIMEOUT_MS ? start + AGENT_TUI_FIRST_DRAW_TIMEOUT_MS : deadline;
|
|
124
124
|
let samples = 0;
|
|
125
125
|
let readyStreak = 0;
|
|
126
|
+
let readySince = 0;
|
|
126
127
|
let settledStreak = 0;
|
|
127
128
|
let lastScreen = "";
|
|
128
129
|
// Synchronous screen/identity and transcript reads can return after the deadline.
|
|
@@ -135,6 +136,9 @@ export async function waitAgentTuiReadyImpl(kind, sample, sleepFn, opts = {}) {
|
|
|
135
136
|
if (opts.selectSteer?.(lastScreen))
|
|
136
137
|
return { ready: false, samples, lastScreen, ...(inTime() ? { steer: true } : {}) };
|
|
137
138
|
if (isAgentTuiIdleReady(kind, lastScreen)) {
|
|
139
|
+
const observedAt = now();
|
|
140
|
+
if (readyStreak === 0)
|
|
141
|
+
readySince = observedAt;
|
|
138
142
|
readyStreak++;
|
|
139
143
|
if (readyStreak >= stableSamples)
|
|
140
144
|
return { ready: inTime(), samples, lastScreen };
|
|
@@ -144,13 +148,18 @@ export async function waitAgentTuiReadyImpl(kind, sample, sleepFn, opts = {}) {
|
|
|
144
148
|
return { ready: inTime(), samples, lastScreen };
|
|
145
149
|
}
|
|
146
150
|
else if (settledStreak > 0) {
|
|
147
|
-
// 記録の上でturn
|
|
151
|
+
// 記録の上でturnが始まった。短い道の回数と経過時間を通常の安定確認へ持ち越さない。
|
|
148
152
|
settledStreak = 0;
|
|
149
153
|
readyStreak = 1;
|
|
154
|
+
readySince = observedAt;
|
|
150
155
|
}
|
|
156
|
+
// Slow native reads still establish the same stabilization window between positive frames.
|
|
157
|
+
if (readyStreak >= 2 && observedAt - readySince >= (stableSamples - 1) * pollMs)
|
|
158
|
+
return { ready: inTime(), samples, lastScreen };
|
|
151
159
|
}
|
|
152
160
|
else {
|
|
153
161
|
readyStreak = 0;
|
|
162
|
+
readySince = 0;
|
|
154
163
|
settledStreak = 0;
|
|
155
164
|
// The one keep-current key can be accepted before the TUI redraws.
|
|
156
165
|
// Wait for that exact handled modal to disappear; never resend its key.
|
package/docs/DESIGN.md
CHANGED
|
@@ -224,9 +224,10 @@ Cursorのsubmitはadapterがextended keyboard protocolのEnterへ変換し、呼
|
|
|
224
224
|
Grokのbusy判定後にturnが終わる競合では、送信前のhistory byte位置と本文全体のdigestを保存し、新しい実user行の`prompt_index`と送信後eventの`turn_started.turn_number`を照合する。新turnでの受理が確定した時だけ、その開始位置を使ったdispatch receiptと親配送登録へ移す。本文やEnterを再送しない。Grokの差し込みwaiterも同じ照合を使い、古い完了や短い本文prefixを受理証拠にしない。欠測・曖昧・旧控え・控え消失は未確定とし、旧turn待ちへのfallbackをしない。生成する観測processの`--launch`は元世代へ固定する。
|
|
225
225
|
queueの未確認/残留は`aiterm.agent-send-error.v1`(文字列code、outcome_unknown/effect possible、元session/launch)を既isError/prefixへ追加する。Grokの保存済み送信前位置だけを観測に渡し、Cursorの未知な受理へ旧turnのwaiterを渡さない。
|
|
226
226
|
起動直後のClaude sessionへの初回dispatchは、他harnessと同じくTUIの入力受付を確認してから貼付とEnterを送る。
|
|
227
|
-
Codex・Grok・Cursorの席は、新しいturn
|
|
228
|
-
|
|
229
|
-
|
|
227
|
+
Codex・Grok・Cursorの席は、新しいturnを送るたびに入力受付を確かめる。起動の途中の入力欄を採らないよう、通常は500msおきに11回、
|
|
228
|
+
または2回以上の連続した入力待ち観測が既定5秒の安定期間を隔てて成立することを確認する。観測が遅い時は最初と最後の読取完了時刻を使い、
|
|
229
|
+
最初の読取自身の時間は安定期間に含めない。途中non-idleやsettled取消で起点を数え直す。疎な観測の間に起きて戻った描画変化は検出できない。
|
|
230
|
+
席のharnessが自分の記録で「この起動でturnを1つ終えていて、次のturnを始めていない」と示している時は、100msおきに2回で通す(ADR 0097)。
|
|
230
231
|
正の入力待ち期限は画面・履歴の読取が返った後にも照合し、期限後に返ったready/busyで入力やsteerを許可しない。
|
|
231
232
|
入力の生存確認は公開observeと同じnative世代・本人の読取を共用し、不要な200行の活動captureや子配送集計は要求しない。専用45行の入力画面判定は保持し、公開observeは従来どおり活動観測まで行う。
|
|
232
233
|
Codexの入力待ちは、入力欄の行(`›`、古い描画の`>`)がある時だけ読む。起動の見出しの`>_`は入力欄ではない。足元の警告をF2で開いた
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "aiterm-mcp",
|
|
3
|
-
"version": "0.63.
|
|
3
|
+
"version": "0.63.15",
|
|
4
4
|
"mcpName": "io.github.kitepon/aiterm-mcp",
|
|
5
5
|
"description": "Persistent terminal MCP with one harness-based launcher for Claude Code, Codex CLI, Grok CLI, Cursor Agent CLI, and Antigravity CLI, plus durable PTYs for SSH, containers, and REPLs.",
|
|
6
6
|
"keywords": [
|