@dev4s/opencode-dcp 0.1.0

package/dist/lib/messages/utils.js

@@ -0,0 +1,124 @@
+import { isMessageCompacted } from "../shared-utils";
+const SYNTHETIC_MESSAGE_ID = "msg_01234567890123456789012345";
+const SYNTHETIC_PART_ID = "prt_01234567890123456789012345";
+export const createSyntheticUserMessage = (baseMessage, content) => {
+    const userInfo = baseMessage.info;
+    return {
+        info: {
+            id: SYNTHETIC_MESSAGE_ID,
+            sessionID: userInfo.sessionID,
+            role: "user",
+            time: { created: Date.now() },
+            agent: userInfo.agent || "code",
+            model: {
+                providerID: userInfo.model.providerID,
+                modelID: userInfo.model.modelID,
+            },
+        },
+        parts: [
+            {
+                id: SYNTHETIC_PART_ID,
+                sessionID: userInfo.sessionID,
+                messageID: SYNTHETIC_MESSAGE_ID,
+                type: "text",
+                text: content,
+            },
+        ],
+    };
+};
+/**
+ * Extracts a human-readable key from tool metadata for display purposes.
+ */
+export const extractParameterKey = (tool, parameters) => {
+    if (!parameters)
+        return "";
+    if (tool === "read" && parameters.filePath) {
+        const offset = parameters.offset;
+        const limit = parameters.limit;
+        if (offset !== undefined && limit !== undefined) {
+            return `${parameters.filePath} (lines ${offset}-${offset + limit})`;
+        }
+        if (offset !== undefined) {
+            return `${parameters.filePath} (lines ${offset}+)`;
+        }
+        if (limit !== undefined) {
+            return `${parameters.filePath} (lines 0-${limit})`;
+        }
+        return parameters.filePath;
+    }
+    if (tool === "write" && parameters.filePath) {
+        return parameters.filePath;
+    }
+    if (tool === "edit" && parameters.filePath) {
+        return parameters.filePath;
+    }
+    if (tool === "list") {
+        return parameters.path || "(current directory)";
+    }
+    if (tool === "glob") {
+        if (parameters.pattern) {
+            const pathInfo = parameters.path ? ` in ${parameters.path}` : "";
+            return `"${parameters.pattern}"${pathInfo}`;
+        }
+        return "(unknown pattern)";
+    }
+    if (tool === "grep") {
+        if (parameters.pattern) {
+            const pathInfo = parameters.path ? ` in ${parameters.path}` : "";
+            return `"${parameters.pattern}"${pathInfo}`;
+        }
+        return "(unknown pattern)";
+    }
+    if (tool === "bash") {
+        if (parameters.description)
+            return parameters.description;
+        if (parameters.command) {
+            return parameters.command.length > 50
+                ? parameters.command.substring(0, 50) + "..."
+                : parameters.command;
+        }
+    }
+    if (tool === "webfetch" && parameters.url) {
+        return parameters.url;
+    }
+    if (tool === "websearch" && parameters.query) {
+        return `"${parameters.query}"`;
+    }
+    if (tool === "codesearch" && parameters.query) {
+        return `"${parameters.query}"`;
+    }
+    if (tool === "todowrite") {
+        return `${parameters.todos?.length || 0} todos`;
+    }
+    if (tool === "todoread") {
+        return "read todo list";
+    }
+    if (tool === "task" && parameters.description) {
+        return parameters.description;
+    }
+    if (tool === "skill" && parameters.name) {
+        return parameters.name;
+    }
+    const paramStr = JSON.stringify(parameters);
+    if (paramStr === "{}" || paramStr === "[]" || paramStr === "null") {
+        return "";
+    }
+    return paramStr.substring(0, 50);
+};
+export function buildToolIdList(state, messages, logger) {
+    const toolIds = [];
+    for (const msg of messages) {
+        if (isMessageCompacted(state, msg)) {
+            continue;
+        }
+        if (msg.parts) {
+            for (const part of msg.parts) {
+                if (part.type === "tool" && part.callID && part.tool) {
+                    toolIds.push(part.callID);
+                }
+            }
+        }
+    }
+    return toolIds;
+}
+//# sourceMappingURL=utils.js.map

