poe-code 3.0.231 → 3.0.233

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poe-code",
-  "version": "3.0.231",
+  "version": "3.0.233",
   "description": "CLI tool to configure Poe API for developer workflows.",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,6 +38,7 @@
     "check:semver": "node -e \"const semver=require('semver'); const pkg=require('./package.json'); if(!semver.valid(pkg.version)){console.error('Invalid semver version in package.json:', pkg.version); process.exit(1);}\"",
     "lint": "npm run lint:eslint && npm run lint:types && npm run lint:workflows",
     "lint:workflows": "(command -v actionlint > /dev/null || bash scripts/setup-actionlint.sh) && (command -v actionlint > /dev/null && actionlint || ./actionlint)",
+    "lint:packages": "poe-package-lint",
     "lint:eslint": "eslint . --ext ts",
     "lint:types": "tsc -p tsconfig.build.json --noEmit",
     "labels:generate": "tsx scripts/generate-labels.ts",
@@ -111,6 +112,7 @@
   "packageManager": "npm@10.9.2",
   "dependencies": {
     "@clack/prompts": "^1.0.0",
+    "ajv": "^8.20.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "console-table-printer": "^2.15.0",
@@ -129,6 +131,8 @@
     "smol-toml": "^1.6.0",
     "tiktoken": "^1.0.22",
     "turndown": "^7.2.4",
+    "uri-template": "^2.0.0",
+    "uri-template-lite": "^23.4.0",
     "yaml": "^2.8.2"
   },
   "devDependencies": {
@@ -160,6 +164,7 @@
     "@poe-code/maestro-tui": "*",
     "@poe-code/markdown-reader": "*",
     "@poe-code/memory": "*",
+    "@poe-code/package-lint": "*",
     "@poe-code/pipeline": "*",
     "@poe-code/plan-browser": "*",
     "@poe-code/poe-acp-client": "*",

package/packages/agent-skill-config/dist/index.d.ts

@@ -7,4 +7,5 @@ export { configure, unconfigure, installSkill, UnsupportedAgentError } from "./a
 export type { InstallSkillOptions, InstallSkillResult } from "./apply.js";
 export { resolveSkillReference } from "./resolve-skill-reference.js";
 export { appendExcludeBlock, removeExcludeBlock } from "./git-exclude.js";
+export { setGitDirRunnerForTest } from "./git-exclude.js";
 export { bridgeActiveSkills, cleanupBridgedSkills } from "./bridge-active-skills.js";

package/packages/agent-skill-config/dist/index.js

@@ -2,4 +2,5 @@ export { supportedAgents, resolveAgentSupport, getAgentConfig, resolveSkillDir }
 export { configure, unconfigure, installSkill, UnsupportedAgentError } from "./apply.js";
 export { resolveSkillReference } from "./resolve-skill-reference.js";
 export { appendExcludeBlock, removeExcludeBlock } from "./git-exclude.js";
+export { setGitDirRunnerForTest } from "./git-exclude.js";
 export { bridgeActiveSkills, cleanupBridgedSkills } from "./bridge-active-skills.js";

package/packages/memory/dist/explain.js

@@ -1,6 +1,6 @@
 import * as fs from "node:fs/promises";
 import path from "node:path";
-import { countTokens } from "../../tokenfill/dist/index.js";
+import { countTokens } from "tokenfill";
 import { spawn } from "@poe-code/agent-spawn";
 import { resolveAgent } from "@poe-code/poe-code-config";
 import { readPage } from "./pages.js";

package/packages/memory/dist/index.js

@@ -12258,7 +12258,7 @@ import { mkdir as mkdir6, open as open2 } from "node:fs/promises";
 import * as fs15 from "node:fs/promises";
 import path52 from "node:path";
 
-// packages/tokenfill/dist/tokenizer.js
+// packages/tokenfill/src/tokenizer.ts
 import { get_encoding } from "tiktoken";
 var DEFAULT_ENCODING = "cl100k_base";
 function createTokenizer(options = {}) {
@@ -12287,10 +12287,14 @@ function createTokenizer(options = {}) {
     try {
       truncated = strictUtf8Decoder.decode(tokenizer.decode(tokens.slice(0, tokenCount)));
     } catch {
-      throw new Error(`Cannot truncate text to exactly ${tokenCount} tokens without corrupting UTF-8 text.`);
+      throw new Error(
+        `Cannot truncate text to exactly ${tokenCount} tokens without corrupting UTF-8 text.`
+      );
     }
     if (count(truncated) !== tokenCount) {
-      throw new Error(`Cannot truncate text to exactly ${tokenCount} tokens without changing token boundaries.`);
+      throw new Error(
+        `Cannot truncate text to exactly ${tokenCount} tokens without changing token boundaries.`
+      );
     }
     return truncated;
   };
@@ -12309,7 +12313,7 @@ function countTokens(text5) {
   return defaultTokenizer.count(text5);
 }
 
-// packages/tokenfill/dist/corpus.js
+// packages/tokenfill/src/corpus.ts
 import { readdirSync as readdirSync2, readFileSync as readFileSync8 } from "node:fs";
 import { dirname, join as join2 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
@@ -12327,7 +12331,7 @@ function loadBuiltInCorpusArticles() {
 }
 var BUILT_IN_CORPUS_ARTICLES = loadBuiltInCorpusArticles();
 
-// packages/tokenfill/dist/tokenfill.js
+// packages/tokenfill/src/tokenfill.ts
 var builtInCorpusText = BUILT_IN_CORPUS_ARTICLES.join(CORPUS_ARTICLE_SEPARATOR);
 var builtInCorpusByteLength = Buffer.byteLength(builtInCorpusText, "utf8");
 
@@ -12564,6 +12568,9 @@ async function runWithTimeout(promise, timeoutMs, onTimeout) {
 
 // packages/tiny-stdio-mcp-server/src/server.ts
 import * as readline2 from "readline";
+import AjvModule from "ajv";
+import uriTemplateParser from "uri-template";
+import UriTemplate from "uri-template-lite";
 
 // packages/tiny-stdio-mcp-server/src/types.ts
 var JSON_RPC_ERROR_CODES = Object.freeze({
@@ -12571,7 +12578,8 @@ var JSON_RPC_ERROR_CODES = Object.freeze({
   INVALID_REQUEST: -32600,
   METHOD_NOT_FOUND: -32601,
   INVALID_PARAMS: -32602,
-  INTERNAL_ERROR: -32603
+  INTERNAL_ERROR: -32603,
+  RESOURCE_NOT_FOUND: -32002
 });
 var ToolError = class extends Error {
   constructor(code, message2) {
@@ -13074,12 +13082,21 @@ var SUPPORTED_PROTOCOL_VERSIONS = /* @__PURE__ */ new Set([
   PROTOCOL_VERSION
 ]);
 function createServer(options) {
+  const Ajv = "default" in AjvModule ? AjvModule.default : AjvModule;
+  const jsonSchemaValidator = new Ajv({ strict: false });
+  const supportNotifications = options.supportNotifications !== false;
+  const supportResourceSubscriptions = options.supportResourceSubscriptions !== false;
   const tools = /* @__PURE__ */ new Map();
+  const prompts = /* @__PURE__ */ new Map();
+  const resources = /* @__PURE__ */ new Map();
+  const resourceTemplates = /* @__PURE__ */ new Map();
   const notificationListeners = /* @__PURE__ */ new Set();
   const connectionNotificationListeners = /* @__PURE__ */ new Map();
   const defaultLifecycle = {
     initialized: false,
-    initializeAccepted: false
+    initializeAccepted: false,
+    notificationReady: false,
+    resourceSubscriptions: /* @__PURE__ */ new Set()
   };
   const messageLifecycles = /* @__PURE__ */ new Set([defaultLifecycle]);
   const handleMessageWithLifecycle = async (method, lifecycle, params) => {
@@ -13089,12 +13106,20 @@ function createServer(options) {
     if (method === "initialize") {
       lifecycle.initializeAccepted = true;
       lifecycle.initialized = true;
+      lifecycle.notificationReady = false;
       const requestedProtocol = typeof params?.protocolVersion === "string" ? params.protocolVersion : void 0;
       const result = {
         protocolVersion: requestedProtocol !== void 0 && SUPPORTED_PROTOCOL_VERSIONS.has(requestedProtocol) ? requestedProtocol : PROTOCOL_VERSION,
         capabilities: {
           tools: {
-            listChanged: true
+            ...supportNotifications ? { listChanged: true } : {}
+          },
+          prompts: {
+            ...supportNotifications ? { listChanged: true } : {}
+          },
+          resources: {
+            ...supportNotifications ? { listChanged: true } : {},
+            ...supportResourceSubscriptions ? { subscribe: true } : {}
           }
         },
         serverInfo: {
@@ -13113,6 +13138,7 @@ function createServer(options) {
           }
         };
       }
+      lifecycle.notificationReady = true;
       return { result: void 0 };
     }
     if (!lifecycle.initialized) {
@@ -13126,10 +13152,10 @@ function createServer(options) {
     if (method === "tools/list") {
       const toolList = [];
       for (const tool of tools.values()) {
+        const descriptor = { ...tool };
+        delete descriptor.handler;
         toolList.push({
-          name: tool.name,
-          description: tool.description,
-          inputSchema: tool.inputSchema
+          ...descriptor
         });
       }
       return { result: { tools: toolList } };
@@ -13154,7 +13180,7 @@ function createServer(options) {
         };
       }
       const toolArgs = params?.arguments ?? {};
-      if (options.validateToolArguments !== false && !areValidToolArguments(tool.inputSchema, toolArgs)) {
+      if (options.validateToolArguments !== false && !jsonSchemaValidator.validate(tool.inputSchema, toolArgs)) {
         return {
           error: {
             code: JSON_RPC_ERROR_CODES.INVALID_PARAMS,
@@ -13168,6 +13194,9 @@ function createServer(options) {
           throw new Error("Invalid tool result");
         }
         const result = isCallToolResult(handlerResult) ? handlerResult : { content: toContentBlocks(handlerResult) };
+        if (tool.outputSchema !== void 0 && (result.structuredContent === void 0 || !jsonSchemaValidator.validate(tool.outputSchema, result.structuredContent))) {
+          throw new Error("Invalid structured tool result");
+        }
         return { result };
       } catch (err) {
         if (err instanceof ToolError) {
@@ -13186,6 +13215,94 @@ function createServer(options) {
         return { result };
       }
     }
+    if (method === "prompts/list") {
+      return {
+        result: {
+          prompts: [...prompts.values()].map(({ handler: _handler, ...prompt }) => prompt)
+        }
+      };
+    }
+    if (method === "prompts/get") {
+      const promptName = typeof params?.name === "string" ? params.name : void 0;
+      if (promptName === void 0) {
+        return invalidParams("Prompt name required");
+      }
+      const prompt = prompts.get(promptName);
+      if (prompt === void 0) {
+        return invalidParams(`Prompt not found: ${promptName}`);
+      }
+      const args = toStringArguments(params?.arguments);
+      if (args === void 0 || !hasRequiredPromptArguments(prompt, args)) {
+        return invalidParams("Invalid prompt arguments");
+      }
+      try {
+        const result = await prompt.handler(args);
+        if (!isGetPromptResult(result)) {
+          return internalError("Invalid prompt result");
+        }
+        return { result };
+      } catch (error2) {
+        return internalError(toErrorMessage(error2));
+      }
+    }
+    if (method === "resources/list") {
+      return {
+        result: {
+          resources: [...resources.values()].map(({ handler: _handler, ...resource }) => resource)
+        }
+      };
+    }
+    if (method === "resources/templates/list") {
+      return {
+        result: {
+          resourceTemplates: [...resourceTemplates.values()].map(
+            ({ handler: _handler, ...resourceTemplate }) => resourceTemplate
+          )
+        }
+      };
+    }
+    if (method === "resources/read") {
+      const uri = typeof params?.uri === "string" ? params.uri : void 0;
+      if (uri === void 0 || !isValidUri(uri)) {
+        return invalidParams("Resource URI required");
+      }
+      const resource = findReadableResource(uri, resources, resourceTemplates);
+      if (resource === void 0) {
+        return resourceNotFound(uri);
+      }
+      try {
+        const result = await resource.handler(uri);
+        if (!isReadResourceResult(result)) {
+          return internalError("Invalid resource result");
+        }
+        return { result };
+      } catch (error2) {
+        return internalError(toErrorMessage(error2));
+      }
+    }
+    if (method === "resources/subscribe" || method === "resources/unsubscribe") {
+      if (!supportResourceSubscriptions) {
+        return {
+          error: {
+            code: JSON_RPC_ERROR_CODES.METHOD_NOT_FOUND,
+            message: "Method not found"
+          }
+        };
+      }
+      const uri = typeof params?.uri === "string" ? params.uri : void 0;
+      if (uri === void 0 || !isValidUri(uri)) {
+        return invalidParams("Resource URI required");
+      }
+      if (method === "resources/subscribe" && findReadableResource(uri, resources, resourceTemplates) === void 0) {
+        return resourceNotFound(uri);
+      }
+      if (method === "resources/subscribe") {
+        lifecycle.resourceSubscriptions.add(uri);
+      } else {
+        lifecycle.resourceSubscriptions.delete(uri);
+      }
+      return { result: {} };
+    }
     return {
       error: {
         code: JSON_RPC_ERROR_CODES.METHOD_NOT_FOUND,
@@ -13193,15 +13310,23 @@ function createServer(options) {
       }
     };
   };
-  const createMessageSession = () => {
+  const createMessageSession = (listener) => {
     const lifecycle = {
       initialized: false,
-      initializeAccepted: false
+      initializeAccepted: false,
+      notificationReady: false,
+      resourceSubscriptions: /* @__PURE__ */ new Set()
     };
     messageLifecycles.add(lifecycle);
+    if (listener !== void 0) {
+      connectionNotificationListeners.set(listener, lifecycle);
+    }
     return {
       handleMessage: (method, params) => handleMessageWithLifecycle(method, lifecycle, params),
       close: () => {
+        if (listener !== void 0) {
+          connectionNotificationListeners.delete(listener);
+        }
         messageLifecycles.delete(lifecycle);
       }
     };
@@ -13236,17 +13361,18 @@ function createServer(options) {
       write2(formatSuccessResponse(requestWithId.id, result) + "\n");
     }
   };
-  const broadcastNotification = async (method) => {
+  const broadcastNotification = async (method, params, canSend = () => true) => {
     const notification = {
       jsonrpc: "2.0",
-      method
+      method,
+      ...params === void 0 ? {} : { params }
     };
     for (const listener of notificationListeners) {
       listener(notification);
     }
     await Promise.all(
       [...connectionNotificationListeners].map(async ([listener, lifecycle]) => {
-        if (lifecycle.initialized) {
+        if (lifecycle.notificationReady && canSend(lifecycle)) {
           await listener(notification);
         }
       })
@@ -13262,6 +13388,30 @@ function createServer(options) {
       });
       return server;
     },
+    registerTool(definition, handler) {
+      tools.set(definition.name, {
+        ...definition,
+        handler
+      });
+      return server;
+    },
+    prompt(definition, handler) {
+      prompts.set(definition.name, { ...definition, handler });
+      return server;
+    },
+    resource(definition, handler) {
+      if (!isValidUri(definition.uri)) {
+        throw new Error(`Invalid resource URI: ${definition.uri}`);
+      }
+      resources.set(definition.uri, { ...definition, handler });
+      return server;
+    },
+    resourceTemplate(definition, handler) {
+      uriTemplateParser.parse(definition.uriTemplate);
+      new UriTemplate(definition.uriTemplate);
+      resourceTemplates.set(definition.uriTemplate, { ...definition, handler });
+      return server;
+    },
     onNotification(listener) {
       notificationListeners.add(listener);
       return () => {
@@ -13271,11 +13421,40 @@ function createServer(options) {
     removeTool(name) {
       return tools.delete(name);
     },
+    removePrompt(name) {
+      return prompts.delete(name);
+    },
+    removeResource(uri) {
+      return resources.delete(uri);
+    },
+    removeResourceTemplate(uriTemplate) {
+      return resourceTemplates.delete(uriTemplate);
+    },
     async notifyToolsChanged() {
-      if ([...messageLifecycles].some((lifecycle) => lifecycle.initialized)) {
+      if (supportNotifications && [...messageLifecycles].some((lifecycle) => lifecycle.notificationReady)) {
         await broadcastNotification("notifications/tools/list_changed");
       }
     },
+    async notifyPromptsChanged() {
+      if (supportNotifications && [...messageLifecycles].some((lifecycle) => lifecycle.notificationReady)) {
+        await broadcastNotification("notifications/prompts/list_changed");
+      }
+    },
+    async notifyResourcesChanged() {
+      if (supportNotifications && [...messageLifecycles].some((lifecycle) => lifecycle.notificationReady)) {
+        await broadcastNotification("notifications/resources/list_changed");
+      }
+    },
+    async notifyResourceUpdated(uri) {
+      if (!supportResourceSubscriptions) {
+        return;
+      }
+      await broadcastNotification(
+        "notifications/resources/updated",
+        { uri },
+        (lifecycle) => lifecycle.resourceSubscriptions.has(uri)
+      );
+    },
     createMessageSession,
     handleMessage,
     async listen() {
@@ -13286,7 +13465,7 @@ function createServer(options) {
     },
     async connect(transport) {
       return new Promise((resolve2) => {
-        const lifecycle = { initialized: false, initializeAccepted: false };
+        const lifecycle = { initialized: false, initializeAccepted: false, notificationReady: false, resourceSubscriptions: /* @__PURE__ */ new Set() };
         const messageHandler = (method, params) => handleMessageWithLifecycle(method, lifecycle, params);
         messageLifecycles.add(lifecycle);
         const listener = (notification) => {
@@ -13316,7 +13495,7 @@ function createServer(options) {
     },
     async connectSDK(transport) {
       return new Promise((resolve2, reject) => {
-        const lifecycle = { initialized: false, initializeAccepted: false };
+        const lifecycle = { initialized: false, initializeAccepted: false, notificationReady: false, resourceSubscriptions: /* @__PURE__ */ new Set() };
         const messageHandler = (method, params) => handleMessageWithLifecycle(method, lifecycle, params);
         messageLifecycles.add(lifecycle);
         const listener = (notification) => transport.send(notification);
@@ -13376,35 +13555,99 @@ function createServer(options) {
   };
   return server;
 }
-function isCallToolResult(value) {
-  return hasContentArray(value) && value.content.every(isContentItem);
+function invalidParams(message2) {
+  return {
+    error: {
+      code: JSON_RPC_ERROR_CODES.INVALID_PARAMS,
+      message: message2
+    }
+  };
 }
-function hasContentArray(value) {
-  return typeof value === "object" && value !== null && "content" in value && Array.isArray(value.content);
+function internalError(message2) {
+  return {
+    error: {
+      code: JSON_RPC_ERROR_CODES.INTERNAL_ERROR,
+      message: message2
+    }
+  };
 }
-function areValidToolArguments(schema, value) {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+function resourceNotFound(uri) {
+  return {
+    error: {
+      code: JSON_RPC_ERROR_CODES.RESOURCE_NOT_FOUND,
+      message: `Resource not found: ${uri}`
+    }
+  };
+}
+function toErrorMessage(error2) {
+  return error2 instanceof Error ? error2.message : String(error2);
+}
+function isValidUri(uri) {
+  try {
+    new URL(uri);
+    return true;
+  } catch {
     return false;
   }
-  const argumentsObject = value;
-  for (const key of schema.required ?? []) {
-    if (!Object.hasOwn(argumentsObject, key)) {
-      return false;
-    }
+}
+function toStringArguments(value) {
+  if (value === void 0) {
+    return {};
   }
-  for (const [key, property] of Object.entries(schema.properties)) {
-    if (!Object.hasOwn(argumentsObject, key)) {
-      continue;
-    }
-    const argument = argumentsObject[key];
-    if (argument === null && property.nullable === true) {
-      continue;
-    }
-    if (property.type === "array" && !Array.isArray(argument) || property.type === "object" && (typeof argument !== "object" || argument === null || Array.isArray(argument)) || property.type === "integer" && !Number.isInteger(argument) || property.type !== "array" && property.type !== "object" && property.type !== "integer" && typeof argument !== property.type) {
-      return false;
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return void 0;
+  }
+  const args = {};
+  for (const [name, argument] of Object.entries(value)) {
+    if (typeof argument !== "string") {
+      return void 0;
     }
+    args[name] = argument;
   }
-  return true;
+  return args;
+}
+function hasRequiredPromptArguments(prompt, args) {
+  return (prompt.arguments ?? []).every(
+    (argument) => argument.required !== true || args[argument.name] !== void 0
+  );
+}
+function findReadableResource(uri, resources, resourceTemplates) {
+  const resource = resources.get(uri);
+  if (resource !== void 0) {
+    return resource;
+  }
+  return [...resourceTemplates.values()].find(
+    (template) => matchesUriTemplate(template.uriTemplate, uri)
+  );
+}
+function matchesUriTemplate(template, uri) {
+  try {
+    return new UriTemplate(template).match(uri) !== null;
+  } catch {
+    return false;
+  }
+}
+function isCallToolResult(value) {
+  return hasContentArray(value) && value.content.every(isContentItem);
+}
+function isGetPromptResult(value) {
+  if (typeof value !== "object" || value === null || !("messages" in value)) {
+    return false;
+  }
+  return Array.isArray(value.messages) && value.messages.every(
+    (message2) => typeof message2 === "object" && message2 !== null && "role" in message2 && (message2.role === "user" || message2.role === "assistant") && "content" in message2 && isPromptContentItem(message2.content)
+  );
+}
+function isReadResourceResult(value) {
+  if (typeof value !== "object" || value === null || !("contents" in value)) {
+    return false;
+  }
+  return Array.isArray(value.contents) && value.contents.every(
+    (content) => typeof content === "object" && content !== null && "uri" in content && typeof content.uri === "string" && isValidUri(content.uri) && ("text" in content && typeof content.text === "string" || "blob" in content && typeof content.blob === "string" && isBase64(content.blob))
+  );
+}
+function hasContentArray(value) {
+  return typeof value === "object" && value !== null && "content" in value && Array.isArray(value.content);
 }
 function isContentItem(value) {
   if (typeof value !== "object" || value === null || !("type" in value)) {
@@ -13415,13 +13658,41 @@ function isContentItem(value) {
     return typeof block.text === "string";
   }
   if (block.type === "image" || block.type === "audio") {
-    return typeof block.data === "string" && typeof block.mimeType === "string";
+    return typeof block.data === "string" && isBase64(block.data) && typeof block.mimeType === "string";
+  }
+  if (block.type === "resource_link") {
+    return typeof block.uri === "string" && typeof block.name === "string";
   }
   if (block.type !== "resource" || typeof block.resource !== "object" || block.resource === null) {
     return false;
   }
   const resource = block.resource;
-  return typeof resource.uri === "string" && typeof resource.mimeType === "string" && (typeof resource.text === "string" || typeof resource.blob === "string");
+  return typeof resource.uri === "string" && (resource.mimeType === void 0 || typeof resource.mimeType === "string") && (typeof resource.text === "string" || typeof resource.blob === "string" && isBase64(resource.blob));
+}
+function isBase64(value) {
+  if (value.length === 0) {
+    return true;
+  }
+  if (value.length % 4 !== 0) {
+    return false;
+  }
+  const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+  const paddingStart = value.indexOf("=");
+  const encoded = paddingStart === -1 ? value : value.slice(0, paddingStart);
+  const padding = paddingStart === -1 ? "" : value.slice(paddingStart);
+  if (padding.length > 2 || [...padding].some((character) => character !== "=")) {
+    return false;
+  }
+  if ([...encoded].some((character) => !alphabet.includes(character))) {
+    return false;
+  }
+  return Buffer.from(value, "base64").toString("base64") === value;
+}
+function isPromptContentItem(value) {
+  if (!isContentItem(value)) {
+    return false;
+  }
+  return !(typeof value === "object" && value !== null && "type" in value && value.type === "resource_link");
 }
 
 // packages/tiny-stdio-mcp-server/src/schema.ts