@rnsk/toolkits 0.0.10 → 0.0.12

package/dist/toolkits/wordpress/tools/index.d.ts

@@ -0,0 +1,489 @@
+import { wordpressCreateDraftPost } from './create-draft-post.js';
+import { wordpressDeleteDraftPost } from './delete-draft-post.js';
+import { wordpressGetPost } from './get-post.js';
+import { wordpressGetSiteOverview } from './get-site-overview.js';
+import { wordpressListBloggingPrompts } from './list-blogging-prompts.js';
+import { wordpressListCmsResources } from './list-cms-resources.js';
+import { wordpressListContent } from './list-content.js';
+import { wordpressListReaderSubscriptions } from './list-reader-subscriptions.js';
+import { wordpressListSites } from './list-sites.js';
+import { wordpressUpdateDraftPost } from './update-draft-post.js';
+export { wordpressCreateDraftPost, wordpressDeleteDraftPost, wordpressGetPost, wordpressGetSiteOverview, wordpressListBloggingPrompts, wordpressListCmsResources, wordpressListContent, wordpressListReaderSubscriptions, wordpressListSites, wordpressUpdateDraftPost, };
+export declare const wordpressTools: ({
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        title: string;
+        wordpressToken: string;
+        siteId: number;
+        content?: string | undefined;
+        categoryIds?: number[] | undefined;
+        excerpt?: string | undefined;
+        tagIds?: number[] | undefined;
+        featuredMediaId?: number | undefined;
+        commentStatus?: "open" | "closed" | undefined;
+    }, {
+        error: string;
+        details?: undefined;
+        post?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: any;
+        post?: undefined;
+        message?: undefined;
+    } | {
+        post: {
+            id: any;
+            status: any;
+            title: any;
+            content: any;
+            excerpt: any;
+            link: any;
+            slug: any;
+            authorId: any;
+            categoryIds: number[] | undefined;
+            tagIds: number[] | undefined;
+            commentStatus: any;
+            featuredMediaId: any;
+            date: any;
+            modified: any;
+        };
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        post?: undefined;
+    }>;
+    requiredAuth: "wordpressToken";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        postId: number;
+        wordpressToken: string;
+        siteId: number;
+    }, {
+        error: string;
+        details?: undefined;
+        deleted?: undefined;
+        post?: undefined;
+        raw?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: any;
+        deleted?: undefined;
+        post?: undefined;
+        raw?: undefined;
+        message?: undefined;
+    } | {
+        deleted: boolean;
+        post: {
+            id: any;
+            status: string;
+            title: any;
+        };
+        raw: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        deleted?: undefined;
+        post?: undefined;
+        raw?: undefined;
+    }>;
+    requiredAuth: "wordpressToken";
+    scope: "delete";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        postId: number;
+        wordpressToken: string;
+        siteId: number;
+    }, {
+        error: string;
+        details?: undefined;
+        post?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: any;
+        post?: undefined;
+        message?: undefined;
+    } | {
+        post: {
+            id: any;
+            status: any;
+            title: any;
+            content: any;
+            excerpt: any;
+            slug: any;
+            link: any;
+            date: any;
+            modified: any;
+            authorId: any;
+            categoryIds: any;
+            tagIds: any;
+            commentStatus: any;
+            featuredMediaId: any;
+        };
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        post?: undefined;
+    }>;
+    requiredAuth: "wordpressToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        wordpressToken: string;
+        siteId: number;
+        statsPeriod?: "year" | "month" | "day" | "week" | undefined;
+        statsPeriods?: number | undefined;
+    }, {
+        error: string;
+        details?: undefined;
+        site?: undefined;
+        settings?: undefined;
+        stats?: undefined;
+        warnings?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: any;
+        site?: undefined;
+        settings?: undefined;
+        stats?: undefined;
+        warnings?: undefined;
+        message?: undefined;
+    } | {
+        site: {
+            siteId: any;
+            name: any;
+            url: any;
+            description: any;
+            language: any;
+            isPrivate: any;
+            isAtomic: any;
+            isComingSoon: any;
+            jetpack: any;
+            plan: any;
+            capabilities: {
+                manage_options: any;
+            } | undefined;
+        };
+        settings: {
+            title: any;
+            description: any;
+            language: any;
+            timezone: any;
+            dateFormat: any;
+            timeFormat: any;
+            startOfWeek: any;
+            postsPerPage: any;
+            defaultCategory: any;
+            defaultPostFormat: any;
+            showOnFront: any;
+            pageOnFront: any;
+            pageForPosts: any;
+        };
+        stats: any;
+        warnings: string[];
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        site?: undefined;
+        settings?: undefined;
+        stats?: undefined;
+        warnings?: undefined;
+    }>;
+    requiredAuth: "wordpressToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        wordpressToken: string;
+        siteId: number;
+        pageSize?: number | undefined;
+        before?: string | undefined;
+        order?: "asc" | "desc" | undefined;
+        search?: string | undefined;
+        after?: string | undefined;
+        cursor?: string | undefined;
+        year?: number | undefined;
+    }, {
+        error: string;
+        details?: undefined;
+        items?: undefined;
+        hasMore?: undefined;
+        nextCursor?: undefined;
+        total?: undefined;
+        totalPages?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: any;
+        items?: undefined;
+        hasMore?: undefined;
+        nextCursor?: undefined;
+        total?: undefined;
+        totalPages?: undefined;
+        message?: undefined;
+    } | {
+        items: any;
+        hasMore: any;
+        nextCursor: any;
+        total: any;
+        totalPages: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        items?: undefined;
+        hasMore?: undefined;
+        nextCursor?: undefined;
+        total?: undefined;
+        totalPages?: undefined;
+    }>;
+    requiredAuth: "wordpressToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        resource: "categories" | "users" | "comments" | "tags" | "media";
+        wordpressToken: string;
+        siteId: number;
+        pageSize?: number | undefined;
+        search?: string | undefined;
+        cursor?: string | undefined;
+    }, {
+        error: string;
+        details?: undefined;
+        resource?: undefined;
+        items?: undefined;
+        hasMore?: undefined;
+        nextCursor?: undefined;
+        total?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: any;
+        resource?: undefined;
+        items?: undefined;
+        hasMore?: undefined;
+        nextCursor?: undefined;
+        total?: undefined;
+        message?: undefined;
+    } | {
+        resource: "categories" | "users" | "comments" | "tags" | "media";
+        items: any;
+        hasMore: boolean;
+        nextCursor: null;
+        total: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        resource?: undefined;
+        items?: undefined;
+        hasMore?: undefined;
+        nextCursor?: undefined;
+        total?: undefined;
+    }>;
+    requiredAuth: "wordpressToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        contentType: "pages" | "posts";
+        wordpressToken: string;
+        siteId: number;
+        pageSize?: number | undefined;
+        order?: "asc" | "desc" | undefined;
+        search?: string | undefined;
+        statuses?: string[] | undefined;
+        orderBy?: "date" | "title" | "id" | "modified" | "slug" | "relevance" | undefined;
+        cursor?: string | undefined;
+        authorId?: number | undefined;
+    }, {
+        error: string;
+        details?: undefined;
+        items?: undefined;
+        hasMore?: undefined;
+        nextCursor?: undefined;
+        total?: undefined;
+        totalPages?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: any;
+        items?: undefined;
+        hasMore?: undefined;
+        nextCursor?: undefined;
+        total?: undefined;
+        totalPages?: undefined;
+        message?: undefined;
+    } | {
+        items: any;
+        hasMore: boolean;
+        nextCursor: any;
+        total: any;
+        totalPages: number | undefined;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        items?: undefined;
+        hasMore?: undefined;
+        nextCursor?: undefined;
+        total?: undefined;
+        totalPages?: undefined;
+    }>;
+    requiredAuth: "wordpressToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        wordpressToken: string;
+    }, {
+        error: string;
+        details?: undefined;
+        subscriptions?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: any;
+        subscriptions?: undefined;
+        message?: undefined;
+    } | {
+        subscriptions: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        subscriptions?: undefined;
+    }>;
+    requiredAuth: "wordpressToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        wordpressToken: string;
+        visibility?: "all" | "visible" | "hidden" | undefined;
+        activity?: "all" | "active" | "inactive" | undefined;
+    }, {
+        error: string;
+        details?: undefined;
+        sites?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: any;
+        sites?: undefined;
+        message?: undefined;
+    } | {
+        sites: any;
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        sites?: undefined;
+    }>;
+    requiredAuth: "wordpressToken";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        postId: number;
+        wordpressToken: string;
+        siteId: number;
+        title?: string | undefined;
+        content?: string | undefined;
+        categoryIds?: number[] | undefined;
+        excerpt?: string | undefined;
+        tagIds?: number[] | undefined;
+        featuredMediaId?: number | undefined;
+        commentStatus?: "open" | "closed" | undefined;
+    }, {
+        error: string;
+        details?: undefined;
+        post?: undefined;
+        updatedFields?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        details: any;
+        post?: undefined;
+        updatedFields?: undefined;
+        message?: undefined;
+    } | {
+        post: {
+            id: any;
+            status: any;
+            title: any;
+            content: any;
+            excerpt: any;
+            slug: any;
+            link: any;
+            modified: any;
+            authorId: any;
+            categoryIds: number[] | undefined;
+            tagIds: number[] | undefined;
+            featuredMediaId: any;
+            commentStatus: any;
+        };
+        updatedFields: string[];
+        error?: undefined;
+        details?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        post?: undefined;
+        updatedFields?: undefined;
+    }>;
+    requiredAuth: "wordpressToken";
+    scope: "write";
+})[];
+//# sourceMappingURL=index.d.ts.map

