@evalops/maestro 0.10.51 → 0.10.53

package/dist/tools/typebox-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"typebox-tool.js","sourceRoot":"","sources":["../../src/tools/typebox-tool.ts"],"names":[],"mappings":"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","sourcesContent":["import { performance } from \"node:perf_hooks\";\nimport type { Static, TSchema } from \"@sinclair/typebox\";\nimport type { ErrorObject } from \"ajv\";\nimport type {\n\tAgentTool,\n\tAgentToolResult,\n\tToolAnnotations,\n} from \"../agent/types.js\";\nimport { getSkillArtifactMetadataFromDetails } from \"../skills/artifact-metadata.js\";\nimport { logToolFailure, recordToolExecution } from \"../telemetry.js\";\nimport { compileTypeboxSchema } from \"../utils/typebox-ajv.js\";\n\ntype ExecuteResult<Details> =\n\t| AgentToolResult<Details>\n\t| Promise<AgentToolResult<Details>>;\n\ninterface CreateTypeboxToolOptions<Schema extends TSchema, Details> {\n\tname: string;\n\tlabel: string;\n\tdescription: string;\n\tschema: Schema;\n\tannotations?: ToolAnnotations;\n\ttoolType?: string;\n\tinputExamples?: unknown[];\n\tallowedCallers?: string[];\n\tdeferApiDefinition?: boolean;\n\tmaxRetries?: number;\n\tretryDelayMs?: number;\n\tshouldRetry?: (error: unknown) => boolean;\n\texecute: (\n\t\ttoolCallId: string,\n\t\tparams: Static<Schema>,\n\t\tsignal?: AbortSignal,\n\t) => ExecuteResult<Details>;\n}\n\nexport function createTypeboxTool<Schema extends TSchema, Details = undefined>(\n\toptions: CreateTypeboxToolOptions<Schema, Details>,\n): AgentTool<Schema, Details> {\n\t// In TypeBox 0.34.x+, Type.Strict() is no longer needed - internal symbols\n\t// are non-enumerable and automatically excluded from JSON serialization\n\tconst schema = options.schema;\n\tconst parameters = schema;\n\tconst validate = compileTypeboxSchema(schema);\n\tconst maxRetries = options.maxRetries ?? 1;\n\tconst retryDelayMs = options.retryDelayMs ?? 500;\n\tconst shouldRetry =\n\t\toptions.shouldRetry ?? ((error: unknown) => isTransientToolError(error));\n\n\treturn {\n\t\tname: options.name,\n\t\tlabel: options.label,\n\t\tdescription: options.description,\n\t\tparameters,\n\t\tannotations: options.annotations,\n\t\ttoolType: options.toolType,\n\t\tinputExamples: options.inputExamples,\n\t\tallowedCallers: options.allowedCallers,\n\t\tdeferApiDefinition: options.deferApiDefinition,\n\t\tmaxRetries,\n\t\tretryDelayMs,\n\t\tshouldRetry,\n\t\texecute: async (toolCallId, params: Record<string, unknown>, signal) => {\n\t\t\tlet parsedParams: Static<Schema>;\n\t\t\tconst input =\n\t\t\t\tparams && typeof params === \"object\"\n\t\t\t\t\t? JSON.parse(JSON.stringify(params))\n\t\t\t\t\t: {};\n\t\t\tif (!validate(input)) {\n\t\t\t\tconst message =\n\t\t\t\t\tvalidate.errors\n\t\t\t\t\t\t?.map((err: ErrorObject) => {\n\t\t\t\t\t\t\treturn `${err.instancePath || \"/\"} ${err.message}`;\n\t\t\t\t\t\t})\n\t\t\t\t\t\t.join(\"; \") ?? \"Invalid arguments\";\n\t\t\t\tthrow new Error(`Invalid arguments for ${options.name}: ${message}`);\n\t\t\t}\n\t\t\tparsedParams = input as Static<Schema>;\n\n\t\t\tconst maxAttempts = Math.max(1, maxRetries + 1);\n\n\t\t\tlet attempt = 0;\n\t\t\tlet lastError: unknown;\n\n\t\t\twhile (attempt < maxAttempts) {\n\t\t\t\tattempt++;\n\t\t\t\tconst start = performance.now();\n\t\t\t\ttry {\n\t\t\t\t\tconst result = await options.execute(\n\t\t\t\t\t\ttoolCallId,\n\t\t\t\t\t\tparsedParams,\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t);\n\t\t\t\t\tconst skillMetadata = getSkillArtifactMetadataFromDetails(\n\t\t\t\t\t\tresult.details,\n\t\t\t\t\t);\n\t\t\t\t\trecordToolExecution(options.name, true, performance.now() - start, {\n\t\t\t\t\t\ttoolCallId,\n\t\t\t\t\t\tattempt,\n\t\t\t\t\t\tmaxAttempts,\n\t\t\t\t\t\t...(skillMetadata ? { skillMetadata } : {}),\n\t\t\t\t\t});\n\t\t\t\t\treturn result;\n\t\t\t\t} catch (error: unknown) {\n\t\t\t\t\tlastError = error;\n\t\t\t\t\tconst errorMessage =\n\t\t\t\t\t\terror instanceof Error ? error.message : String(error ?? \"unknown\");\n\t\t\t\t\tconst isAbort = error instanceof Error && error.name === \"AbortError\";\n\t\t\t\t\tconst isFinalAttempt = attempt === maxAttempts;\n\n\t\t\t\t\tif (isAbort || !shouldRetry(error) || isFinalAttempt) {\n\t\t\t\t\t\trecordToolExecution(\n\t\t\t\t\t\t\toptions.name,\n\t\t\t\t\t\t\tfalse,\n\t\t\t\t\t\t\tperformance.now() - start,\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\ttoolCallId,\n\t\t\t\t\t\t\t\terror: errorMessage,\n\t\t\t\t\t\t\t\tattempt,\n\t\t\t\t\t\t\t\tmaxAttempts,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t);\n\t\t\t\t\t\tlogToolFailure(options.name, errorMessage, {\n\t\t\t\t\t\t\ttoolCallId,\n\t\t\t\t\t\t\tattempt,\n\t\t\t\t\t\t\tmaxAttempts,\n\t\t\t\t\t\t});\n\t\t\t\t\t\tthrow error;\n\t\t\t\t\t}\n\n\t\t\t\t\tlogToolFailure(options.name, errorMessage, {\n\t\t\t\t\t\ttoolCallId,\n\t\t\t\t\t\tattempt,\n\t\t\t\t\t\tmaxAttempts,\n\t\t\t\t\t});\n\n\t\t\t\t\tawait new Promise((resolve) => setTimeout(resolve, retryDelayMs));\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tthrow lastError ?? new Error(\"Unknown tool execution failure\");\n\t\t},\n\t};\n}\nfunction isTransientToolError(error: unknown): boolean {\n\tif (!error) return true;\n\tif (error instanceof Error) {\n\t\tif (error.name === \"AbortError\") {\n\t\t\treturn false;\n\t\t}\n\t\tconst message = error.message.toLowerCase();\n\t\tif (\n\t\t\tmessage.includes(\"invalid\") ||\n\t\t\tmessage.includes(\"syntax\") ||\n\t\t\tmessage.includes(\"not found\") ||\n\t\t\tmessage.includes(\"unknown command\")\n\t\t) {\n\t\t\treturn false;\n\t\t}\n\t}\n\treturn true;\n}\n"]}
+{"version":3,"file":"typebox-tool.js","sourceRoot":"","sources":["../../src/tools/typebox-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,OAAO,EAAE,mCAAmC,EAAE,MAAM,qCAAqC,CAAC;AAM1F,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AA0B/D,MAAM,UAAU,iBAAiB,CAChC,OAAkD;IAElD,2EAA2E;IAC3E,wEAAwE;IACxE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,MAAM,UAAU,GAAG,MAAM,CAAC;IAC1B,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,GAAG,CAAC;IACjD,MAAM,WAAW,GAChB,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;IAE1E,OAAO;QACN,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU;QACV,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,UAAU;QACV,YAAY;QACZ,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAA+B,EAAE,MAAM,EAAE,EAAE;YACtE,IAAI,YAA4B,CAAC;YACjC,MAAM,KAAK,GACV,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;gBACnC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBACpC,CAAC,CAAC,EAAE,CAAC;YACP,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,OAAO,GACZ,QAAQ,CAAC,MAAM;oBACd,EAAE,GAAG,CAAC,CAAC,GAAgB,EAAE,EAAE;oBAC1B,OAAO,GAAG,GAAG,CAAC,YAAY,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBACpD,CAAC,CAAC;qBACD,IAAI,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC;gBACrC,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;YACtE,CAAC;YACD,YAAY,GAAG,KAAuB,CAAC;YAEvC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC;YAEhD,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,IAAI,SAAkB,CAAC;YAEvB,OAAO,OAAO,GAAG,WAAW,EAAE,CAAC;gBAC9B,OAAO,EAAE,CAAC;gBACV,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;gBAChC,IAAI,CAAC;oBACJ,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CACnC,UAAU,EACV,YAAY,EACZ,MAAM,CACN,CAAC;oBACF,MAAM,aAAa,GAAG,mCAAmC,CACxD,MAAM,CAAC,OAAO,CACd,CAAC;oBACF,mBAAmB,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE;wBAClE,UAAU;wBACV,OAAO;wBACP,WAAW;wBACX,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAC3C,CAAC,CAAC;oBACH,OAAO,MAAM,CAAC;gBACf,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACzB,SAAS,GAAG,KAAK,CAAC;oBAClB,MAAM,YAAY,GACjB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC;oBACrE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;oBACtE,MAAM,cAAc,GAAG,OAAO,KAAK,WAAW,CAAC;oBAE/C,IAAI,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,cAAc,EAAE,CAAC;wBACtD,mBAAmB,CAClB,OAAO,CAAC,IAAI,EACZ,KAAK,EACL,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,EACzB;4BACC,UAAU;4BACV,KAAK,EAAE,YAAY;4BACnB,OAAO;4BACP,WAAW;yBACX,CACD,CAAC;wBACF,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE;4BAC1C,UAAU;4BACV,OAAO;4BACP,WAAW;yBACX,CAAC,CAAC;wBACH,MAAM,KAAK,CAAC;oBACb,CAAC;oBAED,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE;wBAC1C,UAAU;wBACV,OAAO;wBACP,WAAW;qBACX,CAAC,CAAC;oBAEH,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;gBACnE,CAAC;YACF,CAAC;YAED,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAChE,CAAC;KACD,CAAC;AACH,CAAC;AACD,SAAS,oBAAoB,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACd,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAC5C,IACC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC7B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAClC,CAAC;YACF,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC","sourcesContent":["import { performance } from \"node:perf_hooks\";\nimport type { Static, TSchema } from \"@sinclair/typebox\";\nimport type { ErrorObject } from \"ajv\";\nimport { getSkillArtifactMetadataFromDetails } from \"../agent/skill-artifact-metadata.js\";\nimport type {\n\tAgentTool,\n\tAgentToolResult,\n\tToolAnnotations,\n} from \"../agent/types.js\";\nimport { logToolFailure, recordToolExecution } from \"../telemetry.js\";\nimport { compileTypeboxSchema } from \"../utils/typebox-ajv.js\";\n\ntype ExecuteResult<Details> =\n\t| AgentToolResult<Details>\n\t| Promise<AgentToolResult<Details>>;\n\ninterface CreateTypeboxToolOptions<Schema extends TSchema, Details> {\n\tname: string;\n\tlabel: string;\n\tdescription: string;\n\tschema: Schema;\n\tannotations?: ToolAnnotations;\n\ttoolType?: string;\n\tinputExamples?: unknown[];\n\tallowedCallers?: string[];\n\tdeferApiDefinition?: boolean;\n\tmaxRetries?: number;\n\tretryDelayMs?: number;\n\tshouldRetry?: (error: unknown) => boolean;\n\texecute: (\n\t\ttoolCallId: string,\n\t\tparams: Static<Schema>,\n\t\tsignal?: AbortSignal,\n\t) => ExecuteResult<Details>;\n}\n\nexport function createTypeboxTool<Schema extends TSchema, Details = undefined>(\n\toptions: CreateTypeboxToolOptions<Schema, Details>,\n): AgentTool<Schema, Details> {\n\t// In TypeBox 0.34.x+, Type.Strict() is no longer needed - internal symbols\n\t// are non-enumerable and automatically excluded from JSON serialization\n\tconst schema = options.schema;\n\tconst parameters = schema;\n\tconst validate = compileTypeboxSchema(schema);\n\tconst maxRetries = options.maxRetries ?? 1;\n\tconst retryDelayMs = options.retryDelayMs ?? 500;\n\tconst shouldRetry =\n\t\toptions.shouldRetry ?? ((error: unknown) => isTransientToolError(error));\n\n\treturn {\n\t\tname: options.name,\n\t\tlabel: options.label,\n\t\tdescription: options.description,\n\t\tparameters,\n\t\tannotations: options.annotations,\n\t\ttoolType: options.toolType,\n\t\tinputExamples: options.inputExamples,\n\t\tallowedCallers: options.allowedCallers,\n\t\tdeferApiDefinition: options.deferApiDefinition,\n\t\tmaxRetries,\n\t\tretryDelayMs,\n\t\tshouldRetry,\n\t\texecute: async (toolCallId, params: Record<string, unknown>, signal) => {\n\t\t\tlet parsedParams: Static<Schema>;\n\t\t\tconst input =\n\t\t\t\tparams && typeof params === \"object\"\n\t\t\t\t\t? JSON.parse(JSON.stringify(params))\n\t\t\t\t\t: {};\n\t\t\tif (!validate(input)) {\n\t\t\t\tconst message =\n\t\t\t\t\tvalidate.errors\n\t\t\t\t\t\t?.map((err: ErrorObject) => {\n\t\t\t\t\t\t\treturn `${err.instancePath || \"/\"} ${err.message}`;\n\t\t\t\t\t\t})\n\t\t\t\t\t\t.join(\"; \") ?? \"Invalid arguments\";\n\t\t\t\tthrow new Error(`Invalid arguments for ${options.name}: ${message}`);\n\t\t\t}\n\t\t\tparsedParams = input as Static<Schema>;\n\n\t\t\tconst maxAttempts = Math.max(1, maxRetries + 1);\n\n\t\t\tlet attempt = 0;\n\t\t\tlet lastError: unknown;\n\n\t\t\twhile (attempt < maxAttempts) {\n\t\t\t\tattempt++;\n\t\t\t\tconst start = performance.now();\n\t\t\t\ttry {\n\t\t\t\t\tconst result = await options.execute(\n\t\t\t\t\t\ttoolCallId,\n\t\t\t\t\t\tparsedParams,\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t);\n\t\t\t\t\tconst skillMetadata = getSkillArtifactMetadataFromDetails(\n\t\t\t\t\t\tresult.details,\n\t\t\t\t\t);\n\t\t\t\t\trecordToolExecution(options.name, true, performance.now() - start, {\n\t\t\t\t\t\ttoolCallId,\n\t\t\t\t\t\tattempt,\n\t\t\t\t\t\tmaxAttempts,\n\t\t\t\t\t\t...(skillMetadata ? { skillMetadata } : {}),\n\t\t\t\t\t});\n\t\t\t\t\treturn result;\n\t\t\t\t} catch (error: unknown) {\n\t\t\t\t\tlastError = error;\n\t\t\t\t\tconst errorMessage =\n\t\t\t\t\t\terror instanceof Error ? error.message : String(error ?? \"unknown\");\n\t\t\t\t\tconst isAbort = error instanceof Error && error.name === \"AbortError\";\n\t\t\t\t\tconst isFinalAttempt = attempt === maxAttempts;\n\n\t\t\t\t\tif (isAbort || !shouldRetry(error) || isFinalAttempt) {\n\t\t\t\t\t\trecordToolExecution(\n\t\t\t\t\t\t\toptions.name,\n\t\t\t\t\t\t\tfalse,\n\t\t\t\t\t\t\tperformance.now() - start,\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\ttoolCallId,\n\t\t\t\t\t\t\t\terror: errorMessage,\n\t\t\t\t\t\t\t\tattempt,\n\t\t\t\t\t\t\t\tmaxAttempts,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t);\n\t\t\t\t\t\tlogToolFailure(options.name, errorMessage, {\n\t\t\t\t\t\t\ttoolCallId,\n\t\t\t\t\t\t\tattempt,\n\t\t\t\t\t\t\tmaxAttempts,\n\t\t\t\t\t\t});\n\t\t\t\t\t\tthrow error;\n\t\t\t\t\t}\n\n\t\t\t\t\tlogToolFailure(options.name, errorMessage, {\n\t\t\t\t\t\ttoolCallId,\n\t\t\t\t\t\tattempt,\n\t\t\t\t\t\tmaxAttempts,\n\t\t\t\t\t});\n\n\t\t\t\t\tawait new Promise((resolve) => setTimeout(resolve, retryDelayMs));\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tthrow lastError ?? new Error(\"Unknown tool execution failure\");\n\t\t},\n\t};\n}\nfunction isTransientToolError(error: unknown): boolean {\n\tif (!error) return true;\n\tif (error instanceof Error) {\n\t\tif (error.name === \"AbortError\") {\n\t\t\treturn false;\n\t\t}\n\t\tconst message = error.message.toLowerCase();\n\t\tif (\n\t\t\tmessage.includes(\"invalid\") ||\n\t\t\tmessage.includes(\"syntax\") ||\n\t\t\tmessage.includes(\"not found\") ||\n\t\t\tmessage.includes(\"unknown command\")\n\t\t) {\n\t\t\treturn false;\n\t\t}\n\t}\n\treturn true;\n}\n"]}

package/dist/utils/terminal-image.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Terminal inline-image support detection and escape-sequence emission.
+ *
+ * Capable terminals (iTerm2, WezTerm, kitty, and sixel-aware terminals) can
+ * render image bytes sent via control sequences. This module detects support
+ * from the environment and encodes a PNG buffer for the matching protocol.
+ *
+ * Sixel is detected but not encoded here: sixel requires rasterizing the
+ * source image, which needs a real image library. iTerm2 (OSC 1337) and kitty
+ * (graphics protocol) both accept the raw image bytes base64-encoded, so they
+ * are fully implemented.
+ *
+ * IMPORTANT: these sequences must be written to a display-only stream (or a
+ * TUI render path that strips them before persistence). Tool-result content
+ * channels feed the model context as base64, so do NOT route inline escapes
+ * through tool text/image content — that wastes tokens and confuses the model.
+ *
+ * @module utils/terminal-image
+ */
+export type TerminalImageSupport = "iterm" | "kitty" | "sixel" | "none";
+export interface DetectEnv {
+    TERM_PROGRAM?: string;
+    TERM?: string;
+    COLORTERM?: string;
+}
+/**
+ * Detect the best inline-image protocol the current terminal claims to support.
+ * Conservative: only returns a protocol when the environment explicitly
+ * advertises it.
+ */
+export declare function detectTerminalImageSupport(env?: DetectEnv): TerminalImageSupport;
+export interface InlineImageOptions {
+    /** Display width: pixels, "auto", or N cells (e.g. "40"). Default "auto". */
+    width?: string | number;
+    /** Display height: pixels, "auto", or N cells. Default "auto". */
+    height?: string | number;
+    /** Optional filename hint for iTerm2. */
+    name?: string;
+}
+/** Encode a PNG for iTerm2's OSC 1337 inline-image protocol. */
+export declare function encodeItermInline(buf: Buffer, opts?: InlineImageOptions): string;
+/**
+ * Encode a PNG for kitty's graphics protocol, splitting the base64 payload
+ * into <=4096-byte chunks with `m=1` continuation markers.
+ */
+export declare function encodeKittyInline(buf: Buffer): string;
+/**
+ * Encode an image for the detected protocol. Returns "" when the protocol is
+ * unsupported (including sixel, which is detected but not rasterized here).
+ */
+export declare function encodeInlineImage(buf: Buffer, support?: TerminalImageSupport, opts?: InlineImageOptions): string;
+//# sourceMappingURL=terminal-image.d.ts.map

package/dist/utils/terminal-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-image.d.ts","sourceRoot":"","sources":["../../src/utils/terminal-image.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAExE,MAAM,WAAW,SAAS;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACzC,GAAG,GAAE,SAAuB,GAC1B,oBAAoB,CAgBtB;AAED,MAAM,WAAW,kBAAkB;IAClC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAQD,gEAAgE;AAChE,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,kBAAuB,GAC3B,MAAM,CAaR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBrD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,oBAAmD,EAC5D,IAAI,GAAE,kBAAuB,GAC3B,MAAM,CASR"}

package/dist/utils/terminal-image.js

@@ -0,0 +1,95 @@
+/**
+ * Terminal inline-image support detection and escape-sequence emission.
+ *
+ * Capable terminals (iTerm2, WezTerm, kitty, and sixel-aware terminals) can
+ * render image bytes sent via control sequences. This module detects support
+ * from the environment and encodes a PNG buffer for the matching protocol.
+ *
+ * Sixel is detected but not encoded here: sixel requires rasterizing the
+ * source image, which needs a real image library. iTerm2 (OSC 1337) and kitty
+ * (graphics protocol) both accept the raw image bytes base64-encoded, so they
+ * are fully implemented.
+ *
+ * IMPORTANT: these sequences must be written to a display-only stream (or a
+ * TUI render path that strips them before persistence). Tool-result content
+ * channels feed the model context as base64, so do NOT route inline escapes
+ * through tool text/image content — that wastes tokens and confuses the model.
+ *
+ * @module utils/terminal-image
+ */
+/**
+ * Detect the best inline-image protocol the current terminal claims to support.
+ * Conservative: only returns a protocol when the environment explicitly
+ * advertises it.
+ */
+export function detectTerminalImageSupport(env = process.env) {
+    const termProgram = env.TERM_PROGRAM ?? "";
+    const term = env.TERM ?? "";
+    if (termProgram === "iTerm.app" || termProgram === "WezTerm") {
+        return "iterm";
+    }
+    if (term === "xterm-kitty" || termProgram === "kitty") {
+        return "kitty";
+    }
+    // Sixel: some terminals set COLORTERM or accept DECSCUSR queries; we only
+    // treat an explicit TERM containing "sixel" as a positive signal.
+    if (term.toLowerCase().includes("sixel")) {
+        return "sixel";
+    }
+    return "none";
+}
+const KITTY_CHUNK_SIZE = 4096;
+function b64(buf) {
+    return buf.toString("base64");
+}
+/** Encode a PNG for iTerm2's OSC 1337 inline-image protocol. */
+export function encodeItermInline(buf, opts = {}) {
+    const width = opts.width ?? "auto";
+    const height = opts.height ?? "auto";
+    const args = [
+        "inline=1",
+        `width=${width}`,
+        `height=${height}`,
+        "preserveAspectRatio=0",
+    ];
+    if (opts.name) {
+        args.push(`name=${b64(Buffer.from(opts.name, "utf8"))}`);
+    }
+    return `\x1b]1337;File=${args.join(";")}:${b64(buf)}\x07`;
+}
+/**
+ * Encode a PNG for kitty's graphics protocol, splitting the base64 payload
+ * into <=4096-byte chunks with `m=1` continuation markers.
+ */
+export function encodeKittyInline(buf) {
+    const payload = b64(buf);
+    const chunks = [];
+    for (let i = 0; i < payload.length; i += KITTY_CHUNK_SIZE) {
+        chunks.push(payload.slice(i, i + KITTY_CHUNK_SIZE));
+    }
+    if (chunks.length === 0) {
+        // Empty image: still emit a single transmit chunk.
+        return "\x1b_Ga=T,f=100,t=f;\x1b\\";
+    }
+    const out = [];
+    out.push(`\x1b_Ga=T,f=100,t=f;${chunks[0]}\x1b\\`);
+    for (let i = 1; i < chunks.length; i++) {
+        out.push(`\x1b_Gm=1;${chunks[i]}\x1b\\`);
+    }
+    return out.join("");
+}
+/**
+ * Encode an image for the detected protocol. Returns "" when the protocol is
+ * unsupported (including sixel, which is detected but not rasterized here).
+ */
+export function encodeInlineImage(buf, support = detectTerminalImageSupport(), opts = {}) {
+    switch (support) {
+        case "iterm":
+            return encodeItermInline(buf, opts);
+        case "kitty":
+            return encodeKittyInline(buf);
+        default:
+            return "";
+    }
+}
+//# sourceMappingURL=terminal-image.js.map

package/dist/utils/terminal-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-image.js","sourceRoot":"","sources":["../../src/utils/terminal-image.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Terminal inline-image support detection and escape-sequence emission.\n *\n * Capable terminals (iTerm2, WezTerm, kitty, and sixel-aware terminals) can\n * render image bytes sent via control sequences. This module detects support\n * from the environment and encodes a PNG buffer for the matching protocol.\n *\n * Sixel is detected but not encoded here: sixel requires rasterizing the\n * source image, which needs a real image library. iTerm2 (OSC 1337) and kitty\n * (graphics protocol) both accept the raw image bytes base64-encoded, so they\n * are fully implemented.\n *\n * IMPORTANT: these sequences must be written to a display-only stream (or a\n * TUI render path that strips them before persistence). Tool-result content\n * channels feed the model context as base64, so do NOT route inline escapes\n * through tool text/image content — that wastes tokens and confuses the model.\n *\n * @module utils/terminal-image\n */\n\nexport type TerminalImageSupport = \"iterm\" | \"kitty\" | \"sixel\" | \"none\";\n\nexport interface DetectEnv {\n\tTERM_PROGRAM?: string;\n\tTERM?: string;\n\tCOLORTERM?: string;\n}\n\n/**\n * Detect the best inline-image protocol the current terminal claims to support.\n * Conservative: only returns a protocol when the environment explicitly\n * advertises it.\n */\nexport function detectTerminalImageSupport(\n\tenv: DetectEnv = process.env,\n): TerminalImageSupport {\n\tconst termProgram = env.TERM_PROGRAM ?? \"\";\n\tconst term = env.TERM ?? \"\";\n\n\tif (termProgram === \"iTerm.app\" || termProgram === \"WezTerm\") {\n\t\treturn \"iterm\";\n\t}\n\tif (term === \"xterm-kitty\" || termProgram === \"kitty\") {\n\t\treturn \"kitty\";\n\t}\n\t// Sixel: some terminals set COLORTERM or accept DECSCUSR queries; we only\n\t// treat an explicit TERM containing \"sixel\" as a positive signal.\n\tif (term.toLowerCase().includes(\"sixel\")) {\n\t\treturn \"sixel\";\n\t}\n\treturn \"none\";\n}\n\nexport interface InlineImageOptions {\n\t/** Display width: pixels, \"auto\", or N cells (e.g. \"40\"). Default \"auto\". */\n\twidth?: string | number;\n\t/** Display height: pixels, \"auto\", or N cells. Default \"auto\". */\n\theight?: string | number;\n\t/** Optional filename hint for iTerm2. */\n\tname?: string;\n}\n\nconst KITTY_CHUNK_SIZE = 4096;\n\nfunction b64(buf: Buffer): string {\n\treturn buf.toString(\"base64\");\n}\n\n/** Encode a PNG for iTerm2's OSC 1337 inline-image protocol. */\nexport function encodeItermInline(\n\tbuf: Buffer,\n\topts: InlineImageOptions = {},\n): string {\n\tconst width = opts.width ?? \"auto\";\n\tconst height = opts.height ?? \"auto\";\n\tconst args = [\n\t\t\"inline=1\",\n\t\t`width=${width}`,\n\t\t`height=${height}`,\n\t\t\"preserveAspectRatio=0\",\n\t];\n\tif (opts.name) {\n\t\targs.push(`name=${b64(Buffer.from(opts.name, \"utf8\"))}`);\n\t}\n\treturn `\\x1b]1337;File=${args.join(\";\")}:${b64(buf)}\\x07`;\n}\n\n/**\n * Encode a PNG for kitty's graphics protocol, splitting the base64 payload\n * into <=4096-byte chunks with `m=1` continuation markers.\n */\nexport function encodeKittyInline(buf: Buffer): string {\n\tconst payload = b64(buf);\n\tconst chunks: string[] = [];\n\tfor (let i = 0; i < payload.length; i += KITTY_CHUNK_SIZE) {\n\t\tchunks.push(payload.slice(i, i + KITTY_CHUNK_SIZE));\n\t}\n\tif (chunks.length === 0) {\n\t\t// Empty image: still emit a single transmit chunk.\n\t\treturn \"\\x1b_Ga=T,f=100,t=f;\\x1b\\\\\";\n\t}\n\tconst out: string[] = [];\n\tout.push(`\\x1b_Ga=T,f=100,t=f;${chunks[0]}\\x1b\\\\`);\n\tfor (let i = 1; i < chunks.length; i++) {\n\t\tout.push(`\\x1b_Gm=1;${chunks[i]}\\x1b\\\\`);\n\t}\n\treturn out.join(\"\");\n}\n\n/**\n * Encode an image for the detected protocol. Returns \"\" when the protocol is\n * unsupported (including sixel, which is detected but not rasterized here).\n */\nexport function encodeInlineImage(\n\tbuf: Buffer,\n\tsupport: TerminalImageSupport = detectTerminalImageSupport(),\n\topts: InlineImageOptions = {},\n): string {\n\tswitch (support) {\n\t\tcase \"iterm\":\n\t\t\treturn encodeItermInline(buf, opts);\n\t\tcase \"kitty\":\n\t\t\treturn encodeKittyInline(buf);\n\t\tdefault:\n\t\t\treturn \"\";\n\t}\n}\n"]}

