@jarkkojs/readseek-api 0.10.7 → 0.11.1

package/dist/client.d.ts

@@ -1,39 +1,32 @@
-import { type DefLocation, type EditOutput, type IdentifyOutput, type ReadSeekCheckOutput, type ReadSeekDetection, type ReadSeekDocumentCache, type ReadSeekImageDetection, type ReadSeekMapOutput, type ReadSeekPreparedImage, type ReadSeekReadOutput, type ReadSeekReference, type ReadSeekSearchOutput, type RenameOutput } from "./client-output.ts";
-import type { GitScope, InspectFacet, VisionAnalysisMode, VisionLevel, VisionMode } from "./contract.ts";
-export type { DefLocation, EditOutput, IdentifierOutput, IdentifyOutput, ReadSeekCheckOutput, ReadSeekDetectedObject, ReadSeekDetection, ReadSeekDiagnostic, ReadSeekDocumentCache, ReadSeekHashline, ReadSeekImageDetection, ReadSeekMapNode, ReadSeekMapOutput, ReadSeekOcrText, ReadSeekPreparedImage, ReadSeekReadOutput, ReadSeekReference, ReadSeekSearchCapture, ReadSeekSearchFileOutput, ReadSeekSearchMatch, ReadSeekSearchOutput, ReadSeekSymbol, RenameConflict, RenameEdit, RenameFileOutput, RenameOutput, } from "./client-output.ts";
-export type ReadSeekImageMode = VisionAnalysisMode;
-export interface ReadSeekInspectOptions {
-    select?: InspectFacet | InspectFacet[];
-    selector?: string;
-    query?: string;
-    end?: number;
-    limit?: number;
-    depth?: number;
-    language?: string;
-    visionMode?: VisionMode;
-    visionLevel?: VisionLevel;
-    stdin?: string;
-    stdinName?: string;
+import * as argv from "./argv.ts";
+import * as output from "./client-output.ts";
+export type * from "./client-output.ts";
+export interface ReadSeekRunOptions {
     signal?: AbortSignal;
-    timeoutMs?: number;
-    /** Route through the runner's vision path (serialized, long timeout). */
-    vision?: boolean;
-}
-export interface ReadSeekInspectOutput {
-    metadata?: ReadSeekDetection;
-    cache?: ReadSeekDocumentCache;
-    content?: unknown;
-    map?: ReadSeekMapOutput;
-    diagnostics?: ReadSeekCheckOutput;
-    identity?: IdentifyOutput;
-}
-export interface ReadSeekExtractOptions {
     stdin?: string;
-    stdinName?: string;
-    signal?: AbortSignal;
     timeoutMs?: number;
     cancelable?: boolean;
+    vision?: boolean;
+}
+export interface ReadSeekRunner {
+    text(args: readonly string[], options?: ReadSeekRunOptions): Promise<string>;
+    kdl(args: readonly string[], options?: ReadSeekRunOptions): Promise<unknown>;
 }
+type Options<T> = Omit<T, "path" | "requestFromStdin" | "flagOrder"> & Omit<ReadSeekRunOptions, "vision">;
+export type ReadSeekContentOptions = Options<argv.ShowContentArgsInput>;
+export type ReadSeekStructureOptions = Options<argv.ShowStructureArgsInput>;
+export type ReadSeekMetadataOptions = Options<argv.ShowMetadataArgsInput>;
+export type ReadSeekAssetsOptions = Options<argv.ShowAssetsArgsInput>;
+export type ReadSeekSyntaxOptions = Options<argv.CheckSyntaxArgsInput>;
+export type ReadSeekRulesOptions = Options<argv.CheckRulesArgsInput>;
+export type ReadSeekCaptionOptions = Options<argv.GenerateCaptionArgsInput>;
+export type ReadSeekVisionOptions = Options<argv.DetectObjectsArgsInput>;
+export type ReadSeekNodesOptions = Options<argv.FindNodesArgsInput>;
+export type ReadSeekTextOptions = Options<argv.FindTextArgsInput>;
+export type ReadSeekDefinitionsOptions = Options<argv.FindDefinitionsArgsInput>;
+export type ReadSeekReferencesOptions = Options<argv.FindReferencesArgsInput>;
+export type ReadSeekEditOptions = Options<argv.EditTextArgsInput>;
+export type ReadSeekRenameOptions = Options<argv.RenameSymbolArgsInput>;
 export interface ReadSeekFailure {
     code: "readseek-not-installed" | "readseek-execution-error";
     message: string;
@@ -45,103 +38,21 @@ export interface ReadSeekFailure {
  * install hint) versus any other execution error.
  */
 export declare function classifyReadSeekFailure(err: unknown): ReadSeekFailure;
-export interface ReadSeekRunOptions {
-    signal?: AbortSignal;
-    stdin?: string;
-    timeoutMs?: number;
-    cancelable?: boolean;
-    /** Set by callers that read a vision payload; the runner may serialize and lengthen timeouts. */
-    vision?: boolean;
-}
-/**
- * Host-supplied spawn seam: resolve the binary and run it, returning stdout as
- * text or decoded KDL. The plugin owns binary resolution, cache-dir decoration,
- * cwd, timeout settings, and any vision serialization queue; the client owns
- * argv construction and output parsing.
- */
-export interface ReadSeekRunner {
-    text(args: readonly string[], options?: ReadSeekRunOptions): Promise<string>;
-    kdl(args: readonly string[], options?: ReadSeekRunOptions): Promise<unknown>;
-}
-interface ReadSeekSearchOptions {
-    language?: string;
-    limit?: number;
-    gitScope?: GitScope;
-    signal?: AbortSignal;
-}
-interface ReadSeekRefsOptions {
-    name?: string;
-    scope?: boolean;
-    line?: number;
-    column?: number;
-    language?: string;
-    gitScope?: GitScope;
-    signal?: AbortSignal;
-}
-interface DefOptions {
-    name: string;
-    language?: string;
-    gitScope?: GitScope;
-    signal?: AbortSignal;
-}
-interface EditOptions {
-    apply?: boolean;
-    planHash?: string;
-    language?: string;
-    signal?: AbortSignal;
-    timeoutMs?: number;
-    cancelable?: boolean;
-}
-interface RenameOptions {
-    to: string;
-    line: number;
-    column?: number;
-    workspace?: string;
-    apply?: boolean;
-    planHash?: string;
-    language?: string;
-    gitScope?: GitScope;
-    signal?: AbortSignal;
-}
-interface IdentifyOptions {
-    line: number;
-    column?: number;
-    language?: string;
-    signal?: AbortSignal;
-}
 export interface ReadSeekClient {
-    inspect(target: string, options?: ReadSeekInspectOptions): Promise<unknown>;
-    inspectText(target: string, options?: ReadSeekInspectOptions): Promise<string>;
-    inspectContent(filePath: string, options?: {
-        startLine?: number;
-        endLine?: number;
-        visionMode?: "none" | ReadSeekImageMode;
-        signal?: AbortSignal;
-        vision?: boolean;
-    }): Promise<{
-        metadata: ReadSeekDetection;
-        cache?: ReadSeekDocumentCache;
-        text?: ReadSeekReadOutput;
-        image?: ReadSeekImageDetection;
-    }>;
-    extract(target: string, selector: string, output: string, options?: ReadSeekExtractOptions): Promise<void>;
-    image(filePath: string, modes: ReadSeekImageMode[], options?: {
-        signal?: AbortSignal;
-    }): Promise<ReadSeekDetection>;
-    preparedImage(filePath: string, options?: {
-        signal?: AbortSignal;
-    }): Promise<ReadSeekPreparedImage>;
-    search(target: string, pattern: string, options?: ReadSeekSearchOptions): Promise<ReadSeekSearchOutput>;
-    refs(target: string, options?: ReadSeekRefsOptions): Promise<ReadSeekReference[]>;
-    def(target: string, options: DefOptions): Promise<DefLocation[]>;
-    check(filePath: string, content: string, options?: {
-        signal?: AbortSignal;
-    }): Promise<ReadSeekCheckOutput>;
-    identify(filePath: string, content: string, options: IdentifyOptions): Promise<IdentifyOutput>;
-    detect(filePath: string, options?: {
-        signal?: AbortSignal;
-    }): Promise<ReadSeekDetection>;
-    edit(filePath: string, edits: unknown[], options?: EditOptions): Promise<EditOutput>;
-    rename(filePath: string, options: RenameOptions): Promise<RenameOutput>;
+    showContent(path: string, options?: ReadSeekContentOptions): Promise<output.ReadSeekContentOutput>;
+    showStructure(path: string, options?: ReadSeekStructureOptions): Promise<output.ReadSeekStructureOutputEnvelope>;
+    showMetadata(path: string, options?: ReadSeekMetadataOptions): Promise<output.ReadSeekDetection>;
+    showAssets(path: string, options?: ReadSeekAssetsOptions): Promise<output.ReadSeekAssetsOutput>;
+    checkSyntax(path: string, options?: ReadSeekSyntaxOptions): Promise<output.ReadSeekCheckOutput>;
+    checkRules(path: string, options: ReadSeekRulesOptions): Promise<output.ReadSeekRulesOutput>;
+    generateCaption(path: string, options?: ReadSeekCaptionOptions): Promise<output.ReadSeekContentOutput>;
+    detectObjects(path: string, options?: ReadSeekVisionOptions): Promise<output.ReadSeekContentOutput>;
+    recognizeText(path: string, options?: ReadSeekVisionOptions): Promise<output.ReadSeekContentOutput>;
+    findNodes(path: string, options: ReadSeekNodesOptions): Promise<output.ReadSeekSearchOutput>;
+    findText(path: string, options: ReadSeekTextOptions): Promise<output.ReadSeekTextSearchOutput>;
+    findDefinitions(path: string, options: ReadSeekDefinitionsOptions): Promise<output.DefLocation[]>;
+    findReferences(path: string, options: ReadSeekReferencesOptions): Promise<output.ReadSeekReference[]>;
+    editText(path: string, edits: unknown[], options?: ReadSeekEditOptions): Promise<output.EditOutput>;
+    renameSymbol(path: string, options: ReadSeekRenameOptions): Promise<output.RenameOutput>;
 }
 export declare function createReadSeekClient(runner: ReadSeekRunner): ReadSeekClient;

package/dist/contract.d.ts

@@ -1,16 +1,10 @@
-export declare const INSPECT_FACETS: readonly ["metadata", "content", "map", "diagnostics", "identity"];
-export type InspectFacet = (typeof INSPECT_FACETS)[number];
-export declare const VISION_MODES: readonly ["none", "all", "ocr", "caption", "objects"];
-export type VisionMode = (typeof VISION_MODES)[number];
-export declare const VISION_ANALYSIS_MODES: readonly ["all", "ocr", "caption", "objects"];
-export type VisionAnalysisMode = (typeof VISION_ANALYSIS_MODES)[number];
 export declare const VISION_LEVELS: readonly ["low", "medium", "high"];
 export type VisionLevel = (typeof VISION_LEVELS)[number];
 export declare const EDIT_VARIANTS: readonly ["set_line", "replace_lines", "insert_after", "replace", "replace_symbol"];
 export type EditVariant = (typeof EDIT_VARIANTS)[number];
 export declare const GIT_SCOPES: readonly ["tracked", "untracked", "ignored", "all"];
 export type GitScope = (typeof GIT_SCOPES)[number];
-export declare const TOOL_NAMES: readonly ["inspect", "edit", "write", "grep", "extract", "search", "def", "refs", "rename"];
+export declare const TOOL_NAMES: readonly ["show_content", "show_structure", "show_metadata", "show_assets", "check_syntax", "check_rules", "generate_caption", "detect_objects", "recognize_text", "find_nodes", "find_text", "find_definitions", "find_references", "edit_text", "rename_symbol", "write_file"];
 export type ToolName = (typeof TOOL_NAMES)[number];
 export declare const PARAM_DESCRIPTIONS: {
     readonly path: "Absolute or relative file path";
@@ -21,31 +15,30 @@ export declare const PARAM_DESCRIPTIONS: {
     readonly languageOverride: "Language override";
     readonly languageSymbol: "Language override for symbol replacement";
     readonly pattern: "AST pattern (ast-grep style), such as console.log($$$ARGS)";
+    readonly patternContext: "Surrounding code context for sub-statement patterns";
+    readonly selector: "Target AST node kind to extract from pattern context";
     readonly grepPattern: "Regex pattern; set literal for exact text";
     readonly name: "Qualified or unqualified symbol name";
     readonly refsName: "Identifier to find references for";
-    readonly scope: "Restrict results to the binding at the cursor";
-    readonly line: "One-based cursor line; required with scope";
-    readonly renameLine: "One-based cursor line of the symbol to rename";
-    readonly column: "One-based cursor byte column for disambiguation";
     readonly gitScope: "In a Git repository, which files to search: tracked, untracked, ignored (untracked plus ignored), or all. Defaults to tracked plus untracked.";
-    readonly select: "Facets: metadata, content, map, diagnostics, identity (default content)";
-    readonly selectComma: "Comma-separated facets: metadata, content, map, diagnostics, identity";
-    readonly selector: "Positional selector: line:N[:COLUMN], hash:H[:COLUMN], symbol:NAME, page:N, node:ID, or asset:ID. Columns require the identity facet, which in turn rejects symbol selectors";
-    readonly assetSelector: "Document asset selector in the form asset:ID";
-    readonly query: "KDL selection query, @path, or '-' for standard input";
+    readonly at: "Location selector: line:N[:COLUMN], hash:H[:COLUMN], symbol:NAME, page:N, node:ID, or asset:ID";
+    readonly assetAt: "Document selector: page:N, node:ID, or asset:ID";
+    readonly rule: "KDL node selection rule, @path, or '-' for standard input";
+    readonly rules: "KDL structural checks, @path, or '-' for standard input";
     readonly stdinName: "File name hint when the target is '-'";
     readonly end: "Last line to include";
     readonly limit: "Maximum number of lines to include";
-    readonly inspectDepth: "Maximum structural depth for map output; defaults to 1 in agent tools";
+    readonly depth: "Maximum structural depth for structure output; defaults to 1 in agent tools";
     readonly offset: "One-based starting line";
     readonly readLimit: "Maximum lines to return";
     readonly symbolRead: "Symbol name to read";
     readonly bundle: "Include related symbols from the same file; requires symbol";
-    readonly image: "Standalone image mode: none, all, ocr, caption, objects. Required for standalone images.";
-    readonly visionModeInspect: "Standalone image mode: none, all, caption, objects, or ocr";
-    readonly visionLevel: "Vision inference level: low (default), medium, or high";
-    readonly output: "Destination file for extracted binary data; stdout is not supported";
+    readonly level: "Explicit inference level: low (default), medium, or high";
+    readonly include: "Additional caption tasks: text and/or objects";
+    readonly kind: "Restrict structure to this node kind";
+    readonly outline: "Return a symbol outline";
+    readonly noAnchors: "Omit source line anchors";
+    readonly text: "Literal native text query; adapter find_text also supports regex via pattern";
     readonly edits: "Use set_line, replace_lines, insert_after, replace_symbol, or replace";
     readonly editVariant: "Exactly one nested edit variant";
     readonly setLine: "Replace one line: {\"set_line\":{\"anchor\":\"LINE:HASH\",\"new_text\":\"...\"}}";
@@ -82,15 +75,22 @@ export declare const PARAM_DESCRIPTIONS: {
     readonly scopeContext: "Context lines within each symbol";
 };
 export declare const TOOL_DESCRIPTIONS: {
-    readonly inspect: "Inspect source content, images, and documents through the native CLI envelope. Use it before edits to obtain fresh `LINE:HASH` anchors; use shallow maps for structural overviews, diagnostics for syntax checks, and identity for cursor context.";
-    readonly edit: "Edit existing text files with fresh `LINE:HASH` anchors. Read or search first when no fresh anchors are available. Each `edits[]` item must use exactly one nested object: `{\"set_line\":{\"anchor\":\"LINE:HASH\",\"new_text\":\"...\"}}`, `{\"replace_lines\":{\"start_anchor\":\"LINE:HASH\",\"end_anchor\":\"LINE:HASH\",\"new_text\":\"...\"}}`, `{\"insert_after\":{\"anchor\":\"LINE:HASH\",\"new_text\":\"...\"}}`, `{\"replace_symbol\":{\"symbol\":\"name\",\"new_body\":\"...\"}}`, or `{\"replace\":{\"old_text\":\"...\",\"new_text\":\"...\"}}`.";
-    readonly write: "Create or replace a complete text file and return `LINE:HASH` anchors. Use `edit` for small changes to an existing file.";
-    readonly grep: "Search text or regex in files and return edit-ready `LINE:HASH` anchors. Use for identifiers, strings, configuration, errors, comments, and documentation.";
-    readonly extract: "Extract a selected document asset into a destination file. Use an `asset:ID` selector discovered through `inspect`; extracted binary data is never returned on stdout.";
-    readonly search: "Search code by AST structure using ast-grep-style patterns. Results include line hashes usable as `LINE:HASH` anchors. Use `grep` for identifiers, strings, comments, configuration, documentation, or other plain text and regex.";
-    readonly def: "Go to a symbol definition or declaration by name. Accepts qualified or unqualified names; use this instead of text search for functions, methods, classes, types, and other declarations.";
-    readonly refs: "Find references or usages of an identifier by name or cursor binding. Results include enclosing symbols and line hashes usable as `LINE:HASH` anchors. Without cursor scope, results are identifier-name matches; with scope, they follow one binding and exclude shadows. Use text search for literals, and use this before renaming or deleting a symbol.";
-    readonly rename: "Rename a symbol at a source location. Resolvable same-named bindings are preserved; verified edits apply by default. Set `apply: false` to preview the plan before changing files.";
+    readonly show_content: "Read source, document content, or image descriptors without inference. Obtain fresh `LINE:HASH` anchors before edits; use at with a column for cursor context. Document results include typed nodes and cached asset paths.";
+    readonly show_structure: "Show parsed source or document hierarchy. Use shallow depth for file overviews.";
+    readonly show_metadata: "Show format, source identity, language, dimensions, or page count without decoding image content or inference.";
+    readonly show_assets: "Return selected document asset descriptors with usable cached paths. Adapters attach images from those paths.";
+    readonly check_syntax: "Check parser syntax diagnostics. Exit 0 is clean, 1 has findings, 2 is failure; this is not type checking.";
+    readonly check_rules: "Evaluate KDL structural assertions. Exit 0 is clean, 1 has findings, 2 is failure.";
+    readonly generate_caption: "Explicitly infer a caption using an installed model. Include text and objects to request OCR and detection too; never downloads models automatically.";
+    readonly detect_objects: "Explicitly infer object labels and bounding boxes using an installed model.";
+    readonly recognize_text: "Explicitly recognize text from pixels using an installed model; reading never silently invokes OCR.";
+    readonly find_nodes: "Find AST nodes by pattern or KDL selection rule. Returns edit-ready anchors. Use `find_text` for text and regex.";
+    readonly find_text: "Search text or regex and return edit-ready `LINE:HASH` anchors. Native CLI text is literal; adapters preserve regex, glob, context, summary, and symbol grouping.";
+    readonly find_definitions: "Find a symbol definition or declaration by qualified or unqualified name.";
+    readonly find_references: "Find identifier-name matches with name, or binding-scoped references with at. Use before renaming or deleting a symbol.";
+    readonly edit_text: "Edit existing files with fresh `LINE:HASH` anchors. Each edits item contains exactly one set_line, replace_lines, insert_after, replace_symbol, or replace object. Preview before applying a verified plan.";
+    readonly rename_symbol: "Rename a symbol at a line or hash cursor with binding-aware edits and stale-plan protection.";
+    readonly write_file: "Create or replace a complete text file and return `LINE:HASH` anchors. Use `edit_text` for small changes.";
 };
 export declare function renderToolDescription(name: ToolName, aliases?: Readonly<Partial<Record<ToolName, string>>>): string;
 export type JsonSchema = {

package/dist/index.d.ts

@@ -1,14 +1,15 @@
-export { INSPECT_FACETS, EDIT_VARIANTS, GIT_SCOPES, PARAM_DESCRIPTIONS, TOOL_CONTRACTS, getToolContract, TOOL_DESCRIPTIONS, TOOL_NAMES, renderToolDescription, VISION_ANALYSIS_MODES, VISION_LEVELS, VISION_MODES, type InspectFacet, type EditVariant, type GitScope, type JsonSchema, type ToolContract, type ToolName, type VisionAnalysisMode, type VisionLevel, type VisionMode, } from "./contract.ts";
-export { BUILTIN_FALLBACKS, REPLACEABLE_TOOLS, TOOL_COMPACT_GUIDELINES, fallbackToolDescriptionMap, preferredToolDescriptionMap, renderCompactGuidelines, renderFallbackToolDescription, renderPreferredToolDescription, renderToolRoutingPolicy, resolveToolName, rewriteBacktickedToolNames, type ReplaceableTool, type ToolAliasMap, type ToolRoutingPolicyOptions, } from "./policy.ts";
-export { coerceBoolean, coerceNonNegativeInt, coerceObviousBase10Int, coerceOptionalString, coercePositiveInt, validateExactlyOneEditVariant, validateRefsNameVsScope, validateVisionLevelVsMode, type CoercedIntResult, type EditItem, type EditObject, type InsertAfterEdit, type RefsScopeInput, type ReplaceEdit, type ReplaceLinesEdit, type ReplaceSymbolEdit, type SetLineEdit, type ValidationResult, type VisionInput, } from "./validation.ts";
+export * from "./contract.ts";
+export * from "./policy.ts";
+export * from "./validation.ts";
+export * from "./argv.ts";
+export * from "./client.ts";
 export { serializeEditPlan } from "./edit-plan.ts";
-export { HASH_LEN, parseLineAnchor, tryParseLineAnchor, type LineAnchor, } from "./hashline.ts";
-export { appendApplyAndPlanHash, appendGitScopeArgs, type GitScopeInput, buildDefArgs, buildExtractArgs, buildInspectArgs, DEFAULT_INSPECT_MAP_DEPTH, buildEditArgs, buildLineLocation, buildRefsArgs, buildRenameArgs, buildSearchArgs, type ApplyPlanHashInput, type ApplyPlanHashOrder, type DefArgsInput, type ExtractArgsInput, type InspectArgsInput, type EditArgsInput, type RefsArgsInput, type RenameArgsInput, type SearchArgsInput, } from "./argv.ts";
+export * from "./hashline.ts";
+export * from "./show-presentation.ts";
 export { READSEEK_BINARY_ENV, READSEEK_PLATFORM_PACKAGES, readSeekBinaryName, readSeekPlatformKey, resolveReadSeekBinaryFromPackages, resolveReadSeekBinaryOverride, resolveReadSeekCacheDir, type ModuleResolver, type ReadSeekCacheOptions, } from "./platform.ts";
 export { canonicalPathKey, expandUserPath, isSubPath, resolveScopedPath, resolveToCwd, } from "./path.ts";
 export { cleanReadSeekErrorText } from "./error.ts";
 export { parseReadSeekKdl } from "./output-kdl.ts";
-export { DEFAULT_MAX_OUTPUT_BYTES, DEFAULT_READSEEK_TIMEOUT_MS, ensureSuccessfulStdout, failureFromProcessResult, parseSuccessfulKdl, readSeekProcessEnvironment, resolveProcessLimits, type ProcessRunOptions, type ProcessRunResult, } from "./process.ts";
+export { DEFAULT_MAX_OUTPUT_BYTES, DEFAULT_READSEEK_TIMEOUT_MS, acceptsReadSeekExitCode, ensureSuccessfulStdout, failureFromProcessResult, parseSuccessfulKdl, readSeekProcessEnvironment, resolveProcessLimits, type ProcessRunOptions, type ProcessRunResult, } from "./process.ts";
 export { runReadSeekNode, runReadSeekNodeKdl, runReadSeekNodeText, } from "./process-node.ts";
 export { runReadSeekBun, runReadSeekBunKdl, runReadSeekBunText, } from "./process-bun.ts";
-export { classifyReadSeekFailure, createReadSeekClient, type DefLocation, type EditOutput, type IdentifierOutput, type IdentifyOutput, type ReadSeekCheckOutput, type ReadSeekClient, type ReadSeekDetection, type ReadSeekDetectedObject, type ReadSeekDiagnostic, type ReadSeekExtractOptions, type ReadSeekInspectOptions, type ReadSeekInspectOutput, type ReadSeekDocumentCache, type ReadSeekFailure, type ReadSeekHashline, type ReadSeekImageDetection, type ReadSeekImageMode, type ReadSeekMapOutput, type ReadSeekMapNode, type ReadSeekOcrText, type ReadSeekPreparedImage, type ReadSeekReadOutput, type ReadSeekReference, type ReadSeekRunOptions, type ReadSeekRunner, type RenameConflict, type RenameEdit, type RenameFileOutput, type RenameOutput, type ReadSeekSearchCapture, type ReadSeekSearchFileOutput, type ReadSeekSearchMatch, type ReadSeekSymbol, } from "./client.ts";