package/dist/lib/messages/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../lib/messages/utils.ts"],"names":[],"mappings":"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"}

package/dist/lib/model-selector.d.ts

@@ -0,0 +1,17 @@
+import type { LanguageModel } from "ai";
+import type { Logger } from "./logger";
+export interface ModelInfo {
+    providerID: string;
+    modelID: string;
+}
+export declare const FALLBACK_MODELS: Record<string, string>;
+export interface ModelSelectionResult {
+    model: LanguageModel;
+    modelInfo: ModelInfo;
+    source: "user-model" | "config" | "fallback";
+    reason?: string;
+    failedModel?: ModelInfo;
+}
+export declare function selectModel(currentModel?: ModelInfo, logger?: Logger, configModel?: string, workspaceDir?: string): Promise<ModelSelectionResult>;
+export declare function extractModelFromSession(sessionState: any, logger?: Logger): ModelInfo | undefined;
+//# sourceMappingURL=model-selector.d.ts.map

package/dist/lib/model-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-selector.d.ts","sourceRoot":"","sources":["../../lib/model-selector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAA;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEtC,MAAM,WAAW,SAAS;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAClB;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CASlD,CAAA;AAgBD,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,aAAa,CAAA;IACpB,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAA;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,SAAS,CAAA;CAC1B;AAwCD,wBAAsB,WAAW,CAC7B,YAAY,CAAC,EAAE,SAAS,EACxB,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,oBAAoB,CAAC,CA+E/B;AAED,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAmBjG"}

package/dist/lib/model-selector.js

