@microsoft/teamsfx-core 3.1.0 → 3.1.1

package/build/v4/model/dataModel.d.ts

@@ -0,0 +1,27 @@
+/** Shared v4 data nouns that cross operation boundaries. */
+/** Resolved answers, including provider `derived.<id>.<key>` values. */
+export type Answers = Record<string, string | string[]>;
+/** Caller-injected identifier floor such as `appName` and `language`. */
+export type CallerFloor = Record<string, string>;
+/** Render variables used by content templates and step `with` values. */
+export type RenderVars = Record<string, string | string[]>;
+/** Names which legacy-layout template inside the package to open. */
+export interface TemplateLocator {
+    language: string;
+    scenario: string;
+}
+/** Names which declarative package inside the channel zip to open. */
+export interface DeclarativeLocator {
+    /** The package namespace: `create` or `modify`. */
+    kind: "create" | "modify";
+    /** The package id within the kind, e.g. `da/mcp-server`. */
+    templateId: string;
+}
+/** One file from the located template content root. */
+export interface TemplateFileEntry {
+    /** Path relative to the located template's content root, forward-slash normalized. */
+    path: string;
+    /** The file's raw bytes, verbatim — unrendered, `.tpl` suffix intact. */
+    data: Buffer;
+}
+//# sourceMappingURL=dataModel.d.ts.map

package/build/v4/model/dataModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataModel.d.ts","sourceRoot":"","sources":["../../../src/v4/model/dataModel.ts"],"names":[],"mappings":"AAGA,4DAA4D;AAI5D,wEAAwE;AACxE,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;AAIxD,yEAAyE;AACzE,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD,yEAAyE;AACzE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;AAI3D,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;CACd"}

package/build/v4/model/dataModel.js

@@ -0,0 +1,5 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=dataModel.js.map

package/build/v4/model/dataModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataModel.js","sourceRoot":"","sources":["../../../src/v4/model/dataModel.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC"}

package/build/v4/pipeline/runScaffoldPipeline.d.ts

