homer-simpson 0.1.0

package/dist/mcp/context7.d.ts

@@ -0,0 +1,5 @@
+export declare const context7: {
+    type: "remote";
+    url: string;
+    enabled: boolean;
+};

package/dist/mcp/grep-app.d.ts

@@ -0,0 +1,5 @@
+export declare const grep_app: {
+    type: "remote";
+    url: string;
+    enabled: boolean;
+};

package/dist/mcp/index.d.ts

@@ -0,0 +1,8 @@
+export { McpNameSchema, type McpName } from "./types";
+type RemoteMcpConfig = {
+    type: "remote";
+    url: string;
+    enabled: boolean;
+    headers?: Record<string, string>;
+};
+export declare function createBuiltinMcps(disabledMcps?: string[]): Record<string, RemoteMcpConfig>;

package/dist/mcp/index.test.d.ts

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

package/dist/mcp/types.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+export declare const McpNameSchema: z.ZodEnum<{
+    websearch: "websearch";
+    context7: "context7";
+    grep_app: "grep_app";
+}>;
+export type McpName = z.infer<typeof McpNameSchema>;
+export declare const AnyMcpNameSchema: z.ZodString;
+export type AnyMcpName = z.infer<typeof AnyMcpNameSchema>;

package/dist/mcp/websearch.d.ts

@@ -0,0 +1,8 @@
+export declare const websearch: {
+    type: "remote";
+    url: string;
+    enabled: boolean;
+    headers: {
+        "x-api-key": string;
+    } | undefined;
+};

package/dist/plugin-config.d.ts

@@ -0,0 +1,4 @@
+import { type HomerSimpsonConfig } from "./config";
+export declare function loadConfigFromPath(configPath: string, ctx: unknown): HomerSimpsonConfig | null;
+export declare function mergeConfigs(base: HomerSimpsonConfig, override: HomerSimpsonConfig): HomerSimpsonConfig;
+export declare function loadPluginConfig(directory: string, ctx: unknown): HomerSimpsonConfig;

package/dist/plugin-handlers/config-handler.d.ts

@@ -0,0 +1,10 @@
+import type { HomerSimpsonConfig } from "../config";
+import type { ModelCacheState } from "../plugin-state";
+export interface ConfigHandlerDeps {
+    ctx: {
+        directory: string;
+    };
+    pluginConfig: HomerSimpsonConfig;
+    modelCacheState: ModelCacheState;
+}
+export declare function createConfigHandler(deps: ConfigHandlerDeps): (config: Record<string, unknown>) => Promise<void>;

package/dist/plugin-handlers/index.d.ts

@@ -0,0 +1 @@
+export { createConfigHandler, type ConfigHandlerDeps } from "./config-handler";

package/dist/plugin-state.d.ts

@@ -0,0 +1,6 @@
+export interface ModelCacheState {
+    modelContextLimitsCache: Map<string, number>;
+    anthropicContext1MEnabled: boolean;
+}
+export declare function createModelCacheState(): ModelCacheState;
+export declare function getModelLimit(state: ModelCacheState, providerID: string, modelID: string): number | undefined;

package/dist/shared/agent-display.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 에이전트 표시 이름 모듈
+ * 그리스 신화 기반 내부 이름을 사용자 친화적인 한국어로 변환
+ */
+/**
+ * 에이전트 내부 이름을 표시용 이름으로 변환
+ * @param agentName 내부 에이전트 이름
+ * @returns 사용자 친화적인 표시 이름
+ */
+export declare function getAgentDisplayName(agentName: string): string;
+/**
+ * 에이전트 역할 설명 가져오기
+ * @param agentName 내부 에이전트 이름
+ * @returns 에이전트 역할 설명
+ */
+export declare function getAgentDescription(agentName: string): string | undefined;
+/**
+ * 에이전트 작업 시작 메시지 생성
+ * @param agentName 에이전트 이름
+ * @param task 작업 내용 (선택)
+ * @returns 친화적인 작업 시작 메시지
+ */
+export declare function agentStartMessage(agentName: string, task?: string): string;
+/**
+ * 에이전트 작업 완료 메시지 생성
+ * @param agentName 에이전트 이름
+ * @param task 작업 내용 (선택)
+ * @returns 친화적인 작업 완료 메시지
+ */
+export declare function agentCompleteMessage(agentName: string, task?: string): string;
+/**
+ * 에이전트 위임 메시지 생성
+ * @param fromAgent 위임하는 에이전트
+ * @param toAgent 위임받는 에이전트
+ * @param task 위임 작업 (선택)
+ * @returns 친화적인 위임 메시지
+ */
+export declare function agentDelegateMessage(fromAgent: string, toAgent: string, task?: string): string;
+/**
+ * 모든 에이전트 표시 이름 목록 가져오기
+ * @returns 에이전트 이름 매핑 객체
+ */
+export declare function getAllAgentDisplayNames(): Record<string, string>;

