@milaboratories/pl-errors 1.2.8 → 1.3.0

package/dist/index.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_parsed_error = require("./parsed_error.cjs");
+exports.ModelAPIVersionMismatchError = require_parsed_error.ModelAPIVersionMismatchError;
 exports.PlErrorReport = require_parsed_error.PlErrorReport;
 exports.PlInternalError = require_parsed_error.PlInternalError;
 exports.PlMonetizationError = require_parsed_error.PlMonetizationError;

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { PlCoreError, PlErrorReport, PlInternalError, PlMonetizationError, PlQuickJSError, PlRunnerError, PlTengoError, parsePlError, parseSubErrors } from "./parsed_error.js";
-export { PlCoreError, PlErrorReport, PlInternalError, PlMonetizationError, PlQuickJSError, PlRunnerError, PlTengoError, parsePlError, parseSubErrors };
+import { ModelAPIVersionMismatchError, PlCoreError, PlErrorReport, PlInternalError, PlMonetizationError, PlQuickJSError, PlRunnerError, PlTengoError, parsePlError, parseSubErrors } from "./parsed_error.js";
+export { ModelAPIVersionMismatchError, PlCoreError, PlErrorReport, PlInternalError, PlMonetizationError, PlQuickJSError, PlRunnerError, PlTengoError, parsePlError, parseSubErrors };

package/dist/index.js

@@ -1,2 +1,2 @@
-import { PlErrorReport, PlInternalError, PlMonetizationError, PlQuickJSError, PlRunnerError, PlTengoError, parsePlError, parseSubErrors } from "./parsed_error.js";
-export { PlErrorReport, PlInternalError, PlMonetizationError, PlQuickJSError, PlRunnerError, PlTengoError, parsePlError, parseSubErrors };
+import { ModelAPIVersionMismatchError, PlErrorReport, PlInternalError, PlMonetizationError, PlQuickJSError, PlRunnerError, PlTengoError, parsePlError, parseSubErrors } from "./parsed_error.js";
+export { ModelAPIVersionMismatchError, PlErrorReport, PlInternalError, PlMonetizationError, PlQuickJSError, PlRunnerError, PlTengoError, parsePlError, parseSubErrors };

package/dist/parsed_error.cjs

@@ -3,6 +3,19 @@ let _milaboratories_pl_client = require("@milaboratories/pl-client");
 let _milaboratories_ts_helpers = require("@milaboratories/ts-helpers");
 //#region src/parsed_error.ts
 /** Pl Backend throws arbitrary errors, and we're trying to parse them here. */
