@microsoft/teamsfx-core 3.1.0 → 3.1.1

package/build/component/generator/openPlugin/iconStrategy.js

@@ -0,0 +1,62 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyIcons = applyIcons;
+const tslib_1 = require("tslib");
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const path = tslib_1.__importStar(require("path"));
+const placeholderPng_1 = require("./placeholderPng");
+const COLOR_FILL = [0x4a, 0x90, 0xd9];
+const OUTLINE_FILL = [0xff, 0xff, 0xff];
+/**
+ * Write color.png and outline.png into the appPackage directory. Resolution
+ * order matches the conversion plan: user-supplied root PNG → Open Plugin
+ * `logo` (when it is a local .png) → generated placeholder.
+ */
+async function applyIcons(parsed, appPackageDir, warnings) {
+    const colorDest = path.join(appPackageDir, "color.png");
+    const outlineDest = path.join(appPackageDir, "outline.png");
+    if (parsed.hasColorPng) {
+        await fs_extra_1.default.copy(path.join(parsed.pluginRoot, "color.png"), colorDest);
+    }
+    else if (typeof parsed.manifest.logo === "string" && parsed.manifest.logo) {
+        const applied = await tryApplyLogo(parsed, colorDest, warnings);
+        if (!applied) {
+            await fs_extra_1.default.writeFile(colorDest, (0, placeholderPng_1.generatePlaceholderPng)(192, ...COLOR_FILL));
+        }
+    }
+    else {
+        await fs_extra_1.default.writeFile(colorDest, (0, placeholderPng_1.generatePlaceholderPng)(192, ...COLOR_FILL));
+    }
+    if (parsed.hasOutlinePng) {
+        await fs_extra_1.default.copy(path.join(parsed.pluginRoot, "outline.png"), outlineDest);
+    }
+    else {
+        await fs_extra_1.default.writeFile(outlineDest, (0, placeholderPng_1.generatePlaceholderPng)(32, ...OUTLINE_FILL));
+    }
+}
+async function tryApplyLogo(parsed, colorDest, warnings) {
+    const logo = parsed.manifest.logo;
+    if (/^https?:\/\//i.test(logo)) {
+        warnings.push(`'logo' field points to a remote URL (${logo}); using placeholder color.png. Download manually if you want to ship the original.`);
+        return false;
+    }
+    if (!/\.png$/i.test(logo)) {
+        warnings.push(`'logo' field '${logo}' is not a .png file; using placeholder color.png.`);
+        return false;
+    }
+    const logoAbs = path.resolve(parsed.pluginRoot, logo);
+    const relativeToRoot = path.relative(parsed.pluginRoot, logoAbs);
+    if (relativeToRoot.startsWith("..") || path.isAbsolute(relativeToRoot)) {
+        warnings.push(`'logo' field '${logo}' resolves outside the plugin root; using placeholder color.png.`);
+        return false;
+    }
+    if (!(await fs_extra_1.default.pathExists(logoAbs))) {
+        warnings.push(`'logo' field '${logo}' does not exist; using placeholder color.png.`);
+        return false;
+    }
+    await fs_extra_1.default.copy(logoAbs, colorDest);
+    return true;
+}
+//# sourceMappingURL=iconStrategy.js.map

package/build/component/generator/openPlugin/iconStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconStrategy.js","sourceRoot":"","sources":["../../../../src/component/generator/openPlugin/iconStrategy.ts"],"names":[],"mappings":"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"}

package/build/component/generator/openPlugin/importer.d.ts

