opencode-swarm 7.177.1 → 7.178.0

package/dist/dashboard/views.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Read-only dashboard data layer (issue #2509).
+ *
+ * Every view composes the repo's existing bounded read APIs — this module
+ * holds no authoritative state and performs no durable writes of its own;
+ * the one exception is shared plumbing: on a legacy-telemetry-only project,
+ * the observability coverage read (same call `/swarm report` makes) may
+ * materialize `.swarm/swarm.db` via its rebuildable-import path
+ * (observability-event-store, issue #2482). Design rules (AGENTS invariants
+ * 4/5, issue #2509 AC4/AC6/AC7):
+ *
+ * - DB reads go through the sanctioned read-only surface
+ *   (`withProjectDbReadOnly`) or store readers that already fail closed on an
+ *   absent DB; anything that would open the shared writer handle is guarded
+ *   by `projectDbExists` so a read-only view can never materialize a
+ *   `.swarm/` tree that does not exist yet.
+ * - Every string rendered into a payload passes through
+ *   `sanitizeFailureEvidenceDisplay` (the house no-secrets posture —
+ *   src/failures/invocation-failure.ts, kin to the src/commands/_shared/
+ *   url-security.ts standard named by the issue) plus the URL-credential and
+ *   filesystem-path prescrubs below — no field class is exempt; plain
+ *   identifiers simply survive it.
+ * - Row counts and per-field lengths are capped so responses stay bounded
+ *   against very large stores (AC7).
+ */
+import { type SwarmDbHealthSnapshot } from '../db/health.js';
+interface GateProfileSummaryRow {
+    planId: string;
+    enabledGates: string[];
+}
+interface CircuitSummaryRow {
+    label: string;
+    state: string;
+    generation: number | null;
+    since: string | null;
+}
+export interface GatesView {
+    available: boolean;
+    unavailableReason?: string;
+    profileCount: number;
+    profiles: GateProfileSummaryRow[];
+    enabledCounts: Record<string, number>;
+    circuits: CircuitSummaryRow[];
+}
+export interface DelegationBandRow {
+    band: string;
+    count: number;
+    oldestAgeMs: number | null;
+}
+export interface DelegationRow {
+    correlationId: string;
+    agent: string;
+    status: string;
+    planTaskId: string;
+    ageMinutes: number | null;
+}
+export interface DelegationsView {
+    available: boolean;
+    unavailableReason?: string;
+    total: number;
+    bands: DelegationBandRow[];
+    recent: DelegationRow[];
+}
+export interface LaneRow {
+    correlationId: string;
+    laneId: string;
+    batchId: string;
+    workflowLane: string;
+    status: string;
+    pendingMinutes: number | null;
+    staleSuspect: boolean;
+}
+export interface LanesView {
+    available: boolean;
+    unavailableReason?: string;
+    lanes: LaneRow[];
+    staleSuspectCount: number;
+}
+export interface TaskRow {
+    id: string;
+    phase: number;
+    status: string;
+    description: string;
+}
+export interface TasksView {
+    available: boolean;
+    unavailableReason?: string;
+    title: string;
+    currentPhase: number | null;
+    tasks: TaskRow[];
+}
+export interface TimelineEventRow {
+    occurredAt: string;
+    kind: string;
+    severity: string;
+    taskId: string;
+    sessionId: string;
+    payload: string;
+}
+export interface TimelineView {
+    available: boolean;
+    unavailableReason?: string;
+    totalMatching: number;
+    truncated: boolean;
+    events: TimelineEventRow[];
+}
+export interface OverviewView {
+    dbHealth: SwarmDbHealthSnapshot;
+    gates: GatesView;
+    delegations: DelegationsView;
+    lanes: LanesView;
+    tasks: TasksView;
+    timeline: TimelineView;
+}
+export declare function renderGatesView(directory: string): GatesView;
+export declare function renderDelegationsView(directory: string): DelegationsView;
+export declare function renderLanesView(directory: string): LanesView;
+export declare function renderTasksView(directory: string): Promise<TasksView>;
+export declare function renderTimelineView(directory: string): TimelineView;
+export interface DashboardStatusView {
+    dbHealth: SwarmDbHealthSnapshot;
+    observabilityCoverage: {
+        available: boolean;
+        totalRows?: number;
+        earliestOccurredAt?: string | null;
+        latestOccurredAt?: string | null;
+    };
+}
+export declare function renderStatusView(directory: string): DashboardStatusView;
+export declare function renderOverviewView(directory: string): Promise<OverviewView>;
+export {};

package/dist/hooks/index.d.ts

@@ -19,5 +19,5 @@ export { createPipelineTrackerHook } from './pipeline-tracker';
 export { createRepoGraphBuilderHook, type RepoGraphBuilderHook, } from './repo-graph-builder';
 export { buildApprovedReceipt, buildReceiptContextForDrift, buildRejectedReceipt, persistReviewReceipt, readAllReceipts, readReceiptsByScopeHash, } from './review-receipt';
 export { createSystemEnhancerHook } from './system-enhancer';
-export { createToolSummarizerHook, resetSummaryIdCounter, } from './tool-summarizer';
+export { createToolSummarizerHook } from './tool-summarizer';
 export { composeBlockingHandlers, composeHandlers, estimateTokens, readSwarmFileAsync, safeHook, validateSwarmPath, } from './utils';

package/dist/hooks/tool-summarizer.d.ts

@@ -6,10 +6,15 @@
  * the output with a compact summary containing a retrieval ID.
  */
 import type { SummaryConfig } from '../config/schema';
+import { allocateSummaryId, storeSummary } from '../summaries/manager';
 /**
- * Reset the summary ID counter. Used for testing.
+ * Dependency seam for tests (repo `_internals` DI convention) so the
+ * collision-retry path is unit-testable without `mock.module`.
  */
-export declare function resetSummaryIdCounter(): void;
+export declare const _internals: {
+    allocateSummaryId: typeof allocateSummaryId;
+    storeSummary: typeof storeSummary;
+};
 /**
  * Creates a tool.execute.after hook that summarizes oversized tool outputs.
  *