package/dist/shared/agent-display.test.d.ts

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

package/dist/shared/claude-config-dir.d.ts

@@ -0,0 +1 @@
+export declare function getClaudeConfigDir(): string;

package/dist/shared/claude-config-dir.test.d.ts

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

package/dist/shared/command-executor.d.ts

@@ -0,0 +1,21 @@
+export interface CommandResult {
+    exitCode: number;
+    stdout?: string;
+    stderr?: string;
+}
+export interface ExecuteHookOptions {
+    forceZsh?: boolean;
+    zshPath?: string;
+}
+/**
+ * Execute a hook command with stdin input
+ */
+export declare function executeHookCommand(command: string, stdin: string, cwd: string, options?: ExecuteHookOptions): Promise<CommandResult>;
+/**
+ * Execute a simple command and return output
+ */
+export declare function executeCommand(command: string): Promise<string>;
+/**
+ * Resolve embedded commands in text recursively
+ */
+export declare function resolveCommandsInText(text: string, depth?: number, maxDepth?: number): Promise<string>;

package/dist/shared/config-errors.d.ts

@@ -0,0 +1,7 @@
+export type ConfigLoadError = {
+    path: string;
+    error: string;
+};
+export declare function getConfigLoadErrors(): ConfigLoadError[];
+export declare function clearConfigLoadErrors(): void;
+export declare function addConfigLoadError(error: ConfigLoadError): void;

package/dist/shared/config-path.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Returns the user-level config directory based on the OS.
+ * - Linux/macOS: XDG_CONFIG_HOME or ~/.config
+ * - Windows: Checks ~/.config first (cross-platform), then %APPDATA% (fallback)
+ *
+ * On Windows, prioritizes ~/.config for cross-platform consistency.
+ * Falls back to %APPDATA% for backward compatibility with existing installations.
+ */
+export declare function getUserConfigDir(): string;
+/**
+ * Returns the full path to the user-level homer-simpson config file.
+ */
+export declare function getUserConfigPath(): string;
+/**
+ * Returns the full path to the project-level homer-simpson config file.
+ */
+export declare function getProjectConfigPath(directory: string): string;

package/dist/shared/data-path.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Returns the user-level data directory.
+ * Matches OpenCode's behavior via xdg-basedir:
+ * - All platforms: XDG_DATA_HOME or ~/.local/share
+ *
+ * Note: OpenCode uses xdg-basedir which returns ~/.local/share on ALL platforms
+ * including Windows, so we match that behavior exactly.
+ */
+export declare function getDataDir(): string;
+/**
+ * Returns the OpenCode storage directory path.
+ * All platforms: ~/.local/share/opencode/storage
+ */
+export declare function getOpenCodeStorageDir(): string;

package/dist/shared/deep-merge.d.ts

@@ -0,0 +1,13 @@
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Deep merges two objects, with override values taking precedence.
+ * - Objects are recursively merged
+ * - Arrays are replaced (not concatenated)
+ * - undefined values in override do not overwrite base values
+ *
+ * @example
+ * deepMerge({ a: 1, b: { c: 2, d: 3 } }, { b: { c: 10 }, e: 5 })
+ * // => { a: 1, b: { c: 10, d: 3 }, e: 5 }
+ */
+export declare function deepMerge<T extends Record<string, unknown>>(base: T, override: Partial<T>, depth?: number): T;
+export declare function deepMerge<T extends Record<string, unknown>>(base: T | undefined, override: T | undefined, depth?: number): T | undefined;

package/dist/shared/dynamic-truncator.d.ts

