@cogenta/agents-builtin 0.1.0

package/dist/content/agent.d.ts

@@ -0,0 +1,18 @@
+import { type AgentDeclaration } from '@cogenta/agents';
+/**
+ * "Il écrit toujours dans un brouillon, jamais en publication." No
+ * `content.publish` in `tools` — structural, same reasoning `seoAgent`
+ * (L5 task 5) documents: the runtime cannot grant what was never listed.
+ *
+ * "Mémoire procédurale : les corrections humaines sur ses brouillons
+ * alimentent son apprentissage. C'est l'agent où le signal de feedback
+ * compte le plus." Nothing new to build for this: `approvalToMemoryRecord`
+ * (`@cogenta/agents`, L4 task 13) already converts a decided
+ * `ApprovalRequest` into a `procedural` `MemoryRecord` — once this agent's
+ * drafts flow through the approval queue (L4 task 9, which `autonomy:
+ * 'propose'` below routes every write through), every human decision on a
+ * draft already produces exactly that signal. A parallel mechanism here
+ * would just duplicate it.
+ */
+export declare const contentAgent: AgentDeclaration;
+//# sourceMappingURL=agent.d.ts.map

package/dist/content/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/content/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,iBAAiB,CAAA;AAEpE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,EAAE,gBAUzB,CAAA"}

package/dist/content/agent.js

@@ -0,0 +1,28 @@
+import { defineAgent } from '@cogenta/agents';
+/**
+ * "Il écrit toujours dans un brouillon, jamais en publication." No
+ * `content.publish` in `tools` — structural, same reasoning `seoAgent`
+ * (L5 task 5) documents: the runtime cannot grant what was never listed.
+ *
+ * "Mémoire procédurale : les corrections humaines sur ses brouillons
+ * alimentent son apprentissage. C'est l'agent où le signal de feedback
+ * compte le plus." Nothing new to build for this: `approvalToMemoryRecord`
+ * (`@cogenta/agents`, L4 task 13) already converts a decided
+ * `ApprovalRequest` into a `procedural` `MemoryRecord` — once this agent's
+ * drafts flow through the approval queue (L4 task 9, which `autonomy:
+ * 'propose'` below routes every write through), every human decision on a
+ * draft already produces exactly that signal. A parallel mechanism here
+ * would just duplicate it.
+ */
+export const contentAgent = defineAgent({
+    name: 'content',
+    identity: './identity.md',
+    model: { preferred: 'claude-sonnet', fallback: 'local' },
+    tools: ['content.read', 'content.write_draft', 'media.read', 'agent.delegate'],
+    skills: ['editorial-charter', 'tone-guide', 'article-templates'],
+    autonomy: { default: 'propose' },
+    budget: { tokensPerDay: 250_000, eurPerMonth: 15, callsPerHour: 30 },
+    memory: { episodic: true, procedural: true, scope: 'site' },
+    triggers: [{ on: 'content.gap_detected' }, { on: 'schedule', cron: '0 8 * * 1' }],
+});
+//# sourceMappingURL=agent.js.map

package/dist/content/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/content/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAEpE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,YAAY,GAAqB,WAAW,CAAC;IACxD,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,eAAe;IACzB,KAAK,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE;IACxD,KAAK,EAAE,CAAC,cAAc,EAAE,qBAAqB,EAAE,YAAY,EAAE,gBAAgB,CAAC;IAC9E,MAAM,EAAE,CAAC,mBAAmB,EAAE,YAAY,EAAE,mBAAmB,CAAC;IAChE,QAAQ,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE;IAChC,MAAM,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;IACpE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE;IAC3D,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,sBAAsB,EAAE,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;CAClF,CAAC,CAAA"}

package/dist/content/provenance.d.ts

