homer-simpson 0.1.0

package/dist/tools/background-task/tools.d.ts

@@ -0,0 +1,7 @@
+import { type PluginInput, type ToolDefinition } from "@opencode-ai/plugin";
+import type { BackgroundManager } from "../../features/background-agent";
+type OpencodeClient = PluginInput["client"];
+export declare function createBackgroundTask(manager: BackgroundManager): ToolDefinition;
+export declare function createBackgroundOutput(manager: BackgroundManager, client: OpencodeClient): ToolDefinition;
+export declare function createBackgroundCancel(manager: BackgroundManager, client: OpencodeClient): ToolDefinition;
+export {};

package/dist/tools/background-task/types.d.ts

@@ -0,0 +1,14 @@
+export interface BackgroundTaskArgs {
+    description: string;
+    prompt: string;
+    agent: string;
+}
+export interface BackgroundOutputArgs {
+    task_id: string;
+    block?: boolean;
+    timeout?: number;
+}
+export interface BackgroundCancelArgs {
+    taskId?: string;
+    all?: boolean;
+}

package/dist/tools/call-homer-agent/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const ALLOWED_AGENTS: readonly ["Explorer", "Researcher"];
+export declare const CALL_HOMER_AGENT_DESCRIPTION = "Spawn Explorer/Researcher agent. run_in_background REQUIRED (true=async with task_id, false=sync).\n\nAvailable: {agents}\n\nPass `resume=session_id` to continue previous agent with full context. Prompts MUST be in English. Use `background_output` for async results.";

package/dist/tools/call-homer-agent/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./constants";
+export { createCallHomerAgent } from "./tools";

package/dist/tools/call-homer-agent/tools.d.ts

@@ -0,0 +1,3 @@
+import { type PluginInput, type ToolDefinition } from "@opencode-ai/plugin";
+import type { BackgroundManager } from "../../features/background-agent";
+export declare function createCallHomerAgent(ctx: PluginInput, backgroundManager: BackgroundManager): ToolDefinition;

package/dist/tools/call-homer-agent/types.d.ts

@@ -0,0 +1,24 @@
+import type { ALLOWED_AGENTS } from "./constants";
+export type AllowedAgentType = (typeof ALLOWED_AGENTS)[number];
+export interface CallHomerAgentArgs {
+    description: string;
+    prompt: string;
+    subagent_type: string;
+    run_in_background: boolean;
+    session_id?: string;
+}
+export interface CallHomerAgentSyncResult {
+    title: string;
+    metadata: {
+        summary?: Array<{
+            id: string;
+            tool: string;
+            state: {
+                status: string;
+                title?: string;
+            };
+        }>;
+        sessionId: string;
+    };
+    output: string;
+}

package/dist/tools/glob/cli.d.ts

@@ -0,0 +1,7 @@
+import { type GrepBackend } from "./constants";
+import type { GlobOptions, GlobResult } from "./types";
+export interface ResolvedCli {
+    path: string;
+    backend: GrepBackend;
+}
+export declare function runRgFiles(options: GlobOptions, resolvedCli?: ResolvedCli): Promise<GlobResult>;

package/dist/tools/glob/constants.d.ts

@@ -0,0 +1,6 @@
+export { resolveGrepCli, resolveGrepCliWithAutoInstall, type GrepBackend } from "../grep/constants";
+export declare const DEFAULT_TIMEOUT_MS = 60000;
+export declare const DEFAULT_LIMIT = 100;
+export declare const DEFAULT_MAX_DEPTH = 20;
+export declare const DEFAULT_MAX_OUTPUT_BYTES: number;
+export declare const RG_FILES_FLAGS: readonly ["--files", "--color=never", "--glob=!.git/*"];

package/dist/tools/glob/index.d.ts

@@ -0,0 +1,2 @@
+import { glob } from "./tools";
+export { glob };

package/dist/tools/glob/tools.d.ts

@@ -0,0 +1,2 @@
+import { type ToolDefinition } from "@opencode-ai/plugin/tool";
+export declare const glob: ToolDefinition;

package/dist/tools/glob/types.d.ts

@@ -0,0 +1,19 @@
+export interface FileMatch {
+    path: string;
+    mtime: number;
+}
+export interface GlobResult {
+    files: FileMatch[];
+    totalFiles: number;
+    truncated: boolean;
+    error?: string;
+}
+export interface GlobOptions {
+    pattern: string;
+    paths?: string[];
+    hidden?: boolean;
+    noIgnore?: boolean;
+    maxDepth?: number;
+    timeout?: number;
+    limit?: number;
+}

