@dorokuma/herdsman 0.6.0

package/dist/src/db/agent-events.js.map

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

package/dist/src/db/agent-history-cache.d.ts

@@ -0,0 +1,31 @@
+import type { DatabaseSync } from "node:sqlite";
+import type { AgentHistoryRef, CompactAgentHistory } from "../observability/contracts.js";
+export type AgentHistoryCacheRecord = {
+    compactHistory: CompactAgentHistory;
+    formatterVersion: string;
+    historyRef: AgentHistoryRef;
+    id: number;
+    sourceMtimeMs: number;
+    sourcePath: string;
+    sourceSize: number;
+    updatedAt: Date;
+};
+export declare class AgentHistoryCacheStore {
+    #private;
+    constructor(sqlite: DatabaseSync);
+    getFresh(input: {
+        formatterVersion: string;
+        sourceMtimeMs: number;
+        sourcePath: string;
+        sourceSize: number;
+    }): AgentHistoryCacheRecord | undefined;
+    put(input: {
+        compactHistory: CompactAgentHistory;
+        formatterVersion: string;
+        historyRef: AgentHistoryRef;
+        sourceMtimeMs: number;
+        sourcePath: string;
+        sourceSize: number;
+    }): AgentHistoryCacheRecord;
+}
+//# sourceMappingURL=agent-history-cache.d.ts.map

package/dist/src/db/agent-history-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-history-cache.d.ts","sourceRoot":"","sources":["../../../src/db/agent-history-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEzF,MAAM,MAAM,uBAAuB,GAAG;IACpC,cAAc,EAAE,mBAAmB,CAAC;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,eAAe,CAAC;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAaF,qBAAa,sBAAsB;;gBAGrB,MAAM,EAAE,YAAY;IAIhC,QAAQ,CAAC,KAAK,EAAE;QACd,gBAAgB,EAAE,MAAM,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,uBAAuB,GAAG,SAAS;IAYvC,GAAG,CAAC,KAAK,EAAE;QACT,cAAc,EAAE,mBAAmB,CAAC;QACpC,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,eAAe,CAAC;QAC5B,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,uBAAuB;CA6B5B"}

package/dist/src/db/agent-history-cache.js

@@ -0,0 +1,46 @@
+export class AgentHistoryCacheStore {
+    #sqlite;
+    constructor(sqlite) {
+        this.#sqlite = sqlite;
+    }
+    getFresh(input) {
+        const row = this.#sqlite
+            .prepare(`select * from agent_history_cache
+         where source_path = ? and formatter_version = ? and source_mtime_ms = ? and source_size = ?`)
+            .get(input.sourcePath, input.formatterVersion, input.sourceMtimeMs, input.sourceSize);
+        return row ? mapCache(row) : undefined;
+    }
+    put(input) {
+        const now = Date.now();
+        this.#sqlite
+            .prepare(`insert into agent_history_cache
+         (source_path, formatter_version, history_ref_json, compact_history_json, source_mtime_ms, source_size, updated_at)
+         values (?, ?, ?, ?, ?, ?, ?)
+         on conflict(source_path, formatter_version) do update set
+           history_ref_json = excluded.history_ref_json,
+           compact_history_json = excluded.compact_history_json,
+           source_mtime_ms = excluded.source_mtime_ms,
+           source_size = excluded.source_size,
+           updated_at = excluded.updated_at`)
+            .run(input.sourcePath, input.formatterVersion, JSON.stringify(input.historyRef), JSON.stringify(input.compactHistory), input.sourceMtimeMs, input.sourceSize, now);
+        const row = this.#sqlite
+            .prepare("select * from agent_history_cache where source_path = ? and formatter_version = ?")
+            .get(input.sourcePath, input.formatterVersion);
+        if (!row)
+            throw new Error("Agent history cache write failed");
+        return mapCache(row);
+    }
+}
+function mapCache(row) {
+    return {
+        compactHistory: JSON.parse(row.compact_history_json),
+        formatterVersion: row.formatter_version,
+        historyRef: JSON.parse(row.history_ref_json),
+        id: row.id,
+        sourceMtimeMs: row.source_mtime_ms,
+        sourcePath: row.source_path,
+        sourceSize: row.source_size,
+        updatedAt: new Date(row.updated_at),
+    };
+}
+//# sourceMappingURL=agent-history-cache.js.map

