@cesteral/meta-mcp 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE.md +201 -0
- package/README.md +337 -0
- package/dist/auth/index.d.ts +3 -0
- package/dist/auth/index.d.ts.map +1 -0
- package/dist/auth/index.js +3 -0
- package/dist/auth/index.js.map +1 -0
- package/dist/auth/meta-auth-adapter.d.ts +37 -0
- package/dist/auth/meta-auth-adapter.d.ts.map +1 -0
- package/dist/auth/meta-auth-adapter.js +109 -0
- package/dist/auth/meta-auth-adapter.js.map +1 -0
- package/dist/auth/meta-auth-strategy.d.ts +13 -0
- package/dist/auth/meta-auth-strategy.d.ts.map +1 -0
- package/dist/auth/meta-auth-strategy.js +47 -0
- package/dist/auth/meta-auth-strategy.js.map +1 -0
- package/dist/config/index.d.ts +108 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +51 -0
- package/dist/config/index.js.map +1 -0
- package/dist/config/insights-catalog.json +95 -0
- package/dist/container/index.d.ts +5 -0
- package/dist/container/index.d.ts.map +1 -0
- package/dist/container/index.js +14 -0
- package/dist/container/index.js.map +1 -0
- package/dist/container/registrations/core.d.ts +3 -0
- package/dist/container/registrations/core.d.ts.map +1 -0
- package/dist/container/registrations/core.js +16 -0
- package/dist/container/registrations/core.js.map +1 -0
- package/dist/container/registrations/mcp.d.ts +2 -0
- package/dist/container/registrations/mcp.d.ts.map +1 -0
- package/dist/container/registrations/mcp.js +3 -0
- package/dist/container/registrations/mcp.js.map +1 -0
- package/dist/container/tokens.d.ts +6 -0
- package/dist/container/tokens.d.ts.map +1 -0
- package/dist/container/tokens.js +6 -0
- package/dist/container/tokens.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +40 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +244 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +111 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js +160 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js +299 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js +170 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js +234 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js +159 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/insights-reporting-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/insights-reporting-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/insights-reporting-workflow.prompt.js +79 -0
- package/dist/mcp-server/prompts/definitions/insights-reporting-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js +289 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js +109 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +77 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/index.d.ts +9 -0
- package/dist/mcp-server/prompts/index.d.ts.map +1 -0
- package/dist/mcp-server/prompts/index.js +97 -0
- package/dist/mcp-server/prompts/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts +4 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js +140 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js +117 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts +4 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js +125 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.js +28 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/findings.resource.d.ts +8 -0
- package/dist/mcp-server/resources/definitions/findings.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/findings.resource.js +33 -0
- package/dist/mcp-server/resources/definitions/findings.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/index.d.ts +8 -0
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/index.js +81 -0
- package/dist/mcp-server/resources/definitions/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/insights-reference.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/insights-reference.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/insights-reference.resource.js +113 -0
- package/dist/mcp-server/resources/definitions/insights-reference.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.js +98 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.js.map +1 -0
- package/dist/mcp-server/resources/index.d.ts +3 -0
- package/dist/mcp-server/resources/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/index.js +2 -0
- package/dist/mcp-server/resources/index.js.map +1 -0
- package/dist/mcp-server/resources/types.d.ts +8 -0
- package/dist/mcp-server/resources/types.d.ts.map +1 -0
- package/dist/mcp-server/resources/types.js +2 -0
- package/dist/mcp-server/resources/types.js.map +1 -0
- package/dist/mcp-server/resources/utils/field-rules.d.ts +18 -0
- package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -0
- package/dist/mcp-server/resources/utils/field-rules.js +103 -0
- package/dist/mcp-server/resources/utils/field-rules.js.map +1 -0
- package/dist/mcp-server/server.d.ts +5 -0
- package/dist/mcp-server/server.d.ts.map +1 -0
- package/dist/mcp-server/server.js +133 -0
- package/dist/mcp-server/server.js.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +221 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +178 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +143 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +108 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +180 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +125 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +140 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +112 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +148 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js +107 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +115 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js +104 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +93 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js +102 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +183 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.js +109 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts +115 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js +98 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +69 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js +63 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.d.ts +69 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.js +68 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-available-metrics.tool.d.ts +91 -0
- package/dist/mcp-server/tools/definitions/get-available-metrics.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-available-metrics.tool.js +85 -0
- package/dist/mcp-server/tools/definitions/get-available-metrics.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-delivery-estimate.tool.d.ts +82 -0
- package/dist/mcp-server/tools/definitions/get-delivery-estimate.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-delivery-estimate.tool.js +72 -0
- package/dist/mcp-server/tools/definitions/get-delivery-estimate.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +90 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.js +83 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-insights-breakdowns.tool.d.ts +277 -0
- package/dist/mcp-server/tools/definitions/get-insights-breakdowns.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-insights-breakdowns.tool.js +175 -0
- package/dist/mcp-server/tools/definitions/get-insights-breakdowns.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-insights.tool.d.ts +274 -0
- package/dist/mcp-server/tools/definitions/get-insights.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-insights.tool.js +188 -0
- package/dist/mcp-server/tools/definitions/get-insights.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts +141 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js +157 -0
- package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +81 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js +73 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/index.d.ts +29 -0
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/index.js +87 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.d.ts +147 -0
- package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.js +83 -0
- package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +184 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js +105 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-budget-schedule.tool.d.ts +128 -0
- package/dist/mcp-server/tools/definitions/manage-budget-schedule.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-budget-schedule.tool.js +145 -0
- package/dist/mcp-server/tools/definitions/manage-budget-schedule.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +89 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js +87 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +192 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.js +131 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +1714 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js +146 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts +88 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.js +89 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts +94 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.js +151 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +169 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js +103 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/index.d.ts +2 -0
- package/dist/mcp-server/tools/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/index.js +2 -0
- package/dist/mcp-server/tools/index.js.map +1 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.d.ts +8 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.js +70 -0
- package/dist/mcp-server/tools/utils/capture-snapshot.js.map +1 -0
- package/dist/mcp-server/tools/utils/dry-run.d.ts +11 -0
- package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/dry-run.js +60 -0
- package/dist/mcp-server/tools/utils/dry-run.js.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts +14 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js +138 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
- package/dist/mcp-server/tools/utils/resolve-session.d.ts +4 -0
- package/dist/mcp-server/tools/utils/resolve-session.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/resolve-session.js +6 -0
- package/dist/mcp-server/tools/utils/resolve-session.js.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts +53 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.js +80 -0
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
- package/dist/services/meta/meta-graph-api-client.d.ts +19 -0
- package/dist/services/meta/meta-graph-api-client.d.ts.map +1 -0
- package/dist/services/meta/meta-graph-api-client.js +226 -0
- package/dist/services/meta/meta-graph-api-client.js.map +1 -0
- package/dist/services/meta/meta-insights-service.d.ts +76 -0
- package/dist/services/meta/meta-insights-service.d.ts.map +1 -0
- package/dist/services/meta/meta-insights-service.js +209 -0
- package/dist/services/meta/meta-insights-service.js.map +1 -0
- package/dist/services/meta/meta-service.d.ts +64 -0
- package/dist/services/meta/meta-service.d.ts.map +1 -0
- package/dist/services/meta/meta-service.js +177 -0
- package/dist/services/meta/meta-service.js.map +1 -0
- package/dist/services/meta/meta-targeting-service.d.ts +13 -0
- package/dist/services/meta/meta-targeting-service.d.ts.map +1 -0
- package/dist/services/meta/meta-targeting-service.js +38 -0
- package/dist/services/meta/meta-targeting-service.js.map +1 -0
- package/dist/services/meta/types.d.ts +227 -0
- package/dist/services/meta/types.d.ts.map +1 -0
- package/dist/services/meta/types.js +55 -0
- package/dist/services/meta/types.js.map +1 -0
- package/dist/services/session-services.d.ts +19 -0
- package/dist/services/session-services.d.ts.map +1 -0
- package/dist/services/session-services.js +19 -0
- package/dist/services/session-services.js.map +1 -0
- package/dist/testkit/fixtures/index.d.ts +9 -0
- package/dist/testkit/fixtures/index.d.ts.map +1 -0
- package/dist/testkit/fixtures/index.js +201 -0
- package/dist/testkit/fixtures/index.js.map +1 -0
- package/dist/testkit/index.d.ts +6 -0
- package/dist/testkit/index.d.ts.map +1 -0
- package/dist/testkit/index.js +26 -0
- package/dist/testkit/index.js.map +1 -0
- package/dist/testkit/types.d.ts +17 -0
- package/dist/testkit/types.d.ts.map +1 -0
- package/dist/testkit/types.js +2 -0
- package/dist/testkit/types.js.map +1 -0
- package/dist/types-global/mcp.d.ts +2 -0
- package/dist/types-global/mcp.d.ts.map +1 -0
- package/dist/types-global/mcp.js +2 -0
- package/dist/types-global/mcp.js.map +1 -0
- package/dist/utils/errors/index.d.ts +2 -0
- package/dist/utils/errors/index.d.ts.map +1 -0
- package/dist/utils/errors/index.js +2 -0
- package/dist/utils/errors/index.js.map +1 -0
- package/dist/utils/internal/request-context.d.ts +20 -0
- package/dist/utils/internal/request-context.d.ts.map +1 -0
- package/dist/utils/internal/request-context.js +19 -0
- package/dist/utils/internal/request-context.js.map +1 -0
- package/dist/utils/platform.d.ts +3 -0
- package/dist/utils/platform.d.ts.map +1 -0
- package/dist/utils/platform.js +5 -0
- package/dist/utils/platform.js.map +1 -0
- package/dist/utils/security/rate-limiter.d.ts +3 -0
- package/dist/utils/security/rate-limiter.d.ts.map +1 -0
- package/dist/utils/security/rate-limiter.js +5 -0
- package/dist/utils/security/rate-limiter.js.map +1 -0
- package/dist/utils/telemetry/index.d.ts +2 -0
- package/dist/utils/telemetry/index.d.ts.map +1 -0
- package/dist/utils/telemetry/index.js +2 -0
- package/dist/utils/telemetry/index.js.map +1 -0
- package/dist/utils/telemetry/tracing.d.ts +3 -0
- package/dist/utils/telemetry/tracing.d.ts.map +1 -0
- package/dist/utils/telemetry/tracing.js +4 -0
- package/dist/utils/telemetry/tracing.js.map +1 -0
- package/package.json +66 -0
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
import { getEntityTypeEnum } from "../utils/entity-mapping.js";
|
|
4
|
+
import { elicitDeleteConfirmation } from "@cesteral/shared";
|
|
5
|
+
const TOOL_NAME = "meta_delete_entity";
|
|
6
|
+
const TOOL_TITLE = "Delete Meta Ads Entity";
|
|
7
|
+
const TOOL_DESCRIPTION = `Delete a Meta Ads entity.
|
|
8
|
+
|
|
9
|
+
**Supported entity types:** ${getEntityTypeEnum().join(", ")}
|
|
10
|
+
|
|
11
|
+
Uses DELETE /{entityId}.
|
|
12
|
+
|
|
13
|
+
**Gotchas:**
|
|
14
|
+
- ACTIVE entities must be paused before deletion.
|
|
15
|
+
- For campaigns, setting status to ARCHIVED is often preferred over deletion.
|
|
16
|
+
- ARCHIVED status is permanent and cannot be reversed.
|
|
17
|
+
- Writes are rate-limited at 3x read cost.`;
|
|
18
|
+
export const DeleteEntityInputSchema = z
|
|
19
|
+
.object({
|
|
20
|
+
entityType: z.enum(getEntityTypeEnum()).describe("Type of entity to delete"),
|
|
21
|
+
entityId: z.string().min(1).describe("The entity ID to delete"),
|
|
22
|
+
})
|
|
23
|
+
.describe("Parameters for deleting a Meta Ads entity");
|
|
24
|
+
export const DeleteEntityOutputSchema = z
|
|
25
|
+
.object({
|
|
26
|
+
confirmed: z.boolean(),
|
|
27
|
+
declineReason: z.string().optional(),
|
|
28
|
+
success: z.boolean(),
|
|
29
|
+
entityId: z.string(),
|
|
30
|
+
entityType: z.string(),
|
|
31
|
+
timestamp: z.string().datetime(),
|
|
32
|
+
})
|
|
33
|
+
.describe("Entity deletion result");
|
|
34
|
+
export async function deleteEntityLogic(input, context, sdkContext) {
|
|
35
|
+
const confirmed = await elicitDeleteConfirmation({
|
|
36
|
+
entityLabel: input.entityType,
|
|
37
|
+
entityId: input.entityId,
|
|
38
|
+
sdkContext,
|
|
39
|
+
});
|
|
40
|
+
if (!confirmed) {
|
|
41
|
+
return {
|
|
42
|
+
confirmed: false,
|
|
43
|
+
declineReason: "user_declined",
|
|
44
|
+
success: false,
|
|
45
|
+
entityId: input.entityId,
|
|
46
|
+
entityType: input.entityType,
|
|
47
|
+
timestamp: new Date().toISOString(),
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
const { metaService } = resolveSessionServices(sdkContext);
|
|
51
|
+
const result = await metaService.deleteEntity(input.entityId, context);
|
|
52
|
+
const success = result?.success === true;
|
|
53
|
+
return {
|
|
54
|
+
confirmed: true,
|
|
55
|
+
success,
|
|
56
|
+
entityId: input.entityId,
|
|
57
|
+
entityType: input.entityType,
|
|
58
|
+
timestamp: new Date().toISOString(),
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
export function deleteEntityResponseFormatter(result) {
|
|
62
|
+
if (!result.confirmed) {
|
|
63
|
+
return [
|
|
64
|
+
{
|
|
65
|
+
type: "text",
|
|
66
|
+
text: `Deletion of ${result.entityType} ${result.entityId} cancelled by user.\n\nTimestamp: ${result.timestamp}`,
|
|
67
|
+
},
|
|
68
|
+
];
|
|
69
|
+
}
|
|
70
|
+
const status = result.success ? "deleted successfully" : "deletion returned unexpected response";
|
|
71
|
+
return [
|
|
72
|
+
{
|
|
73
|
+
type: "text",
|
|
74
|
+
text: `${result.entityType} ${result.entityId} ${status}\n\nTimestamp: ${result.timestamp}`,
|
|
75
|
+
},
|
|
76
|
+
];
|
|
77
|
+
}
|
|
78
|
+
export const deleteEntityTool = {
|
|
79
|
+
name: TOOL_NAME,
|
|
80
|
+
title: TOOL_TITLE,
|
|
81
|
+
description: TOOL_DESCRIPTION,
|
|
82
|
+
inputSchema: DeleteEntityInputSchema,
|
|
83
|
+
outputSchema: DeleteEntityOutputSchema,
|
|
84
|
+
annotations: {
|
|
85
|
+
readOnlyHint: false,
|
|
86
|
+
openWorldHint: false,
|
|
87
|
+
idempotentHint: false,
|
|
88
|
+
destructiveHint: true,
|
|
89
|
+
},
|
|
90
|
+
inputExamples: [
|
|
91
|
+
{
|
|
92
|
+
label: "Delete an ad creative",
|
|
93
|
+
input: {
|
|
94
|
+
entityType: "adCreative",
|
|
95
|
+
entityId: "23456789012345",
|
|
96
|
+
},
|
|
97
|
+
},
|
|
98
|
+
],
|
|
99
|
+
logic: deleteEntityLogic,
|
|
100
|
+
responseFormatter: deleteEntityResponseFormatter,
|
|
101
|
+
};
|
|
102
|
+
//# sourceMappingURL=delete-entity.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"delete-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/delete-entity.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,183 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent } from "@cesteral/shared";
|
|
3
|
+
import type { SdkContext } from "@cesteral/shared";
|
|
4
|
+
export declare const DownloadReportInputSchema: z.ZodObject<{
|
|
5
|
+
reportRunId: z.ZodString;
|
|
6
|
+
cursor: z.ZodOptional<z.ZodString>;
|
|
7
|
+
} & Omit<{
|
|
8
|
+
mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
|
|
9
|
+
columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
10
|
+
offset: z.ZodOptional<z.ZodNumber>;
|
|
11
|
+
maxRows: z.ZodOptional<z.ZodNumber>;
|
|
12
|
+
aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
13
|
+
aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["sum", "avg", "count", "min", "max"]>>>;
|
|
14
|
+
}, "offset"> & {
|
|
15
|
+
includeComputedMetrics: z.ZodDefault<z.ZodBoolean>;
|
|
16
|
+
}, "strip", z.ZodTypeAny, {
|
|
17
|
+
reportRunId: string;
|
|
18
|
+
includeComputedMetrics: boolean;
|
|
19
|
+
mode: "summary" | "rows";
|
|
20
|
+
columns?: string[] | undefined;
|
|
21
|
+
maxRows?: number | undefined;
|
|
22
|
+
aggregateBy?: string[] | undefined;
|
|
23
|
+
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
24
|
+
cursor?: string | undefined;
|
|
25
|
+
}, {
|
|
26
|
+
reportRunId: string;
|
|
27
|
+
includeComputedMetrics?: boolean | undefined;
|
|
28
|
+
mode?: "summary" | "rows" | undefined;
|
|
29
|
+
columns?: string[] | undefined;
|
|
30
|
+
maxRows?: number | undefined;
|
|
31
|
+
aggregateBy?: string[] | undefined;
|
|
32
|
+
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
33
|
+
cursor?: string | undefined;
|
|
34
|
+
}>;
|
|
35
|
+
export declare const DownloadReportOutputSchema: z.ZodObject<{
|
|
36
|
+
fetchedAllRows: z.ZodBoolean;
|
|
37
|
+
nextCursor: z.ZodOptional<z.ZodString>;
|
|
38
|
+
timestamp: z.ZodString;
|
|
39
|
+
totalRows: z.ZodNumber;
|
|
40
|
+
returnedRows: z.ZodNumber;
|
|
41
|
+
truncated: z.ZodBoolean;
|
|
42
|
+
nextOffset: z.ZodNullable<z.ZodNumber>;
|
|
43
|
+
headers: z.ZodArray<z.ZodString, "many">;
|
|
44
|
+
selectedColumns: z.ZodArray<z.ZodString, "many">;
|
|
45
|
+
mode: z.ZodEnum<["summary", "rows"]>;
|
|
46
|
+
previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
|
|
47
|
+
rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
|
|
48
|
+
warnings: z.ZodArray<z.ZodString, "many">;
|
|
49
|
+
reportRunId: z.ZodString;
|
|
50
|
+
}, "strip", z.ZodTypeAny, {
|
|
51
|
+
reportRunId: string;
|
|
52
|
+
fetchedAllRows: boolean;
|
|
53
|
+
timestamp: string;
|
|
54
|
+
mode: "summary" | "rows";
|
|
55
|
+
totalRows: number;
|
|
56
|
+
returnedRows: number;
|
|
57
|
+
truncated: boolean;
|
|
58
|
+
nextOffset: number | null;
|
|
59
|
+
headers: string[];
|
|
60
|
+
selectedColumns: string[];
|
|
61
|
+
warnings: string[];
|
|
62
|
+
nextCursor?: string | undefined;
|
|
63
|
+
rows?: Record<string, any>[] | undefined;
|
|
64
|
+
previewRows?: Record<string, any>[] | undefined;
|
|
65
|
+
}, {
|
|
66
|
+
reportRunId: string;
|
|
67
|
+
fetchedAllRows: boolean;
|
|
68
|
+
timestamp: string;
|
|
69
|
+
mode: "summary" | "rows";
|
|
70
|
+
totalRows: number;
|
|
71
|
+
returnedRows: number;
|
|
72
|
+
truncated: boolean;
|
|
73
|
+
nextOffset: number | null;
|
|
74
|
+
headers: string[];
|
|
75
|
+
selectedColumns: string[];
|
|
76
|
+
warnings: string[];
|
|
77
|
+
nextCursor?: string | undefined;
|
|
78
|
+
rows?: Record<string, any>[] | undefined;
|
|
79
|
+
previewRows?: Record<string, any>[] | undefined;
|
|
80
|
+
}>;
|
|
81
|
+
type DownloadReportInput = z.infer<typeof DownloadReportInputSchema>;
|
|
82
|
+
type DownloadReportOutput = z.infer<typeof DownloadReportOutputSchema>;
|
|
83
|
+
export declare function downloadReportLogic(input: DownloadReportInput, context: RequestContext, sdkContext?: SdkContext): Promise<DownloadReportOutput>;
|
|
84
|
+
export declare function downloadReportResponseFormatter(result: DownloadReportOutput): McpTextContent[];
|
|
85
|
+
export declare const downloadReportTool: {
|
|
86
|
+
name: string;
|
|
87
|
+
title: string;
|
|
88
|
+
description: string;
|
|
89
|
+
inputSchema: z.ZodObject<{
|
|
90
|
+
reportRunId: z.ZodString;
|
|
91
|
+
cursor: z.ZodOptional<z.ZodString>;
|
|
92
|
+
} & Omit<{
|
|
93
|
+
mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["summary", "rows"]>>>;
|
|
94
|
+
columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
95
|
+
offset: z.ZodOptional<z.ZodNumber>;
|
|
96
|
+
maxRows: z.ZodOptional<z.ZodNumber>;
|
|
97
|
+
aggregateBy: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
98
|
+
aggregateMetrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["sum", "avg", "count", "min", "max"]>>>;
|
|
99
|
+
}, "offset"> & {
|
|
100
|
+
includeComputedMetrics: z.ZodDefault<z.ZodBoolean>;
|
|
101
|
+
}, "strip", z.ZodTypeAny, {
|
|
102
|
+
reportRunId: string;
|
|
103
|
+
includeComputedMetrics: boolean;
|
|
104
|
+
mode: "summary" | "rows";
|
|
105
|
+
columns?: string[] | undefined;
|
|
106
|
+
maxRows?: number | undefined;
|
|
107
|
+
aggregateBy?: string[] | undefined;
|
|
108
|
+
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
109
|
+
cursor?: string | undefined;
|
|
110
|
+
}, {
|
|
111
|
+
reportRunId: string;
|
|
112
|
+
includeComputedMetrics?: boolean | undefined;
|
|
113
|
+
mode?: "summary" | "rows" | undefined;
|
|
114
|
+
columns?: string[] | undefined;
|
|
115
|
+
maxRows?: number | undefined;
|
|
116
|
+
aggregateBy?: string[] | undefined;
|
|
117
|
+
aggregateMetrics?: Record<string, "count" | "sum" | "avg" | "min" | "max"> | undefined;
|
|
118
|
+
cursor?: string | undefined;
|
|
119
|
+
}>;
|
|
120
|
+
outputSchema: z.ZodObject<{
|
|
121
|
+
fetchedAllRows: z.ZodBoolean;
|
|
122
|
+
nextCursor: z.ZodOptional<z.ZodString>;
|
|
123
|
+
timestamp: z.ZodString;
|
|
124
|
+
totalRows: z.ZodNumber;
|
|
125
|
+
returnedRows: z.ZodNumber;
|
|
126
|
+
truncated: z.ZodBoolean;
|
|
127
|
+
nextOffset: z.ZodNullable<z.ZodNumber>;
|
|
128
|
+
headers: z.ZodArray<z.ZodString, "many">;
|
|
129
|
+
selectedColumns: z.ZodArray<z.ZodString, "many">;
|
|
130
|
+
mode: z.ZodEnum<["summary", "rows"]>;
|
|
131
|
+
previewRows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
|
|
132
|
+
rows: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
|
|
133
|
+
warnings: z.ZodArray<z.ZodString, "many">;
|
|
134
|
+
reportRunId: z.ZodString;
|
|
135
|
+
}, "strip", z.ZodTypeAny, {
|
|
136
|
+
reportRunId: string;
|
|
137
|
+
fetchedAllRows: boolean;
|
|
138
|
+
timestamp: string;
|
|
139
|
+
mode: "summary" | "rows";
|
|
140
|
+
totalRows: number;
|
|
141
|
+
returnedRows: number;
|
|
142
|
+
truncated: boolean;
|
|
143
|
+
nextOffset: number | null;
|
|
144
|
+
headers: string[];
|
|
145
|
+
selectedColumns: string[];
|
|
146
|
+
warnings: string[];
|
|
147
|
+
nextCursor?: string | undefined;
|
|
148
|
+
rows?: Record<string, any>[] | undefined;
|
|
149
|
+
previewRows?: Record<string, any>[] | undefined;
|
|
150
|
+
}, {
|
|
151
|
+
reportRunId: string;
|
|
152
|
+
fetchedAllRows: boolean;
|
|
153
|
+
timestamp: string;
|
|
154
|
+
mode: "summary" | "rows";
|
|
155
|
+
totalRows: number;
|
|
156
|
+
returnedRows: number;
|
|
157
|
+
truncated: boolean;
|
|
158
|
+
nextOffset: number | null;
|
|
159
|
+
headers: string[];
|
|
160
|
+
selectedColumns: string[];
|
|
161
|
+
warnings: string[];
|
|
162
|
+
nextCursor?: string | undefined;
|
|
163
|
+
rows?: Record<string, any>[] | undefined;
|
|
164
|
+
previewRows?: Record<string, any>[] | undefined;
|
|
165
|
+
}>;
|
|
166
|
+
annotations: {
|
|
167
|
+
readOnlyHint: boolean;
|
|
168
|
+
openWorldHint: boolean;
|
|
169
|
+
destructiveHint: boolean;
|
|
170
|
+
idempotentHint: boolean;
|
|
171
|
+
};
|
|
172
|
+
inputExamples: {
|
|
173
|
+
label: string;
|
|
174
|
+
input: {
|
|
175
|
+
reportRunId: string;
|
|
176
|
+
mode: string;
|
|
177
|
+
};
|
|
178
|
+
}[];
|
|
179
|
+
logic: typeof downloadReportLogic;
|
|
180
|
+
responseFormatter: typeof downloadReportResponseFormatter;
|
|
181
|
+
};
|
|
182
|
+
export {};
|
|
183
|
+
//# sourceMappingURL=download-report.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"download-report.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/download-report.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAUnD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYuB,CAAC;AAE9D,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAeC,CAAC;AAEzC,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACrE,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEvE,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,oBAAoB,CAAC,CA4B/B;AAkBD,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,EAAE,CAY9F;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuB9B,CAAC"}
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
import { appendComputedMetricsToRows, ComputedMetricsFlagSchema, createReportView, formatReportViewResponse, getReportViewFetchLimit, ReportViewInputSchema, ReportViewOutputSchema, } from "@cesteral/shared";
|
|
4
|
+
const TOOL_NAME = "meta_download_report";
|
|
5
|
+
const TOOL_TITLE = "Download Meta Report Results";
|
|
6
|
+
const TOOL_DESCRIPTION = `Download results from a completed Meta Ads async insights report.
|
|
7
|
+
|
|
8
|
+
Only call this after \`meta_check_report_status\` returns \`isComplete: true\` (status "Job Succeeded").
|
|
9
|
+
|
|
10
|
+
Returns the insights data rows from the completed report run.`;
|
|
11
|
+
export const DownloadReportInputSchema = z
|
|
12
|
+
.object({
|
|
13
|
+
reportRunId: z.string().min(1).describe("Report run ID from meta_submit_report"),
|
|
14
|
+
cursor: z
|
|
15
|
+
.string()
|
|
16
|
+
.optional()
|
|
17
|
+
.describe("Meta paging cursor returned as nextCursor by a previous call. This tool pages via cursor; offset is not supported."),
|
|
18
|
+
})
|
|
19
|
+
.merge(ReportViewInputSchema.omit({ offset: true }))
|
|
20
|
+
.merge(ComputedMetricsFlagSchema)
|
|
21
|
+
.describe("Parameters for downloading Meta report results");
|
|
22
|
+
export const DownloadReportOutputSchema = z
|
|
23
|
+
.object({
|
|
24
|
+
reportRunId: z.string(),
|
|
25
|
+
...ReportViewOutputSchema.shape,
|
|
26
|
+
fetchedAllRows: z
|
|
27
|
+
.boolean()
|
|
28
|
+
.describe("Whether all available report rows were fetched. When false, totalRows is a lower bound and nextCursor should be used to continue."),
|
|
29
|
+
nextCursor: z
|
|
30
|
+
.string()
|
|
31
|
+
.optional()
|
|
32
|
+
.describe("Cursor for additional rows when maxRows capped the result set"),
|
|
33
|
+
timestamp: z.string().datetime(),
|
|
34
|
+
})
|
|
35
|
+
.describe("Downloaded report results");
|
|
36
|
+
export async function downloadReportLogic(input, context, sdkContext) {
|
|
37
|
+
const { metaInsightsService } = resolveSessionServices(sdkContext);
|
|
38
|
+
const result = await metaInsightsService.getReportResults(input.reportRunId, { limit: getReportViewFetchLimit(input), after: input.cursor }, context);
|
|
39
|
+
const rawRows = result.data;
|
|
40
|
+
const rows = input.includeComputedMetrics
|
|
41
|
+
? appendComputedMetricsToRows(rawRows.map(stringifyRow), META_COMPUTED_METRIC_ALIASES)
|
|
42
|
+
: rawRows;
|
|
43
|
+
const warnings = result.fetchedAllRows
|
|
44
|
+
? []
|
|
45
|
+
: ["More rows are available. Call again with cursor set to nextCursor to continue."];
|
|
46
|
+
return {
|
|
47
|
+
reportRunId: input.reportRunId,
|
|
48
|
+
...createReportView({
|
|
49
|
+
rows,
|
|
50
|
+
totalRows: rows.length + (result.fetchedAllRows ? 0 : 1),
|
|
51
|
+
input,
|
|
52
|
+
warnings,
|
|
53
|
+
}),
|
|
54
|
+
fetchedAllRows: result.fetchedAllRows,
|
|
55
|
+
nextCursor: result.nextCursor,
|
|
56
|
+
timestamp: new Date().toISOString(),
|
|
57
|
+
};
|
|
58
|
+
}
|
|
59
|
+
const META_COMPUTED_METRIC_ALIASES = {
|
|
60
|
+
cost: ["spend", "Spend"],
|
|
61
|
+
impressions: ["impressions", "Impressions"],
|
|
62
|
+
clicks: ["clicks", "Clicks", "inline_link_clicks"],
|
|
63
|
+
conversions: ["conversions", "actions", "Conversions"],
|
|
64
|
+
conversionValue: ["conversion_values", "action_values", "purchase_roas"],
|
|
65
|
+
};
|
|
66
|
+
function stringifyRow(row) {
|
|
67
|
+
const out = {};
|
|
68
|
+
for (const [k, v] of Object.entries(row)) {
|
|
69
|
+
out[k] = typeof v === "string" ? v : v == null ? "" : String(v);
|
|
70
|
+
}
|
|
71
|
+
return out;
|
|
72
|
+
}
|
|
73
|
+
export function downloadReportResponseFormatter(result) {
|
|
74
|
+
const summary = `Downloaded ${result.returnedRows} row(s) from report ${result.reportRunId}`;
|
|
75
|
+
const truncationNote = result.fetchedAllRows
|
|
76
|
+
? ""
|
|
77
|
+
: `\n\nResults were capped before the full report was exhausted.${result.nextCursor ? ` Continue from cursor: ${result.nextCursor}` : ""}`;
|
|
78
|
+
return [
|
|
79
|
+
{
|
|
80
|
+
type: "text",
|
|
81
|
+
text: `${summary}\n\n${formatReportViewResponse(result, "Report data")}${truncationNote}\n\nTimestamp: ${result.timestamp}`,
|
|
82
|
+
},
|
|
83
|
+
];
|
|
84
|
+
}
|
|
85
|
+
export const downloadReportTool = {
|
|
86
|
+
name: TOOL_NAME,
|
|
87
|
+
title: TOOL_TITLE,
|
|
88
|
+
description: TOOL_DESCRIPTION,
|
|
89
|
+
inputSchema: DownloadReportInputSchema,
|
|
90
|
+
outputSchema: DownloadReportOutputSchema,
|
|
91
|
+
annotations: {
|
|
92
|
+
readOnlyHint: true,
|
|
93
|
+
openWorldHint: false,
|
|
94
|
+
destructiveHint: false,
|
|
95
|
+
idempotentHint: true,
|
|
96
|
+
},
|
|
97
|
+
inputExamples: [
|
|
98
|
+
{
|
|
99
|
+
label: "Download results from a completed report",
|
|
100
|
+
input: {
|
|
101
|
+
reportRunId: "6082575495383",
|
|
102
|
+
mode: "summary",
|
|
103
|
+
},
|
|
104
|
+
},
|
|
105
|
+
],
|
|
106
|
+
logic: downloadReportLogic,
|
|
107
|
+
responseFormatter: downloadReportResponseFormatter,
|
|
108
|
+
};
|
|
109
|
+
//# sourceMappingURL=download-report.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"download-report.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/download-report.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent } from "@cesteral/shared";
|
|
3
|
+
import type { SdkContext } from "@cesteral/shared";
|
|
4
|
+
export declare const DuplicateEntityInputSchema: z.ZodObject<{
|
|
5
|
+
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
6
|
+
entityId: z.ZodString;
|
|
7
|
+
renameOptions: z.ZodOptional<z.ZodObject<{
|
|
8
|
+
prefix: z.ZodOptional<z.ZodString>;
|
|
9
|
+
suffix: z.ZodOptional<z.ZodString>;
|
|
10
|
+
}, "strip", z.ZodTypeAny, {
|
|
11
|
+
prefix?: string | undefined;
|
|
12
|
+
suffix?: string | undefined;
|
|
13
|
+
}, {
|
|
14
|
+
prefix?: string | undefined;
|
|
15
|
+
suffix?: string | undefined;
|
|
16
|
+
}>>;
|
|
17
|
+
statusOption: z.ZodOptional<z.ZodEnum<["ACTIVE", "PAUSED", "INHERITED"]>>;
|
|
18
|
+
}, "strip", z.ZodTypeAny, {
|
|
19
|
+
entityType: string;
|
|
20
|
+
entityId: string;
|
|
21
|
+
renameOptions?: {
|
|
22
|
+
prefix?: string | undefined;
|
|
23
|
+
suffix?: string | undefined;
|
|
24
|
+
} | undefined;
|
|
25
|
+
statusOption?: "ACTIVE" | "PAUSED" | "INHERITED" | undefined;
|
|
26
|
+
}, {
|
|
27
|
+
entityType: string;
|
|
28
|
+
entityId: string;
|
|
29
|
+
renameOptions?: {
|
|
30
|
+
prefix?: string | undefined;
|
|
31
|
+
suffix?: string | undefined;
|
|
32
|
+
} | undefined;
|
|
33
|
+
statusOption?: "ACTIVE" | "PAUSED" | "INHERITED" | undefined;
|
|
34
|
+
}>;
|
|
35
|
+
export declare const DuplicateEntityOutputSchema: z.ZodObject<{
|
|
36
|
+
result: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
37
|
+
timestamp: z.ZodString;
|
|
38
|
+
}, "strip", z.ZodTypeAny, {
|
|
39
|
+
timestamp: string;
|
|
40
|
+
result: Record<string, any>;
|
|
41
|
+
}, {
|
|
42
|
+
timestamp: string;
|
|
43
|
+
result: Record<string, any>;
|
|
44
|
+
}>;
|
|
45
|
+
type DuplicateEntityInput = z.infer<typeof DuplicateEntityInputSchema>;
|
|
46
|
+
type DuplicateEntityOutput = z.infer<typeof DuplicateEntityOutputSchema>;
|
|
47
|
+
export declare function duplicateEntityLogic(input: DuplicateEntityInput, context: RequestContext, sdkContext?: SdkContext): Promise<DuplicateEntityOutput>;
|
|
48
|
+
export declare function duplicateEntityResponseFormatter(result: DuplicateEntityOutput): McpTextContent[];
|
|
49
|
+
export declare const duplicateEntityTool: {
|
|
50
|
+
name: string;
|
|
51
|
+
title: string;
|
|
52
|
+
description: string;
|
|
53
|
+
inputSchema: z.ZodObject<{
|
|
54
|
+
entityType: z.ZodEnum<[string, ...string[]]>;
|
|
55
|
+
entityId: z.ZodString;
|
|
56
|
+
renameOptions: z.ZodOptional<z.ZodObject<{
|
|
57
|
+
prefix: z.ZodOptional<z.ZodString>;
|
|
58
|
+
suffix: z.ZodOptional<z.ZodString>;
|
|
59
|
+
}, "strip", z.ZodTypeAny, {
|
|
60
|
+
prefix?: string | undefined;
|
|
61
|
+
suffix?: string | undefined;
|
|
62
|
+
}, {
|
|
63
|
+
prefix?: string | undefined;
|
|
64
|
+
suffix?: string | undefined;
|
|
65
|
+
}>>;
|
|
66
|
+
statusOption: z.ZodOptional<z.ZodEnum<["ACTIVE", "PAUSED", "INHERITED"]>>;
|
|
67
|
+
}, "strip", z.ZodTypeAny, {
|
|
68
|
+
entityType: string;
|
|
69
|
+
entityId: string;
|
|
70
|
+
renameOptions?: {
|
|
71
|
+
prefix?: string | undefined;
|
|
72
|
+
suffix?: string | undefined;
|
|
73
|
+
} | undefined;
|
|
74
|
+
statusOption?: "ACTIVE" | "PAUSED" | "INHERITED" | undefined;
|
|
75
|
+
}, {
|
|
76
|
+
entityType: string;
|
|
77
|
+
entityId: string;
|
|
78
|
+
renameOptions?: {
|
|
79
|
+
prefix?: string | undefined;
|
|
80
|
+
suffix?: string | undefined;
|
|
81
|
+
} | undefined;
|
|
82
|
+
statusOption?: "ACTIVE" | "PAUSED" | "INHERITED" | undefined;
|
|
83
|
+
}>;
|
|
84
|
+
outputSchema: z.ZodObject<{
|
|
85
|
+
result: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
86
|
+
timestamp: z.ZodString;
|
|
87
|
+
}, "strip", z.ZodTypeAny, {
|
|
88
|
+
timestamp: string;
|
|
89
|
+
result: Record<string, any>;
|
|
90
|
+
}, {
|
|
91
|
+
timestamp: string;
|
|
92
|
+
result: Record<string, any>;
|
|
93
|
+
}>;
|
|
94
|
+
annotations: {
|
|
95
|
+
readOnlyHint: boolean;
|
|
96
|
+
openWorldHint: boolean;
|
|
97
|
+
idempotentHint: boolean;
|
|
98
|
+
destructiveHint: boolean;
|
|
99
|
+
};
|
|
100
|
+
inputExamples: {
|
|
101
|
+
label: string;
|
|
102
|
+
input: {
|
|
103
|
+
entityType: string;
|
|
104
|
+
entityId: string;
|
|
105
|
+
renameOptions: {
|
|
106
|
+
prefix: string;
|
|
107
|
+
};
|
|
108
|
+
statusOption: string;
|
|
109
|
+
};
|
|
110
|
+
}[];
|
|
111
|
+
logic: typeof duplicateEntityLogic;
|
|
112
|
+
responseFormatter: typeof duplicateEntityResponseFormatter;
|
|
113
|
+
};
|
|
114
|
+
export {};
|
|
115
|
+
//# sourceMappingURL=duplicate-entity.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"duplicate-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/duplicate-entity.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAgBnD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBoB,CAAC;AAE5D,eAAO,MAAM,2BAA2B;;;;;;;;;EAKA,CAAC;AAEzC,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AACvE,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEzE,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAgChC;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,EAAE,CAOhG;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyB/B,CAAC"}
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
import { getDuplicateEntityTypeEnum } from "../utils/entity-mapping.js";
|
|
4
|
+
const TOOL_NAME = "meta_duplicate_entity";
|
|
5
|
+
const TOOL_TITLE = "Duplicate Meta Ads Entity";
|
|
6
|
+
const TOOL_DESCRIPTION = `Duplicate a campaign, ad set, or ad via POST /{id}/copies.
|
|
7
|
+
|
|
8
|
+
**Supported entity types:** ${getDuplicateEntityTypeEnum().join(", ")}
|
|
9
|
+
|
|
10
|
+
Returns the new entity ID. Use meta_get_entity to fetch the full entity.
|
|
11
|
+
|
|
12
|
+
**Options:**
|
|
13
|
+
- \`rename_options\`: { prefix, suffix } for naming the copy
|
|
14
|
+
- \`status_option\`: ACTIVE, PAUSED, or INHERITED
|
|
15
|
+
|
|
16
|
+
**Note:** Effective 2026-05-19 Meta blocks \`/copies\` for Advantage+ Shopping and Advantage+ App campaigns (Marketing API v25.0). Use the standard Advantage+ campaign structure for those objectives instead.`;
|
|
17
|
+
export const DuplicateEntityInputSchema = z
|
|
18
|
+
.object({
|
|
19
|
+
entityType: z.enum(getDuplicateEntityTypeEnum()).describe("Type of entity to duplicate"),
|
|
20
|
+
entityId: z.string().min(1).describe("ID of the entity to duplicate"),
|
|
21
|
+
renameOptions: z
|
|
22
|
+
.object({
|
|
23
|
+
prefix: z.string().optional(),
|
|
24
|
+
suffix: z.string().optional(),
|
|
25
|
+
})
|
|
26
|
+
.optional()
|
|
27
|
+
.describe("Naming options for the copy"),
|
|
28
|
+
statusOption: z
|
|
29
|
+
.enum(["ACTIVE", "PAUSED", "INHERITED"])
|
|
30
|
+
.optional()
|
|
31
|
+
.describe("Status for the copy (default: PAUSED)"),
|
|
32
|
+
})
|
|
33
|
+
.describe("Parameters for duplicating a Meta Ads entity");
|
|
34
|
+
export const DuplicateEntityOutputSchema = z
|
|
35
|
+
.object({
|
|
36
|
+
result: z.record(z.any()).describe("Duplication result (includes new entity ID)"),
|
|
37
|
+
timestamp: z.string().datetime(),
|
|
38
|
+
})
|
|
39
|
+
.describe("Entity duplication result");
|
|
40
|
+
export async function duplicateEntityLogic(input, context, sdkContext) {
|
|
41
|
+
const { metaService } = resolveSessionServices(sdkContext);
|
|
42
|
+
const options = {};
|
|
43
|
+
if (input.renameOptions) {
|
|
44
|
+
const renameOptions = {};
|
|
45
|
+
if (input.renameOptions.prefix) {
|
|
46
|
+
renameOptions.rename_prefix = input.renameOptions.prefix;
|
|
47
|
+
}
|
|
48
|
+
if (input.renameOptions.suffix) {
|
|
49
|
+
renameOptions.rename_suffix = input.renameOptions.suffix;
|
|
50
|
+
}
|
|
51
|
+
if (Object.keys(renameOptions).length > 0) {
|
|
52
|
+
options.rename_options = renameOptions;
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
if (input.statusOption) {
|
|
56
|
+
options.status_option = input.statusOption;
|
|
57
|
+
}
|
|
58
|
+
const result = await metaService.duplicateEntity(input.entityId, Object.keys(options).length > 0 ? options : undefined, context);
|
|
59
|
+
return {
|
|
60
|
+
result: result,
|
|
61
|
+
timestamp: new Date().toISOString(),
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
export function duplicateEntityResponseFormatter(result) {
|
|
65
|
+
return [
|
|
66
|
+
{
|
|
67
|
+
type: "text",
|
|
68
|
+
text: `Entity duplicated successfully\n${JSON.stringify(result.result, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
69
|
+
},
|
|
70
|
+
];
|
|
71
|
+
}
|
|
72
|
+
export const duplicateEntityTool = {
|
|
73
|
+
name: TOOL_NAME,
|
|
74
|
+
title: TOOL_TITLE,
|
|
75
|
+
description: TOOL_DESCRIPTION,
|
|
76
|
+
inputSchema: DuplicateEntityInputSchema,
|
|
77
|
+
outputSchema: DuplicateEntityOutputSchema,
|
|
78
|
+
annotations: {
|
|
79
|
+
readOnlyHint: false,
|
|
80
|
+
openWorldHint: false,
|
|
81
|
+
idempotentHint: false,
|
|
82
|
+
destructiveHint: true,
|
|
83
|
+
},
|
|
84
|
+
inputExamples: [
|
|
85
|
+
{
|
|
86
|
+
label: "Duplicate a campaign with prefix",
|
|
87
|
+
input: {
|
|
88
|
+
entityType: "campaign",
|
|
89
|
+
entityId: "23456789012345",
|
|
90
|
+
renameOptions: { prefix: "Copy of " },
|
|
91
|
+
statusOption: "PAUSED",
|
|
92
|
+
},
|
|
93
|
+
},
|
|
94
|
+
],
|
|
95
|
+
logic: duplicateEntityLogic,
|
|
96
|
+
responseFormatter: duplicateEntityResponseFormatter,
|
|
97
|
+
};
|
|
98
|
+
//# sourceMappingURL=duplicate-entity.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"duplicate-entity.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/duplicate-entity.tool.ts"],"names":[],"mappings":"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"}
|