@rnsk/toolkits 0.0.6 → 0.0.8

package/dist/toolkits/docker-hub/tools/get-webhook.js

@@ -0,0 +1,26 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { dockerHubRequest, normalizeLegacyWebhook } from './utils.js';
+export const getWebhook = tool({
+    description: 'Retrieve details of a specific Docker Hub repository webhook by ID.',
+    inputSchema: z.object({
+        dockerHubCredentials: z.string().describe('Docker Hub credentials JSON with username and personalAccessToken'),
+        namespace: z.string().describe('Docker Hub namespace'),
+        repository: z.string().describe('Repository name'),
+        webhook_id: z.number().int().positive().describe('Numeric webhook ID'),
+    }),
+    execute: async ({ dockerHubCredentials, namespace, repository, webhook_id }) => {
+        try {
+            const result = await dockerHubRequest(dockerHubCredentials, `/v2/repositories/${encodeURIComponent(namespace)}/${encodeURIComponent(repository)}/webhooks/${webhook_id}/`);
+            if (!result.ok) {
+                return { error: 'Failed to get webhook', details: result.data, statusCode: result.status };
+            }
+            return normalizeLegacyWebhook(result.data ?? {});
+        }
+        catch (error) {
+            return { error: 'Error getting webhook', message: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    },
+});
+//# sourceMappingURL=get-webhook.js.map

package/dist/toolkits/docker-hub/tools/index.d.ts

@@ -0,0 +1,437 @@
+import { addOrgMember } from './add-org-member.js';
+import { createOrganization } from './create-organization.js';
+import { createRepository } from './create-repository.js';
+import { deleteImage } from './delete-image.js';
+import { deleteOrganization } from './delete-organization.js';
+import { deleteRepository } from './delete-repository.js';
+import { deleteTag } from './delete-tag.js';
+import { deleteTeam } from './delete-team.js';
+import { getImage } from './get-image.js';
+import { getRepository } from './get-repository.js';
+import { getTag } from './get-tag.js';
+import { getTeam } from './get-team.js';
+import { listOrgAccessTokens } from './list-org-access-tokens.js';
+import { listOrganizations } from './list-organizations.js';
+import { listOrgMembers } from './list-org-members.js';
+import { listRepositories } from './list-repositories.js';
+import { listTeamMembers } from './list-team-members.js';
+import { listTeams } from './list-teams.js';
+import { removeOrgMember } from './remove-org-member.js';
+import { removeTeamMember } from './remove-team-member.js';
+export { addOrgMember, createOrganization, createRepository, deleteImage, deleteOrganization, deleteRepository, deleteTag, deleteTeam, getImage, getRepository, getTag, getTeam, listOrgAccessTokens, listOrganizations, listOrgMembers, listRepositories, listTeamMembers, listTeams, removeOrgMember, removeTeamMember, };
+export declare const dockerHubTools: ({
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        org: string;
+        dockerHubCredentials: string;
+        invitee: string;
+        team?: string | undefined;
+        role?: "owner" | "member" | "editor" | undefined;
+    }, {
+        error: string;
+        details: any;
+        statusCode: number;
+        success?: undefined;
+        invitees?: undefined;
+        message?: undefined;
+    } | {
+        success: boolean;
+        invitees: any;
+        message: string;
+        error?: undefined;
+        details?: undefined;
+        statusCode?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        statusCode?: undefined;
+        success?: undefined;
+        invitees?: undefined;
+    }>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        dockerHubCredentials: string;
+        orgname: string;
+        company?: string | undefined;
+    }, any>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        name: string;
+        namespace: string;
+        dockerHubCredentials: string;
+        description?: string | undefined;
+        is_private?: boolean | undefined;
+        full_description?: string | undefined;
+    }, any>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        namespace: string;
+        dockerHubCredentials: string;
+        manifests: {
+            repository: string;
+            digest: string;
+        }[];
+        dry_run?: boolean | undefined;
+        ignore_warnings?: string[] | undefined;
+    }, any>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "delete";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        organization: string;
+        dockerHubCredentials: string;
+    }, {
+        status_code: number;
+        message: string;
+        error?: undefined;
+        details?: undefined;
+        statusCode?: undefined;
+    } | {
+        error: string;
+        details: any;
+        statusCode: number;
+        status_code?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        status_code?: undefined;
+        details?: undefined;
+        statusCode?: undefined;
+    }>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "delete";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        repository: string;
+        namespace: string;
+        dockerHubCredentials: string;
+    }, {
+        message: string;
+        error?: undefined;
+        details?: undefined;
+        statusCode?: undefined;
+    } | {
+        error: string;
+        details: any;
+        statusCode: number;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        statusCode?: undefined;
+    }>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "delete";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        repository: string;
+        namespace: string;
+        dockerHubCredentials: string;
+        tag: string;
+    }, {
+        success: boolean;
+        message: string;
+        error?: undefined;
+        details?: undefined;
+        statusCode?: undefined;
+    } | {
+        error: string;
+        details: any;
+        statusCode: number;
+        success?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        success?: undefined;
+        details?: undefined;
+        statusCode?: undefined;
+    }>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "delete";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        dockerHubCredentials: string;
+        org_name: string;
+        team_name: string;
+    }, {
+        success: boolean;
+        message: string;
+        error?: undefined;
+        details?: undefined;
+        statusCode?: undefined;
+    } | {
+        error: string;
+        details: any;
+        statusCode: number;
+        success?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        success?: undefined;
+        details?: undefined;
+        statusCode?: undefined;
+    }>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "delete";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        repository: string;
+        namespace: string;
+        dockerHubCredentials: string;
+        digest: string;
+    }, {
+        error: string;
+        details: any;
+        statusCode: number;
+        digest?: undefined;
+        architecture?: undefined;
+        os?: undefined;
+        size?: undefined;
+        status?: undefined;
+        variant?: undefined;
+        os_version?: undefined;
+        last_pulled?: undefined;
+        last_pushed?: undefined;
+        tag_name?: undefined;
+        namespace?: undefined;
+        repository?: undefined;
+        message?: undefined;
+    } | {
+        digest: any;
+        architecture: any;
+        os: any;
+        size: any;
+        status: any;
+        variant: any;
+        os_version: any;
+        last_pulled: any;
+        last_pushed: any;
+        tag_name: any;
+        error?: undefined;
+        details?: undefined;
+        statusCode?: undefined;
+        namespace?: undefined;
+        repository?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        digest: string;
+        namespace: string;
+        repository: string;
+        details?: undefined;
+        statusCode?: undefined;
+        architecture?: undefined;
+        os?: undefined;
+        size?: undefined;
+        status?: undefined;
+        variant?: undefined;
+        os_version?: undefined;
+        last_pulled?: undefined;
+        last_pushed?: undefined;
+        tag_name?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        statusCode?: undefined;
+        digest?: undefined;
+        architecture?: undefined;
+        os?: undefined;
+        size?: undefined;
+        status?: undefined;
+        variant?: undefined;
+        os_version?: undefined;
+        last_pulled?: undefined;
+        last_pushed?: undefined;
+        tag_name?: undefined;
+        namespace?: undefined;
+        repository?: undefined;
+    }>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        repository: string;
+        namespace: string;
+        dockerHubCredentials: string;
+    }, any>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        repository: string;
+        namespace: string;
+        dockerHubCredentials: string;
+        tag: string;
+    }, any>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        dockerHubCredentials: string;
+        org_name: string;
+        team_name: string;
+    }, any>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        name: string;
+        dockerHubCredentials: string;
+        page?: number | undefined;
+        page_size?: number | undefined;
+    }, any>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        dockerHubCredentials: string;
+        page?: number | undefined;
+        page_size?: number | undefined;
+    }, any>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        org: string;
+        dockerHubCredentials: string;
+        page?: number | undefined;
+        page_size?: number | undefined;
+    }, any>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        namespace: string;
+        dockerHubCredentials: string;
+        page?: number | undefined;
+        page_size?: number | undefined;
+        ordering?: string | undefined;
+        media_types?: string | undefined;
+        content_types?: string | undefined;
+    }, any>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        dockerHubCredentials: string;
+        org_name: string;
+        team_name: string;
+        page?: number | undefined;
+        search?: string | undefined;
+        page_size?: number | undefined;
+    }, any>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        organization: string;
+        dockerHubCredentials: string;
+        page?: number | undefined;
+        page_size?: number | undefined;
+    }, any>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        username: string;
+        dockerHubCredentials: string;
+        org_name: string;
+    }, {
+        message: string;
+        error?: undefined;
+        details?: undefined;
+        statusCode?: undefined;
+    } | {
+        error: string;
+        details: any;
+        statusCode: number;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        details?: undefined;
+        statusCode?: undefined;
+    }>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "delete";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        username: string;
+        team_slug: string;
+        dockerHubCredentials: string;
+        org_name: string;
+    }, {
+        success: boolean;
+        message: string;
+        error?: undefined;
+        details?: undefined;
+        statusCode?: undefined;
+    } | {
+        error: string;
+        details: any;
+        statusCode: number;
+        success?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        success?: undefined;
+        details?: undefined;
+        statusCode?: undefined;
+    }>;
+    requiredAuth: "dockerHubCredentials";
+    scope: "delete";
+})[];
+//# sourceMappingURL=index.d.ts.map

