@rnsk/toolkits 0.0.7 → 0.0.9

package/dist/toolkits/google-analytics/tools/audiences.js

@@ -0,0 +1,190 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { ADMIN_V1ALPHA, ADMIN_V1BETA, DATA_V1ALPHA, gaGet, gaList, gaPost, googleAnalyticsTokenField, normalizeProperty, paginationSchema, } from './client.js';
+const audienceDimension = z.object({
+    dimensionName: z.string().describe("Dimension API name, e.g. 'deviceId', 'userId', 'city', 'country'"),
+});
+const propertyField = z.string().describe("GA4 property 'properties/{id}' (bare numeric ID accepted)");
+export const getAudience = tool({
+    description: 'Gets a single audience configuration (membership criteria, filter clauses) by property + audience ID.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        propertyId: z.string().describe("Property ID ('123456789' or 'properties/123456789')"),
+        audienceId: z.string().describe("Numeric audience ID, e.g. '11228260226'"),
+    }),
+    execute: async ({ googleAnalyticsToken, propertyId, audienceId }) => {
+        try {
+            return await gaGet(googleAnalyticsToken, ADMIN_V1BETA, `${normalizeProperty(propertyId)}/audiences/${audienceId}`);
+        }
+        catch (error) {
+            return { error: 'Error getting audience', message: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    },
+});
+export const listAudiences = tool({
+    description: 'Lists audience configurations on a property. Audiences created before 2020 may not be supported.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        parent: propertyField,
+        ...paginationSchema,
+    }),
+    execute: async ({ googleAnalyticsToken, parent, pageSize, pageToken }) => gaList(googleAnalyticsToken, ADMIN_V1BETA, normalizeProperty(parent), 'audiences', { pageSize, pageToken }, 'list audiences'),
+});
+export const createAudienceExport = tool({
+    description: 'Exports a snapshot of users in an audience (async long-running operation). Poll getAudienceExport, then queryAudienceExport for rows.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        parent: propertyField,
+        audience: z.string().describe("Audience 'properties/{id}/audiences/{audienceId}'"),
+        dimensions: z.array(audienceDimension).optional().describe('Dimensions to include in the export rows'),
+    }),
+    execute: async ({ googleAnalyticsToken, parent, audience, dimensions }) => {
+        const body = { audience };
+        if (dimensions)
+            body.dimensions = dimensions;
+        return gaPost(googleAnalyticsToken, ADMIN_V1ALPHA, `${normalizeProperty(parent)}/audienceExports`, body, undefined, 'create audience export');
+    },
+});
+export const getAudienceExport = tool({
+    description: 'Gets audience-export metadata/state after creation.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        name: z.string().describe("Export 'properties/{id}/audienceExports/{exportId}'"),
+    }),
+    execute: async ({ googleAnalyticsToken, name }) => {
+        try {
+            return await gaGet(googleAnalyticsToken, ADMIN_V1ALPHA, name);
+        }
+        catch (error) {
+            return { error: 'Error getting audience export', message: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    },
+});
+export const listAudienceExports = tool({
+    description: 'Lists audience exports for a property to find and reuse existing exports.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        parent: propertyField,
+        ...paginationSchema,
+    }),
+    execute: async ({ googleAnalyticsToken, parent, pageSize, pageToken }) => gaList(googleAnalyticsToken, ADMIN_V1ALPHA, normalizeProperty(parent), 'audienceExports', { pageSize, pageToken }, 'list audience exports'),
+});
+export const queryAudienceExport = tool({
+    description: 'Retrieves rows from an audience export. Use after the export operation completes.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        name: z.string().describe("Export 'properties/{id}/audienceExports/{exportId}'"),
+        limit: z.number().min(1).optional(),
+        offset: z.number().min(0).optional(),
+    }),
+    execute: async ({ googleAnalyticsToken, name, limit, offset }) => {
+        const body = {};
+        if (limit !== undefined)
+            body.limit = limit;
+        if (offset !== undefined)
+            body.offset = offset;
+        return gaPost(googleAnalyticsToken, DATA_V1ALPHA, `${name}:query`, body, undefined, 'query audience export');
+    },
+});
+export const createAudienceList = tool({
+    description: 'Creates an audience list snapshot (async operation). At least one dimension is required. Poll getAudienceList, then queryAudienceList.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        parent: propertyField,
+        audience: z.string().describe("Audience 'properties/{id}/audiences/{audienceId}'"),
+        dimensions: z.array(audienceDimension).min(1).describe('At least one dimension is required'),
+        webhookNotification: z.record(z.any()).optional(),
+    }),
+    execute: async ({ googleAnalyticsToken, parent, audience, dimensions, webhookNotification }) => {
+        const body = { audience, dimensions };
+        if (webhookNotification)
+            body.webhookNotification = webhookNotification;
+        return gaPost(googleAnalyticsToken, ADMIN_V1ALPHA, `${normalizeProperty(parent)}/audienceLists`, body, undefined, 'create audience list');
+    },
+});
+export const getAudienceList = tool({
+    description: 'Gets audience-list metadata/state after creation.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        name: z.string().describe("Audience list 'properties/{id}/audienceLists/{listId}'"),
+    }),
+    execute: async ({ googleAnalyticsToken, name }) => {
+        try {
+            return await gaGet(googleAnalyticsToken, ADMIN_V1ALPHA, name);
+        }
+        catch (error) {
+            return { error: 'Error getting audience list', message: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    },
+});
+export const listAudienceLists = tool({
+    description: 'Lists audience lists for a property to find and reuse existing lists.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        parent: propertyField,
+        ...paginationSchema,
+    }),
+    execute: async ({ googleAnalyticsToken, parent, pageSize, pageToken }) => gaList(googleAnalyticsToken, ADMIN_V1ALPHA, normalizeProperty(parent), 'audienceLists', { pageSize, pageToken }, 'list audience lists'),
+});
+export const queryAudienceList = tool({
+    description: 'Retrieves rows from an audience list. Use after the list operation completes.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        name: z.string().describe("Audience list 'properties/{id}/audienceLists/{listId}'"),
+        limit: z.number().min(1).optional(),
+        offset: z.number().min(0).optional(),
+    }),
+    execute: async ({ googleAnalyticsToken, name, limit, offset }) => {
+        const body = {};
+        if (limit !== undefined)
+            body.limit = limit;
+        if (offset !== undefined)
+            body.offset = offset;
+        return gaPost(googleAnalyticsToken, DATA_V1ALPHA, `${name}:query`, body, undefined, 'query audience list');
+    },
+});
+export const createRecurringAudienceList = tool({
+    description: 'Creates a recurring audience list that auto-generates fresh lists daily. Reduces quota-token consumption vs repeated one-off lists.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        parent: propertyField,
+        audience: z.string().describe("Audience 'properties/{id}/audiences/{audienceId}'"),
+        dimensions: z.array(audienceDimension).min(1).describe('At least one dimension is required'),
+        activeDaysRemaining: z.number().min(1).optional().describe('Days the recurring list stays active'),
+        webhookNotification: z.record(z.any()).optional(),
+    }),
+    execute: async ({ googleAnalyticsToken, parent, audience, dimensions, activeDaysRemaining, webhookNotification }) => {
+        const body = { audience, dimensions };
+        if (activeDaysRemaining !== undefined)
+            body.activeDaysRemaining = activeDaysRemaining;
+        if (webhookNotification)
+            body.webhookNotification = webhookNotification;
+        return gaPost(googleAnalyticsToken, ADMIN_V1ALPHA, `${normalizeProperty(parent)}/recurringAudienceLists`, body, undefined, 'create recurring audience list');
+    },
+});
+export const getRecurringAudienceList = tool({
+    description: 'Gets a recurring audience list, including the resource name of the most recent generated list.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        name: z.string().describe("Recurring list 'properties/{id}/recurringAudienceLists/{listId}'"),
+    }),
+    execute: async ({ googleAnalyticsToken, name }) => {
+        try {
+            return await gaGet(googleAnalyticsToken, ADMIN_V1ALPHA, name);
+        }
+        catch (error) {
+            return { error: 'Error getting recurring audience list', message: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    },
+});
+export const listRecurringAudienceLists = tool({
+    description: 'Lists recurring audience lists for a property.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        parent: propertyField,
+        ...paginationSchema,
+    }),
+    execute: async ({ googleAnalyticsToken, parent, pageSize, pageToken }) => gaList(googleAnalyticsToken, ADMIN_V1ALPHA, normalizeProperty(parent), 'recurringAudienceLists', { pageSize, pageToken }, 'list recurring audience lists'),
+});
+//# sourceMappingURL=audiences.js.map

