@cogenta/agents-builtin 0.4.0 → 0.5.0

package/dist/theme-creator/generate-theme-candidates.d.ts

@@ -47,6 +47,26 @@ export interface GenerateThemeCandidatesInput {
         readonly sandboxId: string;
         readonly path: string;
     }) => Promise<void>;
+    /** Threaded straight through to `generateSandboxTheme`, where it becomes the run's `theme.preview_sandbox` tool — the difference between a writer that sees its own output and one that does not. */
+    readonly renderPreview?: (input: {
+        readonly sandboxId: string;
+    }) => Promise<{
+        readonly ok: true;
+        readonly html: string;
+    } | {
+        readonly ok: false;
+        readonly error: string;
+    }>;
+    /** The site's real content model, forwarded so a generated theme fetches what this site actually stores instead of inventing collections. */
+    readonly contentModel?: string;
+    /** Also threaded through — together they let a run change an existing theme instead of only writing a new one. */
+    readonly listFiles?: (input: {
+        readonly sandboxId: string;
+    }) => Promise<readonly string[]>;
+    readonly readFile?: (input: {
+        readonly sandboxId: string;
+        readonly path: string;
+    }) => Promise<string>;
     readonly onProgress?: ProgressReporter;
     readonly auditLog?: AuditLogLike;
     readonly signal?: AbortSignal;