package/dist/tools/glob/utils.d.ts

@@ -0,0 +1,2 @@
+import type { GlobResult } from "./types";
+export declare function formatGlobResult(result: GlobResult): string;

package/dist/tools/grep/cli.d.ts

@@ -0,0 +1,3 @@
+import type { GrepOptions, GrepResult, CountResult } from "./types";
+export declare function runRg(options: GrepOptions): Promise<GrepResult>;
+export declare function runRgCount(options: Omit<GrepOptions, "context">): Promise<CountResult[]>;

package/dist/tools/grep/constants.d.ts

@@ -0,0 +1,17 @@
+export type GrepBackend = "rg" | "grep";
+interface ResolvedCli {
+    path: string;
+    backend: GrepBackend;
+}
+export declare function resolveGrepCli(): ResolvedCli;
+export declare function resolveGrepCliWithAutoInstall(): Promise<ResolvedCli>;
+export declare const DEFAULT_MAX_DEPTH = 20;
+export declare const DEFAULT_MAX_FILESIZE = "10M";
+export declare const DEFAULT_MAX_COUNT = 500;
+export declare const DEFAULT_MAX_COLUMNS = 1000;
+export declare const DEFAULT_CONTEXT = 2;
+export declare const DEFAULT_TIMEOUT_MS = 300000;
+export declare const DEFAULT_MAX_OUTPUT_BYTES: number;
+export declare const RG_SAFETY_FLAGS: readonly ["--no-follow", "--color=never", "--no-heading", "--line-number", "--with-filename"];
+export declare const GREP_SAFETY_FLAGS: readonly ["-n", "-H", "--color=never"];
+export {};

package/dist/tools/grep/downloader.d.ts

@@ -0,0 +1,3 @@
+export declare function findFileRecursive(dir: string, filename: string): string | null;
+export declare function downloadAndInstallRipgrep(): Promise<string>;
+export declare function getInstalledRipgrepPath(): string | null;

package/dist/tools/grep/downloader.test.d.ts

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

package/dist/tools/grep/index.d.ts

@@ -0,0 +1,2 @@
+import { grep } from "./tools";
+export { grep };

package/dist/tools/grep/tools.d.ts

@@ -0,0 +1,2 @@
+import { type ToolDefinition } from "@opencode-ai/plugin/tool";
+export declare const grep: ToolDefinition;

package/dist/tools/grep/types.d.ts

@@ -0,0 +1,36 @@
+export interface GrepMatch {
+    file: string;
+    line: number;
+    column?: number;
+    text: string;
+}
+export interface GrepResult {
+    matches: GrepMatch[];
+    totalMatches: number;
+    filesSearched: number;
+    truncated: boolean;
+    error?: string;
+}
+export interface GrepOptions {
+    pattern: string;
+    paths?: string[];
+    globs?: string[];
+    excludeGlobs?: string[];
+    context?: number;
+    maxDepth?: number;
+    maxFilesize?: string;
+    maxCount?: number;
+    maxColumns?: number;
+    caseSensitive?: boolean;
+    wholeWord?: boolean;
+    fixedStrings?: boolean;
+    multiline?: boolean;
+    hidden?: boolean;
+    noIgnore?: boolean;
+    fileType?: string[];
+    timeout?: number;
+}
+export interface CountResult {
+    file: string;
+    count: number;
+}

package/dist/tools/grep/utils.d.ts

@@ -0,0 +1,3 @@
+import type { GrepResult, CountResult } from "./types";
+export declare function formatGrepResult(result: GrepResult): string;
+export declare function formatCountResult(results: CountResult[]): string;

package/dist/tools/homer-task/constants.d.ts