package/dist/toolkits/google-analytics/tools/client.d.ts

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+export declare const ADMIN_V1BETA = "https://analyticsadmin.googleapis.com/v1beta";
+export declare const ADMIN_V1ALPHA = "https://analyticsadmin.googleapis.com/v1alpha";
+export declare const DATA_V1BETA = "https://analyticsdata.googleapis.com/v1beta";
+export declare const DATA_V1ALPHA = "https://analyticsdata.googleapis.com/v1alpha";
+export declare const googleAnalyticsTokenField: z.ZodString;
+export declare function buildQuery(params: Record<string, string | number | boolean | undefined>): string;
+export declare function gaRequest(googleAnalyticsToken: string, base: string, path: string, options?: {
+    method?: string;
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+}): Promise<{
+    ok: false;
+    error: any;
+    data?: undefined;
+} | {
+    ok: true;
+    data: any;
+    error?: undefined;
+}>;
+export declare function gaGet(token: string, base: string, name: string, query?: Record<string, string | number | boolean | undefined>): Promise<any>;
+export declare function gaPost(token: string, base: string, path: string, body?: unknown, query?: Record<string, string | number | boolean | undefined>, action?: string): Promise<any>;
+export declare function gaList(token: string, base: string, parent: string, resource: string, options?: {
+    pageSize?: number;
+    pageToken?: string;
+    extra?: Record<string, string | number | boolean | undefined>;
+}, action?: string): Promise<any>;
+export declare function normalizeProperty(property: string): string;
+export declare const paginationSchema: {
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    pageToken: z.ZodOptional<z.ZodString>;
+};
+export declare const namedMetric: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodUnknown, z.objectOutputType<{
+    name: z.ZodString;
+}, z.ZodUnknown, "strip">, z.objectInputType<{
+    name: z.ZodString;
+}, z.ZodUnknown, "strip">>;
+export declare const namedDimension: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodUnknown, z.objectOutputType<{
+    name: z.ZodString;
+}, z.ZodUnknown, "strip">, z.objectInputType<{
+    name: z.ZodString;
+}, z.ZodUnknown, "strip">>;
+//# sourceMappingURL=client.d.ts.map

