@heyseo/mcp-server 0.2.0 → 0.3.0

package/dist/tools/memory.d.ts

@@ -0,0 +1,602 @@
+/**
+ * SEO Memory Tools
+ * Tools for accessing and updating the SEO memory system (strategy, goals, actions, learnings)
+ */
+import { z } from 'zod';
+import type { HeySeoApiClient } from '../utils/api-client.js';
+export declare const getMemorySchema: z.ZodObject<{
+    siteId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    siteId: string;
+}, {
+    siteId: string;
+}>;
+export type GetMemoryInput = z.infer<typeof getMemorySchema>;
+export declare const updateStrategySchema: z.ZodObject<{
+    siteId: z.ZodString;
+    action: z.ZodEnum<["update_summary", "create_goal", "update_goal"]>;
+    strategySummary: z.ZodOptional<z.ZodString>;
+    goalType: z.ZodOptional<z.ZodEnum<["clicks", "position", "ctr", "traffic", "ranking", "custom"]>>;
+    goalDescription: z.ZodOptional<z.ZodString>;
+    goalTargetValue: z.ZodOptional<z.ZodNumber>;
+    goalCurrentValue: z.ZodOptional<z.ZodNumber>;
+    goalTargetDate: z.ZodOptional<z.ZodString>;
+    goalId: z.ZodOptional<z.ZodString>;
+    goalStatus: z.ZodOptional<z.ZodEnum<["active", "achieved", "missed", "paused"]>>;
+}, "strip", z.ZodTypeAny, {
+    siteId: string;
+    action: "update_summary" | "create_goal" | "update_goal";
+    strategySummary?: string | undefined;
+    goalType?: "clicks" | "ctr" | "position" | "custom" | "traffic" | "ranking" | undefined;
+    goalDescription?: string | undefined;
+    goalTargetValue?: number | undefined;
+    goalCurrentValue?: number | undefined;
+    goalTargetDate?: string | undefined;
+    goalId?: string | undefined;
+    goalStatus?: "active" | "achieved" | "missed" | "paused" | undefined;
+}, {
+    siteId: string;
+    action: "update_summary" | "create_goal" | "update_goal";
+    strategySummary?: string | undefined;
+    goalType?: "clicks" | "ctr" | "position" | "custom" | "traffic" | "ranking" | undefined;
+    goalDescription?: string | undefined;
+    goalTargetValue?: number | undefined;
+    goalCurrentValue?: number | undefined;
+    goalTargetDate?: string | undefined;
+    goalId?: string | undefined;
+    goalStatus?: "active" | "achieved" | "missed" | "paused" | undefined;
+}>;
+export type UpdateStrategyInput = z.infer<typeof updateStrategySchema>;
+export declare const recordActionSchema: z.ZodObject<{
+    siteId: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    category: z.ZodEnum<["technical", "content", "links", "ux"]>;
+    hypothesis: z.ZodOptional<z.ZodString>;
+    targetMetrics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    measurementDays: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    goalId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    siteId: string;
+    title: string;
+    category: "technical" | "content" | "links" | "ux";
+    measurementDays: number;
+    hypothesis?: string | undefined;
+    targetMetrics?: string[] | undefined;
+    goalId?: string | undefined;
+}, {
+    description: string;
+    siteId: string;
+    title: string;
+    category: "technical" | "content" | "links" | "ux";
+    hypothesis?: string | undefined;
+    targetMetrics?: string[] | undefined;
+    goalId?: string | undefined;
+    measurementDays?: number | undefined;
+}>;
+export type RecordActionInput = z.infer<typeof recordActionSchema>;
+export declare const addLearningSchema: z.ZodObject<{
+    siteId: z.ZodString;
+    type: z.ZodEnum<["fact", "pattern"]>;
+    fact: z.ZodOptional<z.ZodString>;
+    pattern: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodString>;
+    applicableCategories: z.ZodOptional<z.ZodArray<z.ZodEnum<["technical", "content", "links", "ux"]>, "many">>;
+    confidence: z.ZodDefault<z.ZodOptional<z.ZodEnum<["high", "medium", "low"]>>>;
+}, "strip", z.ZodTypeAny, {
+    type: "fact" | "pattern";
+    siteId: string;
+    confidence: "high" | "medium" | "low";
+    fact?: string | undefined;
+    pattern?: string | undefined;
+    evidence?: string | undefined;
+    applicableCategories?: ("technical" | "content" | "links" | "ux")[] | undefined;
+}, {
+    type: "fact" | "pattern";
+    siteId: string;
+    fact?: string | undefined;
+    pattern?: string | undefined;
+    evidence?: string | undefined;
+    applicableCategories?: ("technical" | "content" | "links" | "ux")[] | undefined;
+    confidence?: "high" | "medium" | "low" | undefined;
+}>;
+export type AddLearningInput = z.infer<typeof addLearningSchema>;
+export declare function executeGetMemory(client: HeySeoApiClient, input: GetMemoryInput): Promise<string>;
+export declare function executeUpdateStrategy(client: HeySeoApiClient, input: UpdateStrategyInput): Promise<string>;
+export declare function executeRecordAction(client: HeySeoApiClient, input: RecordActionInput): Promise<string>;
+export declare function executeAddLearning(client: HeySeoApiClient, input: AddLearningInput): Promise<string>;
+export declare const deleteGoalSchema: z.ZodObject<{
+    siteId: z.ZodString;
+    goalId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    siteId: string;
+    goalId: string;
+}, {
+    siteId: string;
+    goalId: string;
+}>;
+export type DeleteGoalInput = z.infer<typeof deleteGoalSchema>;
+export declare const memorySnapshotsSchema: z.ZodObject<{
+    siteId: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    siteId: string;
+    limit: number;
+}, {
+    siteId: string;
+    limit?: number | undefined;
+}>;
+export type MemorySnapshotsInput = z.infer<typeof memorySnapshotsSchema>;
+export declare const generateSnapshotSchema: z.ZodObject<{
+    siteId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    siteId: string;
+}, {
+    siteId: string;
+}>;
+export type GenerateSnapshotInput = z.infer<typeof generateSnapshotSchema>;
+export declare const queueActionSchema: z.ZodObject<{
+    siteId: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    category: z.ZodEnum<["technical", "content", "links", "ux"]>;
+    priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    siteId: string;
+    title: string;
+    category: "technical" | "content" | "links" | "ux";
+    priority?: "high" | "medium" | "low" | undefined;
+}, {
+    description: string;
+    siteId: string;
+    title: string;
+    category: "technical" | "content" | "links" | "ux";
+    priority?: "high" | "medium" | "low" | undefined;
+}>;
+export type QueueActionInput = z.infer<typeof queueActionSchema>;
+export declare const updateQueuedActionSchema: z.ZodObject<{
+    siteId: z.ZodString;
+    actionId: z.ZodString;
+    status: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+}, "strip", z.ZodTypeAny, {
+    siteId: string;
+    actionId: string;
+    status?: string | undefined;
+    priority?: "high" | "medium" | "low" | undefined;
+}, {
+    siteId: string;
+    actionId: string;
+    status?: string | undefined;
+    priority?: "high" | "medium" | "low" | undefined;
+}>;
+export type UpdateQueuedActionInput = z.infer<typeof updateQueuedActionSchema>;
+export declare function executeDeleteGoal(client: HeySeoApiClient, input: DeleteGoalInput): Promise<string>;
+export declare function executeMemorySnapshots(client: HeySeoApiClient, input: MemorySnapshotsInput): Promise<string>;
+export declare function executeGenerateSnapshot(client: HeySeoApiClient, input: GenerateSnapshotInput): Promise<string>;
+export declare function executeQueueAction(client: HeySeoApiClient, input: QueueActionInput): Promise<string>;
+export declare function executeUpdateQueuedAction(client: HeySeoApiClient, input: UpdateQueuedActionInput): Promise<string>;
+export declare const memoryTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            action?: undefined;
+            strategySummary?: undefined;
+            goalType?: undefined;
+            goalDescription?: undefined;
+            goalTargetValue?: undefined;
+            goalCurrentValue?: undefined;
+            goalTargetDate?: undefined;
+            goalId?: undefined;
+            goalStatus?: undefined;
+            title?: undefined;
+            description?: undefined;
+            category?: undefined;
+            hypothesis?: undefined;
+            targetMetrics?: undefined;
+            measurementDays?: undefined;
+            type?: undefined;
+            fact?: undefined;
+            pattern?: undefined;
+            evidence?: undefined;
+            applicableCategories?: undefined;
+            confidence?: undefined;
+            limit?: undefined;
+            priority?: undefined;
+            actionId?: undefined;
+            status?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            strategySummary: {
+                type: string;
+                description: string;
+            };
+            goalType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            goalDescription: {
+                type: string;
+                description: string;
+            };
+            goalTargetValue: {
+                type: string;
+                description: string;
+            };
+            goalCurrentValue: {
+                type: string;
+                description: string;
+            };
+            goalTargetDate: {
+                type: string;
+                description: string;
+            };
+            goalId: {
+                type: string;
+                description: string;
+            };
+            goalStatus: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            title?: undefined;
+            description?: undefined;
+            category?: undefined;
+            hypothesis?: undefined;
+            targetMetrics?: undefined;
+            measurementDays?: undefined;
+            type?: undefined;
+            fact?: undefined;
+            pattern?: undefined;
+            evidence?: undefined;
+            applicableCategories?: undefined;
+            confidence?: undefined;
+            limit?: undefined;
+            priority?: undefined;
+            actionId?: undefined;
+            status?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            category: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            hypothesis: {
+                type: string;
+                description: string;
+            };
+            targetMetrics: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            measurementDays: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+            goalId: {
+                type: string;
+                description: string;
+            };
+            action?: undefined;
+            strategySummary?: undefined;
+            goalType?: undefined;
+            goalDescription?: undefined;
+            goalTargetValue?: undefined;
+            goalCurrentValue?: undefined;
+            goalTargetDate?: undefined;
+            goalStatus?: undefined;
+            type?: undefined;
+            fact?: undefined;
+            pattern?: undefined;
+            evidence?: undefined;
+            applicableCategories?: undefined;
+            confidence?: undefined;
+            limit?: undefined;
+            priority?: undefined;
+            actionId?: undefined;
+            status?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            fact: {
+                type: string;
+                description: string;
+            };
+            pattern: {
+                type: string;
+                description: string;
+            };
+            evidence: {
+                type: string;
+                description: string;
+            };
+            applicableCategories: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                description: string;
+            };
+            confidence: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            action?: undefined;
+            strategySummary?: undefined;
+            goalType?: undefined;
+            goalDescription?: undefined;
+            goalTargetValue?: undefined;
+            goalCurrentValue?: undefined;
+            goalTargetDate?: undefined;
+            goalId?: undefined;
+            goalStatus?: undefined;
+            title?: undefined;
+            description?: undefined;
+            category?: undefined;
+            hypothesis?: undefined;
+            targetMetrics?: undefined;
+            measurementDays?: undefined;
+            limit?: undefined;
+            priority?: undefined;
+            actionId?: undefined;
+            status?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            goalId: {
+                type: string;
+                description: string;
+            };
+            action?: undefined;
+            strategySummary?: undefined;
+            goalType?: undefined;
+            goalDescription?: undefined;
+            goalTargetValue?: undefined;
+            goalCurrentValue?: undefined;
+            goalTargetDate?: undefined;
+            goalStatus?: undefined;
+            title?: undefined;
+            description?: undefined;
+            category?: undefined;
+            hypothesis?: undefined;
+            targetMetrics?: undefined;
+            measurementDays?: undefined;
+            type?: undefined;
+            fact?: undefined;
+            pattern?: undefined;
+            evidence?: undefined;
+            applicableCategories?: undefined;
+            confidence?: undefined;
+            limit?: undefined;
+            priority?: undefined;
+            actionId?: undefined;
+            status?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+            action?: undefined;
+            strategySummary?: undefined;
+            goalType?: undefined;
+            goalDescription?: undefined;
+            goalTargetValue?: undefined;
+            goalCurrentValue?: undefined;
+            goalTargetDate?: undefined;
+            goalId?: undefined;
+            goalStatus?: undefined;
+            title?: undefined;
+            description?: undefined;
+            category?: undefined;
+            hypothesis?: undefined;
+            targetMetrics?: undefined;
+            measurementDays?: undefined;
+            type?: undefined;
+            fact?: undefined;
+            pattern?: undefined;
+            evidence?: undefined;
+            applicableCategories?: undefined;
+            confidence?: undefined;
+            priority?: undefined;
+            actionId?: undefined;
+            status?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            category: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            priority: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            action?: undefined;
+            strategySummary?: undefined;
+            goalType?: undefined;
+            goalDescription?: undefined;
+            goalTargetValue?: undefined;
+            goalCurrentValue?: undefined;
+            goalTargetDate?: undefined;
+            goalId?: undefined;
+            goalStatus?: undefined;
+            hypothesis?: undefined;
+            targetMetrics?: undefined;
+            measurementDays?: undefined;
+            type?: undefined;
+            fact?: undefined;
+            pattern?: undefined;
+            evidence?: undefined;
+            applicableCategories?: undefined;
+            confidence?: undefined;
+            limit?: undefined;
+            actionId?: undefined;
+            status?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            actionId: {
+                type: string;
+                description: string;
+            };
+            status: {
+                type: string;
+                description: string;
+            };
+            priority: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            action?: undefined;
+            strategySummary?: undefined;
+            goalType?: undefined;
+            goalDescription?: undefined;
+            goalTargetValue?: undefined;
+            goalCurrentValue?: undefined;
+            goalTargetDate?: undefined;
+            goalId?: undefined;
+            goalStatus?: undefined;
+            title?: undefined;
+            description?: undefined;
+            category?: undefined;
+            hypothesis?: undefined;
+            targetMetrics?: undefined;
+            measurementDays?: undefined;
+            type?: undefined;
+            fact?: undefined;
+            pattern?: undefined;
+            evidence?: undefined;
+            applicableCategories?: undefined;
+            confidence?: undefined;
+            limit?: undefined;
+        };
+        required: string[];
+    };
+})[];
+//# sourceMappingURL=memory.d.ts.map

package/dist/tools/memory.d.ts.map

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