@openshain/tools 0.3.1 → 0.4.0

package/NOTICE

@@ -0,0 +1,4 @@
+openshain
+Copyright 2026 openshain contributors
+
+Licensed under the Apache License, Version 2.0.

package/dist/index.d.ts

@@ -1 +1 @@
-export { MAX_READ_BYTES, standardTools } from "./standard.ts";
+export { csvText, MAX_READ_BYTES, standardTools } from "./standard.ts";

package/dist/index.js

@@ -1,2 +1,2 @@
 // @openshain/tools: Standard tool provider: filesystem, CSV, Markdown, documents, email
-export { MAX_READ_BYTES, standardTools } from "./standard.js";
+export { csvText, MAX_READ_BYTES, standardTools } from "./standard.js";

package/dist/standard.d.ts

@@ -14,3 +14,12 @@ export declare const DEFAULT_WINDOW: {
 };
 /** The tools every workspace gets: files, CSV and Markdown, all confined to the workspace. */
 export declare function standardTools(): ToolProvider;
+/**
+ * Spreadsheets run a cell that starts with =, +, @ or - as a formula. A leading apostrophe keeps
+ * it text. Negative numbers are left alone.
+ */
+/**
+ * The rows of a csv_write as the file will read them, with the header and the formula guard.
+ * The screen shows this before a person approves a write, so both go through one function.
+ */
+export declare function csvText(rows: Record<string, unknown>[], columns?: string[]): string;

package/dist/standard.js

@@ -391,11 +391,7 @@ async function csvAggregate(ctx, path, input) {
 async function csvWrite(ctx, path, rows, columns) {
     if (!Array.isArray(rows))
         throw new Error("rows must be an array of objects");
-    const safeRows = rows.map((row) => Object.fromEntries(Object.entries(row).map(([key, value]) => [key, neutralizeFormula(value)])));
-    const content = stringify(safeRows, {
-        header: true,
-        ...(Array.isArray(columns) && { columns: columns }),
-    });
+    const content = csvText(rows, Array.isArray(columns) ? columns : undefined);
     const after = await writeText(ctx, path, content);
     return {
         content: [{ type: "text", text: `wrote ${rows.length} rows to ${after.path}` }],
@@ -659,6 +655,14 @@ function failure(message) {
  * Spreadsheets run a cell that starts with =, +, @ or - as a formula. A leading apostrophe keeps
  * it text. Negative numbers are left alone.
  */
+/**
+ * The rows of a csv_write as the file will read them, with the header and the formula guard.
+ * The screen shows this before a person approves a write, so both go through one function.
+ */
+export function csvText(rows, columns) {
+    const safeRows = rows.map((row) => Object.fromEntries(Object.entries(row).map(([key, value]) => [key, neutralizeFormula(value)])));
+    return stringify(safeRows, { header: true, ...(columns && { columns }) });
+}
 function neutralizeFormula(value) {
     if (typeof value !== "string")
         return value;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openshain/tools",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Standard tool provider: filesystem, CSV, Markdown, documents, email",
   "keywords": [
     "openshain",
@@ -30,7 +30,8 @@
     "!src/**/*.test.ts",
     "!src/**/*.test.tsx",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "NOTICE"
   ],
   "exports": {
     ".": {
@@ -44,7 +45,7 @@
     "prepublishOnly": "rm -rf dist && ../../node_modules/.bin/tsc -p tsconfig.build.json"
   },
   "dependencies": {
-    "@openshain/core": "0.3.1",
+    "@openshain/core": "0.4.0",
     "csv-parse": "7.0.2",
     "csv-stringify": "6.8.3"
   },

package/src/index.ts

@@ -1,2 +1,2 @@
 // @openshain/tools: Standard tool provider: filesystem, CSV, Markdown, documents, email
-export { MAX_READ_BYTES, standardTools } from "./standard.ts";
+export { csvText, MAX_READ_BYTES, standardTools } from "./standard.ts";

package/src/standard.ts

@@ -497,13 +497,10 @@ async function csvWrite(
   columns: unknown,
 ): Promise<ToolResult> {
   if (!Array.isArray(rows)) throw new Error("rows must be an array of objects");
-  const safeRows = (rows as Record<string, unknown>[]).map((row) =>
-    Object.fromEntries(Object.entries(row).map(([key, value]) => [key, neutralizeFormula(value)])),
+  const content = csvText(
+    rows as Record<string, unknown>[],
+    Array.isArray(columns) ? (columns as string[]) : undefined,
   );
-  const content = stringify(safeRows, {
-    header: true,
-    ...(Array.isArray(columns) && { columns: columns as string[] }),
-  });
   const after = await writeText(ctx, path, content);
   return {
     content: [{ type: "text", text: `wrote ${rows.length} rows to ${after.path}` }],
@@ -790,6 +787,17 @@ function failure(message: string): ToolResult {
  * Spreadsheets run a cell that starts with =, +, @ or - as a formula. A leading apostrophe keeps
  * it text. Negative numbers are left alone.
  */
+/**
+ * The rows of a csv_write as the file will read them, with the header and the formula guard.
+ * The screen shows this before a person approves a write, so both go through one function.
+ */
+export function csvText(rows: Record<string, unknown>[], columns?: string[]): string {
+  const safeRows = rows.map((row) =>
+    Object.fromEntries(Object.entries(row).map(([key, value]) => [key, neutralizeFormula(value)])),
+  );
+  return stringify(safeRows, { header: true, ...(columns && { columns }) });
+}
+
 function neutralizeFormula(value: unknown): unknown {
   if (typeof value !== "string") return value;
   return /^[=+@\t\r]/.test(value) || /^-(?![0-9.])/.test(value) ? `'${value}` : value;