@happykiller/sunny-mcp 0.1.0

package/dist/graphql/errors.d.ts

@@ -0,0 +1,16 @@
+export interface GraphQLErreur {
+    message: string;
+    extensions?: {
+        code?: string;
+    };
+}
+export declare class GraphQLCallError extends Error {
+    readonly code: string;
+    readonly details: unknown;
+    constructor(code: string, details: unknown);
+}
+export declare function mapGraphQLErrors(erreurs: GraphQLErreur[]): GraphQLCallError;
+/** Le serveur ne distingue pas toujours « jeton absent » de « jeton périmé » :
+ *  les deux ressortent en UNAUTHENTICATED, parfois en FORBIDDEN. */
+export declare function estErreurAuth(erreurs: GraphQLErreur[]): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/graphql/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/graphql/errors.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IAEvC,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO;gBADhB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO;CAK5B;AAMD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,gBAAgB,CAU3E;AAED;oEACoE;AACpE,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAS/D"}

package/dist/graphql/errors.js

@@ -0,0 +1,39 @@
+// src/graphql/errors.ts
+// Les usecases de sunny-apis lèvent des `Error` dont le message EST le code
+// (`GET_USER_USECASE_USER_NOT_FOUND`…). GraphQL les rend en INTERNAL_SERVER_ERROR
+// avec ce code en message. On les remonte tels quels : un agent doit pouvoir
+// distinguer « ce compte n'existe pas » d'une panne, sans lire du français.
+export class GraphQLCallError extends Error {
+    code;
+    details;
+    constructor(code, details) {
+        super(code);
+        this.code = code;
+        this.details = details;
+        this.name = 'GraphQLCallError';
+    }
+}
+/** Un message tout en MAJUSCULES_AVEC_UNDERSCORES est un code métier, pas une
+ *  phrase destinée à un humain. */
+const estCodeMetier = (m) => /^[A-Z][A-Z0-9_]{3,}$/.test(m.trim());
+export function mapGraphQLErrors(erreurs) {
+    const premiere = erreurs[0];
+    const message = premiere?.message ?? 'erreur GraphQL sans message';
+    const code = estCodeMetier(message)
+        ? message.trim()
+        : (premiere?.extensions?.code ?? 'GRAPHQL_ERROR');
+    return new GraphQLCallError(code, {
+        messages: erreurs.map((e) => e.message),
+    });
+}
+/** Le serveur ne distingue pas toujours « jeton absent » de « jeton périmé » :
+ *  les deux ressortent en UNAUTHENTICATED, parfois en FORBIDDEN. */
+export function estErreurAuth(erreurs) {
+    return erreurs.some((e) => {
+        const code = e.extensions?.code ?? '';
+        return (code === 'UNAUTHENTICATED' ||
+            code === 'FORBIDDEN' ||
+            /unauthorized|unauthenticated|jwt|token/i.test(e.message ?? ''));
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/graphql/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/graphql/errors.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,4EAA4E;AAC5E,kFAAkF;AAClF,6EAA6E;AAC7E,4EAA4E;AAO5E,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAE9B;IACA;IAFX,YACW,IAAY,EACZ,OAAgB;QAEzB,KAAK,CAAC,IAAI,CAAC,CAAC;QAHH,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAS;QAGzB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;mCACmC;AACnC,MAAM,aAAa,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAE3E,MAAM,UAAU,gBAAgB,CAAC,OAAwB;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,IAAI,6BAA6B,CAAC;IACnE,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC;QACjC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE;QAChB,CAAC,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,IAAI,eAAe,CAAC,CAAC;IAEpD,OAAO,IAAI,gBAAgB,CAAC,IAAI,EAAE;QAChC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;KACxC,CAAC,CAAC;AACL,CAAC;AAED;oEACoE;AACpE,MAAM,UAAU,aAAa,CAAC,OAAwB;IACpD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC;QACtC,OAAO,CACL,IAAI,KAAK,iBAAiB;YAC1B,IAAI,KAAK,WAAW;YACpB,yCAAyC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAChE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/graphql/session.d.ts

@@ -0,0 +1,34 @@
+import { TokenCache } from './tokenCache.js';
+import type { Logger } from '../logger.js';
+export interface SessionOptions {
+    url: string;
+    /** Document d'authentification du produit. Doit accepter les variables
+     *  `login` / `password` et rendre un jeton à `extraireToken`. */
+    authDocument: string;
+    extraireToken: (data: any) => string | undefined;
+    login?: string;
+    password?: string;
+    /** Jeton fixé d'avance : court-circuite toute connexion. */
+    token?: string;
+    cache?: TokenCache;
+    /** En-tête par lequel le serveur réémet un jeton frais à chaque requête
+     *  authentifiée (`seguri-refresh-token` chez Siguri). L'adopter évite de
+     *  repasser par `auth`, dont le quota est serré. */
+    refreshHeader?: string;
+    logger?: Logger;
+    fetchImpl?: typeof fetch;
+}
+export declare class GraphQLSession {
+    private readonly opts;
+    private token?;
+    private readonly logger;
+    private readonly appel;
+    constructor(opts: SessionOptions);
+    request<T = any>(document: string, variables?: Record<string, unknown>): Promise<T>;
+    /** Jeton courant, sans forcer de connexion si l'on en a déjà un valide. */
+    jeton(): Promise<string>;
+    connexion(): Promise<string>;
+    private envoyer;
+    private adopterRafraichissement;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/graphql/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/graphql/session.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ;qEACiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,GAAG,SAAS,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;;wDAEoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,qBAAa,cAAc;IAKb,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAER,IAAI,EAAE,cAAc;IAM3C,OAAO,CAAC,CAAC,GAAG,GAAG,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACtC,OAAO,CAAC,CAAC,CAAC;IAoBb,2EAA2E;IACrE,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAYxB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;YA0BpB,OAAO;IA6CrB,OAAO,CAAC,uBAAuB;CAQhC"}

package/dist/graphql/session.js

@@ -0,0 +1,118 @@
+// src/graphql/session.ts
+// Session GraphQL authentifiée, réutilisable par n'importe quel produit : le
+// document d'authentification et le nom de l'en-tête de rafraîchissement sont
+// des paramètres, pas des constantes.
+import { GraphQLCallError, estErreurAuth, mapGraphQLErrors, } from './errors.js';
+import { silentLogger } from '../logger.js';
+export class GraphQLSession {
+    opts;
+    token;
+    logger;
+    appel;
+    constructor(opts) {
+        this.opts = opts;
+        this.logger = opts.logger ?? silentLogger;
+        this.appel = opts.fetchImpl ?? fetch;
+        this.token = opts.token;
+    }
+    async request(document, variables = {}) {
+        const token = await this.jeton();
+        const premiere = await this.envoyer(document, variables, token);
+        if (premiere.erreurs && estErreurAuth(premiere.erreurs)) {
+            // Le jeton a été refusé côté serveur : révoqué, compte désactivé, ou
+            // secret tourné. Une seule reprise — jamais de boucle.
+            this.logger.info('jeton refusé, reconnexion');
+            this.token = undefined;
+            this.opts.cache?.vider();
+            const frais = await this.connexion();
+            const seconde = await this.envoyer(document, variables, frais);
+            if (seconde.erreurs)
+                throw mapGraphQLErrors(seconde.erreurs);
+            return seconde.data;
+        }
+        if (premiere.erreurs)
+            throw mapGraphQLErrors(premiere.erreurs);
+        return premiere.data;
+    }
+    /** Jeton courant, sans forcer de connexion si l'on en a déjà un valide. */
+    async jeton() {
+        if (this.opts.token)
+            return this.opts.token;
+        if (this.token)
+            return this.token;
+        const encache = this.opts.cache?.lire();
+        if (encache) {
+            this.token = encache;
+            return encache;
+        }
+        return this.connexion();
+    }
+    async connexion() {
+        if (!this.opts.login || !this.opts.password) {
+            throw new GraphQLCallError('MISSING_CREDENTIALS', {
+                hint: "Ni jeton fixé ni couple login/mot de passe n'a été fourni.",
+            });
+        }
+        const { data, erreurs } = await this.envoyer(this.opts.authDocument, {
+            login: this.opts.login,
+            password: this.opts.password,
+        });
+        if (erreurs)
+            throw mapGraphQLErrors(erreurs);
+        const token = this.opts.extraireToken(data);
+        if (!token) {
+            throw new GraphQLCallError('AUTH_NO_TOKEN', {
+                hint: "L'authentification a répondu sans jeton.",
+            });
+        }
+        this.token = token;
+        this.opts.cache?.ecrire(token);
+        return token;
+    }
+    async envoyer(document, variables, token) {
+        const reponse = await this.appel(this.opts.url, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+                ...(token ? { authorization: `Bearer ${token}` } : {}),
+            },
+            body: JSON.stringify({ query: document, variables }),
+        });
+        // Le quota d'authentification est serré (10/min chez Siguri) : mieux vaut le
+        // dire franchement que laisser l'agent réessayer en aveugle.
+        if (reponse.status === 429) {
+            throw new GraphQLCallError('TOO_MANY_REQUESTS', {
+                retryAfter: reponse.headers.get('retry-after'),
+            });
+        }
+        this.adopterRafraichissement(reponse);
+        const texte = await reponse.text();
+        if (!texte) {
+            throw new GraphQLCallError('EMPTY_RESPONSE', { status: reponse.status });
+        }
+        let corps;
+        try {
+            corps = JSON.parse(texte);
+        }
+        catch {
+            throw new GraphQLCallError('INVALID_RESPONSE', {
+                status: reponse.status,
+                body: texte.slice(0, 400),
+            });
+        }
+        return {
+            data: corps.data,
+            erreurs: corps.errors?.length ? corps.errors : undefined,
+        };
+    }
+    adopterRafraichissement(reponse) {
+        if (!this.opts.refreshHeader)
+            return;
+        const frais = reponse.headers.get(this.opts.refreshHeader);
+        if (frais && frais !== this.token) {
+            this.token = frais;
+            this.opts.cache?.ecrire(frais);
+        }
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/graphql/session.js.map

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

package/dist/graphql/tokenCache.d.ts

@@ -0,0 +1,13 @@
+export declare function jwtExpiration(token: string): number | null;
+export declare function tokenEncoreValide(token: string, maintenant?: number): boolean;
+/** Le cache vit hors du dépôt : un `.token` déposé dans un dossier de projet
+ *  finit par être copié, partagé ou committé. */
+export declare function cheminCache(produit: string, cle: string): string;
+export declare class TokenCache {
+    private readonly chemin;
+    constructor(chemin: string);
+    lire(): string | null;
+    ecrire(token: string): void;
+    vider(): void;
+}
+//# sourceMappingURL=tokenCache.d.ts.map

package/dist/graphql/tokenCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenCache.d.ts","sourceRoot":"","sources":["../../src/graphql/tokenCache.ts"],"names":[],"mappings":"AAsBA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW1D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,SAAa,GAAG,OAAO,CAMjF;AAED;iDACiD;AACjD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAMhE;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE3C,IAAI,IAAI,MAAM,GAAG,IAAI;IAWrB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAU3B,KAAK,IAAI,IAAI;CAOd"}

package/dist/graphql/tokenCache.js

@@ -0,0 +1,78 @@
+// src/graphql/tokenCache.ts
+// Cache de jeton sur disque, hors du dépôt. Reprend la logique éprouvée de
+// `siguri-admin/scripts/sgql.sh` : on décode `exp` sans vérifier la signature —
+// le client n'a pas le secret et n'en a pas besoin, la vérification est
+// l'affaire du serveur. Le seul but est d'éviter de rejouer `auth`, bridé à
+// 10 requêtes par minute.
+import { createHash } from 'node:crypto';
+import { homedir, tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { chmodSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync, } from 'node:fs';
+/** Marge avant expiration : un jeton qui expire pendant le vol de la requête
+ *  coûte un aller-retour inutile et une erreur trompeuse. */
+const MARGE_SECONDES = 60;
+export function jwtExpiration(token) {
+    const parts = token.split('.');
+    if (parts.length !== 3)
+        return null;
+    try {
+        const charge = JSON.parse(Buffer.from(parts[1], 'base64url').toString('utf8'));
+        return typeof charge?.exp === 'number' ? charge.exp : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function tokenEncoreValide(token, maintenant = Date.now()) {
+    const exp = jwtExpiration(token);
+    // Un jeton sans `exp` est indatable : on préfère se reconnecter plutôt que de
+    // parier sur sa validité.
+    if (exp === null)
+        return false;
+    return exp * 1000 > maintenant + MARGE_SECONDES * 1000;
+}
+/** Le cache vit hors du dépôt : un `.token` déposé dans un dossier de projet
+ *  finit par être copié, partagé ou committé. */
+export function cheminCache(produit, cle) {
+    const base = process.env.XDG_CACHE_HOME ??
+        (homedir() ? join(homedir(), '.cache') : tmpdir());
+    const empreinte = createHash('sha256').update(cle).digest('hex').slice(0, 32);
+    return join(base, 'sunny-mcp', `${produit}-${empreinte}.token`);
+}
+export class TokenCache {
+    chemin;
+    constructor(chemin) {
+        this.chemin = chemin;
+    }
+    lire() {
+        try {
+            if (!existsSync(this.chemin))
+                return null;
+            const token = readFileSync(this.chemin, 'utf8').trim();
+            return token && tokenEncoreValide(token) ? token : null;
+        }
+        catch {
+            // Un cache illisible n'est pas une panne : on se reconnecte.
+            return null;
+        }
+    }
+    ecrire(token) {
+        try {
+            mkdirSync(join(this.chemin, '..'), { recursive: true, mode: 0o700 });
+            writeFileSync(this.chemin, token, { encoding: 'utf8', mode: 0o600 });
+            chmodSync(this.chemin, 0o600);
+        }
+        catch {
+            // Un cache non écrit dégrade la performance, pas la correction.
+        }
+    }
+    vider() {
+        try {
+            rmSync(this.chemin, { force: true });
+        }
+        catch {
+            /* idem */
+        }
+    }
+}
+//# sourceMappingURL=tokenCache.js.map

package/dist/graphql/tokenCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenCache.js","sourceRoot":"","sources":["../../src/graphql/tokenCache.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,2EAA2E;AAC3E,gFAAgF;AAChF,wEAAwE;AACxE,4EAA4E;AAC5E,0BAA0B;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,SAAS,EACT,UAAU,EACV,SAAS,EACT,YAAY,EACZ,MAAM,EACN,aAAa,GACd,MAAM,SAAS,CAAC;AAEjB;6DAC6D;AAC7D,MAAM,cAAc,GAAG,EAAE,CAAC;AAE1B,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CACpD,CAAC;QACF,OAAO,OAAO,MAAM,EAAE,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE;IACtE,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACjC,8EAA8E;IAC9E,0BAA0B;IAC1B,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,GAAG,GAAG,IAAI,GAAG,UAAU,GAAG,cAAc,GAAG,IAAI,CAAC;AACzD,CAAC;AAED;iDACiD;AACjD,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,GAAW;IACtD,MAAM,IAAI,GACR,OAAO,CAAC,GAAG,CAAC,cAAc;QAC1B,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9E,OAAO,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,OAAO,IAAI,SAAS,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,OAAO,UAAU;IACQ;IAA7B,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE/C,IAAI;QACF,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC1C,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YACvD,OAAO,KAAK,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,6DAA6D;YAC7D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,IAAI,CAAC;YACH,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACrE,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACrE,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;QAClE,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,UAAU;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { ok, fail } from './server/contract.js';
+export { createMcpServer } from './server/createMcpServer.js';
+export type { CreateServerOptions } from './server/createMcpServer.js';
+export { startTransport } from './server/transport.js';
+export type { StartOptions, TransportKind } from './server/transport.js';
+export { defineTool } from './tools/defineTool.js';
+export type { ToolCatalog, ToolContext, ToolDefinition, } from './tools/defineTool.js';
+export { GraphQLSession } from './graphql/session.js';
+export type { SessionOptions } from './graphql/session.js';
+export { GraphQLCallError, estErreurAuth, mapGraphQLErrors, } from './graphql/errors.js';
+export type { GraphQLErreur } from './graphql/errors.js';
+export { TokenCache, cheminCache, jwtExpiration, tokenEncoreValide, } from './graphql/tokenCache.js';
+export { AVEU_PROD, TargetRefusedError, resolveTarget, } from './safety/target.js';
+export type { Target } from './safety/target.js';
+export { silentLogger, stderrLogger } from './logger.js';
+export type { Logger } from './logger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,YAAY,EACV,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,UAAU,EACV,WAAW,EACX,aAAa,EACb,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// src/index.ts — surface publique du socle.
+export { ok, fail } from './server/contract.js';
+export { createMcpServer } from './server/createMcpServer.js';
+export { startTransport } from './server/transport.js';
+export { defineTool } from './tools/defineTool.js';
+export { GraphQLSession } from './graphql/session.js';
+export { GraphQLCallError, estErreurAuth, mapGraphQLErrors, } from './graphql/errors.js';
+export { TokenCache, cheminCache, jwtExpiration, tokenEncoreValide, } from './graphql/tokenCache.js';
+export { AVEU_PROD, TargetRefusedError, resolveTarget, } from './safety/target.js';
+export { silentLogger, stderrLogger } from './logger.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAOnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,WAAW,EACX,aAAa,EACb,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,7 @@
+export interface Logger {
+    info(message: string): void;
+    error(message: string): void;
+}
+export declare const stderrLogger: (prefixe: string) => Logger;
+export declare const silentLogger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,MAG7C,CAAC;AAEH,eAAO,MAAM,YAAY,EAAE,MAA4C,CAAC"}

package/dist/logger.js

@@ -0,0 +1,6 @@
+export const stderrLogger = (prefixe) => ({
+    info: (m) => process.stderr.write(`[${prefixe}] ${m}\n`),
+    error: (m) => process.stderr.write(`[${prefixe}] ERREUR ${m}\n`),
+});
+export const silentLogger = { info: () => { }, error: () => { } };
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,CAAC;IACxD,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC;IACxD,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,OAAO,YAAY,CAAC,IAAI,CAAC;CACjE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAW,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC"}

package/dist/safety/target.d.ts

@@ -0,0 +1,13 @@
+export interface Target {
+    url: string;
+    host: string;
+    isProd: boolean;
+}
+/** Le mot de passe est volontairement long et non devinable : on ne le pose pas
+ *  par distraction, contrairement à `true` ou `1`. */
+export declare const AVEU_PROD = "yes-i-know";
+export declare class TargetRefusedError extends Error {
+    readonly code = "TARGET_REFUSED";
+}
+export declare function resolveTarget(rawUrl: string, aveu?: string): Target;
+//# sourceMappingURL=target.d.ts.map

package/dist/safety/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/safety/target.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;sDACsD;AACtD,eAAO,MAAM,SAAS,eAAe,CAAC;AAEtC,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,oBAAoB;CAClC;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAqBnE"}

package/dist/safety/target.js

@@ -0,0 +1,34 @@
+// src/safety/target.ts
+// Garde-fou de cible : transposition du cran d'arrêt de `bin/dev-mongo.sh`, qui
+// refuse d'écrire sans `--write`. Il ne protège pas contre un attaquant — il
+// protège contre soi-même, un soir où l'on croit viser le local.
+const HOTES_LOCAUX = new Set([
+    'localhost',
+    '127.0.0.1',
+    '::1',
+    '[::1]',
+    '0.0.0.0',
+]);
+/** Le mot de passe est volontairement long et non devinable : on ne le pose pas
+ *  par distraction, contrairement à `true` ou `1`. */
+export const AVEU_PROD = 'yes-i-know';
+export class TargetRefusedError extends Error {
+    code = 'TARGET_REFUSED';
+}
+export function resolveTarget(rawUrl, aveu) {
+    let url;
+    try {
+        url = new URL(rawUrl);
+    }
+    catch {
+        throw new TargetRefusedError(`URL d'API invalide : ${JSON.stringify(rawUrl)}`);
+    }
+    const host = url.hostname;
+    const isProd = !HOTES_LOCAUX.has(host);
+    if (isProd && aveu !== AVEU_PROD) {
+        throw new TargetRefusedError(`Cible non locale (${host}). Pour l'autoriser délibérément, poser ` +
+            `SUNNY_MCP_ALLOW_PROD=${AVEU_PROD}. Toute autre valeur est refusée.`);
+    }
+    return { url: url.toString(), host, isProd };
+}
+//# sourceMappingURL=target.js.map

package/dist/safety/target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.js","sourceRoot":"","sources":["../../src/safety/target.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,gFAAgF;AAChF,6EAA6E;AAC7E,iEAAiE;AAEjE,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,WAAW;IACX,WAAW;IACX,KAAK;IACL,OAAO;IACP,SAAS;CACV,CAAC,CAAC;AAQH;sDACsD;AACtD,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC;AAEtC,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,GAAG,gBAAgB,CAAC;CAClC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,IAAa;IACzD,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,kBAAkB,CAC1B,wBAAwB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CACjD,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC1B,MAAM,MAAM,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEvC,IAAI,MAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,kBAAkB,CAC1B,qBAAqB,IAAI,0CAA0C;YACjE,wBAAwB,SAAS,mCAAmC,CACvE,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC/C,CAAC"}

package/dist/server/contract.d.ts

@@ -0,0 +1,4 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const ok: (result: unknown) => CallToolResult;
+export declare const fail: (code: string, details?: unknown) => CallToolResult;
+//# sourceMappingURL=contract.d.ts.map

package/dist/server/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/server/contract.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,EAAE,GAAI,QAAQ,OAAO,KAAG,cAEnC,CAAC;AAEH,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,EAAE,UAAU,OAAO,KAAG,cAKrD,CAAC"}

package/dist/server/contract.js

@@ -0,0 +1,10 @@
+export const ok = (result) => ({
+    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+});
+export const fail = (code, details) => ({
+    isError: true,
+    content: [
+        { type: 'text', text: JSON.stringify({ error: code, details }, null, 2) },
+    ],
+});
+//# sourceMappingURL=contract.js.map

package/dist/server/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/server/contract.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAe,EAAkB,EAAE,CAAC,CAAC;IACtD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;CACnE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,OAAiB,EAAkB,EAAE,CAAC,CAAC;IACxE,OAAO,EAAE,IAAI;IACb,OAAO,EAAE;QACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;KAC1E;CACF,CAAC,CAAC"}

package/dist/server/createMcpServer.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolCatalog, ToolContext } from '../tools/defineTool.js';
+export interface CreateServerOptions {
+    name: string;
+    version: string;
+    catalog: ToolCatalog;
+    ctx: ToolContext;
+}
+export declare function createMcpServer(opts: CreateServerOptions): McpServer;
+//# sourceMappingURL=createMcpServer.d.ts.map

package/dist/server/createMcpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMcpServer.d.ts","sourceRoot":"","sources":["../../src/server/createMcpServer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;IACrB,GAAG,EAAE,WAAW,CAAC;CAClB;AAMD,wBAAgB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,SAAS,CA0DpE"}

package/dist/server/createMcpServer.js

@@ -0,0 +1,58 @@
+// src/server/createMcpServer.ts
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ok, fail } from './contract.js';
+import { GraphQLCallError } from '../graphql/errors.js';
+/** Préfixe apposé en clair sur les outils écrivant en production : la seule
+ *  chose que l'agent lit avant d'agir, c'est la description. */
+const PREFIXE_PROD = '[PRODUCTION] ';
+export function createMcpServer(opts) {
+    const { catalog, ctx } = opts;
+    const server = new McpServer({ name: opts.name, version: opts.version });
+    const noms = new Set();
+    for (const tool of catalog) {
+        if (noms.has(tool.name)) {
+            throw new Error(`Outil déclaré deux fois : ${tool.name}`);
+        }
+        noms.add(tool.name);
+        const description = ctx.target.isProd && tool.requiresWrite
+            ? PREFIXE_PROD + tool.description
+            : tool.description;
+        server.registerTool(tool.name, {
+            title: tool.title,
+            description,
+            inputSchema: tool.inputSchema,
+            annotations: tool.annotations,
+        }, async (args) => {
+            if (tool.requiresWrite && !ctx.allowWrites) {
+                // Refus AVANT toute requête : rien ne part sur le réseau.
+                return fail('WRITES_DISABLED', {
+                    tool: tool.name,
+                    target: ctx.target.url,
+                    hint: 'Poser SUNNY_MCP_ALLOW_WRITES=true pour autoriser les écritures.',
+                });
+            }
+            try {
+                const resultat = await tool.execute(args, ctx);
+                // Chaque réponse rappelle où elle a agi : l'agent et le lecteur de la
+                // transcription voient la cible sans avoir à la deviner.
+                return ok({
+                    ...resultat,
+                    target: ctx.target.url,
+                    is_prod: ctx.target.isProd,
+                });
+            }
+            catch (e) {
+                ctx.logger.error(`${tool.name} : ${e?.message ?? e}`);
+                if (e instanceof GraphQLCallError) {
+                    return fail(e.code, { ...e.details, tool: tool.name });
+                }
+                return fail(e?.code ?? 'TOOL_FAILED', {
+                    message: e?.message ?? String(e),
+                    tool: tool.name,
+                });
+            }
+        });
+    }
+    return server;
+}
+//# sourceMappingURL=createMcpServer.js.map

package/dist/server/createMcpServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMcpServer.js","sourceRoot":"","sources":["../../src/server/createMcpServer.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAUxD;gEACgE;AAChE,MAAM,YAAY,GAAG,eAAe,CAAC;AAErC,MAAM,UAAU,eAAe,CAAC,IAAyB;IACvD,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC9B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAEzE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpB,MAAM,WAAW,GACf,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,aAAa;YACrC,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,WAAW;YACjC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;QAEvB,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT;YACE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW;YACX,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,EACD,KAAK,EAAE,IAAS,EAAE,EAAE;YAClB,IAAI,IAAI,CAAC,aAAa,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBAC3C,0DAA0D;gBAC1D,OAAO,IAAI,CAAC,iBAAiB,EAAE;oBAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG;oBACtB,IAAI,EAAE,iEAAiE;iBACxE,CAAC,CAAC;YACL,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC/C,sEAAsE;gBACtE,yDAAyD;gBACzD,OAAO,EAAE,CAAC;oBACR,GAAI,QAAmB;oBACvB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG;oBACtB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM;iBAC3B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBAChB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,MAAM,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;gBACtD,IAAI,CAAC,YAAY,gBAAgB,EAAE,CAAC;oBAClC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,GAAI,CAAC,CAAC,OAAkB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrE,CAAC;gBACD,OAAO,IAAI,CAAC,CAAC,EAAE,IAAI,IAAI,aAAa,EAAE;oBACpC,OAAO,EAAE,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC;oBAChC,IAAI,EAAE,IAAI,CAAC,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server/transport.d.ts

@@ -0,0 +1,10 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Logger } from '../logger.js';
+export type TransportKind = 'stdio' | 'http';
+export interface StartOptions {
+    transport?: TransportKind;
+    port?: number;
+    logger?: Logger;
+}
+export declare function startTransport(server: McpServer, opts?: StartOptions): Promise<void>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/server/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/server/transport.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,IAAI,CAAC,CAkCf"}

package/dist/server/transport.js

@@ -0,0 +1,39 @@
+// src/server/transport.ts
+// Deux transports pour un même serveur, choisis par variable d'environnement :
+// `stdio` pour un client comme Claude Code, `http` pour le débogage manuel et un
+// éventuel déploiement multi-client. Gabarit repris de kalifa.
+import express from 'express';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { silentLogger } from '../logger.js';
+export async function startTransport(server, opts = {}) {
+    const logger = opts.logger ?? silentLogger;
+    const kind = opts.transport ?? 'stdio';
+    if (kind === 'stdio') {
+        await server.connect(new StdioServerTransport());
+        logger.info('transport stdio prêt');
+        return;
+    }
+    const app = express();
+    app.use(express.json({ limit: '4mb' }));
+    // `sessionIdGenerator: undefined` = mode sans état : aucune session à tenir
+    // côté serveur, donc rien à répliquer si l'on déploie plusieurs instances.
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: undefined,
+    });
+    await server.connect(transport);
+    const relais = async (req, res) => {
+        await transport.handleRequest(req, res, req.body);
+    };
+    app.post('/mcp', relais);
+    app.get('/mcp', relais);
+    app.delete('/mcp', relais);
+    const port = opts.port ?? 3000;
+    await new Promise((resolve) => {
+        app.listen(port, () => {
+            logger.info(`transport http prêt sur :${port}/mcp`);
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=transport.js.map

package/dist/server/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/server/transport.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,+EAA+E;AAC/E,iFAAiF;AACjF,+DAA+D;AAC/D,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAInG,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAU5C,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAiB,EACjB,OAAqB,EAAE;IAEvB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC;IAEvC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACpC,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAExC,4EAA4E;IAC5E,2EAA2E;IAC3E,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;QAClD,kBAAkB,EAAE,SAAS;KAC9B,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,MAAM,MAAM,GAAG,KAAK,EAAE,GAAoB,EAAE,GAAqB,EAAE,EAAE;QACnE,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC,CAAC;IACF,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;IAC/B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;YACpB,MAAM,CAAC,IAAI,CAAC,4BAA4B,IAAI,MAAM,CAAC,CAAC;YACpD,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/defineTool.d.ts

@@ -0,0 +1,28 @@
+import type { z } from 'zod';
+import type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
+import type { Logger } from '../logger.js';
+import type { Target } from '../safety/target.js';
+import type { GraphQLSession } from '../graphql/session.js';
+export interface ToolContext {
+    gql: GraphQLSession;
+    target: Target;
+    /** Interrupteur d'écriture, indépendant de la cible : il faut deux erreurs
+     *  pour écrire en production, pas une. */
+    allowWrites: boolean;
+    logger: Logger;
+}
+export interface ToolDefinition<S extends z.ZodRawShape = z.ZodRawShape> {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: S;
+    annotations?: ToolAnnotations;
+    /** Marque l'outil comme écrivant. Le socle le refuse tant que `allowWrites`
+     *  est faux, sans même émettre de requête. */
+    requiresWrite?: boolean;
+    /** Rend l'objet métier ; le socle l'enveloppe dans le contrat de réponse. */
+    execute(args: z.infer<z.ZodObject<S>>, ctx: ToolContext): Promise<unknown>;
+}
+export declare const defineTool: <S extends z.ZodRawShape>(d: ToolDefinition<S>) => ToolDefinition<S>;
+export type ToolCatalog = ReadonlyArray<ToolDefinition<any>>;
+//# sourceMappingURL=defineTool.d.ts.map

package/dist/tools/defineTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineTool.d.ts","sourceRoot":"","sources":["../../src/tools/defineTool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf;8CAC0C;IAC1C,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC;IACf,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B;kDAC8C;IAC9C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6EAA6E;IAC7E,OAAO,CACL,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAC7B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,sBAAM,CAAC;AAE/E,MAAM,MAAM,WAAW,GAAG,aAAa,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC"}

package/dist/tools/defineTool.js

@@ -0,0 +1,2 @@
+export const defineTool = (d) => d;
+//# sourceMappingURL=defineTool.js.map

package/dist/tools/defineTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineTool.js","sourceRoot":"","sources":["../../src/tools/defineTool.ts"],"names":[],"mappings":"AAqCA,MAAM,CAAC,MAAM,UAAU,GAAG,CAA0B,CAAoB,EAAE,EAAE,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@happykiller/sunny-mcp",
+  "version": "0.1.0",
+  "description": "Socle MCP partagé : transport, session GraphQL, registre d'outils et garde-fous, pour exposer le back-office d'un produit aux agents.",
+  "license": "ISC",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json",
+    "test": "tsx --test $(find src -name '*.test.ts' | sort)",
+    "check": "tsc --noEmit -p tsconfig.json && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "express": "^5.2.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^22.15.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.0"
+  }
+}