@avocadostudio-ai/orchestrator-core 0.1.0

package/dist/agent/sites-agent-shared.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Shared utilities for site-agent tools — used by both the Agent SDK MCP server
+ * and the standalone stdio MCP server (CLI mode).
+ *
+ * Contains: prop validation/correction, CSS patching, port allocation, site ID sanitization.
+ */
+export declare function sanitizeSiteId(name: string): string;
+export declare function monorepoRoot(): string;
+/**
+ * Resolve the DRAFT_MODE_SECRET to write into a scaffolded site's `.env.local`.
+ * Reads from the orchestrator's own environment so the scaffolded site lines up
+ * with the editor's build-time `VITE_SITE_DRAFT_SECRET`. Falls back to a known
+ * dev placeholder if the orchestrator wasn't started with one — that placeholder
+ * is intentionally weak so production deployments fail closed if env config is
+ * forgotten.
+ */
+export declare function getDraftModeSecret(): string;
+export declare function findAvailablePort(root: string): Promise<number>;
+export interface ThemePreset {
+    name: string;
+    description: string;
+    googleFontsUrl?: string;
+    overrides: Record<string, string>;
+}
+export declare const THEME_PRESETS: ThemePreset[];
+/**
+ * Format theme presets as a catalog for the system prompt.
+ * Shows name, description, and the full CSS variable overrides so the LLM
+ * can copy them into themeOverrides.
+ */
+export declare function buildThemePresetsCatalog(): string;
+/** Model tiers for the sites agent pipeline. */
+export declare const SITES_AGENT_MODELS: {
+    /** Haiku — triage, intent detection, simple Q&A ($0.001/call).
+     *  Full model ID for direct Anthropic API calls (not Agent SDK). */
+    fast: string;
+    /** Sonnet — main agent, subagents, standard migrations.
+     *  Agent SDK enum value (SDK resolves to latest Sonnet). */
+    balanced: "sonnet";
+    /** Opus — complex migrations, multi-page sites, custom block design.
+     *  Agent SDK enum value (SDK resolves to latest Opus). */
+    powerful: "opus";
+};
+export type TriageResult = {
+    intent: "create" | "migrate" | "integrate" | "question";
+    url?: string;
+    siteName?: string;
+    scope?: string;
+    answer?: string;
+};
+/**
+ * Fast triage using Haiku — classifies intent, extracts params, answers simple questions.
+ * ~200ms, ~$0.001 per call.
+ */
+export declare function triageWithHaiku(message: string, apiKey: string): Promise<TriageResult>;
+export declare function patchGlobalsCssVars(cssPath: string, vars: Record<string, string>): Promise<void>;
+export declare function fixFooterLinks(props: Record<string, unknown>): Record<string, unknown>;
+export declare function validateAndCorrectProps(blockType: string, props: Record<string, unknown>): {
+    props: Record<string, unknown>;
+    corrected: boolean;
+    error?: string;
+};
+/**
+ * Normalize and validate blocks for a page — applies prop correction, strips chrome blocks,
+ * extracts footer. Shared between SDK and stdio bootstrap_pages implementations.
+ */
+export declare function normalizePageBlocks(blocks: Array<{
+    type: string;
+    props: Record<string, unknown>;
+}>): {
+    contentBlocks: Array<{
+        id: string;
+        type: string;
+        props: Record<string, unknown>;
+    }>;
+    footerBlock: {
+        type: string;
+        props: Record<string, unknown>;
+    } | null;
+    strippedCount: number;
+};
+export declare function packageJson(siteId: string, name: string, port: number): string;
+export declare function nextConfigTs(): string;
+export declare function tsconfigJson(): string;
+export declare function postcssConfig(): string;
+export declare function layoutTsx(siteName: string): string;
+export declare function globalsCss(): string;
+export declare function defaultsTs(siteId: string, siteName: string): string;
+export declare function editorApiRoute(): string;
+export declare function pageTsx(siteId: string, options?: {
+    chrome?: boolean;
+}): string;
+export declare function hybridPageTsx(siteId: string): string;
+export declare function blocksRegisterTsx(): string;
+export declare function samplePagesJson(): string;
+export declare function defaultLogoSvg(siteName: string): string;
+export declare function faviconSvg(siteName: string): string;
+/**
+ * Scaffold a complete Next.js site project. Used by both SDK and CLI create_site tools.
+ * Returns the site config and port. Does NOT start the dev server (caller handles that).
+ */
+export declare function scaffoldSiteProject(options: {
+    siteId: string;
+    name: string;
+    purpose?: string;
+    tone?: string;
+    port?: number;
+}): Promise<{
+    siteId: string;
+    port: number;
+    projectDir: string;
+}>;
+export type CodebaseAnalysis = {
+    framework: "nextjs-app-router" | "nextjs-pages-router" | "other";
+    nextVersion: string | null;
+    packageManager: "pnpm" | "npm" | "yarn";
+    hasTypeScript: boolean;
+    hasTailwind: boolean;
+    stylingApproach: string;
+    existingRoutes: string[];
+    existingCms: string | null;
+    hasEditorIntegration: boolean;
+    layoutPath: string | null;
+    globalCssPath: string | null;
+    isMonorepoChild: boolean;
+    dependencies: Record<string, string>;
+};
+/**
+ * Analyze an existing site project to determine its structure, framework,
+ * CMS, and what's needed to integrate with the AI Site Editor.
+ */
+export declare function analyzeCodebase(projectPath: string): Promise<CodebaseAnalysis>;
+export type CloneResult = {
+    status: "cloned" | "updated" | "exists";
+    localPath: string;
+    branch: string;
+    commitCount?: number;
+    repoName: string;
+    message?: string;
+};
+/**
+ * Clone a GitHub repo into apps/{dirName}, or pull if it already exists.
+ */
+export declare function cloneRepo(url: string, targetDir?: string): Promise<CloneResult>;
+/**
+ * Detect the dev server port from an existing site's package.json.
+ */
+export declare function detectSitePort(projectDir: string): Promise<number>;
+/**
+ * Start a Next.js dev server and wait for it to report "Ready" (or timeout).
+ * Replaces fire-and-forget spawn patterns that reported success before the server was up.
+ */
+export declare function startAndWaitForDevServer(opts: {
+    siteId: string;
+    port: number;
+    cwd: string;
+    useFilter?: boolean;
+    timeoutMs?: number;
+}): Promise<{
+    serverReady: boolean;
+}>;