@namzu/sdk 49.0.0 → 50.0.0

package/dist/tools/builtins/computer-use.d.ts

@@ -71,32 +71,32 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        y: number;
-        x: number;
         width: number;
         height: number;
-    }, {
-        y: number;
         x: number;
+        y: number;
+    }, {
         width: number;
         height: number;
+        x: number;
+        y: number;
     }>;
 }, "strip", z.ZodTypeAny, {
     type: "zoom";
     region: {
-        y: number;
-        x: number;
         width: number;
         height: number;
+        x: number;
+        y: number;
     };
     screenshot_id?: string | undefined;
 }, {
     type: "zoom";
     region: {
-        y: number;
-        x: number;
         width: number;
         height: number;
+        x: number;
+        y: number;
     };
     screenshot_id?: string | undefined;
 }>, z.ZodObject<{
@@ -115,26 +115,26 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         x: z.ZodNumber;
         y: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        y: number;
         x: number;
-    }, {
         y: number;
+    }, {
         x: number;
+        y: number;
     }>;
 } & {
     screenshot_id: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "mouse_move";
     to: {
-        y: number;
         x: number;
+        y: number;
     };
     screenshot_id?: string | undefined;
 }, {
     type: "mouse_move";
     to: {
-        y: number;
         x: number;
+        y: number;
     };
     screenshot_id?: string | undefined;
 }>, z.ZodObject<{
@@ -143,11 +143,11 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         x: z.ZodNumber;
         y: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        y: number;
         x: number;
-    }, {
         y: number;
+    }, {
         x: number;
+        y: number;
     }>;
     button: z.ZodDefault<z.ZodEnum<["left", "right", "middle"]>>;
     /** Accepted only to return an explicit refusal; pointer foreground is unsafe. */
@@ -156,8 +156,8 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     screenshot_id: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     at: {
-        y: number;
         x: number;
+        y: number;
     };
     type: "mouse_click";
     button: "left" | "right" | "middle";
@@ -165,8 +165,8 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     screenshot_id?: string | undefined;
 }, {
     at: {
-        y: number;
         x: number;
+        y: number;
     };
     type: "mouse_click";
     button?: "left" | "right" | "middle" | undefined;
@@ -178,21 +178,21 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         x: z.ZodNumber;
         y: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        y: number;
         x: number;
-    }, {
         y: number;
+    }, {
         x: number;
+        y: number;
     }>;
     to: z.ZodObject<{
         x: z.ZodNumber;
         y: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        y: number;
         x: number;
-    }, {
         y: number;
+    }, {
         x: number;
+        y: number;
     }>;
     button: z.ZodDefault<z.ZodEnum<["left", "right", "middle"]>>;
     delivery_mode: z.ZodOptional<z.ZodEnum<["background", "foreground"]>>;
@@ -201,12 +201,12 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: "mouse_drag";
     from: {
-        y: number;
         x: number;
+        y: number;
     };
     to: {
-        y: number;
         x: number;
+        y: number;
     };
     button: "left" | "right" | "middle";
     delivery_mode?: "background" | "foreground" | undefined;
@@ -214,12 +214,12 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
 }, {
     type: "mouse_drag";
     from: {
-        y: number;
         x: number;
+        y: number;
     };
     to: {
-        y: number;
         x: number;
+        y: number;
     };
     button?: "left" | "right" | "middle" | undefined;
     delivery_mode?: "background" | "foreground" | undefined;
@@ -230,11 +230,11 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         x: z.ZodNumber;
         y: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        y: number;
         x: number;
-    }, {
         y: number;
+    }, {
         x: number;
+        y: number;
     }>;
     direction: z.ZodEnum<["up", "down", "left", "right"]>;
     amount: z.ZodNumber;
@@ -243,22 +243,22 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     screenshot_id: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     at: {
-        y: number;
         x: number;
+        y: number;
     };
     type: "scroll";
     amount: number;