@@ -0,0 +1,12 @@
+import type { CategoryConfig } from "../../config/schema";
+export declare const VISUAL_CATEGORY_PROMPT_APPEND = "<Category_Context>\nYou are working on VISUAL/UI tasks.\n\nDesign-first mindset:\n- Bold aesthetic choices over safe defaults\n- Unexpected layouts, asymmetry, grid-breaking elements\n- Distinctive typography (avoid: Arial, Inter, Roboto, Space Grotesk)\n- Cohesive color palettes with sharp accents\n- High-impact animations with staggered reveals\n- Atmosphere: gradient meshes, noise textures, layered transparencies\n\nAVOID: Generic fonts, purple gradients on white, predictable layouts, cookie-cutter patterns.\n</Category_Context>";
+export declare const STRATEGIC_CATEGORY_PROMPT_APPEND = "<Category_Context>\nYou are working on BUSINESS LOGIC / ARCHITECTURE tasks.\n\nStrategic advisor mindset:\n- Bias toward simplicity: least complex solution that fulfills requirements\n- Leverage existing code/patterns over new components\n- Prioritize developer experience and maintainability\n- One clear recommendation with effort estimate (Quick/Short/Medium/Large)\n- Signal when advanced approach warranted\n\nResponse format:\n- Bottom line (2-3 sentences)\n- Action plan (numbered steps)\n- Risks and mitigations (if relevant)\n</Category_Context>";
+export declare const ARTISTRY_CATEGORY_PROMPT_APPEND = "<Category_Context>\nYou are working on HIGHLY CREATIVE / ARTISTIC tasks.\n\nArtistic genius mindset:\n- Push far beyond conventional boundaries\n- Explore radical, unconventional directions\n- Surprise and delight: unexpected twists, novel combinations\n- Rich detail and vivid expression\n- Break patterns deliberately when it serves the creative vision\n\nApproach:\n- Generate diverse, bold options first\n- Embrace ambiguity and wild experimentation\n- Balance novelty with coherence\n- This is for tasks requiring exceptional creativity\n</Category_Context>";
+export declare const QUICK_CATEGORY_PROMPT_APPEND = "<Category_Context>\nYou are working on SMALL / QUICK tasks.\n\nEfficient execution mindset:\n- Fast, focused, minimal overhead\n- Get to the point immediately\n- No over-engineering\n- Simple solutions for simple problems\n\nApproach:\n- Minimal viable implementation\n- Skip unnecessary abstractions\n- Direct and concise\n</Category_Context>\n\n<Caller_Warning>\n\u26A0\uFE0F THIS CATEGORY USES A LESS CAPABLE MODEL (claude-haiku-4-5).\n\nThe model executing this task has LIMITED reasoning capacity. Your prompt MUST be:\n\n**EXHAUSTIVELY EXPLICIT** - Leave NOTHING to interpretation:\n1. MUST DO: List every required action as atomic, numbered steps\n2. MUST NOT DO: Explicitly forbid likely mistakes and deviations\n3. EXPECTED OUTPUT: Describe exact success criteria with concrete examples\n\n**WHY THIS MATTERS:**\n- Less capable models WILL deviate without explicit guardrails\n- Vague instructions \u2192 unpredictable results\n- Implicit expectations \u2192 missed requirements\n\n**PROMPT STRUCTURE (MANDATORY):**\n```\nTASK: [One-sentence goal]\n\nMUST DO:\n1. [Specific action with exact details]\n2. [Another specific action]\n...\n\nMUST NOT DO:\n- [Forbidden action + why]\n- [Another forbidden action]\n...\n\nEXPECTED OUTPUT:\n- [Exact deliverable description]\n- [Success criteria / verification method]\n```\n\nIf your prompt lacks this structure, REWRITE IT before delegating.\n</Caller_Warning>";
+export declare const MOST_CAPABLE_CATEGORY_PROMPT_APPEND = "<Category_Context>\nYou are working on COMPLEX / MOST-CAPABLE tasks.\n\nMaximum capability mindset:\n- Bring full reasoning power to bear\n- Consider all edge cases and implications\n- Deep analysis before action\n- Quality over speed\n\nApproach:\n- Thorough understanding first\n- Comprehensive solution design\n- Meticulous execution\n- This is for the most challenging problems\n</Category_Context>";
+export declare const WRITING_CATEGORY_PROMPT_APPEND = "<Category_Context>\nYou are working on WRITING / PROSE tasks.\n\nWordsmith mindset:\n- Clear, flowing prose\n- Appropriate tone and voice\n- Engaging and readable\n- Proper structure and organization\n\nApproach:\n- Understand the audience\n- Draft with care\n- Polish for clarity and impact\n- Documentation, READMEs, articles, technical writing\n</Category_Context>";
+export declare const GENERAL_CATEGORY_PROMPT_APPEND = "<Category_Context>\nYou are working on GENERAL tasks.\n\nBalanced execution mindset:\n- Practical, straightforward approach\n- Good enough is good enough\n- Focus on getting things done\n\nApproach:\n- Standard best practices\n- Reasonable trade-offs\n- Efficient completion\n</Category_Context>\n\n<Caller_Warning>\n\u26A0\uFE0F THIS CATEGORY USES A MID-TIER MODEL (claude-sonnet-4-5).\n\nWhile capable, this model benefits significantly from EXPLICIT instructions.\n\n**PROVIDE CLEAR STRUCTURE:**\n1. MUST DO: Enumerate required actions explicitly - don't assume inference\n2. MUST NOT DO: State forbidden actions to prevent scope creep or wrong approaches\n3. EXPECTED OUTPUT: Define concrete success criteria and deliverables\n\n**COMMON PITFALLS WITHOUT EXPLICIT INSTRUCTIONS:**\n- Model may take shortcuts that miss edge cases\n- Implicit requirements get overlooked\n- Output format may not match expectations\n- Scope may expand beyond intended boundaries\n\n**RECOMMENDED PROMPT PATTERN:**\n```\nTASK: [Clear, single-purpose goal]\n\nCONTEXT: [Relevant background the model needs]\n\nMUST DO:\n- [Explicit requirement 1]\n- [Explicit requirement 2]\n\nMUST NOT DO:\n- [Boundary/constraint 1]\n- [Boundary/constraint 2]\n\nEXPECTED OUTPUT:\n- [What success looks like]\n- [How to verify completion]\n```\n\nThe more explicit your prompt, the better the results.\n</Caller_Warning>";
+export declare const DEFAULT_CATEGORIES: Record<string, CategoryConfig>;
+export declare const CATEGORY_PROMPT_APPENDS: Record<string, string>;
+export declare const CATEGORY_DESCRIPTIONS: Record<string, string>;
+export declare const HOMER_TASK_DESCRIPTION: string;