package/dist/toolkits/google-analytics/tools/client.js

@@ -0,0 +1,74 @@
+// @ts-nocheck
+import { z } from 'zod';
+export const ADMIN_V1BETA = 'https://analyticsadmin.googleapis.com/v1beta';
+export const ADMIN_V1ALPHA = 'https://analyticsadmin.googleapis.com/v1alpha';
+export const DATA_V1BETA = 'https://analyticsdata.googleapis.com/v1beta';
+export const DATA_V1ALPHA = 'https://analyticsdata.googleapis.com/v1alpha';
+export const googleAnalyticsTokenField = z.string().describe('Google Analytics OAuth access token (Bearer)');
+export function buildQuery(params) {
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined)
+            search.set(key, String(value));
+    }
+    const qs = search.toString();
+    return qs ? `?${qs}` : '';
+}
+export async function gaRequest(googleAnalyticsToken, base, path, options) {
+    const url = `${base}${path.startsWith('/') ? path : `/${path}`}${buildQuery(options?.query ?? {})}`;
+    const headers = { Authorization: `Bearer ${googleAnalyticsToken}` };
+    if (options?.body !== undefined)
+        headers['Content-Type'] = 'application/json';
+    const response = await fetch(url, {
+        method: options?.method ?? 'GET',
+        headers,
+        body: options?.body !== undefined ? JSON.stringify(options.body) : undefined,
+    });
+    if (!response.ok) {
+        const details = await response.json().catch(() => ({}));
+        return { ok: false, error: details };
+    }
+    if (response.status === 204)
+        return { ok: true, data: { success: true } };
+    return { ok: true, data: await response.json().catch(() => ({})) };
+}
+export async function gaGet(token, base, name, query) {
+    const result = await gaRequest(token, base, `/${name}`, { query });
+    if (!result.ok)
+        return { error: 'Failed to fetch resource', details: result.error };
+    return result.data;
+}
+export async function gaPost(token, base, path, body, query, action = 'perform action') {
+    try {
+        const result = await gaRequest(token, base, `/${path}`, { method: 'POST', body: body ?? {}, query });
+        if (!result.ok)
+            return { error: `Failed to ${action}`, details: result.error };
+        return result.data;
+    }
+    catch (error) {
+        return { error: `Error while trying to ${action}`, message: error instanceof Error ? error.message : 'Unknown error' };
+    }
+}
+export async function gaList(token, base, parent, resource, options, action = 'list resources') {
+    try {
+        const result = await gaRequest(token, base, `/${parent}/${resource}`, {
+            query: { pageSize: options?.pageSize, pageToken: options?.pageToken, ...options?.extra },
+        });
+        if (!result.ok)
+            return { error: `Failed to ${action}`, details: result.error };
+        return result.data;
+    }
+    catch (error) {
+        return { error: `Error while trying to ${action}`, message: error instanceof Error ? error.message : 'Unknown error' };
+    }
+}
+export function normalizeProperty(property) {
+    return property.startsWith('properties/') ? property : `properties/${property}`;
+}
+export const paginationSchema = {
+    pageSize: z.number().min(1).max(200).optional().describe('Max resources per page (default 50, max 200)'),
+    pageToken: z.string().optional().describe('Page token from a previous list call'),
+};
+export const namedMetric = z.object({ name: z.string().describe("Metric API name, e.g. 'activeUsers'") }).catchall(z.unknown());
+export const namedDimension = z.object({ name: z.string().describe("Dimension API name, e.g. 'country'") }).catchall(z.unknown());
+//# sourceMappingURL=client.js.map

package/dist/toolkits/google-analytics/tools/custom-definitions.d.ts