@@ -0,0 +1,101 @@
+import { FxError, Warning } from "@microsoft/teamsfx-api";
+import { Result } from "neverthrow";
+import { ConditionalExpression } from "../expression/evaluateExpression";
+import { RenderVars, TemplateFileEntry } from "../model/dataModel";
+/** `Warning.type` for a render path left untouched because the target already had that file. */
+export declare const EXISTING_FILE_SKIPPED_WARNING = "v4ExistingFileSkipped";
+/** A resolved step parameter value. */
+export type ParamValue = string | boolean | string[];
+/** A step's author-supplied `with` block, or its resolved form. */
+export type StepParams = Record<string, ParamValue>;
+/** One `pipeline.steps` entry. `produces` is reserved for future cross-step data flow. */
+export interface PipelineStep extends ConditionalExpression {
+    step: string;
+    with?: StepParams;
+    produces?: string[];
+}
+/** One render-phase file filter. Paths are target-relative output paths after `.tpl` suffix stripping. */
+export interface RenderFilter extends ConditionalExpression {
+    exclude: string[];
+}
+/** Render-phase controls declared by `pipeline.json`. */
+export interface PipelineRender {
+    filters?: RenderFilter[];
+}
+/** A parsed, schema-valid `pipeline.json`. */
+export interface Pipeline {
+    pipeline: string;
+    comment?: string;
+    render?: PipelineRender;
+    steps: PipelineStep[];
+}
+/** The output directory plus its pre-run file snapshot. */
+export interface TargetDir {
+    path: string;
+    existing: string[];
+}
+/** A render-phase path skipped because it already existed. */
+export interface SkippedFile {
+    path: string;
+    warning: string;
+}
+/** The result of a scaffold run. */
+export interface ScaffoldOutcome {
+    written: string[];
+    filtered: string[];
+    skipped: SkippedFile[];
+    stepsRun: string[];
+    stepsSkipped: string[];
+}
+/** A resolved named orchestration. */
+export interface Orchestration {
+    name: string;
+}
+/** Minimal manifest wrapper face needed by registered steps. */
+export interface ManifestWrapper {
+    registerDeclarativeAgentAction(teamsManifestPath: string, pluginManifestPath: string): Result<void, FxError>;
+    setSensitivityLabel?(path: string, id: string): Result<void, FxError>;
+}
+/** The capabilities the executor hands each registered step's `apply`. */
+export interface StepContext {
+    write(path: string, data: Buffer): void;
+    /** Persist regular and `SECRET_*` values through the runtime's environment boundary. */
+    writeEnvironment(environment: string, values: Record<string, string>): Promise<Result<void, FxError>>;
+    manifestWrapper(kind: string): ManifestWrapper;
+    /** Read current bytes at a target path, or `undefined` when absent. */
+    read(path: string): Buffer | undefined;
+    /**
+     * Emit a localized, user-visible warning without failing the pipeline. The `type` is what
+     * lets a surface decide what to do with it (summary line, notification, log only), so it
+     * travels with the message instead of being dropped at the boundary.
+     */
+    warn?(warning: Warning): void;
+}
+/** An engine-registered, whitelist-dispatched post-render step. */
+export interface RegisteredStep {
+    validateParams(resolved: StepParams): string | undefined;
+    apply(resolved: StepParams, ctx: StepContext): Result<void, FxError> | Promise<Result<void, FxError>>;
+}
+/** Narrow pipeline port; `render` is the single Mustache surface for paths and values. */
+export interface PipelineRuntimePort {
+    pipelineRegistry(pipelineName: string): Orchestration | undefined;
+    stepRegistry(stepName: string): RegisteredStep | undefined;
+    evalWhen(expr: string, renderVars: RenderVars): Result<boolean, FxError>;
+    render(mustache: string, renderVars: RenderVars): Result<string, FxError>;
+    manifestWrapper(kind: string): ManifestWrapper;
+    warn?(warning: Warning): void;
+    write(path: string, data: Buffer): void;
+    writeEnvironment(environment: string, values: Record<string, string>): Promise<Result<void, FxError>>;
+    /** Current bytes at a path, or `undefined` when absent. */
+    read(path: string): Buffer | undefined;
+}
+/** `SystemError` names for engine-side pipeline breaks. */
+export declare const PIPELINE_UNKNOWN_PIPELINE = "PipelineUnknownPipeline";
+export declare const PIPELINE_UNKNOWN_STEP = "PipelineUnknownStep";
+export declare const PIPELINE_PARAMS_VIOLATION = "PipelineParamsViolation";
+export declare const PIPELINE_CROSS_STEP_REFERENCE = "PipelineCrossStepReference";
+/** `UserError` name for a non-empty create target. */
+export declare const REQUIRE_EMPTY_TARGET = "RequireEmptyTarget";
+/** Execute one template package's pipeline against a resolved render context. */
+export declare function runScaffoldPipeline(pipeline: Pipeline, content: TemplateFileEntry[], renderVars: RenderVars, targetDir: TargetDir, port: PipelineRuntimePort): Promise<Result<ScaffoldOutcome, FxError>>;
+//# sourceMappingURL=runScaffoldPipeline.d.ts.map

package/build/v4/pipeline/runScaffoldPipeline.d.ts.map

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

package/build/v4/pipeline/runScaffoldPipeline.js