package/dist/tools/homer-task/index.d.ts

@@ -0,0 +1,3 @@
+export { createHomerTask, type HomerTaskToolOptions } from "./tools";
+export type * from "./types";
+export * from "./constants";

package/dist/tools/homer-task/tools.d.ts

@@ -0,0 +1,16 @@
+import { type PluginInput, type ToolDefinition } from "@opencode-ai/plugin";
+import type { BackgroundManager } from "../../features/background-agent";
+import type { CategoriesConfig } from "../../config/schema";
+type OpencodeClient = PluginInput["client"];
+export interface HomerTaskToolOptions {
+    manager: BackgroundManager;
+    client: OpencodeClient;
+    userCategories?: CategoriesConfig;
+}
+export interface BuildSystemContentInput {
+    skillContent?: string;
+    categoryPromptAppend?: string;
+}
+export declare function buildSystemContent(input: BuildSystemContentInput): string | undefined;
+export declare function createHomerTask(options: HomerTaskToolOptions): ToolDefinition;
+export {};

package/dist/tools/homer-task/tools.test.d.ts

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

package/dist/tools/homer-task/types.d.ts

@@ -0,0 +1,9 @@
+export interface HomerTaskArgs {
+    description: string;
+    prompt: string;
+    category?: string;
+    subagent_type?: string;
+    run_in_background: boolean;
+    resume?: string;
+    skills: string[];
+}

package/dist/tools/index.d.ts

@@ -0,0 +1,16 @@
+import { lspManager } from "./lsp";
+export { lspManager };
+export { createSlashcommandTool, discoverCommandsSync } from "./slashcommand";
+export { sessionExists } from "./session-manager/storage";
+export { interactive_bash, startBackgroundCheck as startTmuxCheck } from "./interactive-bash";
+export { createSkillTool } from "./skill";
+export { getTmuxPath } from "./interactive-bash/utils";
+export { createSkillMcpTool } from "./skill-mcp";
+import type { PluginInput, ToolDefinition } from "@opencode-ai/plugin";
+import type { BackgroundManager } from "../features/background-agent";
+type OpencodeClient = PluginInput["client"];
+export { createCallHomerAgent } from "./call-homer-agent";
+export { createLookAt } from "./look-at";
+export { createHomerTask, type HomerTaskToolOptions, DEFAULT_CATEGORIES, CATEGORY_PROMPT_APPENDS } from "./homer-task";
+export declare function createBackgroundTools(manager: BackgroundManager, client: OpencodeClient): Record<string, ToolDefinition>;
+export declare const builtinTools: Record<string, ToolDefinition>;

