@doingdev/opencode-claude-manager-plugin 0.1.21 → 0.1.25

package/dist/types/contracts.d.ts

@@ -0,0 +1,215 @@
+export interface ManagerPromptRegistry {
+    managerSystemPrompt: string;
+    claudeCodeSessionPrompt: string;
+    modePrefixes: {
+        plan: string;
+        free: string;
+    };
+    contextWarnings: {
+        moderate: string;
+        high: string;
+        critical: string;
+    };
+}
+export type ClaudeSettingSource = 'user' | 'project' | 'local';
+export type SessionMode = 'plan' | 'free';
+export interface ClaudeCommandMetadata {
+    name: string;
+    description: string;
+    argumentHint?: string;
+    source: 'sdk' | 'skill' | 'command';
+    path?: string;
+}
+export interface ClaudeSkillMetadata {
+    name: string;
+    description: string;
+    path: string;
+    source: 'skill' | 'command';
+}
+export interface ClaudeHookMetadata {
+    name: string;
+    matcher?: string;
+    sourcePath: string;
+    commandCount: number;
+}
+export interface ClaudeAgentMetadata {
+    name: string;
+    description: string;
+    model?: string;
+    source: 'sdk' | 'filesystem';
+}
+export interface ClaudeMetadataSnapshot {
+    collectedAt: string;
+    cwd: string;
+    commands: ClaudeCommandMetadata[];
+    skills: ClaudeSkillMetadata[];
+    hooks: ClaudeHookMetadata[];
+    agents: ClaudeAgentMetadata[];
+    claudeMdPath?: string;
+    settingsPaths: string[];
+}
+export interface ClaudeSessionEvent {
+    type: 'init' | 'assistant' | 'partial' | 'user' | 'tool_call' | 'tool_progress' | 'tool_summary' | 'status' | 'system' | 'result' | 'error';
+    sessionId?: string;
+    text: string;
+    turns?: number;
+    totalCostUsd?: number;
+    /** Present on live SDK-normalized events; omitted when compact-persisted to save space. */
+    rawType?: string;
+}
+export interface RunClaudeSessionInput {
+    cwd: string;
+    prompt: string;
+    systemPrompt?: string;
+    model?: string;
+    effort?: 'low' | 'medium' | 'high' | 'max';
+    mode?: SessionMode;
+    permissionMode?: 'default' | 'acceptEdits' | 'plan' | 'dontAsk';
+    /** Merged with `Skill` by the SDK adapter unless `Skill` appears in `disallowedTools`. */
+    allowedTools?: string[];
+    disallowedTools?: string[];
+    continueSession?: boolean;
+    resumeSessionId?: string;
+    forkSession?: boolean;
+    persistSession?: boolean;
+    includePartialMessages?: boolean;
+    settingSources?: ClaudeSettingSource[];
+    maxTurns?: number;
+    abortSignal?: AbortSignal;
+}
+export interface ClaudeSessionRunResult {
+    sessionId?: string;
+    events: ClaudeSessionEvent[];
+    finalText: string;
+    turns?: number;
+    totalCostUsd?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    contextWindowSize?: number;
+}
+export interface ClaudeSessionSummary {
+    sessionId: string;
+    summary: string;
+    cwd?: string;
+    gitBranch?: string;
+    createdAt?: number;
+    lastModified: number;
+}
+export interface ClaudeSessionTranscriptMessage {
+    role: 'user' | 'assistant';
+    sessionId: string;
+    messageId: string;
+    text: string;
+}
+export interface ClaudeCapabilitySnapshot {
+    commands: ClaudeCommandMetadata[];
+    agents: ClaudeAgentMetadata[];
+    models: string[];
+}
+export type ContextWarningLevel = 'ok' | 'moderate' | 'high' | 'critical';
+export interface SessionContextSnapshot {
+    sessionId: string | null;
+    totalTurns: number;
+    totalCostUsd: number;
+    latestInputTokens: number | null;
+    latestOutputTokens: number | null;
+    contextWindowSize: number | null;
+    estimatedContextPercent: number | null;
+    warningLevel: ContextWarningLevel;
+    compactionCount: number;
+}
+export interface GitDiffResult {
+    hasDiff: boolean;
+    diffText: string;
+    stats: {
+        filesChanged: number;
+        insertions: number;
+        deletions: number;
+    };
+}
+export interface GitOperationResult {
+    success: boolean;
+    output: string;
+    error?: string;
+}
+export interface ActiveSessionState {
+    sessionId: string;
+    cwd: string;
+    startedAt: string;
+    totalTurns: number;
+    totalCostUsd: number;
+    estimatedContextPercent: number | null;
+    contextWindowSize: number | null;
+    latestInputTokens: number | null;
+}
+export type PersistentRunStatus = 'running' | 'completed' | 'failed';
+export interface PersistentRunMessageRecord {
+    timestamp: string;
+    direction: 'sent' | 'received';
+    text: string;
+    turns?: number;
+    totalCostUsd?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+}
+export interface PersistentRunActionRecord {
+    timestamp: string;
+    type: 'git_diff' | 'git_commit' | 'git_reset' | 'compact' | 'clear';
+    result: string;
+}
+export interface PersistentRunRecord {
+    id: string;
+    cwd: string;
+    task: string;
+    status: PersistentRunStatus;
+    createdAt: string;
+    updatedAt: string;
+    sessionId: string | null;
+    sessionHistory: string[];
+    messages: PersistentRunMessageRecord[];
+    actions: PersistentRunActionRecord[];
+    commits: string[];
+    context: SessionContextSnapshot;
+    finalSummary?: string;
+}
+export interface PersistentRunResult {
+    run: PersistentRunRecord;
+}
+export interface LiveTailEvent {
+    type: 'line' | 'error' | 'end';
+    sessionId: string;
+    data?: unknown;
+    rawLine?: string;
+    error?: string;
+}
+export interface ToolOutputPreview {
+    toolUseId: string;
+    content: string;
+    isError: boolean;
+}
+export interface ToolApprovalRule {
+    id: string;
+    description?: string;
+    /** Tool name — exact match or glob with * wildcard */
+    toolPattern: string;
+    /** Optional substring match against JSON-serialized tool input */
+    inputPattern?: string;
+    action: 'allow' | 'deny';
+    denyMessage?: string;
+}
+export interface ToolApprovalPolicy {
+    rules: ToolApprovalRule[];
+    defaultAction: 'allow' | 'deny';
+    defaultDenyMessage?: string;
+    enabled: boolean;
+}
+export interface ToolApprovalDecision {
+    timestamp: string;
+    toolName: string;
+    inputPreview: string;
+    title?: string;
+    matchedRuleId: string;
+    action: 'allow' | 'deny';
+    denyMessage?: string;
+    agentId?: string;
+}