package/dist/src/db/agent-history-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-history-cache.js","sourceRoot":"","sources":["../../../src/db/agent-history-cache.ts"],"names":[],"mappings":"AAyBA,MAAM,OAAO,sBAAsB;IACxB,OAAO,CAAe;IAE/B,YAAY,MAAoB;QAC9B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,QAAQ,CAAC,KAKR;QACC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO;aACrB,OAAO,CACN;qGAC6F,CAC9F;aACA,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,UAAU,CAEzE,CAAC;QACd,OAAO,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzC,CAAC;IAED,GAAG,CAAC,KAOH;QACC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO;aACT,OAAO,CACN;;;;;;;;4CAQoC,CACrC;aACA,GAAG,CACF,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,gBAAgB,EACtB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,EAChC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,cAAc,CAAC,EACpC,KAAK,CAAC,aAAa,EACnB,KAAK,CAAC,UAAU,EAChB,GAAG,CACJ,CAAC;QACJ,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO;aACrB,OAAO,CAAC,mFAAmF,CAAC;aAC5F,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,gBAAgB,CAAqC,CAAC;QACrF,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAC9D,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,GAAyB;IACzC,OAAO;QACL,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAwB;QAC3E,gBAAgB,EAAE,GAAG,CAAC,iBAAiB;QACvC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAoB;QAC/D,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,aAAa,EAAE,GAAG,CAAC,eAAe;QAClC,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;KACpC,CAAC;AACJ,CAAC"}

package/dist/src/db/agent-orchestrator-scopes.d.ts

@@ -0,0 +1,40 @@
+import type { DatabaseSync } from "node:sqlite";
+import type { AgentOrchestratorState, AgentScope } from "../observability/contracts.js";
+export type AgentOrchestratorScopeKey = AgentScope;
+export type ClaimOrchestratorInput = AgentOrchestratorScopeKey & {
+    ackedEventId: number;
+    paneId: string;
+    terminalId: string;
+};
+type ScopeChange = {
+    current: AgentOrchestratorState;
+    previous: AgentOrchestratorState;
+};
+export declare class AgentOrchestratorScopeStore {
+    #private;
+    constructor(sqlite: DatabaseSync);
+    get(scope: AgentOrchestratorScopeKey): AgentOrchestratorState | undefined;
+    listOwned(): AgentOrchestratorState[];
+    listOwnedForSession(herdrSessionName: string): AgentOrchestratorState[];
+    claim(input: ClaimOrchestratorInput): ScopeChange;
+    releaseIfOwner(input: AgentOrchestratorScopeKey & {
+        terminalId: string;
+    }): {
+        changed: boolean;
+        current: AgentOrchestratorState | undefined;
+        previous: AgentOrchestratorState | undefined;
+    };
+    moveOwner(input: {
+        from: AgentOrchestratorScopeKey;
+        paneId: string;
+        targetAckedEventId: number;
+        terminalId: string;
+        to: AgentOrchestratorScopeKey;
+    }): ScopeChange[];
+    ack(input: AgentOrchestratorScopeKey & {
+        eventId: number;
+        terminalId: string;
+    }): AgentOrchestratorState;
+}
+export {};
+//# sourceMappingURL=agent-orchestrator-scopes.d.ts.map

package/dist/src/db/agent-orchestrator-scopes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-orchestrator-scopes.d.ts","sourceRoot":"","sources":["../../../src/db/agent-orchestrator-scopes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAEvF,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC;AAEnD,MAAM,MAAM,sBAAsB,GAAG,yBAAyB,GAAG;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAYF,KAAK,WAAW,GAAG;IACjB,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,sBAAsB,CAAC;CAClC,CAAC;AAEF,qBAAa,2BAA2B;;gBAG1B,MAAM,EAAE,YAAY;IAIhC,GAAG,CAAC,KAAK,EAAE,yBAAyB,GAAG,sBAAsB,GAAG,SAAS;IAKzE,SAAS,IAAI,sBAAsB,EAAE;IAWrC,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAUvE,KAAK,CAAC,KAAK,EAAE,sBAAsB,GAAG,WAAW;IAIjD,cAAc,CAAC,KAAK,EAAE,yBAAyB,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG;QACzE,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,sBAAsB,GAAG,SAAS,CAAC;QAC5C,QAAQ,EAAE,sBAAsB,GAAG,SAAS,CAAC;KAC9C;IAqBD,SAAS,CAAC,KAAK,EAAE;QACf,IAAI,EAAE,yBAAyB,CAAC;QAChC,MAAM,EAAE,MAAM,CAAC;QACf,kBAAkB,EAAE,MAAM,CAAC;QAC3B,UAAU,EAAE,MAAM,CAAC;QACnB,EAAE,EAAE,yBAAyB,CAAC;KAC/B,GAAG,WAAW,EAAE;IA2BjB,GAAG,CACD,KAAK,EAAE,yBAAyB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GACzE,sBAAsB;CAmF1B"}