@@ -0,0 +1,25 @@
+import { FxError, Result } from "@microsoft/teamsfx-api";
+import { ImportInputs } from "./types";
+export declare const OPEN_PLUGIN_IMPORT_SOURCE = "OpenPluginImport";
+export interface ImportResult {
+    projectPath: string;
+    warnings: string[];
+}
+/**
+ * Import an Open Plugin / Claude Code plugin / Cursor plugin directory into
+ * a scaffolded Microsoft 365 Agents Toolkit project. The output is a usable
+ * ATK project; run `atk teamsapp package` from inside it to produce the
+ * upload zip.
+ *
+ * Static baseline files (m365agents.yml, README, .gitignore, .vscode, env)
+ * come from the `open-plugin-import` template, which ships in the standard
+ * template release pipeline and can be updated independently of fx-core.
+ * Variable-length outputs (manifest, skill folders, icons) are written as
+ * the post-scaffold step here.
+ */
+export declare function importOpenPlugin(inputs: ImportInputs): Promise<Result<ImportResult, FxError>>;
+export declare function stripDisallowedFrontmatter(source: string): {
+    content: string;
+    removedKeys: string[];
+};
+//# sourceMappingURL=importer.d.ts.map

package/build/component/generator/openPlugin/importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../../../src/component/generator/openPlugin/importer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAO,OAAO,EAAM,MAAM,EAA0B,MAAM,wBAAwB,CAAC;AAU1F,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,eAAO,MAAM,yBAAyB,qBAAqB,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAuExC;AAqCD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAsBA"}

package/build/component/generator/openPlugin/importer.js