@@ -0,0 +1,62 @@
+export declare const createCustomDimension: import("ai").Tool<{
+    scope: "EVENT" | "USER" | "ITEM";
+    parent: string;
+    googleAnalyticsToken: string;
+    displayName: string;
+    parameterName: string;
+    description?: string | undefined;
+    disallowAdsPersonalization?: boolean | undefined;
+}, any>;
+export declare const getCustomDimension: import("ai").Tool<{
+    name: string;
+    googleAnalyticsToken: string;
+}, any>;
+export declare const listCustomDimensions: import("ai").Tool<{
+    parent: string;
+    googleAnalyticsToken: string;
+    pageToken?: string | undefined;
+    pageSize?: number | undefined;
+}, any>;
+export declare const archiveCustomDimension: import("ai").Tool<{
+    name: string;
+    googleAnalyticsToken: string;
+}, any>;
+export declare const createCustomMetric: import("ai").Tool<{
+    scope: "EVENT";
+    parent: string;
+    googleAnalyticsToken: string;
+    displayName: string;
+    parameterName: string;
+    measurementUnit: "STANDARD" | "CURRENCY" | "FEET" | "METERS" | "KILOMETERS" | "MILES" | "MILLISECONDS" | "SECONDS" | "MINUTES" | "HOURS";
+    description?: string | undefined;
+    restrictedMetricType?: ("COST_DATA" | "REVENUE_DATA")[] | undefined;
+}, any>;
+export declare const listCustomMetrics: import("ai").Tool<{
+    parent: string;
+    googleAnalyticsToken: string;
+    pageToken?: string | undefined;
+    pageSize?: number | undefined;
+}, any>;
+export declare const listCalculatedMetrics: import("ai").Tool<{
+    parent: string;
+    googleAnalyticsToken: string;
+    pageToken?: string | undefined;
+    pageSize?: number | undefined;
+}, any>;
+export declare const createExpandedDataSet: import("ai").Tool<{
+    parent: string;
+    googleAnalyticsToken: string;
+    expandedDataSet: {
+        displayName: string;
+        dimensionNames: string[];
+        metricNames: string[];
+        description?: string | undefined;
+    };
+}, any>;
+export declare const listExpandedDataSets: import("ai").Tool<{
+    parent: string;
+    googleAnalyticsToken: string;
+    pageToken?: string | undefined;
+    pageSize?: number | undefined;
+}, any>;
+//# sourceMappingURL=custom-definitions.d.ts.map

package/dist/toolkits/google-analytics/tools/custom-definitions.js

@@ -0,0 +1,106 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { ADMIN_V1ALPHA, ADMIN_V1BETA, gaGet, gaList, gaPost, googleAnalyticsTokenField, normalizeProperty, paginationSchema, } from './client.js';
+const propertyField = z.string().describe("Property 'properties/{id}' (bare numeric ID accepted)");
+export const createCustomDimension = tool({
+    description: 'Creates a custom dimension (EVENT, USER, or ITEM scope) to track event parameters, user properties, or item parameters.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        parent: propertyField,
+        displayName: z.string().max(82).describe('UI display name (alphanumeric + space/underscore, starts with a letter)'),
+        parameterName: z.string().describe('Tagging parameter name (alphanumeric + underscore, starts with a letter)'),
+        scope: z.enum(['EVENT', 'USER', 'ITEM']).describe('Immutable scope'),
+        description: z.string().max(150).optional(),
+        disallowAdsPersonalization: z.boolean().optional().describe('Set NPA flag (user scope only)'),
+    }),
+    execute: async ({ googleAnalyticsToken, parent, ...dimension }) => gaPost(googleAnalyticsToken, ADMIN_V1BETA, `${normalizeProperty(parent)}/customDimensions`, dimension, undefined, 'create custom dimension'),
+});
+export const getCustomDimension = tool({
+    description: 'Gets a single custom dimension (display name, scope, parameter name) by resource name.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        name: z.string().describe("Dimension 'properties/{id}/customDimensions/{dimensionId}'"),
+    }),
+    execute: async ({ googleAnalyticsToken, name }) => {
+        try {
+            return await gaGet(googleAnalyticsToken, ADMIN_V1BETA, name);
+        }
+        catch (error) {
+            return { error: 'Error getting custom dimension', message: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    },
+});
+export const listCustomDimensions = tool({
+    description: 'Lists custom dimensions on a property.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        parent: propertyField,
+        ...paginationSchema,
+    }),
+    execute: async ({ googleAnalyticsToken, parent, pageSize, pageToken }) => gaList(googleAnalyticsToken, ADMIN_V1BETA, normalizeProperty(parent), 'customDimensions', { pageSize, pageToken }, 'list custom dimensions'),
+});
+export const archiveCustomDimension = tool({
+    description: 'Archives a custom dimension (removes from active use without deleting). Archived dimensions cannot be used in new reports.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        name: z.string().describe("Dimension 'properties/{id}/customDimensions/{dimensionId}'"),
+    }),
+    execute: async ({ googleAnalyticsToken, name }) => gaPost(googleAnalyticsToken, ADMIN_V1BETA, `${name}:archive`, {}, undefined, 'archive custom dimension'),
+});
+export const createCustomMetric = tool({
+    description: 'Creates an event-scoped custom metric for tracking numeric event parameters. CURRENCY units require restrictedMetricType.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        parent: propertyField,
+        displayName: z.string().max(82).describe('UI display name'),
+        parameterName: z.string().describe('Tagging event-parameter name (max 40 chars)'),
+        measurementUnit: z.enum(['STANDARD', 'CURRENCY', 'FEET', 'METERS', 'KILOMETERS', 'MILES', 'MILLISECONDS', 'SECONDS', 'MINUTES', 'HOURS']).describe('Value type'),
+        scope: z.enum(['EVENT']).describe('Immutable scope (currently EVENT only)'),
+        description: z.string().max(150).optional(),
+        restrictedMetricType: z.array(z.enum(['COST_DATA', 'REVENUE_DATA'])).optional().describe('Required for CURRENCY metrics; empty otherwise'),
+    }),
+    execute: async ({ googleAnalyticsToken, parent, ...metric }) => gaPost(googleAnalyticsToken, ADMIN_V1BETA, `${normalizeProperty(parent)}/customMetrics`, metric, undefined, 'create custom metric'),
+});
+export const listCustomMetrics = tool({
+    description: 'Lists custom metrics on a property.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        parent: propertyField,
+        ...paginationSchema,
+    }),
+    execute: async ({ googleAnalyticsToken, parent, pageSize, pageToken }) => gaList(googleAnalyticsToken, ADMIN_V1BETA, normalizeProperty(parent), 'customMetrics', { pageSize, pageToken }, 'list custom metrics'),
+});
+export const listCalculatedMetrics = tool({
+    description: 'Lists calculated metrics (formula-based metrics) on a property.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        parent: propertyField,
+        ...paginationSchema,
+    }),
+    execute: async ({ googleAnalyticsToken, parent, pageSize, pageToken }) => gaList(googleAnalyticsToken, ADMIN_V1BETA, normalizeProperty(parent), 'calculatedMetrics', { pageSize, pageToken }, 'list calculated metrics'),
+});
+export const createExpandedDataSet = tool({
+    description: 'Creates an expanded data set combining dimensions + metrics into a custom dataset for unsampled exploration.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        parent: propertyField,
+        expandedDataSet: z.object({
+            displayName: z.string().describe('Human-readable name'),
+            dimensionNames: z.array(z.string()).min(1).describe("Dimensions, e.g. ['date','region']"),
+            metricNames: z.array(z.string()).min(1).describe("Metrics, e.g. ['sessions']"),
+            description: z.string().optional(),
+        }).describe('Expanded data set definition'),
+    }),
+    execute: async ({ googleAnalyticsToken, parent, expandedDataSet }) => gaPost(googleAnalyticsToken, ADMIN_V1ALPHA, `${normalizeProperty(parent)}/expandedDataSets`, { expandedDataSet }, undefined, 'create expanded data set'),
+});
+export const listExpandedDataSets = tool({
+    description: 'Lists expanded data sets on a property.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        parent: propertyField,
+        ...paginationSchema,
+    }),
+    execute: async ({ googleAnalyticsToken, parent, pageSize, pageToken }) => gaList(googleAnalyticsToken, ADMIN_V1ALPHA, normalizeProperty(parent), 'expandedDataSets', { pageSize, pageToken }, 'list expanded data sets'),
+});
+//# sourceMappingURL=custom-definitions.js.map