package/dist/src/db/agent-orchestrator-scopes.js

@@ -0,0 +1,148 @@
+export class AgentOrchestratorScopeStore {
+    #sqlite;
+    constructor(sqlite) {
+        this.#sqlite = sqlite;
+    }
+    get(scope) {
+        const row = this.#getRow(scope);
+        return row ? mapScope(row) : undefined;
+    }
+    listOwned() {
+        const rows = this.#sqlite
+            .prepare(`select * from agent_orchestrator_scopes
+         where owner_terminal_id is not null
+         order by herdr_session_name, workspace_id`)
+            .all();
+        return rows.map(mapScope);
+    }
+    listOwnedForSession(herdrSessionName) {
+        const rows = this.#sqlite
+            .prepare(`select * from agent_orchestrator_scopes
+         where herdr_session_name = ? and owner_terminal_id is not null`)
+            .all(herdrSessionName);
+        return rows.map(mapScope);
+    }
+    claim(input) {
+        return this.#transaction(() => this.#claim(input));
+    }
+    releaseIfOwner(input) {
+        return this.#transaction(() => {
+            const row = this.#getRow(input);
+            if (!row || row.owner_terminal_id !== input.terminalId) {
+                return { changed: false, current: row ? mapScope(row) : undefined, previous: undefined };
+            }
+            const previous = mapScope(row);
+            const now = Date.now();
+            this.#sqlite
+                .prepare(`update agent_orchestrator_scopes
+           set owner_pane_id = null, owner_terminal_id = null, updated_at = ?
+           where herdr_session_name = ? and workspace_id = ?`)
+                .run(now, input.herdrSessionName, input.workspaceId);
+            const current = this.get(input);
+            if (!current)
+                throw new Error("Orchestrator scope disappeared during release");
+            return { changed: true, current, previous };
+        });
+    }
+    moveOwner(input) {
+        return this.#transaction(() => {
+            const sourceRow = this.#getRow(input.from);
+            if (!sourceRow || sourceRow.owner_terminal_id !== input.terminalId) {
+                throw new Error("Only the current orchestrator can move ownership");
+            }
+            const sourcePrevious = mapScope(sourceRow);
+            const now = Date.now();
+            this.#sqlite
+                .prepare(`update agent_orchestrator_scopes
+           set owner_pane_id = null, owner_terminal_id = null, updated_at = ?
+           where herdr_session_name = ? and workspace_id = ?`)
+                .run(now, input.from.herdrSessionName, input.from.workspaceId);
+            const sourceCurrent = this.get(input.from);
+            if (!sourceCurrent)
+                throw new Error("Orchestrator source disappeared during move");
+            const target = this.#claim({
+                ...input.to,
+                ackedEventId: input.targetAckedEventId,
+                paneId: input.paneId,
+                terminalId: input.terminalId,
+            });
+            return [{ current: sourceCurrent, previous: sourcePrevious }, target];
+        });
+    }
+    ack(input) {
+        return this.#transaction(() => {
+            const row = this.#getRow(input);
+            if (!row || row.owner_terminal_id !== input.terminalId) {
+                throw new Error("Only the current orchestrator can acknowledge notifications");
+            }
+            const now = Date.now();
+            this.#sqlite
+                .prepare(`update agent_orchestrator_scopes
+           set acked_event_id = max(acked_event_id, ?), updated_at = ?
+           where herdr_session_name = ? and workspace_id = ?`)
+                .run(input.eventId, now, input.herdrSessionName, input.workspaceId);
+            const current = this.get(input);
+            if (!current)
+                throw new Error("Orchestrator scope disappeared during acknowledgement");
+            return current;
+        });
+    }
+    #claim(input) {
+        const row = this.#getRow(input);
+        const now = Date.now();
+        if (!row) {
+            this.#sqlite
+                .prepare(`insert into agent_orchestrator_scopes
+           (herdr_session_name, workspace_id, acked_event_id, owner_pane_id, owner_terminal_id, created_at, updated_at)
+           values (?, ?, ?, ?, ?, ?, ?)`)
+                .run(input.herdrSessionName, input.workspaceId, input.ackedEventId, input.paneId, input.terminalId, now, now);
+            const current = this.get(input);
+            if (!current)
+                throw new Error("Failed to create orchestrator scope");
+            return { current, previous: { ...current, owner: null } };
+        }
+        const previous = mapScope(row);
+        this.#sqlite
+            .prepare(`update agent_orchestrator_scopes
+         set acked_event_id = ?, owner_pane_id = ?, owner_terminal_id = ?, updated_at = ?
+         where herdr_session_name = ? and workspace_id = ?`)
+            .run(input.ackedEventId, input.paneId, input.terminalId, now, input.herdrSessionName, input.workspaceId);
+        const current = this.get(input);
+        if (!current)
+            throw new Error("Orchestrator scope disappeared during claim");
+        return { current, previous };
+    }
+    #getRow(scope) {
+        return this.#sqlite
+            .prepare(`select * from agent_orchestrator_scopes
+         where herdr_session_name = ? and workspace_id = ?`)
+            .get(scope.herdrSessionName, scope.workspaceId);
+    }
+    #transaction(operation) {
+        this.#sqlite.exec("begin immediate");
+        try {
+            const result = operation();
+            this.#sqlite.exec("commit");
+            return result;
+        }
+        catch (error) {
+            this.#sqlite.exec("rollback");
+            throw error;
+        }
+    }
+}
+function mapScope(row) {
+    if ((row.owner_pane_id === null) !== (row.owner_terminal_id === null)) {
+        throw new Error("Corrupt orchestrator scope owner identity");
+    }
+    return {
+        ackedEventId: row.acked_event_id,
+        herdrSessionName: row.herdr_session_name,
+        owner: row.owner_pane_id === null || row.owner_terminal_id === null
+            ? null
+            : { paneId: row.owner_pane_id, terminalId: row.owner_terminal_id },
+        updatedAt: new Date(row.updated_at),
+        workspaceId: row.workspace_id,
+    };
+}
+//# sourceMappingURL=agent-orchestrator-scopes.js.map

