opencode-swarm 7.92.0 → 7.93.0

package/dist/services/session-reflection.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Session reflection service — two-phase end-of-session architect review.
+ *
+ * Phase 1 (deterministic): Aggregate session signals — tool failures, gate
+ * rejections, error taxonomy, agent dispatches, retro lessons. No LLM, no
+ * quota, fast. Produces a structured snapshot the architect can reason over.
+ *
+ * Phase 2 (LLM): Feed the snapshot to the skill_improver agent (which acts
+ * as the architect's reflection delegate) to produce an actionable report:
+ * what skills to create/change, what problems were encountered, what tools
+ * didn't work, and what the swarm should learn for next time. The report is
+ * surfaced directly in the finalize output — not buried in an artifact.
+ *
+ * When no LLM client is available, phase 2 falls back to a deterministic
+ * summary so finalize never blocks on missing infrastructure.
+ */
+import { type SkillImproverLLMDelegate } from '../hooks/skill-improver-llm-factory';
+import type { ToolAggregate } from '../state';
+export interface ToolProblem {
+    tool: string;
+    failureCount: number;
+    totalCalls: number;
+    failureRate: number;
+    avgDurationMs: number;
+}
+export interface AgentDispatchSummary {
+    agent: string;
+    delegationCount: number;
+    lastDelegationReason?: string;
+}
+export interface GateFailureSummary {
+    gate: string;
+    taskId: string;
+    count: number;
+}
+export interface SessionReflectionData {
+    timestamp: string;
+    totalToolCalls: number;
+    totalToolFailures: number;
+    toolProblems: ToolProblem[];
+    agentDispatches: AgentDispatchSummary[];
+    gateFailures: GateFailureSummary[];
+    lessonsFromRetros: string[];
+    errorTaxonomy: Record<string, number>;
+}
+export interface SessionReflectionResult {
+    data: SessionReflectionData;
+    architectReport: string;
+    source: 'llm' | 'deterministic';
+}
+declare function gatherToolProblems(toolAggregates: Map<string, ToolAggregate>): {
+    problems: ToolProblem[];
+    totalCalls: number;
+    totalFailures: number;
+};
+interface AgentSessionLike {
+    agentName: string;
+    lastDelegationReason?: string;
+}
+declare function gatherAgentDispatches(agentSessions: Map<string, AgentSessionLike>): AgentDispatchSummary[];
+declare function gatherRetroLessonsAndTaxonomy(directory: string): Promise<{
+    lessons: string[];
+    taxonomy: Record<string, number>;
+}>;
+declare function gatherGateFailures(directory: string): Promise<GateFailureSummary[]>;
+declare function buildReflectionDataSummary(data: SessionReflectionData): string;
+declare function buildDeterministicReport(data: SessionReflectionData): string;
+export interface SessionReflectionInput {
+    directory: string;
+    toolAggregates: Map<string, ToolAggregate>;
+    agentSessions: Map<string, AgentSessionLike>;
+    sessionId?: string;
+    signal?: AbortSignal;
+    delegate?: SkillImproverLLMDelegate;
+}
+export declare function runSessionReflection(input: SessionReflectionInput): Promise<SessionReflectionResult>;
+export declare function writeSessionReflection(directory: string, result: SessionReflectionResult): Promise<string>;
+export declare const _internals: {
+    gatherToolProblems: typeof gatherToolProblems;
+    gatherAgentDispatches: typeof gatherAgentDispatches;
+    gatherRetroLessonsAndTaxonomy: typeof gatherRetroLessonsAndTaxonomy;
+    gatherGateFailures: typeof gatherGateFailures;
+    buildReflectionDataSummary: typeof buildReflectionDataSummary;
+    buildDeterministicReport: typeof buildDeterministicReport;
+};
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.92.0",
+	"version": "7.93.0",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",