@rex0220/formula-authoring-tools 0.2.0 → 0.3.0

package/dist/types/commands/calc.d.ts

@@ -35,6 +35,8 @@ export interface CalcInput {
     usersOrigin: UsersOrigin | {
         kind: "none";
     };
+    /** APP_URL を使う式でも、接続先が無ければ既定の接続先（例の URL）で評価する（try。サンプルアプリに実在の接続は無い）。既定は名指しで止める */
+    allowDefaultBaseUrl?: boolean;
 }
 export interface CalcLine {
     fieldcode: string;

package/dist/types/commands/save.d.ts

@@ -25,6 +25,8 @@ export interface SaveResult {
     message?: string;
     /** status が ok でないときの誤りの種類（ConflictError、PermissionError、PathError、InputError、NormalizeError、接続の誤りの code など。想定外の失敗は Error） */
     code?: string;
+    /** code が PluginZipError のときの、zip の誤りの種類（MCP が種類ごとの決まった文にする） */
+    zipCode?: string;
     /** ok だが、確定の後に一時ファイルかロックを消せなかった（確定はしている。利用者に伝えて消してもらう） */
     cleanup?: string[];
 }
@@ -58,6 +60,8 @@ export interface SaveContext {
 export declare const MAX_SAVE_INPUT_BYTES: number;
 /** updateFields の rows の行数の上限 */
 export declare const MAX_UPDATE_ROWS = 50;
+/** updateFields の common で置き換えられる共通の設定のキー（封筒と pluginInfos 以外の最上位のキー。設定ファイル仕様の順。Codex のレビュー MAJOR 4） */
+export declare const COMMON_KEYS: readonly string[];
 /** ファイルの digest（sha256。fml_summary が返し、fml_update_fields が照合する） */
 export declare function digestOf(text: string | Buffer): string;
 /** 接続の誤りの状態（print-craft MCP の 15.10 の表） */

package/dist/types/commands/try-data.d.ts

@@ -0,0 +1,54 @@
+import type { FieldProperty, FieldsFile } from "./fields.ts";
+import type { KintoneRecord } from "./record.ts";
+import type { UsersInfoTable } from "../users/index.ts";
+export interface TryFieldDef {
+    code: string;
+    /** 型（NUMBER / TEXT / DATE … の別名も可）。SUBTABLE は fields に子 */
+    type: string;
+    label?: string;
+    /** 選択肢（DROP_DOWN / RADIO_BUTTON / CHECK_BOX / MULTI_SELECT で必須。ほかの型には付けない） */
+    options?: string[];
+    /** 既存のテーブル（標本のテーブル1 / テーブル2 か、この一覧で先に足したテーブル）の子として足すときのテーブルのコード */
+    table?: string;
+    /** SUBTABLE の子（1 つ以上。子に table / fields は書けない） */
+    fields?: TryFieldDef[];
+}
+/** 架空の値のレコード（簡略形。項目コード → 値。テーブルは行（子のコード → 値）の配列） */
+export type TryData = Record<string, unknown>;
+export declare const TRY_MAX_EXTRA_FIELDS = 20;
+export declare const TRY_MAX_DATA = 5;
+export declare const TRY_MAX_TABLE_ROWS = 20;
+export declare const TRY_MAX_OPTIONS = 50;
+/** 文字列の値の上限（文字） */
+export declare const TRY_MAX_VALUE_CHARS = 2000;
+/** 型の別名（大文字小文字は区別しない）。GROUP はグループ枠なので別名にしない */
+export declare const TYPE_ALIASES: Record<string, string>;
+/** 足せる型（テーブルの子にできるのは SUBTABLE 以外） */
+export declare const EXTRA_TYPES: readonly string[];
+export declare function canonicalType(type: string): string;
+/** 既存のコード（テーブルの外と子。kintone ではアプリの中で一意） */
+export declare function allCodesOf(fields: FieldsFile): Set<string>;
+/**
+ * 項目を足す（写しを返す）。戻りの added は「単価（NUMBER）」「分類（DROP_DOWN: 明細 / 小計）」「明細（SUBTABLE: 商品, 数量）」の形
+ */
+export declare function extendFields(fields: FieldsFile, defs: readonly TryFieldDef[]): {
+    fields: FieldsFile;
+    added: string[];
+};
+/**
+ * 項目定義の既定値を補う（写しを返す）: 配列の型（チェック、複数選択、ユーザー・組織・グループ）の defaultValue が配列でなければ []、ほかの入力の型は ""。
+ * 設定画面の検証用レコード（authoring API の createCheckRecord）は defaultValue から作るので、手で書いた・古い fields.json に無いと検証が壊れる（e.value.join is not a function）
+ */
+export declare function normalizeDefaults(fields: FieldsFile): FieldsFile;
+/** 項目の型ごとの空の値 */
+export declare function emptyValueOf(type: string): unknown;
+/** 空のレコードを合成する（$id / $revision、全項目を空に。作成日時などは固定） */
+export declare function emptyRecordOf(fields: FieldsFile, id: string): KintoneRecord;
+/** 土台のレコードに無い項目（足した項目）を空で補う */
+export declare function fillMissing(fields: FieldsFile, record: KintoneRecord): KintoneRecord;
+/** 簡略形の値を kintone の形に（テーブル以外） */
+export declare function convertValue(prop: FieldProperty, v: unknown, where: string, users: UsersInfoTable | null): unknown;
+/** 簡略形のレコードを土台に当てる（写しを返す。where は data[1] など） */
+export declare function applyData(fields: FieldsFile, base: KintoneRecord, data: TryData, where: string, users: UsersInfoTable | null): KintoneRecord;
+/** data の一覧の形の検査（件数、JSON の大きさ） */
+export declare function checkDataList(data: unknown): TryData[];

package/dist/types/commands/try.d.ts

@@ -0,0 +1,115 @@
+/**
+ * try（式の試し計算。計画 25 章。工程 8）: 式ごとに同梱のサンプルアプリ（sample-app.ts。全項目タイプ × 2、テーブル 2 つ、レコード 3 件）へ 1 行だけの設定を組み、
+ * normalize（検査）→ calc（模擬）でサンプルレコードの値を返す。利用者のアプリ・レコード・接続は使わない（関数の解説や使用例の確認、式の断片の確かめに）。
+ *   - 対象（as）は型（NUMBER / TEXT / DATE … TARGET_TYPES の型と、その別名）か項目コード。テーブルの中なら table（テーブルのコード）。既定は TEXT（文字列 1 行。どの値も文字列で見える）
+ *   - 式は 1 回 TRY_MAX_FORMULAS まで。式ごとに独立（1 つの誤りがほかを止めない）。値（value）は対象の型に入れた後の値（kintone に保存される形。calc と同じ変換）。
+ *     エンジンの生の値（raw。数値は数、日付は epoch 秒、配列は配列）が value と違うときは raw も返す（型の変換を見せる。別に 1 回評価する）
+ *   - 対象は式が参照していない項目を選ぶ（数値1 を使う式なら 数値2）。自己参照になるときのために、1 行の設定は各種設定の circular_refer を ON にして組む（設定画面の検査だけの決まり）
+ *   - 文脈は calc と同じ（イベント、ログインユーザー、mobile、ユーザー情報のテストデータ、policy の allowFunctions）。APP_URL はサンプルアプリの接続先（既定の例の URL）で評価する
+ *   - 走査の上の制限（副作用のある関数は policy の承認、EV_SET は不可）も calc と同じ。結果を採らない sink も同じ
+ *   - 架空の項目と値（try-data.ts。計画 25.3）: fields で標本に項目を足す（案 2）、data で簡略形の値のレコードを作る（案 1。土台は標本の base = 3 の空のレコード）、
+ *     appFields で利用者のアプリの項目定義に架空の値（案 3。標本のレコードは使わない。data が要る）
+ */
+import type { CalcEvent, Engine } from "../engine.ts";
+import type { FieldsFile } from "./fields.ts";
+import type { Finding } from "../normalize/findings.ts";
+import type { Lang } from "../normalize/model.ts";
+import type { Policy } from "../normalize/policy.ts";
+import type { UsersInfoTable, UsersOrigin } from "../users/index.ts";
+import { type TryData, type TryFieldDef } from "./try-data.ts";
+export declare const TRY_MAX_FORMULAS = 10;
+export declare const TRY_MAX_FORMULA_CHARS = 4000;
+/** 既定の対象（文字列 1 行。数値も日付も配列も文字列で見える） */
+export declare const TRY_DEFAULT_AS = "TEXT";
+export interface TryFormula {
+    formula: string;
+    /** 対象の型（NUMBER / TEXT / DATE …）か項目コード。省略は TEXT */
+    as?: string;
+    /** テーブルの中で計算するときのテーブルのコード（テーブル1 / テーブル2） */
+    table?: string;
+}
+export interface TryTarget {
+    code: string;
+    type: string;
+    table?: string;
+}
+export interface TryValue {
+    /** レコード（標本は "1"〜"3"、架空の値は "d1"〜） */
+    record: string;
+    /** 対象の型に入れた後の値（kintone に保存される形）。テーブルの中なら行ごとの値の配列 */
+    value: unknown;
+    /** エンジンの生の値（value と違うときだけ。数値は数、日付は epoch 秒、配列は配列。テーブルの中なら行ごと） */
+    raw?: unknown;
+    /** 式の評価の失敗（段: 文） */
+    error?: string;
+    /** 実行時の sink が呼ばれた（結果を採らない） */
+    failed?: boolean;
+}
+export interface TryFormulaResult {
+    /** 1 から */
+    index: number;
+    formula: string;
+    target?: TryTarget;
+    /** ok = 計算した、invalid = 検査のエラーか対象・文脈の誤り（findings に error）、failed = sink が呼ばれた */
+    status: "ok" | "invalid" | "failed";
+    /** その式の normalize の結果（エラー / 警告 / 情報）と、対象・文脈の誤り（try.target / calc.context） */
+    findings: Finding[];
+    values: TryValue[];
+    /** calc の印（ユーザー情報、イベント、再計算で変わる、kintone の文脈、副作用） */
+    marks: string[];
+}
+export interface TryInput {
+    engine: Engine;
+    formulas: TryFormula[];
+    /** 標本のレコードの番号（1〜3。省略は全部。data があるときの省略は無し） */
+    records?: number[];
+    /** 標本に足す項目（案 2） */
+    fields?: TryFieldDef[];
+    /** 架空の値のレコード（案 1。簡略形。標本の base の空のレコードを土台に埋める） */
+    data?: TryData[];
+    /** data の土台にする標本のレコード（1〜3。既定 3 = 空） */
+    base?: number;
+    /** 利用者のアプリの項目定義（案 3。fields.json）。標本の代わりに使う（data が要る。records は使えない） */
+    appFields?: FieldsFile;
+    evType?: string;
+    event?: CalcEvent;
+    mobile?: boolean;
+    user?: string;
+    usersInfo: UsersInfoTable | null;
+    usersOrigin: UsersOrigin | {
+        kind: "none";
+    };
+    usersLabel?: string;
+    policy?: Policy;
+    lang?: Lang;
+}
+export interface TryResult {
+    app: {
+        appId: number;
+        appName: string;
+        fieldCount: number;
+        /** sample = 同梱の標本、app = 利用者のアプリの項目定義（appFields） */
+        source: "sample" | "app";
+        /** 使ったレコード（標本 "1"〜"3"、架空の値 "d1"〜） */
+        records: string[];
+        /** 足した項目（「単価（NUMBER）」の形） */
+        extraFields: string[];
+    };
+    contextLine: string;
+    notice: string;
+    results: TryFormulaResult[];
+    /** 1 行の要約（ok / エラーの件数） */
+    summary: string;
+    text: string;
+}
+/**
+ * 対象の項目を決める（型か項目コード、テーブルの中かどうか）。型のときは、式が参照していない項目を優先し、短いコードの順で最初（文字列1、数値1 …。数値1 を使う式なら 数値2）。
+ * referenced は式の識別子（scanFormula）
+ */
+export declare function resolveTryTarget(fields: FieldsFile, targetTypes: ReadonlySet<string>, as: string | undefined, table: string | undefined, referenced?: ReadonlySet<string>): TryTarget;
+/**
+ * 1 行だけの設定（封筒 + 既定の共通の設定 + 対象の行）。計算式ツールは有効（tool.disabled の警告を出さない）、各種設定の circular_refer は ON
+ * （自己参照の式を設定画面の検査で止めない。実行には関係ない）。各種設定の差（misc.changed）は try が自分で付けたものなので結果から除く
+ */
+export declare function buildTryEnvelope(engine: Engine, fields: FieldsFile, code: string, formula: string, lang: Lang): Record<string, unknown>;
+export declare function trySettings(input: TryInput): Promise<TryResult>;

package/dist/types/core.d.ts

@@ -3,6 +3,7 @@
  * 工程 0（2026-10-17）: 読み込み（engine）、ダミー層（context）、ユーザー情報のテストデータ、zip の読み込み、安全なパス、接続。
  * tools 0.2.0（計画 24.4。CORE_API_VERSION 2）: 作業フォルダーとアプリのフォルダー（workspace）、接続のファイル（connections）、kintone/ の下の許可（permission）、
  * ファイルの確定とロック（commit-file）、take、保存の約束（save: saveNewSettings / updateFields）、users の参照するコードの取得、JSON の誤りの文、行のキー
+ * tools 0.3.0（計画 25 章。CORE_API_VERSION は 2 のまま = 足しただけ）: 同梱のサンプルアプリ（sample-app）と式の試し計算（try: trySettings。評価の仕事の kind "try"）
  */
 export declare const CORE_API_VERSION = 2;
 export { createContext, type WorkContext } from "./context.ts";
@@ -27,13 +28,16 @@ export { DEFAULT_MAX_CALLS, USER_INFO_FUNCTIONS, UsersPullError, pullReferencedU
 export { normalizeSettings, findCycles, stronglyConnected, type ContextNeeds, type NormalizeInput, type NormalizeResult } from "./commands/normalize.ts";
 export { DEFAULT_EVENT, EVENT_RE, RECORDS_MAX, calcSettings, validateEvent, type CalcInput, type CalcLine, type CalcRecordResult, type CalcResult } from "./commands/calc.ts";
 export { takeInbox, type TakeResult } from "./commands/take.ts";
-export { MAX_SAVE_INPUT_BYTES, MAX_UPDATE_ROWS, connectionStatusOf, digestOf, saveNewSettings, updateFields, type EvalSource, type SaveContext, type SaveResult, type SaveStatus } from "./commands/save.ts";
+export { SAMPLE_APP, describeSampleApp, sampleApp, type SampleApp, type SampleRecord } from "./sample-app.ts";
+export { TRY_DEFAULT_AS, TRY_MAX_FORMULAS, TRY_MAX_FORMULA_CHARS, buildTryEnvelope, resolveTryTarget, trySettings, type TryFormula, type TryFormulaResult, type TryInput, type TryResult, type TryTarget, type TryValue } from "./commands/try.ts";
+export { EXTRA_TYPES, TRY_MAX_DATA, TRY_MAX_EXTRA_FIELDS, TRY_MAX_OPTIONS, TRY_MAX_TABLE_ROWS, TRY_MAX_VALUE_CHARS, TYPE_ALIASES, applyData, canonicalType, checkDataList, convertValue, emptyRecordOf, extendFields, normalizeDefaults, type TryData, type TryFieldDef } from "./commands/try-data.ts";
+export { COMMON_KEYS, MAX_SAVE_INPUT_BYTES, MAX_UPDATE_ROWS, connectionStatusOf, digestOf, saveNewSettings, updateFields, type EvalSource, type SaveContext, type SaveResult, type SaveStatus } from "./commands/save.ts";
 export { DEFAULT_POLICY, POLICY_FILE, PolicyError, loadPolicy, parsePolicy, type Policy } from "./normalize/policy.ts";
 export { Findings, type Finding, type Level } from "./normalize/findings.ts";
 export { ENVELOPE_KEYS, OUTER_KEYS, ROW_SCREEN_KEYS, ROW_SOURCE_KEYS, materialsOf, viewsOf, type FormulaSaved, type FormulaSource, type Lang } from "./normalize/model.ts";
 export { DEFAULT_TIMEOUT_SEC, EvalError, EvalTimeoutError, MAX_TIMEOUT_SEC, runEval, type RunOptions } from "./worker/run.ts";
-export { runEvalJob } from "./worker/eval-run.ts";
-export type { EvalJob, EvalMessage, EvalOutcome } from "./worker/eval-job.ts";
+export { builtinErrorName, classifyEvalError, runEvalJob } from "./worker/eval-run.ts";
+export type { EvalErrorKind, EvalJob, EvalMessage, EvalOutcome } from "./worker/eval-job.ts";
 export { APP_MARKER, EDIT_RE, INBOX, KINTONE_ROOT, LEGACY_WORKSPACE_FILE, SNAPSHOT_PREFIX, SNAPSHOT_RE, WorkspaceError, appDirFor, appFolderOfFile, appFoldersOf, assertAppMark, assertInsideWorkspace, assertUsableInKintone, editNameOf, ensureAppFolder, findAppDir, folderNameOf, hasLegacyConfig, legacyBlockedError, listAppFolder, markOf, modeOf, profileDirOf, readAppMark, requireProfiles, snapshotNameOf, unusedProfileDirs, type AppFolderList, type AppMark, type AppMarkState, type ModeOptions, type ProfilesContext, type WorkspaceMode } from "./workspace.ts";
 export { CONNECTION_MAX_BYTES, ConnectionError, FALLBACK_PROFILE, PROFILE_NAME_RE, assertSameConnection, authFor, identityOf, loadConnections, pickProfile, sameIdentity, semanticDigest, snapshotOf, userApiAuthFor, type ConnectionErrorCode, type ConnectionSet, type ConnectionSnapshot, type Env, type LoadConnectionsOptions, type ProfileDef, type ProfileIdentity } from "./connections.ts";
 export { PermissionError, assertChangeAllowed, classOfAppPath, type ChangeOp, type TargetClass } from "./permission.ts";

package/dist/types/sample-app.d.ts

@@ -0,0 +1,19 @@
+import { type FieldsFile } from "./commands/fields.ts";
+import type { KintoneRecord } from "./commands/record.ts";
+export interface SampleRecord {
+    /** レコード番号（1〜3。try の records で選ぶ） */
+    id: number;
+    /** 何のレコードか（典型 / 端 / 空） */
+    label: string;
+    record: KintoneRecord;
+}
+export interface SampleApp {
+    fields: FieldsFile;
+    records: SampleRecord[];
+}
+/** 埋め込んだサンプルアプリ（読むだけ。計算に使うときは sampleApp() の写しを使う） */
+export declare const SAMPLE_APP: SampleApp;
+/** サンプルアプリの写し（calc はレコードを書き換えるので、呼ぶたびに写す） */
+export declare function sampleApp(): SampleApp;
+/** サンプルアプリの説明（try --describe / fml_try の describe）: 項目（1 項目 1 行。○ = 計算式を設定できる型）とレコード 3 件の形 */
+export declare function describeSampleApp(targetTypes?: ReadonlySet<string>): string;

package/dist/types/worker/eval-job.d.ts

@@ -2,6 +2,7 @@
  * Worker に渡す仕事と返す結果（構造化クローンで渡せる形だけ。関数やクラスは渡さない）。
  * normalize / calc の評価（zip のコードの実行）は Worker の中で行い、主スレッドは時間上限で terminate する（計画 7 章・11 章、Codex レビュー BLOCKER 1）。
  * tools 0.2.0（MCP。計画 24 章）: 結果に findings と calc のレコードごとの行を足した（MCP が構造のまま返す。CLI は summary / text を使う）。vendorDir（moment の置き場所）
+ * tools 0.3.0（計画 25 章）: kind "try"（同梱のサンプルアプリで式の試し計算。設定ファイル・項目定義は要らない）。結果の try
  */
 import type { FieldsFile } from "../commands/fields.ts";
 import type { KintoneRecord } from "../commands/record.ts";
@@ -10,8 +11,10 @@ import type { Finding } from "../normalize/findings.ts";
 import type { Policy } from "../normalize/policy.ts";
 import type { UsersOrigin, UsersSource } from "../users/index.ts";
 import type { CalcEvent } from "../engine.ts";
+import type { TryFormula, TryResult } from "../commands/try.ts";
+import type { TryData, TryFieldDef } from "../commands/try-data.ts";
 export interface EvalJob {
-    kind: "normalize" | "calc";
+    kind: "normalize" | "calc" | "try";
     /** 読み込み元（絶対パス。CLI が .env から決める） */
     pluginZip?: string;
     devPluginDir?: string;
@@ -20,9 +23,10 @@ export interface EvalJob {
     vendorDir?: string;
     /** 接続先（検証済み。APP_URL などの元。無ければ既定） */
     baseUrl?: string;
-    settingsText: string;
-    settingsFile: string;
-    fields: FieldsFile;
+    /** 設定と項目定義（normalize / calc。try では要らない） */
+    settingsText?: string;
+    settingsFile?: string;
+    fields?: FieldsFile;
     usersSource: UsersSource;
     usersOrigin: UsersOrigin;
     policy: Policy;
@@ -41,8 +45,24 @@ export interface EvalJob {
         mobile?: boolean;
         user?: string;
     };
+    /** 式の試し計算（kind "try"。サンプルアプリに 1 行だけの設定を組んで normalize + calc） */
+    try?: {
+        formulas: TryFormula[];
+        /** 標本のレコードの番号（1〜3。省略は全部。data があるときの省略は無し） */
+        records?: number[];
+        /** 標本に足す項目（案 2）、架空の値のレコード（案 1）、その土台（1〜3）、利用者のアプリの項目定義（案 3） */
+        fields?: TryFieldDef[];
+        data?: TryData[];
+        base?: number;
+        appFields?: FieldsFile;
+        evType?: string;
+        event?: CalcEvent;
+        mobile?: boolean;
+        user?: string;
+    };
 }
 export interface EvalOutcome {
+    /** normalize の結果（try では式ごとの結果の集計: summary は試し計算の要約、hasErrors は ok でない式があるか、findings は空（式ごとの findings は try.results）） */
     normalize: {
         summary: string;
         hasErrors: boolean;
@@ -68,15 +88,23 @@ export interface EvalOutcome {
         notice: string;
         summary: string;
     };
+    /** 式の試し計算の結果（kind "try"） */
+    try?: TryResult;
     /** エンジンの読み込みの注意 */
     engineWarnings: string[];
 }
+/**
+ * Worker の中の誤りの種類（信頼できる境界 = 中核の eval-run.ts が instanceof で決める。zip のコードが name を偽装しても変わらない。Codex の r2 レビュー R1）:
+ * input（中核の InputError）、zip（PluginZipError。code 付き）、users（UsersDataError）、policy（PolicyError）、other（zip のコードの例外など。文は信用しない）
+ */
+export type EvalErrorKind = "input" | "zip" | "users" | "policy" | "other";
 export type EvalMessage = {
     ok: true;
     outcome: EvalOutcome;
 } | {
     ok: false;
     error: {
+        kind: EvalErrorKind;
         name: string;
         message: string;
         code?: string;

package/dist/types/worker/eval-run.d.ts

@@ -1,2 +1,12 @@
-import type { EvalJob, EvalOutcome } from "./eval-job.ts";
+import type { EvalJob, EvalMessage, EvalOutcome } from "./eval-job.ts";
+/**
+ * Worker の中の誤りを種類に分ける（instanceof で。中核のクラスは zip のコードから届かないので、name の偽装では input / zip にならない）。
+ * name も instanceof で決めた固定の名前（中核のクラスの名前か、JavaScript の組み込みの Error の名前。例外の name / constructor.name は使わない =
+ * zip のコードが name に値やパスを入れても出ない。Codex の r3 レビュー N1）。文は other のときは信用しない（呼ぶ側が決まった文にする）
+ */
+export declare function classifyEvalError(e: unknown): Extract<EvalMessage, {
+    ok: false;
+}>["error"];
+/** JavaScript の組み込みの Error の種類（instanceof。同じ realm で動く zip のコードの例外も、この判定は偽装できない）。それ以外は Error */
+export declare function builtinErrorName(e: unknown): string;
 export declare function runEvalJob(job: EvalJob): Promise<EvalOutcome>;

package/dist/types/worker/run.d.ts

@@ -1,13 +1,17 @@
-import type { EvalJob, EvalOutcome } from "./eval-job.ts";
+import type { EvalErrorKind, EvalJob, EvalOutcome } from "./eval-job.ts";
 export declare const DEFAULT_TIMEOUT_SEC = 60;
 export declare const MAX_TIMEOUT_SEC = 600;
 export declare class EvalTimeoutError extends Error {
 }
-/** Worker の中の誤り（name / code を持って主スレッドに戻す） */
+/**
+ * Worker の中の誤り（kind / name / code を持って主スレッドに戻す）。kind は中核が instanceof で決めた信頼できる種類（input / zip / users / policy / other）。
+ * innerName は参考の名前（other のときは zip のコードが付けた名前かもしれない）。other のときの文は値やパスを含みうる（MCP は返さない）
+ */
 export declare class EvalError extends Error {
     readonly innerName: string;
     readonly code?: string;
-    constructor(message: string, innerName: string, code?: string);
+    readonly kind: EvalErrorKind;
+    constructor(message: string, innerName: string, code?: string, kind?: EvalErrorKind);
 }
 export interface RunOptions {
     timeoutSec?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rex0220/formula-authoring-tools",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "rex0220 計算式プラグイン（kintone）の設定を AI で作るための CLI。利用者のプラグインの zip から authoring API と計算式エンジンを読んで Node で動く",
   "license": "MIT",
   "type": "module",