@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,69 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent } from "@cesteral/shared";
|
|
3
|
+
import type { SdkContext } from "@cesteral/shared";
|
|
4
|
+
export declare const GetAdPreviewInputSchema: z.ZodObject<{
|
|
5
|
+
adId: z.ZodString;
|
|
6
|
+
adFormat: z.ZodString;
|
|
7
|
+
}, "strip", z.ZodTypeAny, {
|
|
8
|
+
adId: string;
|
|
9
|
+
adFormat: string;
|
|
10
|
+
}, {
|
|
11
|
+
adId: string;
|
|
12
|
+
adFormat: string;
|
|
13
|
+
}>;
|
|
14
|
+
export declare const GetAdPreviewOutputSchema: z.ZodObject<{
|
|
15
|
+
previews: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
|
|
16
|
+
timestamp: z.ZodString;
|
|
17
|
+
}, "strip", z.ZodTypeAny, {
|
|
18
|
+
timestamp: string;
|
|
19
|
+
previews: Record<string, any>[];
|
|
20
|
+
}, {
|
|
21
|
+
timestamp: string;
|
|
22
|
+
previews: Record<string, any>[];
|
|
23
|
+
}>;
|
|
24
|
+
type GetAdPreviewInput = z.infer<typeof GetAdPreviewInputSchema>;
|
|
25
|
+
type GetAdPreviewOutput = z.infer<typeof GetAdPreviewOutputSchema>;
|
|
26
|
+
export declare function getAdPreviewLogic(input: GetAdPreviewInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetAdPreviewOutput>;
|
|
27
|
+
export declare function getAdPreviewResponseFormatter(result: GetAdPreviewOutput): McpTextContent[];
|
|
28
|
+
export declare const getAdPreviewTool: {
|
|
29
|
+
name: string;
|
|
30
|
+
title: string;
|
|
31
|
+
description: string;
|
|
32
|
+
inputSchema: z.ZodObject<{
|
|
33
|
+
adId: z.ZodString;
|
|
34
|
+
adFormat: z.ZodString;
|
|
35
|
+
}, "strip", z.ZodTypeAny, {
|
|
36
|
+
adId: string;
|
|
37
|
+
adFormat: string;
|
|
38
|
+
}, {
|
|
39
|
+
adId: string;
|
|
40
|
+
adFormat: string;
|
|
41
|
+
}>;
|
|
42
|
+
outputSchema: z.ZodObject<{
|
|
43
|
+
previews: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
|
|
44
|
+
timestamp: z.ZodString;
|
|
45
|
+
}, "strip", z.ZodTypeAny, {
|
|
46
|
+
timestamp: string;
|
|
47
|
+
previews: Record<string, any>[];
|
|
48
|
+
}, {
|
|
49
|
+
timestamp: string;
|
|
50
|
+
previews: Record<string, any>[];
|
|
51
|
+
}>;
|
|
52
|
+
annotations: {
|
|
53
|
+
readOnlyHint: boolean;
|
|
54
|
+
openWorldHint: boolean;
|
|
55
|
+
idempotentHint: boolean;
|
|
56
|
+
destructiveHint: boolean;
|
|
57
|
+
};
|
|
58
|
+
inputExamples: {
|
|
59
|
+
label: string;
|
|
60
|
+
input: {
|
|
61
|
+
adId: string;
|
|
62
|
+
adFormat: string;
|
|
63
|
+
};
|
|
64
|
+
}[];
|
|
65
|
+
logic: typeof getAdPreviewLogic;
|
|
66
|
+
responseFormatter: typeof getAdPreviewResponseFormatter;
|
|
67
|
+
};
|
|
68
|
+
export {};
|
|
69
|
+
//# sourceMappingURL=get-ad-preview.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-ad-preview.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ad-preview.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAUnD,eAAO,MAAM,uBAAuB;;;;;;;;;EAKY,CAAC;AAEjD,eAAO,MAAM,wBAAwB;;;;;;;;;EAKL,CAAC;AAEjC,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEnE,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAW7B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAO1F;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuB5B,CAAC"}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
const TOOL_NAME = "meta_get_ad_preview";
|
|
4
|
+
const TOOL_TITLE = "Get Meta Ad Preview";
|
|
5
|
+
const TOOL_DESCRIPTION = `Get preview HTML for an ad in a specific format.
|
|
6
|
+
|
|
7
|
+
Returns temporary HTML iframe content showing how the ad will appear.
|
|
8
|
+
|
|
9
|
+
**Common ad formats:** DESKTOP_FEED_STANDARD, MOBILE_FEED_STANDARD, INSTAGRAM_STANDARD, RIGHT_COLUMN_STANDARD, AUDIENCE_NETWORK_INSTREAM_VIDEO, MARKETPLACE_MOBILE`;
|
|
10
|
+
export const GetAdPreviewInputSchema = z
|
|
11
|
+
.object({
|
|
12
|
+
adId: z.string().min(1).describe("Ad ID to preview"),
|
|
13
|
+
adFormat: z.string().describe("Ad format (e.g., DESKTOP_FEED_STANDARD, MOBILE_FEED_STANDARD)"),
|
|
14
|
+
})
|
|
15
|
+
.describe("Parameters for getting ad preview");
|
|
16
|
+
export const GetAdPreviewOutputSchema = z
|
|
17
|
+
.object({
|
|
18
|
+
previews: z.array(z.record(z.any())).describe("Preview data (includes iframe HTML)"),
|
|
19
|
+
timestamp: z.string().datetime(),
|
|
20
|
+
})
|
|
21
|
+
.describe("Ad preview result");
|
|
22
|
+
export async function getAdPreviewLogic(input, context, sdkContext) {
|
|
23
|
+
const { metaService } = resolveSessionServices(sdkContext);
|
|
24
|
+
const result = await metaService.getAdPreviews(input.adId, input.adFormat, context);
|
|
25
|
+
const data = result?.data || [];
|
|
26
|
+
return {
|
|
27
|
+
previews: data,
|
|
28
|
+
timestamp: new Date().toISOString(),
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
export function getAdPreviewResponseFormatter(result) {
|
|
32
|
+
return [
|
|
33
|
+
{
|
|
34
|
+
type: "text",
|
|
35
|
+
text: `Ad preview(s):\n${JSON.stringify(result.previews, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
36
|
+
},
|
|
37
|
+
];
|
|
38
|
+
}
|
|
39
|
+
export const getAdPreviewTool = {
|
|
40
|
+
name: TOOL_NAME,
|
|
41
|
+
title: TOOL_TITLE,
|
|
42
|
+
description: TOOL_DESCRIPTION,
|
|
43
|
+
inputSchema: GetAdPreviewInputSchema,
|
|
44
|
+
outputSchema: GetAdPreviewOutputSchema,
|
|
45
|
+
annotations: {
|
|
46
|
+
readOnlyHint: true,
|
|
47
|
+
openWorldHint: false,
|
|
48
|
+
idempotentHint: true,
|
|
49
|
+
destructiveHint: false,
|
|
50
|
+
},
|
|
51
|
+
inputExamples: [
|
|
52
|
+
{
|
|
53
|
+
label: "Preview an ad in desktop feed format",
|
|
54
|
+
input: {
|
|
55
|
+
adId: "23456789012345",
|
|
56
|
+
adFormat: "DESKTOP_FEED_STANDARD",
|
|
57
|
+
},
|
|
58
|
+
},
|
|
59
|
+
],
|
|
60
|
+
logic: getAdPreviewLogic,
|
|
61
|
+
responseFormatter: getAdPreviewResponseFormatter,
|
|
62
|
+
};
|
|
63
|
+
//# sourceMappingURL=get-ad-preview.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-ad-preview.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ad-preview.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAIrE,MAAM,SAAS,GAAG,qBAAqB,CAAC;AACxC,MAAM,UAAU,GAAG,qBAAqB,CAAC;AACzC,MAAM,gBAAgB,GAAG;;;;mKAI0I,CAAC;AAEpK,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACpD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;CAC/F,CAAC;KACD,QAAQ,CAAC,mCAAmC,CAAC,CAAC;AAEjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACpF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,mBAAmB,CAAC,CAAC;AAKjC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAwB,EACxB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,WAAW,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE3D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEpF,MAAM,IAAI,GAAK,MAAkC,EAAE,IAAkB,IAAI,EAAE,CAAC;IAE5E,OAAO;QACL,QAAQ,EAAE,IAAiC;QAC3C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAA0B;IACtE,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,mBAAmB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACtG;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,wBAAwB;IACtC,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,KAAK;KACvB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,sCAAsC;YAC7C,KAAK,EAAE;gBACL,IAAI,EAAE,gBAAgB;gBACtB,QAAQ,EAAE,uBAAuB;aAClC;SACF;KACF;IACD,KAAK,EAAE,iBAAiB;IACxB,iBAAiB,EAAE,6BAA6B;CACjD,CAAC"}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext } from "@cesteral/shared";
|
|
3
|
+
import type { SdkContext } from "../../../types-global/mcp.js";
|
|
4
|
+
export declare const GetAdPreviewsInputSchema: z.ZodObject<{
|
|
5
|
+
adId: z.ZodString;
|
|
6
|
+
adFormat: z.ZodString;
|
|
7
|
+
}, "strip", z.ZodTypeAny, {
|
|
8
|
+
adId: string;
|
|
9
|
+
adFormat: string;
|
|
10
|
+
}, {
|
|
11
|
+
adId: string;
|
|
12
|
+
adFormat: string;
|
|
13
|
+
}>;
|
|
14
|
+
export declare const GetAdPreviewsOutputSchema: z.ZodObject<{
|
|
15
|
+
previews: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
|
|
16
|
+
timestamp: z.ZodString;
|
|
17
|
+
}, "strip", z.ZodTypeAny, {
|
|
18
|
+
timestamp: string;
|
|
19
|
+
previews: Record<string, any>[];
|
|
20
|
+
}, {
|
|
21
|
+
timestamp: string;
|
|
22
|
+
previews: Record<string, any>[];
|
|
23
|
+
}>;
|
|
24
|
+
type GetAdPreviewsInput = z.infer<typeof GetAdPreviewsInputSchema>;
|
|
25
|
+
type GetAdPreviewsOutput = z.infer<typeof GetAdPreviewsOutputSchema>;
|
|
26
|
+
export declare function getAdPreviewsLogic(input: GetAdPreviewsInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetAdPreviewsOutput>;
|
|
27
|
+
export declare function getAdPreviewsResponseFormatter(result: GetAdPreviewsOutput): unknown[];
|
|
28
|
+
export declare const getAdPreviewsTool: {
|
|
29
|
+
name: string;
|
|
30
|
+
title: string;
|
|
31
|
+
description: string;
|
|
32
|
+
inputSchema: z.ZodObject<{
|
|
33
|
+
adId: z.ZodString;
|
|
34
|
+
adFormat: z.ZodString;
|
|
35
|
+
}, "strip", z.ZodTypeAny, {
|
|
36
|
+
adId: string;
|
|
37
|
+
adFormat: string;
|
|
38
|
+
}, {
|
|
39
|
+
adId: string;
|
|
40
|
+
adFormat: string;
|
|
41
|
+
}>;
|
|
42
|
+
outputSchema: z.ZodObject<{
|
|
43
|
+
previews: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">;
|
|
44
|
+
timestamp: z.ZodString;
|
|
45
|
+
}, "strip", z.ZodTypeAny, {
|
|
46
|
+
timestamp: string;
|
|
47
|
+
previews: Record<string, any>[];
|
|
48
|
+
}, {
|
|
49
|
+
timestamp: string;
|
|
50
|
+
previews: Record<string, any>[];
|
|
51
|
+
}>;
|
|
52
|
+
annotations: {
|
|
53
|
+
readOnlyHint: boolean;
|
|
54
|
+
openWorldHint: boolean;
|
|
55
|
+
idempotentHint: boolean;
|
|
56
|
+
destructiveHint: boolean;
|
|
57
|
+
};
|
|
58
|
+
inputExamples: {
|
|
59
|
+
label: string;
|
|
60
|
+
input: {
|
|
61
|
+
adId: string;
|
|
62
|
+
adFormat: string;
|
|
63
|
+
};
|
|
64
|
+
}[];
|
|
65
|
+
logic: typeof getAdPreviewsLogic;
|
|
66
|
+
responseFormatter: typeof getAdPreviewsResponseFormatter;
|
|
67
|
+
};
|
|
68
|
+
export {};
|
|
69
|
+
//# sourceMappingURL=get-ad-previews.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-ad-previews.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ad-previews.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAU/D,eAAO,MAAM,wBAAwB;;;;;;;;;EAUY,CAAC;AAElD,eAAO,MAAM,yBAAyB;;;;;;;;;EAKN,CAAC;AAEjC,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AACnE,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAErE,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAe9B;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,EAAE,CAOrF;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuB7B,CAAC"}
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
const TOOL_NAME = "meta_get_ad_previews";
|
|
4
|
+
const TOOL_TITLE = "Get Meta Ad Previews";
|
|
5
|
+
const TOOL_DESCRIPTION = `Get preview HTML for an ad in a specific format.
|
|
6
|
+
|
|
7
|
+
Returns temporary HTML iframe content showing how the ad will appear.
|
|
8
|
+
|
|
9
|
+
**Common ad formats:** DESKTOP_FEED_STANDARD, MOBILE_FEED_STANDARD, INSTAGRAM_STANDARD, RIGHT_COLUMN_STANDARD, AUDIENCE_NETWORK_INSTREAM_VIDEO, MARKETPLACE_MOBILE`;
|
|
10
|
+
export const GetAdPreviewsInputSchema = z
|
|
11
|
+
.object({
|
|
12
|
+
adId: z
|
|
13
|
+
.string()
|
|
14
|
+
.min(1)
|
|
15
|
+
.describe("Ad ID to preview"),
|
|
16
|
+
adFormat: z
|
|
17
|
+
.string()
|
|
18
|
+
.describe("Ad format (e.g., DESKTOP_FEED_STANDARD, MOBILE_FEED_STANDARD)"),
|
|
19
|
+
})
|
|
20
|
+
.describe("Parameters for getting ad previews");
|
|
21
|
+
export const GetAdPreviewsOutputSchema = z
|
|
22
|
+
.object({
|
|
23
|
+
previews: z.array(z.record(z.any())).describe("Preview data (includes iframe HTML)"),
|
|
24
|
+
timestamp: z.string().datetime(),
|
|
25
|
+
})
|
|
26
|
+
.describe("Ad preview result");
|
|
27
|
+
export async function getAdPreviewsLogic(input, context, sdkContext) {
|
|
28
|
+
const { metaService } = resolveSessionServices(sdkContext);
|
|
29
|
+
const result = await metaService.getAdPreviews(input.adId, input.adFormat, context);
|
|
30
|
+
const data = result?.data || [];
|
|
31
|
+
return {
|
|
32
|
+
previews: data,
|
|
33
|
+
timestamp: new Date().toISOString(),
|
|
34
|
+
};
|
|
35
|
+
}
|
|
36
|
+
export function getAdPreviewsResponseFormatter(result) {
|
|
37
|
+
return [
|
|
38
|
+
{
|
|
39
|
+
type: "text",
|
|
40
|
+
text: `Ad preview(s):\n${JSON.stringify(result.previews, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
41
|
+
},
|
|
42
|
+
];
|
|
43
|
+
}
|
|
44
|
+
export const getAdPreviewsTool = {
|
|
45
|
+
name: TOOL_NAME,
|
|
46
|
+
title: TOOL_TITLE,
|
|
47
|
+
description: TOOL_DESCRIPTION,
|
|
48
|
+
inputSchema: GetAdPreviewsInputSchema,
|
|
49
|
+
outputSchema: GetAdPreviewsOutputSchema,
|
|
50
|
+
annotations: {
|
|
51
|
+
readOnlyHint: true,
|
|
52
|
+
openWorldHint: false,
|
|
53
|
+
idempotentHint: true,
|
|
54
|
+
destructiveHint: false,
|
|
55
|
+
},
|
|
56
|
+
inputExamples: [
|
|
57
|
+
{
|
|
58
|
+
label: "Preview an ad in desktop feed format",
|
|
59
|
+
input: {
|
|
60
|
+
adId: "23456789012345",
|
|
61
|
+
adFormat: "DESKTOP_FEED_STANDARD",
|
|
62
|
+
},
|
|
63
|
+
},
|
|
64
|
+
],
|
|
65
|
+
logic: getAdPreviewsLogic,
|
|
66
|
+
responseFormatter: getAdPreviewsResponseFormatter,
|
|
67
|
+
};
|
|
68
|
+
//# sourceMappingURL=get-ad-previews.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-ad-previews.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ad-previews.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAIrE,MAAM,SAAS,GAAG,sBAAsB,CAAC;AACzC,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAC1C,MAAM,gBAAgB,GAAG;;;;mKAI0I,CAAC;AAEpK,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,kBAAkB,CAAC;IAC/B,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,+DAA+D,CAAC;CAC7E,CAAC;KACD,QAAQ,CAAC,oCAAoC,CAAC,CAAC;AAElD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACpF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,mBAAmB,CAAC,CAAC;AAKjC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAyB,EACzB,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,WAAW,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE3D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,aAAa,CAC5C,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,QAAQ,EACd,OAAO,CACR,CAAC;IAEF,MAAM,IAAI,GAAI,MAAkC,EAAE,IAAiB,IAAI,EAAE,CAAC;IAE1E,OAAO;QACL,QAAQ,EAAE,IAAiC;QAC3C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAA2B;IACxE,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,mBAAmB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SACtG;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,yBAAyB;IACvC,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,KAAK;KACvB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,sCAAsC;YAC7C,KAAK,EAAE;gBACL,IAAI,EAAE,gBAAgB;gBACtB,QAAQ,EAAE,uBAAuB;aAClC;SACF;KACF;IACD,KAAK,EAAE,kBAAkB;IACzB,iBAAiB,EAAE,8BAA8B;CAClD,CAAC"}
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { McpTextContent, RequestContext } from "@cesteral/shared";
|
|
3
|
+
import type { SdkContext } from "@cesteral/shared";
|
|
4
|
+
export declare const GetAvailableMetricsInputSchema: z.ZodObject<{
|
|
5
|
+
level: z.ZodOptional<z.ZodEnum<["account", "campaign", "adset", "ad"]>>;
|
|
6
|
+
}, "strip", z.ZodTypeAny, {
|
|
7
|
+
level?: "campaign" | "ad" | "account" | "adset" | undefined;
|
|
8
|
+
}, {
|
|
9
|
+
level?: "campaign" | "ad" | "account" | "adset" | undefined;
|
|
10
|
+
}>;
|
|
11
|
+
export declare const GetAvailableMetricsOutputSchema: z.ZodObject<{
|
|
12
|
+
level: z.ZodNullable<z.ZodString>;
|
|
13
|
+
metrics: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>;
|
|
14
|
+
breakdowns: z.ZodArray<z.ZodString, "many">;
|
|
15
|
+
actionBreakdowns: z.ZodArray<z.ZodString, "many">;
|
|
16
|
+
notes: z.ZodArray<z.ZodString, "many">;
|
|
17
|
+
timestamp: z.ZodString;
|
|
18
|
+
}, "strip", z.ZodTypeAny, {
|
|
19
|
+
level: string | null;
|
|
20
|
+
breakdowns: string[];
|
|
21
|
+
timestamp: string;
|
|
22
|
+
metrics: Record<string, string[]>;
|
|
23
|
+
actionBreakdowns: string[];
|
|
24
|
+
notes: string[];
|
|
25
|
+
}, {
|
|
26
|
+
level: string | null;
|
|
27
|
+
breakdowns: string[];
|
|
28
|
+
timestamp: string;
|
|
29
|
+
metrics: Record<string, string[]>;
|
|
30
|
+
actionBreakdowns: string[];
|
|
31
|
+
notes: string[];
|
|
32
|
+
}>;
|
|
33
|
+
type GetAvailableMetricsInput = z.infer<typeof GetAvailableMetricsInputSchema>;
|
|
34
|
+
type GetAvailableMetricsOutput = z.infer<typeof GetAvailableMetricsOutputSchema>;
|
|
35
|
+
export declare function getAvailableMetricsLogic(input: GetAvailableMetricsInput, _context: RequestContext, _sdkContext?: SdkContext): Promise<GetAvailableMetricsOutput>;
|
|
36
|
+
export declare function getAvailableMetricsResponseFormatter(result: GetAvailableMetricsOutput): McpTextContent[];
|
|
37
|
+
export declare const getAvailableMetricsTool: {
|
|
38
|
+
name: string;
|
|
39
|
+
title: string;
|
|
40
|
+
description: string;
|
|
41
|
+
inputSchema: z.ZodObject<{
|
|
42
|
+
level: z.ZodOptional<z.ZodEnum<["account", "campaign", "adset", "ad"]>>;
|
|
43
|
+
}, "strip", z.ZodTypeAny, {
|
|
44
|
+
level?: "campaign" | "ad" | "account" | "adset" | undefined;
|
|
45
|
+
}, {
|
|
46
|
+
level?: "campaign" | "ad" | "account" | "adset" | undefined;
|
|
47
|
+
}>;
|
|
48
|
+
outputSchema: z.ZodObject<{
|
|
49
|
+
level: z.ZodNullable<z.ZodString>;
|
|
50
|
+
metrics: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>;
|
|
51
|
+
breakdowns: z.ZodArray<z.ZodString, "many">;
|
|
52
|
+
actionBreakdowns: z.ZodArray<z.ZodString, "many">;
|
|
53
|
+
notes: z.ZodArray<z.ZodString, "many">;
|
|
54
|
+
timestamp: z.ZodString;
|
|
55
|
+
}, "strip", z.ZodTypeAny, {
|
|
56
|
+
level: string | null;
|
|
57
|
+
breakdowns: string[];
|
|
58
|
+
timestamp: string;
|
|
59
|
+
metrics: Record<string, string[]>;
|
|
60
|
+
actionBreakdowns: string[];
|
|
61
|
+
notes: string[];
|
|
62
|
+
}, {
|
|
63
|
+
level: string | null;
|
|
64
|
+
breakdowns: string[];
|
|
65
|
+
timestamp: string;
|
|
66
|
+
metrics: Record<string, string[]>;
|
|
67
|
+
actionBreakdowns: string[];
|
|
68
|
+
notes: string[];
|
|
69
|
+
}>;
|
|
70
|
+
annotations: {
|
|
71
|
+
readOnlyHint: boolean;
|
|
72
|
+
openWorldHint: boolean;
|
|
73
|
+
destructiveHint: boolean;
|
|
74
|
+
idempotentHint: boolean;
|
|
75
|
+
};
|
|
76
|
+
inputExamples: ({
|
|
77
|
+
label: string;
|
|
78
|
+
input: {
|
|
79
|
+
level?: undefined;
|
|
80
|
+
};
|
|
81
|
+
} | {
|
|
82
|
+
label: string;
|
|
83
|
+
input: {
|
|
84
|
+
level: string;
|
|
85
|
+
};
|
|
86
|
+
})[];
|
|
87
|
+
logic: typeof getAvailableMetricsLogic;
|
|
88
|
+
responseFormatter: typeof getAvailableMetricsResponseFormatter;
|
|
89
|
+
};
|
|
90
|
+
export {};
|
|
91
|
+
//# sourceMappingURL=get-available-metrics.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-available-metrics.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-available-metrics.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA0BnD,eAAO,MAAM,8BAA8B;;;;;;EASyB,CAAC;AAErE,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;EAcF,CAAC;AAE3C,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAC/E,KAAK,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAEjF,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,wBAAwB,EAC/B,QAAQ,EAAE,cAAc,EACxB,WAAW,CAAC,EAAE,UAAU,GACvB,OAAO,CAAC,yBAAyB,CAAC,CASpC;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,yBAAyB,GAChC,cAAc,EAAE,CAYlB;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBnC,CAAC"}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import catalogJson from "../../../config/insights-catalog.json" with { type: "json" };
|
|
3
|
+
const TOOL_NAME = "meta_get_available_metrics";
|
|
4
|
+
const TOOL_TITLE = "Get Meta Available Metrics & Breakdowns";
|
|
5
|
+
const TOOL_DESCRIPTION = `List the Meta Marketing API Insights metrics, breakdowns, and action breakdowns available for a given entity level.
|
|
6
|
+
|
|
7
|
+
Use this before calling \`meta_get_insights\` or \`meta_get_insights_breakdowns\` to discover valid field names.
|
|
8
|
+
|
|
9
|
+
**levels:** account, campaign, adset, ad — the entity level you plan to report on.
|
|
10
|
+
|
|
11
|
+
The response groups metrics by semantic category (delivery, engagement, video, conversions, attribution, quality, other) so you can quickly pick the fields that match what you care about. Breakdowns and action breakdowns are returned as flat lists.
|
|
12
|
+
|
|
13
|
+
**Source:** Meta Marketing API v24.0+ static catalog, seeded from Meta's public docs. Call the live field-introspection endpoint for the authoritative current list.`;
|
|
14
|
+
const catalog = catalogJson;
|
|
15
|
+
export const GetAvailableMetricsInputSchema = z
|
|
16
|
+
.object({
|
|
17
|
+
level: z
|
|
18
|
+
.enum(["account", "campaign", "adset", "ad"])
|
|
19
|
+
.optional()
|
|
20
|
+
.describe("Entity level you plan to report on. Currently the catalog is identical across levels; the parameter is retained so callers can adopt level-specific filtering in a future revision without a breaking change."),
|
|
21
|
+
})
|
|
22
|
+
.describe("Parameters for listing available Meta insights fields");
|
|
23
|
+
export const GetAvailableMetricsOutputSchema = z
|
|
24
|
+
.object({
|
|
25
|
+
level: z
|
|
26
|
+
.string()
|
|
27
|
+
.nullable()
|
|
28
|
+
.describe("Level the response was scoped to (null when not provided)"),
|
|
29
|
+
metrics: z
|
|
30
|
+
.record(z.array(z.string()))
|
|
31
|
+
.describe("Metric field names grouped by semantic category"),
|
|
32
|
+
breakdowns: z.array(z.string()).describe("Valid `breakdowns` values"),
|
|
33
|
+
actionBreakdowns: z.array(z.string()).describe("Valid `action_breakdowns` values"),
|
|
34
|
+
notes: z.array(z.string()).describe("Catalog caveats worth surfacing to the model"),
|
|
35
|
+
timestamp: z.string().datetime(),
|
|
36
|
+
})
|
|
37
|
+
.describe("Meta insights field catalog");
|
|
38
|
+
export async function getAvailableMetricsLogic(input, _context, _sdkContext) {
|
|
39
|
+
return {
|
|
40
|
+
level: input.level ?? null,
|
|
41
|
+
metrics: catalog.metrics,
|
|
42
|
+
breakdowns: catalog.breakdowns,
|
|
43
|
+
actionBreakdowns: catalog.actionBreakdowns,
|
|
44
|
+
notes: catalog.notes,
|
|
45
|
+
timestamp: new Date().toISOString(),
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
export function getAvailableMetricsResponseFormatter(result) {
|
|
49
|
+
const metricLines = Object.entries(result.metrics)
|
|
50
|
+
.map(([group, list]) => `${group} (${list.length}):\n ${list.join(", ")}`)
|
|
51
|
+
.join("\n\n");
|
|
52
|
+
const text = `Meta insights catalog${result.level ? ` (level=${result.level})` : ""}\n\n` +
|
|
53
|
+
`Metrics by group:\n${metricLines}\n\n` +
|
|
54
|
+
`Breakdowns (${result.breakdowns.length}): ${result.breakdowns.join(", ")}\n\n` +
|
|
55
|
+
`Action breakdowns (${result.actionBreakdowns.length}): ${result.actionBreakdowns.join(", ")}\n\n` +
|
|
56
|
+
(result.notes.length > 0 ? `Notes:\n- ${result.notes.join("\n- ")}\n\n` : "") +
|
|
57
|
+
`Timestamp: ${result.timestamp}`;
|
|
58
|
+
return [{ type: "text", text }];
|
|
59
|
+
}
|
|
60
|
+
export const getAvailableMetricsTool = {
|
|
61
|
+
name: TOOL_NAME,
|
|
62
|
+
title: TOOL_TITLE,
|
|
63
|
+
description: TOOL_DESCRIPTION,
|
|
64
|
+
inputSchema: GetAvailableMetricsInputSchema,
|
|
65
|
+
outputSchema: GetAvailableMetricsOutputSchema,
|
|
66
|
+
annotations: {
|
|
67
|
+
readOnlyHint: true,
|
|
68
|
+
openWorldHint: false,
|
|
69
|
+
destructiveHint: false,
|
|
70
|
+
idempotentHint: true,
|
|
71
|
+
},
|
|
72
|
+
inputExamples: [
|
|
73
|
+
{
|
|
74
|
+
label: "List all available metrics",
|
|
75
|
+
input: {},
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
label: "Scope the catalog to campaign-level reporting",
|
|
79
|
+
input: { level: "campaign" },
|
|
80
|
+
},
|
|
81
|
+
],
|
|
82
|
+
logic: getAvailableMetricsLogic,
|
|
83
|
+
responseFormatter: getAvailableMetricsResponseFormatter,
|
|
84
|
+
};
|
|
85
|
+
//# sourceMappingURL=get-available-metrics.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-available-metrics.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-available-metrics.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import type { RequestContext, McpTextContent } from "@cesteral/shared";
|
|
3
|
+
import type { SdkContext } from "@cesteral/shared";
|
|
4
|
+
export declare const GetDeliveryEstimateInputSchema: z.ZodObject<{
|
|
5
|
+
adAccountId: z.ZodString;
|
|
6
|
+
targetingSpec: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
7
|
+
optimizationGoal: z.ZodOptional<z.ZodString>;
|
|
8
|
+
}, "strip", z.ZodTypeAny, {
|
|
9
|
+
adAccountId: string;
|
|
10
|
+
targetingSpec: Record<string, any>;
|
|
11
|
+
optimizationGoal?: string | undefined;
|
|
12
|
+
}, {
|
|
13
|
+
adAccountId: string;
|
|
14
|
+
targetingSpec: Record<string, any>;
|
|
15
|
+
optimizationGoal?: string | undefined;
|
|
16
|
+
}>;
|
|
17
|
+
export declare const GetDeliveryEstimateOutputSchema: z.ZodObject<{
|
|
18
|
+
estimate: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
19
|
+
timestamp: z.ZodString;
|
|
20
|
+
}, "strip", z.ZodTypeAny, {
|
|
21
|
+
timestamp: string;
|
|
22
|
+
estimate: Record<string, any>;
|
|
23
|
+
}, {
|
|
24
|
+
timestamp: string;
|
|
25
|
+
estimate: Record<string, any>;
|
|
26
|
+
}>;
|
|
27
|
+
type GetDeliveryEstimateInput = z.infer<typeof GetDeliveryEstimateInputSchema>;
|
|
28
|
+
type GetDeliveryEstimateOutput = z.infer<typeof GetDeliveryEstimateOutputSchema>;
|
|
29
|
+
export declare function getDeliveryEstimateLogic(input: GetDeliveryEstimateInput, context: RequestContext, sdkContext?: SdkContext): Promise<GetDeliveryEstimateOutput>;
|
|
30
|
+
export declare function getDeliveryEstimateResponseFormatter(result: GetDeliveryEstimateOutput): McpTextContent[];
|
|
31
|
+
export declare const getDeliveryEstimateTool: {
|
|
32
|
+
name: string;
|
|
33
|
+
title: string;
|
|
34
|
+
description: string;
|
|
35
|
+
inputSchema: z.ZodObject<{
|
|
36
|
+
adAccountId: z.ZodString;
|
|
37
|
+
targetingSpec: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
38
|
+
optimizationGoal: z.ZodOptional<z.ZodString>;
|
|
39
|
+
}, "strip", z.ZodTypeAny, {
|
|
40
|
+
adAccountId: string;
|
|
41
|
+
targetingSpec: Record<string, any>;
|
|
42
|
+
optimizationGoal?: string | undefined;
|
|
43
|
+
}, {
|
|
44
|
+
adAccountId: string;
|
|
45
|
+
targetingSpec: Record<string, any>;
|
|
46
|
+
optimizationGoal?: string | undefined;
|
|
47
|
+
}>;
|
|
48
|
+
outputSchema: z.ZodObject<{
|
|
49
|
+
estimate: z.ZodRecord<z.ZodString, z.ZodAny>;
|
|
50
|
+
timestamp: z.ZodString;
|
|
51
|
+
}, "strip", z.ZodTypeAny, {
|
|
52
|
+
timestamp: string;
|
|
53
|
+
estimate: Record<string, any>;
|
|
54
|
+
}, {
|
|
55
|
+
timestamp: string;
|
|
56
|
+
estimate: Record<string, any>;
|
|
57
|
+
}>;
|
|
58
|
+
annotations: {
|
|
59
|
+
readOnlyHint: boolean;
|
|
60
|
+
openWorldHint: boolean;
|
|
61
|
+
idempotentHint: boolean;
|
|
62
|
+
destructiveHint: boolean;
|
|
63
|
+
};
|
|
64
|
+
inputExamples: {
|
|
65
|
+
label: string;
|
|
66
|
+
input: {
|
|
67
|
+
adAccountId: string;
|
|
68
|
+
targetingSpec: {
|
|
69
|
+
age_min: number;
|
|
70
|
+
age_max: number;
|
|
71
|
+
geo_locations: {
|
|
72
|
+
countries: string[];
|
|
73
|
+
};
|
|
74
|
+
};
|
|
75
|
+
optimizationGoal: string;
|
|
76
|
+
};
|
|
77
|
+
}[];
|
|
78
|
+
logic: typeof getDeliveryEstimateLogic;
|
|
79
|
+
responseFormatter: typeof getDeliveryEstimateResponseFormatter;
|
|
80
|
+
};
|
|
81
|
+
export {};
|
|
82
|
+
//# sourceMappingURL=get-delivery-estimate.tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-delivery-estimate.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-delivery-estimate.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AASnD,eAAO,MAAM,8BAA8B;;;;;;;;;;;;EAWa,CAAC;AAEzD,eAAO,MAAM,+BAA+B;;;;;;;;;EAKL,CAAC;AAExC,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAC/E,KAAK,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAEjF,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,yBAAyB,CAAC,CAcpC;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,yBAAyB,GAChC,cAAc,EAAE,CAOlB;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BnC,CAAC"}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { resolveSessionServices } from "../utils/resolve-session.js";
|
|
3
|
+
const TOOL_NAME = "meta_get_delivery_estimate";
|
|
4
|
+
const TOOL_TITLE = "Get Meta Delivery Estimate";
|
|
5
|
+
const TOOL_DESCRIPTION = `Get estimated audience size and delivery estimates for a targeting spec.
|
|
6
|
+
|
|
7
|
+
Requires a targeting specification with at least one location or custom audience.
|
|
8
|
+
Returns estimated daily reach, impressions, and audience size.`;
|
|
9
|
+
export const GetDeliveryEstimateInputSchema = z
|
|
10
|
+
.object({
|
|
11
|
+
adAccountId: z.string().describe("Ad Account ID (with or without act_ prefix)"),
|
|
12
|
+
targetingSpec: z
|
|
13
|
+
.record(z.any())
|
|
14
|
+
.describe("Targeting specification (must include geo_locations or custom_audiences)"),
|
|
15
|
+
optimizationGoal: z
|
|
16
|
+
.string()
|
|
17
|
+
.optional()
|
|
18
|
+
.describe("Optimization goal (e.g., LINK_CLICKS, REACH, CONVERSIONS)"),
|
|
19
|
+
})
|
|
20
|
+
.describe("Parameters for getting delivery estimates");
|
|
21
|
+
export const GetDeliveryEstimateOutputSchema = z
|
|
22
|
+
.object({
|
|
23
|
+
estimate: z.record(z.any()).describe("Delivery estimate data"),
|
|
24
|
+
timestamp: z.string().datetime(),
|
|
25
|
+
})
|
|
26
|
+
.describe("Delivery estimate result");
|
|
27
|
+
export async function getDeliveryEstimateLogic(input, context, sdkContext) {
|
|
28
|
+
const { metaService } = resolveSessionServices(sdkContext);
|
|
29
|
+
const result = await metaService.getDeliveryEstimate(input.adAccountId, input.targetingSpec, input.optimizationGoal, context);
|
|
30
|
+
return {
|
|
31
|
+
estimate: result,
|
|
32
|
+
timestamp: new Date().toISOString(),
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
export function getDeliveryEstimateResponseFormatter(result) {
|
|
36
|
+
return [
|
|
37
|
+
{
|
|
38
|
+
type: "text",
|
|
39
|
+
text: `Delivery estimate:\n${JSON.stringify(result.estimate, null, 2)}\n\nTimestamp: ${result.timestamp}`,
|
|
40
|
+
},
|
|
41
|
+
];
|
|
42
|
+
}
|
|
43
|
+
export const getDeliveryEstimateTool = {
|
|
44
|
+
name: TOOL_NAME,
|
|
45
|
+
title: TOOL_TITLE,
|
|
46
|
+
description: TOOL_DESCRIPTION,
|
|
47
|
+
inputSchema: GetDeliveryEstimateInputSchema,
|
|
48
|
+
outputSchema: GetDeliveryEstimateOutputSchema,
|
|
49
|
+
annotations: {
|
|
50
|
+
readOnlyHint: true,
|
|
51
|
+
openWorldHint: false,
|
|
52
|
+
idempotentHint: true,
|
|
53
|
+
destructiveHint: false,
|
|
54
|
+
},
|
|
55
|
+
inputExamples: [
|
|
56
|
+
{
|
|
57
|
+
label: "Estimate reach for US 25-44",
|
|
58
|
+
input: {
|
|
59
|
+
adAccountId: "act_123456789",
|
|
60
|
+
targetingSpec: {
|
|
61
|
+
age_min: 25,
|
|
62
|
+
age_max: 44,
|
|
63
|
+
geo_locations: { countries: ["US"] },
|
|
64
|
+
},
|
|
65
|
+
optimizationGoal: "REACH",
|
|
66
|
+
},
|
|
67
|
+
},
|
|
68
|
+
],
|
|
69
|
+
logic: getDeliveryEstimateLogic,
|
|
70
|
+
responseFormatter: getDeliveryEstimateResponseFormatter,
|
|
71
|
+
};
|
|
72
|
+
//# sourceMappingURL=get-delivery-estimate.tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-delivery-estimate.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-delivery-estimate.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAIrE,MAAM,SAAS,GAAG,4BAA4B,CAAC;AAC/C,MAAM,UAAU,GAAG,4BAA4B,CAAC;AAChD,MAAM,gBAAgB,GAAG;;;+DAGsC,CAAC;AAEhE,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC;KAC5C,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAC/E,aAAa,EAAE,CAAC;SACb,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;SACf,QAAQ,CAAC,0EAA0E,CAAC;IACvF,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2DAA2D,CAAC;CACzE,CAAC;KACD,QAAQ,CAAC,2CAA2C,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC;KAC7C,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC9D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,CAAC,0BAA0B,CAAC,CAAC;AAKxC,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAA+B,EAC/B,OAAuB,EACvB,UAAuB;IAEvB,MAAM,EAAE,WAAW,EAAE,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAE3D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,mBAAmB,CAClD,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,aAAa,EACnB,KAAK,CAAC,gBAAgB,EACtB,OAAO,CACR,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,MAAiC;QAC3C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,MAAiC;IAEjC,OAAO;QACL;YACE,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,uBAAuB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE;SAC1G;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,8BAA8B;IAC3C,YAAY,EAAE,+BAA+B;IAC7C,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,KAAK;KACvB;IACD,aAAa,EAAE;QACb;YACE,KAAK,EAAE,6BAA6B;YACpC,KAAK,EAAE;gBACL,WAAW,EAAE,eAAe;gBAC5B,aAAa,EAAE;oBACb,OAAO,EAAE,EAAE;oBACX,OAAO,EAAE,EAAE;oBACX,aAAa,EAAE,EAAE,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE;iBACrC;gBACD,gBAAgB,EAAE,OAAO;aAC1B;SACF;KACF;IACD,KAAK,EAAE,wBAAwB;IAC/B,iBAAiB,EAAE,oCAAoC;CACxD,CAAC"}
|