package/dist/src/db/agent-orchestrator-scopes.js.map

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

package/dist/src/db/agents.d.ts

@@ -0,0 +1,34 @@
+import type { DatabaseSync } from "node:sqlite";
+import { type AgentIndexRecord, type AgentQueryScope, type AgentSessionRef, type AgentStatus } from "../observability/contracts.js";
+export type HerdrAgentLike = Record<string, unknown>;
+export declare class AgentStore {
+    #private;
+    constructor(sqlite: DatabaseSync);
+    replaceForSession(input: {
+        agents: HerdrAgentLike[];
+        herdrSessionName: string;
+    }): AgentIndexRecord[];
+    setSessionRefByTerminal(input: {
+        agentSession: AgentSessionRef;
+        herdrSessionName: string;
+        terminalId: string;
+    }): AgentIndexRecord | undefined;
+    updateStatus(input: {
+        agentStatus: AgentStatus;
+        herdrSessionName: string;
+        paneId: string;
+    }): AgentIndexRecord | undefined;
+    list(scope?: AgentQueryScope): AgentIndexRecord[];
+    listForHerdrSession(herdrSessionName: string): AgentIndexRecord[];
+    findByPane(input: {
+        herdrSessionName: string;
+        paneId: string;
+    }): AgentIndexRecord | undefined;
+    findByTerminal(input: {
+        herdrSessionName: string;
+        terminalId: string;
+    }): AgentIndexRecord | undefined;
+    get(id: string): AgentIndexRecord;
+    resolveTarget(scope: AgentQueryScope, target: string): AgentIndexRecord;
+}
+//# sourceMappingURL=agents.d.ts.map

