@botbotgo/agent-harness 0.0.231 → 0.0.232

package/dist/api.d.ts

@@ -1,4 +1,4 @@
-import type { ArtifactListing, CancelOptions, InvocationEnvelope, ListMemoriesInput, ListMemoriesResult, MemoryRecord, MemorizeInput, MemorizeResult, MessageContent, RecallInput, RecallResult, RemoveMemoryInput, RequestRecord, RequestSummary, ResumeOptions, RunDecisionOptions, RunListeners, RunResult, RunStartOptions, RuntimeHealthSnapshot, RuntimeGovernanceDiagnostics, RuntimeOperatorOverview, RuntimeQueueDiagnostics, RuntimeAdapterOptions, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult as InternalRuntimeEvaluationReplayResult, RuntimeSessionPackage, RuntimeSessionPackageInput, SessionRecord, SessionSummary, TranscriptMessage, UpdateMemoryInput, WorkspaceLoadOptions } from "./contracts/types.js";
+import type { ArtifactListing, CancelOptions, InvocationEnvelope, ListMemoriesInput, ListMemoriesResult, MemoryRecord, MemorizeInput, MemorizeResult, MessageContent, RecallInput, RecallResult, RemoveMemoryInput, RequestRecord, RequestSummary, ResumeOptions, RunDecisionOptions, RunListeners, RunResult, RunStartOptions, RuntimeHealthSnapshot, RuntimeGovernanceDiagnostics, RuntimeOperatorOverview, RuntimeQueueDiagnostics, RuntimeAdapterOptions, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult as InternalRuntimeEvaluationReplayResult, RuntimeSessionPackage, RuntimeSessionPackageInput, SessionListSummary, SessionRecord, SessionSummary, TranscriptMessage, UpdateMemoryInput, WorkspaceLoadOptions } from "./contracts/types.js";
 import { AgentHarnessRuntime } from "./runtime/harness.js";
 import type { InventoryAgentRecord, InventorySkillRecord } from "./runtime/harness/system/inventory.js";
 import type { RequirementAssessmentOptions } from "./runtime/harness/system/skill-requirements.js";