@@ -0,0 +1,27 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export interface TruncationResult {
+    result: string;
+    truncated: boolean;
+    removedCount?: number;
+}
+export interface TruncationOptions {
+    targetMaxTokens?: number;
+    preserveHeaderLines?: number;
+    contextWindowLimit?: number;
+}
+export declare function truncateToTokenLimit(output: string, maxTokens: number, preserveHeaderLines?: number): TruncationResult;
+export declare function getContextWindowUsage(ctx: PluginInput, sessionID: string): Promise<{
+    usedTokens: number;
+    remainingTokens: number;
+    usagePercentage: number;
+} | null>;
+export declare function dynamicTruncate(ctx: PluginInput, sessionID: string, output: string, options?: TruncationOptions): Promise<TruncationResult>;
+export declare function createDynamicTruncator(ctx: PluginInput): {
+    truncate: (sessionID: string, output: string, options?: TruncationOptions) => Promise<TruncationResult>;
+    getUsage: (sessionID: string) => Promise<{
+        usedTokens: number;
+        remainingTokens: number;
+        usagePercentage: number;
+    } | null>;
+    truncateSync: (output: string, maxTokens: number, preserveHeaderLines?: number) => TruncationResult;
+};

package/dist/shared/external-plugin-detector.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Detects external plugins that may conflict with homer-simpson features.
+ * Used to prevent crashes from concurrent notification plugins.
+ */
+export interface ExternalNotifierResult {
+    detected: boolean;
+    pluginName: string | null;
+    allPlugins: string[];
+}
+/**
+ * Detect if any external notification plugin is configured.
+ * Returns information about detected plugins for logging/warning.
+ */
+export declare function detectExternalNotificationPlugin(directory: string): ExternalNotifierResult;
+/**
+ * Generate a warning message for users with conflicting notification plugins.
+ */
+export declare function getNotificationConflictWarning(pluginName: string): string;

package/dist/shared/external-plugin-detector.test.d.ts

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

package/dist/shared/file-reference-resolver.d.ts

@@ -0,0 +1 @@
+export declare function resolveFileReferencesInText(text: string, cwd?: string, depth?: number, maxDepth?: number): Promise<string>;

package/dist/shared/file-utils.d.ts

@@ -0,0 +1,7 @@
+export declare function isMarkdownFile(entry: {
+    name: string;
+    isFile: () => boolean;
+}): boolean;
+export declare function isSymbolicLink(filePath: string): boolean;
+export declare function resolveSymlink(filePath: string): string;
+export declare function resolveSymlinkAsync(filePath: string): Promise<string>;

package/dist/shared/frontmatter.d.ts

@@ -0,0 +1,7 @@
+export interface FrontmatterResult<T = Record<string, unknown>> {
+    data: T;
+    body: string;
+    hadFrontmatter: boolean;
+    parseError: boolean;
+}
+export declare function parseFrontmatter<T = Record<string, unknown>>(content: string): FrontmatterResult<T>;

package/dist/shared/frontmatter.test.d.ts

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

package/dist/shared/hook-disabled.d.ts

@@ -0,0 +1,2 @@
+import type { ClaudeHookEvent, PluginConfig } from "../hooks/claude-code-hooks/types";
+export declare function isHookDisabled(config: PluginConfig, hookType: ClaudeHookEvent): boolean;

package/dist/shared/index.d.ts

@@ -0,0 +1,24 @@
+export * from "./frontmatter";
+export * from "./command-executor";
+export * from "./file-reference-resolver";
+export * from "./model-sanitizer";
+export * from "./logger";
+export * from "./snake-case";
+export * from "./tool-name";
+export * from "./pattern-matcher";
+export * from "./hook-disabled";
+export * from "./deep-merge";
+export * from "./file-utils";
+export * from "./dynamic-truncator";
+export * from "./config-path";
+export * from "./data-path";
+export * from "./config-errors";
+export * from "./claude-config-dir";
+export * from "./jsonc-parser";
+export * from "./migration";
+export * from "./opencode-config-dir";
+export * from "./opencode-version";
+export * from "./permission-compat";
+export * from "./external-plugin-detector";
+export * from "./messages";
+export * from "./agent-display";

package/dist/shared/jsonc-parser.d.ts

@@ -0,0 +1,15 @@
+export interface JsoncParseResult<T> {
+    data: T | null;
+    errors: Array<{
+        message: string;
+        offset: number;
+        length: number;
+    }>;
+}
+export declare function parseJsonc<T = unknown>(content: string): T;
+export declare function parseJsoncSafe<T = unknown>(content: string): JsoncParseResult<T>;
+export declare function readJsoncFile<T = unknown>(filePath: string): T | null;
+export declare function detectConfigFile(basePath: string): {
+    format: "json" | "jsonc" | "none";
+    path: string;
+};