package/dist/tools/interactive-bash/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_TIMEOUT_MS = 60000;
+export declare const BLOCKED_TMUX_SUBCOMMANDS: string[];
+export declare const INTERACTIVE_BASH_DESCRIPTION = "Execute tmux commands. Use \"homer-{name}\" session pattern.\n\nFor: server processes, long-running tasks, background jobs, interactive CLI tools.\n\nBlocked (use bash instead): capture-pane, save-buffer, show-buffer, pipe-pane.";

package/dist/tools/interactive-bash/index.d.ts

@@ -0,0 +1,3 @@
+import { interactive_bash } from "./tools";
+import { startBackgroundCheck } from "./utils";
+export { interactive_bash, startBackgroundCheck };

package/dist/tools/interactive-bash/tools.d.ts

@@ -0,0 +1,7 @@
+import { type ToolDefinition } from "@opencode-ai/plugin/tool";
+/**
+ * Quote-aware command tokenizer with escape handling
+ * Handles single/double quotes and backslash escapes without external dependencies
+ */
+export declare function tokenizeCommand(cmd: string): string[];
+export declare const interactive_bash: ToolDefinition;

package/dist/tools/interactive-bash/types.d.ts

@@ -0,0 +1,3 @@
+export interface InteractiveBashArgs {
+    tmux_command: string;
+}

package/dist/tools/interactive-bash/utils.d.ts

@@ -0,0 +1,3 @@
+export declare function getTmuxPath(): Promise<string | null>;
+export declare function getCachedTmuxPath(): string | null;
+export declare function startBackgroundCheck(): void;

package/dist/tools/look-at/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const MULTIMODAL_LOOKER_AGENT: "Viewer";
+export declare const LOOK_AT_DESCRIPTION = "Analyze media files (PDFs, images, diagrams) that require interpretation beyond raw text. Extracts specific information or summaries from documents, describes visual content. Use when you need analyzed/extracted data rather than literal file contents.";

package/dist/tools/look-at/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./constants";
+export { createLookAt } from "./tools";

package/dist/tools/look-at/tools.d.ts

@@ -0,0 +1,2 @@
+import { type PluginInput, type ToolDefinition } from "@opencode-ai/plugin";
+export declare function createLookAt(ctx: PluginInput): ToolDefinition;

package/dist/tools/look-at/types.d.ts

@@ -0,0 +1,4 @@
+export interface LookAtArgs {
+    file_path: string;
+    goal: string;
+}

package/dist/tools/lsp/client.d.ts

@@ -0,0 +1,60 @@
+import type { Diagnostic, ResolvedServer } from "./types";
+declare class LSPServerManager {
+    private static instance;
+    private clients;
+    private cleanupInterval;
+    private readonly IDLE_TIMEOUT;
+    private constructor();
+    private registerProcessCleanup;
+    static getInstance(): LSPServerManager;
+    private getKey;
+    private startCleanupTimer;
+    private cleanupIdleClients;
+    getClient(root: string, server: ResolvedServer): Promise<LSPClient>;
+    warmupClient(root: string, server: ResolvedServer): void;
+    releaseClient(root: string, serverId: string): void;
+    isServerInitializing(root: string, serverId: string): boolean;
+    stopAll(): Promise<void>;
+    cleanupTempDirectoryClients(): Promise<void>;
+}
+export declare const lspManager: LSPServerManager;
+export declare class LSPClient {
+    private root;
+    private server;
+    private proc;
+    private buffer;
+    private pending;
+    private requestIdCounter;
+    private openedFiles;
+    private stderrBuffer;
+    private processExited;
+    private diagnosticsStore;
+    constructor(root: string, server: ResolvedServer);
+    start(): Promise<void>;
+    private startReading;
+    private startStderrReading;
+    private rejectAllPending;
+    private findSequence;
+    private processBuffer;
+    private send;
+    private notify;
+    private respond;
+    private handleServerRequest;
+    initialize(): Promise<void>;
+    openFile(filePath: string): Promise<void>;
+    hover(filePath: string, line: number, character: number): Promise<unknown>;
+    definition(filePath: string, line: number, character: number): Promise<unknown>;
+    references(filePath: string, line: number, character: number, includeDeclaration?: boolean): Promise<unknown>;
+    documentSymbols(filePath: string): Promise<unknown>;
+    workspaceSymbols(query: string): Promise<unknown>;
+    diagnostics(filePath: string): Promise<{
+        items: Diagnostic[];
+    }>;
+    prepareRename(filePath: string, line: number, character: number): Promise<unknown>;
+    rename(filePath: string, line: number, character: number, newName: string): Promise<unknown>;
+    codeAction(filePath: string, startLine: number, startChar: number, endLine: number, endChar: number, only?: string[]): Promise<unknown>;
+    codeActionResolve(codeAction: unknown): Promise<unknown>;
+    isAlive(): boolean;
+    stop(): Promise<void>;
+}
+export {};