@@ -0,0 +1,140 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPEN_PLUGIN_IMPORT_SOURCE = void 0;
+exports.importOpenPlugin = importOpenPlugin;
+exports.stripDisallowedFrontmatter = stripDisallowedFrontmatter;
+const tslib_1 = require("tslib");
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const js_yaml_1 = tslib_1.__importDefault(require("js-yaml"));
+const path = tslib_1.__importStar(require("path"));
+const globalVars_1 = require("../../../common/globalVars");
+const generator_1 = require("../generator");
+const templateNames_1 = require("../templates/templateNames");
+const iconStrategy_1 = require("./iconStrategy");
+const mapper_1 = require("./mapper");
+const parser_1 = require("./parser");
+exports.OPEN_PLUGIN_IMPORT_SOURCE = "OpenPluginImport";
+/**
+ * Import an Open Plugin / Claude Code plugin / Cursor plugin directory into
+ * a scaffolded Microsoft 365 Agents Toolkit project. The output is a usable
+ * ATK project; run `atk teamsapp package` from inside it to produce the
+ * upload zip.
+ *
+ * Static baseline files (m365agents.yml, README, .gitignore, .vscode, env)
+ * come from the `open-plugin-import` template, which ships in the standard
+ * template release pipeline and can be updated independently of fx-core.
+ * Variable-length outputs (manifest, skill folders, icons) are written as
+ * the post-scaffold step here.
+ */
+async function importOpenPlugin(inputs) {
+    try {
+        if (!inputs.path) {
+            return (0, teamsfx_api_1.err)(new teamsfx_api_1.UserError(exports.OPEN_PLUGIN_IMPORT_SOURCE, "MissingPluginPath", "--path is required."));
+        }
+        const parsed = await (0, parser_1.readOpenPluginDir)(inputs.path);
+        const { manifest, copyOps, warnings } = (0, mapper_1.mapToTtkProject)(parsed, inputs);
+        const defaultOutput = path.join(process.cwd(), parsed.manifest.name);
+        const projectPath = path.resolve(inputs.output ?? defaultOutput);
+        if (await fs_extra_1.default.pathExists(projectPath)) {
+            const entries = await fs_extra_1.default.readdir(projectPath);
+            if (entries.length > 0) {
+                return (0, teamsfx_api_1.err)(new teamsfx_api_1.UserError(exports.OPEN_PLUGIN_IMPORT_SOURCE, "OutputDirectoryNotEmpty", `Output directory is not empty: ${projectPath}. Choose a different --output path or empty the directory.`));
+            }
+        }
+        // 1. Scaffold the static baseline from the open-plugin-import template.
+        const ctx = (0, globalVars_1.createContext)();
+        ctx.templateVariables = { appName: parsed.manifest.name };
+        const scaffoldRes = await generator_1.Generator.generateTemplate(ctx, projectPath, templateNames_1.TemplateNames.OpenPluginImport, "common");
+        if (scaffoldRes.isErr())
+            return (0, teamsfx_api_1.err)(scaffoldRes.error);
+        // 2. Post-scaffold: write the dynamic outputs.
+        const appPackageDir = path.join(projectPath, "appPackage");
+        await fs_extra_1.default.ensureDir(appPackageDir);
+        // Manifest (vDevPreview agentSkills/agentConnectors are variable-length).
+        await fs_extra_1.default.writeJSON(path.join(appPackageDir, "manifest.json"), manifest, { spaces: 4 });
+        // Copy skill folders and (when present) the commands folder.
+        for (const op of copyOps) {
+            await fs_extra_1.default.copy(op.src, path.join(projectPath, op.destRelative));
+        }
+        // Strip SKILL.md frontmatter fields that Teams Developer Portal rejects.
+        // Allowed: name, description, license, metadata, compatibility.
+        await sanitizeSkillFiles(path.join(appPackageDir, "skills"), warnings);
+        // Icons.
+        await (0, iconStrategy_1.applyIcons)(parsed, appPackageDir, warnings);
+        return (0, teamsfx_api_1.ok)({ projectPath, warnings });
+    }
+    catch (e) {
+        if (e instanceof teamsfx_api_1.UserError || e instanceof teamsfx_api_1.SystemError) {
+            return (0, teamsfx_api_1.err)(e);
+        }
+        const message = e instanceof Error ? e.message : String(e);
+        return (0, teamsfx_api_1.err)(new teamsfx_api_1.SystemError({
+            source: exports.OPEN_PLUGIN_IMPORT_SOURCE,
+            name: "ImportOpenPluginFailed",
+            message,
+            displayMessage: message,
+        }));
+    }
+}
+// Teams Developer Portal accepts only these SKILL.md frontmatter keys.
+const ALLOWED_SKILL_FRONTMATTER_KEYS = new Set([
+    "name",
+    "description",
+    "license",
+    "metadata",
+    "compatibility",
+]);
+/**
+ * Walk every `skills/<name>/SKILL.md` and remove top-level frontmatter keys
+ * that aren't on the M365 allow-list (e.g. Claude-specific `user-invocable`,
+ * `argument-hint`). Records each removal as a warning. Files without a
+ * frontmatter block are left untouched.
+ */
+async function sanitizeSkillFiles(skillsRoot, warnings) {
+    if (!(await fs_extra_1.default.pathExists(skillsRoot)))
+        return;
+    const entries = await fs_extra_1.default.readdir(skillsRoot, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const skillMd = path.join(skillsRoot, entry.name, "SKILL.md");
+        if (!(await fs_extra_1.default.pathExists(skillMd)))
+            continue;
+        const original = await fs_extra_1.default.readFile(skillMd, "utf8");
+        const { content, removedKeys } = stripDisallowedFrontmatter(original);
+        if (removedKeys.length > 0) {
+            await fs_extra_1.default.writeFile(skillMd, content, "utf8");
+            warnings.push(`Removed unsupported SKILL.md frontmatter field(s) from skills/${entry.name}: ${removedKeys.join(", ")}.`);
+        }
+    }
+}
+function stripDisallowedFrontmatter(source) {
+    const match = /^---\r?\n([\s\S]*?)\r?\n---(\r?\n|$)/.exec(source);
+    if (!match)
+        return { content: source, removedKeys: [] };
+    const parsed = js_yaml_1.default.load(match[1]);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return { content: source, removedKeys: [] };
+    }
+    const obj = parsed;
+    const removedKeys = [];
+    const kept = {};
+    for (const key of Object.keys(obj)) {
+        if (ALLOWED_SKILL_FRONTMATTER_KEYS.has(key)) {
+            kept[key] = obj[key];
+        }
+        else {
+            removedKeys.push(key);
+        }
+    }
+    if (removedKeys.length === 0)
+        return { content: source, removedKeys: [] };
+    const dumped = js_yaml_1.default.dump(kept, { lineWidth: -1 }).replace(/\n$/, "");
+    const trailing = match[2] || "\n";
+    const rebuilt = `---\n${dumped}\n---${trailing}` + source.slice(match[0].length);
+    return { content: rebuilt, removedKeys };
+}
+//# sourceMappingURL=importer.js.map