package/dist/src/db/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/db/agents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,WAAW,EAEjB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAuBrD,qBAAa,UAAU;;gBAGT,MAAM,EAAE,YAAY;IAIhC,iBAAiB,CAAC,KAAK,EAAE;QACvB,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,GAAG,gBAAgB,EAAE;IAyHtB,uBAAuB,CAAC,KAAK,EAAE;QAC7B,YAAY,EAAE,eAAe,CAAC;QAC9B,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,gBAAgB,GAAG,SAAS;IAkBhC,YAAY,CAAC,KAAK,EAAE;QAClB,WAAW,EAAE,WAAW,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,gBAAgB,GAAG,SAAS;IAUhC,IAAI,CAAC,KAAK,GAAE,eAAoB,GAAG,gBAAgB,EAAE;IA6BrD,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAIjE,UAAU,CAAC,KAAK,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,gBAAgB,GAAG,SAAS;IAO7F,cAAc,CAAC,KAAK,EAAE;QACpB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,gBAAgB,GAAG,SAAS;IAOhC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB;IAQjC,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB;CA2BxE"}

package/dist/src/db/agents.js

@@ -0,0 +1,295 @@
+import { randomUUID } from "node:crypto";
+import { parseAgentStatus, } from "../observability/contracts.js";
+export class AgentStore {
+    #sqlite;
+    constructor(sqlite) {
+        this.#sqlite = sqlite;
+    }
+    replaceForSession(input) {
+        const now = Date.now();
+        const snapshots = input.agents.flatMap((agent) => {
+            const paneId = stringValue(agent.pane_id) ?? stringValue(agent.paneId);
+            const workspaceId = stringValue(agent.workspace_id) ?? stringValue(agent.workspaceId);
+            if (!paneId || !workspaceId)
+                return [];
+            return [
+                {
+                    agent,
+                    paneId,
+                    terminalId: stringValue(agent.terminal_id) ?? stringValue(agent.terminalId),
+                    workspaceId,
+                },
+            ];
+        });
+        return this.#transaction(() => {
+            const existing = this.#sqlite
+                .prepare("select * from agents where herdr_session_name = ?")
+                .all(input.herdrSessionName);
+            const byPane = new Map(existing.map((agent) => [agent.pane_id, agent]));
+            const byTerminal = new Map(existing.flatMap((agent) => agent.terminal_id ? [[agent.terminal_id, agent]] : []));
+            const matched = snapshots.map((snapshot) => {
+                const terminalMatch = snapshot.terminalId ? byTerminal.get(snapshot.terminalId) : undefined;
+                const paneMatch = byPane.get(snapshot.paneId);
+                const incomingGeneration = paneGeneration(snapshot.agent);
+                const canUsePaneFallback = paneMatch && (snapshot.terminalId === null || paneMatch.terminal_id === null);
+                const generationMatches = !incomingGeneration || !paneMatch?.pane_generation || incomingGeneration === paneMatch.pane_generation;
+                return {
+                    existing: terminalMatch ?? (generationMatches && canUsePaneFallback ? paneMatch : undefined),
+                    snapshot,
+                };
+            });
+            const temporaryPaneIds = new Set();
+            for (const { existing: current, snapshot } of matched) {
+                if (current && current.pane_id !== snapshot.paneId)
+                    temporaryPaneIds.add(current.id);
+                const occupant = byPane.get(snapshot.paneId);
+                if (occupant && occupant.id !== current?.id)
+                    temporaryPaneIds.add(occupant.id);
+            }
+            for (const id of temporaryPaneIds) {
+                this.#sqlite
+                    .prepare("update agents set pane_id = ? where id = ?")
+                    .run(`__herdsman_moving__:${id}`, id);
+            }
+            const retainedIds = [];
+            for (const { existing: current, snapshot } of matched) {
+                const id = current?.id ?? `ag_${randomUUID()}`;
+                retainedIds.push(id);
+                const agent = stringValue(snapshot.agent.agent);
+                const name = stringValue(snapshot.agent.name);
+                const sessionHint = current?.agent === agent ? current.agent_session_hint_json : null;
+                const values = [
+                    snapshot.paneId,
+                    snapshot.terminalId,
+                    stringValue(snapshot.agent.tab_id) ?? stringValue(snapshot.agent.tabId),
+                    snapshot.workspaceId,
+                    agent,
+                    name,
+                    parseAgentStatus(snapshot.agent.agent_status),
+                    agentSessionJson(snapshot.agent.agent_session),
+                    sessionHint,
+                    integerValue(snapshot.agent.revision),
+                    paneGeneration(snapshot.agent) ?? current?.pane_generation ?? null,
+                    stringValue(snapshot.agent.cwd),
+                    stringValue(snapshot.agent.foreground_cwd) ?? stringValue(snapshot.agent.foregroundCwd),
+                    snapshot.agent.focused === true ? 1 : 0,
+                    now,
+                ];
+                if (current) {
+                    this.#sqlite
+                        .prepare(`update agents
+               set pane_id = ?, terminal_id = ?, tab_id = ?, workspace_id = ?, agent = ?, name = ?,
+                   agent_status = ?, agent_session_json = ?, agent_session_hint_json = ?, pane_revision = ?, pane_generation = ?,
+                   cwd = ?, foreground_cwd = ?, focused = ?, last_seen_at = ?
+               where id = ?`)
+                        .run(...values, id);
+                }
+                else {
+                    this.#sqlite
+                        .prepare(`insert into agents
+               (id, herdr_session_name, pane_id, terminal_id, tab_id, workspace_id, agent, name, agent_status, agent_session_json, agent_session_hint_json, pane_revision, pane_generation, cwd, foreground_cwd, focused, first_seen_at, last_seen_at)
+               values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+                        .run(id, input.herdrSessionName, ...values, now);
+                }
+            }
+            const removedIds = existing
+                .map((agent) => agent.id)
+                .filter((id) => !retainedIds.includes(id));
+            if (removedIds.length > 0) {
+                const placeholders = removedIds.map(() => "?").join(", ");
+                this.#sqlite
+                    .prepare(`delete from agent_context_snapshots where agent_id in (${placeholders})`)
+                    .run(...removedIds);
+            }
+            if (retainedIds.length === 0) {
+                this.#sqlite
+                    .prepare("delete from agents where herdr_session_name = ?")
+                    .run(input.herdrSessionName);
+            }
+            else {
+                const placeholders = retainedIds.map(() => "?").join(", ");
+                this.#sqlite
+                    .prepare(`delete from agents where herdr_session_name = ? and id not in (${placeholders})`)
+                    .run(input.herdrSessionName, ...retainedIds);
+            }
+            return this.listForHerdrSession(input.herdrSessionName);
+        });
+    }
+    setSessionRefByTerminal(input) {
+        const current = this.findByTerminal(input);
+        if (!current)
+            return undefined;
+        const compatible = current.agent?.toLowerCase() === input.agentSession.agent.toLowerCase();
+        this.#sqlite
+            .prepare(`update agents
+         set agent_session_hint_json = ?
+         where herdr_session_name = ? and terminal_id = ?`)
+            .run(compatible ? JSON.stringify(input.agentSession) : null, input.herdrSessionName, input.terminalId);
+        return this.findByTerminal(input);
+    }
+    updateStatus(input) {
+        const now = Date.now();
+        this.#sqlite
+            .prepare("update agents set agent_status = ?, last_seen_at = ? where herdr_session_name = ? and pane_id = ?")
+            .run(input.agentStatus, now, input.herdrSessionName, input.paneId);
+        return this.findByPane(input);
+    }
+    list(scope = {}) {
+        const clauses = ["sessions.running = 1"];
+        const params = [];
+        if (!scope.all && scope.herdrSessionName) {
+            clauses.push("agents.herdr_session_name = ?");
+            params.push(scope.herdrSessionName);
+        }
+        if (!scope.all && scope.workspaceId) {
+            clauses.push("agents.workspace_id = ?");
+            params.push(scope.workspaceId);
+        }
+        if (scope.all && scope.herdrSessionName) {
+            clauses.push("agents.herdr_session_name = ?");
+            params.push(scope.herdrSessionName);
+        }
+        const where = ` where ${clauses.join(" and ")}`;
+        const rows = this.#sqlite
+            .prepare(`select agents.*
+         from agents
+         inner join herdr_sessions as sessions
+           on sessions.name = agents.herdr_session_name
+         ${where}
+         order by agents.herdr_session_name, agents.workspace_id, agents.pane_id`)
+            .all(...params);
+        return rows.map(mapAgent);
+    }
+    listForHerdrSession(herdrSessionName) {
+        return this.list({ herdrSessionName });
+    }
+    findByPane(input) {
+        const row = this.#sqlite
+            .prepare("select * from agents where herdr_session_name = ? and pane_id = ?")
+            .get(input.herdrSessionName, input.paneId);
+        return row ? mapAgent(row) : undefined;
+    }
+    findByTerminal(input) {
+        const row = this.#sqlite
+            .prepare("select * from agents where herdr_session_name = ? and terminal_id = ?")
+            .get(input.herdrSessionName, input.terminalId);
+        return row ? mapAgent(row) : undefined;
+    }
+    get(id) {
+        const row = this.#sqlite.prepare("select * from agents where id = ?").get(id);
+        if (!row)
+            throw new Error(`Agent not found: ${id}`);
+        return mapAgent(row);
+    }
+    resolveTarget(scope, target) {
+        const agents = this.list(scope);
+        const candidateGroups = [
+            agents.filter((agent) => agent.paneId === target || agent.terminalId === target || agent.id === target),
+            agents.filter((agent) => agent.name === target),
+            agents.filter((agent) => agent.agent === target),
+        ];
+        for (const candidates of candidateGroups) {
+            if (candidates.length === 1)
+                return candidates[0];
+            if (candidates.length > 1)
+                throw ambiguousTargetError(target, candidates);
+        }
+        throw new Error(`agent target not found: ${target}`);
+    }
+    #transaction(operation) {
+        this.#sqlite.exec("begin immediate");
+        try {
+            const result = operation();
+            this.#sqlite.exec("commit");
+            return result;
+        }
+        catch (error) {
+            this.#sqlite.exec("rollback");
+            throw error;
+        }
+    }
+}
+function mapAgent(row) {
+    const reportedSession = parseAgentSession(row.agent_session_json);
+    const hintedSession = parseAgentSession(row.agent_session_hint_json);
+    const compatibleHint = row.agent?.toLowerCase() === hintedSession?.agent.toLowerCase() ? hintedSession : null;
+    return {
+        agent: row.agent,
+        agentSession: reportedSession ?? compatibleHint,
+        agentStatus: row.agent_status,
+        cwd: row.cwd,
+        firstSeenAt: new Date(row.first_seen_at),
+        focused: row.focused === 1,
+        foregroundCwd: row.foreground_cwd,
+        herdrSessionName: row.herdr_session_name,
+        id: row.id,
+        lastSeenAt: new Date(row.last_seen_at),
+        name: row.name,
+        paneId: row.pane_id,
+        paneRevision: row.pane_revision,
+        ...(row.pane_generation === null ? {} : { paneGeneration: row.pane_generation }),
+        tabId: row.tab_id,
+        terminalId: row.terminal_id,
+        workspaceId: row.workspace_id,
+    };
+}
+function paneGeneration(agent) {
+    return (stringValue(agent.pane_generation) ??
+        stringValue(agent.paneGeneration) ??
+        stringValue(agent.creation_id) ??
+        stringValue(agent.creationId));
+}
+function agentSessionJson(value) {
+    if (typeof value !== "object" || value === null)
+        return null;
+    const record = value;
+    if (typeof record.agent === "string" &&
+        (record.kind === "id" || record.kind === "path") &&
+        typeof record.source === "string" &&
+        typeof record.value === "string") {
+        return JSON.stringify({
+            agent: record.agent,
+            kind: record.kind,
+            source: record.source,
+            value: record.value,
+        });
+    }
+    return null;
+}
+function parseAgentSession(value) {
+    if (!value)
+        return null;
+    try {
+        const parsed = JSON.parse(value);
+        if (typeof parsed !== "object" || parsed === null)
+            return null;
+        const record = parsed;
+        if (typeof record.agent === "string" &&
+            (record.kind === "id" || record.kind === "path") &&
+            typeof record.source === "string" &&
+            typeof record.value === "string") {
+            return {
+                agent: record.agent,
+                kind: record.kind,
+                source: record.source,
+                value: record.value,
+            };
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+function ambiguousTargetError(target, candidates) {
+    return new Error(`agent target ${target} is ambiguous; candidates: ${candidates
+        .map((agent) => `session=${agent.herdrSessionName} workspace=${agent.workspaceId} pane=${agent.paneId} terminal=${agent.terminalId ?? "unknown"} name=${agent.name ?? "unnamed"} agent=${agent.agent ?? "unknown"}`)
+        .join("; ")}`);
+}
+function integerValue(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : null;
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+//# sourceMappingURL=agents.js.map