package/dist/shared/jsonc-parser.test.d.ts

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

package/dist/shared/logger.d.ts

@@ -0,0 +1,2 @@
+export declare function log(message: string, data?: unknown): void;
+export declare function getLogFilePath(): string;

package/dist/shared/messages.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 메시지 친화화 모듈
+ * 기술적인 메시지를 비개발자도 이해할 수 있는 자연어로 변환
+ */
+/**
+ * 기술적인 메시지를 친화적인 표현으로 변환
+ * @param message 원본 메시지
+ * @returns 친화적인 메시지
+ */
+export declare function friendlyMessage(message: string): string;
+/**
+ * 토스트 메시지 친화화
+ * @param title 토스트 제목
+ * @param message 토스트 본문
+ * @returns 친화적인 토스트 메시지
+ */
+export declare function friendlyToast(title: string, message?: string): {
+    title: string;
+    message?: string;
+};
+/**
+ * 에러 메시지 친화화
+ * @param error 에러 객체 또는 메시지
+ * @returns 친화적인 에러 메시지
+ */
+export declare function friendlyError(error: unknown): string;
+/**
+ * 진행 상태 메시지 생성
+ * @param action 현재 작업
+ * @param target 대상 (파일명, 기능명 등)
+ * @returns 친화적인 진행 상태 메시지
+ */
+export declare function progressMessage(action: string, target?: string): string;

package/dist/shared/messages.test.d.ts

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

package/dist/shared/migration.d.ts

@@ -0,0 +1,17 @@
+export declare const AGENT_NAME_MAP: Record<string, string>;
+export declare const HOOK_NAME_MAP: Record<string, string>;
+export declare const MODEL_TO_CATEGORY_MAP: Record<string, string>;
+export declare function migrateAgentNames(agents: Record<string, unknown>): {
+    migrated: Record<string, unknown>;
+    changed: boolean;
+};
+export declare function migrateHookNames(hooks: string[]): {
+    migrated: string[];
+    changed: boolean;
+};
+export declare function migrateAgentConfigToCategory(config: Record<string, unknown>): {
+    migrated: Record<string, unknown>;
+    changed: boolean;
+};
+export declare function shouldDeleteAgentConfig(config: Record<string, unknown>, category: string): boolean;
+export declare function migrateConfigFile(configPath: string, rawConfig: Record<string, unknown>): boolean;

package/dist/shared/migration.test.d.ts

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

package/dist/shared/model-sanitizer.d.ts

@@ -0,0 +1,3 @@
+type CommandSource = "claude-code" | "opencode";
+export declare function sanitizeModelField(model: unknown, source?: CommandSource): string | undefined;
+export {};

package/dist/shared/opencode-config-dir.d.ts

@@ -0,0 +1,19 @@
+export type OpenCodeBinaryType = "opencode" | "opencode-desktop";
+export interface OpenCodeConfigDirOptions {
+    binary: OpenCodeBinaryType;
+    version?: string | null;
+    checkExisting?: boolean;
+}
+export interface OpenCodeConfigPaths {
+    configDir: string;
+    configJson: string;
+    configJsonc: string;
+    packageJson: string;
+    homerConfig: string;
+}
+export declare const TAURI_APP_IDENTIFIER = "ai.opencode.desktop";
+export declare const TAURI_APP_IDENTIFIER_DEV = "ai.opencode.desktop.dev";
+export declare function isDevBuild(version: string | null | undefined): boolean;
+export declare function getOpenCodeConfigDir(options: OpenCodeConfigDirOptions): string;
+export declare function getOpenCodeConfigPaths(options: OpenCodeConfigDirOptions): OpenCodeConfigPaths;
+export declare function detectExistingConfigDir(binary: OpenCodeBinaryType, version?: string | null): string | null;

package/dist/shared/opencode-config-dir.test.d.ts

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

package/dist/shared/opencode-version.d.ts

@@ -0,0 +1,10 @@
+export declare const PERMISSION_BREAKING_VERSION = "1.1.1";
+export declare function parseVersion(version: string): number[];
+export declare function compareVersions(a: string, b: string): -1 | 0 | 1;
+export declare function isVersionGte(a: string, b: string): boolean;
+export declare function isVersionLt(a: string, b: string): boolean;
+export declare function getOpenCodeVersion(): string | null;
+export declare function supportsNewPermissionSystem(): boolean;
+export declare function usesLegacyToolsSystem(): boolean;
+export declare function resetVersionCache(): void;
+export declare function setVersionCache(version: string | null): void;