-    direction: "left" | "right" | "up" | "down";
+    direction: "up" | "down" | "left" | "right";
     delivery_mode?: "background" | "foreground" | undefined;
     screenshot_id?: string | undefined;
 }, {
     at: {
-        y: number;
         x: number;
+        y: number;
     };
     type: "scroll";
     amount: number;
-    direction: "left" | "right" | "up" | "down";
+    direction: "up" | "down" | "left" | "right";
     delivery_mode?: "background" | "foreground" | undefined;
     screenshot_id?: string | undefined;
 }>, z.ZodObject<{
@@ -269,30 +269,30 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         x: z.ZodNumber;
         y: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        y: number;
         x: number;
-    }, {
         y: number;
+    }, {
         x: number;
+        y: number;
     }>>;
     delivery_mode: z.ZodOptional<z.ZodEnum<["background", "foreground"]>>;
 } & {
     screenshot_id: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    text: string;
     type: "type_text";
+    text: string;
     at?: {
-        y: number;
         x: number;
+        y: number;
     } | undefined;
     delivery_mode?: "background" | "foreground" | undefined;
     screenshot_id?: string | undefined;
 }, {
-    text: string;
     type: "type_text";
+    text: string;
     at?: {
-        y: number;
         x: number;
+        y: number;
     } | undefined;
     delivery_mode?: "background" | "foreground" | undefined;
     screenshot_id?: string | undefined;
@@ -303,11 +303,11 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         x: z.ZodNumber;
         y: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        y: number;
         x: number;
-    }, {
         y: number;
+    }, {
         x: number;
+        y: number;
     }>>;
     delivery_mode: z.ZodOptional<z.ZodEnum<["background", "foreground"]>>;
 } & {
@@ -316,8 +316,8 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     keys: string;
     type: "key";
     at?: {
-        y: number;
         x: number;
+        y: number;
     } | undefined;
     delivery_mode?: "background" | "foreground" | undefined;
     screenshot_id?: string | undefined;
@@ -325,8 +325,8 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     keys: string;
     type: "key";
     at?: {
-        y: number;
         x: number;
+        y: number;
     } | undefined;
     delivery_mode?: "background" | "foreground" | undefined;
     screenshot_id?: string | undefined;
@@ -409,23 +409,23 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             x: z.ZodNumber;
             y: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
-            y: number;
             x: number;
-        }, {
             y: number;
+        }, {
             x: number;
+            y: number;
         }>;
     }, "strip", z.ZodTypeAny, {
         type: "mouse_move";
         to: {
-            y: number;
             x: number;
+            y: number;
         };
     }, {
         type: "mouse_move";
         to: {
-            y: number;
             x: number;
+            y: number;
         };
     }>, z.ZodObject<{
         type: z.ZodLiteral<"mouse_click">;
@@ -433,27 +433,27 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             x: z.ZodNumber;
             y: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
-            y: number;
             x: number;
-        }, {
             y: number;
+        }, {
             x: number;
+            y: number;
         }>;
         button: z.ZodDefault<z.ZodEnum<["left", "right", "middle"]>>;
         /** Accepted only to return an explicit refusal; pointer foreground is unsafe. */
         delivery_mode: z.ZodOptional<z.ZodEnum<["background", "foreground"]>>;
     }, "strip", z.ZodTypeAny, {
         at: {
-            y: number;
             x: number;
+            y: number;
         };
         type: "mouse_click";
         button: "left" | "right" | "middle";
         delivery_mode?: "background" | "foreground" | undefined;
     }, {
         at: {
-            y: number;
             x: number;
+            y: number;
         };
         type: "mouse_click";
         button?: "left" | "right" | "middle" | undefined;
@@ -464,45 +464,45 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             x: z.ZodNumber;
             y: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
-            y: number;
             x: number;
-        }, {
             y: number;
+        }, {
             x: number;
+            y: number;
         }>;
         to: z.ZodObject<{
             x: z.ZodNumber;
             y: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
-            y: number;
             x: number;
-        }, {
             y: number;
+        }, {
             x: number;
+            y: number;
         }>;
         button: z.ZodDefault<z.ZodEnum<["left", "right", "middle"]>>;
         delivery_mode: z.ZodOptional<z.ZodEnum<["background", "foreground"]>>;
     }, "strip", z.ZodTypeAny, {
         type: "mouse_drag";
         from: {
-            y: number;
             x: number;
+            y: number;
         };
         to: {
-            y: number;
             x: number;
+            y: number;
         };
         button: "left" | "right" | "middle";
         delivery_mode?: "background" | "foreground" | undefined;
     }, {
         type: "mouse_drag";
         from: {
-            y: number;
             x: number;
+            y: number;
         };
         to: {
-            y: number;
             x: number;
+            y: number;
         };
         button?: "left" | "right" | "middle" | undefined;
         delivery_mode?: "background" | "foreground" | undefined;
@@ -512,32 +512,32 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             x: z.ZodNumber;
             y: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
-            y: number;
             x: number;
-        }, {
             y: number;
+        }, {
             x: number;
+            y: number;
         }>;
         direction: z.ZodEnum<["up", "down", "left", "right"]>;
         amount: z.ZodNumber;
         delivery_mode: z.ZodOptional<z.ZodEnum<["background", "foreground"]>>;
     }, "strip", z.ZodTypeAny, {
         at: {
-            y: number;
             x: number;
+            y: number;
         };
         type: "scroll";
         amount: number;
-        direction: "left" | "right" | "up" | "down";
+        direction: "up" | "down" | "left" | "right";
         delivery_mode?: "background" | "foreground" | undefined;
     }, {
         at: {
-            y: number;
             x: number;
+            y: number;
         };
         type: "scroll";
         amount: number;
-        direction: "left" | "right" | "up" | "down";
+        direction: "up" | "down" | "left" | "right";
         delivery_mode?: "background" | "foreground" | undefined;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"type_text">;
@@ -547,27 +547,27 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             x: z.ZodNumber;
             y: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
-            y: number;
             x: number;
-        }, {
             y: number;
+        }, {
             x: number;
+            y: number;
         }>>;
         delivery_mode: z.ZodOptional<z.ZodEnum<["background", "foreground"]>>;
     }, "strip", z.ZodTypeAny, {
-        text: string;
         type: "type_text";
+        text: string;
         at?: {
-            y: number;
             x: number;
+            y: number;
         } | undefined;
         delivery_mode?: "background" | "foreground" | undefined;
     }, {
-        text: string;
         type: "type_text";
+        text: string;
         at?: {
-            y: number;
             x: number;
+            y: number;
         } | undefined;
         delivery_mode?: "background" | "foreground" | undefined;
     }>, z.ZodObject<{
@@ -577,27 +577,27 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
             x: z.ZodNumber;
             y: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
-            y: number;
             x: number;
-        }, {
             y: number;
+        }, {
             x: number;
+            y: number;
         }>>;
         delivery_mode: z.ZodOptional<z.ZodEnum<["background", "foreground"]>>;
     }, "strip", z.ZodTypeAny, {
         keys: string;
         type: "key";
         at?: {
-            y: number;
             x: number;
+            y: number;
         } | undefined;
         delivery_mode?: "background" | "foreground" | undefined;
     }, {
         keys: string;
         type: "key";
         at?: {
-            y: number;
             x: number;
+            y: number;
         } | undefined;
         delivery_mode?: "background" | "foreground" | undefined;
     }>, z.ZodObject<{
@@ -647,13 +647,13 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     } | {
         type: "mouse_move";
         to: {
-            y: number;
             x: number;
+            y: number;
         };
     } | {
         at: {
-            y: number;
             x: number;
+            y: number;
         };
         type: "mouse_click";
         button: "left" | "right" | "middle";
@@ -661,38 +661,38 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     } | {
         type: "mouse_drag";
         from: {
-            y: number;
             x: number;
+            y: number;
         };
         to: {
-            y: number;
             x: number;
+            y: number;
         };
         button: "left" | "right" | "middle";
         delivery_mode?: "background" | "foreground" | undefined;
     } | {
         at: {
-            y: number;
             x: number;
+            y: number;
         };
         type: "scroll";
         amount: number;
-        direction: "left" | "right" | "up" | "down";
+        direction: "up" | "down" | "left" | "right";
         delivery_mode?: "background" | "foreground" | undefined;
     } | {
-        text: string;
         type: "type_text";
+        text: string;
         at?: {
-            y: number;
             x: number;
+            y: number;
         } | undefined;
         delivery_mode?: "background" | "foreground" | undefined;
     } | {
         keys: string;
         type: "key";
         at?: {
-            y: number;
             x: number;
+            y: number;
         } | undefined;
         delivery_mode?: "background" | "foreground" | undefined;
     } | {
@@ -717,13 +717,13 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     } | {
         type: "mouse_move";
         to: {
-            y: number;
             x: number;
+            y: number;
         };
     } | {
         at: {
-            y: number;
             x: number;
+            y: number;
         };
         type: "mouse_click";
         button?: "left" | "right" | "middle" | undefined;
@@ -731,38 +731,38 @@ declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     } | {
         type: "mouse_drag";
         from: {
-            y: number;
             x: number;
+            y: number;
         };
         to: {
-            y: number;
             x: number;
+            y: number;
         };
         button?: "left" | "right" | "middle" | undefined;
         delivery_mode?: "background" | "foreground" | undefined;
     } | {
         at: {
-            y: number;
             x: number;
+            y: number;
         };
         type: "scroll";
         amount: number;
-        direction: "left" | "right" | "up" | "down";
+        direction: "up" | "down" | "left" | "right";
         delivery_mode?: "background" | "foreground" | undefined;
     } | {
-        text: string;
         type: "type_text";
+        text: string;
         at?: {
-            y: number;
             x: number;
+            y: number;
         } | undefined;
         delivery_mode?: "background" | "foreground" | undefined;
     } | {
         keys: string;
         type: "key";
         at?: {
-            y: number;
             x: number;
+            y: number;
         } | undefined;
         delivery_mode?: "background" | "foreground" | undefined;
     } | {

package/dist/tools/builtins/edit.d.ts

@@ -139,6 +139,23 @@ declare const inputSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
     }[] | undefined;
 }>;
 export type EditInput = z.infer<typeof inputSchema>;
