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

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

@@ -1,26 +1,26 @@
-/**
- * Derive the working directory a filesystem tool resolves relative paths against: the calling
- * agent's per-session workspace (`exec.agent.session.header.cwd`), so each session's
- * `read`/`write`/`edit` act on its workspace, not the server's launch directory.
- * Non-agent calls return `undefined`, leaving the fallback in the provider rather than reading
- * `process.cwd()` at the tool boundary.
- * @module @deepseek-ai/dsh-tool-fs/session-cwd
- */
+
+
+
+
+
+
+
+
 import type { ToolExecution } from '@deepseek-ai/dsh-tools';
-/**
- * The session workspace cwd for this call, or `undefined` when none applies.
- * @param exec - the tool-execution context; only its optional `agent` is read.
- * @returns the calling agent's session cwd, or undefined for a non-agent caller (the backend then applies its own default).
- */
+
+
+
+
+
 export declare function sessionCwd(exec: ToolExecution): string | undefined;
-/**
- * Resolution options shared by all model-facing filesystem tools.
- * @param exec - the tool-execution context supplying session cwd and cancellation.
- * @param policyWorkspaceRoot - resolved per-call root, when a mutation carries sandbox policy.
- * @returns provider resolution options for the current tool call.
- */
+
+
+
+
+
+
 export declare function sessionResolveOptions(exec: ToolExecution, policyWorkspaceRoot?: string): {
     cwd?: string;
     signal?: AbortSignal;
 };
-//# sourceMappingURL=session-cwd.d.ts.map
+ 

package/lib/types/structure.d.ts

@@ -1,67 +1,67 @@
-/**
- * Structural analysis of file text for read-window completion: markdown
- * fences, bracket nesting, and indentation blocks. The analyzers are pure
- * functions over already-delivered text; they decide which construct a window
- * boundary falls inside, and how many neighbouring lines close an open one.
- *
- * Precision is traded for never touching delivered content: a wrong verdict
- * only costs a few appended real lines, or a silent non-completion. String
- * literals are scanned per line (an unterminated quote never carries into the
- * next line), line comments and C-style block comments are skipped, and
- * brackets inside an open fence are content, so prose and code samples do not
- * fabricate unbalanced constructs.
- * @module @deepseek-ai/dsh-tool-fs/structure
- */
-/** Which structural rule produced a completion. */
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 
 export type CompletionRule = 'fence' | 'brace' | 'indent';
-/** An unbalanced construct at a window boundary. */
+ 
 export type OpenConstruct = {
     kind: 'fence';
-    /** The opening fence marker, e.g. ` ``` ` or `~~~~`. */
+     
     marker: string;
-    /** Index of the line that opened the construct, within the scanned lines. */
+     
     lineIndex: number;
 } | {
     kind: 'brace';
-    /** Bracket levels still open at the boundary. */
+     
     depth: number;
-    /** Index of the innermost opening line, within the scanned lines. */
+     
     lineIndex: number;
 } | {
     kind: 'indent';
-    /** Indent width of the open block's body. */
+     
     width: number;
-    /** Index of the block header line, within the scanned lines. */
+     
     lineIndex: number;
 };
-/** The construct a window starts inside, and the line that opened it. */
+ 
 export interface HeadContext {
-    /** Which rule found the construct. */
+     
     kind: CompletionRule;
-    /** Index into the preceding lines of the line that opened the construct. */
+     
     startIndex: number;
 }
-/**
- * The construct a window ends inside.
- * @param lines - the delivered window lines, in file order.
- * @returns the construct to close, or `undefined` when the tail is balanced.
- */
+
+
+
+
+
 export declare function detectOpenTail(lines: readonly string[]): OpenConstruct | undefined;
-/**
- * The construct a window starts inside, resolved from the lines that precede it.
- * A fence outranks a bracket block, which outranks an indented block. A
- * construct opened before the supplied preceding lines is not provable and
- * reports nothing, so the completion stays silent rather than guessing.
- * @param window - the delivered window lines, in file order.
- * @param preceding - the lines immediately before the window, in file order; the last entry is the line that precedes the window.
- * @returns the leading context, or `undefined` when the window starts at a construct boundary.
- */
+
+
+
+
+
+
+
+
+
 export declare function detectOpenHead(window: readonly string[], preceding: readonly string[]): HeadContext | undefined;