package/dist/shared/opencode-version.test.d.ts

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

package/dist/shared/pattern-matcher.d.ts

@@ -0,0 +1,3 @@
+import type { ClaudeHooksConfig, HookMatcher } from "../hooks/claude-code-hooks/types";
+export declare function matchesToolMatcher(toolName: string, matcher: string): boolean;
+export declare function findMatchingHooks(config: ClaudeHooksConfig, eventName: keyof ClaudeHooksConfig, toolName?: string): HookMatcher[];

package/dist/shared/permission-compat.d.ts

@@ -0,0 +1,12 @@
+export type PermissionValue = "ask" | "allow" | "deny";
+export interface LegacyToolsFormat {
+    tools: Record<string, boolean>;
+}
+export interface NewPermissionFormat {
+    permission: Record<string, PermissionValue>;
+}
+export type VersionAwareRestrictions = LegacyToolsFormat | NewPermissionFormat;
+export declare function createAgentToolRestrictions(denyTools: string[]): VersionAwareRestrictions;
+export declare function migrateToolsToPermission(tools: Record<string, boolean>): Record<string, PermissionValue>;
+export declare function migratePermissionToTools(permission: Record<string, PermissionValue>): Record<string, boolean>;
+export declare function migrateAgentConfig(config: Record<string, unknown>): Record<string, unknown>;

package/dist/shared/permission-compat.test.d.ts

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

package/dist/shared/snake-case.d.ts

@@ -0,0 +1,4 @@
+export declare function camelToSnake(str: string): string;
+export declare function snakeToCamel(str: string): string;
+export declare function objectToSnakeCase(obj: Record<string, unknown>, deep?: boolean): Record<string, unknown>;
+export declare function objectToCamelCase(obj: Record<string, unknown>, deep?: boolean): Record<string, unknown>;

package/dist/shared/tool-name.d.ts

@@ -0,0 +1 @@
+export declare function transformToolName(toolName: string): string;

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

@@ -0,0 +1,15 @@
+import type { CliLanguage, SgResult } from "./types";
+export interface RunOptions {
+    pattern: string;
+    lang: CliLanguage;
+    paths?: string[];
+    globs?: string[];
+    rewrite?: string;
+    context?: number;
+    updateAll?: boolean;
+}
+export declare function getAstGrepPath(): Promise<string | null>;
+export declare function startBackgroundInit(): void;
+export declare function runSg(options: RunOptions): Promise<SgResult>;
+export declare function isCliAvailable(): boolean;
+export declare function ensureCliAvailable(): Promise<boolean>;

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

@@ -0,0 +1,29 @@
+export declare function findSgCliPathSync(): string | null;
+export declare function getSgCliPath(): string;
+export declare function setSgCliPath(path: string): void;
+export declare const CLI_LANGUAGES: readonly ["bash", "c", "cpp", "csharp", "css", "elixir", "go", "haskell", "html", "java", "javascript", "json", "kotlin", "lua", "nix", "php", "python", "ruby", "rust", "scala", "solidity", "swift", "typescript", "tsx", "yaml"];
+export declare const NAPI_LANGUAGES: readonly ["html", "javascript", "tsx", "css", "typescript"];
+export declare const DEFAULT_TIMEOUT_MS = 300000;
+export declare const DEFAULT_MAX_OUTPUT_BYTES: number;
+export declare const DEFAULT_MAX_MATCHES = 500;
+export declare const LANG_EXTENSIONS: Record<string, string[]>;
+export interface EnvironmentCheckResult {
+    cli: {
+        available: boolean;
+        path: string;
+        error?: string;
+    };
+    napi: {
+        available: boolean;
+        error?: string;
+    };
+}
+/**
+ * Check if ast-grep CLI and NAPI are available.
+ * Call this at startup to provide early feedback about missing dependencies.
+ */
+export declare function checkEnvironment(): EnvironmentCheckResult;
+/**
+ * Format environment check result as user-friendly message.
+ */
+export declare function formatEnvironmentCheck(result: EnvironmentCheckResult): string;

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

@@ -0,0 +1,5 @@
+export declare function getCacheDir(): string;
+export declare function getBinaryName(): string;
+export declare function getCachedBinaryPath(): string | null;
+export declare function downloadAstGrep(version?: string): Promise<string | null>;
+export declare function ensureAstGrepBinary(): Promise<string | null>;

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