package/build/component/generator/openPlugin/importer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.js","sourceRoot":"","sources":["../../../../src/component/generator/openPlugin/importer.ts"],"names":[],"mappings":"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"}

package/build/component/generator/openPlugin/mapper.d.ts

@@ -0,0 +1,6 @@
+import { ImportInputs, MappedManifest, ParsedOpenPlugin } from "./types";
+export declare const MANIFEST_SCHEMA_URL = "https://developer.microsoft.com/json-schemas/teams/vDevPreview/MicrosoftTeams.schema.json";
+export declare const MANIFEST_VERSION = "devPreview";
+export declare const ACCENT_COLOR = "#4A90D9";
+export declare function mapToTtkProject(parsed: ParsedOpenPlugin, inputs: ImportInputs): MappedManifest;
+//# sourceMappingURL=mapper.d.ts.map

package/build/component/generator/openPlugin/mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../../src/component/generator/openPlugin/mapper.ts"],"names":[],"mappings":"AAOA,OAAO,EAKL,YAAY,EACZ,cAAc,EAEd,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,mBAAmB,8FAC6D,CAAC;AAC9F,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAC7C,eAAO,MAAM,YAAY,YAAY,CAAC;AAQtC,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,GAAG,cAAc,CAsG9F"}

package/build/component/generator/openPlugin/mapper.js

