@cogenta/agents 0.1.2 → 0.2.1

package/dist/site-plan/propose-plan.js

@@ -0,0 +1,65 @@
+import { newId } from '@cogenta/schema';
+import { analyseBrief } from './analyse-brief.js';
+import { proposeContentModel } from './content-model.js';
+import { proposeDemoContent } from './demo-content.js';
+import { generateSkinCandidates } from './skin-candidates.js';
+export async function proposeSitePlan(options) {
+    const now = options.now ?? (() => new Date());
+    const newDraftId = options.idFactory ?? newId;
+    const analysed = await analyseBrief({
+        client: options.client,
+        model: options.model,
+        documents: options.documents,
+        ...(options.siteName === undefined ? {} : { siteName: options.siteName }),
+    });
+    if (!analysed.ok)
+        return { ok: false, stage: 'brief', reason: analysed.reason };
+    const brief = analysed.brief;
+    const skinDescription = [
+        brief.activity,
+        `Audience: ${brief.audience}.`,
+        `Tone: ${brief.tone}.`,
+    ].join(' ');
+    const [model, skins] = await Promise.all([
+        proposeContentModel({ client: options.client, model: options.model, brief }),
+        generateSkinCandidates({
+            client: options.client,
+            model: options.model,
+            description: skinDescription,
+            blueprintLabel: options.blueprintLabel ?? brief.activity,
+            ...(options.skinCount === undefined ? {} : { count: options.skinCount }),
+        }),
+    ]);
+    if (!model.ok)
+        return { ok: false, stage: 'contentModel', reason: model.reason };
+    if (!skins.ok)
+        return { ok: false, stage: 'skins', reason: skins.reason };
+    const demo = await proposeDemoContent({
+        client: options.client,
+        model: options.model,
+        brief,
+        contentModel: model.proposal,
+    });
+    const warnings = [
+        ...brief.warnings,
+        ...skins.failures.map((failure) => `The "${failure.label}" design was not offered: ${failure.reason}.`),
+        ...(demo.ok
+            ? demo.rejected.map((rejection) => `A demonstration entry for "${rejection.collection}" was dropped: ${rejection.reason}.`)
+            : [`No demonstration content was proposed: ${demo.reason}.`]),
+    ];
+    return {
+        ok: true,
+        draft: {
+            id: newDraftId(),
+            createdAt: now().toISOString(),
+            brief,
+            contentModel: model.proposal,
+            pages: model.pages,
+            skins: skins.candidates,
+            demoContent: demo.ok ? demo.entries : [],
+            violations: model.violations,
+            warnings,
+        },
+    };
+}
+//# sourceMappingURL=propose-plan.js.map

package/dist/site-plan/propose-plan.js.map

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

package/dist/site-plan/skin-candidates.d.ts

@@ -0,0 +1,61 @@
+import type { ProviderClient } from '../providers/types.js';
+import type { SkinCandidate } from './types.js';
+/**
+ * L19 task 3 — "l'utilisateur voit et choisit explicitement entre deux et
+ * cinq gabarits proposés, jamais un seul choix imposé."
+ *
+ * This is a widening of `generateSkin`, not a replacement of it: each
+ * candidate goes through that function's own generate-validate-correct loop
+ * against contract D, unchanged, so an invalid candidate is still rejected
+ * and regenerated exactly as before. What is new is that several are asked
+ * for at once, each steered towards a different design direction, and that a
+ * candidate list is only offered when at least two genuinely distinct skins
+ * survived validation — offering "a choice" of one, or of the same skin
+ * twice, would be a lie about what the human is choosing between.
+ */
+export interface SkinDirection {
+    readonly id: string;
+    readonly label: string;
+    /** Appended to the site description, as guidance for this candidate only. */
+    readonly direction: string;
+}
+/**
+ * Five directions, ordered. Asking one model for "three different skins"
+ * in one call reliably produces three near-identical ones; asking three
+ * times with three genuinely different briefs does not. They are written as
+ * design intent rather than as colour values, because the model fills in
+ * contract D's tokens and `validateSkin` judges the contrast — naming
+ * hex codes here would fight both.
+ */
+export declare const SKIN_DIRECTIONS: readonly SkinDirection[];
+export declare const MIN_SKIN_CANDIDATES = 2;
+export declare const MAX_SKIN_CANDIDATES = 5;
+export interface GenerateSkinCandidatesOptions {
+    readonly client: ProviderClient;
+    readonly model: string;
+    /** Free text: sector, mood, audience, optional brand colours — the same input `generateSkin` takes. */
+    readonly description: string;
+    readonly blueprintLabel: string;
+    /** Clamped to 2..5. Defaults to 3. */
+    readonly count?: number;
+    /** Passed to each candidate's own validation loop. */
+    readonly maxAttemptsPerCandidate?: number;
+}
+export interface SkinCandidateFailure {
+    readonly id: string;
+    readonly label: string;
+    readonly reason: string;
+}
+export type GenerateSkinCandidatesResult = {
+    readonly ok: true;
+    readonly candidates: readonly SkinCandidate[];
+    readonly failures: readonly SkinCandidateFailure[];
+} | {
+    readonly ok: false;
+    readonly reason: string;
+    /** Whatever did survive — one candidate, or none. Never offered as a choice, but reported. */
+    readonly candidates: readonly SkinCandidate[];
+    readonly failures: readonly SkinCandidateFailure[];
+};
+export declare function generateSkinCandidates(options: GenerateSkinCandidatesOptions): Promise<GenerateSkinCandidatesResult>;
+//# sourceMappingURL=skin-candidates.d.ts.map

