khoji 2.1.4

package/dist/prompting/PromptGenerator.d.ts

@@ -0,0 +1,5 @@
+export type CloneSkill = 'frontend-design' | 'seo-audit' | 'web-design-guidelines' | 'award-winning-website';
+export declare class PromptGenerator {
+    static generate(skills: CloneSkill[]): string;
+}
+//# sourceMappingURL=PromptGenerator.d.ts.map

package/dist/prompting/PromptGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptGenerator.d.ts","sourceRoot":"","sources":["../../src/prompting/PromptGenerator.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAChB,iBAAiB,GACjB,WAAW,GACX,uBAAuB,GACvB,uBAAuB,CAAC;AAE9B,qBAAa,eAAe;IACxB,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM;CAmChD"}

package/dist/prompting/PromptGenerator.js

@@ -0,0 +1,30 @@
+export class PromptGenerator {
+    static generate(skills) {
+        let prompt = `# Pixel-Perfect Website Clone Task\n\n`;
+        prompt += `You are an expert AI developer tasked with cloning a website. Within this folder, you have access to the raw HTML, unified CSS, a full-page screenshot, and a structural JSON context map of the target site. Your objective is to rebuild this website pixel-perfectly.\n\n`;
+        if (skills.length > 0) {
+            prompt += `## Project Guidelines & Skills\n`;
+            prompt += `While cloning, you must adhere strictly to the following guidelines selected for this project:\n\n`;
+            if (skills.includes('frontend-design')) {
+                prompt += `### ✦ Frontend Design Excellence\n`;
+                prompt += `Ensure the UI design completely avoids generic AI aesthetics. Prioritize distinctive typography (do not default to standard system fonts), maintain cohesive and intentional spacing, and commit to a bold creative direction for the interface. Every detail should feel meticulously human-crafted.\n\n`;
+            }
+            if (skills.includes('seo-audit')) {
+                prompt += `### ✦ SEO Best Practices\n`;
+                prompt += `Implement strong on-page technical SEO. Use correct HTML5 semantic tags, maintain a strict and logical heading hierarchy (with exactly one H1), ensure all images have descriptive \`alt\` attributes, and structure the DOM for maximum accessibility and immediate indexability.\n\n`;
+            }
+            if (skills.includes('web-design-guidelines')) {
+                prompt += `### ✦ Strict Web Design Guidelines\n`;
+                prompt += `Follow rigorous modern web interface guidelines. Ensure high color contrast ratios, provide reliable and visible focus states for all interactive elements, ensure flawlessly responsive viewport handling across mobile and desktop, and adhere to robust accessibility standards.\n\n`;
+            }
+            if (skills.includes('award-winning-website')) {
+                prompt += `### ✦ Award-Winning Experience\n`;
+                prompt += `Elevate this site into a premium, award-winning experience. Where appropriate, integrate scroll-triggered UI reveals, modern 3D or parallax geometric effects, and smooth high-end micro-interactions using robust animation patterns (e.g., GSAP, Framer Motion, or advanced CSS transitions).\n\n`;
+            }
+        }
+        prompt += `## Deliverables\n`;
+        prompt += `Please provide the functional code necessary to recreate this interface, ensuring the aforementioned guidelines define the final aesthetic and structural quality of the work.`;
+        return prompt;
+    }
+}
+//# sourceMappingURL=PromptGenerator.js.map