package/dist/tools/lsp/config.d.ts

@@ -0,0 +1,17 @@
+import type { ServerLookupResult } from "./types";
+export declare function findServerForExtension(ext: string): ServerLookupResult;
+export declare function getLanguageId(ext: string): string;
+export declare function isServerInstalled(command: string[]): boolean;
+export declare function getAllServers(): Array<{
+    id: string;
+    installed: boolean;
+    extensions: string[];
+    disabled: boolean;
+    source: string;
+    priority: number;
+}>;
+export declare function getConfigPaths_(): {
+    project: string;
+    user: string;
+    opencode: string;
+};

package/dist/tools/lsp/constants.d.ts

@@ -0,0 +1,9 @@
+import type { LSPServerConfig } from "./types";
+export declare const SYMBOL_KIND_MAP: Record<number, string>;
+export declare const SEVERITY_MAP: Record<number, string>;
+export declare const DEFAULT_MAX_REFERENCES = 200;
+export declare const DEFAULT_MAX_SYMBOLS = 200;
+export declare const DEFAULT_MAX_DIAGNOSTICS = 200;
+export declare const LSP_INSTALL_HINTS: Record<string, string>;
+export declare const BUILTIN_SERVERS: Record<string, Omit<LSPServerConfig, "id">>;
+export declare const EXT_TO_LANG: Record<string, string>;

package/dist/tools/lsp/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types";
+export * from "./constants";
+export * from "./config";
+export * from "./client";
+export * from "./utils";
+export * from "./tools";

package/dist/tools/lsp/tools.d.ts

@@ -0,0 +1,12 @@
+import { type ToolDefinition } from "@opencode-ai/plugin/tool";
+export declare const lsp_hover: ToolDefinition;
+export declare const lsp_goto_definition: ToolDefinition;
+export declare const lsp_find_references: ToolDefinition;
+export declare const lsp_document_symbols: ToolDefinition;
+export declare const lsp_workspace_symbols: ToolDefinition;
+export declare const lsp_diagnostics: ToolDefinition;
+export declare const lsp_servers: ToolDefinition;
+export declare const lsp_prepare_rename: ToolDefinition;
+export declare const lsp_rename: ToolDefinition;
+export declare const lsp_code_actions: ToolDefinition;
+export declare const lsp_code_action_resolve: ToolDefinition;

package/dist/tools/lsp/types.d.ts

