@holon-run/agentinbox 0.1.4 → 0.3.0

package/dist/src/store.js

@@ -16,6 +16,17 @@ function parseJson(value) {
     }
     return JSON.parse(value);
 }
+function earlierLifecycleRetirement(left, right) {
+    const leftAt = Date.parse(left.retireAt);
+    const rightAt = Date.parse(right.retireAt);
+    if (!Number.isNaN(leftAt) && !Number.isNaN(rightAt) && leftAt <= rightAt) {
+        return {
+            ...left,
+            updatedAt: right.updatedAt,
+        };
+    }
+    return right;
+}
 class AgentInboxStore {
     dbPath;
     db;
@@ -193,6 +204,38 @@ class AgentInboxStore {
         const rows = this.getAll("select * from sources order by created_at asc");
         return rows.map((row) => this.mapSource(row));
     }
+    getSourceIdleState(sourceId) {
+        const row = this.getOne("select * from source_idle_states where source_id = ?", [sourceId]);
+        return row ? this.mapSourceIdleState(row) : null;
+    }
+    listSourceIdleStatesDue(cutoffIso) {
+        const rows = this.getAll("select * from source_idle_states where auto_pause_at <= ? and auto_paused_at is null order by auto_pause_at asc", [cutoffIso]);
+        return rows.map((row) => this.mapSourceIdleState(row));
+    }
+    upsertSourceIdleState(idleState) {
+        this.db.run(`
+      insert into source_idle_states (
+        source_id, idle_since, auto_pause_at, auto_paused_at, updated_at
+      ) values (?, ?, ?, ?, ?)
+      on conflict(source_id) do update set
+        idle_since = excluded.idle_since,
+        auto_pause_at = excluded.auto_pause_at,
+        auto_paused_at = excluded.auto_paused_at,
+        updated_at = excluded.updated_at
+    `, [
+            idleState.sourceId,
+            idleState.idleSince,
+            idleState.autoPauseAt,
+            idleState.autoPausedAt ?? null,
+            idleState.updatedAt,
+        ]);
+        this.persist();
+        return this.getSourceIdleState(idleState.sourceId);
+    }
+    deleteSourceIdleState(sourceId) {
+        this.db.run("delete from source_idle_states where source_id = ?", [sourceId]);
+        this.persist();
+    }
     updateSourceDefinition(sourceId, input) {
         const current = this.getSource(sourceId);
         if (!current) {
@@ -245,6 +288,7 @@ class AgentInboxStore {
                 this.db.run("delete from stream_events where stream_id = ?", [stream.streamId]);
                 this.db.run("delete from streams where stream_id = ?", [stream.streamId]);
             }
+            this.db.run("delete from source_idle_states where source_id = ?", [sourceId]);
             this.db.run("delete from sources where source_id = ?", [sourceId]);
         });
         this.persist();
@@ -319,15 +363,15 @@ class AgentInboxStore {
     insertSubscription(subscription) {
         this.db.run(`
       insert into subscriptions (
-        subscription_id, agent_id, source_id, filter_json, lifecycle_mode, expires_at, start_policy, start_offset, start_time, created_at
+        subscription_id, agent_id, source_id, filter_json, tracked_resource_ref, cleanup_policy_json, start_policy, start_offset, start_time, created_at
       ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     `, [
             subscription.subscriptionId,
             subscription.agentId,
             subscription.sourceId,
             JSON.stringify(subscription.filter),
-            subscription.lifecycleMode,
-            subscription.expiresAt ?? null,
+            subscription.trackedResourceRef ?? null,
+            JSON.stringify(subscription.cleanupPolicy),
             subscription.startPolicy,
             subscription.startOffset ?? null,
             subscription.startTime ?? null,
@@ -352,10 +396,63 @@ class AgentInboxStore {
         if (!subscription) {
             return null;
         }
-        this.db.run("delete from subscriptions where subscription_id = ?", [subscriptionId]);
+        this.inTransaction(() => {
+            this.db.run("delete from consumer_commits where consumer_id in (select consumer_id from consumers where subscription_id = ?)", [subscriptionId]);
+            this.db.run("delete from consumers where subscription_id = ?", [subscriptionId]);
+            this.db.run("delete from subscription_lifecycle_retirements where subscription_id = ?", [subscriptionId]);
+            this.db.run("delete from subscriptions where subscription_id = ?", [subscriptionId]);
+        });
         this.persist();
         return subscription;
     }
+    getSubscriptionLifecycleRetirement(subscriptionId) {
+        const row = this.getOne("select * from subscription_lifecycle_retirements where subscription_id = ?", [subscriptionId]);
+        return row ? this.mapSubscriptionLifecycleRetirement(row) : null;
+    }
+    listSubscriptionLifecycleRetirements() {
+        const rows = this.getAll("select * from subscription_lifecycle_retirements order by retire_at asc, created_at asc");
+        return rows.map((row) => this.mapSubscriptionLifecycleRetirement(row));
+    }
+    listSubscriptionLifecycleRetirementsDue(cutoffIso) {
+        const rows = this.getAll("select * from subscription_lifecycle_retirements where retire_at <= ? order by retire_at asc, created_at asc", [cutoffIso]);
+        return rows.map((row) => this.mapSubscriptionLifecycleRetirement(row));
+    }
+    upsertSubscriptionLifecycleRetirement(retirement) {
+        const existing = this.getSubscriptionLifecycleRetirement(retirement.subscriptionId);
+        const next = existing
+            ? earlierLifecycleRetirement(existing, retirement)
+            : retirement;
+        this.db.run(`
+      insert into subscription_lifecycle_retirements (
+        subscription_id, source_id, tracked_resource_ref, retire_at, terminal_state, terminal_result, terminal_occurred_at, created_at, updated_at
+      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      on conflict(subscription_id) do update set
+        source_id = excluded.source_id,
+        tracked_resource_ref = excluded.tracked_resource_ref,
+        retire_at = excluded.retire_at,
+        terminal_state = excluded.terminal_state,
+        terminal_result = excluded.terminal_result,
+        terminal_occurred_at = excluded.terminal_occurred_at,
+        created_at = excluded.created_at,
+        updated_at = excluded.updated_at
+    `, [
+            next.subscriptionId,
+            next.sourceId,
+            next.trackedResourceRef,
+            next.retireAt,
+            next.terminalState ?? null,
+            next.terminalResult ?? null,
+            next.terminalOccurredAt ?? null,
+            next.createdAt,
+            next.updatedAt,
+        ]);
+        this.persist();
+        return this.getSubscriptionLifecycleRetirement(retirement.subscriptionId);
+    }
+    deleteSubscriptionLifecycleRetirement(subscriptionId) {
+        this.db.run("delete from subscription_lifecycle_retirements where subscription_id = ?", [subscriptionId]);
+        this.persist();
+    }
     getActivationTarget(targetId) {
         const row = this.getOne("select * from activation_targets where target_id = ?", [targetId]);
         return row ? this.mapActivationTarget(row) : null;
@@ -408,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,
@@ -424,6 +521,7 @@ class AgentInboxStore {
                 target.notifyLeaseMs,
                 target.runtimeKind,
                 target.runtimeSessionId ?? null,
+                target.runtimePid ?? null,
                 target.backend,
                 target.tmuxPaneId ?? null,
                 target.tty ?? null,
@@ -440,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,
@@ -507,6 +606,9 @@ class AgentInboxStore {
                 ]);
                 this.db.run("delete from consumers where subscription_id = ?", [subscription.subscriptionId]);
             }
+            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]);
@@ -532,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;
@@ -895,6 +1077,8 @@ class AgentInboxStore {
             agents: this.count("agents"),
             offlineAgents: this.count("agents where status = 'offline'"),
             subscriptions: this.count("subscriptions"),
+            subscriptionLifecycleRetirements: this.count("subscription_lifecycle_retirements"),
+            sourceIdleStates: this.count("source_idle_states"),
             inboxes: this.count("inboxes"),
             activationTargets: this.count("activation_targets"),
             offlineActivationTargets: this.count("activation_targets where status = 'offline'"),
@@ -959,6 +1143,15 @@ class AgentInboxStore {
             updatedAt: String(row.updated_at),
         };
     }
+    mapSourceIdleState(row) {
+        return {
+            sourceId: String(row.source_id),
+            idleSince: String(row.idle_since),
+            autoPauseAt: String(row.auto_pause_at),
+            autoPausedAt: row.auto_paused_at ? String(row.auto_paused_at) : null,
+            updatedAt: String(row.updated_at),
+        };
+    }
     mapAgent(row) {
         return {
             agentId: String(row.agent_id),
@@ -984,14 +1177,27 @@ class AgentInboxStore {
             agentId: String(row.agent_id),
             sourceId: String(row.source_id),
             filter: parseJson(row.filter_json),
-            lifecycleMode: row.lifecycle_mode,
-            expiresAt: row.expires_at ? String(row.expires_at) : null,
+            trackedResourceRef: row.tracked_resource_ref ? String(row.tracked_resource_ref) : null,
+            cleanupPolicy: parseJson(row.cleanup_policy_json),
             startPolicy: row.start_policy,
             startOffset: row.start_offset != null ? Number(row.start_offset) : null,
             startTime: row.start_time ? String(row.start_time) : null,
             createdAt: String(row.created_at),
         };
     }
+    mapSubscriptionLifecycleRetirement(row) {
+        return {
+            subscriptionId: String(row.subscription_id),
+            sourceId: String(row.source_id),
+            trackedResourceRef: String(row.tracked_resource_ref),
+            retireAt: String(row.retire_at),
+            terminalState: row.terminal_state ? String(row.terminal_state) : null,
+            terminalResult: row.terminal_result ? String(row.terminal_result) : null,
+            terminalOccurredAt: row.terminal_occurred_at ? String(row.terminal_occurred_at) : null,
+            createdAt: String(row.created_at),
+            updatedAt: String(row.updated_at),
+        };
+    }
     mapActivationTarget(row) {
         if (String(row.kind) === "webhook") {
             const url = typeof row.url === "string" && row.url.trim().length > 0 ? row.url.trim() : null;
@@ -1028,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,
@@ -1051,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,
@@ -77,7 +79,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") {
@@ -164,15 +167,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 +189,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 +222,7 @@ function detectClaudeCodeFromFileSystem(env) {
         return {
             runtimeKind: "claude_code",
             runtimeSessionId: sessionData.sessionId,
+            runtimePid: claudePid,
         };
     }
     catch {
@@ -222,13 +230,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/0002_subscription_cleanup_policy.sql

@@ -0,0 +1,45 @@
+create table subscriptions__new (
+  subscription_id text primary key,
+  agent_id text not null,
+  source_id text not null,
+  filter_json text not null,
+  tracked_resource_ref text,
+  cleanup_policy_json text not null,
+  start_policy text not null,
+  start_offset integer,
+  start_time text,
+  created_at text not null
+);
+
+insert into subscriptions__new (
+  subscription_id,
+  agent_id,
+  source_id,
+  filter_json,
+  tracked_resource_ref,
+  cleanup_policy_json,
+  start_policy,
+  start_offset,
+  start_time,
+  created_at
+)
+select
+  subscription_id,
+  agent_id,
+  source_id,
+  filter_json,
+  null as tracked_resource_ref,
+  case
+    when expires_at is not null then json_object('mode', 'at', 'at', expires_at)
+    when lifecycle_mode = 'temporary' then json_object('mode', 'manual')
+    else json_object('mode', 'manual')
+  end as cleanup_policy_json,
+  start_policy,
+  start_offset,
+  start_time,
+  created_at
+from subscriptions;
+
+drop table subscriptions;
+
+alter table subscriptions__new rename to subscriptions;

package/drizzle/migrations/0003_subscription_lifecycle_retirements.sql

@@ -0,0 +1,14 @@
+create table if not exists subscription_lifecycle_retirements (
+  subscription_id text primary key,
+  source_id text not null,
+  tracked_resource_ref text not null,
+  retire_at text not null,
+  terminal_state text,
+  terminal_result text,
+  terminal_occurred_at text,
+  created_at text not null,
+  updated_at text not null
+);
+
+create index if not exists idx_subscription_lifecycle_retirements_retire_at
+  on subscription_lifecycle_retirements(retire_at);

package/drizzle/migrations/0004_source_idle_states.sql

@@ -0,0 +1,10 @@
+create table if not exists source_idle_states (
+  source_id text primary key not null,
+  idle_since text not null,
+  auto_pause_at text not null,
+  auto_paused_at text,
+  updated_at text not null
+);
+
+create index if not exists idx_source_idle_states_auto_pause_at
+  on source_idle_states(auto_pause_at);

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

@@ -14,6 +14,36 @@ export const sources = sqliteTable("sources", {
   sourceTypeKey: uniqueIndex("idx_sources_type_key").on(table.sourceType, table.sourceKey),
 }));
 
+export const sourceIdleStates = sqliteTable("source_idle_states", {
+  sourceId: text("source_id").primaryKey(),
+  idleSince: text("idle_since").notNull(),
+  autoPauseAt: text("auto_pause_at").notNull(),
+  autoPausedAt: text("auto_paused_at"),
+  updatedAt: text("updated_at").notNull(),
+}, (table) => ({
+  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(),
@@ -40,14 +70,26 @@ export const subscriptions = sqliteTable("subscriptions", {
   agentId: text("agent_id").notNull(),
   sourceId: text("source_id").notNull(),
   filterJson: text("filter_json").notNull(),
-  lifecycleMode: text("lifecycle_mode").notNull(),
-  expiresAt: text("expires_at"),
+  trackedResourceRef: text("tracked_resource_ref"),
+  cleanupPolicyJson: text("cleanup_policy_json").notNull(),
   startPolicy: text("start_policy").notNull(),
   startOffset: integer("start_offset"),
   startTime: text("start_time"),
   createdAt: text("created_at").notNull(),
 });
 
+export const subscriptionLifecycleRetirements = sqliteTable("subscription_lifecycle_retirements", {
+  subscriptionId: text("subscription_id").primaryKey(),
+  sourceId: text("source_id").notNull(),
+  trackedResourceRef: text("tracked_resource_ref").notNull(),
+  retireAt: text("retire_at").notNull(),
+  terminalState: text("terminal_state"),
+  terminalResult: text("terminal_result"),
+  terminalOccurredAt: text("terminal_occurred_at"),
+  createdAt: text("created_at").notNull(),
+  updatedAt: text("updated_at").notNull(),
+});
+
 export const activationTargets = sqliteTable("activation_targets", {
   targetId: text("target_id").primaryKey(),
   agentId: text("agent_id").notNull(),
@@ -62,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.1.4",
+  "version": "0.3.0",
   "description": "Local event subscription and delivery service for agents.",
   "license": "Apache-2.0",
   "repository": {