@royalcat/opencode-dcp-rc 0.0.0-stage → 4.0.1

package/lib/v2/index.ts

@@ -0,0 +1,448 @@
+import type { Plugin } from "@opencode/plugin"
+import { tool, type ToolDefinition } from "@opencode-ai/plugin"
+import { getConfig } from "../config"
+import { Logger } from "../logger"
+import { PromptStore } from "../prompts/store"
+import { createRcCompressTool } from "../compress"
+import { extractSummaryCallId, hasSummaryMarker } from "../compress/summary"
+import { attachCompressionDuration } from "../compress/state"
+import {
+    createCompressionUsageTracker,
+    installCompressionUsageHook,
+    installHttpUsageHook,
+} from "./usage"
+import { createCommandExecuteHandler, createSystemPromptHandler } from "../hooks"
+import {
+    createSessionState,
+    ensureSessionInitialized,
+    checkSession,
+    saveSessionState,
+    syncToolCache,
+    type SessionState,
+} from "../state"
+import { assignMessageRefs } from "../message-ids"
+import { applyPendingManualTrigger } from "../commands/manual"
+import {
+    buildToolIdList,
+    injectCompressNudges,
+    injectMessageIds,
+    injectExtendedSubAgentResults,
+    prune,
+    stripHallucinations,
+    syncCompressionBlocks,
+} from "../messages"
+import { countTokens } from "../token-utils"
+import { matchesGlob } from "../protected-patterns"
+import { history, project } from "./messages"
+import { analyzeContextTokens } from "../commands/context"
+import { buildStatsReport } from "../commands/stats"
+import { rpc } from "./rpc"
+
+// Extension point for future model-invisible V2 reports. Never use synthetic()
+// here: its text would enter the model's context, unlike V1 ignored messages.
+export async function report(logger: Logger, text: string, sessionID?: string) {
+    logger.debug("V2 report (display pending)", { sessionID, text })
+}
+
+export async function setup(ctx: Plugin.Context) {
+    const warnings = {
+        tui: {
+            showToast: async (input: { body: { message: string } }) => {
+                console.warn(`DCP: ${input.body.message}`)
+            },
+        },
+    }
+    const config = getConfig({ directory: ctx.location.directory, client: warnings })
+    if (!config.enabled) {
+        await ctx.rpc.register(
+            { ...rpc, methods: { status: rpc.methods.status } },
+            { status: async () => ({ enabled: false }) },
+        )
+        return
+    }
+    const logger = new Logger(config.debug)
+    const usageTracker = createCompressionUsageTracker()
+    await installCompressionUsageHook(ctx, usageTracker, logger)
+    await installHttpUsageHook(ctx, usageTracker, logger)
+    const prompts = new PromptStore(
+        logger,
+        ctx.location.directory,
+        config.experimental.customPrompts,
+        "compact",
+    )
+    const sessions = new Map<string, SessionState>()
+    const queues = new Map<string, Promise<unknown>>()
+    const limits = new Map<string, number>()
+    const aliases: Record<string, string> = {
+        task: "subagent",
+        bash: "shell",
+        apply_patch: "patch",
+    }
+    for (const list of [
+        config.compress.protectedTools,
+        config.commands.protectedTools,
+        config.strategies.deduplication.protectedTools,
+        config.strategies.purgeErrors.protectedTools,
+    ]) {
+        for (const name of [...list])
+            if (aliases[name] && !list.includes(aliases[name]!)) list.push(aliases[name]!)
+    }
+
+    function serial<T>(sessionID: string, operation: () => Promise<T>): Promise<T> {
+        const pending = (queues.get(sessionID) ?? Promise.resolve()).catch(() => {}).then(operation)
+        queues.set(sessionID, pending)
+        void pending
+            .finally(() => {
+                if (queues.get(sessionID) === pending) queues.delete(sessionID)
+            })
+            .catch(() => {})
+        return pending
+    }
+
+    const client = {
+        session: {
+            get: async ({ path }: { path: { id: string } }) => ({
+                data: await ctx.session.get({ sessionID: path.id }),
+            }),
+            messages: async ({ path }: { path: { id: string } }) => {
+                const [entries, session] = await Promise.all([
+                    ctx.session.context({ sessionID: path.id }),
+                    ctx.session.get({ sessionID: path.id }),
+                ])
+                return { data: history(entries, session) }
+            },
+            prompt: async (input: {
+                path: { id: string }
+                body: { parts: Array<{ text: string }> }
+            }) =>
+                report(logger, input.body.parts.map((part) => part.text).join("\n"), input.path.id),
+        },
+        tui: {
+            showToast: async (input: { body: { message: string } }) =>
+                report(logger, input.body.message),
+        },
+    }
+
+    async function load(sessionID: string, agentID?: string) {
+        const [session, entries] = await Promise.all([
+            ctx.session.get({ sessionID }),
+            ctx.session.context({ sessionID }),
+        ])
+        const selected =
+            agentID ??
+            session.agent ??
+            entries.findLast((entry) => entry.type === "assistant")?.agent
+        if (!selected) throw new Error("DCP commands require a session with a selected agent")
+        const { data: agent } = await ctx.agent.get({ agentID: selected })
+        let state = sessions.get(sessionID)
+        if (!state) {
+            state = createSessionState("compact")
+            sessions.set(sessionID, state)
+        }
+        const messages = history(entries, session)
+        await ensureSessionInitialized(
+            client,
+            state,
+            sessionID,
+            logger,
+            messages,
+            config.manualMode.enabled,
+        )
+        await checkSession(client, state, logger, messages, config.manualMode.enabled)
+        const rule = [...agent.permissions, ...(session.permissions ?? [])].findLast(
+            (rule) => matchesGlob("compress", rule.action) && matchesGlob("*", rule.resource),
+        )
+        state.compressPermission =
+            config.compress.permission === "deny"
+                ? "deny"
+                : rule?.effect === "deny"
+                  ? "deny"
+                  : config.compress.permission === "ask" || rule?.effect === "ask"
+                    ? "ask"
+                    : "allow"
+        return { state, entries, session, messages }
+    }
+
+    function allowed(state: SessionState) {
+        if (state.isSubAgent && !config.experimental.allowSubAgents)
+            throw new Error("DCP compression is disabled in subagents")
+        if (state.compressPermission === "deny") throw new Error("DCP compression is denied")
+        if (state.compressPermission === "ask")
+            throw new Error(
+                "DCP: compress permission 'ask' is not supported by OpenCode V2's public plugin API yet. Compression was not performed.",
+            )
+    }
+
+    await ctx.model.transform((editor) => {
+        limits.clear()
+        for (const model of editor.list())
+            limits.set(`${model.providerID}/${model.id}`, model.limit.context)
+    })
+    for (const kind of ["context", "compaction"] as const)
+        await ctx.session.hook(kind, (event) =>
+            serial(event.sessionID, async () => {
+                const { state, entries, session, messages } = await load(
+                    event.sessionID,
+                    event.agent,
+                )
+                if (state.isSubAgent && !config.experimental.allowSubAgents) {
+                    delete event.tools.compress
+                    return
+                }
+                if (state.compressPermission === "deny") delete event.tools.compress
+                state.modelContextLimit = limits.get(`${event.model.providerID}/${event.model.id}`)
+                state.systemPromptTokens = countTokens(
+                    event.system.map((part) => part.text).join("\n"),
+                )
+                const view = project(event.messages, entries, {
+                    ...session,
+                    agent: event.agent,
+                    model: event.model,
+                })
+                stripHallucinations(view.messages, state.idFormat)
+                assignMessageRefs(state, view.messages)
+                // Compaction may select only a prefix; block origins can be in the retained tail.
+                syncCompressionBlocks(state, logger, messages)
+                syncToolCache(state, config, logger, view.messages)
+                buildToolIdList(state, view.messages)
+                prune(state, logger, view.messages, view.summaryBase)
+                await injectExtendedSubAgentResults(
+                    client,
+                    state,
+                    logger,
+                    view.messages,
+                    config.experimental.allowSubAgents,
+                )
+                prompts.reload()
+                injectCompressNudges(
+                    state,
+                    config,
+                    logger,
+                    view.messages,
+                    prompts.getRuntimePrompts(),
+                    kind === "context",
+                )
+                injectMessageIds(state, config, view.messages)
+                applyPendingManualTrigger(state, view.messages, logger)
+                event.messages = view.restore()
+                const system = { system: event.system.map((part) => part.text) }
+                await createSystemPromptHandler(
+                    state,
+                    logger,
+                    config,
+                    prompts,
+                )(
+                    {
+                        sessionID: event.sessionID,
+                        model: { limit: { context: state.modelContextLimit ?? 0 } },
+                    },
+                    system,
+                )
+                event.system = system.system.map((text, index) => ({
+                    ...event.system[index],
+                    type: "text",
+                    text,
+                }))
+                await logger.saveContext(event.sessionID, view.messages)
+            }),
+        )
+
+    // Hidden summary generation for rc mode: when our marker is present, drop
+    // the session context and every tool so the transient request contains
+    // only the prompt we built. This keeps the summarization request invisible
+    // and independent of any injected metadata.
+    await ctx.session.hook("generate", (event) => {
+        const own = event.messages.filter(
+            (message) =>
+                Array.isArray(message.content) &&
+                message.content.some(
+                    (part: any) =>
+                        part?.type === "text" &&
+                        typeof part.text === "string" &&
+                        hasSummaryMarker(part.text),
+                ),
+        )
+        if (own.length === 0) {
+            return
+        }
+        event.messages = own as typeof event.messages
+        for (const name of Object.keys(event.tools ?? {})) {
+            delete (event.tools as Record<string, unknown>)[name]
+        }
+
+        // Local fallback estimate of the request input, used only when the
+        // provider usage cannot be captured from the language model wrapper.
+        const callId = own
+            .flatMap((message) =>
+                Array.isArray(message.content) ? (message.content as any[]) : [],
+            )
+            .filter((part) => part?.type === "text" && typeof part.text === "string")
+            .map((part) => extractSummaryCallId(part.text))
+            .find((id): id is string => !!id)
+        if (callId) {
+            const texts: string[] = []
+            for (const part of event.system ?? []) {
+                if (typeof (part as any)?.text === "string") {
+                    texts.push((part as any).text)
+                }
+            }
+            for (const message of own) {
+                for (const part of (message.content as any[]) ?? []) {
+                    if (part?.type === "text" && typeof part.text === "string") {
+                        texts.push(part.text)
+                    }
+                }
+            }
+            usageTracker.recordEstimatedInput(callId, countTokens(texts.join("\n")))
+        }
+    })
+
+    if (config.compress.permission !== "deny") {
+        const define = (state: SessionState): ToolDefinition => {
+            const context = {
+                client,
+                state,
+                logger,
+                config,
+                prompts,
+                generate: async (input: { sessionID: string; prompt: string; callId?: string }) => {
+                    try {
+                        const result = await ctx.session.generate({
+                            sessionID: input.sessionID,
+                            prompt: input.prompt,
+                        })
+                        const text = result?.text ?? ""
+                        const usage = input.callId
+                            ? usageTracker.resolve(input.callId, text)
+                            : undefined
+                        return { text, usage }
+                    } finally {
+                        if (input.callId) {
+                            usageTracker.discard(input.callId)
+                        }
+                    }
+                },
+            }
+            return createRcCompressTool(context)
+        }
+        const definition = define(createSessionState("compact"))
+        await ctx.tool.transform((editor) =>
+            editor.add({
+                name: "compress",
+                description: definition.description,
+                input: tool.schema.object(definition.args),
+                options: { codemode: false, permission: "compress" },
+                execute: (input, context) =>
+                    serial(context.sessionID, async () => {
+                        const { state } = await load(context.sessionID, context.agent)
+                        allowed(state)
+                        const started = Date.now()
+                        const legacy = define(state)
+                        const content = await legacy.execute(input, {
+                            sessionID: context.sessionID,
+                            messageID: context.messageID,
+                            callID: context.id,
+                            agent: context.agent,
+                            directory: ctx.location.directory,
+                            worktree: ctx.location.directory,
+                            abort: new AbortController().signal,
+                            ask: async () => allowed(state),
+                            metadata: ({ title }: { title?: string }) => {
+                                void context.progress({ title })
+                            },
+                        } as Parameters<typeof legacy.execute>[1])
+                        attachCompressionDuration(
+                            state.prune.messages,
+                            context.messageID,
+                            context.id,
+                            Date.now() - started,
+                        )
+                        await saveSessionState(state, logger)
+                        // The rc executor returns the tool result text.
+                        return { content: content as string }
+                    }),
+            }),
+        )
+    }
+    if (config.commands.enabled)
+        await ctx.command.transform((editor) => {
+            for (const name of ["dcp", "dcp-compress"])
+                editor.add({
+                    name,
+                    description: name === "dcp" ? "DCP commands" : "Trigger DCP manual compression",
+                    execute: async (invocation) => {
+                        const prompt = await serial(invocation.sessionID, async () => {
+                            const { state } = await load(invocation.sessionID)
+                            const permission =
+                                state.compressPermission ?? config.compress.permission
+                            if (
+                                name === "dcp-compress" ||
+                                invocation.prompt.text.trim().split(/\s+/)[0] === "compress"
+                            )
+                                allowed(state)
+                            const output = { parts: [] }
+                            await createCommandExecuteHandler(
+                                client,
+                                state,
+                                logger,
+                                config,
+                                ctx.location.directory,
+                            )(
+                                {
+                                    command: name,
+                                    sessionID: invocation.sessionID,
+                                    arguments: invocation.prompt.text,
+                                },
+                                output,
+                            )
+                            state.compressPermission = permission
+                            const pending = state.pendingManualTrigger
+                            if (!pending) return
+                            allowed(state)
+                            state.pendingManualTrigger = null
+                            return pending.prompt
+                        })
+                        if (prompt)
+                            await ctx.session.prompt({
+                                sessionID: invocation.sessionID,
+                                text: prompt,
+                                delivery: invocation.delivery,
+                            })
+                    },
+                })
+        })
+    await ctx.rpc.register(rpc, {
+        status: async () => ({ enabled: config.commands.enabled }),
+        snapshot: ({ sessionID }) =>
+            serial(sessionID, async () => {
+                const { state, messages } = await load(sessionID)
+                syncCompressionBlocks(state, logger, messages)
+                return {
+                    manualMode: !!state.manualMode,
+                    canCompress:
+                        state.compressPermission === "allow" &&
+                        (!state.isSubAgent || config.experimental.allowSubAgents),
+                    ...(state.compressPermission === "ask"
+                        ? {
+                              blockedReason:
+                                  "Permission 'ask' is not supported by the V2 plugin API yet.",
+                          }
+                        : {}),
+                    context: analyzeContextTokens(state, messages),
+                    stats: await buildStatsReport(state, logger),
+                }
+            }),
+        manual: ({ sessionID, enabled }) =>
+            serial(sessionID, async () => {
+                const { state } = await load(sessionID)
+                state.manualMode = enabled ? "active" : false
+                await saveSessionState(state, logger)
+                return {}
+            }),
+    })
+    logger.info("DCP V2 initialized")
+    return () => {
+        sessions.clear()
+        limits.clear()
+    }
+}