@@ -0,0 +1,28 @@
+import { type ContentServiceLike, type ToolDefinition } from '@cogenta/agents';
+import { z } from 'zod';
+import type { ContentProvenance } from './types.js';
+export interface ContentDraftToolOptions {
+    readonly provenance: ContentProvenance;
+}
+declare const ContentDraftInputSchema: z.ZodObject<{
+    collection: z.ZodString;
+    id: z.ZodOptional<z.ZodString>;
+    values: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    locale: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ContentDraftInput = z.infer<typeof ContentDraftInputSchema>;
+/**
+ * "Tout contenu produit porte `provenance: generated` ou `assisted`. Le
+ * champ n'est pas optionnel et n'est pas modifiable par l'agent." Two
+ * things make this a hard structural rule rather than a convention: the
+ * input schema never offers a `provenance` key for the model to set (see
+ * `ContentDraftInputSchema` above), and `execute` overwrites whatever ends
+ * up under that key in `values` unconditionally, every call — even if a
+ * caller smuggled one in directly. This is the Content agent's own
+ * `content.write_draft`, not the generic one in `@cogenta/agents` (which
+ * has no opinion on provenance at all, correctly — that is this agent's
+ * rule, not the tool registry's).
+ */
+export declare function createContentDraftTool(service: ContentServiceLike, options: ContentDraftToolOptions): ToolDefinition<ContentDraftInput, Record<string, unknown>>;
+export {};
+//# sourceMappingURL=provenance.d.ts.map

package/dist/content/provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../../src/content/provenance.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EAGvB,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;CACvC;AAaD,QAAA,MAAM,uBAAuB;;;;;iBAK3B,CAAA;AACF,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAIhE;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,uBAAuB,GAC/B,cAAc,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA2B5D"}

package/dist/content/provenance.js

@@ -0,0 +1,48 @@
+import { defineTool, } from '@cogenta/agents';
+import { z } from 'zod';
+function accessContextOf(actor) {
+    return { actor };
+}
+// Deliberately no `provenance` field — the model has no way to even attempt
+// setting it. `values` still accepts anything else the agent wants to write.
+const ContentDraftInputSchema = z.object({
+    collection: z.string(),
+    id: z.string().optional(),
+    values: z.record(z.string(), z.unknown()),
+    locale: z.string().optional(),
+});
+const DEFAULT_READ_OPTIONS = { state: 'working', depth: 0 };
+/**
+ * "Tout contenu produit porte `provenance: generated` ou `assisted`. Le
+ * champ n'est pas optionnel et n'est pas modifiable par l'agent." Two
+ * things make this a hard structural rule rather than a convention: the
+ * input schema never offers a `provenance` key for the model to set (see
+ * `ContentDraftInputSchema` above), and `execute` overwrites whatever ends
+ * up under that key in `values` unconditionally, every call — even if a
+ * caller smuggled one in directly. This is the Content agent's own
+ * `content.write_draft`, not the generic one in `@cogenta/agents` (which
+ * has no opinion on provenance at all, correctly — that is this agent's
+ * rule, not the tool registry's).
+ */
+export function createContentDraftTool(service, options) {
+    return defineTool({
+        name: 'content.write_draft',
+        version: '1.0.0',
+        description: 'Create or update a working-state (draft) content entry, stamped with its provenance.',
+        input: ContentDraftInputSchema,
+        output: z.record(z.string(), z.unknown()),
+        permissions: ['content.write_draft'],
+        sideEffects: true,
+        reversible: false,
+        cost: 'low',
+        async execute(input, ctx) {
+            const context = accessContextOf(ctx.actor);
+            const values = { ...input.values, provenance: options.provenance };
+            if (input.id !== undefined) {
+                return service.update(context, input.collection, input.id, { values }, DEFAULT_READ_OPTIONS);
+            }
+            return service.create(context, input.collection, { values, ...(input.locale === undefined ? {} : { locale: input.locale }) }, DEFAULT_READ_OPTIONS);
+        },
+    });
+}
+//# sourceMappingURL=provenance.js.map

package/dist/content/provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.js","sourceRoot":"","sources":["../../src/content/provenance.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,GAGX,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,SAAS,eAAe,CAAC,KAGxB;IAGC,OAAO,EAAE,KAAK,EAAE,CAAA;AAClB,CAAC;AAED,4EAA4E;AAC5E,6EAA6E;AAC7E,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAA;AAGF,MAAM,oBAAoB,GAAG,EAAE,KAAK,EAAE,SAAkB,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;AAEpE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAA2B,EAC3B,OAAgC;IAEhC,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;QAChB,WAAW,EACT,sFAAsF;QACxF,KAAK,EAAE,uBAAuB;QAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QACzC,WAAW,EAAE,CAAC,qBAAqB,CAAC;QACpC,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE,KAAK;QACX,KAAK,CAAC,OAAO,CAAC,KAAwB,EAAE,GAAgB;YACtD,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YAC1C,MAAM,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAA;YAElE,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAA;YAC9F,CAAC;YACD,OAAO,OAAO,CAAC,MAAM,CACnB,OAAO,EACP,KAAK,CAAC,UAAU,EAChB,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAC3E,oBAAoB,CACrB,CAAA;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/content/terminology.d.ts

@@ -0,0 +1,12 @@
+import type { ContentFinding } from './types.js';
+export interface TerminologyRule {
+    readonly banned: string;
+    readonly preferred: string;
+}
+/**
+ * "Cohérence terminologique." Whole-word, case-insensitive matching — a
+ * banned term is only ever a real word occurrence, not a substring of an
+ * unrelated word ("AI" never matches inside "container").
+ */
+export declare function checkTerminology(text: string, rules: readonly TerminologyRule[]): readonly ContentFinding[];
+//# sourceMappingURL=terminology.d.ts.map

package/dist/content/terminology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminology.d.ts","sourceRoot":"","sources":["../../src/content/terminology.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAMD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,eAAe,EAAE,GAChC,SAAS,cAAc,EAAE,CAe3B"}

package/dist/content/terminology.js

@@ -0,0 +1,24 @@
+function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * "Cohérence terminologique." Whole-word, case-insensitive matching — a
+ * banned term is only ever a real word occurrence, not a substring of an
+ * unrelated word ("AI" never matches inside "container").
+ */
+export function checkTerminology(text, rules) {
+    const findings = [];
+    for (const rule of rules) {
+        const pattern = new RegExp(`\\b${escapeRegExp(rule.banned)}\\b`, 'gi');
+        const matches = text.match(pattern);
+        if (matches === null || matches.length === 0)
+            continue;
+        findings.push({
+            check: 'terminology',
+            severity: 'info',
+            message: `"${rule.banned}" used ${matches.length} time(s) — preferred term is "${rule.preferred}".`,
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=terminology.js.map

package/dist/content/terminology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminology.js","sourceRoot":"","sources":["../../src/content/terminology.ts"],"names":[],"mappings":"AAOA,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,KAAiC;IAEjC,MAAM,QAAQ,GAAqB,EAAE,CAAA;IAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QACtE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACnC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAQ;QACtD,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,aAAa;YACpB,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,IAAI,IAAI,CAAC,MAAM,UAAU,OAAO,CAAC,MAAM,iCAAiC,IAAI,CAAC,SAAS,IAAI;SACpG,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/content/topic-gaps.d.ts

@@ -0,0 +1,29 @@
+export interface TopicCandidate {
+    readonly topic: string;
+    readonly description: string;
+}
+export interface ExistingContent {
+    readonly title: string;
+    readonly bodyText: string;
+}
+export interface TopicGapSuggestion {
+    readonly topic: string;
+    readonly description: string;
+    readonly maxSimilarity: number;
+}
+export interface SuggestTopicGapsOptions {
+    readonly maxSuggestions?: number;
+    readonly similarityThreshold?: number;
+}
+/**
+ * "Suggestions de sujets à partir des lacunes du contenu existant." A
+ * candidate topic unlike everything already published (its highest
+ * similarity to any existing piece stays under `similarityThreshold`) is a
+ * genuine gap; one that closely tracks existing content is filtered out.
+ * Reuses `createHashingEmbeddingProvider` (L4 task 14) rather than a
+ * bespoke similarity metric — a local cosine helper is used instead of the
+ * RAG index's `vectorRank`, which expects a full `IndexedChunk`/`Chunk`
+ * wrapper this call has no reason to construct.
+ */
+export declare function suggestTopicGaps(candidateTopics: readonly TopicCandidate[], existingContent: readonly ExistingContent[], options?: SuggestTopicGapsOptions): Promise<readonly TopicGapSuggestion[]>;
+//# sourceMappingURL=topic-gaps.d.ts.map

package/dist/content/topic-gaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-gaps.d.ts","sourceRoot":"","sources":["../../src/content/topic-gaps.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CACtC;AA6BD;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,eAAe,EAAE,SAAS,cAAc,EAAE,EAC1C,eAAe,EAAE,SAAS,eAAe,EAAE,EAC3C,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CA0BxC"}

package/dist/content/topic-gaps.js

@@ -0,0 +1,58 @@
+import { createHashingEmbeddingProvider } from '@cogenta/agents';
+const DEFAULT_MAX_SUGGESTIONS = 5;
+// The hashing-trick embedding (L4 task 14) has no absolute calibration and,
+// on short texts, even fully unrelated sentences share enough incidental
+// function words ("a", "using", ...) to sit as high as ~0.3-0.4 cosine
+// similarity — not a bug, just the ceiling of a bag-of-words hash on short
+// strings. The default sits above that noise floor so only genuinely close
+// (near-duplicate or paraphrased) content counts as "already covered";
+// unrelated topics that merely share a few function words still surface as
+// gaps rather than being silently swallowed by hash noise.
+const DEFAULT_SIMILARITY_THRESHOLD = 0.5;
+function cosineSimilarity(a, b) {
+    let dot = 0;
+    let magnitudeA = 0;
+    let magnitudeB = 0;
+    const length = Math.min(a.length, b.length);
+    for (let i = 0; i < length; i++) {
+        const valueA = a[i] ?? 0;
+        const valueB = b[i] ?? 0;
+        dot += valueA * valueB;
+        magnitudeA += valueA * valueA;
+        magnitudeB += valueB * valueB;
+    }
+    if (magnitudeA === 0 || magnitudeB === 0)
+        return 0;
+    return dot / (Math.sqrt(magnitudeA) * Math.sqrt(magnitudeB));
+}
+/**
+ * "Suggestions de sujets à partir des lacunes du contenu existant." A
+ * candidate topic unlike everything already published (its highest
+ * similarity to any existing piece stays under `similarityThreshold`) is a
+ * genuine gap; one that closely tracks existing content is filtered out.
+ * Reuses `createHashingEmbeddingProvider` (L4 task 14) rather than a
+ * bespoke similarity metric — a local cosine helper is used instead of the
+ * RAG index's `vectorRank`, which expects a full `IndexedChunk`/`Chunk`
+ * wrapper this call has no reason to construct.
+ */
+export async function suggestTopicGaps(candidateTopics, existingContent, options = {}) {
+    const maxSuggestions = options.maxSuggestions ?? DEFAULT_MAX_SUGGESTIONS;
+    const similarityThreshold = options.similarityThreshold ?? DEFAULT_SIMILARITY_THRESHOLD;
+    if (candidateTopics.length === 0)
+        return [];
+    const provider = createHashingEmbeddingProvider();
+    const candidateVectors = await provider.embed(candidateTopics.map((candidate) => candidate.description));
+    const existingVectors = existingContent.length === 0
+        ? []
+        : await provider.embed(existingContent.map((content) => content.bodyText));
+    return candidateTopics
+        .map((candidate, index) => {
+        const vector = candidateVectors[index] ?? [];
+        const maxSimilarity = existingVectors.reduce((max, existingVector) => Math.max(max, cosineSimilarity(vector, existingVector)), 0);
+        return { topic: candidate.topic, description: candidate.description, maxSimilarity };
+    })
+        .filter((candidate) => candidate.maxSimilarity < similarityThreshold)
+        .sort((a, b) => a.maxSimilarity - b.maxSimilarity)
+        .slice(0, maxSuggestions);
+}
+//# sourceMappingURL=topic-gaps.js.map

package/dist/content/topic-gaps.js.map

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

package/dist/content/types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * "Tout contenu produit porte `provenance: generated` ou `assisted`. Le
+ * champ n'est pas optionnel." Only these two values exist for agent-authored
+ * content — `'human'` is never a value this agent can produce, by
+ * construction (see `provenance.ts`).
+ */
+export type ContentProvenance = 'generated' | 'assisted';
+export type ContentSeverity = 'error' | 'warning' | 'info';
+/** Kept decoupled from `SeoFinding`/`PerformanceFinding` — same severity-tagged-finding shape, different domain, no cross-domain coupling for its own sake. */
+export interface ContentFinding {
+    readonly check: string;
+    readonly severity: ContentSeverity;
+    readonly message: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/content/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,UAAU,CAAA;AAExD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;AAE1D,+JAA+J;AAC/J,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB"}

package/dist/content/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/content/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+export { contentAgent } from './content/agent.js';
+export type { ContentDraftToolOptions } from './content/provenance.js';
+export { createContentDraftTool } from './content/provenance.js';
+export type { TerminologyRule } from './content/terminology.js';
+export { checkTerminology } from './content/terminology.js';
+export type { ExistingContent, SuggestTopicGapsOptions, TopicCandidate, TopicGapSuggestion, } from './content/topic-gaps.js';
+export { suggestTopicGaps } from './content/topic-gaps.js';
+export type { ContentFinding, ContentProvenance, ContentSeverity } from './content/types.js';
+export { performanceAgent } from './performance/agent.js';
+export { compareToBudget } from './performance/budget.js';
+export type { CruxFormFactor, QueryCruxOptions } from './performance/crux-client.js';
+export { queryCrux } from './performance/crux-client.js';
+export { diagnosePerformanceRisks } from './performance/diagnosis.js';
+export { medianMetrics, medianOf } from './performance/median.js';
+export type { DetectRegressionOptions } from './performance/regression.js';
+export { detectRegression } from './performance/regression.js';
+export type { CruxMetrics, PerformanceBudget, PerformanceFinding, PerformanceImage, PerformancePageInput, PerformanceSeverity, } from './performance/types.js';
+export { securityAgent } from './security/agent.js';
+export { bumpDependencyVersion } from './security/bump-version.js';
+export type { DepsPatchInput, DepsPatchOutput, DepsPatchToolOptions, } from './security/deps-patch-tool.js';
+export { createDepsPatchTool } from './security/deps-patch-tool.js';
+export type { DepsScanInput, DepsScanOutput, DepsScanToolOptions, } from './security/deps-scan-tool.js';
+export { createDepsScanTool } from './security/deps-scan-tool.js';
+export type { EpssScore, QueryEpssOptions } from './security/epss-client.js';
+export { queryEpss } from './security/epss-client.js';
+export type { ExploitabilityAssessment, Urgency } from './security/exploitability.js';
+export { assessExploitability } from './security/exploitability.js';
+export type { OsvMatch, OsvVulnerability, QueryOsvOptions } from './security/osv-client.js';
+export { queryOsv } from './security/osv-client.js';
+export type { OpenPrOptions, PrClient, PrFile, PrResult } from './security/pr-client.js';
+export type { SecurityFinding, SecurityReport, SecurityReportEntry } from './security/report.js';
+export { buildSecurityReport } from './security/report.js';
+export type { SbomEntry } from './security/sbom.js';
+export { buildSbom } from './security/sbom.js';
+export { seoAgent } from './seo/agent.js';
+export { auditSeoPage } from './seo/audit.js';
+export type { CannibalizationCandidatePage, CannibalizationPair, DetectCannibalizationOptions, } from './seo/cannibalization.js';
+export { detectCannibalization } from './seo/cannibalization.js';
+export type { InternalLinkCandidatePage, InternalLinkProposal, InternalLinkSourcePage, ProposeInternalLinksOptions, } from './seo/internal-linking.js';
+export { proposeInternalLinks } from './seo/internal-linking.js';
+export type { ArticleJsonLdInput, ArticleJsonLdType, JsonLd } from './seo/json-ld.js';
+export { buildArticleJsonLd, validateJsonLd } from './seo/json-ld.js';
+export { validateLlmsTxt } from './seo/llms-txt.js';
+export { countWords, fleschReadingEase } from './seo/readability.js';
+export type { Redirect } from './seo/redirects.js';
+export { findOrphanedRedirects } from './seo/redirects.js';
+export { cosineSimilarity } from './seo/similarity.js';
+export type { SeoAuditResult, SeoFinding, SeoHeading, SeoImage, SeoIssueSeverity, SeoPageInput, } from './seo/types.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":"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"}

package/dist/index.js

@@ -0,0 +1,29 @@
+export { contentAgent } from './content/agent.js';
+export { createContentDraftTool } from './content/provenance.js';
+export { checkTerminology } from './content/terminology.js';
+export { suggestTopicGaps } from './content/topic-gaps.js';
+export { performanceAgent } from './performance/agent.js';
+export { compareToBudget } from './performance/budget.js';
+export { queryCrux } from './performance/crux-client.js';
+export { diagnosePerformanceRisks } from './performance/diagnosis.js';
+export { medianMetrics, medianOf } from './performance/median.js';
+export { detectRegression } from './performance/regression.js';
+export { securityAgent } from './security/agent.js';
+export { bumpDependencyVersion } from './security/bump-version.js';
+export { createDepsPatchTool } from './security/deps-patch-tool.js';
+export { createDepsScanTool } from './security/deps-scan-tool.js';
+export { queryEpss } from './security/epss-client.js';
+export { assessExploitability } from './security/exploitability.js';
+export { queryOsv } from './security/osv-client.js';
+export { buildSecurityReport } from './security/report.js';
+export { buildSbom } from './security/sbom.js';
+export { seoAgent } from './seo/agent.js';
+export { auditSeoPage } from './seo/audit.js';
+export { detectCannibalization } from './seo/cannibalization.js';
+export { proposeInternalLinks } from './seo/internal-linking.js';
+export { buildArticleJsonLd, validateJsonLd } from './seo/json-ld.js';
+export { validateLlmsTxt } from './seo/llms-txt.js';
+export { countWords, fleschReadingEase } from './seo/readability.js';
+export { findOrphanedRedirects } from './seo/redirects.js';
+export { cosineSimilarity } from './seo/similarity.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,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAO3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAEjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAS9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAMlE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAMnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AAEjE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAEnE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAGnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAM7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAOhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAEhE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAEpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/performance/agent.d.ts

@@ -0,0 +1,9 @@
+import { type AgentDeclaration } from '@cogenta/agents';
+/**
+ * "Point clé : il mesure le site déployé, pas un environnement local." No
+ * `content.write_draft` or `content.publish` in `tools` — this agent reports
+ * and proposes through `channel.send`/`build.trigger`, it never writes
+ * content itself.
+ */
+export declare const performanceAgent: AgentDeclaration;
+//# sourceMappingURL=agent.d.ts.map

package/dist/performance/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/performance/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,iBAAiB,CAAA;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,gBAU7B,CAAA"}

package/dist/performance/agent.js

@@ -0,0 +1,19 @@
+import { defineAgent } from '@cogenta/agents';
+/**
+ * "Point clé : il mesure le site déployé, pas un environnement local." No
+ * `content.write_draft` or `content.publish` in `tools` — this agent reports
+ * and proposes through `channel.send`/`build.trigger`, it never writes
+ * content itself.
+ */
+export const performanceAgent = defineAgent({
+    name: 'performance',
+    identity: './identity.md',
+    model: { preferred: 'claude-sonnet', fallback: 'local' },
+    tools: ['http.fetch', 'content.read', 'channel.send', 'build.trigger'],
+    skills: ['performance-diagnosis'],
+    autonomy: { default: 'propose' },
+    budget: { tokensPerDay: 100_000, eurPerMonth: 6, callsPerHour: 20 },
+    memory: { episodic: true, semantic: true, scope: 'site' },
+    triggers: [{ on: 'deploy.completed' }, { on: 'schedule', cron: '0 6 * * *' }],
+});
+//# sourceMappingURL=agent.js.map

package/dist/performance/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/performance/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAEpE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAqB,WAAW,CAAC;IAC5D,IAAI,EAAE,aAAa;IACnB,QAAQ,EAAE,eAAe;IACzB,KAAK,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE;IACxD,KAAK,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,CAAC;IACtE,MAAM,EAAE,CAAC,uBAAuB,CAAC;IACjC,QAAQ,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE;IAChC,MAAM,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE;IACnE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE;IACzD,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,kBAAkB,EAAE,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;CAC9E,CAAC,CAAA"}

package/dist/performance/budget.d.ts

@@ -0,0 +1,8 @@
+import type { CruxMetrics, PerformanceBudget, PerformanceFinding } from './types.js';
+/**
+ * A metric with no budget set, or no CrUX data at all, is silently skipped
+ * — neither is a finding. Only a measured metric that exceeds a budget the
+ * caller actually declared produces one.
+ */
+export declare function compareToBudget(metrics: CruxMetrics, budget: PerformanceBudget): readonly PerformanceFinding[];
+//# sourceMappingURL=budget.d.ts.map

package/dist/performance/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/performance/budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAiBpF;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,iBAAiB,GACxB,SAAS,kBAAkB,EAAE,CAe/B"}

package/dist/performance/budget.js

@@ -0,0 +1,29 @@
+const CHECKS = [
+    { check: 'lcp_budget', metric: 'lcpP75Ms', budgetField: 'lcpMs', label: 'LCP', unit: 'ms' },
+    { check: 'cls_budget', metric: 'clsP75', budgetField: 'clsScore', label: 'CLS', unit: '' },
+    { check: 'inp_budget', metric: 'inpP75Ms', budgetField: 'inpMs', label: 'INP', unit: 'ms' },
+    { check: 'ttfb_budget', metric: 'ttfbP75Ms', budgetField: 'ttfbMs', label: 'TTFB', unit: 'ms' },
+];
+/**
+ * A metric with no budget set, or no CrUX data at all, is silently skipped
+ * — neither is a finding. Only a measured metric that exceeds a budget the
+ * caller actually declared produces one.
+ */
+export function compareToBudget(metrics, budget) {
+    const findings = [];
+    for (const { check, metric, budgetField, label, unit } of CHECKS) {
+        const value = metrics[metric];
+        const limit = budget[budgetField];
+        if (value === undefined || limit === undefined)
+            continue;
+        if (value > limit) {
+            findings.push({
+                check,
+                severity: 'warning',
+                message: `${label} is ${value}${unit} (p75), over the ${limit}${unit} budget.`,
+            });
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=budget.js.map

package/dist/performance/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/performance/budget.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,GAA2B;IACrC,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE;IAC3F,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;IAC1F,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE;IAC3F,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE;CAChG,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAoB,EACpB,MAAyB;IAEzB,MAAM,QAAQ,GAAyB,EAAE,CAAA;IACzC,KAAK,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;QACjE,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAA;QACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;YAAE,SAAQ;QACxD,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK;gBACL,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,GAAG,KAAK,OAAO,KAAK,GAAG,IAAI,oBAAoB,KAAK,GAAG,IAAI,UAAU;aAC/E,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/performance/crux-client.d.ts

@@ -0,0 +1,21 @@
+import type { CruxMetrics } from './types.js';
+export type CruxFormFactor = 'PHONE' | 'DESKTOP' | 'TABLET';
+export interface QueryCruxOptions {
+    /** Injected — never hardcoded (R7). The caller sources this from wherever secrets are configured, never from the model's context. */
+    readonly apiKey: string;
+    readonly fetchImpl?: typeof fetch;
+    readonly formFactor?: CruxFormFactor;
+    readonly baseUrl?: string;
+}
+/**
+ * "Il mesure le site déployé, pas un environnement local." Real Core Web
+ * Vitals need either a headless browser (Lighthouse/Puppeteer — a heavy
+ * native dependency, R9/R10) or the Chrome UX Report API, which is
+ * real-user field data over plain HTTPS — no browser, and field data over
+ * synthetic/lab data is the better fit for "measures the deployed site"
+ * anyway. A 404 means CrUX has no data for this URL (not enough real-user
+ * traffic) — that is data, not an error, and returns empty metrics rather
+ * than throwing.
+ */
+export declare function queryCrux(url: string, options: QueryCruxOptions): Promise<CruxMetrics>;
+//# sourceMappingURL=crux-client.d.ts.map

package/dist/performance/crux-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crux-client.d.ts","sourceRoot":"","sources":["../../src/performance/crux-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,qIAAqI;IACrI,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAA;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAyBD;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAkC5F"}

package/dist/performance/crux-client.js

@@ -0,0 +1,56 @@
+import { CogentaError } from '@cogenta/core';
+function toMetrics(record) {
+    const metrics = record?.metrics;
+    const lcp = metrics?.largest_contentful_paint?.percentiles?.p75;
+    const cls = metrics?.cumulative_layout_shift?.percentiles?.p75;
+    const inp = metrics?.interaction_to_next_paint?.percentiles?.p75;
+    const ttfb = metrics?.experimental_time_to_first_byte?.percentiles?.p75;
+    return {
+        ...(lcp === undefined ? {} : { lcpP75Ms: lcp }),
+        ...(cls === undefined ? {} : { clsP75: cls }),
+        ...(inp === undefined ? {} : { inpP75Ms: inp }),
+        ...(ttfb === undefined ? {} : { ttfbP75Ms: ttfb }),
+    };
+}
+/**
+ * "Il mesure le site déployé, pas un environnement local." Real Core Web
+ * Vitals need either a headless browser (Lighthouse/Puppeteer — a heavy
+ * native dependency, R9/R10) or the Chrome UX Report API, which is
+ * real-user field data over plain HTTPS — no browser, and field data over
+ * synthetic/lab data is the better fit for "measures the deployed site"
+ * anyway. A 404 means CrUX has no data for this URL (not enough real-user
+ * traffic) — that is data, not an error, and returns empty metrics rather
+ * than throwing.
+ */
+export async function queryCrux(url, options) {
+    const doFetch = options.fetchImpl ?? fetch;
+    const baseUrl = options.baseUrl ?? 'https://chromeuxreport.googleapis.com/v1beta/records:queryRecord';
+    const endpoint = `${baseUrl}?key=${options.apiKey}`;
+    const response = await doFetch(endpoint, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({
+            url,
+            ...(options.formFactor === undefined ? {} : { formFactor: options.formFactor }),
+            metrics: [
+                'largest_contentful_paint',
+                'cumulative_layout_shift',
+                'interaction_to_next_paint',
+                'experimental_time_to_first_byte',
+            ],
+        }),
+    });
+    if (response.status === 404)
+        return {};
+    if (!response.ok) {
+        throw new CogentaError({
+            code: 'PERFORMANCE_CRUX_QUERY_FAILED',
+            message: `CrUX query for "${url}" failed with status ${response.status}.`,
+            hint: 'Check the API key and https://developers.google.com/speed/docs/insights/v5/about#crux-api-status.',
+            details: { status: response.status, url },
+        });
+    }
+    const body = (await response.json());
+    return toMetrics(body.record);
+}
+//# sourceMappingURL=crux-client.js.map

package/dist/performance/crux-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crux-client.js","sourceRoot":"","sources":["../../src/performance/crux-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAsB5C,SAAS,SAAS,CAAC,MAAiC;IAClD,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,CAAA;IAC/B,MAAM,GAAG,GAAG,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,GAAG,CAAA;IAC/D,MAAM,GAAG,GAAG,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,GAAG,CAAA;IAC9D,MAAM,GAAG,GAAG,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,GAAG,CAAA;IAChE,MAAM,IAAI,GAAG,OAAO,EAAE,+BAA+B,EAAE,WAAW,EAAE,GAAG,CAAA;IACvE,OAAO;QACL,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAC/C,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAC7C,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAC/C,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;KACnD,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,OAAyB;IACpE,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAA;IAC1C,MAAM,OAAO,GACX,OAAO,CAAC,OAAO,IAAI,kEAAkE,CAAA;IACvF,MAAM,QAAQ,GAAG,GAAG,OAAO,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAA;IAEnD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE;QACvC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,GAAG;YACH,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;YAC/E,OAAO,EAAE;gBACP,0BAA0B;gBAC1B,yBAAyB;gBACzB,2BAA2B;gBAC3B,iCAAiC;aAClC;SACF,CAAC;KACH,CAAC,CAAA;IAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,EAAE,CAAA;IAEtC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,+BAA+B;YACrC,OAAO,EAAE,mBAAmB,GAAG,wBAAwB,QAAQ,CAAC,MAAM,GAAG;YACzE,IAAI,EAAE,mGAAmG;YACzG,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE;SAC1C,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA+B,CAAA;IAClE,OAAO,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AAC/B,CAAC"}

package/dist/performance/diagnosis.d.ts

@@ -0,0 +1,18 @@
+import type { PerformanceFinding, PerformancePageInput } from './types.js';
+/**
+ * "Identification de la cause probable (image non optimisée, script tiers,
+ * bloc coûteux, requête lente)." CrUX is aggregate field data with no
+ * resource-level breakdown, so it cannot itself name a cause — this scans
+ * structural page metadata (already available via `content.read`) for
+ * known, well-established risk factors instead of profiling anything at
+ * runtime.
+ *
+ * "Bloc coûteux" (an expensive render block) and "requête lente" (a slow
+ * request) are deliberately not checked here: neither has a principled
+ * signal derivable from structural metadata alone — the first would need
+ * real DOM/render-cost data, the second real per-resource timing/waterfall
+ * data. Inventing a proxy for either would produce a finding this module
+ * cannot actually back, which is worse than not checking at all.
+ */
+export declare function diagnosePerformanceRisks(page: PerformancePageInput): readonly PerformanceFinding[];
+//# sourceMappingURL=diagnosis.d.ts.map

package/dist/performance/diagnosis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosis.d.ts","sourceRoot":"","sources":["../../src/performance/diagnosis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAM1E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,oBAAoB,GACzB,SAAS,kBAAkB,EAAE,CAqC/B"}