package/dist/site-plan/skin-candidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skin-candidates.d.ts","sourceRoot":"","sources":["../../src/site-plan/skin-candidates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EA+BnD,CAAA;AAED,eAAO,MAAM,mBAAmB,IAAI,CAAA;AACpC,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAEpC,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,uGAAuG;IACvG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,sDAAsD;IACtD,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;CAC1C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,4BAA4B,GACpC;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;IACjB,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAA;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAA;CACnD,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,8FAA8F;IAC9F,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAA;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAA;CACnD,CAAA;AAOL,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,4BAA4B,CAAC,CA6DvC"}

package/dist/site-plan/skin-candidates.js

@@ -0,0 +1,99 @@
+import { generateSkin } from '../skin/generate.js';
+/**
+ * Five directions, ordered. Asking one model for "three different skins"
+ * in one call reliably produces three near-identical ones; asking three
+ * times with three genuinely different briefs does not. They are written as
+ * design intent rather than as colour values, because the model fills in
+ * contract D's tokens and `validateSkin` judges the contrast — naming
+ * hex codes here would fight both.
+ */
+export const SKIN_DIRECTIONS = [
+    {
+        id: 'editorial',
+        label: 'Warm editorial',
+        direction: 'Warm and editorial: a generous type scale, a paper-like background rather than pure white, a single restrained accent colour, comfortable density.',
+    },
+    {
+        id: 'clinical',
+        label: 'Clean and clinical',
+        direction: 'Clean and clinical: a near-neutral palette, a tight type scale, compact density, a cool accent used sparingly, sharp corners.',
+    },
+    {
+        id: 'bold',
+        label: 'Bold and graphic',
+        direction: 'Bold and graphic: a strongly saturated accent, a large type scale with a marked jump between steps, generous radius, high contrast throughout.',
+    },
+    {
+        id: 'quiet',
+        label: 'Quiet and minimal',
+        direction: 'Quiet and minimal: near-monochrome, very low chroma, wide spacing, a small type scale, almost no radius, motion kept to the minimum.',
+    },
+    {
+        id: 'classic',
+        label: 'Classic and formal',
+        direction: 'Classic and formal: deep neutral tones, a conservative type scale, a serif heading stack, moderate density, understated accent.',
+    },
+];
+export const MIN_SKIN_CANDIDATES = 2;
+export const MAX_SKIN_CANDIDATES = 5;
+function clampCount(count) {
+    if (count === undefined)
+        return 3;
+    return Math.min(MAX_SKIN_CANDIDATES, Math.max(MIN_SKIN_CANDIDATES, Math.trunc(count)));
+}
+export async function generateSkinCandidates(options) {
+    const directions = SKIN_DIRECTIONS.slice(0, clampCount(options.count));
+    // Run in parallel: the installer's whole promise is measured in seconds,
+    // and five sequential three-attempt loops is a minute of staring at a
+    // spinner. Each call is independent — no candidate reads another's result.
+    const settled = await Promise.all(directions.map(async (direction) => {
+        const result = await generateSkin({
+            client: options.client,
+            model: options.model,
+            description: `${options.description}\n\nDesign direction for this proposal: ${direction.direction}`,
+            blueprintLabel: options.blueprintLabel,
+            ...(options.maxAttemptsPerCandidate === undefined
+                ? {}
+                : { maxAttempts: options.maxAttemptsPerCandidate }),
+        });
+        return { direction, result };
+    }));
+    const candidates = [];
+    const failures = [];
+    const seen = new Set();
+    for (const { direction, result } of settled) {
+        if (!result.ok) {
+            failures.push({ id: direction.id, label: direction.label, reason: result.reason });
+            continue;
+        }
+        const fingerprint = JSON.stringify(result.tokens);
+        if (seen.has(fingerprint)) {
+            failures.push({
+                id: direction.id,
+                label: direction.label,
+                reason: 'it came back identical to another candidate, so it would not have been a choice',
+            });
+            continue;
+        }
+        seen.add(fingerprint);
+        candidates.push({
+            id: direction.id,
+            label: direction.label,
+            rationale: direction.direction,
+            tokens: result.tokens,
+            attempts: result.attempts,
+        });
+    }
+    if (candidates.length < MIN_SKIN_CANDIDATES) {
+        return {
+            ok: false,
+            reason: candidates.length === 0
+                ? 'no candidate passed contract D validation'
+                : 'only one candidate passed contract D validation, which is not a choice',
+            candidates,
+            failures,
+        };
+    }
+    return { ok: true, candidates, failures };
+}
+//# sourceMappingURL=skin-candidates.js.map