@@ -0,0 +1,212 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REQUIRE_EMPTY_TARGET = exports.PIPELINE_CROSS_STEP_REFERENCE = exports.PIPELINE_PARAMS_VIOLATION = exports.PIPELINE_UNKNOWN_STEP = exports.PIPELINE_UNKNOWN_PIPELINE = exports.EXISTING_FILE_SKIPPED_WARNING = void 0;
+exports.runScaffoldPipeline = runScaffoldPipeline;
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const neverthrow_1 = require("neverthrow");
+const evaluateExpression_1 = require("../expression/evaluateExpression");
+const localizeUtils_1 = require("../../common/localizeUtils");
+/** v4 scaffold pipeline executor. See the run-scaffold-pipeline spec and ADR-0017. */
+const SOURCE = "Scaffold";
+/** Built-in guard that must run before rendering so a violation writes nothing. */
+const STEP_REQUIRE_EMPTY_TARGET = "require-empty-target";
+const TPL_SUFFIX = ".tpl";
+function skipWarning(path) {
+    return (0, localizeUtils_1.getLocalizedString)("core.v4.scaffold.existingFileSkipped", path);
+}
+/** `Warning.type` for a render path left untouched because the target already had that file. */
+exports.EXISTING_FILE_SKIPPED_WARNING = "v4ExistingFileSkipped";
+/** `SystemError` names for engine-side pipeline breaks. */
+exports.PIPELINE_UNKNOWN_PIPELINE = "PipelineUnknownPipeline";
+exports.PIPELINE_UNKNOWN_STEP = "PipelineUnknownStep";
+exports.PIPELINE_PARAMS_VIOLATION = "PipelineParamsViolation";
+exports.PIPELINE_CROSS_STEP_REFERENCE = "PipelineCrossStepReference";
+/** `UserError` name for a non-empty create target. */
+exports.REQUIRE_EMPTY_TARGET = "RequireEmptyTarget";
+function systemError(name, message) {
+    return new teamsfx_api_1.SystemError({ source: SOURCE, name, message });
+}
+/** Evaluate a step's `when` (absent guard ⇒ active). */
+function whenActive(step, renderVars, port) {
+    return (0, evaluateExpression_1.evaluateConditionalWhen)(step, (expr) => port.evalWhen(expr, renderVars));
+}
+function filterActive(filter, renderVars, port) {
+    return (0, evaluateExpression_1.evaluateConditionalWhen)(filter, (expr) => port.evalWhen(expr, renderVars));
+}
+function normalizedPath(path) {
+    return path.replace(/\\/g, "/");
+}
+function matchesActiveFilter(path, filters, renderVars, port) {
+    if (filters === undefined) {
+        return (0, neverthrow_1.ok)(false);
+    }
+    for (const filter of filters) {
+        if (!filter.exclude.includes(path)) {
+            continue;
+        }
+        const active = filterActive(filter, renderVars, port);
+        if (active.isErr()) {
+            return (0, neverthrow_1.err)(active.error);
+        }
+        if (active.value) {
+            return (0, neverthrow_1.ok)(true);
+        }
+    }
+    return (0, neverthrow_1.ok)(false);
+}
+/** Resolve a step's `with`: strings render through Mustache; literals pass through. */
+function resolveParams(params, renderVars, port) {
+    const resolved = {};
+    for (const key of Object.keys(params)) {
+        const value = params[key];
+        if (typeof value === "string") {
+            // Preserve a sole multiSelect token as a typed list for step params.
+            const soleToken = value.match(/^\{\{(\w+)\}\}$/);
+            if (soleToken) {
+                const listValue = renderVars[soleToken[1]];
+                if (Array.isArray(listValue)) {
+                    resolved[key] = listValue;
+                    continue;
+                }
+            }
+            const rendered = port.render(value, renderVars);
+            if (rendered.isErr()) {
+                return (0, neverthrow_1.err)(rendered.error);
+            }
+            resolved[key] = rendered.value;
+        }
+        else {
+            // JSON literals pass through unrendered.
+            resolved[key] = value;
+        }
+    }
+    return (0, neverthrow_1.ok)(resolved);
+}
+/** Execute one template package's pipeline against a resolved render context. */
+async function runScaffoldPipeline(pipeline, content, renderVars, targetDir, port) {
+    // Unknown pipeline names are engine breaks, never silent no-ops.
+    if (!port.pipelineRegistry(pipeline.pipeline)) {
+        return (0, neverthrow_1.err)(systemError(exports.PIPELINE_UNKNOWN_PIPELINE, `Unknown pipeline '${pipeline.pipeline}'. The name is a closed engine whitelist; reaching execution with an unknown one is an engine inconsistency.`));
+    }
+    // Cross-step data flow is reserved until render vars can be updated by steps.
+    for (const step of pipeline.steps) {
+        if (step.produces !== undefined) {
+            return (0, neverthrow_1.err)(systemError(exports.PIPELINE_CROSS_STEP_REFERENCE, `Step '${step.step}' declares a forward-looking cross-step reference ('produces'); render vars are frozen before steps run, so this form is not yet supported.`));
+        }
+    }
+    // Enforce the create guard before render; record it later in declared order.
+    for (const step of pipeline.steps) {
+        if (step.step !== STEP_REQUIRE_EMPTY_TARGET) {
+            continue;
+        }
+        const active = whenActive(step, renderVars, port);
+        if (active.isErr()) {
+            return (0, neverthrow_1.err)(active.error);
+        }
+        if (active.value && targetDir.existing.length > 0) {
+            return (0, neverthrow_1.err)(new teamsfx_api_1.UserError({
+                source: SOURCE,
+                name: exports.REQUIRE_EMPTY_TARGET,
+                message: `The target folder '${targetDir.path}' is not empty. Scaffolding a new project requires an empty folder; remove the existing files or choose another folder, then try again.`,
+            }));
+        }
+    }
+    // Phase 1: render `.tpl` path/body pairs; copy non-template files verbatim.
+    const written = [];
+    const filtered = [];
+    const skipped = [];
+    for (const entry of content) {
+        if (entry.path.endsWith(TPL_SUFFIX)) {
+            const renderedPath = port.render(entry.path.slice(0, -TPL_SUFFIX.length), renderVars);
+            if (renderedPath.isErr()) {
+                return (0, neverthrow_1.err)(renderedPath.error);
+            }
+            const writePath = normalizedPath(renderedPath.value);
+            const omitted = matchesActiveFilter(writePath, pipeline.render?.filters, renderVars, port);
+            if (omitted.isErr()) {
+                return (0, neverthrow_1.err)(omitted.error);
+            }
+            if (omitted.value) {
+                filtered.push(writePath);
+                continue;
+            }
+            if (targetDir.existing.includes(writePath)) {
+                const warning = skipWarning(writePath);
+                skipped.push({ path: writePath, warning });
+                port.warn?.({ type: exports.EXISTING_FILE_SKIPPED_WARNING, content: warning });
+                continue;
+            }
+            const renderedBody = port.render(entry.data.toString("utf8"), renderVars); // AC-18
+            if (renderedBody.isErr()) {
+                return (0, neverthrow_1.err)(renderedBody.error);
+            }
+            port.write(writePath, Buffer.from(renderedBody.value, "utf8"));
+            written.push(writePath);
+        }
+        else {
+            const writePath = normalizedPath(entry.path);
+            const omitted = matchesActiveFilter(writePath, pipeline.render?.filters, renderVars, port);
+            if (omitted.isErr()) {
+                return (0, neverthrow_1.err)(omitted.error);
+            }
+            if (omitted.value) {
+                filtered.push(writePath);
+                continue;
+            }
+            if (targetDir.existing.includes(writePath)) {
+                const warning = skipWarning(writePath);
+                skipped.push({ path: writePath, warning });
+                port.warn?.({ type: exports.EXISTING_FILE_SKIPPED_WARNING, content: warning });
+                continue;
+            }
+            port.write(writePath, entry.data);
+            written.push(writePath);
+        }
+    }
+    // Phase 2 — post-render steps, in declared order.
+    const ctx = {
+        write: (path, data) => port.write(path, data),
+        writeEnvironment: (environment, values) => port.writeEnvironment(environment, values),
+        manifestWrapper: (kind) => port.manifestWrapper(kind),
+        read: (path) => port.read(path),
+        warn: port.warn,
+    };
+    const stepsRun = [];
+    const stepsSkipped = [];
+    for (const step of pipeline.steps) {
+        const active = whenActive(step, renderVars, port);
+        if (active.isErr()) {
+            return (0, neverthrow_1.err)(active.error);
+        }
+        if (step.step === STEP_REQUIRE_EMPTY_TARGET) {
+            // Already enforced before render; only record its declared-order status.
+            (active.value ? stepsRun : stepsSkipped).push(step.step);
+            continue;
+        }
+        const registered = port.stepRegistry(step.step);
+        if (!registered) {
+            return (0, neverthrow_1.err)(systemError(exports.PIPELINE_UNKNOWN_STEP, `Unknown step '${step.step}'. The reverse minEngineVersion gate (ADR-0015) guarantees every referenced step is present; an absent one is an engine inconsistency.`));
+        }
+        if (!active.value) {
+            stepsSkipped.push(step.step);
+            continue;
+        }
+        const resolved = resolveParams(step.with ?? {}, renderVars, port);
+        if (resolved.isErr()) {
+            return (0, neverthrow_1.err)(resolved.error);
+        }
+        const violation = registered.validateParams(resolved.value);
+        if (violation !== undefined) {
+            return (0, neverthrow_1.err)(systemError(exports.PIPELINE_PARAMS_VIOLATION, `Step '${step.step}' resolved parameters violate its schema: ${violation}. The build-time typed-context check (ADR-0016) should have caught this.`));
+        }
+        const applied = await registered.apply(resolved.value, ctx);
+        if (applied.isErr()) {
+            return (0, neverthrow_1.err)(applied.error);
+        }
+        stepsRun.push(step.step);
+    }
+    return (0, neverthrow_1.ok)({ written, filtered, skipped, stepsRun, stepsSkipped });
+}
+//# sourceMappingURL=runScaffoldPipeline.js.map

