@swoop111/dsh-tool-fs 0.0.0-stage → 0.2.0-rc.2.1

package/lib/types/completion.d.ts

@@ -0,0 +1,58 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+import type { FileTextLine } from './read-render.ts';
+import type { CompletionRule } from './structure.ts';
+ 
+export type LineSupplier = (count: number) => Promise<FileTextLine[] | undefined>;
+ 
+export interface CompletionLineSuppliers {
+    
+
+
+
+    preceding: LineSupplier;
+    
+
+
+
+    following: LineSupplier;
+}
+ 
+export interface CompletionTuning {
+    
+
+
+
+    maxLines: number;
+}
+ 
+export interface CompletionResult {
+     
+    head: FileTextLine[];
+     
+    tail: FileTextLine[];
+     
+    headRule?: CompletionRule;
+     
+    tailRule?: CompletionRule;
+}
+
+
+
+
+
+
+
+export declare function completeWindow(lines: readonly FileTextLine[], supply: CompletionLineSuppliers, tuning: CompletionTuning): Promise<CompletionResult | undefined>;
+ 

package/lib/types/diff.d.ts

@@ -0,0 +1,41 @@
+
+
+
+
+
+import type { FileDiff } from '@deepseek-ai/dsh-tools';
+ 
+export declare const DIFF_CONTEXT = 3;
+
+
+
+
+
+
+
+
+
+export type FsDiffMeta = {
+    diffs: FileDiff[];
+    operation?: 'create' | 'update';
+};
+
+
+
+
+
+
+
+
+
+
+
+export declare function computeHunkDiffs(path: string, before: string, after: string): FileDiff[];
+
+
+
+
+
+
+export declare function diffsFromMeta(meta: unknown): FileDiff[] | undefined;
+ 

package/lib/types/edit.d.ts

@@ -0,0 +1,73 @@
+
+
+
+
+
+
+
+
+import type { Context } from '@deepseek-ai/cordis';
+import type { Session } from '@deepseek-ai/dsh-session';
+import type { FsSandboxController } from './sandbox.ts';
+ 
+export interface EditRepairConfig {
+     
+    enabled?: boolean;
+     
+    maxFileChars?: number;
+     
+    maxWindowLines?: number;
+}
+
+
+
+
+export interface EditRepairTuning {
+     
+    enabled: boolean;
+     
+    maxFileChars: number;
+     
+    maxWindowLines: number;
+    
+
+
+
+    priorPaths(session: Session | undefined, limit?: number): string[];
+}
+ 
+interface EditInput {
+    filePath: string;
+    oldString: string;
+    newString: string;
+    replaceAll: boolean;
+}
+
+
+
+
+
+
+
+export declare function parseEditArgs(args: {
+    file_path: string;
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean;
+}): EditInput;
+
+
+
+
+
+
+export declare function formatEditOutput(displayPath: string, replaceAll: boolean): string;
+
+
+
+
+
+
+export declare function applyEditTool(ctx: Context, sandbox: FsSandboxController, repair: EditRepairTuning): void;
+export {};
+ 

package/lib/types/error.d.ts

@@ -0,0 +1,19 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export declare function remediateFsError(error: unknown, displayPath: string): unknown;
+ 

package/lib/types/index.d.ts

@@ -0,0 +1,36 @@
+
+
+
+
+
+
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import type { ReadRepairConfig } from './read.ts';
+import type { WriteRepairConfig } from './write.ts';
+import type { EditRepairConfig } from './edit.ts';
+ 
+export declare const name = "tool-fs";
+ 
+export declare const inject: string[];
+ 
+export interface Config {
+     
+    readLimit?: number;
+     
+    readMaxLineLength?: number;
+     
+    readMaxBytes?: number;
+     
+    readStreamMinSize?: number;
+     
+    editRepair?: EditRepairConfig;
+     
+    readRepair?: ReadRepairConfig;
+     
+    writeRepair?: WriteRepairConfig;
+}
+export declare const Config: z<Config>;
+ 
+export declare function apply(ctx: Context, config: Config): void;
+ 

package/lib/types/read-image.d.ts

