@botbotgo/kit-builtin 0.0.92

package/dist/src/util/now.js

@@ -0,0 +1,51 @@
+import { getExtensionContext } from "../../index.js";
+import { overrideWithConfig } from "./overrideWithConfig.js";
+/**
+ * Get the current date and time in ISO, epoch, and formatted forms with timezone support.
+ * @tool
+ * @effect none
+ */
+export async function now(args) {
+    // Step 1: Defaults, then override with extension config; resolve timezone (arg overrides config).
+    const defaults = { timezone: "UTC" };
+    const ctx = getExtensionContext();
+    const cfg = overrideWithConfig(defaults, ctx.config);
+    const timezone = args.timezone ?? cfg.timezone ?? defaults.timezone;
+    const now = new Date();
+    // Step 2: Format in requested timezone (or ISO fallback).
+    let formatted;
+    try {
+        formatted = new Intl.DateTimeFormat("en-US", {
+            timeZone: timezone,
+            year: "numeric",
+            month: "2-digit",
+            day: "2-digit",
+            hour: "2-digit",
+            minute: "2-digit",
+            second: "2-digit",
+            hour12: false,
+            timeZoneName: "short",
+        }).format(now);
+    }
+    catch {
+        formatted = now.toISOString();
+    }
+    // Step 3: Return iso, epochMs, timezone, formatted, and evidence.
+    return {
+        result: {
+            iso: now.toISOString(),
+            epochMs: now.getTime(),
+            timezone,
+            formatted,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "core/util.time.now",
+                summary: `Current time: ${now.toISOString()} (${timezone})`,
+                createdAt: now.toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=now.js.map

package/dist/src/util/now.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"now.js","sourceRoot":"","sources":["../../../src/util/now.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAA2B;IACnD,kGAAkG;IAClG,MAAM,QAAQ,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,mBAAmB,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC;IACpE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,0DAA0D;IAC1D,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YAC3C,QAAQ,EAAE,QAAQ;YAClB,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,SAAS;YACd,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,KAAK;YACb,YAAY,EAAE,OAAO;SACtB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,SAAS,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,CAAC;IAED,kEAAkE;IAClE,OAAO;QACL,MAAM,EAAE;YACN,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE;YACtB,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;YACtB,QAAQ;YACR,SAAS;SACV;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,oBAAoB;gBACzB,OAAO,EAAE,iBAAiB,GAAG,CAAC,WAAW,EAAE,KAAK,QAAQ,GAAG;gBAC3D,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;aAC7B;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/util/overrideWithConfig.d.ts

@@ -0,0 +1,2 @@
+export { overrideWithConfig } from "@botbotgo/common/utils";
+//# sourceMappingURL=overrideWithConfig.d.ts.map

package/dist/src/util/overrideWithConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrideWithConfig.d.ts","sourceRoot":"","sources":["../../../src/util/overrideWithConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/util/overrideWithConfig.js

@@ -0,0 +1,2 @@
+export { overrideWithConfig } from "@botbotgo/common/utils";
+//# sourceMappingURL=overrideWithConfig.js.map

package/dist/src/util/overrideWithConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrideWithConfig.js","sourceRoot":"","sources":["../../../src/util/overrideWithConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/util/templateRender.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Render a Mustache template with data.
+ * @tool
+ * @effect none
+ */
+export declare function templateRender(args: {
+    template: string;
+    data: Record<string, unknown>;
+}): Promise<{
+    result: {
+        text: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=templateRender.d.ts.map

package/dist/src/util/templateRender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateRender.d.ts","sourceRoot":"","sources":["../../../src/util/templateRender.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;;;;;;;;;;GAsCA"}

package/dist/src/util/templateRender.js

@@ -0,0 +1,40 @@
+/**
+ * Render a Mustache template with data.
+ * @tool
+ * @effect none
+ */
+export async function templateRender(args) {
+    // Step 1: Load mustache and render template with data.
+    const template = args.template;
+    const data = args.data;
+    let renderFn;
+    try {
+        const mod = await import("mustache");
+        const mustache = mod.default ?? mod;
+        renderFn = mustache.render.bind(mustache);
+    }
+    catch {
+        throw new Error("mustache package is required for core/util.template.render. Install it with: npm install mustache");
+    }
+    // Step 2: Render and return result with evidence.
+    let text;
+    try {
+        text = renderFn(template, data);
+    }
+    catch (err) {
+        throw new Error(`Template rendering error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // Step 3: Return rendered text and evidence.
+    return {
+        result: { text },
+        evidence: [
+            {
+                type: "tool",
+                ref: "core/util.template.render",
+                summary: `Rendered template (${template.length} chars) → ${text.length} chars output`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=templateRender.js.map

package/dist/src/util/templateRender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateRender.js","sourceRoot":"","sources":["../../../src/util/templateRender.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAGpC;IACC,uDAAuD;IACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IAEvB,IAAI,QAAqD,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;QACpC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,mGAAmG,CACpG,CAAC;IACJ,CAAC;IAED,kDAAkD;IAClD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAChF,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,OAAO;QACL,MAAM,EAAE,EAAE,IAAI,EAAE;QAChB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,2BAA2B;gBAChC,OAAO,EAAE,sBAAsB,QAAQ,CAAC,MAAM,aAAa,IAAI,CAAC,MAAM,eAAe;gBACrF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/util/truncate.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Truncate text to a max length, appending a suffix (default '...') when exceeded.
+ * @tool
+ * @effect none
+ */
+export declare function truncate(args: {
+    text: string;
+    maxChars: number;
+    suffix?: string;
+}): Promise<{
+    result: {
+        text: string;
+        truncated: boolean;
+        originalLength: number;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=truncate.d.ts.map

package/dist/src/util/truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../../src/util/truncate.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;;;;;;;;;;;;GAuCA"}

package/dist/src/util/truncate.js

@@ -0,0 +1,44 @@
+import { getExtensionContext } from "../../index.js";
+import { overrideWithConfig } from "./overrideWithConfig.js";
+/**
+ * Truncate text to a max length, appending a suffix (default '...') when exceeded.
+ * @tool
+ * @effect none
+ */
+export async function truncate(args) {
+    // Step 1: Defaults, then override with extension config; suffix from arg or config.
+    const defaults = { suffix: "..." };
+    const ctx = getExtensionContext();
+    const cfg = overrideWithConfig(defaults, ctx.config);
+    const text = args.text;
+    const maxChars = args.maxChars;
+    const suffix = args.suffix ?? cfg.suffix ?? defaults.suffix;
+    const originalLength = text.length;
+    if (text.length <= maxChars) {
+        return {
+            result: { text, truncated: false, originalLength },
+            evidence: [
+                {
+                    type: "tool",
+                    ref: "core/util.text.truncate",
+                    summary: `Text not truncated (${originalLength} chars <= ${maxChars} max)`,
+                    createdAt: new Date().toISOString(),
+                },
+            ],
+        };
+    }
+    // Step 2: Truncate and return result with evidence.
+    const truncatedText = text.slice(0, maxChars - suffix.length) + suffix;
+    return {
+        result: { text: truncatedText, truncated: true, originalLength },
+        evidence: [
+            {
+                type: "tool",
+                ref: "core/util.text.truncate",
+                summary: `Truncated ${originalLength} chars to ${truncatedText.length} chars`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=truncate.js.map

package/dist/src/util/truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../../src/util/truncate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAI9B;IACC,oFAAoF;IACpF,MAAM,QAAQ,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,mBAAmB,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC;IAE5D,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC;IAEnC,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC5B,OAAO;YACL,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE;YAClD,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,GAAG,EAAE,yBAAyB;oBAC9B,OAAO,EAAE,uBAAuB,cAAc,aAAa,QAAQ,OAAO;oBAC1E,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC;aACF;SACF,CAAC;IACJ,CAAC;IAED,oDAAoD;IACpD,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAEvE,OAAO;QACL,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE;QAChE,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,yBAAyB;gBAC9B,OAAO,EAAE,aAAa,cAAc,aAAa,aAAa,CAAC,MAAM,QAAQ;gBAC7E,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/vitest.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vite").UserConfig;
+export default _default;
+//# sourceMappingURL=vitest.config.d.ts.map

package/dist/vitest.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.d.ts","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":";AAEA,wBAKG"}

package/dist/vitest.config.js

@@ -0,0 +1,8 @@
+import { defineConfig } from "vitest/config";
+export default defineConfig({
+    test: {
+        include: ["test/**/*.test.ts"],
+        globals: false,
+    },
+});
+//# sourceMappingURL=vitest.config.js.map

package/dist/vitest.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.js","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAe,YAAY,CAAC;IAC1B,IAAI,EAAE;QACJ,OAAO,EAAE,CAAC,mBAAmB,CAAC;QAC9B,OAAO,EAAE,KAAK;KACf;CACF,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@botbotgo/kit-builtin",
+  "version": "0.0.92",
+  "description": "Tools extension for @botbotgo/kit: FS, HTTP, util, security (sandbox, SSRF). Same contract as any other extension.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./iterm": {
+      "types": "./dist/src/iterm/itermTools.d.ts",
+      "import": "./dist/src/iterm/itermTools.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "preinstall": "node -e \"const fs=require('fs'); const {execSync}=require('child_process'); if (fs.existsSync('scripts/resolve-deps.js')) { execSync('node scripts/resolve-deps.js', { stdio: 'inherit' }); } else { console.log('Skipping resolve-deps for published package'); }\"",
+    "prebuild": "npm run build --prefix ../kit 2>/dev/null || true",
+    "build": "npm run check:tool-files && tsx generate-manifest.ts && tsc -p tsconfig.build.json && (mkdir -p dist/config && cp config/tool.yaml dist/config/tool.yaml)",
+    "check:tool-files": "tsx scripts/check-tool-files.ts",
+    "clean": "rm -rf dist",
+    "pretest": "npm run build",
+    "test": "vitest run",
+    "test:iterm-live": "tsx scripts/test-iterm-live.ts",
+    "test:iterm-integration": "npm run build --prefix ../kit && RUN_REAL_SYSTEM_INTEGRATION=1 vitest run test/integration/itermTools.integration.test.ts",
+    "test:macos-integration": "npm run build --prefix ../kit && RUN_REAL_SYSTEM_INTEGRATION=1 vitest run test/integration/macosTools.integration.test.ts",
+    "test:macos-integration:write": "npm run build --prefix ../kit && RUN_REAL_SYSTEM_INTEGRATION=1 vitest run test/integration/macosTools.integration.test.ts",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit"
+  },
+  "dependencies": {
+    "@botbotgo/common": "latest",
+    "node-html-parser": "^6.1.13"
+  },
+  "peerDependencies": {
+    "@botbotgo/kit": "*"
+  },
+  "devDependencies": {
+    "@botbotgo/kit": "latest",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/npm": "^12.0.0",
+    "@types/jmespath": "^0.15.0",
+    "@types/mustache": "^4.2.5",
+    "semantic-release": "^24.0.0",
+    "tsx": "^4.19.2",
+    "typescript": "~5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/botbotgo/kit-builtin.git"
+  },
+  "license": "MIT"
+}