@ubiquity-os/plugin-sdk 3.3.4 → 3.4.0

package/dist/index.d.mts

@@ -129,11 +129,13 @@ interface Options$1 {
     bypassSignatureVerification?: boolean;
     returnDataToKernel?: boolean;
 }
+/**
+ * Removes wrapper backticks or fenced blocks that LLMs often return around payloads.
+ */
+declare function sanitizeLlmResponse(input: string): string;
 
 declare function createActionsPlugin<TConfig = unknown, TEnv = unknown, TCommand = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName>(handler: (context: Context<TConfig, TEnv, TCommand, TSupportedEvents>) => HandlerReturn, options?: Options$1): Promise<void>;
 
-declare function createPlugin<TConfig = unknown, TEnv = unknown, TCommand = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName>(handler: (context: Context<TConfig, TEnv, TCommand, TSupportedEvents>) => HandlerReturn, manifest: Manifest, options?: Options$1): Hono<hono_types.BlankEnv, hono_types.BlankSchema, "/">;
-
 /**
  * Options for cleanMarkdown.
  *
@@ -164,4 +166,6 @@ type Options = {
  */
 declare function cleanMarkdown(md: string, options?: Options): string;
 
-export { CommentHandler, type Context, type Options$1 as Options, cleanMarkdown, createActionsPlugin, createPlugin };
+declare function createPlugin<TConfig = unknown, TEnv = unknown, TCommand = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName>(handler: (context: Context<TConfig, TEnv, TCommand, TSupportedEvents>) => HandlerReturn, manifest: Manifest, options?: Options$1): Hono<hono_types.BlankEnv, hono_types.BlankSchema, "/">;
+
+export { CommentHandler, type Context, type Options$1 as Options, cleanMarkdown, createActionsPlugin, createPlugin, sanitizeLlmResponse };

package/dist/index.d.ts

@@ -129,11 +129,13 @@ interface Options$1 {
     bypassSignatureVerification?: boolean;
     returnDataToKernel?: boolean;
 }
+/**
+ * Removes wrapper backticks or fenced blocks that LLMs often return around payloads.
+ */
+declare function sanitizeLlmResponse(input: string): string;
 
 declare function createActionsPlugin<TConfig = unknown, TEnv = unknown, TCommand = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName>(handler: (context: Context<TConfig, TEnv, TCommand, TSupportedEvents>) => HandlerReturn, options?: Options$1): Promise<void>;
 
-declare function createPlugin<TConfig = unknown, TEnv = unknown, TCommand = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName>(handler: (context: Context<TConfig, TEnv, TCommand, TSupportedEvents>) => HandlerReturn, manifest: Manifest, options?: Options$1): Hono<hono_types.BlankEnv, hono_types.BlankSchema, "/">;
-
 /**
  * Options for cleanMarkdown.
  *
@@ -164,4 +166,6 @@ type Options = {
  */
 declare function cleanMarkdown(md: string, options?: Options): string;
 
-export { CommentHandler, type Context, type Options$1 as Options, cleanMarkdown, createActionsPlugin, createPlugin };
+declare function createPlugin<TConfig = unknown, TEnv = unknown, TCommand = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName>(handler: (context: Context<TConfig, TEnv, TCommand, TSupportedEvents>) => HandlerReturn, manifest: Manifest, options?: Options$1): Hono<hono_types.BlankEnv, hono_types.BlankSchema, "/">;
+
+export { CommentHandler, type Context, type Options$1 as Options, cleanMarkdown, createActionsPlugin, createPlugin, sanitizeLlmResponse };

package/dist/index.js