package/dist/toolkits/docker-hub/tools/index.js

@@ -0,0 +1,165 @@
+// @ts-nocheck
+import { addOrgMember } from './add-org-member.js';
+import { createOrganization } from './create-organization.js';
+import { createRepository } from './create-repository.js';
+import { deleteImage } from './delete-image.js';
+import { deleteOrganization } from './delete-organization.js';
+import { deleteRepository } from './delete-repository.js';
+import { deleteTag } from './delete-tag.js';
+import { deleteTeam } from './delete-team.js';
+import { getImage } from './get-image.js';
+import { getRepository } from './get-repository.js';
+import { getTag } from './get-tag.js';
+import { getTeam } from './get-team.js';
+import { listOrgAccessTokens } from './list-org-access-tokens.js';
+import { listOrganizations } from './list-organizations.js';
+import { listOrgMembers } from './list-org-members.js';
+import { listRepositories } from './list-repositories.js';
+import { listTeamMembers } from './list-team-members.js';
+import { listTeams } from './list-teams.js';
+import { removeOrgMember } from './remove-org-member.js';
+import { removeTeamMember } from './remove-team-member.js';
+export { addOrgMember, createOrganization, createRepository, deleteImage, deleteOrganization, deleteRepository, deleteTag, deleteTeam, getImage, getRepository, getTag, getTeam, listOrgAccessTokens, listOrganizations, listOrgMembers, listRepositories, listTeamMembers, listTeams, removeOrgMember, removeTeamMember, };
+export const dockerHubTools = [
+    {
+        name: 'dockerHubAddOrgMember',
+        description: 'Invite a user to join a Docker Hub organization by Docker ID or email.',
+        tool: addOrgMember,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'write',
+    },
+    {
+        name: 'dockerHubCreateOrganization',
+        description: 'Create a new Docker Hub organization.',
+        tool: createOrganization,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'write',
+    },
+    {
+        name: 'dockerHubCreateRepository',
+        description: 'Create a new Docker Hub repository under the specified namespace.',
+        tool: createRepository,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'write',
+    },
+    {
+        name: 'dockerHubDeleteImage',
+        description: 'Delete one or more images from a Docker Hub namespace using the bulk delete API.',
+        tool: deleteImage,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'delete',
+    },
+    {
+        name: 'dockerHubDeleteOrganization',
+        description: 'Permanently delete a Docker Hub organization. Treats 404 as success (idempotent).',
+        tool: deleteOrganization,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'delete',
+    },
+    {
+        name: 'dockerHubDeleteRepository',
+        description: 'Permanently delete a Docker Hub repository and all its images/tags.',
+        tool: deleteRepository,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'delete',
+    },
+    {
+        name: 'dockerHubDeleteTag',
+        description: 'Permanently delete a specific tag from a Docker Hub repository.',
+        tool: deleteTag,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'delete',
+    },
+    {
+        name: 'dockerHubDeleteTeam',
+        description: 'Permanently delete a team (group) from a Docker Hub organization.',
+        tool: deleteTeam,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'delete',
+    },
+    {
+        name: 'dockerHubGetImage',
+        description: 'Retrieve details about a platform-specific image variant by SHA256 digest.',
+        tool: getImage,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'read',
+    },
+    {
+        name: 'dockerHubGetRepository',
+        description: 'Retrieve detailed information about a specific Docker Hub repository.',
+        tool: getRepository,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'read',
+    },
+    {
+        name: 'dockerHubGetTag',
+        description: 'Retrieve details of a specific Docker Hub repository tag.',
+        tool: getTag,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'read',
+    },
+    {
+        name: 'dockerHubGetTeam',
+        description: 'Retrieve details of a specific team (group) within a Docker Hub organization.',
+        tool: getTeam,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'read',
+    },
+    {
+        name: 'dockerHubListOrgAccessTokens',
+        description: 'List organization access tokens for a Docker Hub organization.',
+        tool: listOrgAccessTokens,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'read',
+    },
+    {
+        name: 'dockerHubListOrganizations',
+        description: 'List Docker Hub organizations the authenticated user belongs to.',
+        tool: listOrganizations,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'read',
+    },
+    {
+        name: 'dockerHubListOrgMembers',
+        description: 'List members of a Docker Hub organization with roles and team assignments.',
+        tool: listOrgMembers,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'read',
+    },
+    {
+        name: 'dockerHubListRepositories',
+        description: 'List repositories under a Docker Hub namespace with optional filtering and pagination.',
+        tool: listRepositories,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'read',
+    },
+    {
+        name: 'dockerHubListTeamMembers',
+        description: 'List members of a Docker Hub organization team (group).',
+        tool: listTeamMembers,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'read',
+    },
+    {
+        name: 'dockerHubListTeams',
+        description: 'List all teams (groups) within a Docker Hub organization.',
+        tool: listTeams,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'read',
+    },
+    {
+        name: 'dockerHubRemoveOrgMember',
+        description: 'Remove a member from a Docker Hub organization.',
+        tool: removeOrgMember,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'delete',
+    },
+    {
+        name: 'dockerHubRemoveTeamMember',
+        description: 'Remove a user from a Docker Hub organization team (group).',
+        tool: removeTeamMember,
+        requiredAuth: 'dockerHubCredentials',
+        scope: 'delete',
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/toolkits/docker-hub/tools/list-org-access-tokens.d.ts

@@ -0,0 +1,7 @@
+export declare const listOrgAccessTokens: import("ai").Tool<{
+    name: string;
+    dockerHubCredentials: string;
+    page?: number | undefined;
+    page_size?: number | undefined;
+}, any>;
+//# sourceMappingURL=list-org-access-tokens.d.ts.map

package/dist/toolkits/docker-hub/tools/list-org-access-tokens.js

@@ -0,0 +1,26 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { dockerHubRequest, buildQueryString } from './utils.js';
+export const listOrgAccessTokens = tool({
+    description: 'List organization access tokens for a Docker Hub organization.',
+    inputSchema: z.object({
+        dockerHubCredentials: z.string().describe('Docker Hub credentials JSON with username and personalAccessToken'),
+        name: z.string().describe('Organization name'),
+        page: z.number().int().min(1).optional().describe('Page number (1-indexed)'),
+        page_size: z.number().int().min(1).max(100).optional().describe('Results per page'),
+    }),
+    execute: async ({ dockerHubCredentials, name, page, page_size }) => {
+        try {
+            const result = await dockerHubRequest(dockerHubCredentials, `/v2/orgs/${encodeURIComponent(name)}/access-tokens${buildQueryString({ page: page ?? 1, page_size: page_size ?? 10 })}`);
+            if (!result.ok) {
+                return { error: 'Failed to list organization access tokens', details: result.data, statusCode: result.status };
+            }
+            return result.data;
+        }
+        catch (error) {
+            return { error: 'Error listing organization access tokens', message: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    },
+});
+//# sourceMappingURL=list-org-access-tokens.js.map

package/dist/toolkits/docker-hub/tools/list-org-members.d.ts

@@ -0,0 +1,7 @@
+export declare const listOrgMembers: import("ai").Tool<{
+    org: string;
+    dockerHubCredentials: string;
+    page?: number | undefined;
+    page_size?: number | undefined;
+}, any>;
+//# sourceMappingURL=list-org-members.d.ts.map

package/dist/toolkits/docker-hub/tools/list-org-members.js

@@ -0,0 +1,26 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { dockerHubRequest, buildQueryString } from './utils.js';
+export const listOrgMembers = tool({
+    description: 'List members of a Docker Hub organization with roles and team assignments.',
+    inputSchema: z.object({
+        dockerHubCredentials: z.string().describe('Docker Hub credentials JSON with username and personalAccessToken'),
+        org: z.string().describe('Organization name'),
+        page: z.number().int().min(1).optional().describe('Page number (1-indexed)'),
+        page_size: z.number().int().min(1).max(100).optional().describe('Results per page'),
+    }),
+    execute: async ({ dockerHubCredentials, org, page, page_size }) => {
+        try {
+            const result = await dockerHubRequest(dockerHubCredentials, `/v2/orgs/${encodeURIComponent(org)}/members${buildQueryString({ page: page ?? 1, page_size: page_size ?? 25 })}`);
+            if (!result.ok) {
+                return { error: 'Failed to list organization members', details: result.data, statusCode: result.status };
+            }
+            return result.data;
+        }
+        catch (error) {
+            return { error: 'Error listing organization members', message: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    },
+});
+//# sourceMappingURL=list-org-members.js.map