package/dist/prompting/PromptGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptGenerator.js","sourceRoot":"","sources":["../../src/prompting/PromptGenerator.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,eAAe;IACxB,MAAM,CAAC,QAAQ,CAAC,MAAoB;QAChC,IAAI,MAAM,GAAG,wCAAwC,CAAC;QAEtD,MAAM,IAAI,8QAA8Q,CAAC;QAEzR,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,kCAAkC,CAAC;YAC7C,MAAM,IAAI,oGAAoG,CAAC;YAE/G,IAAI,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,oCAAoC,CAAC;gBAC/C,MAAM,IAAI,2SAA2S,CAAC;YAC1T,CAAC;YAED,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,4BAA4B,CAAC;gBACvC,MAAM,IAAI,wRAAwR,CAAC;YACvS,CAAC;YAED,IAAI,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,sCAAsC,CAAC;gBACjD,MAAM,IAAI,yRAAyR,CAAC;YACxS,CAAC;YAED,IAAI,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,kCAAkC,CAAC;gBAC7C,MAAM,IAAI,qSAAqS,CAAC;YACpT,CAAC;QACL,CAAC;QAED,MAAM,IAAI,mBAAmB,CAAC;QAC9B,MAAM,IAAI,gLAAgL,CAAC;QAE3L,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ"}

package/dist/serializer/JsonSerializer.d.ts

@@ -0,0 +1,6 @@
+import type { KhojContext } from '../types/KhojContext.js';
+/**
+ * Serializes the KhojContext object to a formatted JSON string.
+ */
+export declare function serializeJson(ctx: KhojContext): string;
+//# sourceMappingURL=JsonSerializer.d.ts.map

package/dist/serializer/JsonSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonSerializer.d.ts","sourceRoot":"","sources":["../../src/serializer/JsonSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAEtD"}

package/dist/serializer/JsonSerializer.js

@@ -0,0 +1,7 @@
+/**
+ * Serializes the KhojContext object to a formatted JSON string.
+ */
+export function serializeJson(ctx) {
+    return JSON.stringify(ctx, null, 2);
+}
+//# sourceMappingURL=JsonSerializer.js.map

package/dist/serializer/JsonSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonSerializer.js","sourceRoot":"","sources":["../../src/serializer/JsonSerializer.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAgB;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/serializer/MarkdownSerializer.d.ts

@@ -0,0 +1,7 @@
+import type { KhojContext } from '../types/KhojContext.js';
+/**
+ * Serializes a KhojContext into a markdown document optimised for LLM readability.
+ * Sections are ordered from most to least relevant for AI agents.
+ */
+export declare function serializeMarkdown(ctx: KhojContext): string;
+//# sourceMappingURL=MarkdownSerializer.d.ts.map

package/dist/serializer/MarkdownSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownSerializer.d.ts","sourceRoot":"","sources":["../../src/serializer/MarkdownSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAsG,MAAM,yBAAyB,CAAC;AAE/J;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAuJ1D"}

package/dist/serializer/MarkdownSerializer.js