@@ -0,0 +1,80 @@
+
+
+
+
+
+
+
+
+
+
+
+
+import type { Context } from '@deepseek-ai/cordis';
+import type { ImageAttachmentRef, ImageMediaType } from '@deepseek-ai/dsh-attachment';
+import type { ToolExecution } from '@deepseek-ai/dsh-tools';
+
+
+
+
+
+export declare function sniffImageMediaType(data: Uint8Array): ImageMediaType | undefined;
+ 
+export interface ImageReadValue {
+    path: string;
+    image: {
+        attachmentId: string;
+        mediaType: ImageMediaType;
+        bytes: number;
+        width: number;
+        height: number;
+        name?: string;
+         
+        originalDimensions?: {
+            width: number;
+            height: number;
+        };
+    };
+}
+
+
+
+
+
+export declare function imageMediaTypeForPath(filePath: string): ImageMediaType | undefined;
+
+
+
+
+
+
+
+
+export declare function assertImageCapableRoute(ctx: Context, exec: ToolExecution, requestedPath: string): Promise<void>;
+
+
+
+
+
+
+export declare function imageRefFromValue(image: ImageReadValue['image']): ImageAttachmentRef;
+
+
+
+
+
+
+
+
+export declare function formatImageReadOutput(displayPath: string, image: ImageReadValue['image']): string;
+
+
+
+
+
+
+
+
+
+export declare function applyReadImageTool(ctx: Context): void;
+ 

package/lib/types/read-render.d.ts

