@creezio/mcp-facade 0.22.0

package/dist/admin/tool-policy-guard.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Garde d'enforcement réutilisable des policies MCP admin (M1).
+ *
+ * Trois surfaces, pour trois points d'entrée :
+ *   - `checkToolPolicy`          : décision brute (enabled/rôles/scopes) —
+ *                                  utilisable par n'importe quel enforcement
+ *                                  marque (ex. TF3 `registerMcpTool`) ;
+ *   - `createToolPolicyAuthorize`: `McpAuthorizeToolCallFn` composable avec
+ *                                  `composeToolPolicies` / `denyCrossLayerToolCall`
+ *                                  pour la façade (`createBrandMcpFacade`) ;
+ *   - `registerGuardedMcpTool`   : wrapper serveur MCP SDK — annotations +
+ *                                  policy + audit + scopes marque injectés.
+ *
+ * Aucune donnée marque : la résolution du rôle (`resolveRole`) et la logique
+ * scopes marque (`scopeAllows`) sont injectées. Les policies vivent dans la
+ * table `mcp_tool_policies` (adapters `configureMcpAdmin`) — mêmes lignes que
+ * la page /admin/mcp.
+ */
+import type { McpAuthorizeContext, McpAuthorizeToolCallFn } from "../types.js";
+import { auditMcpAdmin } from "./mcp-admin.js";
+export type ToolPolicyDenialReason = "tool_disabled" | "role_forbidden" | "policy_scope_forbidden";
+/** Vue minimale d'une policy — ce que la garde consomme. */
+export type ToolPolicyView = {
+    enabled: boolean;
+    allowedRoles: string[];
+    allowedScopes: string[];
+};
+export type ToolPolicyActor = {
+    userId?: string | null;
+    /**
+     * Scopes accordés à l'acteur (string séparée espaces/virgules ou tableau).
+     * `null`/`undefined` = pas de modèle de scopes sur ce canal → la garde ne
+     * vérifie pas les scopes (les canaux OAuth/API key doivent passer `""` au
+     * minimum pour forcer la vérification).
+     */
+    scopes?: string | readonly string[] | null;
+};
+export type ToolPolicyGuardOptions = {
+    /** Résolution de la policy (défaut : table `mcp_tool_policies` des adapters). */
+    getPolicy?: (name: string) => ToolPolicyView | null | undefined;
+    /** Rôle de l'acteur (injecté par la marque — ex. getUserById(id)?.role). */
+    resolveRole?: (userId: string) => string | null | undefined;
+    /** Rôle par défaut quand user inconnu / non résolu (défaut "collaborator"). */
+    defaultRole?: string;
+    /** Scopes « accès complet » qui court-circuitent la policy (défaut ["crm","full"]). */
+    fullAccessScopes?: readonly string[];
+    /** Audit (défaut `auditMcpAdmin` du kit). */
+    audit?: typeof auditMcpAdmin;
+};
+/** Policy stockée, lue directement (indépendante du registre tools marque). */
+export declare function getStoredMcpToolPolicy(name: string): ToolPolicyView | null;
+/**
+ * Décision d'enforcement d'un tool pour un acteur.
+ * Retourne la raison du deny, ou `null` si autorisé.
+ *
+ * Sémantique (parité TempoFlow) :
+ *  - policy absente ou `enabled=false` → "tool_disabled" ;
+ *  - rôle (resolveRole(userId) sinon defaultRole) hors allowedRoles → "role_forbidden" ;
+ *  - scopes fournis, aucun full-access ni allowedScope accordé → "policy_scope_forbidden"
+ *    (allowedScopes vide = aucune restriction de scope configurée).
+ */
+export declare function checkToolPolicy(name: string, actor: ToolPolicyActor, opts?: ToolPolicyGuardOptions): ToolPolicyDenialReason | null;
+export type CreateToolPolicyAuthorizeOptions = ToolPolicyGuardOptions & {
+    /**
+     * Extraction de l'acteur depuis le contexte façade. Défaut : subject JWT
+     * (hors "anonymous"/"opaque-token") comme userId ; scopes depuis les
+     * claims (`scope` string OAuth ou `scopes`), sinon `null` (pas de scopes
+     * sur ce canal → pas de vérif scopes).
+     */
+    resolveActor?: (ctx: McpAuthorizeContext) => ToolPolicyActor;
+};
+/**
+ * `McpAuthorizeToolCallFn` (composable via `composeToolPolicies`) qui applique
+ * les policies admin. Opt-in non cassant : si aucun `getPolicy` custom n'est
+ * fourni ET que `configureMcpAdmin` n'a pas été câblé, la garde autorise tout
+ * (comportement identique à une façade sans admin MCP).
+ */
+export declare function createToolPolicyAuthorize(opts?: CreateToolPolicyAuthorizeOptions): McpAuthorizeToolCallFn;
+/** Surface minimale du serveur MCP SDK (`@modelcontextprotocol/sdk`). */
+export type GuardedMcpServerLike = {
+    registerTool(name: string, config: Record<string, unknown>, handler: (input: any) => any): unknown;
+};
+export type GuardedMcpToolContext = {
+    userId?: string | null;
+    clientId?: string | null;
+    scopes?: string | null;
+};
+export type GuardedMcpToolDefinition = {
+    name: string;
+    requiredScope?: string;
+    annotations?: Record<string, boolean>;
+};
+export type RegisterGuardedMcpToolOptions = ToolPolicyGuardOptions & {
+    /**
+     * Vérification scopes marque supplémentaire (ex. apiKeyAllowsMethod) —
+     * deny `insufficient_scope` si false. Injectée par la marque.
+     */
+    scopeAllows?: (ctx: GuardedMcpToolContext, def: GuardedMcpToolDefinition) => boolean;
+};
+/**
+ * Enregistre un tool sur le serveur MCP SDK avec annotations + policy admin
+ * + audit + vérification scopes marque — SoT de l'enforcement TF-like
+ * (`registerMcpTool` des marques délègue ici, le registre métier reste marque).
+ */
+export declare function registerGuardedMcpTool(server: GuardedMcpServerLike, ctx: GuardedMcpToolContext, def: GuardedMcpToolDefinition, config: Record<string, unknown>, handler: (input: any) => any, opts?: RegisterGuardedMcpToolOptions): void;
+//# sourceMappingURL=tool-policy-guard.d.ts.map