@@ -0,0 +1,143 @@
+/**
+ * Serializes a KhojContext into a markdown document optimised for LLM readability.
+ * Sections are ordered from most to least relevant for AI agents.
+ */
+export function serializeMarkdown(ctx) {
+    const lines = [];
+    lines.push(`# Khoj Context — ${ctx.meta.title || ctx.url}`);
+    lines.push(`> Extracted: ${ctx.extractedAt} | Schema: ${ctx.schemaVersion} | \~${ctx.tokenEstimate.toLocaleString()} tokens\n`);
+    // ── Meta ──────────────────────────────────────────────────────────────────
+    lines.push('## Meta');
+    lines.push(`- **URL**: ${ctx.url}`);
+    if (ctx.finalUrl !== ctx.url)
+        lines.push(`- **Final URL** (after redirect): ${ctx.finalUrl}`);
+    lines.push(`- **Title**: ${ctx.meta.title}`);
+    lines.push(`- **Description**: ${ctx.meta.description}`);
+    if (ctx.meta.ogImage)
+        lines.push(`- **OG Image**: ${ctx.meta.ogImage}`);
+    if (ctx.meta.canonical)
+        lines.push(`- **Canonical**: ${ctx.meta.canonical}`);
+    if (ctx.meta.themeColor)
+        lines.push(`- **Theme Color**: ${ctx.meta.themeColor}`);
+    lines.push('');
+    // ── Design Tokens ─────────────────────────────────────────────────────────
+    lines.push('## Design Tokens');
+    if (Object.keys(ctx.designTokens.colors).length > 0) {
+        lines.push('\n### Colors');
+        for (const [k, v] of Object.entries(ctx.designTokens.colors)) {
+            lines.push(`- \`${k}\`: ${v}`);
+        }
+    }
+    if (Object.keys(ctx.designTokens.spacing).length > 0) {
+        lines.push('\n### Spacing');
+        for (const [k, v] of Object.entries(ctx.designTokens.spacing)) {
+            lines.push(`- \`${k}\`: ${v}`);
+        }
+    }
+    if (ctx.designTokens.fonts.length > 0) {
+        lines.push(`\n### Fonts\n${ctx.designTokens.fonts.map((f) => `- ${f}`).join('\n')}`);
+    }
+    if (ctx.designTokens.breakpoints.length > 0) {
+        lines.push(`\n### Breakpoints\n${ctx.designTokens.breakpoints.map((b) => `- ${b}`).join('\n')}`);
+    }
+    lines.push('');
+    // ── Content ───────────────────────────────────────────────────────────────
+    lines.push('## Content');
+    const headings = ctx.content.filter((c) => c.type === 'heading');
+    const buttons = ctx.content.filter((c) => c.type === 'button');
+    const paragraphs = ctx.content.filter((c) => c.type === 'paragraph').slice(0, 10);
+    if (headings.length > 0) {
+        lines.push('\n### Headings');
+        headings.forEach((h) => lines.push(`${'#'.repeat(h.level ?? 1)} ${h.text}`));
+    }
+    if (buttons.length > 0) {
+        lines.push('\n### CTAs / Buttons');
+        buttons.forEach((b) => lines.push(`- ${b.text}`));
+    }
+    if (paragraphs.length > 0) {
+        lines.push('\n### Text Blocks (sample)');
+        paragraphs.forEach((p) => lines.push(`> ${p.text}`));
+    }
+    lines.push('');
+    // ── Assets ────────────────────────────────────────────────────────────────
+    lines.push('## Assets');
+    lines.push(`- **Images**: ${ctx.assets.images.length}`);
+    lines.push(`- **GIFs**: ${ctx.assets.gifs.length}`);
+    lines.push(`- **Fonts**: ${ctx.assets.fonts.length}`);
+    lines.push(`- **Icons**: ${ctx.assets.icons.length}`);
+    if (ctx.assets.images.length > 0) {
+        lines.push('\n### Images');
+        lines.push('| URL | Alt | Size | Lazy |');
+        lines.push('|-----|-----|------|------|');
+        ctx.assets.images.slice(0, 20).forEach((img) => {
+            const size = img.width && img.height ? `${img.width}×${img.height}` : '–';
+            lines.push(`| ${img.url.slice(0, 60)} | ${img.alt || '–'} | ${size} | ${img.isLazy ? 'yes' : 'no'} |`);
+        });
+    }
+    if (ctx.assets.gifs.length > 0) {
+        lines.push('\n### GIFs');
+        lines.push('| URL | Alt | Selector |');
+        lines.push('|-----|-----|----------|');
+        ctx.assets.gifs.forEach((g) => {
+            lines.push(`| ${g.url.slice(0, 60)} | ${g.alt || '–'} | \`${g.selector}\` |`);
+        });
+    }
+    lines.push('');
+    // ── Animations ────────────────────────────────────────────────────────────
+    lines.push('## Animations');
+    lines.push(`> ${ctx.animations.summary}`);
+    if (ctx.animations.cssAnimations.length > 0) {
+        lines.push('\n### CSS Animations');
+        ctx.animations.cssAnimations.slice(0, 15).forEach((a) => {
+            lines.push(`- **${a.name}** on \`${a.selector.slice(0, 60)}\`: ${a.description} *(${a.duration}, ${a.trigger})*`);
+        });
+    }
+    if (ctx.animations.cssTransitions.length > 0) {
+        lines.push('\n### CSS Transitions');
+        ctx.animations.cssTransitions.slice(0, 10).forEach((t) => {
+            lines.push(`- \`${t.selector.slice(0, 60)}\`: ${t.description}`);
+        });
+    }
+    if (ctx.animations.jsAnimations.length > 0) {
+        lines.push('\n### JS Animations');
+        ctx.animations.jsAnimations.forEach((j) => {
+            lines.push(`- **${j.library}**: ${j.description} *(${j.trigger})*`);
+        });
+    }
+    if (ctx.animations.scrollAnimations.length > 0) {
+        lines.push('\n### Scroll Animations');
+        ctx.animations.scrollAnimations.slice(0, 10).forEach((s) => {
+            lines.push(`- \`${s.selector}\` — ${s.animationType} (${s.library})`);
+        });
+    }
+    if (ctx.animations.gifAnimations.length > 0) {
+        lines.push('\n### GIF Animations');
+        ctx.animations.gifAnimations.forEach((g) => {
+            lines.push(`- **${g.purpose}**: ${g.alt || g.url.split('/').pop()} (\`${g.selector}\`)`);
+        });
+    }
+    lines.push('');
+    // ── Interactions ──────────────────────────────────────────────────────────
+    if (ctx.interactions.length > 0) {
+        lines.push('## Interactions');
+        ctx.interactions.forEach((i) => {
+            lines.push(`\n### ${i.label} (${i.type})`);
+            lines.push(`- Selector: \`${i.selector}\``);
+            if (i.fields && i.fields.length > 0) {
+                lines.push('- Fields:');
+                i.fields.forEach((f) => lines.push(`  - ${f.name} (${f.inputType})${f.required ? ' *required*' : ''}${f.placeholder ? ` — "${f.placeholder}"` : ''}`));
+            }
+        });
+        lines.push('');
+    }
+    // ── Components ────────────────────────────────────────────────────────────
+    if (ctx.components.length > 0) {
+        lines.push('## Detected Components');
+        ctx.components.forEach((c) => {
+            lines.push(`- **${c.name}** (\`${c.pattern}\`): ${c.count} instances`);
+        });
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=MarkdownSerializer.js.map

package/dist/serializer/MarkdownSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownSerializer.js","sourceRoot":"","sources":["../../src/serializer/MarkdownSerializer.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAgB;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,oBAAoB,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,WAAW,cAAc,GAAG,CAAC,aAAa,QAAQ,GAAG,CAAC,aAAa,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAEhI,6EAA6E;IAC7E,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IACpC,IAAI,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,qCAAqC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9F,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,sBAAsB,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACxE,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC7E,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,sBAAsB,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IACjF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,6EAA6E;IAC7E,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAE/B,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;IACL,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5D,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;IACL,CAAC;IACD,IAAI,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,GAAG,CAAC,YAAY,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,sBAAsB,GAAG,CAAC,YAAY,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,6EAA6E;IAC7E,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAA2C,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAC1G,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAElF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACzC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,6EAA6E;IAC7E,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,iBAAiB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAEtD,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC1C,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YAC3C,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YAC1E,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,MAAM,IAAI,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;QAC3G,CAAC,CAAC,CAAC;IACP,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACvC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,GAAG,QAAQ,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC;IACP,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,6EAA6E;IAC7E,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IAE1C,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAe,EAAE,EAAE;YAClE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,WAAW,MAAM,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;QACtH,CAAC,CAAC,CAAC;IACP,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACpC,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAgB,EAAE,EAAE;YACpE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACP,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAClC,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAc,EAAE,EAAE;YACnD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,WAAW,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;IACP,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACtC,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAkB,EAAE,EAAE;YACxE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,QAAQ,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;IACP,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAe,EAAE,EAAE;YACrD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC;QAC7F,CAAC,CAAC,CAAC;IACP,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,6EAA6E;IAC7E,IAAI,GAAG,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAc,EAAE,EAAE;YACxC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBACxB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAC3J,CAAC;QACL,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,6EAA6E;IAC7E,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACzB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC"}

package/dist/types/KhojContext.d.ts

@@ -0,0 +1,141 @@
+export interface KhojContext {
+    schemaVersion: '1.0';
+    url: string;
+    finalUrl: string;
+    extractedAt: string;
+    loadTimeMs: number;
+    tokenEstimate: number;
+    meta: PageMeta;
+    structure: DomNode[];
+    designTokens: DesignTokens;
+    components: DetectedComponent[];
+    assets: AssetMap;
+    content: ContentBlock[];
+    interactions: Interaction[];
+    animations: AnimationMap;
+}
+export interface PageMeta {
+    title: string;
+    description: string;
+    ogImage: string | null;
+    canonical: string | null;
+    themeColor: string | null;
+    jsonLd: unknown[];
+}
+export interface DomNode {
+    tag: string;
+    id?: string;
+    classes: string[];
+    role?: string;
+    text?: string;
+    children?: DomNode[];
+}
+export interface DesignTokens {
+    colors: Record<string, string>;
+    spacing: Record<string, string>;
+    typography: Record<string, string>;
+    fonts: string[];
+    breakpoints: string[];
+}
+export interface DetectedComponent {
+    name: string;
+    pattern: string;
+    count: number;
+    sampleHTML: string;
+}
+export interface AssetMap {
+    images: ImageAsset[];
+    gifs: ImageAsset[];
+    fonts: string[];
+    icons: string[];
+    scripts: string[];
+}
+export interface ImageAsset {
+    url: string;
+    alt: string;
+    type: 'image' | 'gif';
+    width: number | null;
+    height: number | null;
+    isLazy: boolean;
+    selector: string;
+}
+export type ContentType = 'heading' | 'paragraph' | 'button' | 'link' | 'label';
+export interface ContentBlock {
+    type: ContentType;
+    text: string;
+    level?: number;
+    href?: string;
+}
+export type InteractionType = 'form' | 'nav' | 'button';
+export interface Interaction {
+    type: InteractionType;
+    selector: string;
+    label: string;
+    fields?: FormField[];
+}
+export interface FormField {
+    inputType: string;
+    name: string;
+    placeholder: string;
+    required: boolean;
+}
+export interface AnimationMap {
+    cssAnimations: CSSAnimation[];
+    cssTransitions: CSSTransition[];
+    jsAnimations: JSAnimation[];
+    scrollAnimations: ScrollAnimation[];
+    gifAnimations: GifAnimation[];
+    summary: string;
+}
+export interface CSSAnimation {
+    name: string;
+    selector: string;
+    duration: string;
+    timingFunction: string;
+    iterationCount: string;
+    delay: string;
+    trigger: 'page-load' | 'hover' | 'focus' | 'unknown';
+    description: string;
+}
+export interface CSSTransition {
+    selector: string;
+    properties: string[];
+    duration: string;
+    timingFunction: string;
+    trigger: 'hover' | 'focus' | 'active' | 'unknown';
+    description: string;
+}
+export type JSAnimationLibrary = 'gsap' | 'framer-motion' | 'animejs' | 'web-animations-api' | 'lottie' | 'auto' | 'unknown';
+export interface JSAnimation {
+    library: JSAnimationLibrary;
+    selector: string;
+    description: string;
+    trigger: 'page-load' | 'scroll' | 'click' | 'hover' | 'unknown';
+}
+export type ScrollAnimationLibrary = 'aos' | 'intersection-observer' | 'gsap-scrolltrigger' | 'unknown';
+export interface ScrollAnimation {
+    selector: string;
+    library: ScrollAnimationLibrary;
+    animationType: string;
+    description: string;
+}
+export type GifAnimationPurpose = 'loading-spinner' | 'product-demo' | 'decorative' | 'tutorial' | 'unknown';
+export interface GifAnimation {
+    url: string;
+    selector: string;
+    alt: string;
+    purpose: GifAnimationPurpose;
+}
+export interface ExtractionOptions {
+    url: string;
+    outputDir: string;
+    format: 'json' | 'markdown' | 'both';
+    timeout: number;
+    fast: boolean;
+    clone?: boolean;
+    cloneSkills?: string[];
+    sendToGemini?: boolean;
+    prompt?: string;
+    clickSelector?: string;
+}
+//# sourceMappingURL=KhojContext.d.ts.map

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

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

package/dist/types/KhojContext.js

@@ -0,0 +1,6 @@
+// ─── KhojContext ────────────────────────────────────────────────────────────
+// Master TypeScript interface for the khoj-context.json output.
+// This is the source of truth — all extractors must conform to these types.
+// ─────────────────────────────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=KhojContext.js.map

package/dist/types/KhojContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KhojContext.js","sourceRoot":"","sources":["../../src/types/KhojContext.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gEAAgE;AAChE,4EAA4E;AAC5E,gFAAgF"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,15 @@
+import { type Ora } from 'ora';
+export declare const logger: {
+    info(msg: string): void;
+    success(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string, err?: unknown): void;
+    step(emoji: string, msg: string): void;
+    dim(msg: string): void;
+    stat(label: string, value: string): void;
+    divider(): void;
+    spinner(msg: string): Ora;
+    stopSpinner(success?: boolean, msg?: string): void;
+    banner(): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AACA,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAIpC,eAAO,MAAM,MAAM;cACP,MAAM,GAAG,IAAI;iBAKV,MAAM,GAAG,IAAI;cAKhB,MAAM,GAAG,IAAI;eAKZ,MAAM,QAAQ,OAAO,GAAG,IAAI;gBAQ3B,MAAM,OAAO,MAAM,GAAG,IAAI;aAK7B,MAAM,GAAG,IAAI;gBAIV,MAAM,SAAS,MAAM,GAAG,IAAI;eAI7B,IAAI;iBAIF,MAAM,GAAG,GAAG;yCAKS,MAAM,GAAG,IAAI;cAUrC,IAAI;CAYf,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,70 @@
+import chalk from 'chalk';
+import ora from 'ora';
+let _spinner = null;
+export const logger = {
+    info(msg) {
+        if (_spinner)
+            _spinner.stop();
+        console.log(chalk.blue(`ℹ  ${msg}`));
+    },
+    success(msg) {
+        if (_spinner)
+            _spinner.stop();
+        console.log(chalk.green(`✔  ${msg}`));
+    },
+    warn(msg) {
+        if (_spinner)
+            _spinner.stop();
+        console.warn(chalk.yellow(`⚠  ${msg}`));
+    },
+    error(msg, err) {
+        if (_spinner)
+            _spinner.stop();
+        console.error(chalk.red(`✖  ${msg}`));
+        if (err instanceof Error) {
+            console.error(chalk.dim(`   ${err.message}`));
+        }
+    },
+    step(emoji, msg) {
+        if (_spinner)
+            _spinner.stop();
+        console.log(`${emoji} ${chalk.bold(msg)}`);
+    },
+    dim(msg) {
+        console.log(chalk.dim(`   ${msg}`));
+    },
+    stat(label, value) {
+        console.log(`  ${chalk.cyan(label.padEnd(20))} ${chalk.white(value)}`);
+    },
+    divider() {
+        console.log(chalk.dim('─'.repeat(60)));
+    },
+    spinner(msg) {
+        _spinner = ora({ text: msg, color: 'cyan' }).start();
+        return _spinner;
+    },
+    stopSpinner(success = true, msg) {
+        if (!_spinner)
+            return;
+        if (success) {
+            _spinner.succeed(msg);
+        }
+        else {
+            _spinner.fail(msg);
+        }
+        _spinner = null;
+    },
+    banner() {
+        console.log('');
+        console.log(chalk.bold.cyan('  ██╗  ██╗██╗  ██╗ ██████╗      ██╗'));
+        console.log(chalk.bold.cyan('  ██║ ██╔╝██║  ██║██╔═══██╗     ██║'));
+        console.log(chalk.bold.cyan('  █████╔╝ ███████║██║   ██║     ██║'));
+        console.log(chalk.bold.cyan('  ██╔═██╗ ██╔══██║██║   ██║██   ██║'));
+        console.log(chalk.bold.cyan('  ██║  ██╗██║  ██║╚██████╔╝╚█████╔╝'));
+        console.log(chalk.bold.cyan('  ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝  ╚════╝'));
+        console.log('');
+        console.log(chalk.dim('  Website context packager for AI agents'));
+        console.log('');
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/text.d.ts

@@ -0,0 +1,2 @@
+export declare function normalize(text: string): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/utils/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/utils/text.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C"}

package/dist/utils/text.js

@@ -0,0 +1,6 @@
+export function normalize(text) {
+    if (!text)
+        return '';
+    return text.trim().replace(/\s+/g, ' ');
+}
+//# sourceMappingURL=text.js.map

package/dist/utils/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/utils/text.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC"}

package/dist/utils/tokenEstimator.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Estimates the number of LLM tokens in a string.
+ * Uses the standard approximation: ~4 characters per token.
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Returns a human-readable comparison between raw HTML size and khoj output size.
+ */
+export declare function formatTokenSavings(rawHtmlLength: number, khojOutputLength: number): string;
+//# sourceMappingURL=tokenEstimator.d.ts.map

package/dist/utils/tokenEstimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenEstimator.d.ts","sourceRoot":"","sources":["../../src/utils/tokenEstimator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAK1F"}

package/dist/utils/tokenEstimator.js

@@ -0,0 +1,17 @@
+/**
+ * Estimates the number of LLM tokens in a string.
+ * Uses the standard approximation: ~4 characters per token.
+ */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Returns a human-readable comparison between raw HTML size and khoj output size.
+ */
+export function formatTokenSavings(rawHtmlLength, khojOutputLength) {
+    const rawTokens = estimateTokens(rawHtmlLength.toString().padEnd(rawHtmlLength));
+    const outTokens = estimateTokens(khojOutputLength.toString().padEnd(khojOutputLength));
+    const reduction = Math.round(((rawTokens - outTokens) / rawTokens) * 100);
+    return `Raw HTML ~${rawTokens.toLocaleString()} tokens → Khoj ~${outTokens.toLocaleString()} tokens (${reduction}% reduction)`;
+}
+//# sourceMappingURL=tokenEstimator.js.map

package/dist/utils/tokenEstimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenEstimator.js","sourceRoot":"","sources":["../../src/utils/tokenEstimator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,aAAqB,EAAE,gBAAwB;IAC9E,MAAM,SAAS,GAAG,cAAc,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;IACjF,MAAM,SAAS,GAAG,cAAc,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACvF,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC;IAC1E,OAAO,aAAa,SAAS,CAAC,cAAc,EAAE,mBAAmB,SAAS,CAAC,cAAc,EAAE,YAAY,SAAS,cAAc,CAAC;AACnI,CAAC"}

package/khoj-context.schema.json

@@ -0,0 +1,48 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "$id": "https://khoj.dev/schema/khoj-context.schema.json",
+    "title": "KhojContext",
+    "description": "Output schema generated by the Khoj CLI (token-efficient website context)",
+    "type": "object",
+    "properties": {
+        "schemaVersion": {
+            "type": "string",
+            "const": "1.0"
+        },
+        "url": {
+            "type": "string",
+            "format": "uri"
+        },
+        "finalUrl": {
+            "type": "string",
+            "format": "uri"
+        },
+        "extractedAt": {
+            "type": "string",
+            "format": "date-time"
+        },
+        "loadTimeMs": {
+            "type": "number"
+        },
+        "tokenEstimate": {
+            "type": "number",
+            "description": "Estimated LLM tokens for the JSON payload"
+        }
+    },
+    "required": [
+        "schemaVersion",
+        "url",
+        "finalUrl",
+        "extractedAt",
+        "loadTimeMs",
+        "tokenEstimate",
+        "meta",
+        "structure",
+        "designTokens",
+        "components",
+        "assets",
+        "content",
+        "interactions",
+        "animations"
+    ]
+}