@holon-run/agentinbox 0.2.0 → 0.4.0

package/dist/src/store.js

@@ -505,9 +505,9 @@ class AgentInboxStore {
             this.db.run(`
         insert into activation_targets (
           target_id, agent_id, kind, status, offline_since, consecutive_failures, last_delivered_at, last_error, mode, notify_lease_ms,
-          runtime_kind, runtime_session_id, backend, tmux_pane_id, tty, term_program, iterm_session_id,
+          runtime_kind, runtime_session_id, runtime_pid, backend, tmux_pane_id, tty, term_program, iterm_session_id,
           created_at, updated_at, last_seen_at
-        ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
       `, [
                 target.targetId,
                 target.agentId,
@@ -521,6 +521,7 @@ class AgentInboxStore {
                 target.notifyLeaseMs,
                 target.runtimeKind,
                 target.runtimeSessionId ?? null,
+                target.runtimePid ?? null,
                 target.backend,
                 target.tmuxPaneId ?? null,
                 target.tty ?? null,
@@ -537,11 +538,12 @@ class AgentInboxStore {
         this.db.run(`
       update activation_targets
       set status = 'active', offline_since = null, last_error = null, consecutive_failures = 0,
-          runtime_kind = ?, runtime_session_id = ?, tmux_pane_id = ?, tty = ?, term_program = ?, iterm_session_id = ?, updated_at = ?, last_seen_at = ?
+          runtime_kind = ?, runtime_session_id = ?, runtime_pid = ?, tmux_pane_id = ?, tty = ?, term_program = ?, iterm_session_id = ?, updated_at = ?, last_seen_at = ?
       where target_id = ? and kind = 'terminal'
     `, [
             input.runtimeKind,
             input.runtimeSessionId ?? null,
+            input.runtimePid ?? null,
             input.tmuxPaneId ?? null,
             input.tty ?? null,
             input.termProgram ?? null,
@@ -606,6 +608,7 @@ class AgentInboxStore {
             }
             this.db.run("delete from subscription_lifecycle_retirements where subscription_id in (select subscription_id from subscriptions where agent_id = ?)", [agentId]);
             this.db.run("delete from source_idle_states where source_id in (select distinct source_id from subscriptions where agent_id = ?)", [agentId]);
+            this.db.run("delete from timers where agent_id = ?", [agentId]);
             this.db.run("delete from subscriptions where agent_id = ?", [agentId]);
             this.db.run("delete from activation_dispatch_states where agent_id = ?", [agentId]);
             this.db.run("delete from activation_targets where agent_id = ?", [agentId]);
@@ -631,6 +634,86 @@ class AgentInboxStore {
         const rows = this.getAll("select * from agents where status = 'offline' and offline_since is not null and offline_since <= ? order by offline_since asc", [cutoffIso]);
         return rows.map((row) => this.mapAgent(row));
     }
+    insertTimer(timer) {
+        this.db.run(`
+      insert into timers (
+        schedule_id, agent_id, status, mode, at, interval_ms, cron_expr, timezone,
+        message, sender, next_fire_at, last_fired_at, created_at, updated_at
+      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `, [
+            timer.scheduleId,
+            timer.agentId,
+            timer.status,
+            timer.mode,
+            timer.at ?? null,
+            timer.intervalMs ?? null,
+            timer.cronExpr ?? null,
+            timer.timezone,
+            timer.message,
+            timer.sender ?? null,
+            timer.nextFireAt ?? null,
+            timer.lastFiredAt ?? null,
+            timer.createdAt,
+            timer.updatedAt,
+        ]);
+        this.persist();
+    }
+    getTimer(scheduleId) {
+        const row = this.getOne("select * from timers where schedule_id = ?", [scheduleId]);
+        return row ? this.mapTimer(row) : null;
+    }
+    listTimers() {
+        const rows = this.getAll("select * from timers order by created_at asc");
+        return rows.map((row) => this.mapTimer(row));
+    }
+    listTimersForAgent(agentId) {
+        const rows = this.getAll("select * from timers where agent_id = ? order by created_at asc", [agentId]);
+        return rows.map((row) => this.mapTimer(row));
+    }
+    listDueTimers(cutoffIso) {
+        const rows = this.getAll("select * from timers where status = 'active' and next_fire_at is not null and next_fire_at <= ? order by next_fire_at asc, schedule_id asc", [cutoffIso]);
+        return rows.map((row) => this.mapTimer(row));
+    }
+    getNearestActiveTimer() {
+        const row = this.getOne("select * from timers where status = 'active' and next_fire_at is not null order by next_fire_at asc, schedule_id asc limit 1");
+        return row ? this.mapTimer(row) : null;
+    }
+    updateTimer(scheduleId, input) {
+        const current = this.getTimer(scheduleId);
+        if (!current) {
+            throw new Error(`unknown timer: ${scheduleId}`);
+        }
+        this.db.run(`
+      update timers
+      set status = ?, mode = ?, at = ?, interval_ms = ?, cron_expr = ?, timezone = ?,
+          message = ?, sender = ?, next_fire_at = ?, last_fired_at = ?, updated_at = ?
+      where schedule_id = ?
+    `, [
+            input.status ?? current.status,
+            input.mode ?? current.mode,
+            input.at !== undefined ? input.at ?? null : current.at ?? null,
+            input.intervalMs !== undefined ? input.intervalMs ?? null : current.intervalMs ?? null,
+            input.cronExpr !== undefined ? input.cronExpr ?? null : current.cronExpr ?? null,
+            input.timezone ?? current.timezone,
+            input.message ?? current.message,
+            input.sender !== undefined ? input.sender ?? null : current.sender ?? null,
+            input.nextFireAt !== undefined ? input.nextFireAt ?? null : current.nextFireAt ?? null,
+            input.lastFiredAt !== undefined ? input.lastFiredAt ?? null : current.lastFiredAt ?? null,
+            input.updatedAt ?? current.updatedAt,
+            scheduleId,
+        ]);
+        this.persist();
+        return this.getTimer(scheduleId);
+    }
+    deleteTimer(scheduleId) {
+        const current = this.getTimer(scheduleId);
+        if (!current) {
+            return null;
+        }
+        this.db.run("delete from timers where schedule_id = ?", [scheduleId]);
+        this.persist();
+        return current;
+    }
     getActivationDispatchState(agentId, targetId) {
         const row = this.getOne("select * from activation_dispatch_states where agent_id = ? and target_id = ?", [agentId, targetId]);
         return row ? this.mapActivationDispatchState(row) : null;
@@ -1151,6 +1234,7 @@ class AgentInboxStore {
             notifyLeaseMs: Number(row.notify_lease_ms),
             runtimeKind: (row.runtime_kind ? String(row.runtime_kind) : "unknown"),
             runtimeSessionId: row.runtime_session_id ? String(row.runtime_session_id) : null,
+            runtimePid: row.runtime_pid == null ? null : Number(row.runtime_pid),
             backend: row.backend,
             tmuxPaneId: row.tmux_pane_id ? String(row.tmux_pane_id) : null,
             tty: row.tty ? String(row.tty) : null,
@@ -1174,6 +1258,24 @@ class AgentInboxStore {
             updatedAt: String(row.updated_at),
         };
     }
+    mapTimer(row) {
+        return {
+            scheduleId: String(row.schedule_id),
+            agentId: String(row.agent_id),
+            status: String(row.status),
+            mode: String(row.mode),
+            at: row.at ? String(row.at) : null,
+            intervalMs: row.interval_ms == null ? null : Number(row.interval_ms),
+            cronExpr: row.cron_expr ? String(row.cron_expr) : null,
+            timezone: String(row.timezone),
+            message: String(row.message),
+            sender: row.sender ? String(row.sender) : null,
+            nextFireAt: row.next_fire_at ? String(row.next_fire_at) : null,
+            lastFiredAt: row.last_fired_at ? String(row.last_fired_at) : null,
+            createdAt: String(row.created_at),
+            updatedAt: String(row.updated_at),
+        };
+    }
     mapInboxItem(row) {
         return {
             itemId: String(row.item_id),

package/dist/src/terminal.js

@@ -24,6 +24,7 @@ function detectTerminalContext(env = process.env) {
         return {
             runtimeKind: runtime.runtimeKind,
             runtimeSessionId: runtime.runtimeSessionId,
+            runtimePid: runtime.runtimePid,
             backend: "tmux",
             tmuxPaneId,
             tty,
@@ -35,6 +36,7 @@ function detectTerminalContext(env = process.env) {
         return {
             runtimeKind: runtime.runtimeKind,
             runtimeSessionId: runtime.runtimeSessionId,
+            runtimePid: runtime.runtimePid,
             backend: "iterm2",
             tty,
             termProgram,
@@ -44,7 +46,9 @@ function detectTerminalContext(env = process.env) {
     throw new Error("unable to detect a supported terminal context");
 }
 function renderAgentPrompt(input) {
-    const base = `AgentInbox: ${input.newItemCount} new items arrived in inbox ${input.inboxId}.`;
+    const totalUnackedCount = input.totalUnackedCount ?? input.newItemCount ?? 0;
+    const itemWord = totalUnackedCount === 1 ? "item" : "items";
+    const base = `AgentInbox: ${totalUnackedCount} unacked ${itemWord} in inbox ${input.inboxId}.`;
     if (input.summary) {
         return `${base} Summary: ${input.summary}. Please read the inbox, process them, and ack when finished.`;
     }
@@ -77,7 +81,8 @@ class TerminalDispatcher {
             if (!target.tmuxPaneId) {
                 throw new Error(`tmux terminal target ${target.targetId} is missing tmuxPaneId`);
             }
-            await this.execAsync("tmux", ["send-keys", "-t", target.tmuxPaneId, prompt, "Enter"]);
+            await this.execAsync("tmux", ["send-keys", "-t", target.tmuxPaneId, "-l", prompt]);
+            await this.execAsync("tmux", ["send-keys", "-t", target.tmuxPaneId, "-l", "\r"]);
             return;
         }
         if (target.backend === "iterm2") {
@@ -87,31 +92,44 @@ class TerminalDispatcher {
         throw new Error(`unsupported terminal backend: ${String(target.backend)}`);
     }
     async probe(target) {
+        return (await this.probeStatus(target)) === "available";
+    }
+    async probeStatus(target) {
         try {
             if (target.backend === "tmux") {
                 if (!target.tmuxPaneId) {
-                    return false;
+                    return "unknown";
                 }
                 const result = await this.execAsync("tmux", ["display-message", "-p", "-t", target.tmuxPaneId, "#{pane_id}"]);
-                return result.stdout.trim() === target.tmuxPaneId;
+                return result.stdout.trim() === target.tmuxPaneId ? "available" : "gone";
             }
             if (target.backend === "iterm2") {
                 const sessionId = normalizeOptionalString(target.itermSessionId);
                 if (!sessionId) {
-                    return false;
+                    return "unknown";
                 }
                 const it2api = resolveIterm2ApiPath(this.options.iterm2ApiPath);
                 const result = await this.execAsync(it2api, ["list-sessions"]);
-                return result.stdout.includes(sessionId);
+                return result.stdout.includes(sessionId) ? "available" : "gone";
             }
         }
-        catch {
-            return false;
+        catch (error) {
+            if (target.backend === "tmux" && isTmuxMissingPaneError(error)) {
+                return "gone";
+            }
+            return "unknown";
         }
-        return false;
+        return "unknown";
     }
 }
 exports.TerminalDispatcher = TerminalDispatcher;
+function isTmuxMissingPaneError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    const candidate = `${error.message} ${"stderr" in error ? String(error.stderr ?? "") : ""}`;
+    return candidate.includes("can't find pane");
+}
 function detectTty(env) {
     const direct = tryReadCurrentTty();
     if (direct) {
@@ -164,15 +182,18 @@ function detectRuntimeContext(env) {
         return {
             runtimeKind: "codex",
             runtimeSessionId: codexThreadId,
+            runtimePid: findNamedProcessInAncestry((name) => name === "codex"),
         };
     }
     const claudeSessionId = normalizeOptionalString(env.CLAUDE_CODE_SESSION_ID
         ?? env.CLAUDECODE_SESSION_ID
         ?? env.CLAUDE_SESSION_ID);
     if (claudeSessionId) {
+        const claudePid = findNamedProcessInAncestry((name) => name.includes("claude"));
         return {
             runtimeKind: "claude_code",
             runtimeSessionId: claudeSessionId,
+            runtimePid: claudePid,
         };
     }
     // Fallback: try to detect Claude Code from filesystem
@@ -183,12 +204,13 @@ function detectRuntimeContext(env) {
     return {
         runtimeKind: "unknown",
         runtimeSessionId: null,
+        runtimePid: null,
     };
 }
 function detectClaudeCodeFromFileSystem(env) {
     try {
         // Walk up the process tree to find a claude process
-        const claudePid = findClaudeProcessInAncestry();
+        const claudePid = findNamedProcessInAncestry((name) => name.includes("claude"));
         if (!claudePid) {
             return null;
         }
@@ -215,6 +237,7 @@ function detectClaudeCodeFromFileSystem(env) {
         return {
             runtimeKind: "claude_code",
             runtimeSessionId: sessionData.sessionId,
+            runtimePid: claudePid,
         };
     }
     catch {
@@ -222,13 +245,13 @@ function detectClaudeCodeFromFileSystem(env) {
         return null;
     }
 }
-function findClaudeProcessInAncestry() {
+function findNamedProcessInAncestry(matcher) {
     let currentPid = process.ppid;
     const maxIterations = 10; // Prevent infinite loops
     let iterations = 0;
     while (currentPid && iterations < maxIterations) {
         const processName = tryGetProcessName(currentPid);
-        if (processName?.includes("claude")) {
+        if (processName && matcher(processName)) {
             return currentPid;
         }
         // Get parent of current process

package/drizzle/migrations/0005_timers.sql

@@ -0,0 +1,22 @@
+create table if not exists timers (
+  schedule_id text primary key not null,
+  agent_id text not null,
+  status text not null,
+  mode text not null,
+  at text,
+  interval_ms integer,
+  cron_expr text,
+  timezone text not null,
+  message text not null,
+  sender text,
+  next_fire_at text,
+  last_fired_at text,
+  created_at text not null,
+  updated_at text not null
+);
+
+create index if not exists idx_timers_agent_next_fire_at
+  on timers(agent_id, next_fire_at);
+
+create index if not exists idx_timers_next_fire_at
+  on timers(next_fire_at);

package/drizzle/migrations/0006_terminal_runtime_pid.sql

@@ -0,0 +1 @@
+alter table activation_targets add column runtime_pid integer;

package/drizzle/schema.ts

@@ -24,6 +24,26 @@ export const sourceIdleStates = sqliteTable("source_idle_states", {
   autoPauseAtIdx: index("idx_source_idle_states_auto_pause_at").on(table.autoPauseAt),
 }));
 
+export const timers = sqliteTable("timers", {
+  scheduleId: text("schedule_id").primaryKey(),
+  agentId: text("agent_id").notNull(),
+  status: text("status").notNull(),
+  mode: text("mode").notNull(),
+  at: text("at"),
+  intervalMs: integer("interval_ms"),
+  cronExpr: text("cron_expr"),
+  timezone: text("timezone").notNull(),
+  message: text("message").notNull(),
+  sender: text("sender"),
+  nextFireAt: text("next_fire_at"),
+  lastFiredAt: text("last_fired_at"),
+  createdAt: text("created_at").notNull(),
+  updatedAt: text("updated_at").notNull(),
+}, (table) => ({
+  agentNextFireIdx: index("idx_timers_agent_next_fire_at").on(table.agentId, table.nextFireAt),
+  nextFireIdx: index("idx_timers_next_fire_at").on(table.nextFireAt),
+}));
+
 export const agents = sqliteTable("agents", {
   agentId: text("agent_id").primaryKey(),
   status: text("status").notNull(),
@@ -84,6 +104,7 @@ export const activationTargets = sqliteTable("activation_targets", {
   url: text("url"),
   runtimeKind: text("runtime_kind"),
   runtimeSessionId: text("runtime_session_id"),
+  runtimePid: integer("runtime_pid"),
   backend: text("backend"),
   tmuxPaneId: text("tmux_pane_id"),
   tty: text("tty"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holon-run/agentinbox",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Local event subscription and delivery service for agents.",
   "license": "Apache-2.0",
   "repository": {