@heyseo/mcp-server 0.2.0 → 0.2.1

package/dist/tools/indexing.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Indexing Tools
+ * Tools for monitoring and managing URL indexing health
+ */
+import { z } from 'zod';
+import type { HeySeoApiClient } from '../utils/api-client.js';
+export declare const indexingStatusSchema: z.ZodObject<{
+    siteId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    siteId: string;
+}, {
+    siteId: string;
+}>;
+export type IndexingStatusInput = z.infer<typeof indexingStatusSchema>;
+export declare const indexingPagesSchema: z.ZodObject<{
+    siteId: z.ZodString;
+    status: z.ZodDefault<z.ZodOptional<z.ZodEnum<["indexed", "not_indexed", "all"]>>>;
+}, "strip", z.ZodTypeAny, {
+    status: "indexed" | "all" | "not_indexed";
+    siteId: string;
+}, {
+    siteId: string;
+    status?: "indexed" | "all" | "not_indexed" | undefined;
+}>;
+export type IndexingPagesInput = z.infer<typeof indexingPagesSchema>;
+export declare const submitForIndexingSchema: z.ZodObject<{
+    siteId: z.ZodString;
+    pageId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    siteId: string;
+    pageId: string;
+}, {
+    siteId: string;
+    pageId: string;
+}>;
+export type SubmitForIndexingInput = z.infer<typeof submitForIndexingSchema>;
+export declare function executeIndexingStatus(client: HeySeoApiClient, input: IndexingStatusInput): Promise<string>;
+export declare function executeIndexingPages(client: HeySeoApiClient, input: IndexingPagesInput): Promise<string>;
+export declare function executeSubmitForIndexing(client: HeySeoApiClient, input: SubmitForIndexingInput): Promise<string>;
+export declare const indexingTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            status?: undefined;
+            pageId?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            status: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            pageId?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            pageId: {
+                type: string;
+                description: string;
+            };
+            status?: undefined;
+        };
+        required: string[];
+    };
+})[];
+//# sourceMappingURL=indexing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"indexing.d.ts","sourceRoot":"","sources":["../../src/tools/indexing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,eAAO,MAAM,oBAAoB;;;;;;EAE/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,eAAO,MAAM,uBAAuB;;;;;;;;;EAGlC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE7E,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA0CzB,CAAC"}

package/dist/tools/indexing.js