package/build/v4/pipeline/runScaffoldPipeline.js.map

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

package/build/v4/providers/createOptionsProviders.d.ts

@@ -0,0 +1,11 @@
+import { OptionsProvider } from "../collectInputs/collectInputs";
+import { MCPFetchResult } from "../../common/mcpToolFetcher";
+import { type ODRServer } from "../../common/odrProvider";
+import { SearchOpenAPISpecResult } from "../../common/kiotaClient";
+export declare function createMcpServerTypesProvider(localServers: () => Promise<ODRServer[]>): OptionsProvider;
+export declare function createLocalMcpServersProvider(localServers: () => Promise<ODRServer[]>): OptionsProvider;
+export declare const openApiOperationsProvider: OptionsProvider;
+export declare function createOpenApiSearchProvider(searchApiSpec: (query: string) => Promise<SearchOpenAPISpecResult[]>): OptionsProvider;
+export declare function createMcpToolsProvider(fetchTools: (serverUrl: string) => Promise<MCPFetchResult>): OptionsProvider;
+export declare function createDefaultCreateOptionsProviders(fetchTools: (serverUrl: string) => Promise<MCPFetchResult>, listLocalMcpServers: () => Promise<ODRServer[]>, searchApiSpec?: (query: string) => Promise<SearchOpenAPISpecResult[]>): Record<string, OptionsProvider>;
+//# sourceMappingURL=createOptionsProviders.d.ts.map

package/build/v4/providers/createOptionsProviders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createOptionsProviders.d.ts","sourceRoot":"","sources":["../../../src/v4/providers/createOptionsProviders.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AA2BnE,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,GACvC,eAAe,CAejB;AAeD,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,GACvC,eAAe,CAajB;AAqCD,eAAO,MAAM,yBAAyB,EAAE,eA8CvC,CAAC;AAEF,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,EAAE,CAAC,GACnE,eAAe,CA4BjB;AAyBD,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,GACzD,eAAe,CAqDjB;AAED,wBAAgB,mCAAmC,CACjD,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,EAC1D,mBAAmB,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,EAC/C,aAAa,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,EAAE,CAA6B,GAC/F,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CASjC"}