@@ -0,0 +1,156 @@
+export interface LSPServerConfig {
+    id: string;
+    command: string[];
+    extensions: string[];
+    disabled?: boolean;
+    env?: Record<string, string>;
+    initialization?: Record<string, unknown>;
+}
+export interface Position {
+    line: number;
+    character: number;
+}
+export interface Range {
+    start: Position;
+    end: Position;
+}
+export interface Location {
+    uri: string;
+    range: Range;
+}
+export interface LocationLink {
+    targetUri: string;
+    targetRange: Range;
+    targetSelectionRange: Range;
+    originSelectionRange?: Range;
+}
+export interface SymbolInfo {
+    name: string;
+    kind: number;
+    location: Location;
+    containerName?: string;
+}
+export interface DocumentSymbol {
+    name: string;
+    kind: number;
+    range: Range;
+    selectionRange: Range;
+    children?: DocumentSymbol[];
+}
+export interface Diagnostic {
+    range: Range;
+    severity?: number;
+    code?: string | number;
+    source?: string;
+    message: string;
+}
+export interface HoverResult {
+    contents: {
+        kind?: string;
+        value: string;
+    } | string | Array<{
+        kind?: string;
+        value: string;
+    } | string>;
+    range?: Range;
+}
+export interface TextDocumentIdentifier {
+    uri: string;
+}
+export interface VersionedTextDocumentIdentifier extends TextDocumentIdentifier {
+    version: number | null;
+}
+export interface TextEdit {
+    range: Range;
+    newText: string;
+}
+export interface TextDocumentEdit {
+    textDocument: VersionedTextDocumentIdentifier;
+    edits: TextEdit[];
+}
+export interface CreateFile {
+    kind: "create";
+    uri: string;
+    options?: {
+        overwrite?: boolean;
+        ignoreIfExists?: boolean;
+    };
+}
+export interface RenameFile {
+    kind: "rename";
+    oldUri: string;
+    newUri: string;
+    options?: {
+        overwrite?: boolean;
+        ignoreIfExists?: boolean;
+    };
+}
+export interface DeleteFile {
+    kind: "delete";
+    uri: string;
+    options?: {
+        recursive?: boolean;
+        ignoreIfNotExists?: boolean;
+    };
+}
+export interface WorkspaceEdit {
+    changes?: {
+        [uri: string]: TextEdit[];
+    };
+    documentChanges?: (TextDocumentEdit | CreateFile | RenameFile | DeleteFile)[];
+}
+export interface PrepareRenameResult {
+    range: Range;
+    placeholder?: string;
+}
+export interface PrepareRenameDefaultBehavior {
+    defaultBehavior: boolean;
+}
+export interface Command {
+    title: string;
+    command: string;
+    arguments?: unknown[];
+}
+export interface CodeActionContext {
+    diagnostics: Diagnostic[];
+    only?: string[];
+    triggerKind?: CodeActionTriggerKind;
+}
+export type CodeActionTriggerKind = 1 | 2;
+export interface CodeAction {
+    title: string;
+    kind?: string;
+    diagnostics?: Diagnostic[];
+    isPreferred?: boolean;
+    disabled?: {
+        reason: string;
+    };
+    edit?: WorkspaceEdit;
+    command?: Command;
+    data?: unknown;
+}
+export interface ServerLookupInfo {
+    id: string;
+    command: string[];
+    extensions: string[];
+}
+export type ServerLookupResult = {
+    status: "found";
+    server: ResolvedServer;
+} | {
+    status: "not_configured";
+    extension: string;
+    availableServers: string[];
+} | {
+    status: "not_installed";
+    server: ServerLookupInfo;
+    installHint: string;
+};
+export interface ResolvedServer {
+    id: string;
+    command: string[];
+    extensions: string[];
+    priority: number;
+    env?: Record<string, string>;
+    initialization?: Record<string, unknown>;
+}

package/dist/tools/lsp/utils.d.ts

@@ -0,0 +1,29 @@
+import { LSPClient } from "./client";
+import type { HoverResult, DocumentSymbol, SymbolInfo, Location, LocationLink, Diagnostic, PrepareRenameResult, PrepareRenameDefaultBehavior, Range, WorkspaceEdit, TextEdit, CodeAction, Command, ServerLookupResult } from "./types";
+export declare function findWorkspaceRoot(filePath: string): string;
+export declare function uriToPath(uri: string): string;
+export declare function formatServerLookupError(result: Exclude<ServerLookupResult, {
+    status: "found";
+}>): string;
+export declare function withLspClient<T>(filePath: string, fn: (client: LSPClient) => Promise<T>): Promise<T>;
+export declare function formatHoverResult(result: HoverResult | null): string;
+export declare function formatLocation(loc: Location | LocationLink): string;
+export declare function formatSymbolKind(kind: number): string;
+export declare function formatSeverity(severity: number | undefined): string;
+export declare function formatDocumentSymbol(symbol: DocumentSymbol, indent?: number): string;
+export declare function formatSymbolInfo(symbol: SymbolInfo): string;
+export declare function formatDiagnostic(diag: Diagnostic): string;
+export declare function filterDiagnosticsBySeverity(diagnostics: Diagnostic[], severityFilter?: "error" | "warning" | "information" | "hint" | "all"): Diagnostic[];
+export declare function formatPrepareRenameResult(result: PrepareRenameResult | PrepareRenameDefaultBehavior | Range | null): string;
+export declare function formatTextEdit(edit: TextEdit): string;
+export declare function formatWorkspaceEdit(edit: WorkspaceEdit | null): string;
+export declare function formatCodeAction(action: CodeAction): string;
+export declare function formatCodeActions(actions: (CodeAction | Command)[] | null): string;
+export interface ApplyResult {
+    success: boolean;
+    filesModified: string[];
+    totalEdits: number;
+    errors: string[];
+}
+export declare function applyWorkspaceEdit(edit: WorkspaceEdit | null): ApplyResult;
+export declare function formatApplyResult(result: ApplyResult): string;

