@jaeboong/a2ab 0.1.0

package/dist/watch.d.ts

@@ -0,0 +1,24 @@
+import type { Broker } from './broker.js';
+export type WatchTick = 'none' | 'popped' | 'lock-lost' | 'offline';
+export interface WatchContext {
+    readonly broker: Broker;
+    readonly sessionId: string;
+    readonly lockPath: string;
+    readonly nonce: string;
+}
+export interface RunWatchOptions {
+    readonly pollMs?: number;
+    readonly maxMs?: number;
+}
+export interface WatchResult {
+    readonly exitCode: number;
+    readonly payload?: string;
+}
+export declare function watchLockPath(rootDir: string, sessionId: string): string;
+export declare function acquireLock(lockPath: string, nonce: string): void;
+export declare function checkOnce(ctx: WatchContext): {
+    tick: WatchTick;
+    payload?: string;
+};
+export declare function runWatch(broker: Broker, sessionId: string, rootDir: string, opts?: RunWatchOptions): Promise<WatchResult>;
+//# sourceMappingURL=watch.d.ts.map

package/dist/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGxE;AAGD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGjE;AAWD,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAgBlF;AAMD,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,WAAW,CAAC,CAqBtB"}

package/dist/watch.js

@@ -0,0 +1,68 @@
+// 인박스 감시자 — idle 세션 깨우기.
+// Stop/SessionStart hook에서 asyncRewake로 실행되어 백그라운드에서 인박스를 감시한다.
+// request가 도착하면 pop 후 exit 2 → Claude Code가 모델을 깨워 페이로드를 주입한다.
+// notification은 깨우지 않는다 (프로토콜 2.1: push 불가).
+import { randomUUID } from 'node:crypto';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { buildRequestInjection } from './hooks.js';
+export function watchLockPath(rootDir, sessionId) {
+    const safe = sessionId.replace(/[^A-Za-z0-9._-]/g, '_');
+    return join(rootDir, 'watch', `${safe}.lock`);
+}
+// 세션당 watcher는 하나만: 최신 watcher가 lock을 덮어쓰면 이전 것은 스스로 물러난다.
+export function acquireLock(lockPath, nonce) {
+    mkdirSync(dirname(lockPath), { recursive: true });
+    writeFileSync(lockPath, JSON.stringify({ nonce, pid: process.pid }), 'utf8');
+}
+function ownsLock(lockPath, nonce) {
+    try {
+        const lock = JSON.parse(readFileSync(lockPath, 'utf8'));
+        return lock.nonce === nonce;
+    }
+    catch {
+        return false;
+    }
+}
+export function checkOnce(ctx) {
+    if (!ownsLock(ctx.lockPath, ctx.nonce)) {
+        return { tick: 'lock-lost' };
+    }
+    const session = ctx.broker.getSession(ctx.sessionId);
+    if (session === undefined || session.status === 'offline') {
+        return { tick: 'offline' };
+    }
+    const requests = ctx.broker.popRequests(ctx.sessionId);
+    if (requests.length > 0) {
+        return {
+            tick: 'popped',
+            payload: buildRequestInjection(ctx.sessionId, requests, ctx.broker),
+        };
+    }
+    return { tick: 'none' };
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function runWatch(broker, sessionId, rootDir, opts = {}) {
+    const pollMs = opts.pollMs ?? 1500;
+    // hook timeout(14400s)보다 약간 짧게 스스로 종료한다.
+    const maxMs = opts.maxMs ?? 14_100_000;
+    const lockPath = watchLockPath(rootDir, sessionId);
+    const nonce = randomUUID();
+    acquireLock(lockPath, nonce);
+    const ctx = { broker, sessionId, lockPath, nonce };
+    const deadline = Date.now() + maxMs;
+    while (Date.now() < deadline) {
+        const result = checkOnce(ctx);
+        if (result.tick === 'popped') {
+            return { exitCode: 2, ...(result.payload === undefined ? {} : { payload: result.payload }) };
+        }
+        if (result.tick === 'lock-lost' || result.tick === 'offline') {
+            return { exitCode: 0 };
+        }
+        await sleep(pollMs);
+    }
+    return { exitCode: 0 };
+}
+//# sourceMappingURL=watch.js.map

package/dist/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@jaeboong/a2ab",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "A2A terminal-agent broker: session registry, inbox, turn-boundary delivery",
+  "type": "module",
+  "license": "MIT",
+  "author": "Jaeboong",
+  "homepage": "https://github.com/Jaeboong/CLAUDE-CODE-A2A#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Jaeboong/CLAUDE-CODE-A2A.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Jaeboong/CLAUDE-CODE-A2A/issues"
+  },
+  "keywords": [
+    "a2a",
+    "agent",
+    "claude-code",
+    "cli",
+    "broker",
+    "multi-agent"
+  ],
+  "bin": {
+    "a2ab": "bin/a2ab.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.11"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "node --import tsx --test test/*.test.ts",
+    "typecheck": "tsc --noEmit",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run typecheck && npm test"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  }
+}