package/dist/types/contracts.js

@@ -0,0 +1 @@
+export {};

package/dist/util/fs-helpers.d.ts

@@ -0,0 +1,2 @@
+export declare function writeJsonAtomically(filePath: string, data: unknown): Promise<void>;
+export declare function isFileNotFoundError(error: unknown): error is NodeJS.ErrnoException;

package/dist/util/fs-helpers.js

@@ -0,0 +1,12 @@
+import { randomUUID } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+export async function writeJsonAtomically(filePath, data) {
+    const tempPath = `${filePath}.${randomUUID()}.tmp`;
+    await fs.writeFile(tempPath, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
+    await fs.rename(tempPath, filePath);
+}
+export function isFileNotFoundError(error) {
+    return (error instanceof Error &&
+        'code' in error &&
+        error.code === 'ENOENT');
+}

package/dist/util/transcript-append.d.ts

@@ -0,0 +1,7 @@
+import type { ClaudeSessionEvent } from '../types/contracts.js';
+export declare function stripTrailingPartials(events: ClaudeSessionEvent[]): ClaudeSessionEvent[];
+/**
+ * Append transcript events for run-state persistence: at most one trailing
+ * `partial`, dropped whenever a non-partial event is appended.
+ */
+export declare function appendTranscriptEvents(events: ClaudeSessionEvent[], incoming: ClaudeSessionEvent[]): ClaudeSessionEvent[];

package/dist/util/transcript-append.js

@@ -0,0 +1,29 @@
+export function stripTrailingPartials(events) {
+    let end = events.length;
+    while (end > 0 && events[end - 1].type === 'partial') {
+        end -= 1;
+    }
+    return end === events.length ? events : events.slice(0, end);
+}
+/**
+ * Append transcript events for run-state persistence: at most one trailing
+ * `partial`, dropped whenever a non-partial event is appended.
+ */
+export function appendTranscriptEvents(events, incoming) {
+    let next = events;
+    for (const event of incoming) {
+        if (event.type === 'partial') {
+            if (next.length > 0 && next[next.length - 1].type === 'partial') {
+                next = [...next.slice(0, -1), event];
+            }
+            else {
+                next = [...next, event];
+            }
+        }
+        else {
+            next = stripTrailingPartials(next);
+            next = [...next, event];
+        }
+    }
+    return next;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@doingdev/opencode-claude-manager-plugin",
-  "version": "0.1.21",
-  "description": "Thin OpenCode orchestrator plugin with Claude Code specialist subagents.",
+  "version": "0.1.25",
+  "description": "OpenCode plugin that orchestrates Claude Code sessions.",
   "keywords": [
     "opencode",
     "plugin",
@@ -29,7 +29,10 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "^1.2.27"
+    "@anthropic-ai/claude-agent-sdk": "^0.2.81",
+    "@opencode-ai/plugin": "^1.2.27",
+    "json5": "^2.2.3",
+    "zod": "^4.1.8"
   },
   "devDependencies": {
     "@eslint/js": "^9.22.0",