@cognilead/mcp-server 0.1.0

package/dist/index.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+// @cognilead/mcp-server — stdio entrypoint.
+//
+// Wires the CogniLead tools (2 free, 4 gated) into an MCP server
+// that speaks the stdio transport. Cursor, Claude Desktop and Windsurf
+// all launch this as a child process and exchange JSON-RPC over stdin/
+// stdout.
+//
+// Free tools run locally (no network). Gated tools hit the hosted API
+// at COGNILEAD_API_URL. Missing API key for a gated tool surfaces as a
+// structured MCP error containing the upgrade URL — the IDE renders that
+// directly to the developer, which is the canonical acquisition moment.
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { DraftPitchJsonSchema, ScoreSignalJsonSchema, IngestLeadJsonSchema, RunCampaignJsonSchema, SuppressJsonSchema, GenerateSeoContentJsonSchema, } from './schemas.js';
+import { draftPitch } from './tools/draft-pitch.js';
+import { scoreSignal } from './tools/score-signal.js';
+import { ingestLead } from './tools/ingest-lead.js';
+import { runCampaign } from './tools/run-campaign.js';
+import { suppress } from './tools/suppress.js';
+import { generateSeoContent } from './tools/generate-seo-content.js';
+import { McpAuthError, McpQuotaError } from './auth.js';
+const SERVER_INFO = {
+    name: 'cognilead-mcp',
+    version: '0.1.0',
+};
+export const TOOLS = [
+    {
+        name: 'cognilead.draft_pitch',
+        description: 'Draft a cold-outbound pitch for a technical company based on a public signal (job post URL, GitHub repo, HN comment). EU/CH jurisdiction routing — pitches for EU recipients go through EU-resident inference for GDPR. Returns subject_line, email_body_markdown, and a technical_hook_verified flag (false ⇒ the signal lacked a citable hook). Free tier capped at 20 calls/day.',
+        inputSchema: DraftPitchJsonSchema,
+        handler: draftPitch,
+    },
+    {
+        name: 'cognilead.score_signal',
+        description: 'Rate a JSON signal for fit against a target product on a 0-100 scale. Deterministic: keyword match × recency × source quality × URL-presence. Returns fit_score, reasoning, and a recommended_action of pitch | enrich | skip. Cheap and instant — no LLM call. Free tier capped at 50 calls/day.',
+        inputSchema: ScoreSignalJsonSchema,
+        handler: scoreSignal,
+    },
+    {
+        name: 'cognilead.ingest_lead',
+        description: 'Register a lead in the CogniLead pipeline. Runs through the intersect stage (suppression check, dedup, Chainlog audit anchor). Returns the persisted lead row including its chainlog_event_id. Requires a CogniLead API key.',
+        inputSchema: IngestLeadJsonSchema,
+        handler: ingestLead,
+    },
+    {
+        name: 'cognilead.run_campaign',
+        description: 'Kick off a campaign by id, optionally restricted to a set of lead_ids. The hosted API runs the per-step personalize → policy-gate → dispatch pipeline. Returns the dispatch result including send_ids and the AgentGate decision. Requires a CogniLead API key.',
+        inputSchema: RunCampaignJsonSchema,
+        handler: runCampaign,
+    },
+    {
+        name: 'cognilead.suppress',
+        description: "Add an email or domain to the suppression list with a reason. Suppressed addresses are filtered by the intersect stage on every future lead. Either 'email' or 'domain' must be provided. Requires a CogniLead API key.",
+        inputSchema: SuppressJsonSchema,
+        handler: suppress,
+    },
+    {
+        name: 'cognilead.generate_seo_content',
+        description: 'Generate SEO content via phi-cloud. kind=blog|landing returns a full optimised page (title, slug, meta description, headings, Markdown body, target keywords, internal-link ideas); kind=recommendations returns a prioritised on-page SEO audit of existing_content. Provide product + topic (+ optional target_keywords, audience). Requires a CogniLead API key.',
+        inputSchema: GenerateSeoContentJsonSchema,
+        handler: generateSeoContent,
+    },
+];
+function toolByName(name) {
+    return TOOLS.find((t) => t.name === name);
+}
+function formatToolError(e) {
+    if (e instanceof McpAuthError) {
+        return {
+            error: {
+                code: e.code,
+                message: e.message,
+                upgrade_url: 'https://cognilead.ai/signup?via=mcp',
+            },
+        };
+    }
+    if (e instanceof McpQuotaError) {
+        return { error: { code: e.code, message: e.message } };
+    }
+    if (e instanceof Error) {
+        return { error: { code: 'mcp.tool_error', message: e.message } };
+    }
+    return { error: { code: 'mcp.unknown', message: String(e) } };
+}
+export function createServer() {
+    const server = new Server(SERVER_INFO, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: TOOLS.map((t) => ({
+                name: t.name,
+                description: t.description,
+                // The SDK casts inputSchema through its own validator; supplying
+                // a JSON Schema object is the supported shape.
+                inputSchema: t.inputSchema,
+            })),
+        };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const tool = toolByName(name);
+        if (!tool) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: { code: 'mcp.unknown_tool', message: `Unknown tool: ${name}` },
+                        }),
+                    },
+                ],
+            };
+        }
+        try {
+            const result = await tool.handler(args ?? {});
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (e) {
+            const payload = formatToolError(e);
+            return {
+                isError: true,
+                content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+            };
+        }
+    });
+    return server;
+}
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr (stdout is the JSON-RPC wire — never log there).
+    process.stderr.write(`[cognilead-mcp] ${SERVER_INFO.name}@${SERVER_INFO.version} listening on stdio\n`);
+}
+// Run only when invoked directly (not when imported by http.ts or tests).
+const isDirectInvocation = import.meta.url === `file://${process.argv[1]}` ||
+    process.argv[1]?.endsWith('/cognilead-mcp') ||
+    process.argv[1]?.endsWith('/index.js');
+if (isDirectInvocation) {
+    main().catch((err) => {
+        process.stderr.write(`[cognilead-mcp] fatal: ${err.message}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/rate-limit.d.ts

@@ -0,0 +1,17 @@
+interface QuotaState {
+    date: string;
+    counts: Record<string, number>;
+}
+/**
+ * Increments the counter for `toolName` and throws McpQuotaError if the
+ * daily cap would be exceeded. Free tools call this AFTER input validation
+ * so we don't burn quota on malformed calls.
+ */
+export declare function consumeFreeQuota(toolName: string): {
+    remaining: number;
+    limit: number;
+};
+/** For tests / introspection. */
+export declare function _quotaSnapshot(): QuotaState;
+export {};
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":"AAqBA,UAAU,UAAU;IAElB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAuCD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAmBvF;AAED,iCAAiC;AACjC,wBAAgB,cAAc,IAAI,UAAU,CAE3C"}

package/dist/rate-limit.js

@@ -0,0 +1,80 @@
+// In-process daily quota counter for the free tools. Resets at UTC
+// midnight. Persists to ~/.cognilead/quota.json so the counter survives
+// IDE restarts within the same calendar day; fails open if the FS isn't
+// writable (e.g., read-only containers, sandboxed extensions).
+//
+// This is intentionally not a robust distributed limiter. It exists to
+// keep one developer's IDE from burning through free-tier inference. The
+// hosted /api/v1/* endpoints enforce real per-key quotas.
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { McpQuotaError } from './auth.js';
+import { loadConfig } from './config.js';
+const DAILY_QUOTAS = {
+    'cognilead.draft_pitch': 20,
+    'cognilead.score_signal': 50,
+    'cognilead.check_registry_flags': 50,
+};
+function utcDate() {
+    return new Date().toISOString().slice(0, 10);
+}
+function quotaPath() {
+    return join(loadConfig().quotaDir, 'quota.json');
+}
+let cache = null;
+function load() {
+    if (cache && cache.date === utcDate())
+        return cache;
+    const today = utcDate();
+    try {
+        const raw = readFileSync(quotaPath(), 'utf8');
+        const parsed = JSON.parse(raw);
+        if (parsed.date === today && parsed.counts && typeof parsed.counts === 'object') {
+            cache = parsed;
+            return cache;
+        }
+    }
+    catch {
+        /* fall through — fresh start */
+    }
+    cache = { date: today, counts: {} };
+    return cache;
+}
+function persist(state) {
+    try {
+        const dir = loadConfig().quotaDir;
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(quotaPath(), JSON.stringify(state, null, 2), 'utf8');
+    }
+    catch {
+        // fail-open: read-only FS, locked-down sandbox, etc.
+    }
+}
+/**
+ * Increments the counter for `toolName` and throws McpQuotaError if the
+ * daily cap would be exceeded. Free tools call this AFTER input validation
+ * so we don't burn quota on malformed calls.
+ */
+export function consumeFreeQuota(toolName) {
+    const limit = DAILY_QUOTAS[toolName];
+    if (limit === undefined) {
+        // Free quota not defined for this tool — treat as unlimited.
+        return { remaining: Number.POSITIVE_INFINITY, limit: Number.POSITIVE_INFINITY };
+    }
+    const state = load();
+    const used = state.counts[toolName] ?? 0;
+    if (used >= limit) {
+        const { signupUrl } = loadConfig();
+        throw new McpQuotaError(`Free-tier daily limit hit for ${toolName} (${limit}/day). ` +
+            `Resets at UTC midnight. Upgrade for higher limits: ${signupUrl}`);
+    }
+    state.counts[toolName] = used + 1;
+    persist(state);
+    return { remaining: limit - state.counts[toolName], limit };
+}
+/** For tests / introspection. */
+export function _quotaSnapshot() {
+    return load();
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/rate-limit.js.map

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

package/dist/schemas.d.ts

@@ -0,0 +1,384 @@
+import { z } from 'zod';
+export declare const DraftPitchInput: z.ZodObject<{
+    company_domain: z.ZodString;
+    company_name: z.ZodString;
+    target_product: z.ZodString;
+    signal: z.ZodObject<{
+        source: z.ZodOptional<z.ZodString>;
+        source_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodString>;
+        raw_payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        source?: string | undefined;
+        source_url?: string | null | undefined;
+        description?: string | undefined;
+        raw_payload?: Record<string, unknown> | undefined;
+    }, {
+        source?: string | undefined;
+        source_url?: string | null | undefined;
+        description?: string | undefined;
+        raw_payload?: Record<string, unknown> | undefined;
+    }>;
+    jurisdiction: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    company_domain: string;
+    company_name: string;
+    target_product: string;
+    signal: {
+        source?: string | undefined;
+        source_url?: string | null | undefined;
+        description?: string | undefined;
+        raw_payload?: Record<string, unknown> | undefined;
+    };
+    jurisdiction: string;
+}, {
+    company_domain: string;
+    company_name: string;
+    target_product: string;
+    signal: {
+        source?: string | undefined;
+        source_url?: string | null | undefined;
+        description?: string | undefined;
+        raw_payload?: Record<string, unknown> | undefined;
+    };
+    jurisdiction?: string | undefined;
+}>;
+export type DraftPitchInput = z.infer<typeof DraftPitchInput>;
+export declare const DraftPitchJsonSchema: {
+    readonly type: "object";
+    readonly required: readonly ["company_domain", "company_name", "target_product", "signal"];
+    readonly properties: {
+        readonly company_domain: {
+            readonly type: "string";
+            readonly minLength: 3;
+            readonly description: "Company domain, e.g. acme.com";
+        };
+        readonly company_name: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly target_product: {
+            readonly type: "string";
+            readonly description: "Your product being pitched, e.g. chainlog, payprimitives";
+        };
+        readonly signal: {
+            readonly type: "object";
+            readonly properties: {
+                readonly source: {
+                    readonly type: "string";
+                };
+                readonly source_url: {
+                    readonly type: readonly ["string", "null"];
+                    readonly format: "uri";
+                };
+                readonly description: {
+                    readonly type: "string";
+                };
+                readonly raw_payload: {
+                    readonly type: "object";
+                    readonly additionalProperties: true;
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly jurisdiction: {
+            readonly type: "string";
+            readonly minLength: 2;
+            readonly maxLength: 2;
+            readonly default: "US";
+            readonly description: "ISO 3166 alpha-2 country code; drives EU/CH model routing";
+        };
+    };
+    readonly additionalProperties: false;
+};
+export declare const ScoreSignalInput: z.ZodObject<{
+    signal: z.ZodObject<{
+        source_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodString>;
+        raw_payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    } & {
+        source: z.ZodString;
+        scraped_at: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        source_url?: string | null | undefined;
+        description?: string | undefined;
+        raw_payload?: Record<string, unknown> | undefined;
+        scraped_at?: string | undefined;
+    }, {
+        source: string;
+        source_url?: string | null | undefined;
+        description?: string | undefined;
+        raw_payload?: Record<string, unknown> | undefined;
+        scraped_at?: string | undefined;
+    }>;
+    target_product: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    target_product: string;
+    signal: {
+        source: string;
+        source_url?: string | null | undefined;
+        description?: string | undefined;
+        raw_payload?: Record<string, unknown> | undefined;
+        scraped_at?: string | undefined;
+    };
+}, {
+    target_product: string;
+    signal: {
+        source: string;
+        source_url?: string | null | undefined;
+        description?: string | undefined;
+        raw_payload?: Record<string, unknown> | undefined;
+        scraped_at?: string | undefined;
+    };
+}>;
+export type ScoreSignalInput = z.infer<typeof ScoreSignalInput>;
+export declare const ScoreSignalJsonSchema: {
+    readonly type: "object";
+    readonly required: readonly ["signal", "target_product"];
+    readonly properties: {
+        readonly signal: {
+            readonly type: "object";
+            readonly required: readonly ["source"];
+            readonly properties: {
+                readonly source: {
+                    readonly type: "string";
+                    readonly description: "e.g. github_repo, hn_who_hiring, apify_linkedin_jobs";
+                };
+                readonly source_url: {
+                    readonly type: readonly ["string", "null"];
+                    readonly format: "uri";
+                };
+                readonly description: {
+                    readonly type: "string";
+                };
+                readonly scraped_at: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly raw_payload: {
+                    readonly type: "object";
+                    readonly additionalProperties: true;
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly target_product: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+    };
+    readonly additionalProperties: false;
+};
+export declare const IngestLeadInput: z.ZodObject<{
+    company_domain: z.ZodString;
+    company_name: z.ZodString;
+    target_product: z.ZodString;
+    best_contact_email: z.ZodNullable<z.ZodString>;
+    contact_role_class: z.ZodNullable<z.ZodEnum<["eng_lead", "cto", "founder", "recruit", "unknown"]>>;
+    jurisdiction: z.ZodString;
+    technical_hook_text: z.ZodNullable<z.ZodString>;
+    technical_hook_verified: z.ZodBoolean;
+    signal_ids: z.ZodArray<z.ZodString, "many">;
+    fit_score: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    company_domain: string;
+    company_name: string;
+    target_product: string;
+    jurisdiction: string;
+    best_contact_email: string | null;
+    contact_role_class: "unknown" | "eng_lead" | "cto" | "founder" | "recruit" | null;
+    technical_hook_text: string | null;
+    technical_hook_verified: boolean;
+    signal_ids: string[];
+    fit_score: number | null;
+}, {
+    company_domain: string;
+    company_name: string;
+    target_product: string;
+    jurisdiction: string;
+    best_contact_email: string | null;
+    contact_role_class: "unknown" | "eng_lead" | "cto" | "founder" | "recruit" | null;
+    technical_hook_text: string | null;
+    technical_hook_verified: boolean;
+    signal_ids: string[];
+    fit_score: number | null;
+}>;
+export type IngestLeadInput = z.infer<typeof IngestLeadInput>;
+export declare const IngestLeadJsonSchema: {
+    readonly type: "object";
+    readonly required: readonly ["company_domain", "company_name", "target_product", "best_contact_email", "contact_role_class", "jurisdiction", "technical_hook_text", "technical_hook_verified", "signal_ids", "fit_score"];
+    readonly properties: {
+        readonly company_domain: {
+            readonly type: "string";
+            readonly minLength: 3;
+        };
+        readonly company_name: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly target_product: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly best_contact_email: {
+            readonly type: readonly ["string", "null"];
+            readonly format: "email";
+        };
+        readonly contact_role_class: {
+            readonly type: readonly ["string", "null"];
+            readonly enum: readonly ["eng_lead", "cto", "founder", "recruit", "unknown", null];
+        };
+        readonly jurisdiction: {
+            readonly type: "string";
+            readonly minLength: 2;
+            readonly maxLength: 2;
+        };
+        readonly technical_hook_text: {
+            readonly type: readonly ["string", "null"];
+        };
+        readonly technical_hook_verified: {
+            readonly type: "boolean";
+        };
+        readonly signal_ids: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly fit_score: {
+            readonly type: readonly ["integer", "null"];
+            readonly minimum: 0;
+            readonly maximum: 100;
+        };
+    };
+    readonly additionalProperties: false;
+};
+export declare const RunCampaignInput: z.ZodObject<{
+    campaign_id: z.ZodString;
+    lead_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    campaign_id: string;
+    lead_ids?: string[] | undefined;
+}, {
+    campaign_id: string;
+    lead_ids?: string[] | undefined;
+}>;
+export type RunCampaignInput = z.infer<typeof RunCampaignInput>;
+export declare const RunCampaignJsonSchema: {
+    readonly type: "object";
+    readonly required: readonly ["campaign_id"];
+    readonly properties: {
+        readonly campaign_id: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly lead_ids: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+    };
+    readonly additionalProperties: false;
+};
+export declare const SuppressInput: z.ZodEffects<z.ZodObject<{
+    email: z.ZodOptional<z.ZodString>;
+    domain: z.ZodOptional<z.ZodString>;
+    reason: z.ZodEnum<["unsubscribe", "bounce_hard", "bounce_soft_repeat", "reply_negative", "gdpr_request", "manual"]>;
+}, "strip", z.ZodTypeAny, {
+    reason: "unsubscribe" | "bounce_hard" | "bounce_soft_repeat" | "reply_negative" | "gdpr_request" | "manual";
+    email?: string | undefined;
+    domain?: string | undefined;
+}, {
+    reason: "unsubscribe" | "bounce_hard" | "bounce_soft_repeat" | "reply_negative" | "gdpr_request" | "manual";
+    email?: string | undefined;
+    domain?: string | undefined;
+}>, {
+    reason: "unsubscribe" | "bounce_hard" | "bounce_soft_repeat" | "reply_negative" | "gdpr_request" | "manual";
+    email?: string | undefined;
+    domain?: string | undefined;
+}, {
+    reason: "unsubscribe" | "bounce_hard" | "bounce_soft_repeat" | "reply_negative" | "gdpr_request" | "manual";
+    email?: string | undefined;
+    domain?: string | undefined;
+}>;
+export type SuppressInput = z.infer<typeof SuppressInput>;
+export declare const SuppressJsonSchema: {
+    readonly type: "object";
+    readonly required: readonly ["reason"];
+    readonly properties: {
+        readonly email: {
+            readonly type: "string";
+            readonly format: "email";
+        };
+        readonly domain: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly reason: {
+            readonly type: "string";
+            readonly enum: readonly ["unsubscribe", "bounce_hard", "bounce_soft_repeat", "reply_negative", "gdpr_request", "manual"];
+        };
+    };
+    readonly additionalProperties: false;
+    readonly description: "Either email or domain must be provided.";
+};
+export declare const GenerateSeoContentInput: z.ZodObject<{
+    kind: z.ZodEnum<["blog", "landing", "recommendations"]>;
+    product: z.ZodString;
+    topic: z.ZodString;
+    target_keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    audience: z.ZodOptional<z.ZodString>;
+    existing_content: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "blog" | "landing" | "recommendations";
+    product: string;
+    topic: string;
+    target_keywords?: string[] | undefined;
+    audience?: string | undefined;
+    existing_content?: string | undefined;
+}, {
+    kind: "blog" | "landing" | "recommendations";
+    product: string;
+    topic: string;
+    target_keywords?: string[] | undefined;
+    audience?: string | undefined;
+    existing_content?: string | undefined;
+}>;
+export type GenerateSeoContentInput = z.infer<typeof GenerateSeoContentInput>;
+export declare const GenerateSeoContentJsonSchema: {
+    readonly type: "object";
+    readonly required: readonly ["kind", "product", "topic"];
+    readonly properties: {
+        readonly kind: {
+            readonly type: "string";
+            readonly enum: readonly ["blog", "landing", "recommendations"];
+        };
+        readonly product: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "The product/brand the content markets.";
+        };
+        readonly topic: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Primary topic or page intent.";
+        };
+        readonly target_keywords: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly audience: {
+            readonly type: "string";
+        };
+        readonly existing_content: {
+            readonly type: "string";
+            readonly description: "For kind=recommendations: the page text to audit.";
+        };
+    };
+    readonly additionalProperties: false;
+};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAevB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM1B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAE7D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BvB,CAAA;AAIV,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM3B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBxB,CAAA;AAKV,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa1B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAE7D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BvB,CAAA;AAIV,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;CAQxB,CAAA;AAIV,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;EAgBvB,CAAA;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEzD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;CAoBrB,CAAA;AAIV,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;EAOlC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAY/B,CAAA"}