@@ -0,0 +1,8 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+import { ast_grep_search, ast_grep_replace } from "./tools";
+export declare const builtinTools: Record<string, ToolDefinition>;
+export { ast_grep_search, ast_grep_replace };
+export { ensureAstGrepBinary, getCachedBinaryPath, getCacheDir } from "./downloader";
+export { getAstGrepPath, isCliAvailable, ensureCliAvailable, startBackgroundInit } from "./cli";
+export { checkEnvironment, formatEnvironmentCheck } from "./constants";
+export type { EnvironmentCheckResult } from "./constants";

package/dist/tools/ast-grep/napi.d.ts

@@ -0,0 +1,13 @@
+import type { NapiLanguage, AnalyzeResult, MetaVariable } from "./types";
+export declare function parseCode(code: string, lang: NapiLanguage): import("@ast-grep/napi").SgRoot<import("@ast-grep/napi/types/staticTypes").TypesMap>;
+export declare function findPattern(root: ReturnType<typeof parseCode>, pattern: string): import("@ast-grep/napi").SgNode<import("@ast-grep/napi/types/staticTypes").TypesMap, import("@ast-grep/napi/types/staticTypes").Kinds<import("@ast-grep/napi/types/staticTypes").TypesMap>>[];
+export declare function extractMetaVariables(node: ReturnType<ReturnType<typeof parseCode>["root"]>, pattern: string): MetaVariable[];
+export declare function analyzeCode(code: string, lang: NapiLanguage, pattern: string, shouldExtractMetaVars: boolean): AnalyzeResult[];
+export declare function transformCode(code: string, lang: NapiLanguage, pattern: string, rewrite: string): {
+    transformed: string;
+    editCount: number;
+};
+export declare function getRootInfo(code: string, lang: NapiLanguage): {
+    kind: string;
+    childCount: number;
+};

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

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

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

@@ -0,0 +1,58 @@
+import type { CLI_LANGUAGES, NAPI_LANGUAGES } from "./constants";
+export type CliLanguage = (typeof CLI_LANGUAGES)[number];
+export type NapiLanguage = (typeof NAPI_LANGUAGES)[number];
+export interface Position {
+    line: number;
+    column: number;
+}
+export interface Range {
+    start: Position;
+    end: Position;
+}
+export interface CliMatch {
+    text: string;
+    range: {
+        byteOffset: {
+            start: number;
+            end: number;
+        };
+        start: Position;
+        end: Position;
+    };
+    file: string;
+    lines: string;
+    charCount: {
+        leading: number;
+        trailing: number;
+    };
+    language: string;
+}
+export interface SearchMatch {
+    file: string;
+    text: string;
+    range: Range;
+    lines: string;
+}
+export interface MetaVariable {
+    name: string;
+    text: string;
+    kind: string;
+}
+export interface AnalyzeResult {
+    text: string;
+    range: Range;
+    kind: string;
+    metaVariables: MetaVariable[];
+}
+export interface TransformResult {
+    original: string;
+    transformed: string;
+    editCount: number;
+}
+export interface SgResult {
+    matches: CliMatch[];
+    totalMatches: number;
+    truncated: boolean;
+    truncatedReason?: "max_matches" | "max_output_bytes" | "timeout";
+    error?: string;
+}

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

@@ -0,0 +1,5 @@
+import type { AnalyzeResult, SgResult } from "./types";
+export declare function formatSearchResult(result: SgResult): string;
+export declare function formatReplaceResult(result: SgResult, isDryRun: boolean): string;
+export declare function formatAnalyzeResult(results: AnalyzeResult[], extractedMetaVars: boolean): string;
+export declare function formatTransformResult(_original: string, transformed: string, editCount: number): string;

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

@@ -0,0 +1,3 @@
+export declare const BACKGROUND_TASK_DESCRIPTION = "Run agent task in background. Returns task_id immediately; notifies on completion.\n\nUse `background_output` to get results. Prompts MUST be in English.";
+export declare const BACKGROUND_OUTPUT_DESCRIPTION = "Get output from background task. System notifies on completion, so block=true rarely needed.";
+export declare const BACKGROUND_CANCEL_DESCRIPTION = "Cancel running background task(s). Use all=true to cancel ALL before final answer.";

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

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