@@ -0,0 +1,141 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACCENT_COLOR = exports.MANIFEST_VERSION = exports.MANIFEST_SCHEMA_URL = void 0;
+exports.mapToTtkProject = mapToTtkProject;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const authorParser_1 = require("./authorParser");
+const deterministicId_1 = require("./deterministicId");
+const textUtils_1 = require("./textUtils");
+exports.MANIFEST_SCHEMA_URL = "https://developer.microsoft.com/json-schemas/teams/vDevPreview/MicrosoftTeams.schema.json";
+exports.MANIFEST_VERSION = "devPreview";
+exports.ACCENT_COLOR = "#4A90D9";
+const NAME_SHORT_MAX = 30;
+const NAME_FULL_MAX = 100;
+const DESC_SHORT_MAX = 80;
+const DESC_FULL_MAX = 4000;
+const MAX_AGENT_CONNECTORS = 10;
+function mapToTtkProject(parsed, inputs) {
+    const warnings = [...parsed.warnings];
+    const pj = parsed.manifest;
+    const pluginName = pj.name;
+    const ext = parsed.atkExtension ?? {};
+    if (inputs.packageName !== undefined) {
+        warnings.push("--package-name was provided but the devPreview manifest schema does not include 'packageName'; ignored.");
+    }
+    const author = (0, authorParser_1.parseAuthor)(pj.author);
+    const websiteUrl = inputs.websiteUrl ?? ext.developer?.websiteUrl ?? pj.homepage ?? author.url;
+    if (!websiteUrl) {
+        throw new Error("developer.websiteUrl could not be resolved. Set 'homepage' in plugin.json, 'author.url', or pass --website-url.");
+    }
+    const privacyUrl = inputs.privacyUrl ?? ext.developer?.privacyUrl;
+    if (!privacyUrl) {
+        throw new Error("developer.privacyUrl is required. Pass --privacy-url (Open Plugin spec has no equivalent field).");
+    }
+    const termsUrl = inputs.termsUrl ?? ext.developer?.termsOfUseUrl;
+    if (!termsUrl) {
+        throw new Error("developer.termsOfUseUrl is required. Pass --terms-url (Open Plugin spec has no equivalent field).");
+    }
+    const idSeed = inputs.packageName ?? ext.packageName ?? `openplugin:${pluginName}`;
+    const appId = inputs.appId ?? ext.id ?? (0, deterministicId_1.deterministicAppId)(idSeed);
+    const displayName = (0, textUtils_1.toTitleCaseFromKebab)(pluginName);
+    const shortName = ext.name?.short ?? (0, textUtils_1.truncateAtWordBoundary)(displayName, NAME_SHORT_MAX);
+    const fullName = ext.name?.full ?? (0, textUtils_1.truncateAtWordBoundary)(displayName, NAME_FULL_MAX);
+    const description = pj.description ?? pluginName;
+    const shortDesc = ext.description?.short ?? (0, textUtils_1.truncateAtWordBoundary)(description, DESC_SHORT_MAX);
+    const fullDesc = ext.description?.full ?? (0, textUtils_1.truncateAtWordBoundary)(description, DESC_FULL_MAX);
+    const agentSkills = parsed.skills.map((folder) => ({ folder: `./skills/${folder}` }));
+    const agentConnectors = buildAgentConnectors(parsed.mcpServers, pluginName, inputs.defaultAuthType ?? "Auto", ext.agentConnectors, warnings);
+    if (agentConnectors.length > MAX_AGENT_CONNECTORS) {
+        throw new Error(`Too many MCP servers: ${agentConnectors.length}. The manifest caps agentConnectors at ${MAX_AGENT_CONNECTORS}.`);
+    }
+    const developer = {
+        name: ext.developer?.name ?? author.name ?? "Unknown",
+        websiteUrl,
+        privacyUrl,
+        termsOfUseUrl: termsUrl,
+    };
+    const accentColor = ext.accentColor ?? exports.ACCENT_COLOR;
+    const manifest = {
+        $schema: exports.MANIFEST_SCHEMA_URL,
+        manifestVersion: ext.manifestVersion ?? exports.MANIFEST_VERSION,
+        version: pj.version ?? "1.0.0",
+        id: appId,
+    };
+    manifest.developer = developer;
+    manifest.name = { short: shortName, full: fullName };
+    manifest.description = { short: shortDesc, full: fullDesc };
+    manifest.icons = { color: "color.png", outline: "outline.png" };
+    manifest.accentColor = accentColor;
+    if (agentSkills.length > 0) {
+        manifest.agentSkills = agentSkills;
+    }
+    if (agentConnectors.length > 0) {
+        manifest.agentConnectors = agentConnectors;
+    }
+    const copyOps = [];
+    if (parsed.skillsRoot) {
+        for (const skill of parsed.skills) {
+            copyOps.push({
+                src: path.join(parsed.skillsRoot, skill),
+                destRelative: `appPackage/skills/${skill}`,
+            });
+        }
+    }
+    if (parsed.commandsRoot && parsed.commands.length > 0) {
+        copyOps.push({
+            src: parsed.commandsRoot,
+            destRelative: "appPackage/commands",
+        });
+    }
+    return { manifest, copyOps, warnings };
+}
+function buildAgentConnectors(mcpServers, pluginName, defaultAuth, extOverrides, warnings) {
+    const out = [];
+    const serverNames = Object.keys(mcpServers).sort();
+    for (const name of serverNames) {
+        const server = mcpServers[name];
+        const url = typeof server.url === "string" ? server.url.trim() : "";
+        if (!url) {
+            warnings.push(`Skipping MCP server '${name}': no URL found (stdio servers require manual localMcpServer configuration).`);
+            continue;
+        }
+        const override = extOverrides?.[name];
+        const authType = override?.authorization?.type ?? resolveAuthType(url, defaultAuth);
+        const authorization = { type: authType };
+        if (authType !== "None") {
+            authorization.referenceId =
+                override?.authorization?.referenceId ?? `${pluginName}-${name}-auth`;
+        }
+        const description = override?.description ??
+            (typeof server.description === "string" && server.description
+                ? server.description
+                : `Remote MCP server providing tools for ${pluginName}`);
+        out.push({
+            id: name,
+            displayName: override?.displayName ?? `${name} MCP Server`,
+            description,
+            toolSource: {
+                remoteMcpServer: {
+                    mcpServerUrl: url,
+                    authorization,
+                },
+            },
+        });
+    }
+    return out;
+}
+function resolveAuthType(url, defaultAuth) {
+    if (defaultAuth !== "Auto") {
+        return defaultAuth;
+    }
+    const isHttps = /^https:\/\//i.test(url);
+    const isLocal = /localhost|127\.0\.0\.1/.test(url);
+    if (isHttps && !isLocal) {
+        return "OAuthPluginVault";
+    }
+    return "None";
+}
+//# sourceMappingURL=mapper.js.map