package/dist/utils/terminal-text.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Terminal-safe text helpers that do not depend on the removed TypeScript TUI.
+ * Used by CLI previews (e.g. `maestro agents init` diff preview).
+ */
+export declare function stripAnsiSequences(text: string): string;
+/**
+ * Strip ANSI and other control characters so repository text can be printed
+ * safely to a terminal without escaping or mode-setting sequences.
+ */
+export declare function sanitizeTerminalPreview(text: string): string;
+//# sourceMappingURL=terminal-text.d.ts.map

package/dist/utils/terminal-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-text.d.ts","sourceRoot":"","sources":["../../src/utils/terminal-text.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5D"}

package/dist/utils/terminal-text.js

@@ -0,0 +1,21 @@
+/**
+ * Terminal-safe text helpers that do not depend on the removed TypeScript TUI.
+ * Used by CLI previews (e.g. `maestro agents init` diff preview).
+ */
+const ANSI_STRING_TERMINATORS = "(?:\\u0007|\\u001B\\u005C|\\u009C)";
+const ANSI_OSC_SEQUENCE = `(?:\\u001B\\][\\s\\S]*?${ANSI_STRING_TERMINATORS})`;
+const ANSI_CSI_SEQUENCE = "[\\u001B\\u009B][[\\]()#;?]*(?:\\d{1,4}(?:[;:]\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]";
+const ANSI_ESCAPE_SEQUENCE = new RegExp(`${ANSI_OSC_SEQUENCE}|${ANSI_CSI_SEQUENCE}`, "g");
+export function stripAnsiSequences(text) {
+    return text.replace(ANSI_ESCAPE_SEQUENCE, "");
+}
+/**
+ * Strip ANSI and other control characters so repository text can be printed
+ * safely to a terminal without escaping or mode-setting sequences.
+ */
+export function sanitizeTerminalPreview(text) {
+    return stripAnsiSequences(text).replace(
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: preview text may come from repository files and must not emit terminal controls.
+    /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g, "");
+}
+//# sourceMappingURL=terminal-text.js.map