+/**
+ * What an `edit` call WOULD produce for a file body, without touching any file.
+ *
+ * The same schema, the same normalisation and the same `applyEdit` fold that
+ * `execute` runs, so a host that shows a proposed change before approval is
+ * showing what the tool will do, not a second reading of the arguments. Pure:
+ * the caller supplies the current body (and decides what to do when there is no
+ * file). The no-op refusal is repeated because a call `execute` would refuse
+ * has no change to preview.
+ */
+export declare function dryRunEdit(content: string, input: unknown): {
+    success: true;
+    content: string;
+} | {
+    success: false;
+    error: string;
+};
 export declare const EditTool: import("../../types/tool/index.js").ToolDefinition<{
     path: string;
     old_string?: string | undefined;

package/dist/tools/builtins/edit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/edit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAUvB;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4Gf,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAqJnD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;EA+JnB,CAAA"}
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/edit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAUvB;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4Gf,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAEnD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACzB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACZ;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAiBxE;AAqJD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;EAyKnB,CAAA"}

package/dist/tools/builtins/edit.js

@@ -104,6 +104,30 @@ const inputSchema = z
         value.insertLine === undefined), {
     message: 'Use either `edits` or a single top-level edit, not both. Move the top-level old_string/new_string into the edits list.',
 });