package/dist/tools/session-manager/constants.d.ts

@@ -0,0 +1,12 @@
+export declare const OPENCODE_STORAGE: string;
+export declare const MESSAGE_STORAGE: string;
+export declare const PART_STORAGE: string;
+export declare const SESSION_STORAGE: string;
+export declare const TODO_DIR: string;
+export declare const TRANSCRIPT_DIR: string;
+export declare const SESSION_LIST_DESCRIPTION = "List all OpenCode sessions with optional filtering.\n\nReturns a list of available session IDs with metadata including message count, date range, and agents used.\n\nArguments:\n- limit (optional): Maximum number of sessions to return\n- from_date (optional): Filter sessions from this date (ISO 8601 format)\n- to_date (optional): Filter sessions until this date (ISO 8601 format)\n\nExample output:\n| Session ID | Messages | First | Last | Agents |\n|------------|----------|-------|------|--------|\n| ses_abc123 | 45 | 2025-12-20 | 2025-12-24 | build, Architect |\n| ses_def456 | 12 | 2025-12-19 | 2025-12-19 | build |";
+export declare const SESSION_READ_DESCRIPTION = "Read messages and history from an OpenCode session.\n\nReturns a formatted view of session messages with role, timestamp, and content. Optionally includes todos and transcript data.\n\nArguments:\n- session_id (required): Session ID to read\n- include_todos (optional): Include todo list if available (default: false)\n- include_transcript (optional): Include transcript log if available (default: false)\n- limit (optional): Maximum number of messages to return (default: all)\n\nExample output:\nSession: ses_abc123\nMessages: 45\nDate Range: 2025-12-20 to 2025-12-24\n\n[Message 1] user (2025-12-20 10:30:00)\nHello, can you help me with...\n\n[Message 2] assistant (2025-12-20 10:30:15)\nOf course! Let me help you with...";
+export declare const SESSION_SEARCH_DESCRIPTION = "Search for content within OpenCode session messages.\n\nPerforms full-text search across session messages and returns matching excerpts with context.\n\nArguments:\n- query (required): Search query string\n- session_id (optional): Search within specific session only (default: all sessions)\n- case_sensitive (optional): Case-sensitive search (default: false)\n- limit (optional): Maximum number of results to return (default: 20)\n\nExample output:\nFound 3 matches across 2 sessions:\n\n[ses_abc123] Message msg_001 (user)\n...implement the **session manager** tool...\n\n[ses_abc123] Message msg_005 (assistant)\n...I'll create a **session manager** with full search...\n\n[ses_def456] Message msg_012 (user)\n...use the **session manager** to find...";
+export declare const SESSION_INFO_DESCRIPTION = "Get metadata and statistics about an OpenCode session.\n\nReturns detailed information about a session including message count, date range, agents used, and available data sources.\n\nArguments:\n- session_id (required): Session ID to inspect\n\nExample output:\nSession ID: ses_abc123\nMessages: 45\nDate Range: 2025-12-20 10:30:00 to 2025-12-24 15:45:30\nDuration: 4 days, 5 hours\nAgents Used: build, Architect, Researcher\nHas Todos: Yes (12 items, 8 completed)\nHas Transcript: Yes (234 entries)";
+export declare const SESSION_DELETE_DESCRIPTION = "Delete an OpenCode session and all associated data.\n\nRemoves session messages, parts, todos, and transcript. This operation cannot be undone.\n\nArguments:\n- session_id (required): Session ID to delete\n- confirm (required): Must be true to confirm deletion\n\nExample:\nsession_delete(session_id=\"ses_abc123\", confirm=true)\nSuccessfully deleted session ses_abc123";
+export declare const TOOL_NAME_PREFIX = "session_";

package/dist/tools/session-manager/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./tools";
+export * from "./types";
+export * from "./constants";