Open source alternative to Semrush and Ahrefs
TypeScript backlink-analysisgoogle-search-console-mcpkeyword-researchmcpseoseo-agentseo-auditseo-automationseo-skillsseo-toolssite-audit
import { z } from "zod";
// Shared vocabulary for project memory. The MCP tools, the server functions and
// the settings UI all validate against these, so the wire shape of a patch op is
// defined exactly once.
export const PROJECT_CONTEXT_SECTION_KEYS = [
"business_overview",
"current_goal",
"positioning",
"writing_preferences",
] as const;
const projectContextSectionKeySchema = z.enum(PROJECT_CONTEXT_SECTION_KEYS);
export type ProjectContextSectionKey = z.infer<
typeof projectContextSectionKeySchema
>;
export const PROJECT_CONTEXT_SECTION_LABELS: Record<
ProjectContextSectionKey,
string
> = {
business_overview: "Business overview",
current_goal: "Current goal",
positioning: "Positioning",
writing_preferences: "Writing preferences",
};
/** Cap on every prose section, enforced by the service and hinted in the UI. */
export const PROSE_MAX_CHARS = 4000;
export const KEY_PAGE_ROLES = ["hub", "spoke", "money", "other"] as const;
const keyPageRoleSchema = z.enum(KEY_PAGE_ROLES);
export type KeyPageRole = z.infer<typeof keyPageRoleSchema>;
const CONTEXT_AUTHORS = ["user", "sam", "mcp"] as const;
const contextAuthorSchema = z.enum(CONTEXT_AUTHORS);
export type ContextAuthor = z.infer<typeof contextAuthorSchema>;
// Custom sections are addressed by slug; the stored key is `custom:<slug>`.
const customSectionSlugSchema = z
.string()
.trim()
.max(60)
.regex(
/^[a-z0-9]+(?:-[a-z0-9]+)*$/,
"Use a lowercase slug like 'launch-plan'",
)
.describe(
"Lowercase letters and digits separated by hyphens, e.g. 'launch-plan'. No underscores or spaces. Use the same slug to edit or delete the section.",
);
export const CUSTOM_SECTION_KEY_PREFIX = "custom:";
const competitorInputSchema = z.object({
domain: z.string().trim().min(1).max(255),
name: z.string().trim().max(120).optional(),
notes: z.string().trim().max(500).optional(),
});
const keyPageInputSchema = z.object({
url: z.string().trim().min(1).max(2048),
// Optional on purpose: an omitted role keeps the stored classification, so
// an agent re-adding a known URL can't clobber the user's hand-set label.
role: keyPageRoleSchema.optional(),
topic: z.string().trim().max(200).optional(),
notes: z.string().trim().max(500).optional(),
});
// A patch op, discriminated by which key it carries. Strict objects keep the
// members disjoint, so a typo like `{ section, contents }` fails validation
// instead of silently matching another member.
// Content length and per-project row caps are NOT enforced here — the service
// owns them so every writer (server fn, MCP tool, SAM) hits the same limits.
const projectContextUpdateSchema = z.union([
z.strictObject({
section: projectContextSectionKeySchema,
// An empty string clears the section.
content: z.string(),
}),
z.strictObject({
customSection: customSectionSlugSchema,
title: z.string().trim().min(1).max(120).optional(),
content: z.string(),
}),
z.strictObject({ deleteCustomSection: customSectionSlugSchema }),
z.strictObject({
addCompetitors: z.array(competitorInputSchema).min(1).max(100),
}),
z.strictObject({
removeCompetitors: z.array(z.string().trim().min(1)).min(1).max(100),
}),
z.strictObject({
addKeyPages: z.array(keyPageInputSchema).min(1).max(100),
}),
z.strictObject({
removeKeyPages: z.array(z.string().trim().min(1)).min(1).max(100),
}),
// Research log entries are addressed by id, since a summary is not unique.
z.strictObject({
removeResearchLog: z.array(z.string().min(1)).min(1).max(100),
}),
z.strictObject({
// The entry date is server-stamped, never supplied by the caller.
appendResearchLog: z.object({
summary: z.string().trim().min(1).max(1000),
}),
}),
]);
export type ProjectContextUpdate = z.infer<typeof projectContextUpdateSchema>;
export const getProjectContextSchema = z.object({
projectId: z.string().min(1),
});
export const updateProjectContextSchema = z.object({
projectId: z.string().min(1),
updates: z.array(projectContextUpdateSchema).min(1).max(50),
});