package/dist/toolkits/google-analytics/tools/index.d.ts

@@ -0,0 +1,16 @@
+import { createReportTask, getReportTask, listReportTasks, queryReportTask, batchRunPivotReports, batchRunReports, checkCompatibility, getMetadata, runFunnelReport, runPivotReport, runRealtimeReport, runReport } from './reports.js';
+import { createAudienceExport, createAudienceList, createRecurringAudienceList, getAudience, getAudienceExport, getAudienceList, getRecurringAudienceList, listAudienceExports, listAudienceLists, listAudiences, listRecurringAudienceLists, queryAudienceExport, queryAudienceList } from './audiences.js';
+import { createRollupProperty, getAccount, getAttributionSettings, getDataRetentionSettings, getDataSharingSettings, getGoogleSignalsSettings, getProperty, getPropertyQuotasSnapshot, listAccountSummaries, listAccountsV1Beta, listPropertiesFiltered, provisionAccountTicket, updateProperty } from './admin.js';
+import { archiveCustomDimension, createCustomDimension, createCustomMetric, createExpandedDataSet, getCustomDimension, listCalculatedMetrics, listCustomDimensions, listCustomMetrics, listExpandedDataSets } from './custom-definitions.js';
+import { getKeyEvent, listAdsenseLinks, listBigqueryLinks, listChannelGroups, listConversionEvents, listDataStreams, listDv360AdLinks, listDv360LinkProposals, listEventCreateRules, listFirebaseLinks, listGoogleAdsLinks, listKeyEvents, listMeasurementProtocolSecrets, listReportingDataAnnotations, listSearchAds360Links, listSkAdNetworkSchemas, listSubpropertyEventFilters, listSubpropertySyncConfigs } from './links.js';
+import { sendEvents, validateEvents } from './measurement.js';
+export { runReport, batchRunReports, runPivotReport, batchRunPivotReports, runRealtimeReport, runFunnelReport, checkCompatibility, getMetadata, createReportTask, getReportTask, listReportTasks, queryReportTask, getAudience, listAudiences, createAudienceExport, getAudienceExport, listAudienceExports, queryAudienceExport, createAudienceList, getAudienceList, listAudienceLists, queryAudienceList, createRecurringAudienceList, getRecurringAudienceList, listRecurringAudienceLists, getAccount, listAccountsV1Beta, listAccountSummaries, provisionAccountTicket, getProperty, listPropertiesFiltered, updateProperty, createRollupProperty, getPropertyQuotasSnapshot, getAttributionSettings, getDataRetentionSettings, getDataSharingSettings, getGoogleSignalsSettings, createCustomDimension, getCustomDimension, listCustomDimensions, archiveCustomDimension, createCustomMetric, listCustomMetrics, listCalculatedMetrics, createExpandedDataSet, listExpandedDataSets, listAdsenseLinks, listBigqueryLinks, listChannelGroups, listConversionEvents, listKeyEvents, getKeyEvent, listDataStreams, listDv360AdLinks, listDv360LinkProposals, listEventCreateRules, listFirebaseLinks, listGoogleAdsLinks, listMeasurementProtocolSecrets, listSearchAds360Links, listSkAdNetworkSchemas, listSubpropertyEventFilters, listSubpropertySyncConfigs, listReportingDataAnnotations, sendEvents, validateEvents, };
+declare const auth: "googleAnalyticsToken";
+export declare const googleAnalyticsTools: {
+    name: string;
+    description: string;
+    tool: any;
+    requiredAuth?: typeof auth;
+    scope: "read" | "write" | "delete";
+}[];
+//# sourceMappingURL=index.d.ts.map

