@gui-chat-plugin/spreadsheet 0.1.0

package/README.md

@@ -0,0 +1,103 @@
+# @gui-chat-plugin/spreadsheet
+
+A spreadsheet plugin for [MulmoChat](https://github.com/receptron/MulmoChat) - a multi-modal voice chat application with OpenAI's GPT-4 Realtime API.
+
+## What this plugin does
+
+This plugin provides a full-featured spreadsheet component with:
+
+- Excel-like cell editing with formula support
+- Mathematical functions (SUM, AVERAGE, MIN, MAX, etc.)
+- Text functions (CONCATENATE, LEFT, RIGHT, MID, etc.)
+- Date functions (TODAY, NOW, DATE, YEAR, MONTH, DAY, etc.)
+- Logical functions (IF, AND, OR, NOT, etc.)
+- Lookup functions (VLOOKUP, HLOOKUP, INDEX, MATCH)
+- Financial functions (PMT, PV, FV, NPV, IRR)
+- Multi-sheet support
+- Excel file import/export (.xlsx)
+- Cell formatting and styling
+
+## Installation
+
+```bash
+yarn add @gui-chat-plugin/spreadsheet
+```
+
+## Usage
+
+### Vue Implementation (for MulmoChat)
+
+```typescript
+// In src/tools/index.ts
+import SpreadsheetPlugin from "@gui-chat-plugin/spreadsheet/vue";
+
+const pluginList = [
+  // ... other plugins
+  SpreadsheetPlugin,
+];
+
+// In src/main.ts
+import "@gui-chat-plugin/spreadsheet/style.css";
+```
+
+### Core Only (Framework-agnostic)
+
+```typescript
+import { pluginCore, TOOL_NAME } from "@gui-chat-plugin/spreadsheet";
+// or
+import pluginCore from "@gui-chat-plugin/spreadsheet";
+```
+
+## Package Exports
+
+| Export | Description |
+|--------|-------------|
+| `@gui-chat-plugin/spreadsheet` | Core (framework-agnostic) |
+| `@gui-chat-plugin/spreadsheet/vue` | Vue implementation with UI components |
+| `@gui-chat-plugin/spreadsheet/style.css` | Tailwind CSS styles |
+
+## Supported Functions
+
+### Mathematical
+`SUM`, `AVERAGE`, `MIN`, `MAX`, `COUNT`, `COUNTA`, `ABS`, `ROUND`, `FLOOR`, `CEILING`, `POWER`, `SQRT`, `MOD`, `RAND`, `RANDBETWEEN`, `PI`
+
+### Text
+`CONCATENATE`, `LEFT`, `RIGHT`, `MID`, `LEN`, `UPPER`, `LOWER`, `PROPER`, `TRIM`, `SUBSTITUTE`, `REPLACE`, `TEXT`, `VALUE`, `FIND`, `SEARCH`, `REPT`
+
+### Date & Time
+`TODAY`, `NOW`, `DATE`, `YEAR`, `MONTH`, `DAY`, `HOUR`, `MINUTE`, `SECOND`, `WEEKDAY`, `DAYS`, `EDATE`, `EOMONTH`, `WORKDAY`, `NETWORKDAYS`, `DATEDIF`
+
+### Logical
+`IF`, `AND`, `OR`, `NOT`, `TRUE`, `FALSE`, `IFERROR`, `IFNA`, `IFS`, `SWITCH`, `XOR`
+
+### Lookup
+`VLOOKUP`, `HLOOKUP`, `INDEX`, `MATCH`, `OFFSET`, `INDIRECT`, `ROW`, `COLUMN`, `ROWS`, `COLUMNS`, `TRANSPOSE`
+
+### Statistical
+`MEDIAN`, `MODE`, `STDEV`, `STDEVP`, `VAR`, `VARP`, `LARGE`, `SMALL`, `RANK`, `PERCENTILE`, `QUARTILE`, `CORREL`, `COUNTIF`, `COUNTIFS`, `SUMIF`, `SUMIFS`, `AVERAGEIF`, `AVERAGEIFS`
+
+### Financial
+`PMT`, `PV`, `FV`, `NPV`, `IRR`, `RATE`, `NPER`, `IPMT`, `PPMT`, `SLN`, `DB`, `DDB`
+
+## Development
+
+```bash
+# Install dependencies
+yarn install
+
+# Start dev server (http://localhost:5173/)
+yarn dev
+
+# Build
+yarn build
+
+# Type check
+yarn typecheck
+
+# Lint
+yarn lint
+```
+
+## License
+
+MIT

package/dist/core/definition.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Spreadsheet Tool Definition (Schema)
+ */
+import type { ToolDefinition } from "gui-chat-protocol";
+export declare const TOOL_NAME = "presentSpreadsheet";
+export declare const TOOL_DEFINITION: ToolDefinition;
+export declare const SYSTEM_PROMPT = "Use presentSpreadsheet whenever the user needs a spreadsheet-style table, multi-step math, or dynamic what-if analysis\u2014do not summarize in text. Build LIVE sheets where every cell is an object {\"v\": value, \"f\": format}. For formulas, set \"v\" to a string starting with \"=\" (e.g., {\"v\": \"=B2*1.05\", \"f\": \"$#,##0.00\"}). For dates, use date strings like \"01/15/2025\" or date formulas like \"=TODAY()\" or \"=DATE(2025,1,15)\". The spreadsheet auto-parses common date formats (MM/DD/YYYY, YYYY-MM-DD, DD-MMM-YYYY) into date serial numbers for calculations. Date arithmetic works: \"=B2-TODAY()\" calculates days between dates. Never pre-calculate; let the spreadsheet compute using cell refs, functions (SUM, AVERAGE, IF, TODAY, DATE, DATEDIF, etc.), and arithmetic. Standard formats: \"$#,##0.00\" currency, \"#,##0\" integer, \"0.00%\" percent, \"0.00\" decimal, \"MM/DD/YYYY\" date, \"DD-MMM-YYYY\" date, \"YYYY-MM-DD\" ISO date. Format is optional for plain text/numbers.";

package/dist/core/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Spreadsheet Plugin - Core (Framework-agnostic)
+ *
+ * This module exports the core plugin logic without UI components.
+ * Import from "@anthropic/guichat-plugin-spreadsheet" or "@anthropic/guichat-plugin-spreadsheet/core"
+ */
+export type { SpreadsheetCell, SpreadsheetSheet, SpreadsheetToolData, SpreadsheetArgs, } from "./types";
+export { TOOL_NAME, TOOL_DEFINITION, SYSTEM_PROMPT, executeSpreadsheet, pluginCore, } from "./plugin";
+export { samples } from "./samples";

package/dist/core/plugin.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Spreadsheet Plugin Core (Framework-agnostic)
+ *
+ * Contains the plugin logic without UI components.
+ * Can be used by any framework (Vue, React, etc.)
+ */
+import type { ToolPluginCore, ToolContext, ToolResult } from "gui-chat-protocol";
+import type { SpreadsheetToolData, SpreadsheetArgs } from "./types";
+export { TOOL_NAME, TOOL_DEFINITION, SYSTEM_PROMPT } from "./definition";
+export declare const executeSpreadsheet: (_context: ToolContext, args: SpreadsheetArgs) => Promise<ToolResult<SpreadsheetToolData, never>>;
+export declare const pluginCore: ToolPluginCore<SpreadsheetToolData, never, SpreadsheetArgs>;

package/dist/core/samples.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Spreadsheet Plugin Samples
+ */
+import type { ToolSample } from "gui-chat-protocol";
+export declare const samples: ToolSample[];

package/dist/core/types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Spreadsheet Plugin Types
+ *
+ * Plugin-specific types only.
+ * Common types are imported from gui-chat-protocol.
+ */
+export interface SpreadsheetCell {
+    v: string | number;
+    f?: string;
+}
+export interface SpreadsheetSheet {
+    name: string;
+    data: Array<Array<SpreadsheetCell>>;
+}
+export interface SpreadsheetToolData {
+    sheets: SpreadsheetSheet[];
+}
+export interface SpreadsheetArgs {
+    title: string;
+    sheets: SpreadsheetSheet[];
+}

package/dist/core.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a="presentSpreadsheet",n={type:"function",name:a,description:"Display an Excel-like spreadsheet with formulas and calculations.",parameters:{type:"object",properties:{title:{type:"string",description:"Title for the spreadsheet"},sheets:{type:"array",description:"Sheets to render as spreadsheet tabs. Each sheet includes a name and 2D array of cells (rows x columns).",items:{type:"object",properties:{name:{type:"string",description:"Sheet name (e.g., 'Sales Q1', 'Summary')"},data:{type:"array",description:`Rows of cells. Each cell is an object with 'v' (value) and 'f' (format). Use Excel-style A1 notation in formulas: columns are letters (A, B, C...), rows are 1-based numbers (1, 2, 3...). Values can be text, numbers, dates, or formulas. Examples: [{"v": "Product"}, {"v": 2024, "f": "#,##0"}, {"v": "01/15/2025", "f": "MM/DD/YYYY"}, {"v": "=B2*1.05", "f": "$#,##0.00"}]. Format codes: '$#,##0.00' (currency), '#,##0' (integer), '0.00%' (percent), '0.00' (decimal), 'MM/DD/YYYY' (date), 'DD-MMM-YYYY' (date), 'YYYY-MM-DD' (ISO date).`,items:{type:"array",description:"Row of cells. Each cell is an object with value and format.",items:{type:"object",description:"Cell object with value and optional format. If value is a string starting with '=', it's treated as a formula.",properties:{v:{oneOf:[{type:"string"},{type:"number"}],description:"Cell value. Can be text, number, date, or formula (string starting with '='). Examples: 'Revenue', 1500000, '01/15/2025', '=SUM(A1:A10)', '=B2-TODAY()'. Date strings like '01/15/2025' are automatically parsed to date serial numbers."},f:{type:"string",description:"Optional format code for displaying the value. Common formats: '$#,##0.00' (currency), '#,##0' (integer), '0.00%' (percent), '0.00' (decimal), 'MM/DD/YYYY' (date), 'DD-MMM-YYYY' (date), 'YYYY-MM-DD' (ISO date)"}},required:["v"]}}}},required:["name","data"]}}},required:["title","sheets"]}},o=`Use ${a} whenever the user needs a spreadsheet-style table, multi-step math, or dynamic what-if analysis—do not summarize in text. Build LIVE sheets where every cell is an object {"v": value, "f": format}. For formulas, set "v" to a string starting with "=" (e.g., {"v": "=B2*1.05", "f": "$#,##0.00"}). For dates, use date strings like "01/15/2025" or date formulas like "=TODAY()" or "=DATE(2025,1,15)". The spreadsheet auto-parses common date formats (MM/DD/YYYY, YYYY-MM-DD, DD-MMM-YYYY) into date serial numbers for calculations. Date arithmetic works: "=B2-TODAY()" calculates days between dates. Never pre-calculate; let the spreadsheet compute using cell refs, functions (SUM, AVERAGE, IF, TODAY, DATE, DATEDIF, etc.), and arithmetic. Standard formats: "$#,##0.00" currency, "#,##0" integer, "0.00%" percent, "0.00" decimal, "MM/DD/YYYY" date, "DD-MMM-YYYY" date, "YYYY-MM-DD" ISO date. Format is optional for plain text/numbers.`,v=async(d,r)=>{const{title:s}=r;let{sheets:t}=r;if(typeof t=="string")try{t=JSON.parse(t),console.warn("Sheets was provided as a string and has been parsed to an array")}catch(e){throw new Error(`Invalid sheets format: sheets must be an array, not a string. Parse error: ${e instanceof Error?e.message:String(e)}`)}if(!Array.isArray(t)||t.length===0)throw new Error("At least one sheet is required. Sheets must be an array of sheet objects.");for(const e of t)if(!e.name||!e.data||e.data.length===0)throw new Error(`Invalid sheet: ${e.name||"unnamed"}. Each sheet must have a name and data array.`);return{message:`Created spreadsheet: ${s}`,title:s,data:{sheets:t},instructions:"Acknowledge that the spreadsheet has been created and is displayed to the user."}},i={toolDefinition:n,execute:v,generatingMessage:"Creating spreadsheet...",waitingMessage:"Tell the user that the spreadsheet was created and will be presented shortly.",isEnabled:()=>!0,systemPrompt:o},l=[{name:"Simple Budget",args:{title:"Monthly Budget",sheets:[{name:"Budget",data:[[{v:"Category"},{v:"Amount"}],[{v:"Income"},{v:5e3,f:"$#,##0.00"}],[{v:"Rent"},{v:-1500,f:"$#,##0.00"}],[{v:"Utilities"},{v:-200,f:"$#,##0.00"}],[{v:"Food"},{v:-600,f:"$#,##0.00"}],[{v:"Transport"},{v:-300,f:"$#,##0.00"}],[{v:"Total"},{v:"=SUM(B2:B6)",f:"$#,##0.00"}]]}]}},{name:"Sales Report",args:{title:"Q1 Sales Report",sheets:[{name:"Sales",data:[[{v:"Product"},{v:"Jan"},{v:"Feb"},{v:"Mar"},{v:"Total"}],[{v:"Widget A"},{v:1200},{v:1350},{v:1500},{v:"=SUM(B2:D2)"}],[{v:"Widget B"},{v:800},{v:920},{v:1100},{v:"=SUM(B3:D3)"}],[{v:"Widget C"},{v:450},{v:480},{v:520},{v:"=SUM(B4:D4)"}],[{v:"Total"},{v:"=SUM(B2:B4)"},{v:"=SUM(C2:C4)"},{v:"=SUM(D2:D4)"},{v:"=SUM(E2:E4)"}]]}]}},{name:"Loan Calculator",args:{title:"Loan Calculator",sheets:[{name:"Calculator",data:[[{v:"Loan Amount"},{v:25e4,f:"$#,##0"}],[{v:"Interest Rate"},{v:.065,f:"0.00%"}],[{v:"Term (Years)"},{v:30}],[{v:""},{v:""}],[{v:"Monthly Payment"},{v:"=PMT(B2/12, B3*12, -B1)",f:"$#,##0.00"}],[{v:"Total Interest"},{v:"=B5*B3*12-B1",f:"$#,##0.00"}]]}]}},{name:"World Population",args:{title:"世界人口（上位10）",sheets:[{name:"世界人口（上位10）",data:[[{v:"順位"},{v:"国・地域"},{v:"人口（概数）",f:"#,##0"},{v:"上位10合計に占める割合"},{v:"世界人口に占める割合"}],[{v:1,f:"#,##0"},{v:"インド"},{v:1428627e3,f:"#,##0"},{v:"=C2/$C$12",f:"0.00%"},{v:"=C2/$C$13",f:"0.00%"}],[{v:2,f:"#,##0"},{v:"中国"},{v:1425671e3,f:"#,##0"},{v:"=C3/$C$12",f:"0.00%"},{v:"=C3/$C$13",f:"0.00%"}],[{v:3,f:"#,##0"},{v:"アメリカ合衆国"},{v:334e6,f:"#,##0"},{v:"=C4/$C$12",f:"0.00%"},{v:"=C4/$C$13",f:"0.00%"}],[{v:4,f:"#,##0"},{v:"インドネシア"},{v:277e6,f:"#,##0"},{v:"=C5/$C$12",f:"0.00%"},{v:"=C5/$C$13",f:"0.00%"}],[{v:5,f:"#,##0"},{v:"パキスタン"},{v:24e7,f:"#,##0"},{v:"=C6/$C$12",f:"0.00%"},{v:"=C6/$C$13",f:"0.00%"}],[{v:6,f:"#,##0"},{v:"ナイジェリア"},{v:219e6,f:"#,##0"},{v:"=C7/$C$12",f:"0.00%"},{v:"=C7/$C$13",f:"0.00%"}],[{v:7,f:"#,##0"},{v:"ブラジル"},{v:216e6,f:"#,##0"},{v:"=C8/$C$12",f:"0.00%"},{v:"=C8/$C$13",f:"0.00%"}],[{v:8,f:"#,##0"},{v:"バングラデシュ"},{v:172e6,f:"#,##0"},{v:"=C9/$C$12",f:"0.00%"},{v:"=C9/$C$13",f:"0.00%"}],[{v:9,f:"#,##0"},{v:"ロシア"},{v:146e6,f:"#,##0"},{v:"=C10/$C$12",f:"0.00%"},{v:"=C10/$C$13",f:"0.00%"}],[{v:10,f:"#,##0"},{v:"メキシコ"},{v:13e7,f:"#,##0"},{v:"=C11/$C$12",f:"0.00%"},{v:"=C11/$C$13",f:"0.00%"}],[{v:""},{v:"合計（上位10）"},{v:"=SUM(C2:C11)",f:"#,##0"},{v:""},{v:""}],[{v:""},{v:"世界推定人口（例）"},{v:805e7,f:"#,##0"},{v:""},{v:""}]]}]}}];exports.SYSTEM_PROMPT=o;exports.TOOL_DEFINITION=n;exports.TOOL_NAME=a;exports.executeSpreadsheet=v;exports.pluginCore=i;exports.samples=l;

package/dist/core.js

@@ -0,0 +1,257 @@
+const s = "presentSpreadsheet", n = {
+  type: "function",
+  name: s,
+  description: "Display an Excel-like spreadsheet with formulas and calculations.",
+  parameters: {
+    type: "object",
+    properties: {
+      title: {
+        type: "string",
+        description: "Title for the spreadsheet"
+      },
+      sheets: {
+        type: "array",
+        description: "Sheets to render as spreadsheet tabs. Each sheet includes a name and 2D array of cells (rows x columns).",
+        items: {
+          type: "object",
+          properties: {
+            name: {
+              type: "string",
+              description: "Sheet name (e.g., 'Sales Q1', 'Summary')"
+            },
+            data: {
+              type: "array",
+              description: `Rows of cells. Each cell is an object with 'v' (value) and 'f' (format). Use Excel-style A1 notation in formulas: columns are letters (A, B, C...), rows are 1-based numbers (1, 2, 3...). Values can be text, numbers, dates, or formulas. Examples: [{"v": "Product"}, {"v": 2024, "f": "#,##0"}, {"v": "01/15/2025", "f": "MM/DD/YYYY"}, {"v": "=B2*1.05", "f": "$#,##0.00"}]. Format codes: '$#,##0.00' (currency), '#,##0' (integer), '0.00%' (percent), '0.00' (decimal), 'MM/DD/YYYY' (date), 'DD-MMM-YYYY' (date), 'YYYY-MM-DD' (ISO date).`,
+              items: {
+                type: "array",
+                description: "Row of cells. Each cell is an object with value and format.",
+                items: {
+                  type: "object",
+                  description: "Cell object with value and optional format. If value is a string starting with '=', it's treated as a formula.",
+                  properties: {
+                    v: {
+                      oneOf: [{ type: "string" }, { type: "number" }],
+                      description: "Cell value. Can be text, number, date, or formula (string starting with '='). Examples: 'Revenue', 1500000, '01/15/2025', '=SUM(A1:A10)', '=B2-TODAY()'. Date strings like '01/15/2025' are automatically parsed to date serial numbers."
+                    },
+                    f: {
+                      type: "string",
+                      description: "Optional format code for displaying the value. Common formats: '$#,##0.00' (currency), '#,##0' (integer), '0.00%' (percent), '0.00' (decimal), 'MM/DD/YYYY' (date), 'DD-MMM-YYYY' (date), 'YYYY-MM-DD' (ISO date)"
+                    }
+                  },
+                  required: ["v"]
+                }
+              }
+            }
+          },
+          required: ["name", "data"]
+        }
+      }
+    },
+    required: ["title", "sheets"]
+  }
+}, o = `Use ${s} whenever the user needs a spreadsheet-style table, multi-step math, or dynamic what-if analysis—do not summarize in text. Build LIVE sheets where every cell is an object {"v": value, "f": format}. For formulas, set "v" to a string starting with "=" (e.g., {"v": "=B2*1.05", "f": "$#,##0.00"}). For dates, use date strings like "01/15/2025" or date formulas like "=TODAY()" or "=DATE(2025,1,15)". The spreadsheet auto-parses common date formats (MM/DD/YYYY, YYYY-MM-DD, DD-MMM-YYYY) into date serial numbers for calculations. Date arithmetic works: "=B2-TODAY()" calculates days between dates. Never pre-calculate; let the spreadsheet compute using cell refs, functions (SUM, AVERAGE, IF, TODAY, DATE, DATEDIF, etc.), and arithmetic. Standard formats: "$#,##0.00" currency, "#,##0" integer, "0.00%" percent, "0.00" decimal, "MM/DD/YYYY" date, "DD-MMM-YYYY" date, "YYYY-MM-DD" ISO date. Format is optional for plain text/numbers.`, v = async (i, a) => {
+  const { title: r } = a;
+  let { sheets: t } = a;
+  if (typeof t == "string")
+    try {
+      t = JSON.parse(t), console.warn(
+        "Sheets was provided as a string and has been parsed to an array"
+      );
+    } catch (e) {
+      throw new Error(
+        `Invalid sheets format: sheets must be an array, not a string. Parse error: ${e instanceof Error ? e.message : String(e)}`
+      );
+    }
+  if (!Array.isArray(t) || t.length === 0)
+    throw new Error(
+      "At least one sheet is required. Sheets must be an array of sheet objects."
+    );
+  for (const e of t)
+    if (!e.name || !e.data || e.data.length === 0)
+      throw new Error(
+        `Invalid sheet: ${e.name || "unnamed"}. Each sheet must have a name and data array.`
+      );
+  return {
+    message: `Created spreadsheet: ${r}`,
+    title: r,
+    data: { sheets: t },
+    instructions: "Acknowledge that the spreadsheet has been created and is displayed to the user."
+  };
+}, l = {
+  toolDefinition: n,
+  execute: v,
+  generatingMessage: "Creating spreadsheet...",
+  waitingMessage: "Tell the user that the spreadsheet was created and will be presented shortly.",
+  isEnabled: () => !0,
+  systemPrompt: o
+}, d = [
+  {
+    name: "Simple Budget",
+    args: {
+      title: "Monthly Budget",
+      sheets: [
+        {
+          name: "Budget",
+          data: [
+            [{ v: "Category" }, { v: "Amount" }],
+            [{ v: "Income" }, { v: 5e3, f: "$#,##0.00" }],
+            [{ v: "Rent" }, { v: -1500, f: "$#,##0.00" }],
+            [{ v: "Utilities" }, { v: -200, f: "$#,##0.00" }],
+            [{ v: "Food" }, { v: -600, f: "$#,##0.00" }],
+            [{ v: "Transport" }, { v: -300, f: "$#,##0.00" }],
+            [{ v: "Total" }, { v: "=SUM(B2:B6)", f: "$#,##0.00" }]
+          ]
+        }
+      ]
+    }
+  },
+  {
+    name: "Sales Report",
+    args: {
+      title: "Q1 Sales Report",
+      sheets: [
+        {
+          name: "Sales",
+          data: [
+            [{ v: "Product" }, { v: "Jan" }, { v: "Feb" }, { v: "Mar" }, { v: "Total" }],
+            [{ v: "Widget A" }, { v: 1200 }, { v: 1350 }, { v: 1500 }, { v: "=SUM(B2:D2)" }],
+            [{ v: "Widget B" }, { v: 800 }, { v: 920 }, { v: 1100 }, { v: "=SUM(B3:D3)" }],
+            [{ v: "Widget C" }, { v: 450 }, { v: 480 }, { v: 520 }, { v: "=SUM(B4:D4)" }],
+            [{ v: "Total" }, { v: "=SUM(B2:B4)" }, { v: "=SUM(C2:C4)" }, { v: "=SUM(D2:D4)" }, { v: "=SUM(E2:E4)" }]
+          ]
+        }
+      ]
+    }
+  },
+  {
+    name: "Loan Calculator",
+    args: {
+      title: "Loan Calculator",
+      sheets: [
+        {
+          name: "Calculator",
+          data: [
+            [{ v: "Loan Amount" }, { v: 25e4, f: "$#,##0" }],
+            [{ v: "Interest Rate" }, { v: 0.065, f: "0.00%" }],
+            [{ v: "Term (Years)" }, { v: 30 }],
+            [{ v: "" }, { v: "" }],
+            [{ v: "Monthly Payment" }, { v: "=PMT(B2/12, B3*12, -B1)", f: "$#,##0.00" }],
+            [{ v: "Total Interest" }, { v: "=B5*B3*12-B1", f: "$#,##0.00" }]
+          ]
+        }
+      ]
+    }
+  },
+  {
+    name: "World Population",
+    args: {
+      title: "世界人口（上位10）",
+      sheets: [
+        {
+          name: "世界人口（上位10）",
+          data: [
+            [
+              { v: "順位" },
+              { v: "国・地域" },
+              { v: "人口（概数）", f: "#,##0" },
+              { v: "上位10合計に占める割合" },
+              { v: "世界人口に占める割合" }
+            ],
+            [
+              { v: 1, f: "#,##0" },
+              { v: "インド" },
+              { v: 1428627e3, f: "#,##0" },
+              { v: "=C2/$C$12", f: "0.00%" },
+              { v: "=C2/$C$13", f: "0.00%" }
+            ],
+            [
+              { v: 2, f: "#,##0" },
+              { v: "中国" },
+              { v: 1425671e3, f: "#,##0" },
+              { v: "=C3/$C$12", f: "0.00%" },
+              { v: "=C3/$C$13", f: "0.00%" }
+            ],
+            [
+              { v: 3, f: "#,##0" },
+              { v: "アメリカ合衆国" },
+              { v: 334e6, f: "#,##0" },
+              { v: "=C4/$C$12", f: "0.00%" },
+              { v: "=C4/$C$13", f: "0.00%" }
+            ],
+            [
+              { v: 4, f: "#,##0" },
+              { v: "インドネシア" },
+              { v: 277e6, f: "#,##0" },
+              { v: "=C5/$C$12", f: "0.00%" },
+              { v: "=C5/$C$13", f: "0.00%" }
+            ],
+            [
+              { v: 5, f: "#,##0" },
+              { v: "パキスタン" },
+              { v: 24e7, f: "#,##0" },
+              { v: "=C6/$C$12", f: "0.00%" },
+              { v: "=C6/$C$13", f: "0.00%" }
+            ],
+            [
+              { v: 6, f: "#,##0" },
+              { v: "ナイジェリア" },
+              { v: 219e6, f: "#,##0" },
+              { v: "=C7/$C$12", f: "0.00%" },
+              { v: "=C7/$C$13", f: "0.00%" }
+            ],
+            [
+              { v: 7, f: "#,##0" },
+              { v: "ブラジル" },
+              { v: 216e6, f: "#,##0" },
+              { v: "=C8/$C$12", f: "0.00%" },
+              { v: "=C8/$C$13", f: "0.00%" }
+            ],
+            [
+              { v: 8, f: "#,##0" },
+              { v: "バングラデシュ" },
+              { v: 172e6, f: "#,##0" },
+              { v: "=C9/$C$12", f: "0.00%" },
+              { v: "=C9/$C$13", f: "0.00%" }
+            ],
+            [
+              { v: 9, f: "#,##0" },
+              { v: "ロシア" },
+              { v: 146e6, f: "#,##0" },
+              { v: "=C10/$C$12", f: "0.00%" },
+              { v: "=C10/$C$13", f: "0.00%" }
+            ],
+            [
+              { v: 10, f: "#,##0" },
+              { v: "メキシコ" },
+              { v: 13e7, f: "#,##0" },
+              { v: "=C11/$C$12", f: "0.00%" },
+              { v: "=C11/$C$13", f: "0.00%" }
+            ],
+            [
+              { v: "" },
+              { v: "合計（上位10）" },
+              { v: "=SUM(C2:C11)", f: "#,##0" },
+              { v: "" },
+              { v: "" }
+            ],
+            [
+              { v: "" },
+              { v: "世界推定人口（例）" },
+              { v: 805e7, f: "#,##0" },
+              { v: "" },
+              { v: "" }
+            ]
+          ]
+        }
+      ]
+    }
+  }
+];
+export {
+  o as SYSTEM_PROMPT,
+  n as TOOL_DEFINITION,
+  s as TOOL_NAME,
+  v as executeSpreadsheet,
+  l as pluginCore,
+  d as samples
+};

package/dist/engine/calculator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Spreadsheet Calculator
+ *
+ * Core calculation engine with circular reference detection and cross-sheet support
+ */
+import type { SheetData, CalculatedSheet } from "./types";
+/**
+ * Calculate formulas in a single sheet
+ *
+ * @param sheet - Sheet data to calculate
+ * @param allSheets - All sheets for cross-sheet references
+ * @returns Calculated sheet with formulas evaluated
+ */
+export declare function calculateSheet(sheet: SheetData, allSheets?: SheetData[]): CalculatedSheet;
+/**
+ * Calculate all sheets in a workbook
+ *
+ * @param sheets - Array of sheets to calculate
+ * @returns Array of calculated sheets
+ */
+export declare function calculateWorkbook(sheets: SheetData[]): CalculatedSheet[];

package/dist/engine/date-parser.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Date Parsing Utilities
+ *
+ * Parse various date string formats into Excel serial numbers.
+ */
+/**
+ * Check if a string looks like a date
+ *
+ * @param str - String to check
+ * @returns true if string matches common date patterns
+ */
+export declare function isDateLike(str: string): boolean;
+/**
+ * Parse a date string into Excel serial number
+ *
+ * Supports formats:
+ * - MM/DD/YYYY, M/D/YYYY
+ * - DD/MM/YYYY (when day > 12)
+ * - YYYY-MM-DD, YYYY/MM/DD (ISO format)
+ * - DD-MMM-YYYY, D-MMM-YYYY
+ * - MMM D, YYYY, MMMM D, YYYY
+ *
+ * @param dateStr - String that might contain a date
+ * @param preferDDMMYYYY - Prefer DD/MM/YYYY over MM/DD/YYYY for ambiguous dates (default: false)
+ * @returns Serial number or null if not a valid date
+ */
+export declare function parseDate(dateStr: string, preferDDMMYYYY?: boolean): number | null;
+/**
+ * Get default date format based on parsed date
+ *
+ * @param originalStr - Original date string
+ * @returns Appropriate format code
+ */
+export declare function getDefaultDateFormat(originalStr: string): string;

package/dist/engine/date-utils.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Date Utility Functions
+ *
+ * Shared utilities for converting between JavaScript Date objects and Excel serial numbers.
+ * Excel stores dates as sequential serial numbers so they can be used in calculations.
+ * January 1, 1900 is serial number 1.
+ */
+/**
+ * Convert JavaScript Date to Excel Serial Number
+ *
+ * @param date - JavaScript Date object
+ * @returns Excel serial number (days since Dec 30, 1899)
+ */
+export declare const dateToSerial: (date: Date) => number;
+/**
+ * Convert Excel Serial Number to JavaScript Date
+ *
+ * @param serial - Excel serial number
+ * @returns JavaScript Date object
+ */
+export declare const serialToDate: (serial: number) => Date;
+/**
+ * Month names for formatting
+ */
+export declare const MONTH_NAMES_SHORT: string[];
+export declare const MONTH_NAMES_FULL: string[];
+/**
+ * Day names for formatting
+ */
+export declare const DAY_NAMES_SHORT: string[];
+export declare const DAY_NAMES_FULL: string[];

package/dist/engine/engine.d.ts

@@ -0,0 +1,134 @@
+/**
+ * SpreadsheetEngine - Main API
+ *
+ * High-level interface for spreadsheet calculations
+ */
+import type { SheetData, CalculatedSheet, EngineOptions, SpreadsheetCell } from "./types";
+/**
+ * SpreadsheetEngine - Main calculation engine class
+ *
+ * Provides a clean API for calculating spreadsheet formulas with support for:
+ * - Formula evaluation (SUM, AVERAGE, IF, etc.)
+ * - Cell references (A1, $B$2, Sheet1!C3)
+ * - Cross-sheet references
+ * - Number formatting ($#,##0.00, 0.00%, etc.)
+ * - Circular reference detection
+ *
+ * @example
+ * ```typescript
+ * const engine = new SpreadsheetEngine();
+ * const sheet = {
+ *   name: 'Sales',
+ *   data: [
+ *     [{v: 'Product'}, {v: 'Price'}, {v: 'Qty'}, {v: 'Total'}],
+ *     [{v: 'Widget'}, {v: 10}, {v: 100}, {v: '=B2*C2'}],
+ *   ]
+ * };
+ * const result = engine.calculate(sheet);
+ * console.log(result.data); // [['Product', 'Price', 'Qty', 'Total'], ['Widget', 10, 100, 1000]]
+ * ```
+ */
+export declare class SpreadsheetEngine {
+    private options;
+    /**
+     * Create a new SpreadsheetEngine
+     *
+     * @param options - Configuration options
+     */
+    constructor(options?: EngineOptions);
+    /**
+     * Calculate a single sheet
+     *
+     * Evaluates all formulas in the sheet and applies number formatting.
+     * Returns calculated values with formula metadata and any errors.
+     *
+     * @param sheet - Sheet data with formulas
+     * @param allSheets - Optional array of all sheets for cross-sheet references
+     * @returns Calculated sheet with evaluated formulas
+     *
+     * @example
+     * ```typescript
+     * const result = engine.calculate({
+     *   name: 'Budget',
+     *   data: [
+     *     [{v: 'Item'}, {v: 'Amount'}],
+     *     [{v: 'Revenue'}, {v: 1000}],
+     *     [{v: 'Expenses'}, {v: 600}],
+     *     [{v: 'Profit'}, {v: '=B2-B3'}],
+     *   ]
+     * });
+     * console.log(result.data[3][1]); // 400
+     * ```
+     */
+    calculate(sheet: SheetData, allSheets?: SheetData[]): CalculatedSheet;
+    /**
+     * Calculate all sheets in a workbook
+     *
+     * Evaluates formulas across multiple sheets with support for
+     * cross-sheet references (e.g., Sheet1!A1).
+     *
+     * @param sheets - Array of sheets to calculate
+     * @returns Array of calculated sheets
+     *
+     * @example
+     * ```typescript
+     * const results = engine.calculateWorkbook([
+     *   { name: 'Data', data: [[{v: 100}]] },
+     *   { name: 'Summary', data: [[{v: '=Data!A1*2'}]] }
+     * ]);
+     * console.log(results[1].data[0][0]); // 200
+     * ```
+     */
+    calculateWorkbook(sheets: SheetData[]): CalculatedSheet[];
+    /**
+     * Get current engine options
+     *
+     * @returns Current configuration options
+     */
+    getOptions(): Required<EngineOptions>;
+    /**
+     * Update engine options
+     *
+     * @param options - Options to update
+     *
+     * @example
+     * ```typescript
+     * engine.setOptions({ strictMode: true });
+     * ```
+     */
+    setOptions(options: Partial<EngineOptions>): void;
+    /**
+     * Create a simple sheet from array data
+     *
+     * Helper method to create a SheetData object from simple arrays.
+     * Automatically converts values to SpreadsheetCell format.
+     *
+     * @param name - Sheet name
+     * @param data - Array of arrays (rows and cells)
+     * @returns SheetData object
+     *
+     * @example
+     * ```typescript
+     * const sheet = engine.createSheet('Sales', [
+     *   ['Product', 'Price', 'Qty', 'Total'],
+     *   ['Widget', 10, 100, '=B2*C2'],
+     * ]);
+     * ```
+     */
+    createSheet(name: string, data: Array<Array<SpreadsheetCell | string | number>>): SheetData;
+    /**
+     * Convert calculated sheet data to string array
+     *
+     * Helper method for testing and output formatting.
+     *
+     * @param calculated - Calculated sheet
+     * @returns 2D array of strings
+     *
+     * @example
+     * ```typescript
+     * const result = engine.calculate(sheet);
+     * const stringArray = engine.toStringArray(result);
+     * ```
+     */
+    toStringArray(calculated: CalculatedSheet): string[][];
+}