@dealdesk/server 2026.527.0-canary.0

package/dist/services/plugin-managed-skills.js

@@ -0,0 +1,264 @@
+import { and, eq } from "drizzle-orm";
+import { pluginManagedResources, } from "@dealdesk/db";
+import { normalizeAgentUrlKey } from "@dealdesk/shared";
+import { notFound } from "../errors.js";
+import { logActivity } from "./activity-log.js";
+import { companySkillService } from "./company-skills.js";
+const MANAGED_SKILL_RESOURCE_KIND = "skill";
+function pluginKeySlug(pluginKey) {
+    return normalizeAgentUrlKey(pluginKey) ?? "plugin";
+}
+function canonicalSkillKey(pluginKey, skillKey) {
+    return `plugin/${pluginKeySlug(pluginKey)}/${skillKey}`;
+}
+function yamlString(value) {
+    return JSON.stringify(value);
+}
+function buildDefaultMarkdown(pluginKey, declaration) {
+    const description = declaration.description?.trim() || `${declaration.displayName} plugin skill.`;
+    return [
+        "---",
+        `name: ${yamlString(declaration.displayName)}`,
+        `description: ${yamlString(description)}`,
+        `key: ${yamlString(canonicalSkillKey(pluginKey, declaration.skillKey))}`,
+        "---",
+        "",
+        `# ${declaration.displayName}`,
+        "",
+        description,
+        "",
+    ].join("\n");
+}
+function withManagedSkillKey(markdown, canonicalKey) {
+    const keyLine = `key: ${yamlString(canonicalKey)}`;
+    const normalized = markdown.replace(/\r\n/g, "\n");
+    const frontmatter = /^---\n([\s\S]*?)\n---(\n?)/.exec(normalized);
+    if (!frontmatter) {
+        return [
+            "---",
+            keyLine,
+            "---",
+            "",
+            normalized,
+        ].join("\n");
+    }
+    const currentBody = frontmatter[1] ?? "";
+    const nextBody = /^key\s*:/m.test(currentBody)
+        ? currentBody.replace(/^key\s*:.*$/m, keyLine)
+        : [currentBody, keyLine].filter(Boolean).join("\n");
+    return `---\n${nextBody}\n---${frontmatter[2] ?? ""}${normalized.slice(frontmatter[0].length)}`;
+}
+function buildPackageFiles(pluginKey, declaration) {
+    const root = declaration.skillKey;
+    const canonicalKey = canonicalSkillKey(pluginKey, declaration.skillKey);
+    const files = {
+        [`${root}/SKILL.md`]: declaration.markdown?.trim()
+            ? withManagedSkillKey(declaration.markdown, canonicalKey)
+            : buildDefaultMarkdown(pluginKey, declaration),
+    };
+    for (const file of declaration.files ?? []) {
+        files[`${root}/${file.path}`] = file.content;
+    }
+    return files;
+}
+function buildDeclaredSkillFiles(pluginKey, declaration) {
+    const packageFiles = buildPackageFiles(pluginKey, declaration);
+    const root = declaration.skillKey;
+    const prefix = `${root}/`;
+    const files = {};
+    for (const [filePath, content] of Object.entries(packageFiles)) {
+        files[filePath.startsWith(prefix) ? filePath.slice(prefix.length) : filePath] = content;
+    }
+    return files;
+}
+function buildSkillDefaults(pluginKey, declaration) {
+    return {
+        skillKey: declaration.skillKey,
+        displayName: declaration.displayName,
+        slug: declaration.slug ?? declaration.skillKey,
+        description: declaration.description ?? null,
+        canonicalKey: canonicalSkillKey(pluginKey, declaration.skillKey),
+        files: [
+            "SKILL.md",
+            ...(declaration.files ?? []).map((file) => file.path),
+        ],
+    };
+}
+function stableJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(",")}]`;
+    if (value && typeof value === "object") {
+        return `{${Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, entry]) => `${JSON.stringify(key)}:${stableJson(entry)}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+function resolution(pluginKey, companyId, declaration, skill, status, defaultDrift = null) {
+    return {
+        pluginKey,
+        resourceKind: "skill",
+        resourceKey: declaration.skillKey,
+        companyId,
+        skillId: skill?.id ?? null,
+        skill,
+        status,
+        defaultDrift,
+    };
+}
+export function pluginManagedSkillService(db, options) {
+    const skills = companySkillService(db);
+    function declarationFor(skillKey) {
+        const declaration = options.manifest?.skills?.find((skill) => skill.skillKey === skillKey);
+        if (!declaration) {
+            throw notFound(`Managed skill declaration not found: ${skillKey}`);
+        }
+        return declaration;
+    }
+    async function getBinding(companyId, skillKey) {
+        return db
+            .select()
+            .from(pluginManagedResources)
+            .where(and(eq(pluginManagedResources.companyId, companyId), eq(pluginManagedResources.pluginId, options.pluginId), eq(pluginManagedResources.resourceKind, MANAGED_SKILL_RESOURCE_KIND), eq(pluginManagedResources.resourceKey, skillKey)))
+            .then((rows) => rows[0] ?? null);
+    }
+    async function upsertBinding(companyId, declaration, skillId) {
+        const defaultsJson = buildSkillDefaults(options.pluginKey, declaration);
+        const existing = await getBinding(companyId, declaration.skillKey);
+        if (existing) {
+            if (existing.resourceId === skillId &&
+                stableJson(existing.defaultsJson) === stableJson(defaultsJson)) {
+                return existing;
+            }
+            return db
+                .update(pluginManagedResources)
+                .set({
+                resourceId: skillId,
+                defaultsJson,
+                updatedAt: new Date(),
+            })
+                .where(eq(pluginManagedResources.id, existing.id))
+                .returning()
+                .then((rows) => rows[0]);
+        }
+        return db
+            .insert(pluginManagedResources)
+            .values({
+            companyId,
+            pluginId: options.pluginId,
+            pluginKey: options.pluginKey,
+            resourceKind: MANAGED_SKILL_RESOURCE_KIND,
+            resourceKey: declaration.skillKey,
+            resourceId: skillId,
+            defaultsJson,
+        })
+            .returning()
+            .then((rows) => rows[0]);
+    }
+    async function getSkill(companyId, skillId) {
+        return skills.getById(companyId, skillId);
+    }
+    async function managedSkillDefaultDrift(companyId, skill, declaration) {
+        if (!skill)
+            return null;
+        const declaredFiles = buildDeclaredSkillFiles(options.pluginKey, declaration);
+        const currentFiles = {};
+        const paths = new Set([
+            ...Object.keys(declaredFiles),
+            ...skill.fileInventory.map((entry) => entry.path),
+        ]);
+        for (const filePath of paths) {
+            if (filePath === "SKILL.md") {
+                currentFiles[filePath] = skill.markdown;
+                continue;
+            }
+            try {
+                currentFiles[filePath] = (await skills.readFile(companyId, skill.id, filePath))?.content ?? null;
+            }
+            catch {
+                currentFiles[filePath] = null;
+            }
+        }
+        const changedFiles = [...paths]
+            .filter((filePath) => (currentFiles[filePath] ?? null) !== (declaredFiles[filePath] ?? null))
+            .sort((left, right) => left.localeCompare(right));
+        return changedFiles.length > 0 ? { changedFiles } : null;
+    }
+    async function resolvedSkill(companyId, declaration, skill, status) {
+        return resolution(options.pluginKey, companyId, declaration, skill, status, await managedSkillDefaultDrift(companyId, skill, declaration));
+    }
+    async function importDeclaredSkill(companyId, declaration, mode) {
+        const beforeByKey = mode === "reconcile"
+            ? await skills.getByKey(companyId, canonicalSkillKey(options.pluginKey, declaration.skillKey))
+            : null;
+        if (beforeByKey) {
+            await upsertBinding(companyId, declaration, beforeByKey.id);
+            return { skill: beforeByKey, status: "relinked" };
+        }
+        const results = await skills.importPackageFiles(companyId, buildPackageFiles(options.pluginKey, declaration), { onConflict: "replace" });
+        const imported = results.find((result) => result.skill.key === canonicalSkillKey(options.pluginKey, declaration.skillKey)
+            || result.originalSlug === (declaration.slug ?? declaration.skillKey)
+            || result.originalSlug === declaration.skillKey)?.skill ?? results[0]?.skill ?? null;
+        if (!imported) {
+            throw notFound(`Managed skill was not imported: ${declaration.skillKey}`);
+        }
+        await upsertBinding(companyId, declaration, imported.id);
+        const status = mode === "reset" ? "reset" : "created";
+        return { skill: imported, status };
+    }
+    async function get(skillKey, companyId) {
+        const declaration = declarationFor(skillKey);
+        const binding = await getBinding(companyId, skillKey);
+        if (!binding)
+            return resolvedSkill(companyId, declaration, null, "missing");
+        const skill = await getSkill(companyId, binding.resourceId);
+        return resolvedSkill(companyId, declaration, skill, skill ? "resolved" : "missing");
+    }
+    async function reconcile(skillKey, companyId) {
+        const declaration = declarationFor(skillKey);
+        const current = await get(skillKey, companyId);
+        if (current.skill) {
+            await upsertBinding(companyId, declaration, current.skill.id);
+            return current;
+        }
+        const imported = await importDeclaredSkill(companyId, declaration, "reconcile");
+        await logActivity(db, {
+            companyId,
+            actorType: "plugin",
+            actorId: options.pluginId,
+            action: "plugin.managed_skill.reconciled",
+            entityType: "company_skill",
+            entityId: imported.skill.id,
+            details: {
+                sourcePluginKey: options.pluginKey,
+                managedResourceKey: declaration.skillKey,
+                status: imported.status,
+            },
+        });
+        return resolvedSkill(companyId, declaration, imported.skill, imported.status);
+    }
+    async function reset(skillKey, companyId) {
+        const declaration = declarationFor(skillKey);
+        const imported = await importDeclaredSkill(companyId, declaration, "reset");
+        await logActivity(db, {
+            companyId,
+            actorType: "plugin",
+            actorId: options.pluginId,
+            action: "plugin.managed_skill.reset",
+            entityType: "company_skill",
+            entityId: imported.skill.id,
+            details: {
+                sourcePluginKey: options.pluginKey,
+                managedResourceKey: declaration.skillKey,
+            },
+        });
+        return resolvedSkill(companyId, declaration, imported.skill, "reset");
+    }
+    return {
+        get,
+        reconcile,
+        reset,
+    };
+}
+//# sourceMappingURL=plugin-managed-skills.js.map

package/dist/services/plugin-managed-skills.js.map

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

package/dist/services/plugin-manifest-validator.d.ts

@@ -0,0 +1,79 @@
+import type { DealDeskPluginManifestV1 } from "@dealdesk/shared";
+/**
+ * Successful parse result.
+ */
+export interface ManifestParseSuccess {
+    success: true;
+    manifest: DealDeskPluginManifestV1;
+}
+/**
+ * Failed parse result. `errors` is a human-readable description of what went
+ * wrong; `details` is the raw Zod error list for programmatic inspection.
+ */
+export interface ManifestParseFailure {
+    success: false;
+    errors: string;
+    details: Array<{
+        path: (string | number)[];
+        message: string;
+    }>;
+}
+/** Union of parse outcomes. */
+export type ManifestParseResult = ManifestParseSuccess | ManifestParseFailure;
+/**
+ * Service for parsing and validating plugin manifests.
+ *
+ * @see PLUGIN_SPEC.md §10 — Plugin Manifest
+ */
+export interface PluginManifestValidator {
+    /**
+     * Try to parse `input` as a plugin manifest.
+     *
+     * Returns a {@link ManifestParseSuccess} when the input passes all
+     * validation rules, or a {@link ManifestParseFailure} with human-readable
+     * error messages when it does not.
+     *
+     * This is the "safe" variant — it never throws.
+     */
+    parse(input: unknown): ManifestParseResult;
+    /**
+     * Parse `input` as a plugin manifest, throwing a 400 HttpError on failure.
+     *
+     * Use this at install time when an invalid manifest should surface as an
+     * HTTP error to the caller.
+     *
+     * @throws {HttpError} 400 Bad Request if the manifest is invalid.
+     */
+    parseOrThrow(input: unknown): DealDeskPluginManifestV1;
+    /**
+     * Return the list of plugin API versions supported by this host.
+     *
+     * Callers can use this to present the supported version range to operators
+     * or to decide whether a candidate plugin can be installed.
+     */
+    getSupportedVersions(): readonly number[];
+}
+/**
+ * Create a {@link PluginManifestValidator}.
+ *
+ * Usage:
+ * ```ts
+ * const validator = pluginManifestValidator();
+ *
+ * // Safe parse — inspect the result
+ * const result = validator.parse(rawManifest);
+ * if (!result.success) {
+ *   console.error(result.errors);
+ *   return;
+ * }
+ * const manifest = result.manifest;
+ *
+ * // Throwing parse — use at install time
+ * const manifest = validator.parseOrThrow(rawManifest);
+ *
+ * // Check supported versions
+ * const versions = validator.getSupportedVersions(); // [1]
+ * ```
+ */
+export declare function pluginManifestValidator(): PluginManifestValidator;
+//# sourceMappingURL=plugin-manifest-validator.d.ts.map

package/dist/services/plugin-manifest-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manifest-validator.d.ts","sourceRoot":"","sources":["../../src/services/plugin-manifest-validator.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAmBjE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,wBAAwB,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChE;AAED,+BAA+B;AAC/B,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAM9E;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAAC;IAE3C;;;;;;;OAOG;IACH,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAAC;IAEvD;;;;;OAKG;IACH,oBAAoB,IAAI,SAAS,MAAM,EAAE,CAAC;CAC3C;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,IAAI,uBAAuB,CA4CjE"}

package/dist/services/plugin-manifest-validator.js

@@ -0,0 +1,84 @@
+/**
+ * PluginManifestValidator — schema validation for plugin manifest files.
+ *
+ * Uses the shared Zod schema (`pluginManifestV1Schema`) to validate
+ * manifest payloads. Provides both a safe `parse()` variant (returns
+ * a result union) and a throwing `parseOrThrow()` for HTTP error
+ * propagation at install time.
+ *
+ * @see PLUGIN_SPEC.md §10 — Plugin Manifest
+ * @see packages/shared/src/validators/plugin.ts — Zod schema definition
+ */
+import { pluginManifestV1Schema } from "@dealdesk/shared";
+import { PLUGIN_API_VERSION } from "@dealdesk/shared";
+import { badRequest } from "../errors.js";
+// ---------------------------------------------------------------------------
+// Supported manifest API versions
+// ---------------------------------------------------------------------------
+/**
+ * The set of plugin API versions this host can accept.
+ * When a new API version is introduced, add it here. Old versions should be
+ * retained until the host drops support for them.
+ */
+const SUPPORTED_VERSIONS = [PLUGIN_API_VERSION];
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a {@link PluginManifestValidator}.
+ *
+ * Usage:
+ * ```ts
+ * const validator = pluginManifestValidator();
+ *
+ * // Safe parse — inspect the result
+ * const result = validator.parse(rawManifest);
+ * if (!result.success) {
+ *   console.error(result.errors);
+ *   return;
+ * }
+ * const manifest = result.manifest;
+ *
+ * // Throwing parse — use at install time
+ * const manifest = validator.parseOrThrow(rawManifest);
+ *
+ * // Check supported versions
+ * const versions = validator.getSupportedVersions(); // [1]
+ * ```
+ */
+export function pluginManifestValidator() {
+    return {
+        parse(input) {
+            const result = pluginManifestV1Schema.safeParse(input);
+            if (result.success) {
+                return {
+                    success: true,
+                    manifest: result.data,
+                };
+            }
+            const details = result.error.errors.map((issue) => ({
+                path: issue.path,
+                message: issue.message,
+            }));
+            const errors = details
+                .map(({ path, message }) => path.length > 0 ? `${path.join(".")}: ${message}` : message)
+                .join("; ");
+            return {
+                success: false,
+                errors,
+                details,
+            };
+        },
+        parseOrThrow(input) {
+            const result = this.parse(input);
+            if (!result.success) {
+                throw badRequest(`Invalid plugin manifest: ${result.errors}`, result.details);
+            }
+            return result.manifest;
+        },
+        getSupportedVersions() {
+            return SUPPORTED_VERSIONS;
+        },
+    };
+}
+//# sourceMappingURL=plugin-manifest-validator.js.map

package/dist/services/plugin-manifest-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manifest-validator.js","sourceRoot":"","sources":["../../src/services/plugin-manifest-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,CAAC,kBAAkB,CAAU,CAAC;AAmEzD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,KAAK,CAAC,KAAc;YAClB,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAEvD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,QAAQ,EAAE,MAAM,CAAC,IAAgC;iBAClD,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAClD,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC,CAAC;YAEJ,MAAM,MAAM,GAAG,OAAO;iBACnB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CACzB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAC5D;iBACA,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM;gBACN,OAAO;aACR,CAAC;QACJ,CAAC;QAED,YAAY,CAAC,KAAc;YACzB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAEjC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,UAAU,CAAC,4BAA4B,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAChF,CAAC;YAED,OAAO,MAAM,CAAC,QAAQ,CAAC;QACzB,CAAC;QAED,oBAAoB;YAClB,OAAO,kBAAkB,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC"}