package/dist/admin/tool-policy-guard.d.ts.map

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

package/dist/admin/tool-policy-guard.js

@@ -0,0 +1,187 @@
+/**
+ * Garde d'enforcement réutilisable des policies MCP admin (M1).
+ *
+ * Trois surfaces, pour trois points d'entrée :
+ *   - `checkToolPolicy`          : décision brute (enabled/rôles/scopes) —
+ *                                  utilisable par n'importe quel enforcement
+ *                                  marque (ex. TF3 `registerMcpTool`) ;
+ *   - `createToolPolicyAuthorize`: `McpAuthorizeToolCallFn` composable avec
+ *                                  `composeToolPolicies` / `denyCrossLayerToolCall`
+ *                                  pour la façade (`createBrandMcpFacade`) ;
+ *   - `registerGuardedMcpTool`   : wrapper serveur MCP SDK — annotations +
+ *                                  policy + audit + scopes marque injectés.
+ *
+ * Aucune donnée marque : la résolution du rôle (`resolveRole`) et la logique
+ * scopes marque (`scopeAllows`) sont injectées. Les policies vivent dans la
+ * table `mcp_tool_policies` (adapters `configureMcpAdmin`) — mêmes lignes que
+ * la page /admin/mcp.
+ */
+import { getMcpAdminAdapters, isMcpAdminConfigured } from "./adapters.js";
+import { auditMcpAdmin, ensureMcpAdminSchema } from "./mcp-admin.js";
+function splitList(raw) {
+    return String(raw || "")
+        .split(/[\s,]+/)
+        .filter(Boolean);
+}
+function grantedScopeSet(scopes) {
+    if (Array.isArray(scopes))
+        return new Set(scopes.map(String).filter(Boolean));
+    return new Set(splitList(String(scopes)));
+}
+/** Policy stockée, lue directement (indépendante du registre tools marque). */
+export function getStoredMcpToolPolicy(name) {
+    ensureMcpAdminSchema();
+    const row = getMcpAdminAdapters()
+        .getDb()
+        .prepare(`SELECT enabled, allowed_roles, allowed_scopes
+       FROM mcp_tool_policies WHERE tool_name = ?`)
+        .get(name);
+    if (!row)
+        return null;
+    return {
+        enabled: row.enabled !== 0,
+        allowedRoles: splitList(row.allowed_roles),
+        allowedScopes: splitList(row.allowed_scopes),
+    };
+}
+/**
+ * Décision d'enforcement d'un tool pour un acteur.
+ * Retourne la raison du deny, ou `null` si autorisé.
+ *
+ * Sémantique (parité TempoFlow) :
+ *  - policy absente ou `enabled=false` → "tool_disabled" ;
+ *  - rôle (resolveRole(userId) sinon defaultRole) hors allowedRoles → "role_forbidden" ;
+ *  - scopes fournis, aucun full-access ni allowedScope accordé → "policy_scope_forbidden"
+ *    (allowedScopes vide = aucune restriction de scope configurée).
+ */
+export function checkToolPolicy(name, actor, opts = {}) {
+    const getPolicy = opts.getPolicy || getStoredMcpToolPolicy;
+    const policy = getPolicy(name);
+    if (!policy?.enabled)
+        return "tool_disabled";
+    const role = (actor.userId ? opts.resolveRole?.(actor.userId) : null) ||
+        opts.defaultRole ||
+        "collaborator";
+    if (!policy.allowedRoles.includes(role))
+        return "role_forbidden";
+    if (actor.scopes != null && policy.allowedScopes.length > 0) {
+        const granted = grantedScopeSet(actor.scopes);
+        const fullAccess = opts.fullAccessScopes || ["crm", "full"];
+        if (!fullAccess.some((scope) => granted.has(scope)) &&
+            !policy.allowedScopes.some((scope) => granted.has(scope))) {
+            return "policy_scope_forbidden";
+        }
+    }
+    return null;
+}
+function defaultResolveActor(ctx) {
+    const claims = ctx.claims || {};
+    const claimUserId = typeof claims.userId === "string" && claims.userId ? claims.userId : null;
+    const subject = ctx.subject && ctx.subject !== "anonymous" && ctx.subject !== "opaque-token"
+        ? ctx.subject
+        : null;
+    let scopes = null;
+    if (typeof claims.scope === "string")
+        scopes = claims.scope;
+    else if (Array.isArray(claims.scopes))
+        scopes = claims.scopes.map(String);
+    else if (typeof claims.scopes === "string")
+        scopes = claims.scopes;
+    return { userId: claimUserId ?? subject, scopes };
+}
+/**
+ * `McpAuthorizeToolCallFn` (composable via `composeToolPolicies`) qui applique
+ * les policies admin. Opt-in non cassant : si aucun `getPolicy` custom n'est
+ * fourni ET que `configureMcpAdmin` n'a pas été câblé, la garde autorise tout
+ * (comportement identique à une façade sans admin MCP).
+ */
+export function createToolPolicyAuthorize(opts = {}) {
+    const resolveActor = opts.resolveActor || defaultResolveActor;
+    const audit = opts.audit || auditMcpAdmin;
+    return (ctx) => {
+        if (!opts.getPolicy && !isMcpAdminConfigured()) {
+            return { allow: true };
+        }
+        const actor = resolveActor(ctx);
+        // Les policies sont stockées sous le nom canonique OU le nom public
+        // (alias legacy) selon la surface seedée — on tente les deux.
+        const getPolicy = opts.getPolicy || getStoredMcpToolPolicy;
+        let denial = checkToolPolicy(ctx.canonicalName, actor, opts);
+        if (denial === "tool_disabled" &&
+            ctx.name !== ctx.canonicalName &&
+            getPolicy(ctx.name)) {
+            denial = checkToolPolicy(ctx.name, actor, opts);
+        }
+        if (denial) {
+            try {
+                audit("tool_call", {
+                    actor: actor.userId || null,
+                    toolName: ctx.name,
+                    outcome: "denied",
+                    detail: { reason: denial },
+                });
+            }
+            catch {
+                /* audit best-effort côté façade */
+            }
+            return { allow: false, reason: denial };
+        }
+        return { allow: true };
+    };
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function errorResult(payload) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(payload) }],
+        isError: true,
+    };
+}
+/**
+ * Enregistre un tool sur le serveur MCP SDK avec annotations + policy admin
+ * + audit + vérification scopes marque — SoT de l'enforcement TF-like
+ * (`registerMcpTool` des marques délègue ici, le registre métier reste marque).
+ */
+export function registerGuardedMcpTool(server, ctx, def, config, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+handler, opts = {}) {
+    const auditFn = opts.audit || auditMcpAdmin;
+    server.registerTool(def.name, {
+        ...config,
+        ...(def.annotations ? { annotations: def.annotations } : {}),
+    }, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async (input) => {
+        const audit = (outcome, detail) => auditFn("tool_call", {
+            actor: ctx.userId ?? null,
+            clientId: ctx.clientId ?? null,
+            toolName: def.name,
+            outcome,
+            detail,
+        });
+        const denial = checkToolPolicy(def.name, { userId: ctx.userId, scopes: ctx.scopes ?? "" }, opts);
+        if (denial) {
+            audit("denied", { reason: denial });
+            return errorResult({ error: denial, tool: def.name });
+        }
+        if (opts.scopeAllows && !opts.scopeAllows(ctx, def)) {
+            audit("denied", { reason: "insufficient_scope" });
+            return errorResult({
+                error: "insufficient_scope",
+                tool: def.name,
+                required_scope: def.requiredScope,
+            });
+        }
+        try {
+            const result = await handler(input);
+            audit(result?.isError ? "error" : "ok");
+            return result;
+        }
+        catch (error) {
+            audit("error", {
+                message: error instanceof Error ? error.message.slice(0, 300) : "Erreur tool",
+            });
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=tool-policy-guard.js.map

package/dist/admin/tool-policy-guard.js.map

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

package/dist/admin/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Types admin MCP (port TempoFlow — N6).
+ * Le registre métier des tools reste injecté par la marque.
+ */
+export type McpToolDefinition = {
+    name: string;
+    category: string;
+    access: "read" | "write";
+    requiredScope: string;
+    defaultRoles?: string[];
+    annotations?: Record<string, boolean>;
+    description?: string;
+    /** Absent = seed enabled (historique). false = désactivé jusqu'à /admin/mcp. */
+    mcpPublishDefault?: boolean;
+};
+export type McpAdminSqliteStatement = {
+    run(...params: unknown[]): {
+        changes: number;
+        lastInsertRowid?: number | bigint;
+    };
+    get(...params: unknown[]): unknown;
+    all(...params: unknown[]): unknown[];
+};
+export type McpAdminSqliteDatabase = {
+    exec(sql: string): unknown;
+    prepare(sql: string): McpAdminSqliteStatement;
+    transaction?: <TArgs extends unknown[], TResult>(fn: (...args: TArgs) => TResult) => (...args: TArgs) => TResult;
+};
+export type McpRequestLogEntry = {
+    status: number;
+    durationMs: number;
+    detail: Record<string, unknown>;
+};
+export type McpAdminAdapters = {
+    getDb: () => McpAdminSqliteDatabase;
+    getWriteDb: () => McpAdminSqliteDatabase;
+    tableExists: (name: string) => boolean;
+    /** Registre tools métier (seed policies). */
+    listTools: () => McpToolDefinition[];
+    mcpOauthReady: () => boolean;
+    resolveMcpPublicUrl: () => string | null;
+    /** Logs process MCP pour métriques (optionnel → métriques vides). */
+    listRequestLogs?: (opts: {
+        source: string;
+        limit: number;
+    }) => {
+        logs: McpRequestLogEntry[];
+    };
+    /** Filename export diagnostic (défaut creezio). */
+    diagnosticFilenamePrefix?: string;
+    /**
+     * Rôles acceptés dans `updateMcpToolPolicy` / seed des policies
+     * (défaut ["owner","collaborator"] — comportement historique).
+     */
+    policyRoleNames?: string[];
+    /**
+     * Scopes acceptés dans `updateMcpToolPolicy`
+     * (défaut ["crm","crm:read","crm:write","full"] — comportement historique).
+     */
+    policyScopeNames?: string[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/admin/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/admin/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAClF,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACnC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,CAAC;IAC9C,WAAW,CAAC,EAAE,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,KAAK,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC;CAClH,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,sBAAsB,CAAC;IACpC,UAAU,EAAE,MAAM,sBAAsB,CAAC;IACzC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,iBAAiB,EAAE,CAAC;IACrC,aAAa,EAAE,MAAM,OAAO,CAAC;IAC7B,mBAAmB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACzC,qEAAqE;IACrE,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,KAAK;QAAE,IAAI,EAAE,kBAAkB,EAAE,CAAA;KAAE,CAAC;IACrC,mDAAmD;IACnD,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC"}

package/dist/admin/types.js

@@ -0,0 +1,6 @@
+/**
+ * Types admin MCP (port TempoFlow — N6).
+ * Le registre métier des tools reste injecté par la marque.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/admin/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/admin/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/brand-facade.d.ts

@@ -0,0 +1,41 @@
+/**
+ * DX factory marque — remplace le boilerplate create*BrandMcp ×3.
+ * La marque fournit api + aliases ; tools module.* générés depuis
+ * `api.listOperations()`. `discoverModuleTools` = hook apps optionnel
+ * (extras / JWT) — SoT = `operations[]`, pas de `mcpTools` manuscrit.
+ */
+import type { ApiKernel } from "@creezio/api-kernel";
+import { type McpFacade } from "./facade.js";
+import { type CreateToolPolicyAuthorizeOptions } from "./admin/tool-policy-guard.js";
+import type { McpFacadeOptions, McpPublicSurfaceMode, McpRegisteredTool } from "./types.js";
+export type CreateBrandMcpFacadeOptions = Omit<McpFacadeOptions, "discoverToolsBySpace" | "aliases"> & {
+    api: ApiKernel;
+    /** Aliases legacy métier (surface publique). */
+    aliases: Record<string, string>;
+    /**
+     * Hook apps (extras / JWT). Le runtime génère toujours depuis
+     * `api.listOperations()` (space module) — SoT = `operations[]`.
+     */
+    discoverModuleTools?: (api: ApiKernel) => McpRegisteredTool[] | Promise<McpRegisteredTool[]>;
+    /** Discovery plugins (défaut : []). */
+    discoverPluginTools?: (api: ApiKernel) => McpRegisteredTool[] | Promise<McpRegisteredTool[]>;
+    /** Surface publique (défaut legacy-preferred — compat clients MCP externes). */
+    publicSurface?: McpPublicSurfaceMode;
+    /** Aliases additionnels fusionnés. */
+    extraAliases?: Record<string, string>;
+    /**
+     * M2 — enforcement des policies admin MCP (`mcp_tool_policies`) sur les
+     * tool calls de la façade, composé avec `denyCrossLayerToolCall`. Opt-in
+     * et non cassant : sans ce flag (ou si `configureMcpAdmin` n'est pas
+     * câblé), comportement identique à aujourd'hui. `true` = défauts ; objet =
+     * options de la garde (resolveRole, fullAccessScopes, …). Les tools listés
+     * par la façade sont seedés en policies permissives à la première décision
+     * (rien ne casse à l'activation).
+     */
+    toolPolicyGuard?: boolean | CreateToolPolicyAuthorizeOptions;
+};
+/**
+ * Une seule factory listTools/callTool pour Electron / Hono / assistant.
+ */
+export declare function createBrandMcpFacade(options: CreateBrandMcpFacadeOptions): McpFacade;
+//# sourceMappingURL=brand-facade.d.ts.map

package/dist/brand-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-facade.d.ts","sourceRoot":"","sources":["../src/brand-facade.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAI9D,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAEV,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,gBAAgB,EAChB,sBAAsB,GAAG,SAAS,CACnC,GAAG;IACF,GAAG,EAAE,SAAS,CAAC;IACf,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CACpB,GAAG,EAAE,SAAS,KACX,iBAAiB,EAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxD,uCAAuC;IACvC,mBAAmB,CAAC,EAAE,CACpB,GAAG,EAAE,SAAS,KACX,iBAAiB,EAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxD,gFAAgF;IAChF,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,OAAO,GAAG,gCAAgC,CAAC;CAC9D,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,SAAS,CA0EX"}

package/dist/brand-facade.js

@@ -0,0 +1,67 @@
+import { createMcpFacade } from "./facade.js";
+import { composeToolPolicies } from "./policy.js";
+import { isMcpAdminConfigured } from "./admin/adapters.js";
+import { seedMcpToolPolicies } from "./admin/mcp-admin.js";
+import { createToolPolicyAuthorize, } from "./admin/tool-policy-guard.js";
+import { discoverModuleToolsFromKernel } from "./module-ops-tools.js";
+/**
+ * Une seule factory listTools/callTool pour Electron / Hono / assistant.
+ */
+export function createBrandMcpFacade(options) {
+    const { api, aliases, discoverModuleTools, discoverPluginTools, extraAliases, publicSurface = "legacy-preferred", toolPolicyGuard, ...rest } = options;
+    let facade;
+    let authorizeToolCall = rest.authorizeToolCall;
+    if (toolPolicyGuard) {
+        const guardOpts = typeof toolPolicyGuard === "object" ? toolPolicyGuard : {};
+        const policyAuthorize = createToolPolicyAuthorize(guardOpts);
+        // Seed permissif des tools exposés par la façade (INSERT OR IGNORE) —
+        // lazy à la première décision : la DB admin n'est pas forcément prête
+        // à la création de la façade.
+        let policySeeded = false;
+        const ensurePolicySeed = async () => {
+            if (policySeeded || guardOpts.getPolicy || !isMcpAdminConfigured()) {
+                return;
+            }
+            policySeeded = true;
+            try {
+                const { tools } = await facade.listTools();
+                seedMcpToolPolicies(tools.map((tool) => ({
+                    name: tool.name,
+                    defaultRoles: tool.defaultRoles,
+                    requiredScope: tool.requiredScope,
+                    mcpPublishDefault: tool.mcpPublishDefault,
+                })));
+            }
+            catch {
+                policySeeded = false; // DB pas prête — retentera au prochain call
+            }
+        };
+        const guardedAuthorize = async (ctx) => {
+            await ensurePolicySeed();
+            return policyAuthorize(ctx);
+        };
+        authorizeToolCall = authorizeToolCall
+            ? composeToolPolicies(authorizeToolCall, guardedAuthorize)
+            : guardedAuthorize;
+    }
+    facade = createMcpFacade({
+        allowUnauthenticated: true,
+        enforceNamespaces: true,
+        publicSurface,
+        // defaultCrossLayerDeny=true : la façade compose elle-même
+        // denyCrossLayerToolCall AVANT authorizeToolCall (premier deny gagne).
+        defaultCrossLayerDeny: true,
+        listApiMounts: () => api.listMounts(),
+        ...rest,
+        authorizeToolCall,
+        aliases: { ...aliases, ...(extraAliases || {}) },
+        discoverToolsBySpace: async () => ({
+            module: discoverModuleToolsFromKernel(api, discoverModuleTools ? await discoverModuleTools(api) : []),
+            plugin: discoverPluginTools
+                ? await discoverPluginTools(api)
+                : [],
+        }),
+    });
+    return facade;
+}
+//# sourceMappingURL=brand-facade.js.map

package/dist/brand-facade.js.map

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

package/dist/core-tools.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Tools MCP cœur (`creezio.*`) — SoT kit (H1/H4 → M9).
+ *
+ * Les marques importent les noms / factories ; handlers Hono peuvent
+ * rester brand-specific tant que les noms restent alignés.
+ */
+import type { McpRegisteredTool, McpToolsBySpace } from "./types.js";
+export declare const CREEZIO_CORE_MCP_TOOL_NAMES: readonly ["creezio.health", "creezio.architecture", "creezio.admin.list_mounts", "creezio.admin.list_tools_by_space", "creezio.admin.list_aliases"];
+export type CreezioCoreMcpToolName = (typeof CREEZIO_CORE_MCP_TOOL_NAMES)[number];
+export type CreateCoreMcpToolsOptions = {
+    architectureVersion?: string;
+    brandId?: string;
+    listApiMounts?: () => Array<{
+        space: string;
+        id: string;
+    }>;
+    listToolsBySpaceSync?: () => McpToolsBySpace;
+    listAliasesSync?: () => Record<string, string>;
+};
+/** Factory tools cœur — utilisée par `createMcpFacade`. */
+export declare function createCoreMcpTools(opts?: CreateCoreMcpToolsOptions): McpRegisteredTool[];
+//# sourceMappingURL=core-tools.d.ts.map

package/dist/core-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-tools.d.ts","sourceRoot":"","sources":["../src/core-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAErE,eAAO,MAAM,2BAA2B,qJAM9B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAChC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,MAAM,MAAM,yBAAyB,GAAG;IACtC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,oBAAoB,CAAC,EAAE,MAAM,eAAe,CAAC;IAC7C,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD,CAAC;AAMF,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAChC,IAAI,GAAE,yBAA8B,GACnC,iBAAiB,EAAE,CA2ErB"}

package/dist/core-tools.js

@@ -0,0 +1,93 @@
+/**
+ * Tools MCP cœur (`creezio.*`) — SoT kit (H1/H4 → M9).
+ *
+ * Les marques importent les noms / factories ; handlers Hono peuvent
+ * rester brand-specific tant que les noms restent alignés.
+ */
+import { ARCHITECTURE_VERSION } from "@creezio/platform-core";
+import { API_V1_PREFIX } from "@creezio/api-kernel";
+export const CREEZIO_CORE_MCP_TOOL_NAMES = [
+    "creezio.health",
+    "creezio.architecture",
+    "creezio.admin.list_mounts",
+    "creezio.admin.list_tools_by_space",
+    "creezio.admin.list_aliases",
+];
+function emptyBySpace() {
+    return { core: [], module: [], plugin: [] };
+}
+/** Factory tools cœur — utilisée par `createMcpFacade`. */
+export function createCoreMcpTools(opts = {}) {
+    const architectureVersion = opts.architectureVersion ?? ARCHITECTURE_VERSION;
+    return [
+        {
+            name: "creezio.health",
+            description: "Ping santé façade MCP / API cœur",
+            space: "core",
+            inputSchema: { type: "object", properties: {} },
+            handler: async () => ({
+                ok: true,
+                content: { ok: true, brandId: opts.brandId ?? null },
+            }),
+        },
+        {
+            name: "creezio.architecture",
+            description: "Version architecture + préfixe API unique",
+            space: "core",
+            inputSchema: { type: "object", properties: {} },
+            handler: async () => ({
+                ok: true,
+                content: {
+                    architectureVersion,
+                    apiPrefix: API_V1_PREFIX,
+                    note: "Une seule façade MCP = MCP de l'app (proxy unifié H4)",
+                    toolSpaces: ["core", "module", "plugin"],
+                    publicSurfaceModes: [
+                        "canonical",
+                        "legacy-preferred",
+                        "both",
+                    ],
+                },
+            }),
+        },
+        {
+            name: "creezio.admin.list_mounts",
+            description: "Liste les montages API modules/plugins connus",
+            space: "core",
+            inputSchema: { type: "object", properties: {} },
+            handler: async () => ({
+                ok: true,
+                content: {
+                    mounts: opts.listApiMounts ? opts.listApiMounts() : [],
+                },
+            }),
+        },
+        {
+            name: "creezio.admin.list_tools_by_space",
+            description: "Liste les tools MCP groupés par couche (core / module / plugin)",
+            space: "core",
+            inputSchema: { type: "object", properties: {} },
+            handler: async () => ({
+                ok: true,
+                content: {
+                    bySpace: opts.listToolsBySpaceSync
+                        ? opts.listToolsBySpaceSync()
+                        : emptyBySpace(),
+                },
+            }),
+        },
+        {
+            name: "creezio.admin.list_aliases",
+            description: "Liste les aliases legacy → tools canoniques (anti double exposition)",
+            space: "core",
+            inputSchema: { type: "object", properties: {} },
+            handler: async () => ({
+                ok: true,
+                content: {
+                    aliases: opts.listAliasesSync ? opts.listAliasesSync() : {},
+                },
+            }),
+        },
+    ];
+}
+//# sourceMappingURL=core-tools.js.map

package/dist/core-tools.js.map

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

package/dist/dyn-import.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Import dynamique type-erased pour les packages `@creezio/*` qui ne sont
+ * PAS des dépendances de build de mcp-facade (`@creezio/auth`,
+ * `@creezio/tasks` — façade utilisable standalone). Un `import("…")` littéral
+ * ferait résoudre les types par tsc → TS2307 selon l'ordre topologique de
+ * `scripts/build-workspaces.mjs` (tasks compile APRÈS mcp-facade). Résolution
+ * au RUNTIME de l'app hôte, fail-closed chez les appelants — même pattern que
+ * `@creezio/mails` (imapflow / nodemailer).
+ */
+type DynImport = (specifier: string) => Promise<unknown>;
+export declare const dynImport: DynImport;
+export {};
+//# sourceMappingURL=dyn-import.d.ts.map