@@ -57,7 +77,10 @@ export type ThemeCandidate = ({
     readonly kind: 'sandbox';
     readonly id: string;
     readonly label: string;
+    /** The agent's whole closing text — for the conversation, where it has room. */
     readonly rationale: string;
+    /** The card-sized version of it, guaranteed short. */
+    readonly summary: string;
     readonly sandboxId: string;
     readonly filesWritten: readonly string[];
 };

package/dist/theme-creator/generate-theme-candidates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-theme-candidates.d.ts","sourceRoot":"","sources":["../../src/theme-creator/generate-theme-candidates.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EAGjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EAEnB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC7B,MAAM,iBAAiB,CAAA;AAGxB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,eAAe,EAAE,SAAS,uBAAuB,EAAE,CAAA;IAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAA;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;IAC5F,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,gIAAgI;IAChI,QAAQ,CAAC,aAAa,EAAE,MAAM,MAAM,CAAA;IACpC,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE;QAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KACzB,KAAK,OAAO,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACxC,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE;QAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KACtB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACnB,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,MAAM,MAAM,cAAc,GACtB,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG,qBAAqB,CAAC,GACrD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;CACzC,CAAA;AAEL,MAAM,MAAM,6BAA6B,GACrC;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;IACjB,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAA;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,qIAAqI;IACrI,QAAQ,CAAC,cAAc,EAAE;QAAE,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1F,GACD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnD,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CAgHxC"}
+{"version":3,"file":"generate-theme-candidates.d.ts","sourceRoot":"","sources":["../../src/theme-creator/generate-theme-candidates.ts"],"names":[],"mappings":"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"}

package/dist/theme-creator/generate-theme-candidates.js

@@ -39,6 +39,17 @@ export async function generateThemeCandidates(input) {
     };
     const warnings = [...classification.processed.warnings];
     const candidates = [];
+    // One answer unless more were asked for. A live run made the case against
+    // the old behaviour better than any argument could: a request for "un thème
+    // complet à partir du design sur la capture" came back as the one real
+    // custom layout plus three recolours of an installed blog theme, and the
+    // answer was buried among alternatives nobody wanted. The classifier reads
+    // the brief for an explicit count; everything else gets exactly one.
+    // Defended rather than trusted, even though the type says it is always
+    // there: this number is a loop bound, and an `undefined` one silently
+    // produces zero candidates — a feature that answers with nothing at all
+    // rather than with an error anyone could act on.
+    const requestedVariants = classification.requestedVariants ?? 1;
     async function tryTokensCandidates() {
         const result = await proposeThemeCandidates({
             client: input.client,
@@ -48,7 +59,9 @@ export async function generateThemeCandidates(input) {
             availableThemes: input.availableThemes,
             ...(input.attachments === undefined ? {} : { attachments: input.attachments }),
             ...(input.baseline === undefined ? {} : { baseline: input.baseline }),
-            ...(input.maxCandidates === undefined ? {} : { maxCandidates: input.maxCandidates }),
+            // The brief's own count wins; an explicit caller-supplied ceiling
+            // still overrides it, which is what keeps existing callers unchanged.
+            maxCandidates: input.maxCandidates ?? requestedVariants,
             ...(input.onProgress === undefined ? {} : { onProgress: input.onProgress }),
         });
         if (!result.ok) {
@@ -62,7 +75,9 @@ export async function generateThemeCandidates(input) {
     }
     async function trySandboxCandidate() {
         const sandboxId = input.mintSandboxId();
-        progress.report(`Writing a custom layout into sandbox "${sandboxId}"…`);
+        progress.report(`Writing a custom layout into sandbox "${sandboxId}"…`, {
+            kind: 'stage',
+        });
         const result = await generateSandboxTheme({
             client: input.client,
             model: input.model,
@@ -71,6 +86,10 @@ export async function generateThemeCandidates(input) {
             sandboxId,
             writeFile: input.writeFile,
             deleteFile: input.deleteFile,
+            ...(input.renderPreview === undefined ? {} : { renderPreview: input.renderPreview }),
+            ...(input.contentModel === undefined ? {} : { contentModel: input.contentModel }),
+            ...(input.listFiles === undefined ? {} : { listFiles: input.listFiles }),
+            ...(input.readFile === undefined ? {} : { readFile: input.readFile }),
             ...(input.attachments === undefined ? {} : { attachments: input.attachments }),
             ...(input.onProgress === undefined ? {} : { onProgress: input.onProgress }),
             ...(input.auditLog === undefined ? {} : { auditLog: input.auditLog }),
@@ -85,16 +104,20 @@ export async function generateThemeCandidates(input) {
             id: result.sandboxId,
             label: 'Custom layout',
             rationale: result.rationale,
+            summary: result.summary,
             sandboxId: result.sandboxId,
             filesWritten: result.filesWritten,
         });
     }
     if (needsCustomLayout) {
-        // Sandbox generation first — it is the point of this request, and the
-        // slower, more expensive of the two; the tokens-only fallback runs
-        // after so a failure in one never blocks the other from being reported.
-        await trySandboxCandidate();
-        await tryTokensCandidates();
+        for (let index = 0; index < requestedVariants; index++) {
+            await trySandboxCandidate();
+        }
+        // Only as a rescue: if writing a custom layout produced nothing at all,
+        // a tokens-only proposal is still better than an empty screen. When the
+        // custom layout worked, adding recolours beside it is noise.
+        if (candidates.length === 0)
+            await tryTokensCandidates();
     }
     else {
         await tryTokensCandidates();

package/dist/theme-creator/generate-theme-candidates.js.map

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

package/dist/theme-creator/preview-sandbox-tool.d.ts

@@ -0,0 +1,57 @@
+import { type ToolDefinition } from '@cogenta/agents';
+import { z } from 'zod';
+/**
+ * The feedback signal the theme writer never had.
+ *
+ * Before this tool, a generation run was open-loop: the model wrote files and
+ * heard back only "written" or a structural rejection (module failed to load,
+ * manifest field wrong). It never saw the page its own code produced, which
+ * is why asking it to reproduce a reference screenshot behaved like asking
+ * someone to paint blindfolded — no amount of prompt work fixes a control
+ * loop with no measurement in it.
+ *
+ * `renderSandboxPreview` (`@cogenta/cli`'s `theme-sandbox.ts`) already
+ * rendered a sandbox theme to real HTML in an isolated module, and the admin
+ * preview screen already used it. This exposes exactly that, unchanged, as a
+ * tool — so the writer can render, read what it actually produced, and
+ * correct it before finishing.
+ *
+ * Read-only by construction: `sideEffects: false`, no `revert` to have, and
+ * the injected `renderPreview` neither writes to the sandbox nor touches
+ * `themes/`. The HTML it returns is this theme's own output against a fixed
+ * demo page — never real site content, so nothing a visitor stored can reach
+ * the model through it.
+ */
+export interface PreviewSandboxToolOptions {
+    /** Exactly `renderSandboxPreview`'s own result shape (`@cogenta/cli`), threaded in as a plain function — this package cannot import `@cogenta/cli`, the dependency arrow runs the other way. The returned HTML is a whole document, the theme's stylesheet included inline. */
+    readonly renderPreview: (input: {
+        readonly sandboxId: string;
+    }) => Promise<{
+        readonly ok: true;
+        readonly html: string;
+    } | {
+        readonly ok: false;
+        readonly error: string;
+    }>;
+    /**
+     * Guard against one render filling the whole context window: a theme that
+     * loops over demo entries can emit a lot of markup, and the model needs
+     * enough to judge structure, not every last node.
+     */
+    readonly maxHtmlChars?: number;
+}
+declare const PreviewSandboxInputSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+}, z.core.$strip>;
+export type PreviewSandboxInput = z.infer<typeof PreviewSandboxInputSchema>;
+declare const PreviewSandboxOutputSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    html: z.ZodOptional<z.ZodString>;
+    hasStylesheet: z.ZodOptional<z.ZodBoolean>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PreviewSandboxOutput = z.infer<typeof PreviewSandboxOutputSchema>;
+export declare function createPreviewSandboxTool(options: PreviewSandboxToolOptions): ToolDefinition<PreviewSandboxInput, PreviewSandboxOutput>;
+export {};
+//# sourceMappingURL=preview-sandbox-tool.d.ts.map

package/dist/theme-creator/preview-sandbox-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-sandbox-tool.d.ts","sourceRoot":"","sources":["../../src/theme-creator/preview-sandbox-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,yBAAyB;IACxC,+QAA+Q;IAC/Q,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE;QAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAC3B,KAAK,OAAO,CACX;QAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAC9F,CAAA;IACD;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAID,QAAA,MAAM,yBAAyB;;iBAE7B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE3E,QAAA,MAAM,0BAA0B;;;;;;iBAO9B,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAE7E,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,cAAc,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,CAgC3D"}

package/dist/theme-creator/preview-sandbox-tool.js

@@ -0,0 +1,48 @@
+import { defineTool } from '@cogenta/agents';
+import { z } from 'zod';
+const DEFAULT_MAX_HTML_CHARS = 12_000;
+const PreviewSandboxInputSchema = z.object({
+    sandboxId: z.string().min(1),
+});
+const PreviewSandboxOutputSchema = z.object({
+    ok: z.boolean(),
+    html: z.string().optional(),
+    /** `false` means the rendered document carries no stylesheet at all — the theme will render as unstyled text no matter how good its markup is, and that is worth saying outright rather than leaving the model to notice. */
+    hasStylesheet: z.boolean().optional(),
+    truncated: z.boolean().optional(),
+    error: z.string().optional(),
+});
+export function createPreviewSandboxTool(options) {
+    const limit = options.maxHtmlChars ?? DEFAULT_MAX_HTML_CHARS;
+    return defineTool({
+        name: 'theme.preview_sandbox',
+        version: '1.0.0',
+        description: `Renders the theme currently written in a sandbox and returns the real HTML it produces, against a fixed demo page. This is the only way to find out what the theme you just wrote actually looks like — writing a file only reports that it was accepted, never that it renders the design you intended.
+
+Call it after the theme's files are in place, and again after any correction. Read the returned markup as the page a visitor would get: check that the regions you designed are really there and really nested the way you meant, that no section silently rendered empty, and that the class names your CSS targets are the class names the markup actually carries — a selector that matches nothing is the single most common reason a written theme renders as unstyled text.
+
+A render failure comes back with the real error message: fix the file it names and preview again. Never finish a run on a sandbox whose last preview failed.`,
+        input: PreviewSandboxInputSchema,
+        output: PreviewSandboxOutputSchema,
+        permissions: ['theme.write_sandbox'],
+        sideEffects: false,
+        // Nothing to undo: this tool only reads. `false` here is the honest
+        // declaration for a read-only tool, not a refusal to support undo.
+        reversible: false,
+        cost: 'low',
+        async execute(input) {
+            const result = await options.renderPreview({ sandboxId: input.sandboxId });
+            if (!result.ok) {
+                return { ok: false, error: result.error };
+            }
+            const truncated = result.html.length > limit;
+            return {
+                ok: true,
+                html: truncated ? `${result.html.slice(0, limit)}\n<!-- …truncated -->` : result.html,
+                hasStylesheet: /<style[\s>]/u.test(result.html),
+                truncated,
+            };
+        },
+    });
+}
+//# sourceMappingURL=preview-sandbox-tool.js.map

package/dist/theme-creator/preview-sandbox-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-sandbox-tool.js","sourceRoot":"","sources":["../../src/theme-creator/preview-sandbox-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuB,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAwCvB,MAAM,sBAAsB,GAAG,MAAM,CAAA;AAErC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC7B,CAAC,CAAA;AAGF,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,6NAA6N;IAC7N,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAA;AAGF,MAAM,UAAU,wBAAwB,CACtC,OAAkC;IAElC,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,IAAI,sBAAsB,CAAA;IAC5D,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE;;;;6JAI4I;QACzJ,KAAK,EAAE,yBAAyB;QAChC,MAAM,EAAE,0BAA0B;QAClC,WAAW,EAAE,CAAC,qBAAqB,CAAC;QACpC,WAAW,EAAE,KAAK;QAClB,oEAAoE;QACpE,mEAAmE;QACnE,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE,KAAK;QACX,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAA;YAC1E,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAA;YAC3C,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;YAC5C,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI;gBACrF,aAAa,EAAE,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBAC/C,SAAS;aACV,CAAA;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/theme-creator/read-sandbox-tool.d.ts

@@ -0,0 +1,57 @@
+import { type ToolDefinition } from '@cogenta/agents';
+import { z } from 'zod';
+/**
+ * What was missing for a theme to be *adjusted* rather than only created.
+ *
+ * The sandbox tools could write a file and render the result, but never read
+ * one back. Inside a single generation run that is survivable — the agent
+ * still has its own transcript, so it knows what it wrote. Across a second
+ * conversation turn ("make it darker", "put the grid on two columns") it is
+ * fatal: the agent is handed a theme it has never seen, and its only options
+ * are to guess or to rewrite the whole thing from scratch, throwing away
+ * every decision the operator just approved.
+ *
+ * Two tools, because listing and reading are genuinely different questions
+ * and a model asked to "read the theme" should not have to guess filenames:
+ * `theme.list_sandbox_files` answers "what is in here", and
+ * `theme.read_sandbox_file` answers "what does this one say".
+ *
+ * Both are read-only (`sideEffects: false`) and confined to one sandbox
+ * directory — the same directory `theme.write_sandbox_file` already writes
+ * to, with the same host-side path-escape guard in `@cogenta/cli`, which is
+ * where the real filesystem lives.
+ */
+export interface ReadSandboxToolsOptions {
+    readonly listFiles: (input: {
+        readonly sandboxId: string;
+    }) => Promise<readonly string[]>;
+    readonly readFile: (input: {
+        readonly sandboxId: string;
+        readonly path: string;
+    }) => Promise<string>;
+    /** A theme file that is genuinely enormous is truncated rather than allowed to crowd out the rest of the conversation. */
+    readonly maxFileChars?: number;
+}
+declare const ListInputSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+}, z.core.$strip>;
+export type ListSandboxFilesInput = z.infer<typeof ListInputSchema>;
+declare const ListOutputSchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type ListSandboxFilesOutput = z.infer<typeof ListOutputSchema>;
+declare const ReadInputSchema: z.ZodObject<{
+    sandboxId: z.ZodString;
+    path: z.ZodString;
+}, z.core.$strip>;
+export type ReadSandboxFileInput = z.infer<typeof ReadInputSchema>;
+declare const ReadOutputSchema: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodString;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ReadSandboxFileOutput = z.infer<typeof ReadOutputSchema>;
+export declare function createListSandboxFilesTool(options: Pick<ReadSandboxToolsOptions, 'listFiles'>): ToolDefinition<ListSandboxFilesInput, ListSandboxFilesOutput>;
+export declare function createReadSandboxFileTool(options: Pick<ReadSandboxToolsOptions, 'readFile' | 'maxFileChars'>): ToolDefinition<ReadSandboxFileInput, ReadSandboxFileOutput>;
+export {};
+//# sourceMappingURL=read-sandbox-tool.d.ts.map

package/dist/theme-creator/read-sandbox-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-sandbox-tool.d.ts","sourceRoot":"","sources":["../../src/theme-creator/read-sandbox-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;IACzF,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE;QACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KACtB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACrB,0HAA0H;IAC1H,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAID,QAAA,MAAM,eAAe;;iBAA6C,CAAA;AAClE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,QAAA,MAAM,gBAAgB;;iBAA2C,CAAA;AACjE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAErE,QAAA,MAAM,eAAe;;;iBAInB,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAElE,QAAA,MAAM,gBAAgB;;;;iBAIpB,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEpE,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,WAAW,CAAC,GAClD,cAAc,CAAC,qBAAqB,EAAE,sBAAsB,CAAC,CAe/D;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,UAAU,GAAG,cAAc,CAAC,GAClE,cAAc,CAAC,oBAAoB,EAAE,qBAAqB,CAAC,CAsB7D"}

package/dist/theme-creator/read-sandbox-tool.js

@@ -0,0 +1,55 @@
+import { defineTool } from '@cogenta/agents';
+import { z } from 'zod';
+const DEFAULT_MAX_FILE_CHARS = 24_000;
+const ListInputSchema = z.object({ sandboxId: z.string().min(1) });
+const ListOutputSchema = z.object({ files: z.array(z.string()) });
+const ReadInputSchema = z.object({
+    sandboxId: z.string().min(1),
+    /** Sandbox-relative, exactly as `theme.list_sandbox_files` returned it. */
+    path: z.string().min(1),
+});
+const ReadOutputSchema = z.object({
+    path: z.string(),
+    content: z.string(),
+    truncated: z.boolean().optional(),
+});
+export function createListSandboxFilesTool(options) {
+    return defineTool({
+        name: 'theme.list_sandbox_files',
+        version: '1.0.0',
+        description: `Lists every file currently in a theme sandbox, as sandbox-relative paths. Call it first when you are changing a theme you did not write in this conversation — you cannot correct a file whose name you had to guess, and a theme's stylesheet can be called anything.`,
+        input: ListInputSchema,
+        output: ListOutputSchema,
+        permissions: ['theme.write_sandbox'],
+        sideEffects: false,
+        reversible: false,
+        cost: 'low',
+        async execute(input) {
+            return { files: [...(await options.listFiles({ sandboxId: input.sandboxId }))] };
+        },
+    });
+}
+export function createReadSandboxFileTool(options) {
+    const limit = options.maxFileChars ?? DEFAULT_MAX_FILE_CHARS;
+    return defineTool({
+        name: 'theme.read_sandbox_file',
+        version: '1.0.0',
+        description: `Returns the current contents of one file in a theme sandbox. Read a file before changing it: a write replaces the whole file, so editing from memory — or from what you assume a previous run wrote — silently drops everything you did not happen to reproduce. When a request asks to adjust part of a theme, read the file, change that part, and write the whole corrected file back.`,
+        input: ReadInputSchema,
+        output: ReadOutputSchema,
+        permissions: ['theme.write_sandbox'],
+        sideEffects: false,
+        reversible: false,
+        cost: 'low',
+        async execute(input) {
+            const content = await options.readFile({ sandboxId: input.sandboxId, path: input.path });
+            const truncated = content.length > limit;
+            return {
+                path: input.path,
+                content: truncated ? `${content.slice(0, limit)}\n/* …truncated */` : content,
+                truncated,
+            };
+        },
+    });
+}
+//# sourceMappingURL=read-sandbox-tool.js.map

package/dist/theme-creator/read-sandbox-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-sandbox-tool.js","sourceRoot":"","sources":["../../src/theme-creator/read-sandbox-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuB,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAkCvB,MAAM,sBAAsB,GAAG,MAAM,CAAA;AAErC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AAGlE,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAA;AAGjE,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,2EAA2E;IAC3E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACxB,CAAC,CAAA;AAGF,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAA;AAGF,MAAM,UAAU,0BAA0B,CACxC,OAAmD;IAEnD,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,wQAAwQ;QACrR,KAAK,EAAE,eAAe;QACtB,MAAM,EAAE,gBAAgB;QACxB,WAAW,EAAE,CAAC,qBAAqB,CAAC;QACpC,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE,KAAK;QACX,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAClF,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,OAAmE;IAEnE,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,IAAI,sBAAsB,CAAA;IAC5D,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,2XAA2X;QACxY,KAAK,EAAE,eAAe;QACtB,MAAM,EAAE,gBAAgB;QACxB,WAAW,EAAE,CAAC,qBAAqB,CAAC;QACpC,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE,KAAK;QACX,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;YACxF,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,KAAK,CAAA;YACxC,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,OAAO;gBAC7E,SAAS;aACV,CAAA;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/theme-creator/theme-spec.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The structure and composition of a Cogenta theme, as one standing
+ * specification handed to the model in the system prompt's own
+ * `<specification>` section (`assembleContext`, `@cogenta/agents`).
+ *
+ * **Why this file exists.** Every fact below already existed — scattered
+ * across `theme.write_sandbox_file`'s tool `description`, a 311-line
+ * `identity.md` no admin flow ever loads, and the contract D docs. A live
+ * report ("I attach a screenshot and what comes back is nowhere near it")
+ * traced back to that scattering: a tool description is read as API
+ * reference for one call, not as standing knowledge about what is being
+ * built, and the writer agent's actual system prompt was a one-sentence role
+ * plus ten bullets. The tool description keeps only what belongs to the
+ * tool (its arguments and what it rejects); everything about what a theme
+ * *is* lives here.
+ *
+ * **The palette rule reversed, deliberately.** The previous brief told the
+ * model "colour/font/spacing VALUES are not invented here — reference
+ * --cogenta-*". Those custom properties are generated exclusively from the
+ * *site's* skin (`theme-wiring.ts`'s `computeEffectiveStyles`), so a theme
+ * asked to reproduce a specific design was structurally repainted in
+ * whatever palette the site already had — the single largest cause of "far
+ * from the screenshot", and no amount of layout accuracy could compensate.
+ * A theme's own stylesheet is emitted *after* the skin stylesheet
+ * (`joinStyles`, `theme-render.ts`), so a theme can and should carry its own
+ * design palette. The namespaced pattern below keeps the site's brand colours
+ * reachable rather than simply overwriting `--cogenta-*` at `:root`, which
+ * would silently disable the operator's own colour controls.
+ */
+export declare const COGENTA_THEME_SPECIFICATION: string;
+//# sourceMappingURL=theme-spec.d.ts.map

package/dist/theme-creator/theme-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-spec.d.ts","sourceRoot":"","sources":["../../src/theme-creator/theme-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,2BAA2B,QA+NhC,CAAA"}