+/**
+ * What an `edit` call WOULD produce for a file body, without touching any file.
+ *
+ * The same schema, the same normalisation and the same `applyEdit` fold that
+ * `execute` runs, so a host that shows a proposed change before approval is
+ * showing what the tool will do, not a second reading of the arguments. Pure:
+ * the caller supplies the current body (and decides what to do when there is no
+ * file). The no-op refusal is repeated because a call `execute` would refuse
+ * has no change to preview.
+ */
+export function dryRunEdit(content, input) {
+    const parsed = inputSchema.safeParse(input);
+    if (!parsed.success) {
+        return { success: false, error: parsed.error.issues.map((issue) => issue.message).join('; ') };
+    }
+    const normalized = normalizeEditInput(parsed.data);
+    if (!normalized.success)
+        return normalized;
+    if (normalized.operations.some((operation) => operation.operation === 'replace' && operation.oldString === operation.newString)) {
+        return { success: false, error: 'old_string and new_string are identical — no change needed' };
+    }
+    const result = applyEdit(content, normalized.operations);
+    return result.success ? { success: true, content: result.content } : result;
+}
 /**
  * What a capable provider constrains the model to emit: one shape, closed.
  *
@@ -361,6 +385,11 @@ export const EditTool = defineTool({
                     success: true,
                     output: `Edited ${parsed.data.path}: ${result.replacements} replacement(s) [sandboxed]`,
                     data: { path: parsed.data.path, replacements: result.replacements, sandboxed: true },
+                    facts: {
+                        kind: 'edit',
+                        path: parsed.data.path,
+                        replacements: result.replacements,
+                    },
                 };
             }
             const hostPath = filePath;
@@ -385,6 +414,11 @@ export const EditTool = defineTool({
                 success: true,
                 output: `Edited ${hostPath}: ${result.replacements} replacement(s)`,
                 data: { path: hostPath, replacements: result.replacements },
+                facts: {
+                    kind: 'edit',
+                    path: hostPath,
+                    replacements: result.replacements,
+                },
             };
         });
     },