@@ -33,7 +33,8 @@ __export(src_exports, {
   CommentHandler: () => CommentHandler,
   cleanMarkdown: () => cleanMarkdown,
   createActionsPlugin: () => createActionsPlugin,
-  createPlugin: () => createPlugin
+  createPlugin: () => createPlugin,
+  sanitizeLlmResponse: () => sanitizeLlmResponse
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -156,6 +157,24 @@ JQIDAQAB
 function sanitizeMetadata(obj) {
   return JSON.stringify(obj, null, 2).replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/--/g, "&#45;&#45;");
 }
+function sanitizeLlmResponse(input) {
+  const trimmed = input.trim();
+  if (!trimmed) {
+    return trimmed;
+  }
+  if (trimmed.startsWith("```")) {
+    let result = trimmed.replace(/^```[a-z0-9+-]*\s*(?:\r\n|\n)?/i, "");
+    if (result.endsWith("```")) {
+      result = result.slice(0, -3);
+      result = result.replace(/[\r\n]+$/, "");
+    }
+    return result.trim();
+  }
+  if (trimmed.startsWith("`") && trimmed.endsWith("`")) {
+    return trimmed.slice(1, -1).trim();
+  }
+  return trimmed;
+}
 function getPluginOptions(options) {
   return {
     // Important to use || and not ?? to not consider empty strings
@@ -553,6 +572,59 @@ async function returnDataToKernel(repoToken, stateId, output) {
   });
 }
 
+// src/markdown.ts
+var VOID_TAGS = /* @__PURE__ */ new Set(["area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "param", "source", "track", "wbr"]);
+function cleanMarkdown(md, options = {}) {
+  const codeBlockRegex = /(```[\s\S]*?```|~~~[\s\S]*?~~~)/g;
+  const { tags = [], shouldCollapseEmptyLines = false } = options;
+  const segments = [];
+  let lastIndex = 0;
+  const matches = [...md.matchAll(codeBlockRegex)];
+  for (const match of matches) {
+    if (match.index > lastIndex) {
+      segments.push(processSegment(md.slice(lastIndex, match.index), tags, shouldCollapseEmptyLines));
+    }
+    segments.push(match[0]);
+    lastIndex = match.index + match[0].length;
+  }
+  if (lastIndex < md.length) {
+    segments.push(processSegment(md.slice(lastIndex), tags, shouldCollapseEmptyLines));
+  }
+  return segments.join("");
+}
+function processSegment(segment, extraTags, shouldCollapseEmptyLines) {
+  const inlineCodeRegex = /`[^`]*`/g;
+  const inlineCodes = [];
+  let s = segment.replace(inlineCodeRegex, (m) => {
+    inlineCodes.push(m);
+    return `__INLINE_CODE_${inlineCodes.length - 1}__`;
+  });
+  s = s.replace(/<!--[\s\S]*?-->/g, "");
+  for (const raw of extraTags) {
+    if (!raw) continue;
+    const tag = raw.toLowerCase().trim().replace(/[^\w:-]/g, "");
+    if (!tag) continue;
+    if (VOID_TAGS.has(tag)) {
+      const voidRe = new RegExp(`<${tag}\\b[^>]*\\/?>`, "gi");
+      s = s.replace(voidRe, "");
+      continue;
+    }
+    const pairRe = new RegExp(`<${tag}\\b[^>]*>[\\s\\S]*?<\\/${tag}>`, "gi");
+    let prev;
+    do {
+      prev = s;
+      s = s.replace(pairRe, "");
+    } while (s !== prev);
+    const openCloseRe = new RegExp(`<\\/?${tag}\\b[^>]*>`, "gi");
+    s = s.replace(openCloseRe, "");
+  }
+  s = s.replace(/__INLINE_CODE_(\d+)__/g, (str, idx) => inlineCodes[+idx]);
+  if (shouldCollapseEmptyLines) {
+    s = s.replace(/[ \t]+$/gm, "").replace(/\n{3,}/g, "\n\n");
+  }
+  return s;
+}
+
 // src/server.ts
 var import_value4 = require("@sinclair/typebox/value");
 var import_ubiquity_os_logger4 = require("@ubiquity-os/ubiquity-os-logger");
@@ -633,63 +705,11 @@ function createPlugin(handler, manifest, options) {
   });
   return app;
 }
-
-// src/markdown.ts
-var VOID_TAGS = /* @__PURE__ */ new Set(["area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "param", "source", "track", "wbr"]);
-function cleanMarkdown(md, options = {}) {
-  const codeBlockRegex = /(```[\s\S]*?```|~~~[\s\S]*?~~~)/g;
-  const { tags = [], shouldCollapseEmptyLines = false } = options;
-  const segments = [];
-  let lastIndex = 0;
-  const matches = [...md.matchAll(codeBlockRegex)];
-  for (const match of matches) {
-    if (match.index > lastIndex) {
-      segments.push(processSegment(md.slice(lastIndex, match.index), tags, shouldCollapseEmptyLines));
-    }
-    segments.push(match[0]);
-    lastIndex = match.index + match[0].length;
-  }
-  if (lastIndex < md.length) {
-    segments.push(processSegment(md.slice(lastIndex), tags, shouldCollapseEmptyLines));
-  }
-  return segments.join("");
-}
-function processSegment(segment, extraTags, shouldCollapseEmptyLines) {
-  const inlineCodeRegex = /`[^`]*`/g;
-  const inlineCodes = [];
-  let s = segment.replace(inlineCodeRegex, (m) => {
-    inlineCodes.push(m);
-    return `__INLINE_CODE_${inlineCodes.length - 1}__`;
-  });
-  s = s.replace(/<!--[\s\S]*?-->/g, "");
-  for (const raw of extraTags) {
-    if (!raw) continue;
-    const tag = raw.toLowerCase().trim().replace(/[^\w:-]/g, "");
-    if (!tag) continue;
-    if (VOID_TAGS.has(tag)) {
-      const voidRe = new RegExp(`<${tag}\\b[^>]*\\/?>`, "gi");
-      s = s.replace(voidRe, "");
-      continue;
-    }
-    const pairRe = new RegExp(`<${tag}\\b[^>]*>[\\s\\S]*?<\\/${tag}>`, "gi");
-    let prev;
-    do {
-      prev = s;
-      s = s.replace(pairRe, "");
-    } while (s !== prev);
-    const openCloseRe = new RegExp(`<\\/?${tag}\\b[^>]*>`, "gi");
-    s = s.replace(openCloseRe, "");
-  }
-  s = s.replace(/__INLINE_CODE_(\d+)__/g, (str, idx) => inlineCodes[+idx]);
-  if (shouldCollapseEmptyLines) {
-    s = s.replace(/[ \t]+$/gm, "").replace(/\n{3,}/g, "\n\n");
-  }
-  return s;
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CommentHandler,
   cleanMarkdown,
   createActionsPlugin,
-  createPlugin
+  createPlugin,
+  sanitizeLlmResponse
 });

package/dist/index.mjs

@@ -117,6 +117,24 @@ JQIDAQAB
 function sanitizeMetadata(obj) {
   return JSON.stringify(obj, null, 2).replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/--/g, "&#45;&#45;");
 }
+function sanitizeLlmResponse(input) {
+  const trimmed = input.trim();
+  if (!trimmed) {
+    return trimmed;
+  }
+  if (trimmed.startsWith("```")) {
+    let result = trimmed.replace(/^```[a-z0-9+-]*\s*(?:\r\n|\n)?/i, "");
+    if (result.endsWith("```")) {
+      result = result.slice(0, -3);
+      result = result.replace(/[\r\n]+$/, "");
+    }
+    return result.trim();
+  }
+  if (trimmed.startsWith("`") && trimmed.endsWith("`")) {
+    return trimmed.slice(1, -1).trim();
+  }
+  return trimmed;
+}
 function getPluginOptions(options) {
   return {
     // Important to use || and not ?? to not consider empty strings
@@ -514,6 +532,59 @@ async function returnDataToKernel(repoToken, stateId, output) {
   });
 }
 
+// src/markdown.ts
+var VOID_TAGS = /* @__PURE__ */ new Set(["area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "param", "source", "track", "wbr"]);
+function cleanMarkdown(md, options = {}) {
+  const codeBlockRegex = /(```[\s\S]*?```|~~~[\s\S]*?~~~)/g;
+  const { tags = [], shouldCollapseEmptyLines = false } = options;
+  const segments = [];
+  let lastIndex = 0;
+  const matches = [...md.matchAll(codeBlockRegex)];
+  for (const match of matches) {
+    if (match.index > lastIndex) {
+      segments.push(processSegment(md.slice(lastIndex, match.index), tags, shouldCollapseEmptyLines));
+    }
+    segments.push(match[0]);
+    lastIndex = match.index + match[0].length;
+  }
+  if (lastIndex < md.length) {
+    segments.push(processSegment(md.slice(lastIndex), tags, shouldCollapseEmptyLines));
+  }
+  return segments.join("");
+}
+function processSegment(segment, extraTags, shouldCollapseEmptyLines) {
+  const inlineCodeRegex = /`[^`]*`/g;
+  const inlineCodes = [];
+  let s = segment.replace(inlineCodeRegex, (m) => {
+    inlineCodes.push(m);
+    return `__INLINE_CODE_${inlineCodes.length - 1}__`;
+  });
+  s = s.replace(/<!--[\s\S]*?-->/g, "");
+  for (const raw of extraTags) {
+    if (!raw) continue;
+    const tag = raw.toLowerCase().trim().replace(/[^\w:-]/g, "");
+    if (!tag) continue;
+    if (VOID_TAGS.has(tag)) {
+      const voidRe = new RegExp(`<${tag}\\b[^>]*\\/?>`, "gi");
+      s = s.replace(voidRe, "");
+      continue;
+    }
+    const pairRe = new RegExp(`<${tag}\\b[^>]*>[\\s\\S]*?<\\/${tag}>`, "gi");
+    let prev;
+    do {
+      prev = s;
+      s = s.replace(pairRe, "");
+    } while (s !== prev);
+    const openCloseRe = new RegExp(`<\\/?${tag}\\b[^>]*>`, "gi");
+    s = s.replace(openCloseRe, "");
+  }
+  s = s.replace(/__INLINE_CODE_(\d+)__/g, (str, idx) => inlineCodes[+idx]);
+  if (shouldCollapseEmptyLines) {
+    s = s.replace(/[ \t]+$/gm, "").replace(/\n{3,}/g, "\n\n");
+  }
+  return s;
+}
+
 // src/server.ts
 import { Value as Value4 } from "@sinclair/typebox/value";
 import { Logs as Logs2 } from "@ubiquity-os/ubiquity-os-logger";
@@ -594,62 +665,10 @@ function createPlugin(handler, manifest, options) {
   });
   return app;
 }
-
-// src/markdown.ts
-var VOID_TAGS = /* @__PURE__ */ new Set(["area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "param", "source", "track", "wbr"]);
-function cleanMarkdown(md, options = {}) {
-  const codeBlockRegex = /(```[\s\S]*?```|~~~[\s\S]*?~~~)/g;
-  const { tags = [], shouldCollapseEmptyLines = false } = options;
-  const segments = [];
-  let lastIndex = 0;
-  const matches = [...md.matchAll(codeBlockRegex)];
-  for (const match of matches) {
-    if (match.index > lastIndex) {
-      segments.push(processSegment(md.slice(lastIndex, match.index), tags, shouldCollapseEmptyLines));
-    }
-    segments.push(match[0]);
-    lastIndex = match.index + match[0].length;
-  }
-  if (lastIndex < md.length) {
-    segments.push(processSegment(md.slice(lastIndex), tags, shouldCollapseEmptyLines));
-  }
-  return segments.join("");
-}
-function processSegment(segment, extraTags, shouldCollapseEmptyLines) {
-  const inlineCodeRegex = /`[^`]*`/g;
-  const inlineCodes = [];
-  let s = segment.replace(inlineCodeRegex, (m) => {
-    inlineCodes.push(m);
-    return `__INLINE_CODE_${inlineCodes.length - 1}__`;
-  });
-  s = s.replace(/<!--[\s\S]*?-->/g, "");
-  for (const raw of extraTags) {
-    if (!raw) continue;
-    const tag = raw.toLowerCase().trim().replace(/[^\w:-]/g, "");
-    if (!tag) continue;
-    if (VOID_TAGS.has(tag)) {
-      const voidRe = new RegExp(`<${tag}\\b[^>]*\\/?>`, "gi");
-      s = s.replace(voidRe, "");
-      continue;
-    }
-    const pairRe = new RegExp(`<${tag}\\b[^>]*>[\\s\\S]*?<\\/${tag}>`, "gi");
-    let prev;
-    do {
-      prev = s;
-      s = s.replace(pairRe, "");
-    } while (s !== prev);
-    const openCloseRe = new RegExp(`<\\/?${tag}\\b[^>]*>`, "gi");
-    s = s.replace(openCloseRe, "");
-  }
-  s = s.replace(/__INLINE_CODE_(\d+)__/g, (str, idx) => inlineCodes[+idx]);
-  if (shouldCollapseEmptyLines) {
-    s = s.replace(/[ \t]+$/gm, "").replace(/\n{3,}/g, "\n\n");
-  }
-  return s;
-}
 export {
   CommentHandler,
   cleanMarkdown,
   createActionsPlugin,
-  createPlugin
+  createPlugin,
+  sanitizeLlmResponse
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubiquity-os/plugin-sdk",
-  "version": "3.3.4",
+  "version": "3.4.0",
   "description": "SDK for plugin support.",
   "author": "Ubiquity DAO",
   "license": "MIT",