@agimon-ai/po-log 0.0.0-alpha.74 → 0.0.0-alpha.75

package/dist/extensions/server.cjs

@@ -170,6 +170,7 @@ function createLogsinkTool(method, operations) {
 //#region src/services/logsinkNamespace/index.ts
 const DECLARATIONS = `interface LogScope { kind: 'session' | 'history'; sessionId?: string; startTime?: string; endTime?: string }
 interface LogResponse<T> { scope: LogScope; data: T }
+interface LogPage { offset: number; limit: number; hasMore: boolean; nextOffset: number | null }
 interface LogFilters {
   scope?: 'session' | 'history'; sessionId?: string; startTime?: string; endTime?: string;
   workflowRunId?: string; workflowName?: string; jobName?: string; jobId?: string;
@@ -183,7 +184,7 @@ interface LogRecord {
   metadata: Record<string, unknown> | null; errorType: string | null; errorMessage: string | null;
   [field: string]: unknown;
 }
-interface LogSearch { mode: 'filter' | 'fts'; count: number; total: number; truncated: boolean; results: LogRecord[] }
+interface LogSearch { mode: 'filter' | 'fts'; count: number; total: number; truncated: boolean; results: LogRecord[]; pagination: LogPage }
 interface LogIssue {
   category: string; timestamp: string; service: string; sessionId: string | null; tool: string | null;
   errorType: string | null; message: string; detail: string | null; fingerprint: string; occurrenceCount: number;
@@ -192,12 +193,12 @@ interface LogIssue {
 interface LogIssues {
   scanned: number; matchingLogs: number; truncated: boolean; coveragePercent: number; oldestScannedTimestamp: string | null;
   totalIssues: number; uniqueIncidents: number; byCategory: Record<string, number>; byTool: Record<string, number>;
-  byErrorType: Record<string, number>; bySession: Record<string, number>; issues: LogIssue[];
+  byErrorType: Record<string, number>; bySession: Record<string, number>; issues: LogIssue[]; pagination: LogPage;
 }
 interface LogTraceEntry { timestamp: string; service: string; spanId: string | null; parentSpanId: string | null; level: string; message: string; [field: string]: unknown }
-interface LogTrace { traceId: string; count: number; truncated: boolean; timeline: LogTraceEntry[] }
-interface LogStats { groupBy: string; signalType: 'log' | 'span' | 'all'; totalEntries: number; statistics: { service: string; level: string; count: number }[] }
-interface LogServices { count: number; truncated: boolean; services: string[] }
+interface LogTrace { traceId: string; count: number; truncated: boolean; timeline: LogTraceEntry[]; pagination: LogPage }
+interface LogStats { groupBy: string; signalType: 'log' | 'span' | 'all'; totalEntries: number; statistics: { service: string; level: string; count: number }[]; pagination: LogPage }
+interface LogServices { count: number; truncated: boolean; services: string[]; pagination: LogPage }
 interface LogTokens { inputTokens: number; outputTokens: number; totalTokens: number; cachedInputTokens: number; reasoningOutputTokens: number; usageEventCount: number }
 interface LogTokenDistribution { samples: number; avgInputTokens: number; p50InputTokens: number; p90InputTokens: number; avgOutputTokens: number; p50OutputTokens: number; p90OutputTokens: number; avgTotalTokens: number; p50TotalTokens: number; p90TotalTokens: number }
 interface LogMetrics {
@@ -207,22 +208,23 @@ interface LogMetrics {
   groups: (LogTokens & { key: string; sessionId: string | null; issueCount: number; byCategory: Record<string, number>; [field: string]: unknown })[];
   tools: { returnedTools: number; rows: { toolName: string; invocationCount: number; toolCallTurn: LogTokenDistribution; toolOutputImpact: LogTokenDistribution; [field: string]: unknown }[] };
   timeline: (LogTokens & { bucketStart: string; label: string; totalRecords: number; issueCount: number })[];
+  pagination: { groups: LogPage; tools: LogPage; timeline: LogPage };
 }
 declare const logsink: {
   /** Retained storage availability, not proof that the collector is capturing now. */
   status(): Promise<LogResponse<LogAvailability>>;
-  /** Scoped structured query or FTS search. History requires explicit startTime/endTime. order is filter-only and rejected with query. limit is at most 1000, and a result too large to return is refused: narrow the time window instead. */
-  search(input?: LogFilters & { query?: string; mode?: 'fts'; level?: string | string[]; traceId?: string; spanId?: string; errorType?: string; parentSessionId?: string; workflowId?: string; signalType?: 'log' | 'span'; limit?: number; order?: 'asc' | 'desc' }): Promise<LogResponse<LogSearch>>;
-  /** Failure aggregates and deduplicated samples, including coverage and truncation. */
-  agentIssues(input?: LogFilters & { limit?: number; scanLimit?: number }): Promise<LogResponse<LogIssues>>;
-  /** A bounded trace, filtered within scope before retrieval. */
-  trace(input: LogFilters & { traceId: string; limit?: number }): Promise<LogResponse<LogTrace>>;
-  /** Counts by level, service, agent, workflow, job or signal. */
-  stats(input?: LogFilters & { groupBy?: 'level' | 'service' | 'both' | 'agent' | 'workflow' | 'job' | 'signal'; signalType?: 'log' | 'span' | 'all' }): Promise<LogResponse<LogStats>>;
-  /** Services that have retained records within scope. */
-  services(input?: LogFilters & { limit?: number }): Promise<LogResponse<LogServices>>;
-  /** Captured usage and tool turn costs, not exclusive per-tool token shares. */
-  metrics(input?: LogFilters & { model?: string | string[]; provider?: string | string[]; groupBy?: 'session' | 'workflow-run' | 'workflow-name' | 'job' | 'step' | 'agent' | 'model' | 'provider'; sort?: 'last-seen' | 'total-tokens' | 'issues'; toolSort?: 'p90-total-tokens' | 'avg-total-tokens' | 'invocations'; limit?: number; toolLimit?: number; period?: 'day' | 'week' | 'month' | 'all'; bucket?: 'hour' | 'day' | 'week' | 'month' }): Promise<LogResponse<LogMetrics>>;
+  /** Scoped structured query or FTS search. History requires explicit startTime/endTime. order is filter-only. Pages default to limit 100 (max 1000), offset 0. Continue with pagination.nextOffset and unchanged filters; live data is not a snapshot. Oversized results are refused: lower limits or narrow the window. */
+  search(input?: LogFilters & { query?: string; mode?: 'fts'; level?: string | string[]; traceId?: string; spanId?: string; errorType?: string; parentSessionId?: string; workflowId?: string; signalType?: 'log' | 'span'; limit?: number; offset?: number; order?: 'asc' | 'desc' }): Promise<LogResponse<LogSearch>>;
+  /** Pages deduplicated incidents, not scan coverage. Totals cover the whole bounded scan; truncated describes that scan. */
+  agentIssues(input?: LogFilters & { limit?: number; offset?: number; scanLimit?: number }): Promise<LogResponse<LogIssues>>;
+  /** A bounded trace page, filtered within scope before retrieval. */
+  trace(input: LogFilters & { traceId: string; limit?: number; offset?: number }): Promise<LogResponse<LogTrace>>;
+  /** Pages counts by level, service, agent, workflow, job or signal. totalEntries covers all matching groups. */
+  stats(input?: LogFilters & { groupBy?: 'level' | 'service' | 'both' | 'agent' | 'workflow' | 'job' | 'signal'; signalType?: 'log' | 'span' | 'all'; limit?: number; offset?: number }): Promise<LogResponse<LogStats>>;
+  /** Services that have retained records within scope, alphabetically paged. */
+  services(input?: LogFilters & { limit?: number; offset?: number }): Promise<LogResponse<LogServices>>;
+  /** Captured usage and tool turn costs, not exclusive per-tool token shares. Independently pages groups (limit/offset, default 50), tools (toolLimit/toolOffset, default 20), timeline (timelineLimit/timelineOffset, default 100). Totals cover the full scope. */
+  metrics(input?: LogFilters & { model?: string | string[]; provider?: string | string[]; groupBy?: 'session' | 'workflow-run' | 'workflow-name' | 'job' | 'step' | 'agent' | 'model' | 'provider'; sort?: 'last-seen' | 'total-tokens' | 'issues'; toolSort?: 'p90-total-tokens' | 'avg-total-tokens' | 'invocations'; limit?: number; offset?: number; toolLimit?: number; toolOffset?: number; timelineLimit?: number; timelineOffset?: number; period?: 'day' | 'week' | 'month' | 'all'; bucket?: 'hour' | 'day' | 'week' | 'month' }): Promise<LogResponse<LogMetrics>>;
 };`;
 const MAX_TRANSCRIPT_JSON = 12e3;
 const TRANSCRIPT_LIST_SIZES = [
@@ -235,8 +237,11 @@ const RECORD_LISTS = /* @__PURE__ */ new Set([
 	"timeline",
 	"issues",
 	"groups",
-	"rows"
+	"rows",
+	"statistics",
+	"services"
 ]);
+const RUN_DISPOSED = "Log Sink run is disposed.";
 function cutLists(value, size) {
 	if (Array.isArray(value)) return value.map((item) => cutLists(item, size));
 	if (value === null || typeof value !== "object") return value;
@@ -249,7 +254,7 @@ function transcriptCopy(result) {
 	for (const size of TRANSCRIPT_LIST_SIZES) {
 		const kept = {
 			...cutLists(JSON.parse(json), size),
-			note: `Transcript copy keeps at most ${size} items per record list; the script received every record.`
+			note: `Transcript copy keeps at most ${size} items per record list; the script received every record in the requested page.`
 		};
 		if (JSON.stringify(kept).length <= MAX_TRANSCRIPT_JSON) return kept;
 	}
@@ -265,12 +270,12 @@ function createLogsinkNamespace(operations) {
 			const controller = new AbortController();
 			run.onDispose(() => {
 				disposed = true;
-				controller.abort(/* @__PURE__ */ new Error("Log Sink run is disposed."));
+				controller.abort(/* @__PURE__ */ new Error(RUN_DISPOSED));
 			});
 			const signal = AbortSignal.any([run.signal, controller.signal]);
 			const check = () => {
 				signal.throwIfAborted();
-				if (disposed) throw new Error("Log Sink run is disposed.");
+				if (disposed) throw new Error(RUN_DISPOSED);
 			};
 			const members = Object.create(null);
 			for (const method of LOGSINK_METHODS) members[method] = async (input = {}) => {