@scotthuang/agent-knock-knock-pi 0.1.0-poc.21 → 0.1.0-poc.23
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 +9 -9
- package/lib/constants.d.ts +1 -1
- package/lib/constants.js +1 -1
- package/package.json +3 -3
- package/skills/agent-knock-knock/SKILL.md +4 -2
package/README.md
CHANGED
|
@@ -14,9 +14,9 @@ socket.
|
|
|
14
14
|
|
|
15
15
|
This release includes [managed Claude result-delivery fixes](../../docs/managed-task-result-delivery.md): exact-PID observation, verified foreground completion despite returned background shell work, and durable diagnostics/recovery. Accepted Claude terminal tasks keep observing past configured timeout thresholds; foreground completion does not prove a background build succeeded. Pi does not gain a durable idempotent-delivery guarantee merely from this core update.
|
|
16
16
|
|
|
17
|
-
Connector **0.1.0-poc.
|
|
17
|
+
Connector **0.1.0-poc.23** pins AKK **0.16.15**, including CLI direct
|
|
18
18
|
connections, Codex Desktop, Recovery, compact List v5 and verified
|
|
19
|
-
running-process Codex version discovery, with the 0.
|
|
19
|
+
running-process Codex version discovery, with the reviewed 0.169.0 CLI/backend adaptation and accurate
|
|
20
20
|
Claude pane-observation diagnostics. Its generated Skill and registered tools
|
|
21
21
|
are verified against that exact core package at startup. See the [root compatibility
|
|
22
22
|
summary](../../README.md#compatibility) for the coding-agent versions and
|
|
@@ -37,7 +37,7 @@ The current compatibility contract is intentionally exact:
|
|
|
37
37
|
supported older runtime, installed from the official
|
|
38
38
|
`@earendil-works/pi-coding-agent` package.
|
|
39
39
|
- Node.js `22.19.0` or newer.
|
|
40
|
-
- AKK `0.16.
|
|
40
|
+
- AKK `0.16.15`, pinned by this connector's package and lockfile. A different
|
|
41
41
|
version at the repository root is not substituted automatically. Before core
|
|
42
42
|
publication, test its candidate tarball in isolation under the
|
|
43
43
|
[coordinated release policy](../../CONTRIBUTING.md#coordinated-package-releases).
|
|
@@ -89,8 +89,8 @@ pi list
|
|
|
89
89
|
```
|
|
90
90
|
|
|
91
91
|
Using `next` follows compatible Pi connector prereleases. To pin this exact
|
|
92
|
-
core `0.16.
|
|
93
|
-
`npm:@scotthuang/agent-knock-knock-pi@0.1.0-poc.
|
|
92
|
+
core `0.16.15` connector, install
|
|
93
|
+
`npm:@scotthuang/agent-knock-knock-pi@0.1.0-poc.23`; exact versions are pinned
|
|
94
94
|
and are not advanced by Pi's bulk update command.
|
|
95
95
|
|
|
96
96
|
### 4. Start Pi
|
|
@@ -455,7 +455,7 @@ Harness independently; it does not require their package versions to match.
|
|
|
455
455
|
Publishing Pi additionally requires explicit version confirmation:
|
|
456
456
|
|
|
457
457
|
```sh
|
|
458
|
-
npm run release:check -- --publish --confirm-version 0.1.0-poc.
|
|
458
|
+
npm run release:check -- --publish --confirm-version 0.1.0-poc.23
|
|
459
459
|
```
|
|
460
460
|
|
|
461
461
|
Prereleases use npm tag `next`; stable versions use `latest`. Tags and GitHub
|
|
@@ -505,7 +505,7 @@ a presentation change, not evidence that a candidate is disconnected, and it
|
|
|
505
505
|
does not change Send routing or callback ownership. Sole empty conversations
|
|
506
506
|
and exact frontend associations remain visible.
|
|
507
507
|
|
|
508
|
-
Connector **`0.1.0-poc.
|
|
508
|
+
Connector **`0.1.0-poc.23`** pins AKK **`0.16.15`** and its synchronized Skill.
|
|
509
509
|
Its Host tools explicitly opt into compact List **v5**, removing derived usage
|
|
510
510
|
prose and duplicate IDs while preserving exact selectors, readable states,
|
|
511
511
|
dynamic action inputs, current blockers and bounded pagination. An explicit
|
|
@@ -625,8 +625,8 @@ or external-channel delivery run.
|
|
|
625
625
|
|
|
626
626
|
These are POC acceptance results, not a promise of compatibility with every
|
|
627
627
|
future Pi, Codex, Claude Code, tmux, or Herdr release. Version
|
|
628
|
-
`0.1.0-poc.
|
|
629
|
-
its publication is coordinated with core `0.16.
|
|
628
|
+
`0.1.0-poc.23` is an npm prerelease distributed through the `next` dist-tag;
|
|
629
|
+
its publication is coordinated with core `0.16.15` and the DSH connector.
|
|
630
630
|
ClawHub publication remains a separate channel.
|
|
631
631
|
|
|
632
632
|
## Deliberate POC limits
|
package/lib/constants.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
export declare const CONNECTOR_NAME = "agent-knock-knock-pi";
|
|
2
2
|
export declare const CONNECTOR_PACKAGE = "@scotthuang/agent-knock-knock-pi";
|
|
3
|
-
export declare const CONNECTOR_VERSION = "0.1.0-poc.
|
|
3
|
+
export declare const CONNECTOR_VERSION = "0.1.0-poc.23";
|
|
4
4
|
export declare const PI_HOST_ID = "pi-coding-agent";
|
|
5
5
|
export declare const SUPPORTED_PI_VERSION = "1.2.0";
|
|
6
6
|
export declare const SUPPORTED_PI_VERSIONS: readonly string[];
|
package/lib/constants.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
export const CONNECTOR_NAME = "agent-knock-knock-pi";
|
|
2
2
|
export const CONNECTOR_PACKAGE = "@scotthuang/agent-knock-knock-pi";
|
|
3
|
-
export const CONNECTOR_VERSION = "0.1.0-poc.
|
|
3
|
+
export const CONNECTOR_VERSION = "0.1.0-poc.23";
|
|
4
4
|
export const PI_HOST_ID = "pi-coding-agent";
|
|
5
5
|
export const SUPPORTED_PI_VERSION = "1.2.0";
|
|
6
6
|
export const SUPPORTED_PI_VERSIONS = [SUPPORTED_PI_VERSION, "0.84.4"];
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@scotthuang/agent-knock-knock-pi",
|
|
3
|
-
"version": "0.1.0-poc.
|
|
3
|
+
"version": "0.1.0-poc.23",
|
|
4
4
|
"description": "Pi-as-orchestrator connector for Agent Knock Knock",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -58,7 +58,7 @@
|
|
|
58
58
|
"skill:check": "node ../../scripts/sync-connector-skills.js --check --connector pi",
|
|
59
59
|
"build": "npm run clean && npm run skill:sync && tsc -p tsconfig.json",
|
|
60
60
|
"typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit",
|
|
61
|
-
"test:fast": "npm run build && tsc -p tsconfig.test.json && node
|
|
61
|
+
"test:fast": "npm run build && tsc -p tsconfig.test.json && node ../../scripts/run-connector-fast-tests.js",
|
|
62
62
|
"prepublishOnly": "npm run skill:check",
|
|
63
63
|
"prepack": "npm run build && npm run skill:check",
|
|
64
64
|
"pack:check": "npm run build && npm run skill:check && node ../../scripts/verify-connector-skill-pack.js --connector pi",
|
|
@@ -69,7 +69,7 @@
|
|
|
69
69
|
"typebox": "*"
|
|
70
70
|
},
|
|
71
71
|
"dependencies": {
|
|
72
|
-
"@scotthuang/agent-knock-knock": "0.16.
|
|
72
|
+
"@scotthuang/agent-knock-knock": "0.16.15",
|
|
73
73
|
"ajv": "8.20.0"
|
|
74
74
|
},
|
|
75
75
|
"devDependencies": {
|
|
@@ -236,7 +236,7 @@ success; never retry an uncertain repair automatically.
|
|
|
236
236
|
For native status inspection:
|
|
237
237
|
|
|
238
238
|
1. Use only a current `available_actions.native_inspect({terminal_id,inspection:"status"})` entry. Those semantic arguments are complete; never add a command or authority field.
|
|
239
|
-
2. Regression-tested profiles are Codex 0.146.0/0.146.1/0.147.0/0.148.0/0.149.1/0.150.1/0.151.0/0.153.0/0.153.4/0.154.0/0.155.1/0.158.0/0.159.0/0.159.2/0.159.3/0.160.0/0.162.1/0.164.0/0.165.0/0.166.0/0.167.0 and Claude Code 2.1.218/2.1.226/2.1.237/2.1.251/2.1.259/2.1.263/2.1.266/2.1.267/2.1.285 `inspection="status"`. Other complete `x.y.z` versions remain callable through the generic runtime profile and add a compatibility warning; actual incompatible UI or schema evidence fails at runtime and is not automatically retried. Claude success includes parsing and safely dismissing the newly opened Status panel. The inspection tool does not accept `/status` text or any arbitrary command string. `/usage`, `/cost`, `/stats`, `/usage-credits`, raw `/model`, `/compact`, and arbitrary slash commands remain unavailable; model changes use only the typed model-control tools above. Never automate bare Codex `/usage`: it opens an interactive menu whose later Enter can select an account-side usage-limit reset.
|
|
239
|
+
2. Regression-tested profiles are Codex 0.146.0/0.146.1/0.147.0/0.148.0/0.149.1/0.150.1/0.151.0/0.153.0/0.153.4/0.154.0/0.155.1/0.158.0/0.159.0/0.159.2/0.159.3/0.160.0/0.162.1/0.164.0/0.165.0/0.166.0/0.167.0/0.169.0 and Claude Code 2.1.218/2.1.226/2.1.237/2.1.251/2.1.259/2.1.263/2.1.266/2.1.267/2.1.285 `inspection="status"`. Other complete `x.y.z` versions remain callable through the generic runtime profile and add a compatibility warning; actual incompatible UI or schema evidence fails at runtime and is not automatically retried. Claude success includes parsing and safely dismissing the newly opened Status panel. The inspection tool does not accept `/status` text or any arbitrary command string. `/usage`, `/cost`, `/stats`, `/usage-credits`, raw `/model`, `/compact`, and arbitrary slash commands remain unavailable; model changes use only the typed model-control tools above. Never automate bare Codex `/usage`: it opens an interactive menu whose later Enter can select an account-side usage-limit reset.
|
|
240
240
|
3. Treat this as terminal input even though the native command is read-only. AKK privately derives a fresh binding fence and requires an idle empty composer, exact PID/process/pane/cwd/version identity, and no conflicting Turn, transition, dispatch, approval, or owner.
|
|
241
241
|
4. Codex `/status` requires an exact viewport of at least 80 columns so the full Session UUID can be proven. That pre-UUID gate applies to native inspection, lifecycle, and strict Session operations that must know the UUID before terminal input. Legacy terminal-scoped ordinary tasks may send once and bind from exact native acceptance afterward without running `/status` or failing merely because the pane is narrow. Codex paginated read-contract candidates attempt their separate closed `/status` binding before physical Send. If an exact callback Watch cannot be prepared safely, AKK may prepare terminal-activity observation; report the receipt's actual callback mode and limitation.
|
|
242
242
|
5. The result is valid only when AKK proves one fresh bounded native status result and the pane returns to idle. On an uncertain or unproven submission, do not retry, send Enter, clear the composer, or bypass AKK with raw terminal input.
|
|
@@ -352,7 +352,7 @@ Action-name glossary:
|
|
|
352
352
|
|
|
353
353
|
- `status`: inspect one terminal, Turn, or Watch; it sends no native slash command.
|
|
354
354
|
- `send`: deliver a new request, or perform the separately advertised immutable `retry_submission` form.
|
|
355
|
-
- `watch` / `unwatch`: create or stop durable terminal observation; Codex 0.158.0/0.159.0/0.159.2/0.159.3/0.160.0/0.162.1/0.164.0/0.165.0/0.166.0/0.167.0 exact creation performs the closed `/status` transaction, while subsequent observation is read-only.
|
|
355
|
+
- `watch` / `unwatch`: create or stop durable terminal observation; Codex 0.158.0/0.159.0/0.159.2/0.159.3/0.160.0/0.162.1/0.164.0/0.165.0/0.166.0/0.167.0/0.169.0 exact creation performs the closed `/status` transaction, while subsequent observation is read-only.
|
|
356
356
|
- `list_resumable_threads`, `new_thread`, and `resume_thread`: inspect or change native thread context through their closed lifecycle protocols.
|
|
357
357
|
- `native_inspect`: run only an advertised closed native inspection such as `status`.
|
|
358
358
|
- `model_options`, `repair_model_control`, and `set_model`: discover the current native catalog, clear only a proven model-control residue, or consume one catalog offer.
|
|
@@ -390,3 +390,5 @@ Return:
|
|
|
390
390
|
- the actionable failure reason.
|
|
391
391
|
|
|
392
392
|
Codex 0.167.0 adds person-only `humanCommand` approvals. AKK does not claim the native human-approval capability. Such requests and unknown command kinds have no automated approval action; handle them in the original CLI. On 0.167 or newer, a screen-only command dialog cannot prove its native kind: use a verified structured backend approval or the original CLI. Ordinary backend approvals, file-edit approvals and question responses retain their existing contracts.
|
|
393
|
+
|
|
394
|
+
Codex 0.169.0 attached CLI threads are not independent main CLI targets. Native moderation/display-directed messages are excluded from raw CLI public progress, final results and asynchronous questions; do not interpret missing public text as missing task completion. No new Cloud, deferred-output or lifecycle operation is implied.
|