@@ -0,0 +1,141 @@
+export const FALLBACK_MODELS = {
+    openai: "gpt-5-mini",
+    anthropic: "claude-haiku-4-5", //This model isn't broken in opencode-auth-provider
+    google: "gemini-2.5-flash",
+    deepseek: "deepseek-chat",
+    xai: "grok-4-fast",
+    alibaba: "qwen3-coder-flash",
+    zai: "glm-4.5-flash",
+    opencode: "big-pickle",
+};
+const PROVIDER_PRIORITY = [
+    "openai",
+    "anthropic",
+    "google",
+    "deepseek",
+    "xai",
+    "alibaba",
+    "zai",
+    "opencode",
+];
+// TODO: some anthropic provided models aren't supported by the opencode-auth-provider package, so this provides a temporary workaround
+const SKIP_PROVIDERS = ["github-copilot", "anthropic"];
+function shouldSkipProvider(providerID) {
+    const normalized = providerID.toLowerCase().trim();
+    return SKIP_PROVIDERS.some((skip) => normalized.includes(skip.toLowerCase()));
+}
+async function importOpencodeAI(logger, maxRetries = 3, delayMs = 100, workspaceDir) {
+    let lastError;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            const { OpencodeAI } = await import("@tarquinen/opencode-auth-provider");
+            return new OpencodeAI({ workspaceDir });
+        }
+        catch (error) {
+            lastError = error;
+            if (error.message?.includes("before initialization")) {
+                logger?.debug(`Import attempt ${attempt}/${maxRetries} failed, will retry`, {
+                    error: error.message,
+                });
+                if (attempt < maxRetries) {
+                    await new Promise((resolve) => setTimeout(resolve, delayMs * attempt));
+                    continue;
+                }
+            }
+            throw error;
+        }
+    }
+    throw lastError;
+}
+export async function selectModel(currentModel, logger, configModel, workspaceDir) {
+    const opencodeAI = await importOpencodeAI(logger, 3, 100, workspaceDir);
+    let failedModelInfo;
+    if (configModel) {
+        const parts = configModel.split("/");
+        if (parts.length !== 2) {
+            logger?.warn("Invalid config model format", { configModel });
+        }
+        else {
+            const [providerID, modelID] = parts;
+            try {
+                const model = await opencodeAI.getLanguageModel(providerID, modelID);
+                return {
+                    model,
+                    modelInfo: { providerID, modelID },
+                    source: "config",
+                    reason: "Using model specified in dcp.jsonc config",
+                };
+            }
+            catch (error) {
+                logger?.warn(`Config model failed: ${providerID}/${modelID}`, {
+                    error: error.message,
+                });
+                failedModelInfo = { providerID, modelID };
+            }
+        }
+    }
+    if (currentModel) {
+        if (shouldSkipProvider(currentModel.providerID)) {
+            if (!failedModelInfo) {
+                failedModelInfo = currentModel;
+            }
+        }
+        else {
+            try {
+                const model = await opencodeAI.getLanguageModel(currentModel.providerID, currentModel.modelID);
+                return {
+                    model,
+                    modelInfo: currentModel,
+                    source: "user-model",
+                    reason: "Using current session model",
+                };
+            }
+            catch (error) {
+                if (!failedModelInfo) {
+                    failedModelInfo = currentModel;
+                }
+            }
+        }
+    }
+    const providers = await opencodeAI.listProviders();
+    for (const providerID of PROVIDER_PRIORITY) {
+        if (!providers[providerID])
+            continue;
+        const fallbackModelID = FALLBACK_MODELS[providerID];
+        if (!fallbackModelID)
+            continue;
+        try {
+            const model = await opencodeAI.getLanguageModel(providerID, fallbackModelID);
+            return {
+                model,
+                modelInfo: { providerID, modelID: fallbackModelID },
+                source: "fallback",
+                reason: `Using ${providerID}/${fallbackModelID}`,
+                failedModel: failedModelInfo,
+            };
+        }
+        catch (error) {
+            continue;
+        }
+    }
+    throw new Error("No available models for analysis. Please authenticate with at least one provider.");
+}
+export function extractModelFromSession(sessionState, logger) {
+    if (sessionState?.model?.providerID && sessionState?.model?.modelID) {
+        return {
+            providerID: sessionState.model.providerID,
+            modelID: sessionState.model.modelID,
+        };
+    }
+    if (sessionState?.messages && Array.isArray(sessionState.messages)) {
+        const lastMessage = sessionState.messages[sessionState.messages.length - 1];
+        if (lastMessage?.model?.providerID && lastMessage?.model?.modelID) {
+            return {
+                providerID: lastMessage.model.providerID,
+                modelID: lastMessage.model.modelID,
+            };
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=model-selector.js.map

package/dist/lib/model-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-selector.js","sourceRoot":"","sources":["../../lib/model-selector.ts"],"names":[],"mappings":"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"}

package/dist/lib/prompt.d.ts

@@ -0,0 +1,3 @@
+export declare function loadPrompt(name: string, vars?: Record<string, string>): string;
+export declare function buildAnalysisPrompt(unprunedToolCallIds: string[], messages: any[], alreadyPrunedIds?: string[], protectedToolCallIds?: string[]): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/lib/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../lib/prompt.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAS9E;AA2HD,wBAAgB,mBAAmB,CAC/B,mBAAmB,EAAE,MAAM,EAAE,EAC7B,QAAQ,EAAE,GAAG,EAAE,EACf,gBAAgB,CAAC,EAAE,MAAM,EAAE,EAC3B,oBAAoB,CAAC,EAAE,MAAM,EAAE,GAChC,MAAM,CAQR"}

package/dist/lib/prompt.js

@@ -0,0 +1,128 @@
+import { readFileSync } from "fs";
+import { join } from "path";
+export function loadPrompt(name, vars) {
+    const filePath = join(__dirname, "prompts", `${name}.txt`);
+    let content = readFileSync(filePath, "utf8").trim();
+    if (vars) {
+        for (const [key, value] of Object.entries(vars)) {
+            content = content.replace(new RegExp(`\\{\\{${key}\\}\\}`, "g"), value);
+        }
+    }
+    return content;
+}
+function minimizeMessages(messages, alreadyPrunedIds, protectedToolCallIds) {
+    const prunedIdsSet = alreadyPrunedIds
+        ? new Set(alreadyPrunedIds.map((id) => id.toLowerCase()))
+        : new Set();
+    const protectedIdsSet = protectedToolCallIds
+        ? new Set(protectedToolCallIds.map((id) => id.toLowerCase()))
+        : new Set();
+    return messages
+        .map((msg) => {
+        const minimized = {
+            role: msg.info?.role,
+        };
+        if (msg.parts) {
+            minimized.parts = msg.parts
+                .filter((part) => {
+                if (part.type === "step-start" || part.type === "step-finish") {
+                    return false;
+                }
+                return true;
+            })
+                .map((part) => {
+                if (part.type === "text") {
+                    if (part.ignored) {
+                        return null;
+                    }
+                    return {
+                        type: "text",
+                        text: part.text,
+                    };
+                }
+                // TODO: This should use the opencode normalized system instead of per provider settings
+                if (part.type === "reasoning") {
+                    // Calculate encrypted content size if present
+                    let encryptedContentLength = 0;
+                    if (part.metadata?.openai?.reasoningEncryptedContent) {
+                        encryptedContentLength =
+                            part.metadata.openai.reasoningEncryptedContent.length;
+                    }
+                    else if (part.metadata?.anthropic?.signature) {
+                        encryptedContentLength = part.metadata.anthropic.signature.length;
+                    }
+                    else if (part.metadata?.google?.thoughtSignature) {
+                        encryptedContentLength =
+                            part.metadata.google.thoughtSignature.length;
+                    }
+                    return {
+                        type: "reasoning",
+                        text: part.text,
+                        textLength: part.text?.length || 0,
+                        encryptedContentLength,
+                        ...(part.time && { time: part.time }),
+                        ...(part.metadata && { metadataKeys: Object.keys(part.metadata) }),
+                    };
+                }
+                if (part.type === "tool") {
+                    const callIDLower = part.callID?.toLowerCase();
+                    const isAlreadyPruned = prunedIdsSet.has(callIDLower);
+                    const isProtected = protectedIdsSet.has(callIDLower);
+                    let displayCallID = part.callID;
+                    if (isAlreadyPruned) {
+                        displayCallID = "<already-pruned>";
+                    }
+                    else if (isProtected) {
+                        displayCallID = "<protected>";
+                    }
+                    const toolPart = {
+                        type: "tool",
+                        toolCallID: displayCallID,
+                        tool: part.tool,
+                    };
+                    if (part.state?.output) {
+                        toolPart.output = part.state.output;
+                    }
+                    if (part.state?.input) {
+                        const input = part.state.input;
+                        if (input.filePath &&
+                            (part.tool === "write" ||
+                                part.tool === "edit" ||
+                                part.tool === "multiedit" ||
+                                part.tool === "patch")) {
+                            toolPart.input = input;
+                        }
+                        else if (input.filePath) {
+                            toolPart.input = { filePath: input.filePath };
+                        }
+                        else if (input.tool_calls && Array.isArray(input.tool_calls)) {
+                            toolPart.input = {
+                                batch_summary: `${input.tool_calls.length} tool calls`,
+                                tools: input.tool_calls.map((tc) => tc.tool),
+                            };
+                        }
+                        else {
+                            toolPart.input = input;
+                        }
+                    }
+                    return toolPart;
+                }
+                return null;
+            })
+                .filter(Boolean);
+        }
+        return minimized;
+    })
+        .filter((msg) => {
+        return msg.parts && msg.parts.length > 0;
+    });
+}
+export function buildAnalysisPrompt(unprunedToolCallIds, messages, alreadyPrunedIds, protectedToolCallIds) {
+    const minimizedMessages = minimizeMessages(messages, alreadyPrunedIds, protectedToolCallIds);
+    const messagesJson = JSON.stringify(minimizedMessages, null, 2).replace(/\\n/g, "\n");
+    return loadPrompt("on-idle-analysis", {
+        available_tool_call_ids: unprunedToolCallIds.join(", "),
+        session_history: messagesJson,
+    });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/lib/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../lib/prompt.ts"],"names":[],"mappings":"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"}

package/dist/lib/prompts/discard-tool-spec.txt

@@ -0,0 +1,41 @@
+Discards tool outputs from context to manage conversation size and reduce noise.
+
+## IMPORTANT: The Prunable List
+A `<prunable-tools>` list is provided to you showing available tool outputs you can discard when there are tools available for pruning. Each line has the format `ID: tool, parameter` (e.g., `20: read, /path/to/file.ts`). You MUST only use numeric IDs that appear in this list to select which tools to discard.
+
+## When to Use This Tool
+
+Use `discard` for removing tool content that is no longer needed
+
+- **Noise:** Irrelevant, unhelpful, or superseded outputs that provide no value.
+- **Task Completion:** Work is complete and there's no valuable information worth preserving.
+
+## When NOT to Use This Tool
+
+- **If the output contains useful information:** Use `extract` instead to preserve key findings.
+- **If you'll need the output later:** Don't discard files you plan to edit or context you'll need for implementation.
+
+## Best Practices
+- **Strategic Batching:** Don't discard single small tool outputs (like short bash commands) unless they are pure noise. Wait until you have several items to perform high-impact discards.
+- **Think ahead:** Before discarding, ask: "Will I need this output for an upcoming task?" If yes, keep it.
+
+## Format
+
+- `ids`: Array where the first element is the reason, followed by numeric IDs from the `<prunable-tools>` list
+
+Reasons: `noise` | `completion`
+
+## Example
+
+<example_noise>
+Assistant: [Reads 'wrong_file.ts']
+This file isn't relevant to the auth system. I'll remove it to clear the context.
+[Uses discard with ids: ["noise", "5"]]
+</example_noise>
+
+<example_completion>
+Assistant: [Runs tests, they pass]
+The tests passed and I don't need to preserve any details. I'll clean up now.
+[Uses discard with ids: ["completion", "20", "21"]]
+</example_completion>
+

package/dist/lib/prompts/extract-tool-spec.txt

@@ -0,0 +1,47 @@
+Extracts key findings from tool outputs into distilled knowledge, then removes the raw outputs from context.
+
+## IMPORTANT: The Prunable List
+A `<prunable-tools>` list is provided to you showing available tool outputs you can extract from when there are tools available for pruning. Each line has the format `ID: tool, parameter` (e.g., `20: read, /path/to/file.ts`). You MUST only use numeric IDs that appear in this list to select which tools to extract.
+
+## When to Use This Tool
+
+Use `extract` when you have gathered useful information that you want to **preserve in distilled form** before removing the raw outputs:
+
+- **Task Completion:** You completed a unit of work and want to preserve key findings.
+- **Knowledge Preservation:** You have context that contains valuable information, but also a lot of unnecessary detail - you only need to preserve some specifics.
+
+## When NOT to Use This Tool
+
+- **If you need precise syntax:** If you'll edit a file or grep for exact strings, keep the raw output.
+- **If uncertain:** Prefer keeping over re-fetching.
+
+
+## Best Practices
+- **Strategic Batching:** Wait until you have several items or a few large outputs to extract, rather than doing tiny, frequent extractions. Aim for high-impact extractions that significantly reduce context size.
+- **Think ahead:** Before extracting, ask: "Will I need the raw output for an upcoming task?" If you researched a file you'll later edit, do NOT extract it.
+
+## Format
+
+- `ids`: Array of numeric IDs as strings from the `<prunable-tools>` list
+- `distillation`: Array of strings, one per ID (positional: distillation[0] is for ids[0], etc.)
+
+Each distillation string should capture the essential information you need to preserve - function signatures, logic, constraints, values, etc. Be as detailed as needed for your task.
+
+## Example
+
+<example_extraction>
+Assistant: [Reads auth service and user types]
+I'll preserve the key details before extracting.
+[Uses extract with:
+  ids: ["10", "11"],
+  distillation: [
+    "auth.ts: validateToken(token: string) -> User|null checks cache first (5min TTL) then OIDC. hashPassword uses bcrypt 12 rounds. Tokens must be 128+ chars.",
+    "user.ts: interface User { id: string; email: string; permissions: ('read'|'write'|'admin')[]; status: 'active'|'suspended' }"
+  ]
+]
+</example_extraction>
+
+<example_keep>
+Assistant: [Reads 'auth.ts' to understand the login flow]
+I've understood the auth flow. I'll need to modify this file to add the new validation, so I'm keeping this read in context rather than extracting.
+</example_keep>

package/dist/lib/prompts/on-idle-analysis.txt

@@ -0,0 +1,30 @@
+You are a conversation analyzer that identifies obsolete tool outputs in a coding session.
+
+Your task: Analyze the session history and identify tool call IDs whose outputs are NO LONGER RELEVANT to the current conversation context.
+
+Guidelines for identifying obsolete tool calls:
+1. Exploratory reads that didn't lead to actual edits or meaningful discussion AND were not explicitly requested to be retained
+2. Tool outputs from debugging/fixing an error that has now been resolved
+3. Failed or incorrect tool attempts that were immediately corrected (e.g., reading a file from the wrong path, then reading from the correct path)
+
+DO NOT prune:
+- Tool calls whose outputs are actively being discussed
+- Tool calls that produced errors still being debugged
+- Tool calls that are the MOST RECENT activity in the conversation (these may be intended for future use)
+
+IMPORTANT: Available tool call IDs for analysis: {{available_tool_call_ids}}
+
+The session history below may contain tool calls with IDs not in the available list above, these cannot be pruned. These are either:
+1. Protected tools (marked with toolCallID "<protected>")
+2. Already-pruned tools (marked with toolCallID "<already-pruned>")
+
+ONLY return IDs from the available list above.
+
+Session history (each tool call has a "toolCallID" field):
+{{session_history}}
+
+You MUST respond with valid JSON matching this exact schema:
+{
+  "pruned_tool_call_ids": ["id1", "id2", ...],
+  "reasoning": "explanation of why these IDs were selected"
+}

package/dist/lib/prompts/user/nudge/nudge-both.txt

@@ -0,0 +1,10 @@
+<instruction name=context_management_required>
+**CRITICAL CONTEXT WARNING:** Your context window is filling with tool outputs. Strict adherence to context hygiene is required.
+
+**Immediate Actions Required:**
+1. **Task Completion:** If a sub-task is complete, decide: use `discard` if no valuable context to preserve (default), or use `extract` if insights are worth keeping.
+2. **Noise Removal:** If you read files or ran commands that yielded no value, use `discard` to remove them.
+3. **Knowledge Preservation:** If you are holding valuable raw data you'll need to reference later, use `extract` to distill the insights and remove the raw entry.
+
+**Protocol:** You should prioritize this cleanup, but do not interrupt a critical atomic operation if one is in progress. Once the immediate step is done, you must perform context management.
+</instruction>

package/dist/lib/prompts/user/nudge/nudge-discard.txt

@@ -0,0 +1,9 @@
+<instruction name=context_management_required>
+**CRITICAL CONTEXT WARNING:** Your context window is filling with tool outputs. Strict adherence to context hygiene is required.
+
+**Immediate Actions Required:**
+1. **Task Completion:** If a sub-task is complete, use the `discard` tool to remove the tools used.
+2. **Noise Removal:** If you read files or ran commands that yielded no value, use the `discard` tool to remove them.
+
+**Protocol:** You should prioritize this cleanup, but do not interrupt a critical atomic operation if one is in progress. Once the immediate step is done, you must discard unneeded tool outputs.
+</instruction>

package/dist/lib/prompts/user/nudge/nudge-extract.txt

@@ -0,0 +1,9 @@
+<instruction name=context_management_required>
+**CRITICAL CONTEXT WARNING:** Your context window is filling with tool outputs. Strict adherence to context hygiene is required.
+
+**Immediate Actions Required:**
+1. **Task Completion:** If you have completed work, extract key findings from the tools used. Scale distillation depth to the value of the content.
+2. **Knowledge Preservation:** If you are holding valuable raw data you'll need to reference later, use the `extract` tool with high-fidelity distillation to preserve the insights and remove the raw entry.
+
+**Protocol:** You should prioritize this cleanup, but do not interrupt a critical atomic operation if one is in progress. Once the immediate step is done, you must extract valuable findings from tool outputs.
+</instruction>