+/**
+* Thrown when MCP or middle layer attempts an operation with a model API version
+* that doesn't match the block's actual version (e.g., V2 operation on a V1 block).
+*/
+var ModelAPIVersionMismatchError = class extends Error {
+	constructor(blockId, expected, actual) {
+		super(`Model API version mismatch for block ${blockId}: ${expected} !== ${actual}`);
+		this.blockId = blockId;
+		this.expected = expected;
+		this.actual = actual;
+		this.name = "ModelAPIVersionMismatchError";
+	}
+};
 /** The error that comes from QuickJS. */
 var PlQuickJSError = class extends Error {
 	stack;
@@ -206,6 +219,7 @@ function parseCoreError(message) {
 	return new PlInternalError(message);
 }
 //#endregion
+exports.ModelAPIVersionMismatchError = ModelAPIVersionMismatchError;
 exports.PlErrorReport = PlErrorReport;
 exports.PlInternalError = PlInternalError;
 exports.PlMonetizationError = PlMonetizationError;

package/dist/parsed_error.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"parsed_error.cjs","names":["z"],"sources":["../src/parsed_error.ts"],"sourcesContent":["/** Pl Backend throws arbitrary errors, and we're trying to parse them here. */\n\nimport { z } from \"zod\";\nimport type { ResourceId, ResourceType } from \"@milaboratories/pl-client\";\nimport { resourceIdToString, resourceTypeToString } from \"@milaboratories/pl-client\";\nimport { notEmpty } from \"@milaboratories/ts-helpers\";\n\n/** The error that comes from QuickJS. */\nexport class PlQuickJSError extends Error {\n  public stack: string;\n  public fullMessage: string;\n\n  constructor(quickJSError: Error, cause: Error) {\n    super(`PlQuickJSError: ${cause.message}`, { cause });\n    this.name = \"PlQuickJSError\";\n\n    // QuickJS wraps the error with the name and the message,\n    // but we need another format.\n    let stack = notEmpty(quickJSError.stack);\n    stack = stack.replace(quickJSError.message, \"\");\n    stack = stack.replace(notEmpty(cause.message), \"\");\n\n    this.stack = stack;\n\n    const causeMsg =\n      \"fullMessage\" in cause && typeof cause.fullMessage === \"string\"\n        ? cause.fullMessage\n        : cause.message;\n\n    this.fullMessage = `PlQuickJSError: ${causeMsg}\nQuickJS stacktrace:\n${this.stack}\n`;\n  }\n}\n\n/**\n * A parsed error from the Pl backend.\n * It contains several suberrors, which could be one or different causes of the error.\n */\nexport class PlErrorReport extends Error {\n  public readonly fullMessage: string;\n\n  constructor(\n    /** Full message from the Pl backend. */\n    public readonly rawBackendMessage: string,\n\n    /** Either CID conflict or a error from controller. */\n    public readonly plErrorType: string,\n\n    /** Parsed pl backend message that will be futher parsed into suberrors. */\n    public readonly plMessage: string,\n\n    /** Could be several different errors, the name is from AggregateError. */\n    public readonly errors: PlCoreError[],\n\n    /** Optional info about a resource where the error happened. */\n    public readonly fieldName?: string,\n    public readonly resource?: ResourceId,\n    public readonly resourceType?: ResourceType,\n  ) {\n    const errorMessages = errors.map((e) => e.message).join(\"\\n\\n\");\n    const errorFullMessages = errors.map((e) => e.fullMessage).join(\"\\n\\n\");\n\n    super(`PlErrorReport: ${errorMessages}`);\n    this.name = \"PlErrorReport\";\n\n    const rt = this.resourceType ? `${resourceTypeToString(this.resourceType)},` : \"\";\n    const r = this.resource ? resourceIdToString(this.resource) : \"\";\n    const f = this.fieldName ? `/${this.fieldName}` : \"\";\n    const errType = this.plErrorType ? `error type: ${this.plErrorType}` : \"\";\n\n    this.fullMessage = `PlErrorReport: resource: ${rt} ${r}${f}\n${errType}\n${errorFullMessages}\n`;\n  }\n}\n\n/**\n * A suberror of a parsed error.\n */\nexport type PlCoreError = PlInternalError | PlTengoError | PlRunnerError | PlMonetizationError;\n\n/**\n * An general error when we couldn't parse the cause.\n */\nexport class PlInternalError extends Error {\n  public readonly fullMessage: string;\n  constructor(public readonly message: string) {\n    super(message);\n    this.name = \"PlInternalError\";\n    this.fullMessage = `PlInternalError: ${message}`;\n  }\n}\n\n/**\n * Happens when workflow template panics.\n */\nexport class PlTengoError extends Error {\n  public readonly fullMessage: string;\n\n  constructor(\n    public readonly rawBackendMessage: string,\n    public readonly templateName: string,\n    public readonly tengoMessage: string,\n    public readonly tengoStacktrace: string,\n  ) {\n    const msg = `PlTengoError:\nmessage:\n${tengoMessage}\ntemplate: ${templateName}\ntengo stacktrace:\n${tengoStacktrace}\n`;\n\n    super(msg);\n    this.name = \"PlTengoError\";\n\n    this.fullMessage = `${msg}\nraw message:\n${this.rawBackendMessage}\n`;\n  }\n}\n\n/**\n * Happens when a command fails to run.\n */\nexport class PlRunnerError extends Error {\n  public readonly fullMessage: string;\n\n  constructor(\n    public readonly rawBackendMessage: string,\n    public readonly commandName: string,\n    public readonly exitCode: number,\n    public readonly stdout: string,\n    public readonly workingDirectory: string,\n  ) {\n    const msg = `PlRunnerError:\ncommand: ${commandName}\nexit code: ${exitCode}\nworking directory: ${workingDirectory}\nstdout:\n${stdout}`;\n\n    super(msg);\n    this.name = \"PlRunnerError\";\n    this.fullMessage = `\n${msg}\nraw message:\n${this.rawBackendMessage}\n`;\n  }\n}\n\n/**\n * Happens when a monetization command fails to run.\n */\nexport class PlMonetizationError extends PlRunnerError {\n  public readonly fullMessage: string;\n  constructor(\n    rawBackendMessage: string,\n    commandName: string,\n    exitCode: number,\n    stdout: string,\n    workingDirectory: string,\n  ) {\n    super(rawBackendMessage, commandName, exitCode, stdout, workingDirectory);\n    const msg = `Monetizaiton error:\n${this.stdout}\n`;\n\n    this.message = msg;\n    this.name = \"PlMonetizationError\";\n\n    this.fullMessage = `\n${msg}\ncommand: ${this.commandName}\nexit code: ${this.exitCode}\nworking directory: ${this.workingDirectory}\n\nraw message:\n${this.rawBackendMessage}\n`;\n  }\n}\n\n/**\n * How the Pl backend represents an error.\n */\nconst backendErrorSchema = z\n  .object({\n    errorType: z.string().default(\"\"),\n    message: z.string(),\n  })\n  .passthrough();\n\n/**\n * Parses a Pl error and suberrors from the Pl backend.\n */\nexport function parsePlError(\n  error: string,\n  resource?: ResourceId,\n  resourceType?: ResourceType,\n  field?: string,\n): PlErrorReport {\n  const parsed = backendErrorSchema.safeParse(JSON.parse(error));\n  if (!parsed.success) {\n    throw new Error(`parsePlError: failed to parse the message, got ${error}`);\n  }\n\n  const errors = parseSubErrors(parsed.data.message);\n\n  return new PlErrorReport(\n    error,\n    parsed.data.errorType,\n    parsed.data.message,\n    errors,\n\n    field,\n    resource,\n    resourceType,\n  );\n}\n\n/**\n * Reduces over the lines of the pl error message\n * to extract messages, and categorizes them.\n */\nexport function parseSubErrors(message: string): PlCoreError[] {\n  // the state of this reducing function\n  const state = {\n    stage: \"initial\" as \"initial\" | \"path\" | \"message\",\n    value: [] as string[],\n    result: [] as PlCoreError[],\n  };\n\n  for (const line of message.split(\"\\n\")) {\n    if (state.stage == \"initial\") {\n      // we need initial stage because apparently the first line\n      // of the error doesn't have [I], but is a path line.\n      state.stage = \"path\";\n    } else if (state.stage == \"path\" && line.startsWith(\"---\")) {\n      // we should add stack separator to path stage\n      // without break stage processing\n    } else if (state.stage == \"path\" && !isPath(line)) {\n      state.stage = \"message\";\n    } else if (state.stage == \"message\" && isPath(line)) {\n      state.stage = \"path\";\n      const text = state.value.join(\"\\n\");\n      state.result.push(parseCoreError(text));\n      state.value = [];\n    }\n\n    state.value.push(line);\n  }\n\n  const text = state.value.join(\"\\n\");\n  state.result.push(parseCoreError(text));\n\n  return state.result;\n}\n\nfunction isPath(line: string): boolean {\n  for (const fieldType of [\"U\", \"I\", \"O\", \"S\", \"OTW\", \"D\", \"MTW\"]) {\n    if (line.startsWith(`[${fieldType}]`)) return true;\n  }\n\n  return false;\n}\n\n/**\n * Parses a suberror from the Pl backend.\n */\nfunction parseCoreError(message: string): PlCoreError {\n  // trying to parse a runner or monetization error.\n  // https://regex101.com/r/tmKLj7/1\n  const runnerErrorRegex =\n    /working directory: \"(.*)\"[\\s\\S]failed to run command: \"([^\"]+)\" exited with code (\\d+)\\.[\\s\\S]*?Here is the latest command output:[\\s\\S]*?\\t([\\s\\S]*)/;\n  const match = message.match(runnerErrorRegex);\n  if (match) {\n    const workingDirectory = match[1];\n    const command = match[2];\n    const exitCode = parseInt(match[3], 10);\n    const stdout = match[4].trim();\n\n    if (command.endsWith(`mnz-client`) && exitCode == 1) {\n      return new PlMonetizationError(message, command, exitCode, stdout, workingDirectory);\n    }\n\n    return new PlRunnerError(message, command, exitCode, stdout, workingDirectory);\n  }\n\n  // trying to parse a Tengo error.\n  // https://regex101.com/r/1a7RpO/1\n  const workflowErrorRegex =\n    /cannot eval code: cannot eval template: template: (.+)\\n\\t(.*?)\\n\\t(at [\\s\\S]*)/;\n  const workflowMatch = message.match(workflowErrorRegex);\n  if (workflowMatch) {\n    const templateName = workflowMatch[1];\n    const errorMessage = workflowMatch[2];\n    const stackTrace = workflowMatch[3];\n\n    return new PlTengoError(message, templateName, errorMessage, stackTrace);\n  }\n\n  // if we couldn't parse the error, return a general error.\n  return new PlInternalError(message);\n}\n"],"mappings":"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"}
+{"version":3,"file":"parsed_error.cjs","names":["z"],"sources":["../src/parsed_error.ts"],"sourcesContent":["/**\n * Thrown when MCP or middle layer attempts an operation with a model API version\n * that doesn't match the block's actual version (e.g., V2 operation on a V1 block).\n */\nexport class ModelAPIVersionMismatchError extends Error {\n  constructor(\n    public readonly blockId: string,\n    public readonly expected: number,\n    public readonly actual: number,\n  ) {\n    super(`Model API version mismatch for block ${blockId}: ${expected} !== ${actual}`);\n    this.name = \"ModelAPIVersionMismatchError\";\n  }\n}\n\n/** Pl Backend throws arbitrary errors, and we're trying to parse them here. */\n\nimport { z } from \"zod\";\nimport type { ResourceId, ResourceType } from \"@milaboratories/pl-client\";\nimport { resourceIdToString, resourceTypeToString } from \"@milaboratories/pl-client\";\nimport { notEmpty } from \"@milaboratories/ts-helpers\";\n\n/** The error that comes from QuickJS. */\nexport class PlQuickJSError extends Error {\n  public stack: string;\n  public fullMessage: string;\n\n  constructor(quickJSError: Error, cause: Error) {\n    super(`PlQuickJSError: ${cause.message}`, { cause });\n    this.name = \"PlQuickJSError\";\n\n    // QuickJS wraps the error with the name and the message,\n    // but we need another format.\n    let stack = notEmpty(quickJSError.stack);\n    stack = stack.replace(quickJSError.message, \"\");\n    stack = stack.replace(notEmpty(cause.message), \"\");\n\n    this.stack = stack;\n\n    const causeMsg =\n      \"fullMessage\" in cause && typeof cause.fullMessage === \"string\"\n        ? cause.fullMessage\n        : cause.message;\n\n    this.fullMessage = `PlQuickJSError: ${causeMsg}\nQuickJS stacktrace:\n${this.stack}\n`;\n  }\n}\n\n/**\n * A parsed error from the Pl backend.\n * It contains several suberrors, which could be one or different causes of the error.\n */\nexport class PlErrorReport extends Error {\n  public readonly fullMessage: string;\n\n  constructor(\n    /** Full message from the Pl backend. */\n    public readonly rawBackendMessage: string,\n\n    /** Either CID conflict or a error from controller. */\n    public readonly plErrorType: string,\n\n    /** Parsed pl backend message that will be futher parsed into suberrors. */\n    public readonly plMessage: string,\n\n    /** Could be several different errors, the name is from AggregateError. */\n    public readonly errors: PlCoreError[],\n\n    /** Optional info about a resource where the error happened. */\n    public readonly fieldName?: string,\n    public readonly resource?: ResourceId,\n    public readonly resourceType?: ResourceType,\n  ) {\n    const errorMessages = errors.map((e) => e.message).join(\"\\n\\n\");\n    const errorFullMessages = errors.map((e) => e.fullMessage).join(\"\\n\\n\");\n\n    super(`PlErrorReport: ${errorMessages}`);\n    this.name = \"PlErrorReport\";\n\n    const rt = this.resourceType ? `${resourceTypeToString(this.resourceType)},` : \"\";\n    const r = this.resource ? resourceIdToString(this.resource) : \"\";\n    const f = this.fieldName ? `/${this.fieldName}` : \"\";\n    const errType = this.plErrorType ? `error type: ${this.plErrorType}` : \"\";\n\n    this.fullMessage = `PlErrorReport: resource: ${rt} ${r}${f}\n${errType}\n${errorFullMessages}\n`;\n  }\n}\n\n/**\n * A suberror of a parsed error.\n */\nexport type PlCoreError = PlInternalError | PlTengoError | PlRunnerError | PlMonetizationError;\n\n/**\n * An general error when we couldn't parse the cause.\n */\nexport class PlInternalError extends Error {\n  public readonly fullMessage: string;\n  constructor(public readonly message: string) {\n    super(message);\n    this.name = \"PlInternalError\";\n    this.fullMessage = `PlInternalError: ${message}`;\n  }\n}\n\n/**\n * Happens when workflow template panics.\n */\nexport class PlTengoError extends Error {\n  public readonly fullMessage: string;\n\n  constructor(\n    public readonly rawBackendMessage: string,\n    public readonly templateName: string,\n    public readonly tengoMessage: string,\n    public readonly tengoStacktrace: string,\n  ) {\n    const msg = `PlTengoError:\nmessage:\n${tengoMessage}\ntemplate: ${templateName}\ntengo stacktrace:\n${tengoStacktrace}\n`;\n\n    super(msg);\n    this.name = \"PlTengoError\";\n\n    this.fullMessage = `${msg}\nraw message:\n${this.rawBackendMessage}\n`;\n  }\n}\n\n/**\n * Happens when a command fails to run.\n */\nexport class PlRunnerError extends Error {\n  public readonly fullMessage: string;\n\n  constructor(\n    public readonly rawBackendMessage: string,\n    public readonly commandName: string,\n    public readonly exitCode: number,\n    public readonly stdout: string,\n    public readonly workingDirectory: string,\n  ) {\n    const msg = `PlRunnerError:\ncommand: ${commandName}\nexit code: ${exitCode}\nworking directory: ${workingDirectory}\nstdout:\n${stdout}`;\n\n    super(msg);\n    this.name = \"PlRunnerError\";\n    this.fullMessage = `\n${msg}\nraw message:\n${this.rawBackendMessage}\n`;\n  }\n}\n\n/**\n * Happens when a monetization command fails to run.\n */\nexport class PlMonetizationError extends PlRunnerError {\n  public readonly fullMessage: string;\n  constructor(\n    rawBackendMessage: string,\n    commandName: string,\n    exitCode: number,\n    stdout: string,\n    workingDirectory: string,\n  ) {\n    super(rawBackendMessage, commandName, exitCode, stdout, workingDirectory);\n    const msg = `Monetizaiton error:\n${this.stdout}\n`;\n\n    this.message = msg;\n    this.name = \"PlMonetizationError\";\n\n    this.fullMessage = `\n${msg}\ncommand: ${this.commandName}\nexit code: ${this.exitCode}\nworking directory: ${this.workingDirectory}\n\nraw message:\n${this.rawBackendMessage}\n`;\n  }\n}\n\n/**\n * How the Pl backend represents an error.\n */\nconst backendErrorSchema = z\n  .object({\n    errorType: z.string().default(\"\"),\n    message: z.string(),\n  })\n  .passthrough();\n\n/**\n * Parses a Pl error and suberrors from the Pl backend.\n */\nexport function parsePlError(\n  error: string,\n  resource?: ResourceId,\n  resourceType?: ResourceType,\n  field?: string,\n): PlErrorReport {\n  const parsed = backendErrorSchema.safeParse(JSON.parse(error));\n  if (!parsed.success) {\n    throw new Error(`parsePlError: failed to parse the message, got ${error}`);\n  }\n\n  const errors = parseSubErrors(parsed.data.message);\n\n  return new PlErrorReport(\n    error,\n    parsed.data.errorType,\n    parsed.data.message,\n    errors,\n\n    field,\n    resource,\n    resourceType,\n  );\n}\n\n/**\n * Reduces over the lines of the pl error message\n * to extract messages, and categorizes them.\n */\nexport function parseSubErrors(message: string): PlCoreError[] {\n  // the state of this reducing function\n  const state = {\n    stage: \"initial\" as \"initial\" | \"path\" | \"message\",\n    value: [] as string[],\n    result: [] as PlCoreError[],\n  };\n\n  for (const line of message.split(\"\\n\")) {\n    if (state.stage == \"initial\") {\n      // we need initial stage because apparently the first line\n      // of the error doesn't have [I], but is a path line.\n      state.stage = \"path\";\n    } else if (state.stage == \"path\" && line.startsWith(\"---\")) {\n      // we should add stack separator to path stage\n      // without break stage processing\n    } else if (state.stage == \"path\" && !isPath(line)) {\n      state.stage = \"message\";\n    } else if (state.stage == \"message\" && isPath(line)) {\n      state.stage = \"path\";\n      const text = state.value.join(\"\\n\");\n      state.result.push(parseCoreError(text));\n      state.value = [];\n    }\n\n    state.value.push(line);\n  }\n\n  const text = state.value.join(\"\\n\");\n  state.result.push(parseCoreError(text));\n\n  return state.result;\n}\n\nfunction isPath(line: string): boolean {\n  for (const fieldType of [\"U\", \"I\", \"O\", \"S\", \"OTW\", \"D\", \"MTW\"]) {\n    if (line.startsWith(`[${fieldType}]`)) return true;\n  }\n\n  return false;\n}\n\n/**\n * Parses a suberror from the Pl backend.\n */\nfunction parseCoreError(message: string): PlCoreError {\n  // trying to parse a runner or monetization error.\n  // https://regex101.com/r/tmKLj7/1\n  const runnerErrorRegex =\n    /working directory: \"(.*)\"[\\s\\S]failed to run command: \"([^\"]+)\" exited with code (\\d+)\\.[\\s\\S]*?Here is the latest command output:[\\s\\S]*?\\t([\\s\\S]*)/;\n  const match = message.match(runnerErrorRegex);\n  if (match) {\n    const workingDirectory = match[1];\n    const command = match[2];\n    const exitCode = parseInt(match[3], 10);\n    const stdout = match[4].trim();\n\n    if (command.endsWith(`mnz-client`) && exitCode == 1) {\n      return new PlMonetizationError(message, command, exitCode, stdout, workingDirectory);\n    }\n\n    return new PlRunnerError(message, command, exitCode, stdout, workingDirectory);\n  }\n\n  // trying to parse a Tengo error.\n  // https://regex101.com/r/1a7RpO/1\n  const workflowErrorRegex =\n    /cannot eval code: cannot eval template: template: (.+)\\n\\t(.*?)\\n\\t(at [\\s\\S]*)/;\n  const workflowMatch = message.match(workflowErrorRegex);\n  if (workflowMatch) {\n    const templateName = workflowMatch[1];\n    const errorMessage = workflowMatch[2];\n    const stackTrace = workflowMatch[3];\n\n    return new PlTengoError(message, templateName, errorMessage, stackTrace);\n  }\n\n  // if we couldn't parse the error, return a general error.\n  return new PlInternalError(message);\n}\n"],"mappings":"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"}