package/dist/utils/terminal-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-text.js","sourceRoot":"","sources":["../../src/utils/terminal-text.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,uBAAuB,GAAG,oCAAoC,CAAC;AACrE,MAAM,iBAAiB,GAAG,0BAA0B,uBAAuB,GAAG,CAAC;AAC/E,MAAM,iBAAiB,GACtB,oFAAoF,CAAC;AACtF,MAAM,oBAAoB,GAAG,IAAI,MAAM,CACtC,GAAG,iBAAiB,IAAI,iBAAiB,EAAE,EAC3C,GAAG,CACH,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IACnD,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,OAAO;IACtC,4IAA4I;IAC5I,iDAAiD,EACjD,EAAE,CACF,CAAC;AACH,CAAC","sourcesContent":["/**\n * Terminal-safe text helpers that do not depend on the removed TypeScript TUI.\n * Used by CLI previews (e.g. `maestro agents init` diff preview).\n */\n\nconst ANSI_STRING_TERMINATORS = \"(?:\\\\u0007|\\\\u001B\\\\u005C|\\\\u009C)\";\nconst ANSI_OSC_SEQUENCE = `(?:\\\\u001B\\\\][\\\\s\\\\S]*?${ANSI_STRING_TERMINATORS})`;\nconst ANSI_CSI_SEQUENCE =\n\t\"[\\\\u001B\\\\u009B][[\\\\]()#;?]*(?:\\\\d{1,4}(?:[;:]\\\\d{0,4})*)?[\\\\dA-PR-TZcf-nq-uy=><~]\";\nconst ANSI_ESCAPE_SEQUENCE = new RegExp(\n\t`${ANSI_OSC_SEQUENCE}|${ANSI_CSI_SEQUENCE}`,\n\t\"g\",\n);\n\nexport function stripAnsiSequences(text: string): string {\n\treturn text.replace(ANSI_ESCAPE_SEQUENCE, \"\");\n}\n\n/**\n * Strip ANSI and other control characters so repository text can be printed\n * safely to a terminal without escaping or mode-setting sequences.\n */\nexport function sanitizeTerminalPreview(text: string): string {\n\treturn stripAnsiSequences(text).replace(\n\t\t// biome-ignore lint/suspicious/noControlCharactersInRegex: preview text may come from repository files and must not emit terminal controls.\n\t\t/[\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F]/g,\n\t\t\"\",\n\t);\n}\n"]}