package/build/component/generator/openPlugin/mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../../../src/component/generator/openPlugin/mapper.ts"],"names":[],"mappings":"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"}

package/build/component/generator/openPlugin/parser.d.ts

@@ -0,0 +1,3 @@
+import { ParsedOpenPlugin } from "./types";
+export declare function readOpenPluginDir(root: string): Promise<ParsedOpenPlugin>;
+//# sourceMappingURL=parser.d.ts.map

package/build/component/generator/openPlugin/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/component/generator/openPlugin/parser.ts"],"names":[],"mappings":"AAKA,OAAO,EAKL,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAoCjB,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+H/E"}

package/build/component/generator/openPlugin/parser.js

@@ -0,0 +1,153 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readOpenPluginDir = readOpenPluginDir;
+const tslib_1 = require("tslib");
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const path = tslib_1.__importStar(require("path"));
+const MANIFEST_LOCATIONS = [
+    { relPath: ".plugin/plugin.json", kind: "open-plugin" },
+    { relPath: ".claude-plugin/plugin.json", kind: "claude-plugin" },
+    { relPath: ".cursor-plugin/plugin.json", kind: "cursor-plugin" },
+];
+const SKILL_NAME_RE = /^[a-z0-9][a-z0-9-_]*$/;
+const UNMAPPED_FIELDS = [
+    "agents",
+    "hooks",
+    "rules",
+    "lspServers",
+    "outputStyles",
+];
+function requireStringPathOverride(value, field) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value === "string") {
+        return value;
+    }
+    throw new Error(`Open Plugin '${field}' override is set to a non-string value. Only the single-string form ` +
+        `(e.g. \"${field}\": \"./custom/path\") is supported by this converter today.`);
+}
+async function readOpenPluginDir(root) {
+    const warnings = [];
+    const absRoot = path.resolve(root);
+    if (!(await fs_extra_1.default.pathExists(absRoot))) {
+        throw new Error(`Plugin directory not found: ${absRoot}`);
+    }
+    // 1. Probe manifest locations.
+    let manifestPath;
+    let manifestKind;
+    for (const loc of MANIFEST_LOCATIONS) {
+        const candidate = path.join(absRoot, loc.relPath);
+        if (await fs_extra_1.default.pathExists(candidate)) {
+            manifestPath = candidate;
+            manifestKind = loc.kind;
+            break;
+        }
+    }
+    if (!manifestPath || !manifestKind) {
+        throw new Error(`No Open Plugin manifest found in ${absRoot}. Looked for: ` +
+            MANIFEST_LOCATIONS.map((l) => l.relPath).join(", "));
+    }
+    const manifest = (await fs_extra_1.default.readJSON(manifestPath));
+    if (!manifest.name || typeof manifest.name !== "string") {
+        throw new Error(`plugin.json is missing required 'name' field at ${manifestPath}`);
+    }
+    // 2. MCP servers (with optional path override).
+    const mcpRel = requireStringPathOverride(manifest.mcpServers, "mcpServers") ?? ".mcp.json";
+    const mcpAbs = path.resolve(absRoot, mcpRel);
+    const mcpServers = {};
+    if (await fs_extra_1.default.pathExists(mcpAbs)) {
+        const mcpJson = (await fs_extra_1.default.readJSON(mcpAbs));
+        const source = mcpJson &&
+            typeof mcpJson === "object" &&
+            mcpJson.mcpServers &&
+            typeof mcpJson.mcpServers === "object"
+            ? mcpJson.mcpServers
+            : mcpJson;
+        if (source && typeof source === "object") {
+            for (const [name, value] of Object.entries(source)) {
+                if (value && typeof value === "object" && !Array.isArray(value)) {
+                    mcpServers[name] = value;
+                }
+            }
+        }
+    }
+    // 3. Skills.
+    const skillsRel = requireStringPathOverride(manifest.skills, "skills") ?? "skills";
+    const skillsAbs = path.resolve(absRoot, skillsRel);
+    const skills = [];
+    let skillsRoot;
+    if (await fs_extra_1.default.pathExists(skillsAbs)) {
+        skillsRoot = skillsAbs;
+        const entries = await fs_extra_1.default.readdir(skillsAbs, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory()) {
+                continue;
+            }
+            if (!SKILL_NAME_RE.test(entry.name)) {
+                warnings.push(`Skipping skill folder '${entry.name}': name does not match ${SKILL_NAME_RE.source}.`);
+                continue;
+            }
+            const skillMd = path.join(skillsAbs, entry.name, "SKILL.md");
+            if (await fs_extra_1.default.pathExists(skillMd)) {
+                skills.push(entry.name);
+            }
+        }
+        skills.sort();
+    }
+    // 4. Commands.
+    const commandsRel = requireStringPathOverride(manifest.commands, "commands") ?? "commands";
+    const commandsAbs = path.resolve(absRoot, commandsRel);
+    const commands = [];
+    let commandsRoot;
+    if (await fs_extra_1.default.pathExists(commandsAbs)) {
+        commandsRoot = commandsAbs;
+        const entries = await fs_extra_1.default.readdir(commandsAbs, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isFile() && entry.name.toLowerCase().endsWith(".md")) {
+                commands.push(entry.name);
+            }
+        }
+        commands.sort();
+    }
+    // 5. Unmapped Open Plugin fields → emit a warning so the caller knows we
+    // dropped them. We do not throw — the spec says hosts may ignore unknown
+    // component types.
+    const manifestRecord = manifest;
+    for (const field of UNMAPPED_FIELDS) {
+        if (manifestRecord[field] !== undefined) {
+            warnings.push(`Open Plugin '${field}' field is present but not supported by MOS3 today; dropped.`);
+        }
+    }
+    // 6. Icons.
+    const hasColorPng = await fs_extra_1.default.pathExists(path.join(absRoot, "color.png"));
+    const hasOutlinePng = await fs_extra_1.default.pathExists(path.join(absRoot, "outline.png"));
+    // 7. Round-trip extension block (written by `atk export openplugin`).
+    const atkExtension = readAtkExtensionBlock(manifest);
+    return {
+        pluginRoot: absRoot,
+        manifest,
+        manifestPath,
+        manifestKind,
+        mcpServers,
+        skills,
+        skillsRoot,
+        commands,
+        commandsRoot,
+        hasColorPng,
+        hasOutlinePng,
+        warnings,
+        atkExtension,
+    };
+}
+const ATK_EXTENSION_KEY = "x-microsoft-365-agents-toolkit";
+function readAtkExtensionBlock(manifest) {
+    const raw = manifest[ATK_EXTENSION_KEY];
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        return undefined;
+    }
+    return raw;
+}
+//# sourceMappingURL=parser.js.map

package/build/component/generator/openPlugin/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../src/component/generator/openPlugin/parser.ts"],"names":[],"mappings":"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"}

package/build/component/generator/openPlugin/placeholderPng.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generate a square solid-color RGB PNG of the given size.
+ * Produces minimal valid PNG bytes; no external dependencies.
+ */
+export declare function generatePlaceholderPng(size: number, r: number, g: number, b: number): Buffer;
+//# sourceMappingURL=placeholderPng.d.ts.map

package/build/component/generator/openPlugin/placeholderPng.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholderPng.d.ts","sourceRoot":"","sources":["../../../../src/component/generator/openPlugin/placeholderPng.ts"],"names":[],"mappings":"AAqCA;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAkC5F"}