@watasu/sdk 0.1.53 → 0.1.66

package/README.md

@@ -156,6 +156,15 @@ await sbx.files.writeFiles([
   { path: '/workspace/project/a.txt', data: 'alpha' },
   { path: '/workspace/project/b.bin', data: new Uint8Array([0, 1, 2]) },
 ])
+const patch = await sbx.files.applyDiff(
+  `*** Begin Patch
+*** Update File: /workspace/project/a.txt
+@@
+-alpha
++beta
+*** End Patch`
+)
+console.log(patch.status)
 
 const watcher = sbx.files.watchDir('/workspace/project')
 watcher.addEventListener((event) => {

package/dist/filesystem.d.ts

@@ -68,6 +68,41 @@ export interface FilesystemWriteOpts extends FilesystemRequestOpts {
     useOctetStream?: boolean;
     metadata?: Record<string, string>;
 }
+export interface ApplyDiffOpts extends FilesystemRequestOpts {
+    cwd?: string;
+}
+export interface ApplyDiffFailedHunk {
+    index: number;
+    oldStart: number;
+}
+export interface ApplyDiffFailure {
+    path: string;
+    error: string;
+    failedHunk?: ApplyDiffFailedHunk;
+}
+export interface ApplyDiffFileSummary {
+    path: string;
+    sourcePath?: string;
+    kind: string;
+    added: number;
+    removed: number;
+}
+export interface ApplyDiffSummary {
+    requested: number;
+    applied: number;
+    failed: number;
+}
+export interface ApplyDiffReport {
+    status: 'applied' | 'partial' | 'failed' | string;
+    parsedDiffBlocks: number;
+    patches: number;
+    files: ApplyDiffFileSummary[];
+    summary: ApplyDiffSummary;
+    applied: string[];
+    failed: ApplyDiffFailure[];
+    touched: string[];
+    raw: Record<string, unknown>;
+}
 /** Live filesystem watcher. Call `stop()` to close the local watch stream. */
 export declare class WatchHandle {
     private readonly socket;
@@ -130,6 +165,8 @@ export declare class Filesystem {
     remove(path: string, opts?: FilesystemRequestOpts): Promise<void>;
     /** Move or rename a file. */
     rename(oldPath: string, newPath: string, opts?: FilesystemRequestOpts): Promise<EntryInfo>;
+    /** Apply a git-style unified diff or Codex apply_patch payload inside the sandbox. */
+    applyDiff(diff: string, opts?: ApplyDiffOpts): Promise<ApplyDiffReport>;
     /** Create a directory. */
     makeDir(path: string, opts?: FilesystemRequestOpts): Promise<boolean>;
     /** Start watching a directory for filesystem events. */

package/dist/filesystem.js

@@ -183,6 +183,17 @@ export class Filesystem {
         });
         return entryInfo(payload.file ?? payload);
     }
+    /** Apply a git-style unified diff or Codex apply_patch payload inside the sandbox. */
+    async applyDiff(diff, opts = {}) {
+        const payload = await this.dataPlane.postJson('/runtime/v1/files/apply_diff', {
+            ...requestOpts(opts),
+            json: {
+                diff,
+                ...(opts.cwd ? { cwd: opts.cwd } : {}),
+            },
+        });
+        return applyDiffReport(payload);
+    }
     /** Create a directory. */
     async makeDir(path, opts = {}) {
         await this.dataPlane.postJson(withQuery('/runtime/v1/directories', { path }), opts);
@@ -312,6 +323,60 @@ function filesystemEvent(value) {
         raw: item,
     };
 }
+function applyDiffReport(value) {
+    const item = value && typeof value === 'object' ? value : {};
+    return {
+        status: String(item.status ?? ''),
+        parsedDiffBlocks: requiredNumber(item.parsed_diff_blocks),
+        patches: requiredNumber(item.patches),
+        files: Array.isArray(item.files) ? item.files.map(applyDiffFileSummary) : [],
+        summary: applyDiffSummary(item.summary),
+        applied: stringArray(item.applied),
+        failed: Array.isArray(item.failed) ? item.failed.map(applyDiffFailure) : [],
+        touched: stringArray(item.touched),
+        raw: item,
+    };
+}
+function applyDiffSummary(value) {
+    const item = value && typeof value === 'object' ? value : {};
+    return {
+        requested: requiredNumber(item.requested),
+        applied: requiredNumber(item.applied),
+        failed: requiredNumber(item.failed),
+    };
+}
+function applyDiffFileSummary(value) {
+    const item = value && typeof value === 'object' ? value : {};
+    return {
+        path: String(item.path ?? ''),
+        sourcePath: typeof item.source_path === 'string' ? item.source_path : undefined,
+        kind: String(item.kind ?? ''),
+        added: requiredNumber(item.added),
+        removed: requiredNumber(item.removed),
+    };
+}
+function applyDiffFailure(value) {
+    const item = value && typeof value === 'object' ? value : {};
+    const failedHunk = item.failed_hunk && typeof item.failed_hunk === 'object'
+        ? item.failed_hunk
+        : undefined;
+    return {
+        path: String(item.path ?? ''),
+        error: String(item.error ?? ''),
+        failedHunk: failedHunk
+            ? {
+                index: requiredNumber(failedHunk.index),
+                oldStart: requiredNumber(failedHunk.old_start),
+            }
+            : undefined,
+    };
+}
+function requiredNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : 0;
+}
+function stringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === 'string') : [];
+}
 function normalizeEventType(value) {
     if (value === 'delete')
         return FilesystemEventType.REMOVE;

package/dist/index.d.ts

@@ -12,7 +12,7 @@ export type { CommandConnectOpts, CommandRequestOpts, CommandResult, CommandStar
 export { Process, ProcessManager, ProcessMessage, ProcessOutput } from './process.js';
 export type { ProcessOpts } from './process.js';
 export { FileType, Filesystem, FilesystemEventType, FilesystemWatcher, WatchHandle, } from './filesystem.js';
-export type { EntryInfo, FilesystemEvent, FilesystemReadOpts, FilesystemRequestOpts, FilesystemWriteOpts, WatchOpts, WriteData, WriteEntry, WriteInfo, } from './filesystem.js';
+export type { ApplyDiffFailure, ApplyDiffFailedHunk, ApplyDiffFileSummary, ApplyDiffOpts, ApplyDiffReport, ApplyDiffSummary, EntryInfo, FilesystemEvent, FilesystemReadOpts, FilesystemRequestOpts, FilesystemWriteOpts, WatchOpts, WriteData, WriteEntry, WriteInfo, } from './filesystem.js';
 export { Git } from './git.js';
 export type { GitAddOpts, GitAuthOpts, GitBranches, GitBranchOpts, GitCloneOpts, GitCommandResult, GitConfigScope, GitConfigOpts, GitConfigureUserOpts, GitCredentialOpts, GitCommitOpts, GitDangerouslyAuthenticateOpts, GitDeleteBranchOpts, GitFileStatus, GitInitOpts, GitPullOpts, GitPushOpts, GitRemoteAddOpts, GitResetMode, GitResetOpts, GitRestoreOpts, GitRequestOpts, GitStatus, } from './git.js';
 export { Pty } from './pty.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@watasu/sdk",
-  "version": "0.1.53",
+  "version": "0.1.66",
   "type": "module",
   "license": "MIT OR Apache-2.0",
   "description": "TypeScript SDK for Watasu",