@microsoft/teamsfx-core 3.1.4 → 3.1.5-alpha.3256bba3fe.0

package/build/component/m365/skills/skillFileSync.js

@@ -0,0 +1,256 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.synchronizeSkillFiles = synchronizeSkillFiles;
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const crypto_1 = require("crypto");
+const localizeUtils_1 = require("../../../common/localizeUtils");
+function invalidInventory() {
+    return new teamsfx_api_1.UserError({
+        source: "M365",
+        name: "InvalidSkillInventory",
+        message: (0, localizeUtils_1.getDefaultString)("error.m365.skills.invalidInventory"),
+        displayMessage: (0, localizeUtils_1.getLocalizedString)("error.m365.skills.invalidInventory"),
+    });
+}
+function validName(name) {
+    return (typeof name === "string" &&
+        name.length > 0 &&
+        name !== "." &&
+        name !== ".." &&
+        name.trim() === name &&
+        !name.endsWith(".") &&
+        !/[<>:"/\\|?*\u0000-\u001f\u007f]/.test(name));
+}
+function validId(id) {
+    return typeof id === "string" && id.trim().length > 0;
+}
+function validItem(item) {
+    return (item !== null &&
+        typeof item === "object" &&
+        validId(item.id) &&
+        validName(item.name) &&
+        (item.kind === "file" || item.kind === "folder") &&
+        validId(item.eTag) &&
+        (item.size === undefined || (Number.isSafeInteger(item.size) && item.size >= 0)));
+}
+function collisionKey(path) {
+    return path.normalize("NFC").toLowerCase();
+}
+function localInventory(files) {
+    const entries = new Map();
+    const paths = new Map();
+    for (const file of files) {
+        if (!file || typeof file.path !== "string" || !Buffer.isBuffer(file.content)) {
+            return (0, teamsfx_api_1.err)(invalidInventory());
+        }
+        const parts = file.path.split("/");
+        if (!parts.every(validName))
+            return (0, teamsfx_api_1.err)(invalidInventory());
+        let path = "";
+        for (let i = 0; i < parts.length; i++) {
+            path = path ? `${path}/${parts[i]}` : parts[i];
+            const kind = i === parts.length - 1 ? "file" : "folder";
+            const existingPath = paths.get(collisionKey(path));
+            if (existingPath !== undefined) {
+                if (existingPath !== path || kind === "file" || entries.get(path)?.kind !== "folder") {
+                    return (0, teamsfx_api_1.err)(invalidInventory());
+                }
+            }
+            else {
+                paths.set(collisionKey(path), path);
+                entries.set(path, kind === "file" ? { kind, content: file.content } : { kind });
+            }
+        }
+    }
+    return (0, teamsfx_api_1.ok)(entries);
+}
+async function remoteInventory(store, rootId) {
+    const entries = new Map();
+    const ids = new Set([rootId]);
+    const paths = new Set();
+    const folders = [{ id: rootId, path: "" }];
+    // Iterative traversal bounds the call stack even for deeply nested drafts.
+    for (let index = 0; index < folders.length; index++) {
+        const parent = folders[index];
+        const children = await store.listChildren(parent.id);
+        if (children.isErr())
+            return (0, teamsfx_api_1.err)(children.error);
+        if (!Array.isArray(children.value))
+            return (0, teamsfx_api_1.err)(invalidInventory());
+        for (const item of children.value) {
+            if (!validItem(item) || ids.has(item.id))
+                return (0, teamsfx_api_1.err)(invalidInventory());
+            const path = parent.path ? `${parent.path}/${item.name}` : item.name;
+            const key = collisionKey(path);
+            if (paths.has(key))
+                return (0, teamsfx_api_1.err)(invalidInventory());
+            paths.add(key);
+            ids.add(item.id);
+            entries.set(path, item);
+            if (item.kind === "folder")
+                folders.push({ id: item.id, path });
+        }
+    }
+    return (0, teamsfx_api_1.ok)(entries);
+}
+function quickXorHash(content) {
+    // Matches Microsoft's C# reference: circular 160-bit XOR, 11-bit stride,
+    // followed by little-endian length XOR into bytes 12..19.
+    // https://learn.microsoft.com/onedrive/developer/code-snippets/quickxorhash
+    const hash = Buffer.alloc(20);
+    for (let i = 0; i < Math.min(content.length, 160); i++) {
+        let byte = 0;
+        for (let j = i; j < content.length; j += 160)
+            byte ^= content[j];
+        const shift = (i * 11) % 160;
+        const index = Math.floor(shift / 8);
+        const offset = shift % 8;
+        hash[index] ^= byte << offset;
+        hash[(index + 1) % hash.length] ^= byte >>> (8 - offset);
+    }
+    const length = Buffer.alloc(8);
+    length.writeBigUInt64LE(BigInt(content.length));
+    for (let i = 0; i < length.length; i++)
+        hash[12 + i] ^= length[i];
+    return hash.toString("base64");
+}
+function sameContent(item, content) {
+    if (item.size !== content.length)
+        return false;
+    // These are change detectors, never credential/security primitives. Prefer
+    // SHA-1 when usable; a mismatch must not be overridden by a weaker hash.
+    const sha1 = item.hashes?.sha1Hash;
+    if (typeof sha1 === "string" && /^[a-fA-F0-9]{40}$/.test(sha1)) {
+        return (0, crypto_1.createHash)("sha1").update(content).digest("hex") === sha1.toLowerCase();
+    }
+    const quickXor = item.hashes?.quickXorHash;
+    if (typeof quickXor !== "string" ||
+        !/^[A-Za-z0-9+/]{27}=$/.test(quickXor) ||
+        Buffer.from(quickXor, "base64").toString("base64") !== quickXor) {
+        return false;
+    }
+    return quickXorHash(content) === quickXor;
+}
+async function refreshEmptyFolder(store, rootId, path, item, entries) {
+    const parentPath = path.substring(0, Math.max(0, path.lastIndexOf("/")));
+    const parentId = parentPath ? entries.get(parentPath)?.id : rootId;
+    if (!parentId)
+        return (0, teamsfx_api_1.err)(invalidInventory());
+    const siblings = await store.listChildren(parentId);
+    if (siblings.isErr())
+        return (0, teamsfx_api_1.err)(siblings.error);
+    if (!Array.isArray(siblings.value))
+        return (0, teamsfx_api_1.err)(invalidInventory());
+    const expected = new Map(Array.from(entries).filter(([entryPath]) => entryPath.substring(0, Math.max(0, entryPath.lastIndexOf("/"))) === parentPath));
+    if (siblings.value.length !== expected.size)
+        return (0, teamsfx_api_1.err)(invalidInventory());
+    const seen = new Set();
+    let refreshed;
+    for (const sibling of siblings.value) {
+        if (!validItem(sibling) || seen.has(sibling.id))
+            return (0, teamsfx_api_1.err)(invalidInventory());
+        seen.add(sibling.id);
+        const siblingPath = parentPath ? `${parentPath}/${sibling.name}` : sibling.name;
+        const original = expected.get(siblingPath);
+        if (original?.id !== sibling.id || original.kind !== sibling.kind) {
+            return (0, teamsfx_api_1.err)(invalidInventory());
+        }
+        if (sibling.id === item.id)
+            refreshed = sibling;
+    }
+    if (!refreshed)
+        return (0, teamsfx_api_1.err)(invalidInventory());
+    // Capture the new version BEFORE checking emptiness. A child added before the
+    // check is detected here; a later change must fail the port's If-Match delete.
+    const children = await store.listChildren(item.id);
+    if (children.isErr())
+        return (0, teamsfx_api_1.err)(children.error);
+    if (!Array.isArray(children.value) || children.value.length !== 0) {
+        return (0, teamsfx_api_1.err)(invalidInventory());
+    }
+    return (0, teamsfx_api_1.ok)(refreshed);
+}
+/**
+ * Reconciles only descendants enumerated from the caller's draft root. Every
+ * inventory read completes before mutation; errors retain partial progress for
+ * a subsequent invocation to reconcile against fresh metadata. Deleted counts
+ * include files and folders; uploaded and skipped counts include only files.
+ */
+async function synchronizeSkillFiles(store, rootId, files) {
+    if (!validId(rootId) || !Array.isArray(files))
+        return (0, teamsfx_api_1.err)(invalidInventory());
+    const local = localInventory(files);
+    if (local.isErr())
+        return (0, teamsfx_api_1.err)(local.error);
+    const remote = await remoteInventory(store, rootId);
+    if (remote.isErr())
+        return (0, teamsfx_api_1.err)(remote.error);
+    const counts = { uploaded: 0, skipped: 0, deleted: 0 };
+    const entries = remote.value;
+    const ids = new Set([rootId, ...Array.from(entries.values(), (item) => item.id)]);
+    // Removing stale children first also makes file/folder and case replacements
+    // possible without recursive deletes or a name-conflict overwrite.
+    const stale = Array.from(entries).filter(([path, item]) => local.value.get(path)?.kind !== item.kind);
+    stale.sort(([a], [b]) => b.split("/").length - a.split("/").length);
+    for (const [path, item] of stale) {
+        let versionedItem = item;
+        if (item.kind === "folder") {
+            const refreshed = await refreshEmptyFolder(store, rootId, path, item, entries);
+            if (refreshed.isErr())
+                return (0, teamsfx_api_1.err)(refreshed.error);
+            versionedItem = refreshed.value;
+        }
+        const deleted = await store.deleteItem(versionedItem);
+        if (deleted.isErr())
+            return (0, teamsfx_api_1.err)(deleted.error);
+        entries.delete(path);
+        counts.deleted++;
+    }
+    // Local inventory inserts each parent before its children.
+    for (const [path, entry] of local.value) {
+        const separator = path.lastIndexOf("/");
+        const parentPath = separator < 0 ? "" : path.substring(0, separator);
+        const parentId = parentPath ? entries.get(parentPath)?.id : rootId;
+        if (!parentId)
+            return (0, teamsfx_api_1.err)(invalidInventory());
+        const name = path.substring(separator + 1);
+        const existing = entries.get(path);
+        if (entry.kind === "folder") {
+            if (existing)
+                continue;
+            const created = await store.createFolder(parentId, name);
+            if (created.isErr())
+                return (0, teamsfx_api_1.err)(created.error);
+            if (!validItem(created.value) ||
+                created.value.kind !== "folder" ||
+                created.value.name !== name ||
+                ids.has(created.value.id)) {
+                return (0, teamsfx_api_1.err)(invalidInventory());
+            }
+            ids.add(created.value.id);
+            entries.set(path, created.value);
+        }
+        else {
+            if (existing && sameContent(existing, entry.content)) {
+                counts.skipped++;
+                continue;
+            }
+            const uploaded = await store.uploadFile(parentId, name, entry.content, existing);
+            if (uploaded.isErr())
+                return (0, teamsfx_api_1.err)(uploaded.error);
+            if (!validItem(uploaded.value) ||
+                uploaded.value.kind !== "file" ||
+                uploaded.value.name !== name ||
+                (existing ? uploaded.value.id !== existing.id : ids.has(uploaded.value.id))) {
+                return (0, teamsfx_api_1.err)(invalidInventory());
+            }
+            ids.add(uploaded.value.id);
+            entries.set(path, uploaded.value);
+            counts.uploaded++;
+        }
+    }
+    return (0, teamsfx_api_1.ok)(counts);
+}
+//# sourceMappingURL=skillFileSync.js.map

package/build/component/m365/skills/skillFileSync.js.map

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

package/build/component/m365/skills/skillPackage.d.ts

@@ -0,0 +1,40 @@
+import { FxError, Result } from "@microsoft/teamsfx-api";
+export interface SkillPackageFile {
+    /** Confined, slash-separated path relative to the skill folder. */
+    path: string;
+    content: Buffer;
+}
+export interface LocalSkill {
+    folder: string;
+    name: string;
+    description: string;
+    files: SkillPackageFile[];
+}
+export interface SkillReference {
+    manifestPath: string;
+    property: "agentSkills" | "agent_skills" | "x-agent_skills";
+    index: number;
+    folder: string;
+}
+export interface SkillAgentManifest {
+    path: string;
+    /** Original parsed fields, including extensions and exposure metadata. */
+    manifest: Record<string, unknown>;
+}
+/** Validated inventory from readSkillPackage; consumers must not mutate its source data. */
+export interface SkillPackage {
+    /** Unmodified source ZIP, retained for a separately defined transport transformation. */
+    data: Buffer;
+    agentId: string;
+    manifest: Record<string, unknown>;
+    declarativeAgents: SkillAgentManifest[];
+    references: SkillReference[];
+    skills: LocalSkill[];
+}
+/** Build the verified MOS reference package without changing the portable source package. */
+export declare function buildSkillTransportPackage(source: SkillPackage, folders: ReadonlyMap<string, string>): Result<Buffer, FxError>;
+/** Validate before remote mutations; remote-GUID associations require the final builder mapping. */
+export declare function validateSkillTransportPackage(source: SkillPackage): Result<void, FxError>;
+/** Inventory and validate only; this function never extracts files or performs remote I/O. */
+export declare function readSkillPackage(data: Buffer): Result<SkillPackage, FxError>;
+//# sourceMappingURL=skillPackage.d.ts.map

package/build/component/m365/skills/skillPackage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillPackage.d.ts","sourceRoot":"","sources":["../../../../src/component/m365/skills/skillPackage.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,OAAO,EAEP,MAAM,EAGP,MAAM,wBAAwB,CAAC;AAOhC,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,aAAa,GAAG,cAAc,GAAG,gBAAgB,CAAC;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,4FAA4F;AAC5F,MAAM,WAAW,YAAY;IAC3B,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;IACxC,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,6FAA6F;AAC7F,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB;AAED,oGAAoG;AACpG,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAEzF;AAqOD,8FAA8F;AAC9F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAiC5E"}