package/dist/toolkits/wordpress/tools/index.js

@@ -0,0 +1,85 @@
+// @ts-nocheck
+import { wordpressCreateDraftPost } from './create-draft-post.js';
+import { wordpressDeleteDraftPost } from './delete-draft-post.js';
+import { wordpressGetPost } from './get-post.js';
+import { wordpressGetSiteOverview } from './get-site-overview.js';
+import { wordpressListBloggingPrompts } from './list-blogging-prompts.js';
+import { wordpressListCmsResources } from './list-cms-resources.js';
+import { wordpressListContent } from './list-content.js';
+import { wordpressListReaderSubscriptions } from './list-reader-subscriptions.js';
+import { wordpressListSites } from './list-sites.js';
+import { wordpressUpdateDraftPost } from './update-draft-post.js';
+export { wordpressCreateDraftPost, wordpressDeleteDraftPost, wordpressGetPost, wordpressGetSiteOverview, wordpressListBloggingPrompts, wordpressListCmsResources, wordpressListContent, wordpressListReaderSubscriptions, wordpressListSites, wordpressUpdateDraftPost, };
+export const wordpressTools = [
+    {
+        name: 'wordpressCreateDraftPost',
+        description: 'Create a non-public draft post on an authorized site. This tool never publishes content; use the returned post ID for review, update, and cleanup.',
+        tool: wordpressCreateDraftPost,
+        requiredAuth: 'wordpressToken',
+        scope: 'write',
+    },
+    {
+        name: 'wordpressDeleteDraftPost',
+        description: 'Permanently delete an existing draft post after verifying it is still a draft. The tool refuses to delete published, scheduled, pending, or private posts.',
+        tool: wordpressDeleteDraftPost,
+        requiredAuth: 'wordpressToken',
+        scope: 'delete',
+    },
+    {
+        name: 'wordpressGetPost',
+        description: 'Get one post by ID in editable context, including raw content and its current status.',
+        tool: wordpressGetPost,
+        requiredAuth: 'wordpressToken',
+        scope: 'read',
+    },
+    {
+        name: 'wordpressGetSiteOverview',
+        description: 'Get concise identity, plan, capabilities, editable settings, and traffic summary for one authorized site.',
+        tool: wordpressGetSiteOverview,
+        requiredAuth: 'wordpressToken',
+        scope: 'read',
+    },
+    {
+        name: 'wordpressListBloggingPrompts',
+        description: 'List WordPress.com writing prompts for a site, optionally filtered by date or text, with agent-controlled pagination.',
+        tool: wordpressListBloggingPrompts,
+        requiredAuth: 'wordpressToken',
+        scope: 'read',
+    },
+    {
+        name: 'wordpressListCmsResources',
+        description: 'List categories, tags, comments, media, or users for an authorized site through one consistent paginated read tool.',
+        tool: wordpressListCmsResources,
+        requiredAuth: 'wordpressToken',
+        scope: 'read',
+    },
+    {
+        name: 'wordpressListContent',
+        description: 'List and search editable posts or pages on an authorized site, including drafts, with compact raw and rendered content fields and agent-controlled pagination.',
+        tool: wordpressListContent,
+        requiredAuth: 'wordpressToken',
+        scope: 'read',
+    },
+    {
+        name: 'wordpressListReaderSubscriptions',
+        description: 'List feeds and sites followed by the connected WordPress.com account without changing subscriptions.',
+        tool: wordpressListReaderSubscriptions,
+        requiredAuth: 'wordpressToken',
+        scope: 'read',
+    },
+    {
+        name: 'wordpressListSites',
+        description: 'List every WordPress.com or Jetpack-connected site authorized by the global OAuth account, returning stable numeric site IDs and concise capability and plan summaries for use with other tools.',
+        tool: wordpressListSites,
+        requiredAuth: 'wordpressToken',
+        scope: 'read',
+    },
+    {
+        name: 'wordpressUpdateDraftPost',
+        description: 'Update title, body, excerpt, taxonomy, featured media, or comment policy for an existing draft. Provide at least one field to update. The tool refuses to modify a post whose current status is not draft.',
+        tool: wordpressUpdateDraftPost,
+        requiredAuth: 'wordpressToken',
+        scope: 'write',
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/toolkits/wordpress/tools/list-blogging-prompts.d.ts

@@ -0,0 +1,48 @@
+export declare const wordpressListBloggingPrompts: import("ai").Tool<{
+    wordpressToken: string;
+    siteId: number;
+    pageSize?: number | undefined;
+    before?: string | undefined;
+    order?: "asc" | "desc" | undefined;
+    search?: string | undefined;
+    after?: string | undefined;
+    cursor?: string | undefined;
+    year?: number | undefined;
+}, {
+    error: string;
+    details?: undefined;
+    items?: undefined;
+    hasMore?: undefined;
+    nextCursor?: undefined;
+    total?: undefined;
+    totalPages?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    details: any;
+    items?: undefined;
+    hasMore?: undefined;
+    nextCursor?: undefined;
+    total?: undefined;
+    totalPages?: undefined;
+    message?: undefined;
+} | {
+    items: any;
+    hasMore: any;
+    nextCursor: any;
+    total: any;
+    totalPages: any;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    items?: undefined;
+    hasMore?: undefined;
+    nextCursor?: undefined;
+    total?: undefined;
+    totalPages?: undefined;
+}>;
+//# sourceMappingURL=list-blogging-prompts.d.ts.map

package/dist/toolkits/wordpress/tools/list-blogging-prompts.js

@@ -0,0 +1,55 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { wpFetch } from './utils.js';
+export const wordpressListBloggingPrompts = tool({
+    description: 'List WordPress.com writing prompts for a site, optionally filtered by date or text, with agent-controlled pagination.',
+    inputSchema: z.object({
+        wordpressToken: z.string().describe('WordPress.com OAuth access token.'),
+        siteId: z.number().describe('Numeric site ID returned by WORDPRESS_COM_LIST_SITES.'),
+        search: z.string().optional().describe('Limit prompts to text matching this query.'),
+        before: z.string().optional().describe('Return prompts before this ISO 8601 date.'),
+        after: z.string().optional().describe('Return prompts after this ISO 8601 date.'),
+        order: z.enum(['asc', 'desc']).optional().describe('Sort direction by prompt date.'),
+        year: z.number().min(2000).max(2100).optional().describe('Return the prompt calendar for this year.'),
+        cursor: z.string().optional().describe('Opaque continuation cursor returned by a previous call.'),
+        pageSize: z.number().min(1).max(100).optional().describe('Maximum prompts in this page.'),
+    }),
+    execute: async ({ wordpressToken, siteId, search, before, after, order, year, cursor, pageSize }) => {
+        if (!wordpressToken)
+            return { error: 'WordPress token is required. Connect WordPress.com first.' };
+        try {
+            const res = await wpFetch(`/wpcom/v2/blogging-prompts`, {
+                wordpressToken,
+                method: 'GET',
+                query: {
+                    site_id: siteId,
+                    search,
+                    before,
+                    after,
+                    order,
+                    year,
+                    cursor,
+                    per_page: pageSize,
+                    number: pageSize,
+                },
+            });
+            if (!res.ok)
+                return { error: 'Failed to list blogging prompts', details: res.data };
+            const data = res.data;
+            // Normalize to expected shape
+            const items = data.prompts ?? data.items ?? data.blogging_prompts ?? [];
+            return {
+                items,
+                hasMore: data.has_more ?? data.hasMore ?? false,
+                nextCursor: data.next_cursor ?? data.nextCursor ?? null,
+                total: data.total ?? data.found ?? undefined,
+                totalPages: data.total_pages ?? data.totalPages ?? undefined,
+            };
+        }
+        catch (e) {
+            return { error: 'Error listing blogging prompts', message: e instanceof Error ? e.message : 'Unknown error' };
+        }
+    },
+});
+//# sourceMappingURL=list-blogging-prompts.js.map