package/dist/parsed_error.d.ts

@@ -1,6 +1,16 @@
 import { ResourceId, ResourceType } from "@milaboratories/pl-client";
 
 //#region src/parsed_error.d.ts
+/**
+ * Thrown when MCP or middle layer attempts an operation with a model API version
+ * that doesn't match the block's actual version (e.g., V2 operation on a V1 block).
+ */
+declare class ModelAPIVersionMismatchError extends Error {
+  readonly blockId: string;
+  readonly expected: number;
+  readonly actual: number;
+  constructor(blockId: string, expected: number, actual: number);
+}
 /** The error that comes from QuickJS. */
 declare class PlQuickJSError extends Error {
   stack: string;
@@ -89,5 +99,5 @@ declare function parsePlError(error: string, resource?: ResourceId, resourceType
  */
 declare function parseSubErrors(message: string): PlCoreError[];
 //#endregion
-export { PlCoreError, PlErrorReport, PlInternalError, PlMonetizationError, PlQuickJSError, PlRunnerError, PlTengoError, parsePlError, parseSubErrors };
+export { ModelAPIVersionMismatchError, PlCoreError, PlErrorReport, PlInternalError, PlMonetizationError, PlQuickJSError, PlRunnerError, PlTengoError, parsePlError, parseSubErrors };
 //# sourceMappingURL=parsed_error.d.ts.map

package/dist/parsed_error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parsed_error.d.ts","names":[],"sources":["../src/parsed_error.ts"],"mappings":";;;;cAQa,cAAA,SAAuB,KAAA;EAC3B,KAAA;EACA,WAAA;cAEK,YAAA,EAAc,KAAA,EAAO,KAAA,EAAO,KAAA;AAAA;;;;;cA4B7B,aAAA,SAAsB,KAAA;EA9B1B;EAAA,SAmCW,iBAAA;EAjCQ;EAAA,SAoCR,WAAA;EApCsB;EAAA,SAuCtB,SAAA;EAvC2B;EAAA,SA0C3B,MAAA,EAAQ,WAAA;EAdf;EAAA,SAiBO,SAAA;EAAA,SACA,QAAA,GAAW,UAAA;EAAA,SACX,YAAA,GAAe,YAAA;EAAA,SAlBjB,WAAA;cAaU;;EATR,iBAAA,UAce;;EAXf,WAAA,UARoB;;EAWpB,SAAA,UAXe;;EAcf,MAAA,EAAQ,WAAA,IANR;;EASA,SAAA,uBACA,QAAA,GAAW,UAAA,cACX,YAAA,GAAe,YAAA;AAAA;;;;KAuBvB,WAAA,GAAc,eAAA,GAAkB,YAAA,GAAe,aAAA,GAAgB,mBAAA;;;;cAK9D,eAAA,SAAwB,KAAA;EAAA,SAEP,OAAA;EAAA,SADZ,WAAA;cACY,OAAA;AAAA;;;;cAUjB,YAAA,SAAqB,KAAA;EAAA,SAId,iBAAA;EAAA,SACA,YAAA;EAAA,SACA,YAAA;EAAA,SACA,eAAA;EAAA,SANF,WAAA;cAGE,iBAAA,UACA,YAAA,UACA,YAAA,UACA,eAAA;AAAA;;;;cAuBP,aAAA,SAAsB,KAAA;EAAA,SAIf,iBAAA;EAAA,SACA,WAAA;EAAA,SACA,QAAA;EAAA,SACA,MAAA;EAAA,SACA,gBAAA;EAAA,SAPF,WAAA;cAGE,iBAAA,UACA,WAAA,UACA,QAAA,UACA,MAAA,UACA,gBAAA;AAAA;AAlDpB;;;AAAA,cAwEa,mBAAA,SAA4B,aAAA;EAAA,SACvB,WAAA;cAEd,iBAAA,UACA,WAAA,UACA,QAAA,UACA,MAAA,UACA,gBAAA;AAAA;;;;iBAmCY,YAAA,CACd,KAAA,UACA,QAAA,GAAW,UAAA,EACX,YAAA,GAAe,YAAA,EACf,KAAA,YACC,aAAA;AA3GH;;;;AAAA,iBAmIgB,cAAA,CAAe,OAAA,WAAkB,WAAA"}
+{"version":3,"file":"parsed_error.d.ts","names":[],"sources":["../src/parsed_error.ts"],"mappings":";;;;;;AAIA;cAAa,4BAAA,SAAqC,KAAA;EAAA,SAE9B,OAAA;EAAA,SACA,QAAA;EAAA,SACA,MAAA;cAFA,OAAA,UACA,QAAA,UACA,MAAA;AAAA;;cAeP,cAAA,SAAuB,KAAA;EAC3B,KAAA;EACA,WAAA;cAEK,YAAA,EAAc,KAAA,EAAO,KAAA,EAAO,KAAA;AAAA;AAJ1C;;;;AAAA,cAgCa,aAAA,SAAsB,KAAA;EAhCC;EAAA,SAqChB,iBAAA;EArCqB;EAAA,SAwCrB,WAAA;EAvCX;EAAA,SA0CW,SAAA;;WAGA,MAAA,EAAQ,WAAA;EA1Cd;EAAA,SA6CM,SAAA;EAAA,SACA,QAAA,GAAW,UAAA;EAAA,SACX,YAAA,GAAe,YAAA;EAAA,SAlBjB,WAAA;cADS;;EAKP,iBAAA,UASQ;;EANR,WAAA,UAWe;;EARf,SAAA,UAOW;;EAJX,MAAA,EAAQ,WAAA,IAdO;;EAiBf,SAAA,uBACA,QAAA,GAAW,UAAA,cACX,YAAA,GAAe,YAAA;AAAA;;;;KAuBvB,WAAA,GAAc,eAAA,GAAkB,YAAA,GAAe,aAAA,GAAgB,mBAAA;;;;cAK9D,eAAA,SAAwB,KAAA;EAAA,SAEP,OAAA;EAAA,SADZ,WAAA;cACY,OAAA;AAAA;;;;cAUjB,YAAA,SAAqB,KAAA;EAAA,SAId,iBAAA;EAAA,SACA,YAAA;EAAA,SACA,YAAA;EAAA,SACA,eAAA;EAAA,SANF,WAAA;cAGE,iBAAA,UACA,YAAA,UACA,YAAA,UACA,eAAA;AAAA;;;AAxBpB;cA+Ca,aAAA,SAAsB,KAAA;EAAA,SAIf,iBAAA;EAAA,SACA,WAAA;EAAA,SACA,QAAA;EAAA,SACA,MAAA;EAAA,SACA,gBAAA;EAAA,SAPF,WAAA;cAGE,iBAAA,UACA,WAAA,UACA,QAAA,UACA,MAAA,UACA,gBAAA;AAAA;;;;cAsBP,mBAAA,SAA4B,aAAA;EAAA,SACvB,WAAA;cAEd,iBAAA,UACA,WAAA,UACA,QAAA,UACA,MAAA,UACA,gBAAA;AAAA;;;;iBAmCY,YAAA,CACd,KAAA,UACA,QAAA,GAAW,UAAA,EACX,YAAA,GAAe,YAAA,EACf,KAAA,YACC,aAAA;;;;;iBAwBa,cAAA,CAAe,OAAA,WAAkB,WAAA"}

package/dist/parsed_error.js

@@ -3,6 +3,19 @@ import { resourceIdToString, resourceTypeToString } from "@milaboratories/pl-cli
 import { notEmpty } from "@milaboratories/ts-helpers";
 //#region src/parsed_error.ts
 /** Pl Backend throws arbitrary errors, and we're trying to parse them here. */
+/**
+* Thrown when MCP or middle layer attempts an operation with a model API version
+* that doesn't match the block's actual version (e.g., V2 operation on a V1 block).
+*/
+var ModelAPIVersionMismatchError = class extends Error {
+	constructor(blockId, expected, actual) {
+		super(`Model API version mismatch for block ${blockId}: ${expected} !== ${actual}`);
+		this.blockId = blockId;
+		this.expected = expected;
+		this.actual = actual;
+		this.name = "ModelAPIVersionMismatchError";
+	}
+};
 /** The error that comes from QuickJS. */
 var PlQuickJSError = class extends Error {
 	stack;
@@ -206,6 +219,6 @@ function parseCoreError(message) {
 	return new PlInternalError(message);
 }
 //#endregion
-export { PlErrorReport, PlInternalError, PlMonetizationError, PlQuickJSError, PlRunnerError, PlTengoError, parsePlError, parseSubErrors };
+export { ModelAPIVersionMismatchError, PlErrorReport, PlInternalError, PlMonetizationError, PlQuickJSError, PlRunnerError, PlTengoError, parsePlError, parseSubErrors };
 
 //# sourceMappingURL=parsed_error.js.map

package/dist/parsed_error.js.map

@@ -1 +1 @@
-{"version":3,"file":"parsed_error.js","names":[],"sources":["../src/parsed_error.ts"],"sourcesContent":["/** Pl Backend throws arbitrary errors, and we're trying to parse them here. */\n\nimport { z } from \"zod\";\nimport type { ResourceId, ResourceType } from \"@milaboratories/pl-client\";\nimport { resourceIdToString, resourceTypeToString } from \"@milaboratories/pl-client\";\nimport { notEmpty } from \"@milaboratories/ts-helpers\";\n\n/** The error that comes from QuickJS. */\nexport class PlQuickJSError extends Error {\n  public stack: string;\n  public fullMessage: string;\n\n  constructor(quickJSError: Error, cause: Error) {\n    super(`PlQuickJSError: ${cause.message}`, { cause });\n    this.name = \"PlQuickJSError\";\n\n    // QuickJS wraps the error with the name and the message,\n    // but we need another format.\n    let stack = notEmpty(quickJSError.stack);\n    stack = stack.replace(quickJSError.message, \"\");\n    stack = stack.replace(notEmpty(cause.message), \"\");\n\n    this.stack = stack;\n\n    const causeMsg =\n      \"fullMessage\" in cause && typeof cause.fullMessage === \"string\"\n        ? cause.fullMessage\n        : cause.message;\n\n    this.fullMessage = `PlQuickJSError: ${causeMsg}\nQuickJS stacktrace:\n${this.stack}\n`;\n  }\n}\n\n/**\n * A parsed error from the Pl backend.\n * It contains several suberrors, which could be one or different causes of the error.\n */\nexport class PlErrorReport extends Error {\n  public readonly fullMessage: string;\n\n  constructor(\n    /** Full message from the Pl backend. */\n    public readonly rawBackendMessage: string,\n\n    /** Either CID conflict or a error from controller. */\n    public readonly plErrorType: string,\n\n    /** Parsed pl backend message that will be futher parsed into suberrors. */\n    public readonly plMessage: string,\n\n    /** Could be several different errors, the name is from AggregateError. */\n    public readonly errors: PlCoreError[],\n\n    /** Optional info about a resource where the error happened. */\n    public readonly fieldName?: string,\n    public readonly resource?: ResourceId,\n    public readonly resourceType?: ResourceType,\n  ) {\n    const errorMessages = errors.map((e) => e.message).join(\"\\n\\n\");\n    const errorFullMessages = errors.map((e) => e.fullMessage).join(\"\\n\\n\");\n\n    super(`PlErrorReport: ${errorMessages}`);\n    this.name = \"PlErrorReport\";\n\n    const rt = this.resourceType ? `${resourceTypeToString(this.resourceType)},` : \"\";\n    const r = this.resource ? resourceIdToString(this.resource) : \"\";\n    const f = this.fieldName ? `/${this.fieldName}` : \"\";\n    const errType = this.plErrorType ? `error type: ${this.plErrorType}` : \"\";\n\n    this.fullMessage = `PlErrorReport: resource: ${rt} ${r}${f}\n${errType}\n${errorFullMessages}\n`;\n  }\n}\n\n/**\n * A suberror of a parsed error.\n */\nexport type PlCoreError = PlInternalError | PlTengoError | PlRunnerError | PlMonetizationError;\n\n/**\n * An general error when we couldn't parse the cause.\n */\nexport class PlInternalError extends Error {\n  public readonly fullMessage: string;\n  constructor(public readonly message: string) {\n    super(message);\n    this.name = \"PlInternalError\";\n    this.fullMessage = `PlInternalError: ${message}`;\n  }\n}\n\n/**\n * Happens when workflow template panics.\n */\nexport class PlTengoError extends Error {\n  public readonly fullMessage: string;\n\n  constructor(\n    public readonly rawBackendMessage: string,\n    public readonly templateName: string,\n    public readonly tengoMessage: string,\n    public readonly tengoStacktrace: string,\n  ) {\n    const msg = `PlTengoError:\nmessage:\n${tengoMessage}\ntemplate: ${templateName}\ntengo stacktrace:\n${tengoStacktrace}\n`;\n\n    super(msg);\n    this.name = \"PlTengoError\";\n\n    this.fullMessage = `${msg}\nraw message:\n${this.rawBackendMessage}\n`;\n  }\n}\n\n/**\n * Happens when a command fails to run.\n */\nexport class PlRunnerError extends Error {\n  public readonly fullMessage: string;\n\n  constructor(\n    public readonly rawBackendMessage: string,\n    public readonly commandName: string,\n    public readonly exitCode: number,\n    public readonly stdout: string,\n    public readonly workingDirectory: string,\n  ) {\n    const msg = `PlRunnerError:\ncommand: ${commandName}\nexit code: ${exitCode}\nworking directory: ${workingDirectory}\nstdout:\n${stdout}`;\n\n    super(msg);\n    this.name = \"PlRunnerError\";\n    this.fullMessage = `\n${msg}\nraw message:\n${this.rawBackendMessage}\n`;\n  }\n}\n\n/**\n * Happens when a monetization command fails to run.\n */\nexport class PlMonetizationError extends PlRunnerError {\n  public readonly fullMessage: string;\n  constructor(\n    rawBackendMessage: string,\n    commandName: string,\n    exitCode: number,\n    stdout: string,\n    workingDirectory: string,\n  ) {\n    super(rawBackendMessage, commandName, exitCode, stdout, workingDirectory);\n    const msg = `Monetizaiton error:\n${this.stdout}\n`;\n\n    this.message = msg;\n    this.name = \"PlMonetizationError\";\n\n    this.fullMessage = `\n${msg}\ncommand: ${this.commandName}\nexit code: ${this.exitCode}\nworking directory: ${this.workingDirectory}\n\nraw message:\n${this.rawBackendMessage}\n`;\n  }\n}\n\n/**\n * How the Pl backend represents an error.\n */\nconst backendErrorSchema = z\n  .object({\n    errorType: z.string().default(\"\"),\n    message: z.string(),\n  })\n  .passthrough();\n\n/**\n * Parses a Pl error and suberrors from the Pl backend.\n */\nexport function parsePlError(\n  error: string,\n  resource?: ResourceId,\n  resourceType?: ResourceType,\n  field?: string,\n): PlErrorReport {\n  const parsed = backendErrorSchema.safeParse(JSON.parse(error));\n  if (!parsed.success) {\n    throw new Error(`parsePlError: failed to parse the message, got ${error}`);\n  }\n\n  const errors = parseSubErrors(parsed.data.message);\n\n  return new PlErrorReport(\n    error,\n    parsed.data.errorType,\n    parsed.data.message,\n    errors,\n\n    field,\n    resource,\n    resourceType,\n  );\n}\n\n/**\n * Reduces over the lines of the pl error message\n * to extract messages, and categorizes them.\n */\nexport function parseSubErrors(message: string): PlCoreError[] {\n  // the state of this reducing function\n  const state = {\n    stage: \"initial\" as \"initial\" | \"path\" | \"message\",\n    value: [] as string[],\n    result: [] as PlCoreError[],\n  };\n\n  for (const line of message.split(\"\\n\")) {\n    if (state.stage == \"initial\") {\n      // we need initial stage because apparently the first line\n      // of the error doesn't have [I], but is a path line.\n      state.stage = \"path\";\n    } else if (state.stage == \"path\" && line.startsWith(\"---\")) {\n      // we should add stack separator to path stage\n      // without break stage processing\n    } else if (state.stage == \"path\" && !isPath(line)) {\n      state.stage = \"message\";\n    } else if (state.stage == \"message\" && isPath(line)) {\n      state.stage = \"path\";\n      const text = state.value.join(\"\\n\");\n      state.result.push(parseCoreError(text));\n      state.value = [];\n    }\n\n    state.value.push(line);\n  }\n\n  const text = state.value.join(\"\\n\");\n  state.result.push(parseCoreError(text));\n\n  return state.result;\n}\n\nfunction isPath(line: string): boolean {\n  for (const fieldType of [\"U\", \"I\", \"O\", \"S\", \"OTW\", \"D\", \"MTW\"]) {\n    if (line.startsWith(`[${fieldType}]`)) return true;\n  }\n\n  return false;\n}\n\n/**\n * Parses a suberror from the Pl backend.\n */\nfunction parseCoreError(message: string): PlCoreError {\n  // trying to parse a runner or monetization error.\n  // https://regex101.com/r/tmKLj7/1\n  const runnerErrorRegex =\n    /working directory: \"(.*)\"[\\s\\S]failed to run command: \"([^\"]+)\" exited with code (\\d+)\\.[\\s\\S]*?Here is the latest command output:[\\s\\S]*?\\t([\\s\\S]*)/;\n  const match = message.match(runnerErrorRegex);\n  if (match) {\n    const workingDirectory = match[1];\n    const command = match[2];\n    const exitCode = parseInt(match[3], 10);\n    const stdout = match[4].trim();\n\n    if (command.endsWith(`mnz-client`) && exitCode == 1) {\n      return new PlMonetizationError(message, command, exitCode, stdout, workingDirectory);\n    }\n\n    return new PlRunnerError(message, command, exitCode, stdout, workingDirectory);\n  }\n\n  // trying to parse a Tengo error.\n  // https://regex101.com/r/1a7RpO/1\n  const workflowErrorRegex =\n    /cannot eval code: cannot eval template: template: (.+)\\n\\t(.*?)\\n\\t(at [\\s\\S]*)/;\n  const workflowMatch = message.match(workflowErrorRegex);\n  if (workflowMatch) {\n    const templateName = workflowMatch[1];\n    const errorMessage = workflowMatch[2];\n    const stackTrace = workflowMatch[3];\n\n    return new PlTengoError(message, templateName, errorMessage, stackTrace);\n  }\n\n  // if we couldn't parse the error, return a general error.\n  return new PlInternalError(message);\n}\n"],"mappings":"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"}
+{"version":3,"file":"parsed_error.js","names":[],"sources":["../src/parsed_error.ts"],"sourcesContent":["/**\n * Thrown when MCP or middle layer attempts an operation with a model API version\n * that doesn't match the block's actual version (e.g., V2 operation on a V1 block).\n */\nexport class ModelAPIVersionMismatchError extends Error {\n  constructor(\n    public readonly blockId: string,\n    public readonly expected: number,\n    public readonly actual: number,\n  ) {\n    super(`Model API version mismatch for block ${blockId}: ${expected} !== ${actual}`);\n    this.name = \"ModelAPIVersionMismatchError\";\n  }\n}\n\n/** Pl Backend throws arbitrary errors, and we're trying to parse them here. */\n\nimport { z } from \"zod\";\nimport type { ResourceId, ResourceType } from \"@milaboratories/pl-client\";\nimport { resourceIdToString, resourceTypeToString } from \"@milaboratories/pl-client\";\nimport { notEmpty } from \"@milaboratories/ts-helpers\";\n\n/** The error that comes from QuickJS. */\nexport class PlQuickJSError extends Error {\n  public stack: string;\n  public fullMessage: string;\n\n  constructor(quickJSError: Error, cause: Error) {\n    super(`PlQuickJSError: ${cause.message}`, { cause });\n    this.name = \"PlQuickJSError\";\n\n    // QuickJS wraps the error with the name and the message,\n    // but we need another format.\n    let stack = notEmpty(quickJSError.stack);\n    stack = stack.replace(quickJSError.message, \"\");\n    stack = stack.replace(notEmpty(cause.message), \"\");\n\n    this.stack = stack;\n\n    const causeMsg =\n      \"fullMessage\" in cause && typeof cause.fullMessage === \"string\"\n        ? cause.fullMessage\n        : cause.message;\n\n    this.fullMessage = `PlQuickJSError: ${causeMsg}\nQuickJS stacktrace:\n${this.stack}\n`;\n  }\n}\n\n/**\n * A parsed error from the Pl backend.\n * It contains several suberrors, which could be one or different causes of the error.\n */\nexport class PlErrorReport extends Error {\n  public readonly fullMessage: string;\n\n  constructor(\n    /** Full message from the Pl backend. */\n    public readonly rawBackendMessage: string,\n\n    /** Either CID conflict or a error from controller. */\n    public readonly plErrorType: string,\n\n    /** Parsed pl backend message that will be futher parsed into suberrors. */\n    public readonly plMessage: string,\n\n    /** Could be several different errors, the name is from AggregateError. */\n    public readonly errors: PlCoreError[],\n\n    /** Optional info about a resource where the error happened. */\n    public readonly fieldName?: string,\n    public readonly resource?: ResourceId,\n    public readonly resourceType?: ResourceType,\n  ) {\n    const errorMessages = errors.map((e) => e.message).join(\"\\n\\n\");\n    const errorFullMessages = errors.map((e) => e.fullMessage).join(\"\\n\\n\");\n\n    super(`PlErrorReport: ${errorMessages}`);\n    this.name = \"PlErrorReport\";\n\n    const rt = this.resourceType ? `${resourceTypeToString(this.resourceType)},` : \"\";\n    const r = this.resource ? resourceIdToString(this.resource) : \"\";\n    const f = this.fieldName ? `/${this.fieldName}` : \"\";\n    const errType = this.plErrorType ? `error type: ${this.plErrorType}` : \"\";\n\n    this.fullMessage = `PlErrorReport: resource: ${rt} ${r}${f}\n${errType}\n${errorFullMessages}\n`;\n  }\n}\n\n/**\n * A suberror of a parsed error.\n */\nexport type PlCoreError = PlInternalError | PlTengoError | PlRunnerError | PlMonetizationError;\n\n/**\n * An general error when we couldn't parse the cause.\n */\nexport class PlInternalError extends Error {\n  public readonly fullMessage: string;\n  constructor(public readonly message: string) {\n    super(message);\n    this.name = \"PlInternalError\";\n    this.fullMessage = `PlInternalError: ${message}`;\n  }\n}\n\n/**\n * Happens when workflow template panics.\n */\nexport class PlTengoError extends Error {\n  public readonly fullMessage: string;\n\n  constructor(\n    public readonly rawBackendMessage: string,\n    public readonly templateName: string,\n    public readonly tengoMessage: string,\n    public readonly tengoStacktrace: string,\n  ) {\n    const msg = `PlTengoError:\nmessage:\n${tengoMessage}\ntemplate: ${templateName}\ntengo stacktrace:\n${tengoStacktrace}\n`;\n\n    super(msg);\n    this.name = \"PlTengoError\";\n\n    this.fullMessage = `${msg}\nraw message:\n${this.rawBackendMessage}\n`;\n  }\n}\n\n/**\n * Happens when a command fails to run.\n */\nexport class PlRunnerError extends Error {\n  public readonly fullMessage: string;\n\n  constructor(\n    public readonly rawBackendMessage: string,\n    public readonly commandName: string,\n    public readonly exitCode: number,\n    public readonly stdout: string,\n    public readonly workingDirectory: string,\n  ) {\n    const msg = `PlRunnerError:\ncommand: ${commandName}\nexit code: ${exitCode}\nworking directory: ${workingDirectory}\nstdout:\n${stdout}`;\n\n    super(msg);\n    this.name = \"PlRunnerError\";\n    this.fullMessage = `\n${msg}\nraw message:\n${this.rawBackendMessage}\n`;\n  }\n}\n\n/**\n * Happens when a monetization command fails to run.\n */\nexport class PlMonetizationError extends PlRunnerError {\n  public readonly fullMessage: string;\n  constructor(\n    rawBackendMessage: string,\n    commandName: string,\n    exitCode: number,\n    stdout: string,\n    workingDirectory: string,\n  ) {\n    super(rawBackendMessage, commandName, exitCode, stdout, workingDirectory);\n    const msg = `Monetizaiton error:\n${this.stdout}\n`;\n\n    this.message = msg;\n    this.name = \"PlMonetizationError\";\n\n    this.fullMessage = `\n${msg}\ncommand: ${this.commandName}\nexit code: ${this.exitCode}\nworking directory: ${this.workingDirectory}\n\nraw message:\n${this.rawBackendMessage}\n`;\n  }\n}\n\n/**\n * How the Pl backend represents an error.\n */\nconst backendErrorSchema = z\n  .object({\n    errorType: z.string().default(\"\"),\n    message: z.string(),\n  })\n  .passthrough();\n\n/**\n * Parses a Pl error and suberrors from the Pl backend.\n */\nexport function parsePlError(\n  error: string,\n  resource?: ResourceId,\n  resourceType?: ResourceType,\n  field?: string,\n): PlErrorReport {\n  const parsed = backendErrorSchema.safeParse(JSON.parse(error));\n  if (!parsed.success) {\n    throw new Error(`parsePlError: failed to parse the message, got ${error}`);\n  }\n\n  const errors = parseSubErrors(parsed.data.message);\n\n  return new PlErrorReport(\n    error,\n    parsed.data.errorType,\n    parsed.data.message,\n    errors,\n\n    field,\n    resource,\n    resourceType,\n  );\n}\n\n/**\n * Reduces over the lines of the pl error message\n * to extract messages, and categorizes them.\n */\nexport function parseSubErrors(message: string): PlCoreError[] {\n  // the state of this reducing function\n  const state = {\n    stage: \"initial\" as \"initial\" | \"path\" | \"message\",\n    value: [] as string[],\n    result: [] as PlCoreError[],\n  };\n\n  for (const line of message.split(\"\\n\")) {\n    if (state.stage == \"initial\") {\n      // we need initial stage because apparently the first line\n      // of the error doesn't have [I], but is a path line.\n      state.stage = \"path\";\n    } else if (state.stage == \"path\" && line.startsWith(\"---\")) {\n      // we should add stack separator to path stage\n      // without break stage processing\n    } else if (state.stage == \"path\" && !isPath(line)) {\n      state.stage = \"message\";\n    } else if (state.stage == \"message\" && isPath(line)) {\n      state.stage = \"path\";\n      const text = state.value.join(\"\\n\");\n      state.result.push(parseCoreError(text));\n      state.value = [];\n    }\n\n    state.value.push(line);\n  }\n\n  const text = state.value.join(\"\\n\");\n  state.result.push(parseCoreError(text));\n\n  return state.result;\n}\n\nfunction isPath(line: string): boolean {\n  for (const fieldType of [\"U\", \"I\", \"O\", \"S\", \"OTW\", \"D\", \"MTW\"]) {\n    if (line.startsWith(`[${fieldType}]`)) return true;\n  }\n\n  return false;\n}\n\n/**\n * Parses a suberror from the Pl backend.\n */\nfunction parseCoreError(message: string): PlCoreError {\n  // trying to parse a runner or monetization error.\n  // https://regex101.com/r/tmKLj7/1\n  const runnerErrorRegex =\n    /working directory: \"(.*)\"[\\s\\S]failed to run command: \"([^\"]+)\" exited with code (\\d+)\\.[\\s\\S]*?Here is the latest command output:[\\s\\S]*?\\t([\\s\\S]*)/;\n  const match = message.match(runnerErrorRegex);\n  if (match) {\n    const workingDirectory = match[1];\n    const command = match[2];\n    const exitCode = parseInt(match[3], 10);\n    const stdout = match[4].trim();\n\n    if (command.endsWith(`mnz-client`) && exitCode == 1) {\n      return new PlMonetizationError(message, command, exitCode, stdout, workingDirectory);\n    }\n\n    return new PlRunnerError(message, command, exitCode, stdout, workingDirectory);\n  }\n\n  // trying to parse a Tengo error.\n  // https://regex101.com/r/1a7RpO/1\n  const workflowErrorRegex =\n    /cannot eval code: cannot eval template: template: (.+)\\n\\t(.*?)\\n\\t(at [\\s\\S]*)/;\n  const workflowMatch = message.match(workflowErrorRegex);\n  if (workflowMatch) {\n    const templateName = workflowMatch[1];\n    const errorMessage = workflowMatch[2];\n    const stackTrace = workflowMatch[3];\n\n    return new PlTengoError(message, templateName, errorMessage, stackTrace);\n  }\n\n  // if we couldn't parse the error, return a general error.\n  return new PlInternalError(message);\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milaboratories/pl-errors",
-  "version": "1.2.8",
+  "version": "1.3.0",
   "description": "Parsing errors from Pl backend",
   "files": [
     "./dist/**/*",
@@ -18,17 +18,17 @@
   },
   "dependencies": {
     "zod": "~3.25.76",
-    "@milaboratories/pl-client": "3.1.1",
-    "@milaboratories/ts-helpers": "1.8.1"
+    "@milaboratories/ts-helpers": "1.8.1",
+    "@milaboratories/pl-client": "3.1.1"
   },
   "devDependencies": {
     "@vitest/coverage-istanbul": "^4.1.3",
     "typescript": "~5.9.3",
     "vitest": "^4.1.3",
     "@milaboratories/build-configs": "2.0.0",
-    "@milaboratories/ts-builder": "1.3.1",
-    "@milaboratories/ts-configs": "1.2.3",
-    "@milaboratories/pl-error-like": "1.12.9"
+    "@milaboratories/pl-error-like": "1.12.9",
+    "@milaboratories/ts-builder": "1.3.2",
+    "@milaboratories/ts-configs": "1.2.3"
   },
   "scripts": {
     "build": "ts-builder build --target node",

package/src/parsed_error.test.ts

@@ -4,6 +4,7 @@ import {
   stringifyWithResourceId,
 } from "@milaboratories/pl-client";
 import {
+  ModelAPIVersionMismatchError,
   parsePlError,
   parseSubErrors,
   PlMonetizationError,
@@ -162,6 +163,18 @@ at @platforma-sdk/workflow-tengo:ll:25:1
   });
 });
 
+describe("ModelAPIVersionMismatchError", () => {
+  it("should format message with block id and versions", () => {
+    const err = new ModelAPIVersionMismatchError("block-123", 2, 1);
+    expect(err.message).toBe("Model API version mismatch for block block-123: 2 !== 1");
+    expect(err.name).toBe("ModelAPIVersionMismatchError");
+    expect(err.blockId).toBe("block-123");
+    expect(err.expected).toBe(2);
+    expect(err.actual).toBe(1);
+    expect(err).toBeInstanceOf(Error);
+  });
+});
+
 test("pl error report has error like shape", () => {
   const plErrorReport = new PlErrorReport("test error report", "", "", []);
 

package/src/parsed_error.ts

@@ -1,3 +1,18 @@
+/**
+ * Thrown when MCP or middle layer attempts an operation with a model API version
+ * that doesn't match the block's actual version (e.g., V2 operation on a V1 block).
+ */
+export class ModelAPIVersionMismatchError extends Error {
+  constructor(
+    public readonly blockId: string,
+    public readonly expected: number,
+    public readonly actual: number,
+  ) {
+    super(`Model API version mismatch for block ${blockId}: ${expected} !== ${actual}`);
+    this.name = "ModelAPIVersionMismatchError";
+  }
+}
+
 /** Pl Backend throws arbitrary errors, and we're trying to parse them here. */
 
 import { z } from "zod";