package/dist/version.json

@@ -1,4 +1,4 @@
 {
-  "version": "0.10.51",
-  "notes": "Maestro by EvalOps - Deterministic coding agent with TUI/CLI and Web UI for AI-assisted development v0.10.51 is now available."
+  "version": "0.10.53",
+  "notes": "Maestro by EvalOps - Deterministic coding agent with TUI/CLI and Web UI for AI-assisted development v0.10.53 is now available."
 }

package/dist/web-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-server.d.ts","sourceRoot":"","sources":["../src/web-server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACN,KAAK,eAAe,EACpB,KAAK,cAAc,EAEnB,MAAM,WAAW,CAAC;AA+BnB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AASxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAgB5D,OAAO,KAAK,EACX,mBAAmB,EAEnB,MAAM,yBAAyB,CAAC;AAsBjC,UAAU,qBAAqB;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACvC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAC/B;AA0FD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAoQrD,eAAO,MAAM,qBAAqB;iBACpB,eAAe;;;kBAbT,MAAM;iBAAW,MAAM;;CAgB1C,CAAC;AA+OF,wBAAgB,wBAAwB,CACvC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,EACrC,aAAa,SAAiB,GAC5B,OAAO,CAET;AAkLD,wBAAsB,cAAc,CACnC,IAAI,SAAO,EACX,OAAO,GAAE,qBAA0B,iFA2SnC"}
+{"version":3,"file":"web-server.d.ts","sourceRoot":"","sources":["../src/web-server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACN,KAAK,eAAe,EACpB,KAAK,cAAc,EAEnB,MAAM,WAAW,CAAC;AA+BnB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AASxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAgB5D,OAAO,KAAK,EACX,mBAAmB,EAEnB,MAAM,yBAAyB,CAAC;AA2BjC,UAAU,qBAAqB;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACvC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAC/B;AA0FD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAoQrD,eAAO,MAAM,qBAAqB;iBACpB,eAAe;;;kBAbT,MAAM;iBAAW,MAAM;;CAgB1C,CAAC;AA+OF,wBAAgB,wBAAwB,CACvC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,EACrC,aAAa,SAAiB,GAC5B,OAAO,CAET;AAkLD,wBAAsB,cAAc,CACnC,IAAI,SAAO,EACX,OAAO,GAAE,qBAA0B,iFAkUnC"}

package/dist/web-server.js

@@ -29,7 +29,8 @@ import { createAuthResolver, } from "./providers/auth.js";
 import { registerBackgroundTaskShutdownHooks } from "./runtime/background-task-hooks.js";
 import { configureSafeMode } from "./safety/safe-mode.js";
 import { HostedRunnerDrainReasonValue, HostedRunnerDrainStatusValue, drainHostedRunnerForShutdown, } from "./server/handlers/hosted-runner-drain.js";
-import { createWorkspaceConfigMiddleware } from "./services/workspace-config/middleware.js";
+import { createWorkspaceConfigMiddleware, loadWorkspaceConfigRequestContext, } from "./services/workspace-config/middleware.js";
+import { WorkspaceConfigValidationError } from "./services/workspace-config/normalize.js";
 import { recordApiRequest } from "./telemetry.js";
 import { artifactsClientTool } from "./tools/artifacts-client.js";
 import { askUserClientTool } from "./tools/ask-user-client.js";
@@ -729,6 +730,7 @@ export async function startWebServer(port = 8080, options = {}) {
             return;
         }
         let runtimeSessionId;
+        let workspaceConfig;
         if (url.pathname === "/api/runtime/ws") {
             const authorization = await authorizeRuntimeWebSocketSession({
                 req,
@@ -742,6 +744,26 @@ export async function startWebServer(port = 8080, options = {}) {
             }
             runtimeSessionId = authorization;
         }
+        else {
+            try {
+                workspaceConfig = await loadWorkspaceConfigRequestContext(req);
+            }
+            catch (error) {
+                const validationError = error instanceof WorkspaceConfigValidationError;
+                const status = validationError ? 400 : 503;
+                const message = validationError
+                    ? error.message
+                    : "Workspace config could not be loaded.";
+                if (!validationError) {
+                    logger.warn("Failed to load workspace config for WebSocket chat", {
+                        error: sanitizeWithStaticMask(error instanceof Error ? error.message : String(error)),
+                    });
+                }
+                socket.write(`HTTP/1.1 ${status} ${status === 400 ? "Bad Request" : "Service Unavailable"}\r\nConnection: close\r\nContent-Type: text/plain\r\nContent-Length: ${Buffer.byteLength(message)}\r\n\r\n${message}`);
+                socket.destroy();
+                return;
+            }
+        }
         wsServer.handleUpgrade(req, socket, head, (ws) => {
             if (url.pathname === "/api/runtime/ws") {
                 handleRuntimeAppServerWebSocket(ws, {
@@ -750,7 +772,7 @@ export async function startWebServer(port = 8080, options = {}) {
                 });
                 return;
             }
-            handleChatWebSocket(ws, req, context);
+            handleChatWebSocket(ws, req, context, workspaceConfig);
         });
     });
     const onListening = () => {