@@ -0,0 +1,99 @@
+/**
+ * Indexing Tools
+ * Tools for monitoring and managing URL indexing health
+ */
+import { z } from 'zod';
+export const indexingStatusSchema = z.object({
+    siteId: z.string().describe('The ID of the site to check indexing status for'),
+});
+export const indexingPagesSchema = z.object({
+    siteId: z.string().describe('The ID of the site'),
+    status: z.enum(['indexed', 'not_indexed', 'all']).optional().default('all').describe('Filter by indexing status'),
+});
+export const submitForIndexingSchema = z.object({
+    siteId: z.string().describe('The ID of the site'),
+    pageId: z.string().describe('The ID of the page to submit for indexing'),
+});
+export async function executeIndexingStatus(client, input) {
+    try {
+        const summary = await client.getIndexingStatus(input.siteId);
+        return JSON.stringify({ success: true, ...summary }, null, 2);
+    }
+    catch (error) {
+        return JSON.stringify({ success: false, error: error instanceof Error ? error.message : 'Unknown error' });
+    }
+}
+export async function executeIndexingPages(client, input) {
+    try {
+        const result = await client.getIndexingPages(input.siteId, input.status);
+        return JSON.stringify({
+            success: true,
+            total: result.total,
+            pages: result.pages.map(p => ({
+                id: p.id,
+                url: p.url,
+                verdict: p.verdict,
+                coverageState: p.coverageState,
+                indexingState: p.indexingState,
+                lastCheckedAt: p.lastCheckedAt,
+                lastCrawlTime: p.lastCrawlTime,
+            })),
+        }, null, 2);
+    }
+    catch (error) {
+        return JSON.stringify({ success: false, error: error instanceof Error ? error.message : 'Unknown error' });
+    }
+}
+export async function executeSubmitForIndexing(client, input) {
+    try {
+        const result = await client.submitForIndexing(input.siteId, input.pageId);
+        return JSON.stringify({ success: true, ...result }, null, 2);
+    }
+    catch (error) {
+        return JSON.stringify({ success: false, error: error instanceof Error ? error.message : 'Unknown error' });
+    }
+}
+export const indexingTools = [
+    {
+        name: 'heyseo_indexing_status',
+        description: `Get the indexing health summary for a site.
+
+Returns the total number of pages monitored, how many are indexed vs not indexed, and overall health metrics.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                siteId: { type: 'string', description: 'The ID of the site' },
+            },
+            required: ['siteId'],
+        },
+    },
+    {
+        name: 'heyseo_indexing_pages',
+        description: `List pages with their indexing status.
+
+Returns each monitored page with its indexing verdict (PASS/FAIL), coverage state, and when it was last checked or crawled. Filter by indexed/not_indexed status.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                siteId: { type: 'string', description: 'The ID of the site' },
+                status: { type: 'string', enum: ['indexed', 'not_indexed', 'all'], default: 'all', description: 'Filter by indexing status' },
+            },
+            required: ['siteId'],
+        },
+    },
+    {
+        name: 'heyseo_submit_for_indexing',
+        description: `Submit a page to Google's Indexing API for faster indexing.
+
+Requires the page to already be tracked in the indexing monitor. Use heyseo_indexing_pages to find the page ID first.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                siteId: { type: 'string', description: 'The ID of the site' },
+                pageId: { type: 'string', description: 'The ID of the page to submit' },
+            },
+            required: ['siteId', 'pageId'],
+        },
+    },
+];
+//# sourceMappingURL=indexing.js.map

package/dist/tools/indexing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexing.js","sourceRoot":"","sources":["../../src/tools/indexing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;CAC/E,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACjD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CAClH,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACjD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CACzE,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAuB,EACvB,KAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IAC7G,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAuB,EACvB,KAAyB;IAEzB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAEzE,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC5B,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,aAAa,EAAE,CAAC,CAAC,aAAa;gBAC9B,aAAa,EAAE,CAAC,CAAC,aAAa;gBAC9B,aAAa,EAAE,CAAC,CAAC,aAAa;gBAC9B,aAAa,EAAE,CAAC,CAAC,aAAa;aAC/B,CAAC,CAAC;SACJ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IAC7G,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAuB,EACvB,KAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IAC7G,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE;;8GAE6F;QAC1G,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;aAC9D;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE;;kKAEiJ;QAC9J,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;gBAC7D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,2BAA2B,EAAE;aAC9H;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE;;sHAEqG;QAClH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;gBAC7D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;aACxE;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;SAC/B;KACF;CACF,CAAC"}

package/dist/tools/insights.d.ts

@@ -0,0 +1,38 @@
+/**
+ * AI Insights Tools
+ * Tools for accessing AI-generated SEO insights
+ */
+import { z } from 'zod';
+import type { HeySeoApiClient } from '../utils/api-client.js';
+export declare const getInsightsSchema: z.ZodObject<{
+    siteId: z.ZodString;
+    unreadOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    siteId: string;
+    unreadOnly: boolean;
+}, {
+    siteId: string;
+    unreadOnly?: boolean | undefined;
+}>;
+export type GetInsightsInput = z.infer<typeof getInsightsSchema>;
+export declare function executeGetInsights(client: HeySeoApiClient, input: GetInsightsInput): Promise<string>;
+export declare const insightTools: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            siteId: {
+                type: string;
+                description: string;
+            };
+            unreadOnly: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+}[];
+//# sourceMappingURL=insights.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../../src/tools/insights.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;GAexB,CAAC"}

package/dist/tools/insights.js

@@ -0,0 +1,58 @@
+/**
+ * AI Insights Tools
+ * Tools for accessing AI-generated SEO insights
+ */
+import { z } from 'zod';
+export const getInsightsSchema = z.object({
+    siteId: z.string().describe('The ID of the site'),
+    unreadOnly: z.boolean().optional().default(false).describe('Only return unread insights'),
+});
+export async function executeGetInsights(client, input) {
+    try {
+        const result = await client.getInsights(input.siteId, input.unreadOnly);
+        if (result.insights.length === 0) {
+            return JSON.stringify({
+                success: true,
+                message: 'No insights found. Insights are generated automatically as the system detects anomalies, opportunities, and trends.',
+                unreadCount: 0,
+                insights: [],
+            });
+        }
+        return JSON.stringify({
+            success: true,
+            unreadCount: result.unreadCount,
+            hasUnread: result.hasUnread,
+            insights: result.insights.map(i => ({
+                id: i.id,
+                type: i.type,
+                severity: i.severity,
+                title: i.title,
+                description: i.description,
+                suggestedActions: i.suggestedActions,
+                createdAt: i.createdAt,
+                isRead: !!i.readAt,
+                isDismissed: !!i.dismissedAt,
+            })),
+        }, null, 2);
+    }
+    catch (error) {
+        return JSON.stringify({ success: false, error: error instanceof Error ? error.message : 'Unknown error' });
+    }
+}
+export const insightTools = [
+    {
+        name: 'heyseo_get_insights',
+        description: `Get AI-generated insights for a site.
+
+Returns proactive insights including anomalies, opportunities, alerts, trends, and milestones. Each insight includes a severity level, description, and suggested actions.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                siteId: { type: 'string', description: 'The ID of the site' },
+                unreadOnly: { type: 'boolean', default: false, description: 'Only return unread insights' },
+            },
+            required: ['siteId'],
+        },
+    },
+];
+//# sourceMappingURL=insights.js.map

package/dist/tools/insights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights.js","sourceRoot":"","sources":["../../src/tools/insights.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;CAC1F,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAuB,EACvB,KAAuB;IAEvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAExE,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,qHAAqH;gBAC9H,WAAW,EAAE,CAAC;gBACd,QAAQ,EAAE,EAAE;aACb,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAClC,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;gBACpC,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM;gBAClB,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW;aAC7B,CAAC,CAAC;SACJ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IAC7G,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE;;2KAE0J;QACvK,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;gBAC7D,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,6BAA6B,EAAE;aAC5F;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;CACF,CAAC"}

package/dist/tools/memory.d.ts

@@ -0,0 +1,329 @@
+/**
+ * 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 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;
+        };
+        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;
+        };
+        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;
+        };
+        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;
+        };
+        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":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,eAAO,MAAM,eAAe;;;;;;EAE1B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE7D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW/B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS7B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;EAQ5B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,MAAM,CAAC,CA8CjB;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,MAAM,CAAC,CA0CjB;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+EvB,CAAC"}