@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 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.21** pins AKK **0.16.13**, including CLI direct
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.165.0 adaptation and accurate
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.13`, pinned by this connector's package and lockfile. A different
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.13` connector, install
93
- `npm:@scotthuang/agent-knock-knock-pi@0.1.0-poc.21`; exact versions are pinned
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.21
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.21`** pins AKK **`0.16.13`** and its synchronized Skill.
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.21` is an npm prerelease distributed through the `next` dist-tag;
629
- its publication is coordinated with core `0.16.13` and the DSH connector.
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
@@ -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.21";
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.21";
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.21",
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 --test .test-dist/test/*.test.js",
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.13",
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.