package/dist/toolkits/google-analytics/tools/index.js

@@ -0,0 +1,88 @@
+// @ts-nocheck
+import { createReportTask, getReportTask, listReportTasks, queryReportTask, batchRunPivotReports, batchRunReports, checkCompatibility, getMetadata, runFunnelReport, runPivotReport, runRealtimeReport, runReport, } from './reports.js';
+import { createAudienceExport, createAudienceList, createRecurringAudienceList, getAudience, getAudienceExport, getAudienceList, getRecurringAudienceList, listAudienceExports, listAudienceLists, listAudiences, listRecurringAudienceLists, queryAudienceExport, queryAudienceList, } from './audiences.js';
+import { createRollupProperty, getAccount, getAttributionSettings, getDataRetentionSettings, getDataSharingSettings, getGoogleSignalsSettings, getProperty, getPropertyQuotasSnapshot, listAccountSummaries, listAccountsV1Beta, listPropertiesFiltered, provisionAccountTicket, updateProperty, } from './admin.js';
+import { archiveCustomDimension, createCustomDimension, createCustomMetric, createExpandedDataSet, getCustomDimension, listCalculatedMetrics, listCustomDimensions, listCustomMetrics, listExpandedDataSets, } from './custom-definitions.js';
+import { getKeyEvent, listAdsenseLinks, listBigqueryLinks, listChannelGroups, listConversionEvents, listDataStreams, listDv360AdLinks, listDv360LinkProposals, listEventCreateRules, listFirebaseLinks, listGoogleAdsLinks, listKeyEvents, listMeasurementProtocolSecrets, listReportingDataAnnotations, listSearchAds360Links, listSkAdNetworkSchemas, listSubpropertyEventFilters, listSubpropertySyncConfigs, } from './links.js';
+import { sendEvents, validateEvents } from './measurement.js';
+export { runReport, batchRunReports, runPivotReport, batchRunPivotReports, runRealtimeReport, runFunnelReport, checkCompatibility, getMetadata, createReportTask, getReportTask, listReportTasks, queryReportTask, getAudience, listAudiences, createAudienceExport, getAudienceExport, listAudienceExports, queryAudienceExport, createAudienceList, getAudienceList, listAudienceLists, queryAudienceList, createRecurringAudienceList, getRecurringAudienceList, listRecurringAudienceLists, getAccount, listAccountsV1Beta, listAccountSummaries, provisionAccountTicket, getProperty, listPropertiesFiltered, updateProperty, createRollupProperty, getPropertyQuotasSnapshot, getAttributionSettings, getDataRetentionSettings, getDataSharingSettings, getGoogleSignalsSettings, createCustomDimension, getCustomDimension, listCustomDimensions, archiveCustomDimension, createCustomMetric, listCustomMetrics, listCalculatedMetrics, createExpandedDataSet, listExpandedDataSets, listAdsenseLinks, listBigqueryLinks, listChannelGroups, listConversionEvents, listKeyEvents, getKeyEvent, listDataStreams, listDv360AdLinks, listDv360LinkProposals, listEventCreateRules, listFirebaseLinks, listGoogleAdsLinks, listMeasurementProtocolSecrets, listSearchAds360Links, listSkAdNetworkSchemas, listSubpropertyEventFilters, listSubpropertySyncConfigs, listReportingDataAnnotations, sendEvents, validateEvents, };
+const auth = 'googleAnalyticsToken';
+function entry(name, description, toolRef, scope, opts) {
+    return {
+        name,
+        description,
+        tool: toolRef,
+        ...(opts?.noAuth ? {} : { requiredAuth: auth }),
+        scope,
+    };
+}
+export const googleAnalyticsTools = [
+    entry('googleAnalyticsRunReport', 'Runs a standard GA4 report (dimensions x metrics over date ranges).', runReport, 'read'),
+    entry('googleAnalyticsBatchRunReports', 'Runs multiple standard reports for one property in a single call.', batchRunReports, 'read'),
+    entry('googleAnalyticsRunPivotReport', 'Runs a GA4 pivot-table report.', runPivotReport, 'read'),
+    entry('googleAnalyticsBatchRunPivotReports', 'Runs multiple pivot reports for one property in a single call.', batchRunPivotReports, 'read'),
+    entry('googleAnalyticsRunRealtimeReport', 'Runs a realtime report over the last 30 minutes of activity.', runRealtimeReport, 'read'),
+    entry('googleAnalyticsRunFunnelReport', 'Runs a funnel analysis report.', runFunnelReport, 'read'),
+    entry('googleAnalyticsCheckCompatibility', 'Lists dimensions/metrics compatible with a report request.', checkCompatibility, 'read'),
+    entry('googleAnalyticsGetMetadata', 'Gets report metadata (available dimensions, metrics, comparisons).', getMetadata, 'read'),
+    entry('googleAnalyticsCreateReportTask', 'Creates an async report task for large/complex reports.', createReportTask, 'write'),
+    entry('googleAnalyticsGetReportTask', 'Gets report-task metadata and processing state.', getReportTask, 'read'),
+    entry('googleAnalyticsListReportTasks', 'Lists report tasks for a property.', listReportTasks, 'read'),
+    entry('googleAnalyticsQueryReportTask', 'Retrieves rows from an ACTIVE report task.', queryReportTask, 'read'),
+    entry('googleAnalyticsGetAudience', 'Gets a single audience configuration.', getAudience, 'read'),
+    entry('googleAnalyticsListAudiences', 'Lists audience configurations on a property.', listAudiences, 'read'),
+    entry('googleAnalyticsCreateAudienceExport', 'Exports a snapshot of users in an audience (async).', createAudienceExport, 'write'),
+    entry('googleAnalyticsGetAudienceExport', 'Gets audience-export metadata/state.', getAudienceExport, 'read'),
+    entry('googleAnalyticsListAudienceExports', 'Lists audience exports for a property.', listAudienceExports, 'read'),
+    entry('googleAnalyticsQueryAudienceExport', 'Retrieves rows from an audience export.', queryAudienceExport, 'read'),
+    entry('googleAnalyticsCreateAudienceList', 'Creates an audience list snapshot (async).', createAudienceList, 'write'),
+    entry('googleAnalyticsGetAudienceList', 'Gets audience-list metadata/state.', getAudienceList, 'read'),
+    entry('googleAnalyticsListAudienceLists', 'Lists audience lists for a property.', listAudienceLists, 'read'),
+    entry('googleAnalyticsQueryAudienceList', 'Retrieves rows from an audience list.', queryAudienceList, 'read'),
+    entry('googleAnalyticsCreateRecurringAudienceList', 'Creates a recurring (daily) audience list.', createRecurringAudienceList, 'write'),
+    entry('googleAnalyticsGetRecurringAudienceList', 'Gets a recurring audience list and its latest generated list.', getRecurringAudienceList, 'read'),
+    entry('googleAnalyticsListRecurringAudienceLists', 'Lists recurring audience lists for a property.', listRecurringAudienceLists, 'read'),
+    entry('googleAnalyticsGetAccount', 'Gets a single account by resource name.', getAccount, 'read'),
+    entry('googleAnalyticsListAccountsV1Beta', 'Lists all accessible accounts (v1beta).', listAccountsV1Beta, 'read'),
+    entry('googleAnalyticsListAccountSummaries', 'Lists high-level summaries of all accessible accounts.', listAccountSummaries, 'read'),
+    entry('googleAnalyticsProvisionAccountTicket', 'Provisions an account ticket for creating a new account.', provisionAccountTicket, 'write'),
+    entry('googleAnalyticsGetProperty', 'Gets a single GA4 property by resource name.', getProperty, 'read'),
+    entry('googleAnalyticsListPropertiesFiltered', 'Lists GA4 properties by filter expression.', listPropertiesFiltered, 'read'),
+    entry('googleAnalyticsUpdateProperty', 'Updates a property (displayName, timeZone, currencyCode).', updateProperty, 'write'),
+    entry('googleAnalyticsCreateRollupProperty', 'Creates a roll-up property aggregating source properties.', createRollupProperty, 'write'),
+    entry('googleAnalyticsGetPropertyQuotasSnapshot', 'Gets property quota usage by category.', getPropertyQuotasSnapshot, 'read'),
+    entry('googleAnalyticsGetAttributionSettings', 'Gets attribution configuration for a property.', getAttributionSettings, 'read'),
+    entry('googleAnalyticsGetDataRetentionSettings', 'Gets data retention configuration for a property.', getDataRetentionSettings, 'read'),
+    entry('googleAnalyticsGetDataSharingSettings', 'Gets data-sharing configuration for an account.', getDataSharingSettings, 'read'),
+    entry('googleAnalyticsGetGoogleSignalsSettings', 'Gets Google Signals configuration for a property.', getGoogleSignalsSettings, 'read'),
+    entry('googleAnalyticsCreateCustomDimension', 'Creates a custom dimension (EVENT, USER, or ITEM scope).', createCustomDimension, 'write'),
+    entry('googleAnalyticsGetCustomDimension', 'Gets a single custom dimension by resource name.', getCustomDimension, 'read'),
+    entry('googleAnalyticsListCustomDimensions', 'Lists custom dimensions on a property.', listCustomDimensions, 'read'),
+    entry('googleAnalyticsArchiveCustomDimension', 'Archives a custom dimension (removes from active use).', archiveCustomDimension, 'write'),
+    entry('googleAnalyticsCreateCustomMetric', 'Creates an event-scoped custom metric.', createCustomMetric, 'write'),
+    entry('googleAnalyticsListCustomMetrics', 'Lists custom metrics on a property.', listCustomMetrics, 'read'),
+    entry('googleAnalyticsListCalculatedMetrics', 'Lists calculated metrics on a property.', listCalculatedMetrics, 'read'),
+    entry('googleAnalyticsCreateExpandedDataSet', 'Creates an expanded data set (dimensions + metrics).', createExpandedDataSet, 'write'),
+    entry('googleAnalyticsListExpandedDataSets', 'Lists expanded data sets on a property.', listExpandedDataSets, 'read'),
+    entry('googleAnalyticsListAdsenseLinks', 'Lists AdSense links on a property.', listAdsenseLinks, 'read'),
+    entry('googleAnalyticsListBigqueryLinks', 'Lists BigQuery links on a property.', listBigqueryLinks, 'read'),
+    entry('googleAnalyticsListChannelGroups', 'Lists channel groups on a property.', listChannelGroups, 'read'),
+    entry('googleAnalyticsListConversionEvents', 'Lists conversion events on a property.', listConversionEvents, 'read'),
+    entry('googleAnalyticsListKeyEvents', 'Lists key events on a property.', listKeyEvents, 'read'),
+    entry('googleAnalyticsGetKeyEvent', 'Gets a single key event by resource name.', getKeyEvent, 'read'),
+    entry('googleAnalyticsListDataStreams', 'Lists data streams on a property.', listDataStreams, 'read'),
+    entry('googleAnalyticsListDv360AdLinks', 'Lists DV360 advertiser links on a property.', listDv360AdLinks, 'read'),
+    entry('googleAnalyticsListDv360LinkProposals', 'Lists DV360 link proposals on a property.', listDv360LinkProposals, 'read'),
+    entry('googleAnalyticsListEventCreateRules', 'Lists event-create rules on a property.', listEventCreateRules, 'read'),
+    entry('googleAnalyticsListFirebaseLinks', 'Lists Firebase links on a property.', listFirebaseLinks, 'read'),
+    entry('googleAnalyticsListGoogleAdsLinks', 'Lists Google Ads links on a property.', listGoogleAdsLinks, 'read'),
+    entry('googleAnalyticsListMeasurementProtocolSecrets', 'Lists Measurement Protocol secrets on a property.', listMeasurementProtocolSecrets, 'read'),
+    entry('googleAnalyticsListSearchAds360Links', 'Lists Search Ads 360 links on a property.', listSearchAds360Links, 'read'),
+    entry('googleAnalyticsListSkAdNetworkSchemas', 'Lists SKAdNetwork schemas for an iOS data stream.', listSkAdNetworkSchemas, 'read'),
+    entry('googleAnalyticsListSubpropertyEventFilters', 'Lists subproperty event filters on a property.', listSubpropertyEventFilters, 'read'),
+    entry('googleAnalyticsListSubpropertySyncConfigs', 'Lists subproperty sync configs on a property.', listSubpropertySyncConfigs, 'read'),
+    entry('googleAnalyticsListReportingDataAnnotations', 'Lists reporting data annotations on a property.', listReportingDataAnnotations, 'read'),
+    entry('googleAnalyticsSendEvents', 'Sends server-side events via Measurement Protocol (API-secret auth).', sendEvents, 'write', { noAuth: true }),
+    entry('googleAnalyticsValidateEvents', 'Validates Measurement Protocol events without recording them.', validateEvents, 'read', { noAuth: true }),
+];
+//# sourceMappingURL=index.js.map

