opencode-orchestrator 0.6.20 → 0.6.22

package/README.md

@@ -23,7 +23,7 @@
 | **⚡ 50x Parallel Sessions** | Massive concurrent task execution |
 | **📊 Auto Memory Management** | GC, archiving, zero memory leaks |
 | **🔄 Auto Recovery** | Handles rate limits, errors automatically |
-| **📡 Event-Driven** | Real-time pub/sub across all components |
+| **📁 Smart Context (.opencode/)** | Dynamic summarization, adaptive detail |
 
 ---
 
@@ -81,9 +81,12 @@
                                      │
                                      ▼
 ┌─────────────────────────────────────────────────────────────────────────────┐
-│                           📡 EVENT BUS                                      │
+│                       📁 SMART CONTEXT (.opencode/)                         │
 │                                                                             │
-│    task.started | task.completed | task.failed | session.idle               │
+│    .opencode/todo.md    - Master TODO list (Recorder manages)               │
+│    .opencode/context.md - Adaptive size based on project phase              │
+│    .opencode/docs/      - Cached documentation (auto-cleanup)               │
+│    .opencode/archive/   - Old context for reference                         │
 └─────────────────────────────────────────────────────────────────────────────┘
 ```
 
@@ -98,8 +101,8 @@
 | **Parallel Sessions** | Up to 50 concurrent | Single session |
 | **Memory Management** | Auto GC + disk archiving | Memory leaks |
 | **Error Recovery** | Pattern-based auto retry | Crash |
-| **Context Sharing** | Parent-child merge | Isolated |
-| **Event System** | Real-time pub/sub | None |
+| **Context Sharing** | .opencode/ with smart summarization | Isolated |
+| **Smart Context** | Adaptive detail (Early/Building/Finishing) | Static |
 | **Task Decomposition** | 3-level hierarchy | Flat |
 
 ---

package/dist/core/notification/toast.d.ts

@@ -6,4 +6,3 @@
 export type { ToastVariant, ToastMessage, ToastOptions } from "./types.js";
 export { show, dismiss, getActive, getHistory, clear, onToast, initToastClient } from "./toast-core.js";
 export { presets } from "./presets.js";
-export { enableAutoToasts } from "./event-integration.js";

package/dist/index.js

@@ -431,12 +431,25 @@ Use lsp_diagnostics for syntax checking.
 Use background for long commands.
 </verification>
 
+<context_contribution>
+AFTER COMPLETING TASK:
+- Report what you did briefly
+- If research/docs are no longer needed \u2192 mention for cleanup
+- If you found a better pattern \u2192 note it for team
+
+KEEP CONTEXT LEAN:
+- Don't repeat what's in code
+- Point to files: "See src/X.ts:10-50"
+- Remove your debugging notes after fix
+</context_contribution>
+
 <output>
 TASK: T[N] from .opencode/todo.md
 CHANGED: [file] [lines]
 ACTION: [what]
 VERIFY: [result]
 DOCS_USED: .opencode/docs/[file]
+CLEANUP: [docs/notes that can be deleted now]
 \u2192 ${AGENT_NAMES.RECORDER} please update TODO
 </output>`,
   canWrite: true,