-/**
- * How many of the following lines close an open construct.
- * @param construct - the construct {@link detectOpenTail} found.
- * @param appended - the lines following the window, in file order.
- * @returns the count of lines to append, or `0` when the sequence closes nothing.
- */
+
+
+
+
+
+
 export declare function closureLength(construct: OpenConstruct, appended: readonly string[]): number;
-//# sourceMappingURL=structure.d.ts.map
+ 

package/lib/types/write.d.ts

@@ -1,37 +1,37 @@
-/**
- * Model-facing full-file write. It obtains an optional intent from the single policy slot, calls
- * `ctx.fs.writeText` without a stat, then records the resulting version; no policy means an
- * unconditional atomic create-or-overwrite.
- * @module @deepseek-ai/dsh-tool-fs/src/write
- */
+
+
+
+
+
+
 import type { Context } from '@deepseek-ai/cordis';
 import type { FsWriteOutcome } from '@deepseek-ai/dsh-fs';
 import type { Session } from '@deepseek-ai/dsh-session';
 import type { FsSandboxController } from './sandbox.ts';
-/**
- * Tuning for the drifted-path hint: on a create, a verified high-similarity
- * existing path is disclosed as a note — never rewritten.
- */
+
+
+
+
 export interface WriteHintTuning {
-    /** Master switch for the drifted-path hint. */
+     
     pathHint: boolean;
-    /**
-     * Absolute path arguments of the session's prior successful tool calls, most
-     * recent first — the similarity matcher's history source.
-     */
+    
+
+
+
     priorPaths(session: Session | undefined, limit?: number): string[];
 }
-/** Plugin-config shape for the write hint tuning. */
+ 
 export interface WriteRepairConfig {
-    /** Disable the drifted-path hint so creates stay silent (default enabled). */
+     
     pathHint?: boolean;
 }
-/**
- * Validate value constraints the schema DSL can't express: only a non-blank
- * `file_path` — an empty `content` is legitimate (it writes an empty file).
- * @param args - the schema-validated raw tool arguments.
- * @returns the camelCased input; `content` passes through untouched.
- */
+
+
+
+
+
+
 export declare function parseWriteArgs(args: {
     file_path: string;
     content: string;
@@ -39,19 +39,19 @@ export declare function parseWriteArgs(args: {
     filePath: string;
     content: string;
 };
-/**
- * Format a write outcome as one model-facing text block body.
- * @param displayPath - the backend-resolved path rendered in the envelope's `<path>` element.
- * @param outcome - the write outcome; its `operation` selects the Created/Updated wording.
- * @param hint - the drifted-path disclosure appended inside the content block, or undefined.
- * @returns the model-facing confirmation envelope (no file content is echoed back).
- */
+
+
+
+
+
+
+
 export declare function formatWriteOutput(displayPath: string, outcome: Pick<FsWriteOutcome, 'operation'>, hint?: string): string;
-/**
- * Register the `write` tool and its scope-aware system-prompt guidance.
- * @param ctx - the plugin context; registrations are effects scoped to it, and execution uses its `fs` service.
- * @param sandbox - the shared sandbox-escalation API (advertisement, mode stamping, denial mapping).
- * @param hints - the drifted-path hint tuning; disabled keeps creates silent.
- */
+
+
+
+
+
+
 export declare function applyWriteTool(ctx: Context, sandbox: FsSandboxController, hints: WriteHintTuning): void;
-//# sourceMappingURL=write.d.ts.map
+ 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@swoop111/dsh-tool-fs",
   "description": "Model-facing filesystem tools (read, write, edit) over the DeepSeek Harness filesystem seam (ctx.fs)",
-  "version": "0.2.0-rc.2",
+  "version": "0.2.0-rc.2.1",
   "publishConfig": {
     "access": "public"
   },