@rnsk/toolkits 0.0.8 → 0.0.10

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

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

@@ -0,0 +1,56 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { ADMIN_V1ALPHA, ADMIN_V1BETA, gaGet, gaList, googleAnalyticsTokenField, normalizeProperty, paginationSchema, } from './client.js';
+const propertyField = z.string().describe("Property 'properties/{id}' (bare numeric ID accepted)");
+function makeListTool(toolName, description, resource, action, base = ADMIN_V1BETA, extraSchema = {}) {
+    return tool({
+        description,
+        inputSchema: z.object({
+            googleAnalyticsToken: googleAnalyticsTokenField,
+            parent: propertyField,
+            ...paginationSchema,
+            ...extraSchema,
+        }),
+        execute: async ({ googleAnalyticsToken, parent, pageSize, pageToken, ...rest }) => {
+            const extra = {};
+            for (const [k, v] of Object.entries(rest))
+                if (v !== undefined)
+                    extra[k] = v;
+            return gaList(googleAnalyticsToken, base, parent.startsWith('properties/') || parent.startsWith('accounts/') ? parent : normalizeProperty(parent), resource, { pageSize, pageToken, extra }, action);
+        },
+    });
+}
+export const listAdsenseLinks = makeListTool('listAdsenseLinks', 'Lists AdSense links on a property.', 'adsenseLinks', 'list AdSense links');
+export const listBigqueryLinks = makeListTool('listBigqueryLinks', 'Lists BigQuery export links on a property.', 'bigqueryLinks', 'list BigQuery links');
+export const listChannelGroups = makeListTool('listChannelGroups', 'Lists channel groups that categorize traffic sources in reports.', 'channelGroups', 'list channel groups');
+export const listConversionEvents = makeListTool('listConversionEvents', 'Lists conversion events configured on a property.', 'conversionEvents', 'list conversion events');
+export const listKeyEvents = makeListTool('listKeyEvents', 'Lists key events (successor of conversion events) on a property.', 'keyEvents', 'list key events');
+export const getKeyEvent = tool({
+    description: 'Gets a single key event by resource name. Read-only; create/update/delete require the Analytics UI.',
+    inputSchema: z.object({
+        googleAnalyticsToken: googleAnalyticsTokenField,
+        name: z.string().describe("Key event 'properties/{id}/keyEvents/{event}'"),
+    }),
+    execute: async ({ googleAnalyticsToken, name }) => {
+        try {
+            return await gaGet(googleAnalyticsToken, ADMIN_V1BETA, name);
+        }
+        catch (error) {
+            return { error: 'Error getting key event', message: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    },
+});
+export const listDataStreams = makeListTool('listDataStreams', 'Lists data streams (web, iOS, Android) on a property.', 'dataStreams', 'list data streams');
+export const listDv360AdLinks = makeListTool('listDv360AdLinks', 'Lists Display & Video 360 advertiser links on a property.', 'displayVideo360AdvertiserLinks', 'list DV360 advertiser links');
+export const listDv360LinkProposals = makeListTool('listDv360LinkProposals', 'Lists Display & Video 360 link proposals on a property.', 'displayVideo360AdvertiserLinkProposals', 'list DV360 link proposals');
+export const listEventCreateRules = makeListTool('listEventCreateRules', 'Lists event-create rules (derived events) on a property.', 'eventCreateRules', 'list event create rules');
+export const listFirebaseLinks = makeListTool('listFirebaseLinks', 'Lists Firebase links on a property.', 'firebaseLinks', 'list Firebase links');
+export const listGoogleAdsLinks = makeListTool('listGoogleAdsLinks', 'Lists Google Ads links on a property.', 'googleAdsLinks', 'list Google Ads links');
+export const listMeasurementProtocolSecrets = makeListTool('listMeasurementProtocolSecrets', 'Lists Measurement Protocol secrets (api_secret values live under data streams — reuse them for sendEvents).', 'measurementProtocolSecrets', 'list Measurement Protocol secrets');
+export const listSearchAds360Links = makeListTool('listSearchAds360Links', 'Lists Search Ads 360 links on a property.', 'searchAds360Links', 'list Search Ads 360 links');
+export const listSkAdNetworkSchemas = makeListTool('listSkAdNetworkSchemas', 'Lists SKAdNetwork conversion-value schemas for an iOS data stream. At most one schema per property.', 'skadnetworkConversionValueSchemas', 'list SKAdNetwork schemas', ADMIN_V1ALPHA);
+export const listSubpropertyEventFilters = makeListTool('listSubpropertyEventFilters', 'Lists subproperty event filters on a property.', 'subpropertyEventFilters', 'list subproperty event filters', ADMIN_V1ALPHA);
+export const listSubpropertySyncConfigs = makeListTool('listSubpropertySyncConfigs', 'Lists subproperty sync configurations on a property.', 'subpropertySyncConfigs', 'list subproperty sync configs', ADMIN_V1ALPHA);
+export const listReportingDataAnnotations = makeListTool('listReportingDataAnnotations', 'Lists reporting data annotations (notes on report data) on a property. Supports filter expressions.', 'reportingDataAnnotations', 'list reporting data annotations', ADMIN_V1ALPHA, { filter: z.string().optional().describe('Filter expression for annotations') });
+//# sourceMappingURL=links.js.map

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

@@ -0,0 +1,3 @@
+export declare const sendEvents: import("ai").Tool<any, any>;
+export declare const validateEvents: import("ai").Tool<any, any>;
+//# sourceMappingURL=measurement.d.ts.map

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

@@ -0,0 +1,55 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+const mpEvent = z.object({
+    name: z.string().max(40).describe("Event name, e.g. 'purchase', 'login', 'page_view'"),
+    params: z.record(z.any()).optional().describe("Parameters, e.g. {currency:'USD', value:42.5, transaction_id:'T12345'}"),
+});
+const mpBody = {
+    measurementId: z.string().describe("Web stream measurement ID, e.g. 'G-XXXXXXX'"),
+    apiSecret: z.string().describe('Measurement Protocol API secret (see listMeasurementProtocolSecrets)'),
+    clientId: z.string().describe('Client ID (same value used client-side for session stitching)'),
+    events: z.array(mpEvent).min(1).max(25).describe('1-25 events per request'),
+    userId: z.string().optional(),
+    timestampMicros: z.number().optional().describe('Unix microseconds; defaults to collection time'),
+    userProperties: z.record(z.any()).optional(),
+    consent: z.object({
+        adUserData: z.string().optional().describe("'GRANTED' or 'DENIED'"),
+        adPersonalization: z.string().optional().describe("'GRANTED' or 'DENIED'"),
+    }).catchall(z.unknown()).optional(),
+};
+async function postMeasurementProtocol(measurementId, apiSecret, payload, debug, action) {
+    try {
+        const base = debug ? 'https://www.google-analytics.com/debug/mp/collect' : 'https://www.google-analytics.com/mp/collect';
+        const url = `${base}?measurement_id=${encodeURIComponent(measurementId)}&api_secret=${encodeURIComponent(apiSecret)}`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            const details = await response.text().catch(() => '');
+            return { error: `Failed to ${action} (HTTP ${response.status})`, details };
+        }
+        const data = await response.json().catch(() => ({}));
+        return debug ? data : { success: true, ...(typeof data === 'object' ? data : {}) };
+    }
+    catch (error) {
+        return { error: `Error while trying to ${action}`, message: error instanceof Error ? error.message : 'Unknown error' };
+    }
+}
+function toPayload(input) {
+    const { measurementId, apiSecret, ...rest } = input;
+    return rest;
+}
+export const sendEvents = tool({
+    description: 'Sends server-side events via Measurement Protocol (API-secret auth, no OAuth). Events appear in reports within 24-48h. Validate first with validateEvents.',
+    inputSchema: z.object(mpBody),
+    execute: async (input) => postMeasurementProtocol(input.measurementId, input.apiSecret, toPayload(input), false, 'send events'),
+});
+export const validateEvents = tool({
+    description: 'Validates Measurement Protocol events against the debug endpoint without recording them. Fix validationMessages before calling sendEvents.',
+    inputSchema: z.object(mpBody),
+    execute: async (input) => postMeasurementProtocol(input.measurementId, input.apiSecret, toPayload(input), true, 'validate events'),
+});
+//# sourceMappingURL=measurement.js.map

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

@@ -0,0 +1,136 @@
+import { z } from 'zod';
+export declare const runReport: import("ai").Tool<{
+    property: string;
+    googleAnalyticsToken: string;
+    limit?: number | undefined;
+    dimensions?: z.objectOutputType<{
+        name: z.ZodString;
+    }, z.ZodUnknown, "strip">[] | undefined;
+    metricAggregations?: string[] | undefined;
+    dateRanges?: z.objectOutputType<{
+        startDate: z.ZodString;
+        endDate: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.ZodUnknown, "strip">[] | undefined;
+    metrics?: z.objectOutputType<{
+        name: z.ZodString;
+    }, z.ZodUnknown, "strip">[] | undefined;
+    dimensionFilter?: Record<string, any> | undefined;
+    metricFilter?: Record<string, any> | undefined;
+    orderBys?: Record<string, any>[] | undefined;
+    offset?: number | undefined;
+    currencyCode?: string | undefined;
+    cohortSpec?: Record<string, any> | undefined;
+    comparisons?: Record<string, any>[] | undefined;
+    keepEmptyRows?: boolean | undefined;
+    returnPropertyQuota?: boolean | undefined;
+}, unknown>;
+export declare const batchRunReports: import("ai").Tool<{
+    property: string;
+    requests: Record<string, any>[];
+    googleAnalyticsToken: string;
+}, unknown>;
+export declare const runPivotReport: import("ai").Tool<{
+    property: string;
+    googleAnalyticsToken: string;
+    limit?: number | undefined;
+    dimensions?: z.objectOutputType<{
+        name: z.ZodString;
+    }, z.ZodUnknown, "strip">[] | undefined;
+    dateRanges?: z.objectOutputType<{
+        startDate: z.ZodString;
+        endDate: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.ZodUnknown, "strip">[] | undefined;
+    metrics?: z.objectOutputType<{
+        name: z.ZodString;
+    }, z.ZodUnknown, "strip">[] | undefined;
+    dimensionFilter?: Record<string, any> | undefined;
+    metricFilter?: Record<string, any> | undefined;
+    orderBys?: Record<string, any>[] | undefined;
+    offset?: number | undefined;
+    currencyCode?: string | undefined;
+    cohortSpec?: Record<string, any> | undefined;
+    comparisons?: Record<string, any>[] | undefined;
+    keepEmptyRows?: boolean | undefined;
+    returnPropertyQuota?: boolean | undefined;
+    pivots?: Record<string, any>[] | undefined;
+}, unknown>;
+export declare const batchRunPivotReports: import("ai").Tool<{
+    property: string;
+    requests: Record<string, any>[];
+    googleAnalyticsToken: string;
+}, unknown>;
+export declare const runRealtimeReport: import("ai").Tool<{
+    property: string;
+    googleAnalyticsToken: string;
+    limit?: number | undefined;
+    dimensions?: z.objectOutputType<{
+        name: z.ZodString;
+    }, z.ZodUnknown, "strip">[] | undefined;
+    metricAggregations?: string[] | undefined;
+    metrics?: z.objectOutputType<{
+        name: z.ZodString;
+    }, z.ZodUnknown, "strip">[] | undefined;
+    dimensionFilter?: Record<string, any> | undefined;
+    metricFilter?: Record<string, any> | undefined;
+    orderBys?: Record<string, any>[] | undefined;
+    returnPropertyQuota?: boolean | undefined;
+    minuteRanges?: Record<string, any>[] | undefined;
+}, unknown>;
+export declare const runFunnelReport: import("ai").Tool<{
+    property: string;
+    googleAnalyticsToken: string;
+    funnel: Record<string, any>;
+    limit?: number | undefined;
+    dateRanges?: z.objectOutputType<{
+        startDate: z.ZodString;
+        endDate: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.ZodUnknown, "strip">[] | undefined;
+    dimensionFilter?: Record<string, any> | undefined;
+    returnPropertyQuota?: boolean | undefined;
+    segments?: Record<string, any>[] | undefined;
+    funnelBreakdown?: Record<string, any> | undefined;
+    funnelNextAction?: Record<string, any> | undefined;
+    funnelVisualizationType?: string | undefined;
+}, unknown>;
+export declare const checkCompatibility: import("ai").Tool<{
+    property: string;
+    googleAnalyticsToken: string;
+    dimensions?: z.objectOutputType<{
+        name: z.ZodString;
+    }, z.ZodUnknown, "strip">[] | undefined;
+    metrics?: z.objectOutputType<{
+        name: z.ZodString;
+    }, z.ZodUnknown, "strip">[] | undefined;
+    dimensionFilter?: Record<string, any> | undefined;
+    metricFilter?: Record<string, any> | undefined;
+    compatibilityFilter?: "DIMENSION_COMPATIBILITY_FILTER_UNSPECIFIED" | "COMPATIBLE" | "INCOMPATIBLE" | undefined;
+}, unknown>;
+export declare const getMetadata: import("ai").Tool<{
+    name: string;
+    googleAnalyticsToken: string;
+}, any>;
+export declare const createReportTask: import("ai").Tool<{
+    parent: string;
+    googleAnalyticsToken: string;
+    reportDefinition?: Record<string, any> | undefined;
+}, any>;
+export declare const getReportTask: import("ai").Tool<{
+    name: string;
+    googleAnalyticsToken: string;
+}, any>;
+export declare const listReportTasks: import("ai").Tool<{
+    parent: string;
+    googleAnalyticsToken: string;
+    pageToken?: string | undefined;
+    pageSize?: number | undefined;
+}, any>;
+export declare const queryReportTask: import("ai").Tool<{
+    name: string;
+    googleAnalyticsToken: string;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}, any>;
+//# sourceMappingURL=reports.d.ts.map