package/dist/site-plan/skin-candidates.js.map

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

package/dist/site-plan/types.d.ts

@@ -0,0 +1,93 @@
+import type { SkinTokens } from '@cogenta/render';
+import type { CollectionDefinition } from '@cogenta/schema';
+import type { DocumentFormat } from '../documents/extract-text.js';
+import type { DetectedConstraint } from './constraints.js';
+/**
+ * The shapes L19's four agents pass between each other.
+ *
+ * Nothing here is ever applied. Every one of these is a **draft**: the plan
+ * exists so a human can read it, accept parts of it and refuse others
+ * (`./approval.js`), and only what they accepted is ever handed to a
+ * scaffolder or a schema writer. R6 is not a review step bolted on at the
+ * end — it is why these types are separate from `CollectionDefinition` in
+ * the first place.
+ */
+export interface BriefSource {
+    readonly filename: string;
+    readonly format: DocumentFormat;
+    readonly characters: number;
+    readonly truncated: boolean;
+}
+export interface BriefPage {
+    readonly title: string;
+    readonly purpose: string;
+}
+export interface BriefContentType {
+    readonly name: string;
+    readonly description: string;
+}
+/** What the analysis agent understood, plus what was read out of the document without it. */
+export interface SiteBrief {
+    /** The kind of activity the site is for, in the document's own terms. */
+    readonly activity: string;
+    readonly audience: string;
+    readonly tone: string;
+    /** BCP-47-ish locale codes. Constrained by a `language` constraint when the document states one. */
+    readonly languages: readonly string[];
+    readonly pages: readonly BriefPage[];
+    readonly contentTypes: readonly BriefContentType[];
+    /** Deterministically scanned from the document first, then whatever the model added. */
+    readonly constraints: readonly DetectedConstraint[];
+    readonly summary: string;
+    readonly sources: readonly BriefSource[];
+    readonly warnings: readonly string[];
+}
+export interface ProposedCollection {
+    /** A real contract A collection, built by `defineCollection` — never a parallel format. */
+    readonly definition: CollectionDefinition;
+    /** Why the agent proposed it, in one sentence, for the human reading the plan. */
+    readonly rationale: string;
+}
+export interface ContentModelProposal {
+    readonly collections: readonly ProposedCollection[];
+}
+export interface ProposedPage {
+    readonly title: string;
+    readonly slug: string;
+    readonly purpose: string;
+}
+export interface SkinCandidate {
+    readonly id: string;
+    /** A short name a human can pick by: "Warm editorial", "Clinical mono". */
+    readonly label: string;
+    readonly rationale: string;
+    readonly tokens: SkinTokens;
+    /** How many generate/validate rounds this candidate needed. */
+    readonly attempts: number;
+}
+export interface DemoEntry {
+    readonly collection: string;
+    readonly values: Readonly<Record<string, unknown>>;
+}
+/** Everything the planner produced, before any human has looked at it. */
+export interface SitePlanDraft {
+    readonly id: string;
+    readonly createdAt: string;
+    readonly brief: SiteBrief;
+    readonly contentModel: ContentModelProposal;
+    readonly pages: readonly ProposedPage[];
+    readonly skins: readonly SkinCandidate[];
+    readonly demoContent: readonly DemoEntry[];
+    /** What was removed or flagged because it contradicted an explicit constraint. */
+    readonly violations: readonly ConstraintViolation[];
+    readonly warnings: readonly string[];
+}
+export interface ConstraintViolation {
+    readonly constraint: DetectedConstraint;
+    /** What the model proposed that contradicted it. */
+    readonly proposed: string;
+    /** `'removed'`: dropped from the plan before the human ever saw it. `'flagged'`: kept, but marked. */
+    readonly action: 'removed' | 'flagged';
+    readonly explanation: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/site-plan/types.d.ts.map

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

package/dist/site-plan/types.js

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

package/dist/site-plan/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cogenta/agents",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "The agentic runtime: LLM provider abstraction, tool-calling, execution loop, permissions, memory, budgets, audit.",
   "license": "MPL-2.0",
   "type": "module",
@@ -28,8 +28,9 @@
   },
   "dependencies": {
     "zod": "^4.4.3",
-    "@cogenta/core": "0.2.0",
-    "@cogenta/render": "0.1.2"
+    "@cogenta/core": "0.4.0",
+    "@cogenta/schema": "0.3.0",
+    "@cogenta/render": "0.1.4"
   },
   "devDependencies": {
     "typescript": "^7.0.2",