@ahpd/server 0.4.0 → 0.5.0

package/dist/config.d.ts

@@ -25,6 +25,8 @@ export interface Config {
      * beside this configuration, or `memory` until the process ends.
      */
     sessions?: 'file' | 'memory';
+    /** A file every frame is appended to, both directions, as JSON lines. */
+    wire?: string;
 }
 /**
  * Where this tool's files live.

package/dist/main.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { automationsPath, configPath, loadConfig, sessionsPath } from './config.js';
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { automationsPath, configPath, daemonLog, loadConfig, sessionsPath } from './config.js';
 import { version } from './version.js';
 import { running, start, stop as stopDaemon } from './daemon.js';
 import { pty } from './pty.js';
 import { claude } from '@ahpd/agent-claude';
-import { createHost, fileResources, gitBranches, gitChanges, gitWorktrees, hostTools, listen, fileSessions, memoryAutomations, memorySessions, scheduledAutomations, shellTerminals } from '@ahpd/sdk';
+import { createHost, fileResources, gitBranches, gitChanges, gitWorktrees, githubPullRequests, hostTools, listen, fileSessions, memoryAutomations, memorySessions, scheduledAutomations, shellTerminals } from '@ahpd/sdk';
 const USAGE = `ahpd - an Agent Host Protocol server, with a Claude backend
 
   ahpd [options]              run it here, in this terminal
@@ -35,12 +35,16 @@ const USAGE = `ahpd - an Agent Host Protocol server, with a Claude backend
                                 session's settings go. file, the default,
                                 keeps them beside the configuration; memory
                                 forgets them when this process ends.
+  --wire <file>                 Append every frame, both directions, to this
+                                file as JSON lines: { at, from, peer, frame }.
+                                pnpm wire -- <file> checks it against the
+                                protocol schema.
   --version, -v                 What version this is
   --help, -h                    This
 
 Every option above can be a key in the configuration file instead, spelled the
 way it is here without the dashes: port, host, paths, connectionToken,
-connectionTokenFile, withoutConnectionToken, automations, sessions. A flag beats the file, because a
+connectionTokenFile, withoutConnectionToken, automations, sessions, wire. A flag beats the file, because a
 flag is this run and a file is every run until somebody edits it.
 
 Clients present the token as ?tkn=<secret> on the URL, or as an
@@ -104,6 +108,9 @@ function parse(argv) {
                     stop(`--sessions takes file or memory, not ${said}.`);
                 break;
             }
+            case '--wire':
+                options.wire = String(argv[++i]);
+                break;
             case '--help':
             case '-h':
                 options.help = true;
@@ -147,6 +154,8 @@ function parse(argv) {
     if (!argv.includes('--sessions') && (file.sessions === 'file' || file.sessions === 'memory')) {
         options.sessions = file.sessions;
     }
+    if (!argv.includes('--wire') && typeof file.wire === 'string')
+        options.wire = file.wire;
     if (options.paths.length === 0)
         options.paths.push(process.cwd());
     return options;
@@ -298,6 +307,7 @@ const host = createHost({
     directories: gitBranches(),
     changes: gitChanges(),
     worktrees: gitWorktrees(),
+    github: githubPullRequests(),
     /*
      * The host's own tools, offered to every session's model.
      *
@@ -357,18 +367,52 @@ const host = createHost({
      * `onEvent` hands it the message to do that with.
      */
     onEvent: (message) => process.stdout.write(`${new Date().toISOString()} ${message}\n`),
+    /*
+     * What the window's diagnostics get from this daemon.
+     *
+     * The version out of the manifest, the log a detached daemon writes to and
+     * the wire capture when there is one, and a shutdown that is the same
+     * signal handler `ahpd stop` reaches through `SIGTERM`.
+     */
+    diagnostics: {
+        version: version(),
+        logs: () => [daemonLog(), ...(options.wire === undefined ? [] : [options.wire])],
+        shutdown: () => { process.kill(process.pid, 'SIGTERM'); },
+    },
 });
 // Whichever runtime this is. `listen` is the only file that knows, and it
 // says which one it found - a daemon that silently ran somewhere unexpected
 // would be a daemon nobody could tell apart from the one they meant to start.
-const listener = await listen({ port: options.port, host: options.host, ...(token !== undefined ? { token } : {}) }, (peer) => host.accept(peer));
+/*
+ * The wire, written down as it happens.
+ *
+ * One line per frame, appended synchronously so the file is whole at the
+ * moment anything else is read: a capture that lags the crash it is meant to
+ * explain is no capture. `frame` is the message parsed, so `jq` reads the
+ * file; a frame that is not JSON is kept as the string it was, because a
+ * client that sent one is exactly what a capture is for.
+ */
+const tap = options.wire === undefined ? undefined : (() => {
+    const at = options.wire;
+    writeFileSync(at, '');
+    return (from, text, peer) => {
+        let frame = text;
+        try {
+            frame = JSON.parse(text);
+        }
+        catch { /* kept as text */ }
+        appendFileSync(at, `${JSON.stringify({ at: new Date().toISOString(), from, peer, frame })}\n`);
+    };
+})();
+const listener = await listen({ port: options.port, host: options.host, ...(token !== undefined ? { token } : {}), ...(tap ? { tap } : {}) }, (peer) => host.accept(peer));
 process.stdout.write(`ahpd on ws://${listener.host}:${listener.port} (${listener.runtime}), sessions in ${options.paths.join(', ')}\n`
     // Its own line rather than the end of the one above, which `daemon.ts`
     // reads the session directories off with a regular expression.
     + `automations ${memory ? 'in memory, schedules do not fire' : `in ${automationsPath()}, schedules fire`}\n`
     // Where the secret came from, never the secret: stdout is a log, and a log
     // is the one place a credential should not end up.
-    + `${from}\n`);
+    + `${from}\n`
+    + (options.wire === undefined ? '' : `wire to ${options.wire}\n`));
 const shutdown = () => {
     void Promise.resolve(listener.close()).finally(() => process.exit(0));
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahpd/server",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "type": "module",
   "description": "An Agent Host Protocol server on Node, Bun or Deno. Ships with a Claude backend",
   "keywords": [
@@ -41,8 +41,8 @@
   },
   "dependencies": {
     "@microsoft/agent-host-protocol": "^0.9.0",
-    "@ahpd/agent-claude": "^0.4.0",
-    "@ahpd/sdk": "^0.4.0"
+    "@ahpd/agent-claude": "^0.5.0",
+    "@ahpd/sdk": "^0.5.0"
   },
   "publishConfig": {
     "access": "public"