@albertomarturelo/sii-mcp 0.11.0 → 0.12.0

package/CHANGELOG.md

@@ -9,6 +9,20 @@ Versions move in **lockstep** with `@albertomarturelo/sii-core` and
 (ADR-003), so the domain detail behind each entry lives in the
 [core changelog](../core/CHANGELOG.md).
 
+## 0.12.0 — 2026-10-18
+
+### Changed
+
+- **A failed tool call's text is a JSON object (#134):** `{ "error", "type", "reason"?,
+  "codigo"? }`, still with `isError: true`. Before, it was the bare message. It is the CLI's
+  JSON error without `exitCode`, with the same stable `type`. The verbatim SII message is still
+  in `error`. A client that parsed the bare text must read `error` instead.
+
+### Fixed
+
+- **A session SII has closed is reported as expired (#139):** `whoami` and `auth_status` with
+  `refresh` answer `session_expired`. Before, they failed with "DatosCntrNow ausente".
+
 ## 0.11.0 — 2026-10-18
 
 ### Changed

package/dist/tool-helpers.d.ts

@@ -1,5 +1,9 @@
+/** A failed tool call's text: the CLI's JSON error without `exitCode` (a tool has none), so
+ *  both surfaces report the same stable `type` next to SII's verbatim message (ADR-012
+ *  amendment). */
+export declare function errorText(e: unknown): string;
 /** Run a task and wrap its text as a tool result; domain errors come back as an
- *  error result carrying SII's Spanish message verbatim (CONVENTIONS). */
+ *  error result carrying SII's Spanish message verbatim (CONVENTIONS) and its kind. */
 export declare function toolText(fn: () => Promise<string>): Promise<{
     content: {
         type: 'text';

package/dist/tool-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-helpers.d.ts","sourceRoot":"","sources":["../src/tool-helpers.ts"],"names":[],"mappings":"AAMA;0EAC0E;AAC1E,wBAAsB,QAAQ,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;IACjE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAMD"}
+{"version":3,"file":"tool-helpers.d.ts","sourceRoot":"","sources":["../src/tool-helpers.ts"],"names":[],"mappings":"AAOA;;kBAEkB;AAClB,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAG5C;AAED;uFACuF;AACvF,wBAAsB,QAAQ,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;IACjE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAMD"}

package/dist/tool-helpers.js

@@ -1,15 +1,23 @@
 // Shared MCP tool helpers. Each domain module owns a `tools/<mod>.ts` exporting a
 // `register<Mod>Tools(server, runtime)`; they all reuse `toolText` so SII's Spanish
 // error messages surface verbatim and the registration stays uniform across modules.
+import { classifyError } from '@albertomarturelo/sii-core';
 const messageOf = (e) => (e instanceof Error ? e.message : String(e));
+/** A failed tool call's text: the CLI's JSON error without `exitCode` (a tool has none), so
+ *  both surfaces report the same stable `type` next to SII's verbatim message (ADR-012
+ *  amendment). */
+export function errorText(e) {
+    const { type, ...detail } = classifyError(e);
+    return JSON.stringify({ error: messageOf(e), type, ...detail });
+}
 /** Run a task and wrap its text as a tool result; domain errors come back as an
- *  error result carrying SII's Spanish message verbatim (CONVENTIONS). */
+ *  error result carrying SII's Spanish message verbatim (CONVENTIONS) and its kind. */
 export async function toolText(fn) {
     try {
         return { content: [{ type: 'text', text: await fn() }] };
     }
     catch (e) {
-        return { content: [{ type: 'text', text: messageOf(e) }], isError: true };
+        return { content: [{ type: 'text', text: errorText(e) }], isError: true };
     }
 }
 //# sourceMappingURL=tool-helpers.js.map

package/dist/tool-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-helpers.js","sourceRoot":"","sources":["../src/tool-helpers.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,oFAAoF;AACpF,qFAAqF;AAErF,MAAM,SAAS,GAAG,CAAC,CAAU,EAAU,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAEvF;0EAC0E;AAC1E,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,EAAyB;IAItD,IAAI,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IAC3D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC5E,CAAC;AACH,CAAC"}
+{"version":3,"file":"tool-helpers.js","sourceRoot":"","sources":["../src/tool-helpers.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,oFAAoF;AACpF,qFAAqF;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,MAAM,SAAS,GAAG,CAAC,CAAU,EAAU,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAEvF;;kBAEkB;AAClB,MAAM,UAAU,SAAS,CAAC,CAAU;IAClC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AAClE,CAAC;AAED;uFACuF;AACvF,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,EAAyB;IAItD,IAAI,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IAC3D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC5E,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@albertomarturelo/sii-mcp",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "type": "module",
   "description": "MCP (stdio) server for Chile's SII (tax authority): exposes authenticated reads — RCV, F29, F22, boletas de honorarios, DTE-authorized, peticiones administrativas — plus factura borradores on the Portal MIPYME (never emission) and document downloads, as tools/resources for Claude Desktop and Claude Code. Each tool is a thin call into @albertomarturelo/sii-core tasks (ADR-003).",
   "keywords": [
@@ -45,7 +45,7 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "playwright": "^1.49.0",
     "zod": "^4.4.3",
-    "@albertomarturelo/sii-core": "^0.11.0"
+    "@albertomarturelo/sii-core": "^0.12.0"
   },
   "scripts": {
     "build": "tsc -b"