package/dist/toolkits/google-analytics/tools/links.d.ts

@@ -0,0 +1,22 @@
+export declare const listAdsenseLinks: import("ai").Tool<Record<string, any>, any>;
+export declare const listBigqueryLinks: import("ai").Tool<Record<string, any>, any>;
+export declare const listChannelGroups: import("ai").Tool<Record<string, any>, any>;
+export declare const listConversionEvents: import("ai").Tool<Record<string, any>, any>;
+export declare const listKeyEvents: import("ai").Tool<Record<string, any>, any>;
+export declare const getKeyEvent: import("ai").Tool<{
+    name: string;
+    googleAnalyticsToken: string;
+}, any>;
+export declare const listDataStreams: import("ai").Tool<Record<string, any>, any>;
+export declare const listDv360AdLinks: import("ai").Tool<Record<string, any>, any>;
+export declare const listDv360LinkProposals: import("ai").Tool<Record<string, any>, any>;
+export declare const listEventCreateRules: import("ai").Tool<Record<string, any>, any>;
+export declare const listFirebaseLinks: import("ai").Tool<Record<string, any>, any>;
+export declare const listGoogleAdsLinks: import("ai").Tool<Record<string, any>, any>;
+export declare const listMeasurementProtocolSecrets: import("ai").Tool<Record<string, any>, any>;
+export declare const listSearchAds360Links: import("ai").Tool<Record<string, any>, any>;
+export declare const listSkAdNetworkSchemas: import("ai").Tool<Record<string, any>, any>;
+export declare const listSubpropertyEventFilters: import("ai").Tool<Record<string, any>, any>;
+export declare const listSubpropertySyncConfigs: import("ai").Tool<Record<string, any>, any>;
+export declare const listReportingDataAnnotations: import("ai").Tool<Record<string, any>, any>;
+//# sourceMappingURL=links.d.ts.map