opencode-swarm-plugin 0.32.0 → 0.34.0

package/dist/logger.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Logger infrastructure using Pino with daily rotation
+ *
+ * Features:
+ * - Daily log rotation via pino-roll (numeric format: swarm.1log, swarm.2log, etc.)
+ * - 14-day retention (14 files max in addition to current file)
+ * - Module-specific child loggers with separate log files
+ * - Pretty mode for development (SWARM_LOG_PRETTY=1 env var)
+ * - Logs to ~/.config/swarm-tools/logs/ by default
+ *
+ * Note: pino-roll uses numeric rotation (e.g., swarm.1log, swarm.2log) not date-based names.
+ * Files rotate daily based on frequency='daily', with a maximum of 14 retained files.
+ */
+import type { Logger } from "pino";
+/**
+ * Gets or creates the main logger instance
+ *
+ * @param logDir - Optional log directory (defaults to ~/.config/swarm-tools/logs)
+ * @returns Pino logger instance
+ */
+export declare function getLogger(logDir?: string): Logger;
+/**
+ * Creates a child logger for a specific module with its own log file
+ *
+ * @param module - Module name (e.g., "compaction", "cli")
+ * @param logDir - Optional log directory (defaults to ~/.config/swarm-tools/logs)
+ * @returns Child logger instance
+ */
+export declare function createChildLogger(module: string, logDir?: string): Logger;
+/**
+ * Default logger instance for immediate use
+ */
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAuDnC;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,GAAE,MAAwB,GAAG,MAAM,CAmBlE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAwB,GAC/B,MAAM,CAoBR;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,QAAc,CAAC"}

package/dist/observability-tools.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Observability Tools - Agent-facing Analytics
+ *
+ * Exposes observability tools to agents via plugin tools.
+ * Agents get programmatic access to analytics, not just CLI.
+ *
+ * Tools:
+ * - swarm_analytics: Query pre-built analytics
+ * - swarm_query: Raw SQL for power users
+ * - swarm_diagnose: Auto-diagnosis for epic/task
+ * - swarm_insights: Generate learning insights
+ */
+export interface SwarmAnalyticsArgs {
+    query: "failed-decompositions" | "strategy-success-rates" | "lock-contention" | "agent-activity" | "message-latency" | "scope-violations" | "task-duration" | "checkpoint-frequency" | "recovery-success" | "human-feedback";
+    since?: string;
+    format?: "json" | "summary";
+}
+export interface SwarmQueryArgs {
+    sql: string;
+    format?: "json" | "table";
+}
+export interface SwarmDiagnoseArgs {
+    epic_id?: string;
+    bead_id?: string;
+    include?: Array<"blockers" | "conflicts" | "slow_tasks" | "errors" | "timeline">;
+}
+export interface SwarmInsightsArgs {
+    scope: "epic" | "project" | "recent";
+    epic_id?: string;
+    metrics: Array<"success_rate" | "avg_duration" | "conflict_rate" | "retry_rate">;
+}
+export declare const observabilityTools: {
+    swarm_analytics: {
+        description: string;
+        args: {
+            query: import("zod").ZodEnum<{
+                "failed-decompositions": "failed-decompositions";
+                "strategy-success-rates": "strategy-success-rates";
+                "lock-contention": "lock-contention";
+                "agent-activity": "agent-activity";
+                "message-latency": "message-latency";
+                "scope-violations": "scope-violations";
+                "task-duration": "task-duration";
+                "checkpoint-frequency": "checkpoint-frequency";
+                "recovery-success": "recovery-success";
+                "human-feedback": "human-feedback";
+            }>;
+            since: import("zod").ZodOptional<import("zod").ZodString>;
+            format: import("zod").ZodOptional<import("zod").ZodEnum<{
+                summary: "summary";
+                json: "json";
+            }>>;
+        };
+        execute(args: {
+            query: "failed-decompositions" | "strategy-success-rates" | "lock-contention" | "agent-activity" | "message-latency" | "scope-violations" | "task-duration" | "checkpoint-frequency" | "recovery-success" | "human-feedback";
+            since?: string | undefined;
+            format?: "summary" | "json" | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    swarm_query: {
+        description: string;
+        args: {
+            sql: import("zod").ZodString;
+            format: import("zod").ZodOptional<import("zod").ZodEnum<{
+                json: "json";
+                table: "table";
+            }>>;
+        };
+        execute(args: {
+            sql: string;
+            format?: "json" | "table" | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    swarm_diagnose: {
+        description: string;
+        args: {
+            epic_id: import("zod").ZodOptional<import("zod").ZodString>;
+            bead_id: import("zod").ZodOptional<import("zod").ZodString>;
+            include: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
+                errors: "errors";
+                blockers: "blockers";
+                conflicts: "conflicts";
+                slow_tasks: "slow_tasks";
+                timeline: "timeline";
+            }>>>;
+        };
+        execute(args: {
+            epic_id?: string | undefined;
+            bead_id?: string | undefined;
+            include?: ("errors" | "blockers" | "conflicts" | "slow_tasks" | "timeline")[] | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    swarm_insights: {
+        description: string;
+        args: {
+            scope: import("zod").ZodEnum<{
+                project: "project";
+                epic: "epic";
+                recent: "recent";
+            }>;
+            epic_id: import("zod").ZodOptional<import("zod").ZodString>;
+            metrics: import("zod").ZodArray<import("zod").ZodEnum<{
+                success_rate: "success_rate";
+                avg_duration: "avg_duration";
+                conflict_rate: "conflict_rate";
+                retry_rate: "retry_rate";
+            }>>;
+        };
+        execute(args: {
+            scope: "project" | "epic" | "recent";
+            metrics: ("success_rate" | "avg_duration" | "conflict_rate" | "retry_rate")[];
+            epic_id?: string | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+};
+//# sourceMappingURL=observability-tools.d.ts.map

package/dist/observability-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-tools.d.ts","sourceRoot":"","sources":["../src/observability-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA2BH,MAAM,WAAW,kBAAkB;IAClC,KAAK,EACF,uBAAuB,GACvB,wBAAwB,GACxB,iBAAiB,GACjB,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,eAAe,GACf,sBAAsB,GACtB,kBAAkB,GAClB,gBAAgB,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,KAAK,CACd,UAAU,GAAG,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,CAC/D,CAAC;CACF;AAED,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC,cAAc,GAAG,cAAc,GAAG,eAAe,GAAG,YAAY,CAAC,CAAC;CACjF;AAqgBD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAK9B,CAAC"}