@@ -0,0 +1,129 @@
+
+
+
+
+
+
+ 
+export declare const READ_MAX_LINE_LENGTH = 2000;
+ 
+export declare const READ_MAX_BYTES: number;
+ 
+export interface ReadWindow {
+     
+    offset: number;
+     
+    limit: number;
+     
+    maxLineLength: number;
+     
+    maxBytes: number;
+}
+ 
+export interface FileTextLine {
+     
+    number: number;
+     
+    text: string;
+}
+ 
+export interface WindowResult {
+     
+    lines: FileTextLine[];
+     
+    totalLines: number;
+     
+    truncatedByBytes: boolean;
+}
+ 
+export interface FileReadOutcome {
+     
+    offset: number;
+     
+    lines: FileTextLine[];
+     
+    totalLines: number;
+     
+    truncatedByBytes?: true;
+     
+    repairNote?: string;
+}
+ 
+export interface OffsetOutOfRange {
+     
+    requestedOffset: number;
+     
+    totalLines: number;
+}
+
+
+
+
+
+
+
+
+export declare function parseOffsetOutOfRange(error: unknown): OffsetOutOfRange | undefined;
+
+
+
+
+
+
+
+
+
+export declare function buildWindow(chunks: AsyncIterable<string> | Iterable<string>, request: ReadWindow, displayPath: string): Promise<WindowResult>;
+
+
+
+
+
+
+export declare function formatReadOutput(displayPath: string, outcome: FileReadOutcome): string;
+
+
+
+
+
+
+
+
+
+
+export { readLangHintForPath as langFromPath } from '@deepseek-ai/dsh-util-code-language';
+
+
+
+
+
+
+
+
+export interface FsReadMeta {
+     
+    path: string;
+     
+    offset: number;
+     
+    lines: FileTextLine[];
+     
+    totalLines: number;
+     
+    lang?: string;
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+export declare function readMetaFromMeta(meta: unknown): FsReadMeta | undefined;
+ 

package/lib/types/read-target.d.ts

@@ -0,0 +1,33 @@
+
+
+
+
+import type { Context } from '@deepseek-ai/cordis';
+import type { FsInfo, FsTarget } from '@deepseek-ai/dsh-fs';
+import type { ToolExecution } from '@deepseek-ai/dsh-tools';
+import type { MissingPathRepair } from '@deepseek-ai/dsh-fs-edit-repair';
+
+
+
+
+
+
+
+export declare function resolveRegularReadTarget(ctx: Context, exec: ToolExecution, requestedPath: string): Promise<{
+    target: FsTarget;
+    info: FsInfo;
+}>;
+
+
+
+
+
+
+
+
+
+
+
+
+export declare function repairTargetPath(ctx: Context, exec: ToolExecution, requestedPath: string, knownPaths: readonly string[]): Promise<MissingPathRepair | undefined>;
+ 

package/lib/types/read.d.ts

@@ -0,0 +1,150 @@
+
+
+
+
+
+import type { Context } from '@deepseek-ai/cordis';
+import type { ReadArgRepair } from '@deepseek-ai/dsh-arg-repair';
+import type { Session } from '@deepseek-ai/dsh-session';
+import type { ReadDuplicateVerdict } from '@deepseek-ai/dsh-fs-edit-repair';
+ 
+export declare const READ_LIMIT = 2000;
+
+
+
+
+export declare const STREAM_MIN_SIZE: number;
+ 
+export interface ReadToolCaps {
+     
+    limit: number;
+     
+    maxLineLength: number;
+     
+    maxBytes: number;
+     
+    streamMinSize: number;
+}
+
+
+
+
+export interface ReadRepairConfig {
+     
+    enabled?: boolean;
+    
+
+
+
+
+    duplicate?: {
+         
+        enabled?: boolean;
+         
+        maxSteps?: number;
+    };
+    
+
+
+
+
+
+    completion?: {
+         
+        enabled?: boolean;
+         
+        maxLines?: number;
+    };
+}
+
+
+
+
+
+export interface ReadRepairTuning {
+     
+    enabled: boolean;
+    
+
+
+
+    priorPaths(session: Session | undefined, limit?: number): string[];
+    
+
+
+
+
+    duplicate: {
+        enabled: boolean;
+         
+        maxSteps: number;
+        judge(session: Session | undefined, path: string, version: string, window: {
+            offset: number;
+            endLine: number;
+        }): ReadDuplicateVerdict | undefined;
+        record(session: Session | undefined, path: string, observation: {
+            offset: number;
+            endLine: number;
+            totalLines: number;
+            version: string;
+        }): void;
+    };
+    
+
+
+
+
+
+
+
+    completion: {
+        enabled: boolean;
+        maxLines: number;
+    };
+    
+
+
+
+
+
+
+
+
+    claimDisclosure(session: Session | undefined, key: string): boolean;
+}
+ 
+interface ReadInput {
+    filePath: string;
+    offset: number;
+    limit: number;
+     
+    force: boolean;
+     
+    repairs?: readonly ReadArgRepair[];
+}
+
+
+
+
+
+
+
+
+
+
+
+export declare function parseReadArgs(args: {
+    file_path: string;
+    force?: boolean;
+    offset?: number;
+    limit?: number;
+}, maxLimit: number, repairEnabled?: boolean): ReadInput;
+
+
+
+
+
+
+export declare function applyReadTool(ctx: Context, caps: ReadToolCaps, repair: ReadRepairTuning): void;
+export {};
+ 

package/lib/types/sandbox.d.ts

@@ -0,0 +1,82 @@
+
+
+
+
+
+
+
+
+
+
+
+import type { Context } from '@deepseek-ai/cordis';
+import type { ToolExecution } from '@deepseek-ai/dsh-tools';
+import type { SandboxExecutionPolicy, SandboxMode } from '@deepseek-ai/dsh-sandbox';
+ 
+export interface FsEscalationArgs {
+    sandbox_permissions?: string;
+    justification?: string;
+}
+ 
+export interface EscalationSchemaFields {
+    sandbox_permissions: {
+        type: 'string';
+        enum: string[];
+        description: string;
+    };
+    justification: {
+        type: 'string';
+        description: string;
+    };
+}
+
+
+
+
+
+export declare class FsSandboxController {
+    private readonly ctx;
+     
+    readonly escalationModes: readonly SandboxMode[];
+     
+    private readonly policy;
+    constructor(ctx: Context);
+    
+
+
+
+
+
+
+    schemaFields(): EscalationSchemaFields;
+    
+
+
+
+
+
+
+
+
+
+
+
+
+    resolvePolicy(toolName: string, args: FsEscalationArgs, exec: ToolExecution): Promise<SandboxExecutionPolicy | undefined>;
+    
+
+
+
+
+
+
+
+
+
+
+
+
+
+    mapError(error: unknown, policy: SandboxExecutionPolicy | undefined): unknown;
+}
+ 

package/lib/types/session-cwd.d.ts

@@ -0,0 +1,26 @@
+
+
+
+
+
+
+
+
+import type { ToolExecution } from '@deepseek-ai/dsh-tools';
+
+
+
+
+
+export declare function sessionCwd(exec: ToolExecution): string | undefined;
+
+
+
+
+
+
+export declare function sessionResolveOptions(exec: ToolExecution, policyWorkspaceRoot?: string): {
+    cwd?: string;
+    signal?: AbortSignal;
+};
+