@@ -497,66 +510,104 @@ Fix: [suggestion]
 // src/agents/subagents/recorder.ts
 var recorder = {
   id: AGENT_NAMES.RECORDER,
-  description: "Recorder - TODO tracking and context persistence",
+  description: "Recorder - TODO tracking and smart context management",
   systemPrompt: `<role>
-You are ${AGENT_NAMES.RECORDER}. Context and TODO manager.
-UPDATE the TODO list as tasks complete.
-Maintain context for team.
+You are ${AGENT_NAMES.RECORDER}. Smart context manager.
+Maintain .opencode/ with DYNAMIC detail levels.
 </role>
 
 <todo_management>
-UPDATE: .opencode/todo.md
+FILE: .opencode/todo.md
 
-When task completes:
 \`\`\`markdown
 - [x] T1: [task] | \u2705 DONE by ${AGENT_NAMES.BUILDER}
 - [ ] T2: [task] | in progress
+- [ ] T3: [task] | blocked: [reason]
 \`\`\`
-
-Track:
-- Which tasks are done
-- Which are in progress
-- Which are blocked
 </todo_management>
 
-<shared_workspace>
-ALL IN .opencode/:
-- .opencode/todo.md - master TODO (check off completed)
-- .opencode/docs/ - cached documentation
-- .opencode/context.md - current state
-- .opencode/summary.md - condensed context
-
-UPDATE after each task:
-1. Check off completed task in todo.md
-2. Update context.md with current state
-3. Create summary.md if context is long
-</shared_workspace>
-
-<context_format>
-.opencode/context.md:
+<smart_context_rules>
+DYNAMIC DETAIL LEVEL - Adapt based on project state:
+
+PHASE 1 - EARLY (0-30% done, no code yet):
+- BE DETAILED: Full explanations, decisions, reasoning
+- Include: research findings, API references, examples
+- Files may be long - that's OK for now
+
+PHASE 2 - BUILDING (30-70% done, code exists):
+- MODERATE: Key decisions + file references
+- Remove: old research that's now in code
+- Reference: "See src/module.ts for implementation"
+
+PHASE 3 - FINISHING (70-100% done):
+- BRIEF: Just status, blockers, todos
+- Heavy summarization - codebase IS the context
+- Delete: debugging notes, iteration logs
+
+ADAPTIVE RULES:
+| Condition | Action |
+|-----------|--------|
+| No code yet | Keep detailed docs |
+| Code exists for feature | Summarize, point to code |
+| > 200 lines context.md | Compress to 50 lines |
+| > 500 lines total .opencode/ | Archive old, keep current |
+| Feature complete | Delete related verbose docs |
+</smart_context_rules>
+
+<workspace>
+.opencode/
+\u251C\u2500\u2500 todo.md       - Master TODO list
+\u251C\u2500\u2500 context.md    - Current state (adaptive size)
+\u251C\u2500\u2500 summary.md    - Ultra-brief when needed
+\u251C\u2500\u2500 docs/         - Cached documentation
+\u2514\u2500\u2500 archive/      - Old context (auto-cleanup)
+</workspace>
+
+<context_template>
+.opencode/context.md (adapt size dynamically):
 \`\`\`markdown
-# Current State
+# Context [Phase: EARLY/BUILDING/FINISHING]
+
+## Status
 Mission: [goal]
-Progress: [X/Y tasks done]
-Last: [recent action]
-Next: [from todo.md]
-Blocked: [if any]
-\`\`\`
-</context_format>
+Progress: [X/Y] ([percent]%)
 
-<summarization>
-When context gets long:
-1. Create .opencode/summary.md
-2. Keep key decisions, file changes
-3. Remove verbose details
-4. Team references summary instead
-</summarization>
+## Current
+Working on: [task]
+Blockers: [if any]
+
+## Key Decisions (keep only important ones)
+- [decision]: [brief reason]
+
+## Files Changed (keep recent only)
+- [file]: [change]
+
+## Next Steps
+- [from todo.md]
+\`\`\`
+</context_template>
+
+<cleanup_triggers>
+AFTER EACH UPDATE, CHECK:
+1. Is this info still needed for FUTURE tasks? No \u2192 DELETE
+2. Is this now implemented in code? Yes \u2192 SUMMARIZE to reference
+3. Is context.md > 150 lines? Yes \u2192 COMPRESS
+4. Is any doc > 7 days old and unused? Yes \u2192 ARCHIVE
+
+DELETE IMMEDIATELY:
+- Debugging logs after fix
+- Old iteration attempts
+- Research for completed features
+- Temporary notes
+</cleanup_triggers>
 
 <output>
-UPDATED: .opencode/todo.md
-- [x] T[N] marked complete
-Status: [X/Y done]
-Next: T[M] for ${AGENT_NAMES.BUILDER}
+CONTEXT UPDATED:
+Phase: [EARLY/BUILDING/FINISHING]
+todo.md: [X/Y done]
+context.md: [before \u2192 after lines]
+Action: [summarized/archived/kept]
+Next: [task for team]
 </output>`,
   canWrite: true,
   canBash: true
@@ -612,10 +663,29 @@ Retrieved: [date]
 \`\`\`
 </doc_format>
 
+<doc_lifecycle>
+DOCS HAVE EXPIRY:
+
+WHEN SAVING:
+- Include "Expires: [when this is no longer needed]"
+- Example: "Expires: after T3 complete"
+
+WHEN FEATURE IS DONE:
+- Docs can be SUMMARIZED to 5-10 lines
+- Or DELETED if fully implemented in code
+- Team references code, not old docs
+
+KEEP DOCS LEAN:
+- Only current, needed documentation
+- Archive old: mv to .opencode/archive/docs/
+- Delete: outdated versions
+</doc_lifecycle>
+
 <output>
 QUERY: [question]
 SEARCHED: [official sources]
 SAVED: .opencode/docs/[file].md
+EXPIRES: [when no longer needed]
 SUMMARY: [key findings]
 
 Team can now reference .opencode/docs/[file].md
@@ -14466,180 +14536,11 @@ var TaskCleaner = class {
   }
 };
 
-// src/shared/event-types.ts
-var TASK_EVENTS = {
-  STARTED: "task.started",
-  COMPLETED: "task.completed",
-  FAILED: "task.failed",
-  CANCELLED: "task.cancelled"
-};
-var TODO_EVENTS = {
-  CREATED: "todo.created",
-  UPDATED: "todo.updated",
-  COMPLETED: "todo.completed"
-};
+// src/core/agents/manager/event-handler.ts
 var SESSION_EVENTS = {
   IDLE: "session.idle",
-  BUSY: "session.busy",
-  ERROR: "session.error",
   DELETED: "session.deleted"
 };
-var DOCUMENT_EVENTS = {
-  CACHED: "document.cached",
-  EXPIRED: "document.expired"
-};
-var MISSION_EVENTS = {
-  COMPLETE: "mission.complete",
-  FAILED: "mission.failed",
-  ALL_TASKS_COMPLETE: "all_tasks.complete"
-};
-var SPECIAL_EVENTS = {
-  WILDCARD: "*"
-};
-var EVENT_TYPES = {
-  ...TASK_EVENTS,
-  ...TODO_EVENTS,
-  ...SESSION_EVENTS,
-  ...DOCUMENT_EVENTS,
-  ...MISSION_EVENTS,
-  ...SPECIAL_EVENTS
-};
-
-// src/core/bus/event-bus.ts
-var EventBusImpl = class {
-  subscriptions = /* @__PURE__ */ new Map();
-  eventHistory = [];
-  maxHistorySize = 100;
-  subscriptionCounter = 0;
-  /**
-   * Subscribe to an event type
-   * Returns unsubscribe function
-   */
-  subscribe(type, handler) {
-    const id = `sub_${++this.subscriptionCounter}`;
-    const subscription = { id, type, handler, once: false };
-    const existing = this.subscriptions.get(type) || [];
-    existing.push(subscription);
-    this.subscriptions.set(type, existing);
-    return () => this.unsubscribe(id, type);
-  }
-  /**
-   * Subscribe to an event type, auto-unsubscribe after first event
-   */
-  once(type, handler) {
-    const id = `sub_${++this.subscriptionCounter}`;
-    const subscription = { id, type, handler, once: true };
-    const existing = this.subscriptions.get(type) || [];
-    existing.push(subscription);
-    this.subscriptions.set(type, existing);
-    return () => this.unsubscribe(id, type);
-  }
-  /**
-   * Unsubscribe from an event
-   */
-  unsubscribe(id, type) {
-    const subs = this.subscriptions.get(type);
-    if (subs) {
-      const filtered = subs.filter((s) => s.id !== id);
-      if (filtered.length > 0) {
-        this.subscriptions.set(type, filtered);
-      } else {
-        this.subscriptions.delete(type);
-      }
-    }
-  }
-  /**
-   * Publish an event
-   */
-  async publish(type, properties = {}, options = {}) {
-    const event = {
-      type,
-      timestamp: /* @__PURE__ */ new Date(),
-      source: options.source || "unknown",
-      sessionId: options.sessionId,
-      properties
-    };
-    this.eventHistory.push(event);
-    if (this.eventHistory.length > this.maxHistorySize) {
-      this.eventHistory.shift();
-    }
-    const toNotify = [];
-    const typeSubs = this.subscriptions.get(type) || [];
-    toNotify.push(...typeSubs);
-    const wildcardSubs = this.subscriptions.get(SPECIAL_EVENTS.WILDCARD) || [];
-    toNotify.push(...wildcardSubs);
-    const toRemove = [];
-    for (const sub of toNotify) {
-      try {
-        await sub.handler(event);
-      } catch (error45) {
-        console.error(`[EventBus] Handler error for ${type}:`, error45);
-      }
-      if (sub.once) {
-        toRemove.push({ id: sub.id, type: sub.type });
-      }
-    }
-    for (const { id, type: t } of toRemove) {
-      this.unsubscribe(id, t);
-    }
-  }
-  /**
-   * Emit (alias for publish, sync-looking API)
-   */
-  emit(type, properties = {}) {
-    this.publish(type, properties).catch(console.error);
-  }
-  /**
-   * Get recent event history
-   */
-  getHistory(type, limit = 20) {
-    let events = this.eventHistory;
-    if (type && type !== SPECIAL_EVENTS.WILDCARD) {
-      events = events.filter((e) => e.type === type);
-    }
-    return events.slice(-limit);
-  }
-  /**
-   * Clear all subscriptions
-   */
-  clear() {
-    this.subscriptions.clear();
-    this.eventHistory = [];
-  }
-  /**
-   * Get subscription count
-   */
-  getSubscriptionCount() {
-    let count = 0;
-    for (const subs of this.subscriptions.values()) {
-      count += subs.length;
-    }
-    return count;
-  }
-  /**
-   * Wait for a specific event (Promise-based)
-   */
-  waitFor(type, timeout = 3e4) {
-    return new Promise((resolve, reject) => {
-      const timer = setTimeout(() => {
-        unsubscribe();
-        reject(new Error(`Timeout waiting for event: ${type}`));
-      }, timeout);
-      const unsubscribe = this.once(type, (event) => {
-        clearTimeout(timer);
-        resolve(event);
-      });
-    });
-  }
-};
-
-// src/core/bus/index.ts
-var EventBus = new EventBusImpl();
-function emit(type, properties) {
-  EventBus.emit(type, properties);
-}
-
-// src/core/agents/manager/event-handler.ts
 var EventHandler = class {
   constructor(client, store, concurrency, findBySession, notifyParentIfAllComplete, scheduleCleanup, validateSessionHasOutput) {
     this.client = client;
@@ -16009,40 +15910,6 @@ ${r.content}
   }
 });
 
-// src/core/notification/event-integration.ts
-function enableAutoToasts() {
-  const unsubscribers = [];
-  unsubscribers.push(EventBus.subscribe(TASK_EVENTS.STARTED, (event) => {
-    const { taskId, agent } = event.properties;
-    presets.taskStarted(taskId, agent);
-  }));
-  unsubscribers.push(EventBus.subscribe(TASK_EVENTS.COMPLETED, (event) => {
-    const { taskId, agent } = event.properties;
-    presets.taskCompleted(taskId, agent);
-  }));
-  unsubscribers.push(EventBus.subscribe(TASK_EVENTS.FAILED, (event) => {
-    const { taskId, error: error45 } = event.properties;
-    presets.taskFailed(taskId, error45);
-  }));
-  unsubscribers.push(EventBus.subscribe(MISSION_EVENTS.ALL_TASKS_COMPLETE, (event) => {
-    const { count } = event.properties;
-    presets.allTasksComplete(count);
-  }));
-  unsubscribers.push(EventBus.subscribe(MISSION_EVENTS.COMPLETE, (event) => {
-    const { summary } = event.properties;
-    presets.missionComplete(summary);
-  }));
-  unsubscribers.push(EventBus.subscribe(DOCUMENT_EVENTS.CACHED, (event) => {
-    const { filename } = event.properties;
-    presets.documentCached(filename);
-  }));
-  return () => {
-    for (const unsub of unsubscribers) {
-      unsub();
-    }
-  };
-}
-
 // src/core/progress/store.ts
 var progressHistory = /* @__PURE__ */ new Map();
 var sessionStartTimes = /* @__PURE__ */ new Map();
@@ -16164,7 +16031,6 @@ var OrchestratorPlugin = async (input) => {
   console.log(`[orchestrator] Log file: ${getLogPath()}`);
   log2("[index.ts] Plugin initialized", { version: PLUGIN_VERSION, directory });
   initToastClient(client);
-  const disableAutoToasts = enableAutoToasts();
   log2("[index.ts] Toast notifications enabled with TUI");
   const sessions = /* @__PURE__ */ new Map();
   const parallelAgentManager2 = ParallelAgentManager.getInstance(client, directory);
@@ -16307,7 +16173,7 @@ var OrchestratorPlugin = async (input) => {
         log2("[index.ts] event: session.created", { sessionID });
         presets.missionStarted(`Session ${sessionID.slice(0, 12)}...`);
       }
-      if (event.type === "session.deleted" || event.type === SESSION_EVENTS.DELETED) {
+      if (event.type === "session.deleted") {
         const sessionID = event.properties?.id || event.properties?.info?.id || "";
         const session = sessions.get(sessionID);
         if (session) {
@@ -16364,11 +16230,7 @@ var OrchestratorPlugin = async (input) => {
             anomalyCount: 0
           });
           startSession(sessionID);
-          emit(TASK_EVENTS.STARTED, {
-            taskId: sessionID,
-            agent: AGENT_NAMES.COMMANDER,
-            description: "Mission started"
-          });
+          presets.taskStarted(sessionID, AGENT_NAMES.COMMANDER);
         }
         if (!parsed || parsed.command !== "task") {
           const taskTemplate = COMMANDS["task"].template;
@@ -16527,10 +16389,7 @@ Anomaly count: ${stateSession.anomalyCount}
       if (textContent.includes(MISSION.COMPLETE) || textContent.includes(MISSION.COMPLETE_TEXT)) {
         session.active = false;
         state.missionActive = false;
-        emit(MISSION_EVENTS.COMPLETE, {
-          sessionId: sessionID,
-          summary: "Mission completed successfully"
-        });
+        presets.missionComplete("Mission completed successfully");
         clearSession(sessionID);
         sessions.delete(sessionID);
         state.sessions.delete(sessionID);
@@ -16539,10 +16398,7 @@ Anomaly count: ${stateSession.anomalyCount}
       if (textContent.includes(MISSION.STOP_COMMAND) || textContent.includes(MISSION.CANCEL_COMMAND)) {
         session.active = false;
         state.missionActive = false;
-        emit(TASK_EVENTS.FAILED, {
-          taskId: sessionID,
-          error: "Cancelled by user"
-        });
+        presets.taskFailed(sessionID, "Cancelled by user");
         clearSession(sessionID);
         sessions.delete(sessionID);
         state.sessions.delete(sessionID);

package/package.json

@@ -2,7 +2,7 @@
   "name": "opencode-orchestrator",
   "displayName": "OpenCode Orchestrator",
   "description": "Distributed Cognitive Architecture for OpenCode. Turns simple prompts into specialized multi-agent workflows (Planner, Coder, Reviewer).",
-  "version": "0.6.20",
+  "version": "0.6.22",
   "author": "agnusdei1207",
   "license": "MIT",
   "repository": {

package/dist/core/bus/event-bus.d.ts

@@ -1,53 +0,0 @@
-/**
- * Event Bus Implementation
- *
- * Core pub/sub system for communication between sessions and agents
- */
-import type { EventType } from "./types.js";
-import type { BusEvent, EventHandler } from "./interfaces.js";
-export declare class EventBusImpl {
-    private subscriptions;
-    private eventHistory;
-    private maxHistorySize;
-    private subscriptionCounter;
-    /**
-     * Subscribe to an event type
-     * Returns unsubscribe function
-     */
-    subscribe(type: EventType, handler: EventHandler): () => void;
-    /**
-     * Subscribe to an event type, auto-unsubscribe after first event
-     */
-    once(type: EventType, handler: EventHandler): () => void;
-    /**
-     * Unsubscribe from an event
-     */
-    private unsubscribe;
-    /**
-     * Publish an event
-     */
-    publish(type: EventType, properties?: Record<string, unknown>, options?: {
-        source?: string;
-        sessionId?: string;
-    }): Promise<void>;
-    /**
-     * Emit (alias for publish, sync-looking API)
-     */
-    emit(type: EventType, properties?: Record<string, unknown>): void;
-    /**
-     * Get recent event history
-     */
-    getHistory(type?: EventType, limit?: number): BusEvent[];
-    /**
-     * Clear all subscriptions
-     */
-    clear(): void;
-    /**
-     * Get subscription count
-     */
-    getSubscriptionCount(): number;
-    /**
-     * Wait for a specific event (Promise-based)
-     */
-    waitFor(type: EventType, timeout?: number): Promise<BusEvent>;
-}

package/dist/core/bus/index.d.ts

@@ -1,19 +0,0 @@
-/**
- * Event Bus System
- *
- * Pub/Sub system for communication between sessions and agents
- * Enables loose coupling and async event handling
- */
-export type { EventType, EventProperties } from "./types.js";
-export type { BusEvent, EventHandler, Subscription, PublishOptions } from "./interfaces.js";
-export { EVENT_TYPES, TASK_EVENTS, TODO_EVENTS, SESSION_EVENTS, DOCUMENT_EVENTS, MISSION_EVENTS, SPECIAL_EVENTS, } from "../../shared/event-types.js";
-import { EventBusImpl } from "./event-bus.js";
-import type { EventType, EventProperties } from "./types.js";
-import type { EventHandler } from "./interfaces.js";
-export declare const EventBus: EventBusImpl;
-export declare function subscribe(type: EventType, handler: EventHandler): () => void;
-export declare function publish(type: EventType, properties?: EventProperties, options?: {
-    source?: string;
-    sessionId?: string;
-}): Promise<void>;
-export declare function emit(type: EventType, properties?: EventProperties): void;

package/dist/core/bus/interfaces.d.ts

@@ -1,34 +0,0 @@
-/**
- * Event Bus Interfaces
- */
-import type { EventType, EventProperties } from "./types.js";
-/**
- * Event payload structure
- */
-export interface BusEvent {
-    type: EventType;
-    timestamp: Date;
-    source: string;
-    sessionId?: string;
-    properties: EventProperties;
-}
-/**
- * Event handler function signature
- */
-export type EventHandler = (event: BusEvent) => void | Promise<void>;
-/**
- * Internal subscription record
- */
-export interface Subscription {
-    id: string;
-    type: EventType;
-    handler: EventHandler;
-    once: boolean;
-}
-/**
- * Publish options
- */
-export interface PublishOptions {
-    source?: string;
-    sessionId?: string;
-}

package/dist/core/bus/types.d.ts

@@ -1,12 +0,0 @@
-/**
- * Event Bus Types (Type Aliases Only)
- */
-import type { EventTypeValue } from "../../shared/event-types.js";
-/**
- * Event type - allows constants or custom strings
- */
-export type EventType = EventTypeValue | (string & {});
-/**
- * Properties payload for events
- */
-export type EventProperties = Record<string, unknown>;

package/dist/core/notification/event-integration.d.ts

@@ -1,7 +0,0 @@
-/**
- * Event Bus Integration - Auto-subscribe to events
- */
-/**
- * Auto-subscribe to events and show toasts
- */
-export declare function enableAutoToasts(): () => void;