@ahpd/server 0.2.0 → 0.3.0

package/README.md

@@ -52,6 +52,7 @@ ahpd config                 print the config file path and its contents
 | `--connection-token-file <p>` | Require the secret in this file. Writes a new one if the file is missing |
 | `--without-connection-token` | Accept any connection |
 | `--config-file <p>` | Use this config file instead of the default |
+| `--automations <where>` | `file`, the default, keeps them beside the config and fires their schedules. `memory` keeps them until the process ends and fires nothing |
 | `--help`, `-h` | |
 
 Every flag also has a key in `config.json` under `$XDG_CONFIG_HOME/ahpd`, spelled the same way without the dashes. A flag beats the file. Run `ahpd config` to see the path and the current values.

package/dist/config.d.ts

@@ -13,6 +13,13 @@ export interface Config {
     connectionTokenFile?: string;
     /** Accept any connection, with no secret at all. */
     withoutConnectionToken?: boolean;
+    /**
+     * Where automations are kept: `file` beside this configuration, or `memory`.
+     *
+     * `file` is the default and is the one with a clock in it. `memory` holds
+     * definitions for the life of the process and fires nothing.
+     */
+    automations?: 'file' | 'memory';
 }
 /**
  * Where this tool's files live.

package/dist/daemon.d.ts

@@ -5,6 +5,11 @@ export interface Running {
     url: string;
     paths: string[];
     startedAt: string;
+    /**
+     * Where automations are kept and whether their schedules fire, in the
+     * daemon's own words. Absent from a record an older daemon wrote.
+     */
+    automations?: string;
 }
 /**
  * The daemon this user has running, if the record names one that still is.

package/dist/daemon.js

@@ -130,6 +130,7 @@ export async function start(argv, self) {
     // rather than for the case, and `0` must never reach the record.
     if (child.pid === undefined)
         throw new Error('it started but has no process id');
+    const automations = /^automations (.+)$/m.exec(announced)?.[1]?.trim();
     const record = {
         pid: child.pid,
         url,
@@ -139,6 +140,7 @@ export async function start(argv, self) {
         paths: (/sessions in (.+)/.exec(announced)?.[1] ?? '')
             .trim().split(',').map((one) => one.trim()).filter((one) => one !== ''),
         startedAt: new Date().toISOString(),
+        ...(automations !== undefined ? { automations } : {}),
     };
     writeFileSync(daemonPath(), `${JSON.stringify(record, null, 2)}\n`, { mode: 0o600 });
     return record;

package/dist/main.js

@@ -4,7 +4,7 @@ import { automationsPath, configPath, loadConfig } from './config.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, scheduledAutomations, shellTerminals } from '@ahpd/sdk';
+import { createHost, fileResources, gitBranches, gitChanges, gitWorktrees, hostTools, listen, memoryAutomations, 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
@@ -26,11 +26,15 @@ const USAGE = `ahpd - an Agent Host Protocol server, with a Claude backend
   --without-connection-token    Accept any connection. Only when the port is
                                 already reachable by nobody else.
   --config-file <p>             Read this instead of the file below.
+  --automations <where>         file, the default, keeps them beside the
+                                configuration and fires their schedules;
+                                memory keeps them until this process ends and
+                                fires nothing.
   --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. A flag beats the file, because a
+connectionTokenFile, withoutConnectionToken, automations. 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
@@ -44,6 +48,7 @@ function parse(argv) {
         port: 9187,
         host: '127.0.0.1',
         paths: [],
+        automations: 'file',
         open: false,
         help: false,
     };
@@ -75,6 +80,14 @@ function parse(argv) {
             case '--config-file':
                 options.configFile = String(argv[++i]);
                 break;
+            case '--automations': {
+                const said = String(argv[++i]);
+                if (said === 'file' || said === 'memory')
+                    options.automations = said;
+                else
+                    stop(`--automations takes file or memory, not ${said}.`);
+                break;
+            }
             case '--help':
             case '-h':
                 options.help = true;
@@ -108,6 +121,9 @@ function parse(argv) {
         options.tokenFile = file.connectionTokenFile;
     if (!options.open && file.withoutConnectionToken === true)
         options.open = true;
+    if (!argv.includes('--automations') && (file.automations === 'file' || file.automations === 'memory')) {
+        options.automations = file.automations;
+    }
     if (options.paths.length === 0)
         options.paths.push(process.cwd());
     return options;
@@ -179,6 +195,8 @@ if (verb !== undefined) {
         try {
             const begun = await start(rest, process.argv[1]);
             process.stdout.write(`ahpd on ${begun.url} (pid ${String(begun.pid)}), sessions in ${begun.paths.join(', ') || process.cwd()}\n`);
+            if (begun.automations !== undefined)
+                process.stdout.write(`automations ${begun.automations}\n`);
             process.exit(0);
         }
         catch (error) {
@@ -200,6 +218,10 @@ if (verb !== undefined) {
         process.stdout.write(`ahpd on ${found.url} (pid ${String(found.pid)}), started ${found.startedAt}\n`);
         if (found.paths.length > 0)
             process.stdout.write(`sessions in ${found.paths.join(', ')}\n`);
+        // Absent from a record written by an older daemon, which is the one case
+        // where saying nothing is better than guessing which store it was given.
+        if (found.automations !== undefined)
+            process.stdout.write(`automations ${found.automations}\n`);
         process.exit(0);
     }
     if (verb === 'config') {
@@ -221,6 +243,15 @@ if (options.help) {
     process.exit(0);
 }
 const { token, from } = secret(options);
+/*
+ * Whether a clock is running, decided once and then said out loud.
+ *
+ * Both stores take a schedule trigger and only one of them ever fires it, and
+ * what tells a client which it got is a `nextRunAt` that is simply absent.
+ * That is too quiet for somebody who has just written a schedule, so the
+ * startup line says it in words and `ahpd status` repeats it.
+ */
+const memory = options.automations === 'memory';
 const host = createHost({
     path: options.paths[0],
     // The daemon serves Claude Code. The host serves whatever it is given -
@@ -249,7 +280,7 @@ const host = createHost({
      */
     tools: hostTools(),
     /*
-     * Automations, with a clock.
+     * Automations, with a clock unless asked otherwise.
      *
      * A daemon is the case the port was written for: it is already running at
      * nine in the morning, which is the only way an automation fires with
@@ -257,15 +288,19 @@ const host = createHost({
      * come back on a restart; the runs do not, because they name sessions that
      * went when the process did.
      *
-     * A host embedded in something that already schedules passes its own store
-     * instead, and one that should fire nothing passes `memoryAutomations()`.
+     * `--automations memory` is the same store without either half: nothing is
+     * written and nothing fires. Both are an `AutomationStore`, so the host is
+     * not told which it was given - a host embedded in something that already
+     * schedules passes a third of its own.
      */
-    automations: scheduledAutomations({
-        // Beside the configuration, which is this daemon's decision to make and
-        // not the store's - see `ScheduledOptions.file`.
-        file: automationsPath(),
-        onProblem: (message) => process.stdout.write(`${message}\n`),
-    }),
+    automations: memory
+        ? memoryAutomations()
+        : scheduledAutomations({
+            // Beside the configuration, which is this daemon's decision to make and
+            // not the store's - see `ScheduledOptions.file`.
+            file: automationsPath(),
+            onProblem: (message) => process.stdout.write(`${message}\n`),
+        }),
     /*
      * When, as well as what.
      *
@@ -287,6 +322,9 @@ const host = createHost({
 // 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));
 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`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahpd/server",
-  "version": "0.2.0",
+  "version": "0.3.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.2.0",
-    "@ahpd/sdk": "^0.2.0"
+    "@ahpd/agent-claude": "^0.3.0",
+    "@ahpd/sdk": "^0.3.0"
   },
   "publishConfig": {
     "access": "public"