@doingdev/opencode-claude-manager-plugin 0.1.16 → 0.1.17

package/dist/claude/claude-agent-sdk-adapter.js

@@ -245,6 +245,36 @@ function normalizeSdkMessages(message, includePartials) {
     if (message.type === 'user') {
         return normalizeUserSdkMessage(message, sessionId);
     }
+    if (message.type === 'tool_progress') {
+        const toolName = 'tool_name' in message && typeof message.tool_name === 'string'
+            ? message.tool_name
+            : 'tool';
+        const elapsed = 'elapsed_time_seconds' in message &&
+            typeof message.elapsed_time_seconds === 'number'
+            ? message.elapsed_time_seconds
+            : 0;
+        return [
+            {
+                type: 'tool_progress',
+                sessionId,
+                text: JSON.stringify({ name: toolName, elapsed }),
+                rawType: message.type,
+            },
+        ];
+    }
+    if (message.type === 'tool_use_summary') {
+        const summary = 'summary' in message && typeof message.summary === 'string'
+            ? message.summary
+            : '';
+        return [
+            {
+                type: 'tool_summary',
+                sessionId,
+                text: summary,
+                rawType: message.type,
+            },
+        ];
+    }
     return [
         {
             type: 'system',

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import type { Plugin } from '@opencode-ai/plugin';
 import { ClaudeManagerPlugin } from './plugin/claude-manager.plugin.js';
-export type { ClaudeCapabilitySnapshot, ClaudeMetadataSnapshot, ClaudeSessionRunResult, ClaudeSessionSummary, ClaudeSessionTranscriptMessage, ManagerPromptRegistry, RunClaudeSessionInput, SessionContextSnapshot, GitDiffResult, GitOperationResult, PersistentRunRecord, PersistentRunResult, ActiveSessionState, ContextWarningLevel, LiveTailEvent, ToolOutputPreview, ToolApprovalRule, ToolApprovalPolicy, ToolApprovalDecision, } from './types/contracts.js';
+export type { ClaudeCapabilitySnapshot, ClaudeMetadataSnapshot, ClaudeSessionRunResult, ClaudeSessionSummary, ClaudeSessionTranscriptMessage, ManagerPromptRegistry, RunClaudeSessionInput, SessionContextSnapshot, GitDiffResult, GitOperationResult, PersistentRunRecord, PersistentRunResult, ActiveSessionState, ContextWarningLevel, SessionMode, LiveTailEvent, ToolOutputPreview, ToolApprovalRule, ToolApprovalPolicy, ToolApprovalDecision, } from './types/contracts.js';
 export { SessionLiveTailer } from './claude/session-live-tailer.js';
 export { ClaudeManagerPlugin };
 export declare const plugin: Plugin;

package/dist/manager/persistent-manager.d.ts

@@ -19,6 +19,7 @@ export declare class PersistentManager {
      */
     sendMessage(cwd: string, message: string, options?: {
         model?: string;
+        mode?: 'plan' | 'free';
         abortSignal?: AbortSignal;
     }, onEvent?: ClaudeSessionEventHandler): Promise<{
         sessionId: string | undefined;

package/dist/manager/session-controller.d.ts

@@ -1,12 +1,16 @@
 import type { ClaudeAgentSdkAdapter, ClaudeSessionEventHandler } from '../claude/claude-agent-sdk-adapter.js';
-import type { ClaudeSessionRunResult, SessionContextSnapshot } from '../types/contracts.js';
+import type { ClaudeSessionRunResult, SessionContextSnapshot, SessionMode } from '../types/contracts.js';
 import type { ContextTracker } from './context-tracker.js';
 export declare class SessionController {
     private readonly sdkAdapter;
     private readonly contextTracker;
     private readonly sessionPrompt;
+    private readonly modePrefixes;
     private activeSessionId;
-    constructor(sdkAdapter: ClaudeAgentSdkAdapter, contextTracker: ContextTracker, sessionPrompt: string);
+    constructor(sdkAdapter: ClaudeAgentSdkAdapter, contextTracker: ContextTracker, sessionPrompt: string, modePrefixes?: {
+        plan: string;
+        free: string;
+    });
     get isActive(): boolean;
     get sessionId(): string | null;
     /**
@@ -16,6 +20,7 @@ export declare class SessionController {
     sendMessage(cwd: string, message: string, options?: {
         model?: string;
         effort?: 'low' | 'medium' | 'high' | 'max';
+        mode?: SessionMode;
         settingSources?: Array<'user' | 'project' | 'local'>;
         abortSignal?: AbortSignal;
     }, onEvent?: ClaudeSessionEventHandler): Promise<ClaudeSessionRunResult>;

package/dist/manager/session-controller.js

@@ -5,11 +5,16 @@ export class SessionController {
     sdkAdapter;
     contextTracker;
     sessionPrompt;
+    modePrefixes;
     activeSessionId = null;
-    constructor(sdkAdapter, contextTracker, sessionPrompt) {
+    constructor(sdkAdapter, contextTracker, sessionPrompt, modePrefixes = {
+        plan: '',
+        free: '',
+    }) {
         this.sdkAdapter = sdkAdapter;
         this.contextTracker = contextTracker;
         this.sessionPrompt = sessionPrompt;
+        this.modePrefixes = modePrefixes;
     }
     get isActive() {
         return this.activeSessionId !== null;
@@ -22,11 +27,14 @@ export class SessionController {
      * Returns the session result including usage data.
      */
     async sendMessage(cwd, message, options, onEvent) {
+        const mode = options?.mode ?? 'free';
+        const prefix = this.modePrefixes[mode];
+        const prompt = prefix ? `${prefix}\n\n${message}` : message;
         const input = {
             cwd,
-            prompt: message,
+            prompt,
             persistSession: true,
-            permissionMode: 'acceptEdits',
+            permissionMode: mode === 'plan' ? 'plan' : 'acceptEdits',
             includePartialMessages: true,
             model: options?.model,
             effort: options?.effort,

package/dist/plugin/claude-manager.plugin.js

@@ -107,10 +107,13 @@ export const ClaudeManagerPlugin = async ({ worktree }) => {
             claude_manager_send: tool({
                 description: 'Send a message to the persistent Claude Code session. ' +
                     'Auto-creates a session on first call. Resumes the existing session on subsequent calls. ' +
-                    'Returns the assistant response and current context health snapshot.',
+                    'Returns the assistant response and current context health snapshot. ' +
+                    'Use mode "plan" for read-only investigation and planning (no edits), ' +
+                    'or "free" (default) for normal execution with edit permissions.',
                 args: {
                     message: tool.schema.string().min(1),
                     model: tool.schema.string().optional(),
+                    mode: tool.schema.enum(['plan', 'free']).default('free'),
                     cwd: tool.schema.string().optional(),
                 },
                 async execute(args, context) {
@@ -130,7 +133,7 @@ export const ClaudeManagerPlugin = async ({ worktree }) => {
                     });
                     let turnsSoFar = 0;
                     let costSoFar = 0;
-                    const result = await services.manager.sendMessage(cwd, args.message, { model: args.model, abortSignal: context.abort }, (event) => {
+                    const result = await services.manager.sendMessage(cwd, args.message, { model: args.model, mode: args.mode, abortSignal: context.abort }, (event) => {
                         if (event.turns !== undefined) {
                             turnsSoFar = event.turns;
                         }
@@ -189,6 +192,66 @@ export const ClaudeManagerPlugin = async ({ worktree }) => {
                                 },
                             });
                         }
+                        else if (event.type === 'user') {
+                            const preview = event.text.length > 200
+                                ? event.text.slice(0, 200) + '...'
+                                : event.text;
+                            context.metadata({
+                                title: `Claude Code: Tool result (${turnsSoFar} turns, ${costLabel})`,
+                                metadata: {
+                                    sessionId: event.sessionId,
+                                    type: event.type,
+                                    output: preview,
+                                },
+                            });
+                        }
+                        else if (event.type === 'tool_progress') {
+                            let toolName = 'tool';
+                            let elapsed = 0;
+                            try {
+                                const parsed = JSON.parse(event.text);
+                                toolName = parsed.name ?? 'tool';
+                                elapsed = parsed.elapsed ?? 0;
+                            }
+                            catch {
+                                // ignore
+                            }
+                            context.metadata({
+                                title: `Claude Code: ${toolName} running ${elapsed > 0 ? `(${elapsed.toFixed(0)}s)` : ''}... (${turnsSoFar} turns, ${costLabel})`,
+                                metadata: {
+                                    sessionId: event.sessionId,
+                                    type: event.type,
+                                    tool: toolName,
+                                    elapsed,
+                                },
+                            });
+                        }
+                        else if (event.type === 'tool_summary') {
+                            const summary = event.text.length > 200
+                                ? event.text.slice(0, 200) + '...'
+                                : event.text;
+                            context.metadata({
+                                title: `Claude Code: Tool done (${turnsSoFar} turns, ${costLabel})`,
+                                metadata: {
+                                    sessionId: event.sessionId,
+                                    type: event.type,
+                                    summary,
+                                },
+                            });
+                        }
+                        else if (event.type === 'partial') {
+                            const delta = event.text.length > 200
+                                ? event.text.slice(0, 200) + '...'
+                                : event.text;
+                            context.metadata({
+                                title: `Claude Code: Writing... (${turnsSoFar} turns, ${costLabel})`,
+                                metadata: {
+                                    sessionId: event.sessionId,
+                                    type: event.type,
+                                    delta,
+                                },
+                            });
+                        }
                         else if (event.type === 'error') {
                             context.metadata({
                                 title: `Claude Code: Error`,

package/dist/plugin/service-factory.js

@@ -22,7 +22,7 @@ export function getOrCreatePluginServices(worktree) {
     const metadataService = new ClaudeMetadataService(new RepoClaudeConfigReader(), sdkAdapter);
     const sessionService = new ClaudeSessionService(sdkAdapter, metadataService);
     const contextTracker = new ContextTracker();
-    const sessionController = new SessionController(sdkAdapter, contextTracker, managerPromptRegistry.claudeCodeSessionPrompt);
+    const sessionController = new SessionController(sdkAdapter, contextTracker, managerPromptRegistry.claudeCodeSessionPrompt, managerPromptRegistry.modePrefixes);
     const gitOps = new GitOperations(worktree);
     const stateStore = new FileRunStateStore();
     const transcriptStore = new TranscriptStore();

package/dist/prompts/registry.js

@@ -118,6 +118,16 @@ export const managerPromptRegistry = {
         '- Report blockers immediately with specifics: file, line, error message.',
         '- If a task is partially complete, state exactly what remains.',
     ].join('\n'),
+    modePrefixes: {
+        plan: [
+            '[PLAN MODE] You are in read-only planning mode. Do NOT create or edit any files.',
+            'Use read, grep, glob, and search tools only.',
+            'Analyze the codebase and produce a detailed implementation plan:',
+            'files to change, functions to modify, new files to create, test strategy,',
+            'and potential risks. End with a numbered step-by-step plan.',
+        ].join(' '),
+        free: '',
+    },
     contextWarnings: {
         moderate: 'Session context is filling up ({percent}% estimated). Consider whether a fresh session would be more efficient.',
         high: 'Session context is heavy ({percent}% estimated, {turns} turns, ${cost}). Start a new session or compact first.',

package/dist/types/contracts.d.ts

@@ -1,6 +1,10 @@
 export interface ManagerPromptRegistry {
     managerSystemPrompt: string;
     claudeCodeSessionPrompt: string;
+    modePrefixes: {
+        plan: string;
+        free: string;
+    };
     contextWarnings: {
         moderate: string;
         high: string;
@@ -8,6 +12,7 @@ export interface ManagerPromptRegistry {
     };
 }
 export type ClaudeSettingSource = 'user' | 'project' | 'local';
+export type SessionMode = 'plan' | 'free';
 export interface ClaudeCommandMetadata {
     name: string;
     description: string;
@@ -44,7 +49,7 @@ export interface ClaudeMetadataSnapshot {
     settingsPaths: string[];
 }
 export interface ClaudeSessionEvent {
-    type: 'init' | 'assistant' | 'partial' | 'user' | 'tool_call' | 'status' | 'system' | 'result' | 'error';
+    type: 'init' | 'assistant' | 'partial' | 'user' | 'tool_call' | 'tool_progress' | 'tool_summary' | 'status' | 'system' | 'result' | 'error';
     sessionId?: string;
     text: string;
     turns?: number;
@@ -58,6 +63,7 @@ export interface RunClaudeSessionInput {
     systemPrompt?: string;
     model?: string;
     effort?: 'low' | 'medium' | 'high' | 'max';
+    mode?: SessionMode;
     permissionMode?: 'default' | 'acceptEdits' | 'plan' | 'dontAsk';
     allowedTools?: string[];
     disallowedTools?: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doingdev/opencode-claude-manager-plugin",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "OpenCode plugin that orchestrates Claude Code sessions.",
   "keywords": [
     "opencode",