@@ -9,7 +9,7 @@ export type { AcpApproval, AcpArtifact, AcpEventNotification, AcpJsonRpcError, A
 export { AgentHarnessRuntime } from "./runtime/harness.js";
 export { buildFlowGraph, exportFlowGraphToMermaid, exportFlowGraphToSequenceMermaid } from "./flow/index.js";
 export { createUpstreamTimelineReducer } from "./upstream-events.js";
-export type { ListMemoriesInput, ListMemoriesResult, MemoryDecision, MemoryKind, MemoryRecord, MemoryScope, MemorizeInput, MemorizeResult, RecallInput, RecallResult, RemoveMemoryInput, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, RuntimeSessionPackageInput, RuntimeSessionPackage, UpdateMemoryInput, } from "./contracts/types.js";
+export type { ListMemoriesInput, ListMemoriesResult, MemoryDecision, MemoryKind, MemoryRecord, MemoryScope, MemorizeInput, MemorizeResult, RecallInput, RecallResult, RemoveMemoryInput, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, SessionListSummary, RuntimeSessionPackageInput, RuntimeSessionPackage, UpdateMemoryInput, } from "./contracts/types.js";
 export type { AcpHttpServer, AcpHttpServerOptions } from "./protocol/acp/http.js";
 export type { AcpStdioClient, AcpStdioClientOptions } from "./protocol/acp/client.js";
 export type { A2aAgentCard, A2aHttpServer, A2aHttpServerOptions, A2aTask, A2aTaskState } from "./protocol/a2a/http.js";
@@ -135,6 +135,7 @@ export declare function updateMemory(runtime: AgentHarnessRuntime, input: Update
 export declare function removeMemory(runtime: AgentHarnessRuntime, input: RemoveMemoryInput): Promise<MemoryRecord>;
 export declare function subscribe(runtime: AgentHarnessRuntime, listener: (event: RequestEvent) => void | Promise<void>): () => void;
 export declare function listSessions(runtime: AgentHarnessRuntime, filter?: Parameters<AgentHarnessRuntime["listSessions"]>[0]): Promise<SessionSummary[]>;
+export declare function listSessionSummaries(runtime: AgentHarnessRuntime, filter?: Parameters<AgentHarnessRuntime["listSessionSummaries"]>[0]): Promise<SessionListSummary[]>;
 export declare function listRequests(runtime: AgentHarnessRuntime, filter?: {
     agentId?: string;
     sessionId?: string;

package/dist/api.js

@@ -193,6 +193,9 @@ export function subscribe(runtime, listener) {
 export async function listSessions(runtime, filter) {
     return runtime.listSessions(filter);
 }
+export async function listSessionSummaries(runtime, filter) {
+    return runtime.listSessionSummaries(filter);
+}
 export async function listRequests(runtime, filter) {
     return runtime.listRequests(filter);
 }

package/dist/contracts/runtime.d.ts

@@ -13,6 +13,18 @@ export type SessionSummary = {
     status: RunState;
     currentAgentId?: string;
 };
+/**
+ * Bulk session-history projection for conversation lists and sidebars.
+ * This stays runtime-owned and intentionally lighter than full session inspection.
+ */
+export type SessionListSummary = SessionSummary & {
+    entryAgentId: string;
+    messageCount: number;
+    hasVisibleMessages: boolean;
+    lastMessageRole?: TranscriptMessage["role"];
+    title?: string;
+    snippet?: string;
+};
 /**
  * Backward-compatible alias for older thread/run terminology.
  */
@@ -20,6 +32,10 @@ export type ThreadSummary = Omit<SessionSummary, "sessionId" | "latestRequestId"
     threadId: string;
     latestRunId: string;
 };
+export type ThreadListSummary = Omit<SessionListSummary, "sessionId" | "latestRequestId"> & {
+    threadId: string;
+    latestRunId: string;
+};
 export type KnownHarnessEventType = "run.created" | "run.queued" | "run.dequeued" | "run.state.changed" | "run.resumed" | "approval.requested" | "approval.resolved" | "artifact.created" | "output.delta" | "runtime.health.changed" | "runtime.synthetic_fallback";
 export type HarnessEventType = KnownHarnessEventType | (string & {});
 /**

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { AgentHarnessAcpServer, AgentHarnessRuntime, buildFlowGraph, cancelRun, createAgentHarness, createAcpServer, createAcpStdioClient, createRuntimeMcpServer, createUpstreamTimelineReducer, createToolMcpServer, deleteSession, describeInventory, exportEvaluationBundle, exportRequestPackage, exportSessionPackage, replayEvaluationBundle, getArtifact, getAgent, getApproval, getOperatorOverview, getRequest, getHealth, listMemories, getSession, listAgentSkills, listArtifacts, listApprovals, listRequests, listRequestEvents, listSessions, memorize, normalizeUserChatInput, request, recall, removeMemory, resolveApproval, serveA2aHttp, serveAcpHttp, serveAcpStdio, serveAgUiHttp, serveRuntimeMcpOverStdio, serveToolsOverStdio, subscribe, stop, updateMemory, exportFlowGraphToMermaid, exportFlowGraphToSequenceMermaid, } from "./api.js";
+export { AgentHarnessAcpServer, AgentHarnessRuntime, buildFlowGraph, cancelRun, createAgentHarness, createAcpServer, createAcpStdioClient, createRuntimeMcpServer, createUpstreamTimelineReducer, createToolMcpServer, deleteSession, describeInventory, exportEvaluationBundle, exportRequestPackage, exportSessionPackage, replayEvaluationBundle, getArtifact, getAgent, getApproval, getOperatorOverview, getRequest, getHealth, listMemories, getSession, listAgentSkills, listArtifacts, listApprovals, listRequests, listRequestEvents, listSessionSummaries, listSessions, memorize, normalizeUserChatInput, request, recall, removeMemory, resolveApproval, serveA2aHttp, serveAcpHttp, serveAcpStdio, serveAgUiHttp, serveRuntimeMcpOverStdio, serveToolsOverStdio, subscribe, stop, updateMemory, exportFlowGraphToMermaid, exportFlowGraphToSequenceMermaid, } from "./api.js";
 export type { AcpApproval, AcpArtifact, AcpEventNotification, AcpJsonRpcError, AcpJsonRpcRequest, AcpJsonRpcResponse, AcpJsonRpcSuccess, AcpRequestRecord, AcpRunRequestParams, AcpServerCapabilities, AcpSessionRecord, AcpStdioClient, AcpStdioClientOptions, } from "./acp.js";
-export type { Approval, ListMemoriesInput, ListMemoriesResult, MemoryDecision, MemoryKind, MemoryRecord, MemoryScope, MemorizeInput, MemorizeResult, NormalizeUserChatInputOptions, OperatorOverview, PublicRunListeners, RequestArtifactListing, RequestEvent, RequestEventType, RequestPackage, RequestPackageInput, RequestResult, RequestUpstreamEventItem, RecallInput, RecallResult, RemoveMemoryInput, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult, RuntimeSessionPackage, RuntimeSessionPackageInput, UpdateMemoryInput, UserChatInput, UserChatMessage, } from "./api.js";
+export type { Approval, ListMemoriesInput, ListMemoriesResult, MemoryDecision, MemoryKind, MemoryRecord, MemoryScope, MemorizeInput, MemorizeResult, NormalizeUserChatInputOptions, OperatorOverview, PublicRunListeners, RequestArtifactListing, RequestEvent, RequestEventType, RequestPackage, RequestPackageInput, RequestResult, RequestUpstreamEventItem, RecallInput, RecallResult, RemoveMemoryInput, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult, SessionListSummary, RuntimeSessionPackage, RuntimeSessionPackageInput, UpdateMemoryInput, UserChatInput, UserChatMessage, } from "./api.js";
 export type { BuildFlowGraphInput, FlowEdge, FlowEdgeKind, FlowGraph, FlowGraphMermaidOptions, FlowGraphSequenceMermaidOptions, FlowGroup, FlowGroupKind, FlowNode, FlowNodeKind, FlowNodeLayer, FlowNodeStatus, } from "./flow/index.js";
 export type { A2aAgentCard, A2aHttpServer, A2aHttpServerOptions, A2aTask, A2aTaskState, AcpHttpServer, AcpHttpServerOptions, AcpStdioServer, AcpStdioServerOptions, AgUiEvent, AgUiHttpServer, AgUiHttpServerOptions, AgUiRunAgentInput, } from "./api.js";
 export type { RuntimeMcpServerOptions, ToolMcpServerOptions } from "./mcp.js";

package/dist/index.js

@@ -1,2 +1,2 @@
-export { AgentHarnessAcpServer, AgentHarnessRuntime, buildFlowGraph, cancelRun, createAgentHarness, createAcpServer, createAcpStdioClient, createRuntimeMcpServer, createUpstreamTimelineReducer, createToolMcpServer, deleteSession, describeInventory, exportEvaluationBundle, exportRequestPackage, exportSessionPackage, replayEvaluationBundle, getArtifact, getAgent, getApproval, getOperatorOverview, getRequest, getHealth, listMemories, getSession, listAgentSkills, listArtifacts, listApprovals, listRequests, listRequestEvents, listSessions, memorize, normalizeUserChatInput, request, recall, removeMemory, resolveApproval, serveA2aHttp, serveAcpHttp, serveAcpStdio, serveAgUiHttp, serveRuntimeMcpOverStdio, serveToolsOverStdio, subscribe, stop, updateMemory, exportFlowGraphToMermaid, exportFlowGraphToSequenceMermaid, } from "./api.js";
+export { AgentHarnessAcpServer, AgentHarnessRuntime, buildFlowGraph, cancelRun, createAgentHarness, createAcpServer, createAcpStdioClient, createRuntimeMcpServer, createUpstreamTimelineReducer, createToolMcpServer, deleteSession, describeInventory, exportEvaluationBundle, exportRequestPackage, exportSessionPackage, replayEvaluationBundle, getArtifact, getAgent, getApproval, getOperatorOverview, getRequest, getHealth, listMemories, getSession, listAgentSkills, listArtifacts, listApprovals, listRequests, listRequestEvents, listSessionSummaries, listSessions, memorize, normalizeUserChatInput, request, recall, removeMemory, resolveApproval, serveA2aHttp, serveAcpHttp, serveAcpStdio, serveAgUiHttp, serveRuntimeMcpOverStdio, serveToolsOverStdio, subscribe, stop, updateMemory, exportFlowGraphToMermaid, exportFlowGraphToSequenceMermaid, } from "./api.js";
 export { tool } from "./tools.js";

package/dist/package-version.d.ts

@@ -1 +1 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.230";
+export declare const AGENT_HARNESS_VERSION = "0.0.231";

package/dist/package-version.js

@@ -1 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.230";
+export const AGENT_HARNESS_VERSION = "0.0.231";

package/dist/persistence/file-store.d.ts

@@ -1,5 +1,5 @@
 import type { ArtifactListing, ArtifactRecord, HarnessEvent, InternalApprovalRecord, RunSummary, RunState, ThreadSummary, ThreadRunRecord, TranscriptMessage } from "../contracts/types.js";
-import type { ApprovalFilter, PersistedRunRequest, PersistedRunControlRecord, PersistedRunInspection, PersistedRunQueueRecord, PersistenceLifecycle as Lifecycle, RuntimePersistence, RecoveryIntent, PersistenceRunMeta as RunMeta, RunSummaryFilter, ThreadSummaryFilter, PersistenceThreadMeta as ThreadMeta } from "./types.js";
+import type { ApprovalFilter, PersistedSessionListSummary, PersistedRunRequest, PersistedRunControlRecord, PersistedRunInspection, PersistedRunQueueRecord, PersistenceLifecycle as Lifecycle, RuntimePersistence, RecoveryIntent, PersistenceRunMeta as RunMeta, RunSummaryFilter, ThreadSummaryFilter, PersistenceThreadMeta as ThreadMeta } from "./types.js";
 type RunIndexRecord = {
     runId: string;
     threadId: string;
@@ -40,6 +40,7 @@ export declare class FilePersistence implements RuntimePersistence {
     setRunState(threadId: string, runId: string, state: RunState, checkpointRef?: string | null): Promise<void>;
     appendEvent(event: HarnessEvent): Promise<void>;
     listSessions(filter?: ThreadSummaryFilter): Promise<ThreadSummary[]>;
+    listSessionSummaries(filter?: ThreadSummaryFilter): Promise<PersistedSessionListSummary[]>;
     listRunIndexes(): Promise<RunIndexRecord[]>;
     private readRunSummary;
     listRuns(filter?: RunSummaryFilter): Promise<RunSummary[]>;

package/dist/persistence/file-store.js

@@ -228,6 +228,25 @@ export class FilePersistence {
             .filter((record) => !filter.agentId || record.agentId === filter.agentId)
             .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
     }
+    async listSessionSummaries(filter = {}) {
+        const sessions = await this.listSessions(filter);
+        const summaries = await Promise.all(sessions.map(async (session) => {
+            const [meta, messageBundle] = await Promise.all([
+                readJson(path.join(this.threadDir(session.threadId), "meta.json")),
+                readJson(path.join(this.threadDir(session.threadId), "messages.json"))
+                    .catch(() => ({ threadId: session.threadId, items: [] })),
+            ]);
+            const items = messageBundle.items;
+            return {
+                ...session,
+                entryAgentId: meta.entryAgentId,
+                messageCount: items.length,
+                firstMessage: items[0],
+                lastMessage: items.at(-1),
+            };
+        }));
+        return summaries.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+    }
     async listRunIndexes() {
         const runIndexDir = path.join(this.runRoot, "indexes", "runs");
         if (!(await fileExists(runIndexDir))) {

package/dist/persistence/sqlite-store.d.ts

@@ -1,5 +1,5 @@
 import type { ArtifactListing, ArtifactRecord, HarnessEvent, InternalApprovalRecord, RunState, RunSummary, ThreadRunRecord, ThreadSummary, TranscriptMessage } from "../contracts/types.js";
-import type { PersistedRunRequest, PersistedRunControlRecord, PersistedRunInspection, PersistedRunQueueRecord, PersistenceLifecycle, PersistenceRunMeta, PersistenceThreadMeta, RecoveryIntent, RuntimePersistence, ApprovalFilter, RunSummaryFilter, ThreadSummaryFilter } from "./types.js";
+import type { PersistedSessionListSummary, PersistedRunRequest, PersistedRunControlRecord, PersistedRunInspection, PersistedRunQueueRecord, PersistenceLifecycle, PersistenceRunMeta, PersistenceThreadMeta, RecoveryIntent, RuntimePersistence, ApprovalFilter, RunSummaryFilter, ThreadSummaryFilter } from "./types.js";
 export declare function listProtectedCheckpointThreadIds(dbPath: string): Promise<Set<string>>;
 export declare class SqlitePersistence implements RuntimePersistence {
     private readonly runRoot;
@@ -63,6 +63,7 @@ export declare class SqlitePersistence implements RuntimePersistence {
     setRunState(threadId: string, runId: string, state: RunState, checkpointRef?: string | null): Promise<void>;
     appendEvent(event: HarnessEvent): Promise<void>;
     listSessions(filter?: ThreadSummaryFilter): Promise<ThreadSummary[]>;
+    listSessionSummaries(filter?: ThreadSummaryFilter): Promise<PersistedSessionListSummary[]>;
     listRuns(filter?: RunSummaryFilter): Promise<RunSummary[]>;
     getRun(runId: string): Promise<RunSummary | null>;
     getSession(threadId: string): Promise<ThreadSummary | null>;

package/dist/persistence/sqlite-store.js

@@ -633,6 +633,65 @@ export class SqlitePersistence {
        ORDER BY updated_at DESC`, args);
         return rows.map((row) => this.mapThreadSummary(row));
     }
+    async listSessionSummaries(filter = {}) {
+        const { clause, args } = buildWhereClause([
+            ["threads.entry_agent_id = ?", filter.agentId],
+        ]);
+        const rows = await this.selectAll(`SELECT threads.thread_id, threads.entry_agent_id, threads.latest_run_id, threads.created_at, threads.updated_at, threads.status, run_inspection.current_agent_id,
+              COALESCE(message_counts.message_count, 0) AS message_count,
+              first_message.role AS first_message_role,
+              first_message.content_json AS first_message_content_json,
+              first_message.run_id AS first_message_run_id,
+              first_message.created_at AS first_message_created_at,
+              last_message.role AS last_message_role,
+              last_message.content_json AS last_message_content_json,
+              last_message.run_id AS last_message_run_id,
+              last_message.created_at AS last_message_created_at
+       FROM threads
+       LEFT JOIN run_inspection ON run_inspection.run_id = threads.latest_run_id
+       LEFT JOIN (
+         SELECT thread_id, COUNT(*) AS message_count
+         FROM thread_messages
+         GROUP BY thread_id
+       ) message_counts ON message_counts.thread_id = threads.thread_id
+       LEFT JOIN thread_messages AS first_message ON first_message.id = (
+         SELECT message.id
+         FROM thread_messages AS message
+         WHERE message.thread_id = threads.thread_id
+         ORDER BY message.created_at ASC, message.id ASC
+         LIMIT 1
+       )
+       LEFT JOIN thread_messages AS last_message ON last_message.id = (
+         SELECT message.id
+         FROM thread_messages AS message
+         WHERE message.thread_id = threads.thread_id
+         ORDER BY message.created_at DESC, message.id DESC
+         LIMIT 1
+       )
+       ${clause}
+       ORDER BY threads.updated_at DESC`, args);
+        return rows.map((row) => ({
+            ...this.mapThreadSummary(row),
+            entryAgentId: asString(row.entry_agent_id),
+            messageCount: Number(row.message_count ?? 0),
+            firstMessage: row.first_message_role
+                ? {
+                    role: asString(row.first_message_role),
+                    content: parseJson(row.first_message_content_json),
+                    runId: asString(row.first_message_run_id),
+                    createdAt: asString(row.first_message_created_at),
+                }
+                : undefined,
+            lastMessage: row.last_message_role
+                ? {
+                    role: asString(row.last_message_role),
+                    content: parseJson(row.last_message_content_json),
+                    runId: asString(row.last_message_run_id),
+                    createdAt: asString(row.last_message_created_at),
+                }
+                : undefined,
+        }));
+    }
     async listRuns(filter = {}) {
         const { clause, args } = buildWhereClause([
             ["runs.agent_id = ?", filter.agentId],

package/dist/persistence/types.d.ts

@@ -82,6 +82,12 @@ export type ApprovalFilter = {
     threadId?: string;
     runId?: string;
 };
+export type PersistedSessionListSummary = ThreadSummary & {
+    entryAgentId: string;
+    messageCount: number;
+    firstMessage?: TranscriptMessage;
+    lastMessage?: TranscriptMessage;
+};
 export interface RuntimePersistence {
     initialize(): Promise<void>;
     bootstrapRun?(input: {
@@ -123,6 +129,7 @@ export interface RuntimePersistence {
     appendEvent(event: HarnessEvent): Promise<void>;
     listRunEvents(threadId: string, runId: string): Promise<HarnessEvent[]>;
     listSessions(filter?: ThreadSummaryFilter): Promise<ThreadSummary[]>;
+    listSessionSummaries(filter?: ThreadSummaryFilter): Promise<PersistedSessionListSummary[]>;
     listRuns(filter?: RunSummaryFilter): Promise<RunSummary[]>;
     getRun(runId: string): Promise<RunSummary | null>;
     getSession(threadId: string): Promise<ThreadSummary | null>;

package/dist/runtime/harness.d.ts

@@ -1,4 +1,4 @@
-import type { ApprovalRecord, ArtifactListing, CancelOptions, HarnessEvent, HarnessStreamItem, RuntimeHealthSnapshot, RuntimeOperatorOverview, ListMemoriesInput, ListMemoriesResult, MessageContent, RemoveMemoryInput, RunRecord, RunStartOptions, RestartConversationOptions, RuntimeAdapterOptions, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult, RuntimeRunPackage, RuntimeRunPackageInput, RuntimeSessionPackage, RuntimeSessionPackageInput, ResumeOptions, RunOptions, RunResult, RunSummary, MemoryRecord, MemorizeInput, MemorizeResult, RecallInput, RecallResult, UpdateMemoryInput, SessionSummary, ThreadSummary, ThreadRecord, SessionRecord, RequestRecord, RequestSummary, WorkspaceBundle } from "../contracts/types.js";
+import type { ApprovalRecord, ArtifactListing, CancelOptions, HarnessEvent, HarnessStreamItem, RuntimeHealthSnapshot, RuntimeOperatorOverview, ListMemoriesInput, ListMemoriesResult, MessageContent, RemoveMemoryInput, RunRecord, RunStartOptions, RestartConversationOptions, RuntimeAdapterOptions, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult, RuntimeRunPackage, RuntimeRunPackageInput, RuntimeSessionPackage, RuntimeSessionPackageInput, ResumeOptions, RunOptions, RunResult, RunSummary, MemoryRecord, MemorizeInput, MemorizeResult, RecallInput, RecallResult, UpdateMemoryInput, SessionSummary, ThreadSummary, ThreadRecord, SessionRecord, RequestRecord, RequestSummary, SessionListSummary, WorkspaceBundle } from "../contracts/types.js";
 import { type RuntimeMcpServerOptions, type ToolMcpServerOptions } from "../mcp.js";
 import { type InventoryAgentRecord, type InventorySkillRecord } from "./harness/system/inventory.js";
 import type { RequirementAssessmentOptions } from "./harness/system/skill-requirements.js";
@@ -66,6 +66,9 @@ export declare class AgentHarnessRuntime {
     listSessions(filter?: {
         agentId?: string;
     }): Promise<SessionSummary[]>;
+    listSessionSummaries(filter?: {
+        agentId?: string;
+    }): Promise<SessionListSummary[]>;
     listThreads(filter?: {
         agentId?: string;
     }): Promise<ThreadSummary[]>;

package/dist/runtime/harness.js

@@ -1,6 +1,7 @@
 import path from "node:path";
 import { SqlitePersistence } from "../persistence/sqlite-store.js";
 import { createPersistentId } from "../utils/id.js";
+import { extractMessageText } from "../utils/message-content.js";
 import { AgentRuntimeAdapter } from "./agent-runtime-adapter.js";
 import { EventBus } from "./harness/events/event-bus.js";
 import { createBackgroundEventRuntime } from "./harness/background-runtime.js";
@@ -40,6 +41,34 @@ import { initializeHarnessRuntime, reclaimExpiredClaimedRuns as reclaimHarnessEx
 import { streamHarnessRun } from "./harness/run/stream-run.js";
 import { defaultRequestedAgentId, prepareRunStart } from "./harness/run/start-run.js";
 import { buildRequestInspectionRecord, buildSessionInspectionRecord, deleteSessionRecord, deleteThreadRecord, getPublicApproval, listPublicApprovals, } from "./harness/run/thread-records.js";
+function normalizeSessionListText(content, limit) {
+    if (!content) {
+        return undefined;
+    }
+    const collapsed = extractMessageText(content).replace(/\s+/g, " ").trim();
+    if (!collapsed) {
+        return undefined;
+    }
+    return collapsed.length > limit ? `${collapsed.slice(0, limit - 1).trimEnd()}…` : collapsed;
+}
+function toSessionListSummary(session) {
+    const titleSource = session.firstMessage?.role === "user" ? session.firstMessage : session.lastMessage;
+    return {
+        agentId: session.agentId,
+        entryAgentId: session.entryAgentId,
+        sessionId: session.threadId,
+        latestRequestId: session.latestRunId,
+        createdAt: session.createdAt,
+        updatedAt: session.updatedAt,
+        status: session.status,
+        currentAgentId: session.currentAgentId,
+        messageCount: session.messageCount,
+        hasVisibleMessages: session.messageCount > 0,
+        lastMessageRole: session.lastMessage?.role,
+        title: normalizeSessionListText(titleSource?.content, 72),
+        snippet: normalizeSessionListText(session.lastMessage?.content, 160),
+    };
+}
 export class AgentHarnessRuntime {
     workspace;
     runtimeAdapterOptions;
@@ -312,6 +341,10 @@ export class AgentHarnessRuntime {
             currentAgentId: session.currentAgentId,
         }));
     }
+    async listSessionSummaries(filter) {
+        const sessions = await this.persistence.listSessionSummaries(filter);
+        return sessions.map((session) => toSessionListSummary(session));
+    }
     async listThreads(filter) {
         const sessions = await this.listSessions(filter);
         return sessions.map((session) => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.231",
+  "version": "0.0.232",
   "description": "Workspace runtime for multi-agent applications",
   "license": "MIT",
   "type": "module",