@microsoft/teamsfx-core 3.1.0 → 3.1.1

package/build/v4/runtime/steps/openApiCustomApi.js

@@ -0,0 +1,385 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTeamsAiCustomApiFiles = generateTeamsAiCustomApiFiles;
+const tslib_1 = require("tslib");
+const m365_spec_parser_1 = require("@microsoft/m365-spec-parser");
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const util = tslib_1.__importStar(require("util"));
+const featureFlags_1 = require("../../../common/featureFlags");
+const localizeUtils_1 = require("../../../common/localizeUtils");
+const constants_1 = require("../../../question/constants");
+const supportedLanguages = [constants_1.ProgrammingLanguage.TS, constants_1.ProgrammingLanguage.JS, constants_1.ProgrammingLanguage.PY];
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function operationId(operation) {
+    if (!operation.operationId) {
+        throw new Error("The selected OpenAPI operation has no operationId.");
+    }
+    return operation.operationId;
+}
+function isOperationObject(value) {
+    return isRecord(value);
+}
+function parseOperations(spec) {
+    const operations = [];
+    for (const [pathUrl, pathItem] of Object.entries(spec.paths ?? {})) {
+        if (!pathItem) {
+            continue;
+        }
+        for (const method of m365_spec_parser_1.ConstantString.AllOperationMethods) {
+            const operation = isRecord(pathItem) ? pathItem[method] : undefined;
+            if (isOperationObject(operation)) {
+                operations.push({
+                    pathUrl,
+                    method,
+                    operation,
+                    auth: m365_spec_parser_1.Utils.getAuthArray(operation.security, spec).length > 0,
+                });
+            }
+        }
+    }
+    return operations;
+}
+async function updateInstructions(spec, language, appFolder) {
+    if (!supportedLanguages.includes(language)) {
+        return;
+    }
+    const emptyArgs = `{ "path": null, "body": null, "query": null }`;
+    const description = spec.info.description ? `. ${spec.info.description}` : ".";
+    const prompt = `The following is a conversation with an AI assistant.\n` +
+        `The assistant can help to call APIs for the open api spec file${description}\n` +
+        `If the API doesn't require parameters, invoke it with default JSON object ${emptyArgs}.\n\n`;
+    await fs_extra_1.default.writeFile(path_1.default.join(appFolder, "instructions.txt"), prompt, "utf8");
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+async function updateAdaptiveCards(operations, language, destinationPath) {
+    const warnings = [];
+    if (!supportedLanguages.includes(language)) {
+        return warnings;
+    }
+    const cardsFolder = path_1.default.join(destinationPath, "src", "adaptiveCards");
+    await fs_extra_1.default.ensureDir(cardsFolder);
+    for (const item of operations) {
+        const id = operationId(item.operation);
+        const name = id.replace(/[^a-zA-Z0-9]/g, "_");
+        try {
+            const [card, jsonPath, jsonData, generateWarnings] = m365_spec_parser_1.AdaptiveCardGenerator.generateAdaptiveCard(item.operation, true, 5);
+            if (jsonPath !== "$" &&
+                isRecord(card) &&
+                Array.isArray(card.body) &&
+                isRecord(card.body[0]) &&
+                card.body[0].$data) {
+                card.body[0].$data = `\${${jsonPath}}`;
+            }
+            await fs_extra_1.default.writeFile(path_1.default.join(cardsFolder, `${name}.json`), JSON.stringify(card, null, 2));
+            await fs_extra_1.default.writeFile(path_1.default.join(cardsFolder, `${name}.data.json`), JSON.stringify(jsonData, null, 2));
+            for (const warning of generateWarnings) {
+                warnings.push({
+                    type: m365_spec_parser_1.WarningType.GenerateJsonDataFailed,
+                    content: util.format("Failed to create the adaptive card mock data for API '%s': %s. Mitigation: Not required but you can manually add it to the adaptiveCards folder.", id, warning.content),
+                    data: id,
+                });
+            }
+        }
+        catch (error) {
+            warnings.push({
+                type: m365_spec_parser_1.WarningType.GenerateCardFailed,
+                content: (0, localizeUtils_1.getLocalizedString)("core.copilotPlugin.scaffold.summary.warning.generate.ac.failed", id, errorMessage(error)),
+                data: id,
+            });
+        }
+    }
+    return warnings;
+}
+function filteredSchema(value) {
+    if (!isRecord(value)) {
+        return {};
+    }
+    const result = {};
+    if (typeof value.type === "string") {
+        result.type = value.type;
+    }
+    if (typeof value.description === "string") {
+        result.description = value.description;
+    }
+    if (value.type === "object" && isRecord(value.properties)) {
+        const properties = {};
+        for (const [name, property] of Object.entries(value.properties)) {
+            properties[name] = filteredSchema(property);
+        }
+        result.properties = properties;
+        if (Array.isArray(value.required)) {
+            result.required = value.required.filter((name) => typeof name === "string");
+        }
+    }
+    else if (value.type === "array" && value.items !== undefined) {
+        result.items = filteredSchema(value.items);
+    }
+    return result;
+}
+function functionParameters(operation) {
+    const properties = {};
+    const required = [];
+    for (const parameter of operation.parameters ?? []) {
+        if (!isRecord(parameter) ||
+            typeof parameter.name !== "string" ||
+            typeof parameter.in !== "string") {
+            continue;
+        }
+        const parameterGroup = properties[parameter.in] ?? {
+            type: "object",
+            properties: {},
+            required: [],
+        };
+        const groupProperties = parameterGroup.properties;
+        const groupRequired = parameterGroup.required;
+        if (!isRecord(groupProperties) || !Array.isArray(groupRequired)) {
+            continue;
+        }
+        groupProperties[parameter.name] = {
+            ...filteredSchema(parameter.schema),
+            description: typeof parameter.description === "string" ? parameter.description : "",
+        };
+        if (parameter.required === true) {
+            groupRequired.push(parameter.name);
+            if (!required.includes(parameter.in)) {
+                required.push(parameter.in);
+            }
+        }
+        properties[parameter.in] = parameterGroup;
+    }
+    const requestBody = operation.requestBody;
+    if (isRecord(requestBody) && isRecord(requestBody.content)) {
+        const jsonContent = requestBody.content["application/json"];
+        if (isRecord(jsonContent) && isRecord(jsonContent.schema)) {
+            properties.body = {
+                ...filteredSchema(jsonContent.schema),
+                description: typeof requestBody.description === "string" ? requestBody.description : "",
+            };
+            if (requestBody.required === true) {
+                required.push("body");
+            }
+        }
+    }
+    return { type: "object", properties, required };
+}
+async function updateFunctions(operations, appFolder) {
+    const functions = {};
+    for (const item of operations) {
+        const id = operationId(item.operation);
+        functions[id] = {
+            name: id,
+            description: item.operation.description ?? item.operation.summary,
+            parameters: functionParameters(item.operation),
+        };
+    }
+    await fs_extra_1.default.writeFile(path_1.default.join(appFolder, "functions.json"), JSON.stringify(functions, null, 2));
+}
+const functionDefinitionCode = {
+    javascript: `.function(
+      functionDefs.{{operationId}}.name,
+      functionDefs.{{operationId}}.description,
+      functionDefs.{{operationId}}.parameters,
+      async (parameter) => {
+        const result = await functionHandlers.{{operationId}}Handler(parameter);
+        if(result) {
+          await send(result);
+          return "result showed";
+        } else {
+          return "no result";
+        }
+      }
+  )`,
+    typescript: `.function(
+      functionDefs.{{operationId}}.name,
+      functionDefs.{{operationId}}.description,
+      functionDefs.{{operationId}}.parameters,
+      async (parameter) => {
+        const result = await functionHandlers.{{operationId}}Handler(parameter);
+        if(result) {
+          await send(result);
+          return "result showed";
+        } else {
+          return "no result";
+        }
+      }
+  )`,
+    python: `.with_function(
+      Function(
+            name=function_defs["{{operationId}}"]["name"],
+            description=function_defs["{{operationId}}"]["description"],
+            parameter_schema=function_defs["{{operationId}}"]["parameters"],
+            handler=make_handler({{operationId}}, ctx)
+      )
+    )`,
+};
+const functionHandlerCode = {
+    javascript: `const {{operationId}}Handler = async (
+  parameters
+) => {
+  const client = await api.getClient();
+  // Add authentication configuration for the client
+  const apiPath = client.paths["{{pathUrl}}"];
+  if (apiPath && apiPath.{{method}}) {
+    const result = await apiPath.{{method}}(parameters.path, parameters.body, {
+      params: parameters.query,
+    });
+    if (!result || !result.data) {
+      throw new Error("Get empty result from api call.");
+    }
+    const cardName = "{{operationId}}".replace(/[^a-zA-Z0-9]/g, "_");
+    const cardTemplatePath = path.join(__dirname, '../adaptiveCards', cardName + '.json');
+    if (await fs.exists(cardTemplatePath)){
+      const card = generateAdaptiveCard(cardTemplatePath, result);
+      return card;
+    } else {
+      return JSON.stringify(result.data);
+    }
+  } else {
+    return "";
+  }
+
+};
+
+module.exports = { {{operationId}}Handler };`,
+    typescript: `export const {{operationId}}Handler = async (
+  parameter: any
+) => {
+  const client = await api.getClient();
+  // Add authentication configuration for the client
+  const apiPath = client.paths["{{pathUrl}}"];
+  if (apiPath && apiPath.{{method}}) {
+    const result = await apiPath.{{method}}(parameter.path, parameter.body, {
+      params: parameter.query,
+    });
+    if (!result || !result.data) {
+      throw new Error("Get empty result from api call.");
+    }
+    const cardName = "{{operationId}}".replace(/[^a-zA-Z0-9]/g, "_");
+    const cardTemplatePath = path.join(__dirname, '../adaptiveCards', cardName + '.json');
+    if (await fs.exists(cardTemplatePath)){
+      const card = generateAdaptiveCard(cardTemplatePath, result);
+      return card;
+    } else {
+      return JSON.stringify(result.data);
+    }
+  } else {
+    return "";
+  }
+    
+};`,
+    python: `async def {{operationId}}(
+  parameters,
+):
+  path = getattr(parameters, "path", {})
+  body = getattr(parameters, "body", None)
+  query = getattr(parameters, "query", {}) or {}
+  resp = client.{{operationId}}(**path, json=body, _headers={}, _params=query, _cookies={})
+
+  if resp.status_code != 200:
+    return resp.reason
+  else:
+    card_template_path = os.path.join(current_dir, 'adaptiveCards/{{operationId}}.json')
+    if not os.path.exists(card_template_path):
+      json_resoponse_str = resp.text
+      return json_resoponse_str
+    else:
+      with open(card_template_path) as card_template_file:
+        adaptive_card_template = card_template_file.read()
+
+      renderer = AdaptiveCardRenderer(adaptive_card_template)
+
+      json_resoponse_str = resp.text
+      rendered_card_str = renderer.render(json_resoponse_str)
+      rendered_card_json = json.loads(rendered_card_str)
+      return AdaptiveCard.model_validate(rendered_card_json)
+  `,
+};
+function renderCode(template, item) {
+    const id = operationId(item.operation);
+    return template
+        .replace(/{{operationId}}/g, id)
+        .replace(/{{pathUrl}}/g, item.pathUrl)
+        .replace(/{{method}}/g, item.method);
+}
+async function updateJavaScriptOrTypeScript(operations, language, destinationPath, openapiSpecFileName) {
+    const isJavaScript = language === constants_1.ProgrammingLanguage.JS;
+    const appFolder = path_1.default.join(destinationPath, "src", "app");
+    const appPath = path_1.default.join(appFolder, isJavaScript ? "app.js" : "app.ts");
+    const handlersPath = path_1.default.join(appFolder, isJavaScript ? "handlers.js" : "handlers.ts");
+    const definitionTemplate = isJavaScript
+        ? functionDefinitionCode.javascript
+        : functionDefinitionCode.typescript;
+    const handlerTemplate = isJavaScript
+        ? functionHandlerCode.javascript
+        : functionHandlerCode.typescript;
+    const definitions = operations.map((item) => renderCode(definitionTemplate, item));
+    const handlers = operations.map((item) => {
+        const withAuth = item.auth
+            ? handlerTemplate.replace("// Add authentication configuration for the client", "addAuthConfig(client);")
+            : handlerTemplate.replace("// Add authentication configuration for the client", "");
+        return renderCode(withAuth, item);
+    });
+    const app = await fs_extra_1.default.readFile(appPath, "utf8");
+    await fs_extra_1.default.writeFile(appPath, app.replace("// Replace with function definition code", `${definitions.join("\n")};`));
+    const handlersFile = await fs_extra_1.default.readFile(handlersPath, "utf8");
+    await fs_extra_1.default.writeFile(handlersPath, handlersFile
+        .replace("{{OPENAPI_SPEC_PATH}}", openapiSpecFileName)
+        .replace("// Replace with function handler code", handlers.join("\t\t\n")));
+}
+async function updatePython(operations, destinationPath, openapiSpecFileName) {
+    const appPath = path_1.default.join(destinationPath, "src", "app.py");
+    const handlersPath = path_1.default.join(destinationPath, "src", "handlers.py");
+    const definitions = operations.map((item) => renderCode(functionDefinitionCode.python, item));
+    const handlers = operations.map((item) => renderCode(functionHandlerCode.python, item));
+    const operationIds = operations.map((item) => operationId(item.operation));
+    const app = await fs_extra_1.default.readFile(appPath, "utf8");
+    await fs_extra_1.default.writeFile(appPath, app
+        .replace("// Replace with function definition code", `prompt${definitions.join("")}`)
+        .replace("//Replace with functions to be imported", operationIds.join(", ")));
+    const handlersFile = await fs_extra_1.default.readFile(handlersPath, "utf8");
+    await fs_extra_1.default.writeFile(handlersPath, handlersFile
+        .replace("{{OPENAPI_SPEC_PATH}}", openapiSpecFileName)
+        .replace("// Replace with function handler code", handlers.join("\t\t\n")));
+}
+async function updateCode(operations, language, destinationPath, openapiSpecFileName) {
+    if (language === constants_1.ProgrammingLanguage.PY) {
+        await updatePython(operations, destinationPath, openapiSpecFileName);
+    }
+    else if (language === constants_1.ProgrammingLanguage.JS || language === constants_1.ProgrammingLanguage.TS) {
+        await updateJavaScriptOrTypeScript(operations, language, destinationPath, openapiSpecFileName);
+    }
+}
+async function updatePromptSuggestions(operations, destinationPath) {
+    const commands = operations
+        .map((item) => item.operation.summary ?? item.operation.description)
+        .filter((description) => description !== undefined)
+        .slice(0, 10)
+        .map((description) => ({
+        title: description.slice(0, 32),
+        description: description.slice(0, 128),
+    }));
+    const manifest = await teamsfx_api_1.TeamsManifestWrapper.read(path_1.default.join(destinationPath, teamsfx_api_1.AppPackageFolderName, teamsfx_api_1.ManifestTemplateFileName));
+    manifest.setFirstBotCommandSuggestions(commands, featureFlags_1.featureFlagManager.getBooleanValue(featureFlags_1.FeatureFlags.CEAEnabled));
+    await manifest.save();
+}
+/** Generate the post-render Teams AI files declared by the custom API scenario. */
+async function generateTeamsAiCustomApiFiles(spec, language, destinationPath, openapiSpecFileName) {
+    const appFolder = path_1.default.join(destinationPath, "src", language === constants_1.ProgrammingLanguage.PY ? "" : "app");
+    await fs_extra_1.default.ensureDir(appFolder);
+    await updateInstructions(spec, language, appFolder);
+    const operations = parseOperations(spec);
+    const warnings = await updateAdaptiveCards(operations, language, destinationPath);
+    await updateFunctions(operations, appFolder);
+    await updateCode(operations, language, destinationPath, openapiSpecFileName);
+    await updatePromptSuggestions(operations, destinationPath);
+    return warnings;
+}
+//# sourceMappingURL=openApiCustomApi.js.map

package/build/v4/runtime/steps/openApiCustomApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiCustomApi.js","sourceRoot":"","sources":["../../../../src/v4/runtime/steps/openApiCustomApi.ts"],"names":[],"mappings":"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"}

package/build/v4/runtime/whitelist.d.ts

@@ -0,0 +1,41 @@
+import { ExpressionRuntimePort, WhitelistFn } from "../expression/evaluateExpression";
+/** Derive a stable MCP server namespace from a URL host. */
+export declare function deriveMcpServerName(url: string): string;
+/** Whitelist fn `mcpNamespace(url)` — the rendered `ai-plugin.json` namespace. */
+export declare const mcpNamespace: WhitelistFn;
+/** Whitelist fn `mcpAuthRef(url)` for the deferred auth env-ref placeholder. */
+export declare const mcpAuthRef: WhitelistFn;
+/** Whitelist fn `safeProjectNameLowerCase(appName)` for package names. */
+export declare const safeProjectNameLowerCase: WhitelistFn;
+/** Whitelist fn `pathDelimiter()` for PATH-like launch configuration values. */
+export declare const pathDelimiter: WhitelistFn;
+/** Whitelist fn `contains(csv, item)` — `"true"` when a multiSelect answer selects `item`. */
+export declare const contains: WhitelistFn;
+/** Whitelist fn `officeAddinManifestScope(host)` — the single-host manifest scope literal. */
+export declare const officeAddinManifestScope: WhitelistFn;
+/**
+ * Whitelist fn `officeAddinManifestScopes(csv)` — the multiSelect host set rendered
+ * as the inner body of a manifest `scopes` JSON array. Pre-joins so the array stays
+ * valid for any host subset (v3 parity: no trailing-comma breakage).
+ */
+export declare const officeAddinManifestScopes: WhitelistFn;
+/**
+ * Whitelist fn `officeAddinLaunchConfigurations(csv)` — the inner body of the
+ * `.vscode/launch.json` `configurations` array, limited to the selected hosts.
+ */
+export declare const officeAddinLaunchConfigurations: WhitelistFn;
+/**
+ * Whitelist fn `officeAddinLaunchCompounds(csv)` — the inner body of the
+ * `.vscode/launch.json` `compounds` array, limited to the selected hosts.
+ */
+export declare const officeAddinLaunchCompounds: WhitelistFn;
+/**
+ * Whitelist fn `officeAddinDebugScripts(csv)` — the `start:desktop:<host>` npm
+ * script entries for the selected hosts, each on its own line with a trailing comma.
+ */
+export declare const officeAddinDebugScripts: WhitelistFn;
+/** Whitelist fn `officeAddinDebugApp(csv)` — the default `app_to_debug` host. */
+export declare const officeAddinDebugApp: WhitelistFn;
+/** Build the real pure expression runtime port. */
+export declare function createExpressionPort(flagReader?: (name: string) => boolean): ExpressionRuntimePort;
+//# sourceMappingURL=whitelist.d.ts.map

package/build/v4/runtime/whitelist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whitelist.d.ts","sourceRoot":"","sources":["../../../src/v4/runtime/whitelist.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAStF,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASvD;AAED,kFAAkF;AAClF,eAAO,MAAM,YAAY,EAAE,WAA+D,CAAC;AAE3F,gFAAgF;AAChF,eAAO,MAAM,UAAU,EAAE,WAC6C,CAAC;AAEvE,0EAA0E;AAC1E,eAAO,MAAM,wBAAwB,EAAE,WACa,CAAC;AAErD,gFAAgF;AAChF,eAAO,MAAM,aAAa,EAAE,WAA0C,CAAC;AAqBvE,8FAA8F;AAC9F,eAAO,MAAM,QAAQ,EAAE,WACqB,CAAC;AAE7C,8FAA8F;AAC9F,eAAO,MAAM,wBAAwB,EAAE,WAC+B,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,WAKvC,CAAC;AA8CF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,EAAE,WAiC7C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,WAgBxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,WAOtB,CAAC;AAEjB,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,EAAE,WACL,CAAC;AAsB9B,mDAAmD;AACnD,wBAAgB,oBAAoB,CAClC,UAAU,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAuB,GACpD,qBAAqB,CAKvB"}

package/build/v4/runtime/whitelist.js

@@ -0,0 +1,211 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.officeAddinDebugApp = exports.officeAddinDebugScripts = exports.officeAddinLaunchCompounds = exports.officeAddinLaunchConfigurations = exports.officeAddinManifestScopes = exports.officeAddinManifestScope = exports.contains = exports.pathDelimiter = exports.safeProjectNameLowerCase = exports.mcpAuthRef = exports.mcpNamespace = void 0;
+exports.deriveMcpServerName = deriveMcpServerName;
+exports.createExpressionPort = createExpressionPort;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const featureFlags_1 = require("../../common/featureFlags");
+/** Closed v4 render-context function whitelist. See build-render-context spec. */
+const NAMESPACE_FALLBACK = "mcpServer";
+const NAMESPACE_MAX_LENGTH = 10;
+/** Derive a stable MCP server namespace from a URL host. */
+function deriveMcpServerName(url) {
+    let host = "";
+    try {
+        host = new URL(url).host;
+    }
+    catch {
+        host = "";
+    }
+    const alphanumeric = host.replace(/[^a-zA-Z0-9]/g, "").substring(0, NAMESPACE_MAX_LENGTH);
+    return alphanumeric.length > 0 ? alphanumeric : NAMESPACE_FALLBACK;
+}
+/** Whitelist fn `mcpNamespace(url)` — the rendered `ai-plugin.json` namespace. */
+const mcpNamespace = (url) => deriveMcpServerName(url);
+exports.mcpNamespace = mcpNamespace;
+/** Whitelist fn `mcpAuthRef(url)` for the deferred auth env-ref placeholder. */
+const mcpAuthRef = (url) => "${{MCP_DA_AUTH_ID_" + deriveMcpServerName(url).toUpperCase() + "}}";
+exports.mcpAuthRef = mcpAuthRef;
+/** Whitelist fn `safeProjectNameLowerCase(appName)` for package names. */
+const safeProjectNameLowerCase = (appName) => appName.replace(/[^0-9a-zA-Z]/g, "").toLowerCase();
+exports.safeProjectNameLowerCase = safeProjectNameLowerCase;
+/** Whitelist fn `pathDelimiter()` for PATH-like launch configuration values. */
+const pathDelimiter = () => path.delimiter;
+exports.pathDelimiter = pathDelimiter;
+/** Office add-in manifest requirement scope for each host id. */
+const OFFICE_ADDIN_HOST_SCOPE = {
+    outlook: "mail",
+    excel: "workbook",
+    word: "document",
+    powerpoint: "presentation",
+};
+/** Stable host order for a deterministic multi-scope render. */
+const OFFICE_ADDIN_HOST_ORDER = ["mail", "workbook", "document", "presentation"];
+/** Parse a comma-joined multiSelect answer into its selected ids. */
+function parseCsv(csv) {
+    return csv
+        .split(",")
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+}
+/** Whitelist fn `contains(csv, item)` — `"true"` when a multiSelect answer selects `item`. */
+const contains = (csv, item) => parseCsv(csv).includes(item) ? "true" : "";
+exports.contains = contains;
+/** Whitelist fn `officeAddinManifestScope(host)` — the single-host manifest scope literal. */
+const officeAddinManifestScope = (host) => `"${OFFICE_ADDIN_HOST_SCOPE[host] ?? OFFICE_ADDIN_HOST_SCOPE.word}"`;
+exports.officeAddinManifestScope = officeAddinManifestScope;
+/**
+ * Whitelist fn `officeAddinManifestScopes(csv)` — the multiSelect host set rendered
+ * as the inner body of a manifest `scopes` JSON array. Pre-joins so the array stays
+ * valid for any host subset (v3 parity: no trailing-comma breakage).
+ */
+const officeAddinManifestScopes = (csv) => {
+    const selected = new Set(parseCsv(csv).map((host) => OFFICE_ADDIN_HOST_SCOPE[host]));
+    const scopes = OFFICE_ADDIN_HOST_ORDER.filter((scope) => selected.has(scope));
+    const body = scopes.length > 0 ? scopes : [OFFICE_ADDIN_HOST_SCOPE.word];
+    return body.map((scope) => `"${scope}"`).join(",\n                    ");
+};
+exports.officeAddinManifestScopes = officeAddinManifestScopes;
+/**
+ * Debug launch surface for the Office task-pane template.
+ *
+ * These functions pre-join the `.vscode/launch.json` and `package.json` host
+ * entries instead of the `{{#HostOutlook}}` Mustache sections the manifest uses.
+ * The manifest's optional blocks each sit next to a guaranteed-present sibling
+ * (the default permission / runtime / ribbon), so a section can carry its own
+ * trailing comma safely. The launch configs, compounds, and debug scripts are
+ * *fully* optional arrays — every element depends on a host that may be
+ * deselected — so there is no anchor element to absorb a trailing comma, and
+ * flat Mustache cannot suppress the comma after the last selected block. A
+ * comma `join` over the selected hosts is the only comma-correct option, which
+ * only a function (not a template) can express.
+ *
+ * This mirrors how v3 handles the same files: rather than editing JSON text, v3
+ * scaffolds all hosts and then `Array.filter`s the parsed `configurations` /
+ * `compounds` / `scripts` and re-serializes (officeAddin generator `post`). v4
+ * has no post-render file mutation, so the equivalent filtered-list-to-string
+ * happens here at render time instead.
+ */
+const OFFICE_ADDIN_HOST_LABEL = {
+    word: "Word",
+    excel: "Excel",
+    powerpoint: "PowerPoint",
+    outlook: "Outlook",
+};
+const OFFICE_ADDIN_LAUNCH_HOST_ORDER = ["word", "excel", "powerpoint", "outlook"];
+/** Selected hosts in canonical order, defaulting to word when nothing is selected. */
+function selectedLaunchHosts(csv) {
+    const selected = new Set(parseCsv(csv));
+    const hosts = OFFICE_ADDIN_LAUNCH_HOST_ORDER.filter((host) => selected.has(host));
+    return hosts.length > 0 ? hosts : ["word"];
+}
+/** Indent a multi-line JSON fragment so it nests under the given column. */
+function indentJson(json, spaces) {
+    const pad = " ".repeat(spaces);
+    return json
+        .split("\n")
+        .map((line) => (line.length > 0 ? pad + line : line))
+        .join("\n");
+}
+/**
+ * Whitelist fn `officeAddinLaunchConfigurations(csv)` — the inner body of the
+ * `.vscode/launch.json` `configurations` array, limited to the selected hosts.
+ */
+const officeAddinLaunchConfigurations = (csv) => {
+    const blocks = selectedLaunchHosts(csv).flatMap((host) => {
+        const label = OFFICE_ADDIN_HOST_LABEL[host];
+        return [
+            `{
+  "name": "${label} Desktop Host",
+  "type": "node-terminal",
+  "request": "launch",
+  "command": "npm run start:desktop:${host}",
+  "cwd": "\${workspaceFolder}",
+  "preLaunchTask": "Install",
+  "postDebugTask": "Stop Debug",
+  "presentation": {
+    "hidden": true
+  }
+}`,
+            `{
+  "name": "${label} Desktop Attach (Edge Chromium)",
+  "type": "msedge",
+  "request": "attach",
+  "port": 9229,
+  "timeout": 600000,
+  "webRoot": "\${workspaceRoot}",
+  "presentation": {
+    "hidden": true
+  }
+}`,
+        ];
+    });
+    return blocks
+        .map((block) => indentJson(block, 4))
+        .join(",\n")
+        .trimStart();
+};
+exports.officeAddinLaunchConfigurations = officeAddinLaunchConfigurations;
+/**
+ * Whitelist fn `officeAddinLaunchCompounds(csv)` — the inner body of the
+ * `.vscode/launch.json` `compounds` array, limited to the selected hosts.
+ */
+const officeAddinLaunchCompounds = (csv) => {
+    const blocks = selectedLaunchHosts(csv).map((host) => {
+        const label = OFFICE_ADDIN_HOST_LABEL[host];
+        return `{
+  "name": "${label} Desktop (Edge Chromium)",
+  "configurations": [
+    "${label} Desktop Host",
+    "${label} Desktop Attach (Edge Chromium)"
+  ],
+  "stopAll": true
+}`;
+    });
+    return blocks
+        .map((block) => indentJson(block, 4))
+        .join(",\n")
+        .trimStart();
+};
+exports.officeAddinLaunchCompounds = officeAddinLaunchCompounds;
+/**
+ * Whitelist fn `officeAddinDebugScripts(csv)` — the `start:desktop:<host>` npm
+ * script entries for the selected hosts, each on its own line with a trailing comma.
+ */
+const officeAddinDebugScripts = (csv) => selectedLaunchHosts(csv)
+    .map((host) => `    "start:desktop:${host}": "office-addin-debugging start appPackage/manifest.json desktop --app ${host}",`)
+    .join("\n")
+    .trimStart();
+exports.officeAddinDebugScripts = officeAddinDebugScripts;
+/** Whitelist fn `officeAddinDebugApp(csv)` — the default `app_to_debug` host. */
+const officeAddinDebugApp = (csv) => selectedLaunchHosts(csv)[0];
+exports.officeAddinDebugApp = officeAddinDebugApp;
+/** The closed function whitelist; an author cannot extend it (ADR-0016 decision 3). */
+const WHITELIST = new Map([
+    ["mcpNamespace", exports.mcpNamespace],
+    ["mcpAuthRef", exports.mcpAuthRef],
+    ["safeProjectNameLowerCase", exports.safeProjectNameLowerCase],
+    ["pathDelimiter", exports.pathDelimiter],
+    ["contains", exports.contains],
+    ["officeAddinManifestScope", exports.officeAddinManifestScope],
+    ["officeAddinManifestScopes", exports.officeAddinManifestScopes],
+    ["officeAddinLaunchConfigurations", exports.officeAddinLaunchConfigurations],
+    ["officeAddinLaunchCompounds", exports.officeAddinLaunchCompounds],
+    ["officeAddinDebugScripts", exports.officeAddinDebugScripts],
+    ["officeAddinDebugApp", exports.officeAddinDebugApp],
+]);
+/** Default feature-flag reader: an env-backed truthy check (`"true"` / `"1"`). */
+function envFlagReader(name) {
+    return (0, featureFlags_1.readBooleanFeatureFlag)(name);
+}
+/** Build the real pure expression runtime port. */
+function createExpressionPort(flagReader = envFlagReader) {
+    return {
+        functions: (name) => WHITELIST.get(name),
+        flags: (name) => flagReader(name),
+    };
+}
+//# sourceMappingURL=whitelist.js.map