@cesteral/ttd-mcp 1.0.0

package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js

@@ -0,0 +1,145 @@
+import { getEntityConfig, getSupportedEntityTypes, } from "../../tools/utils/entity-mapping.js";
+let cachedContent;
+const parentFieldLabels = {
+    advertiserId: "AdvertiserId",
+    campaignId: "CampaignId",
+    adGroupId: "AdGroupId",
+    partnerId: "PartnerId",
+};
+function formatParentIds(parentIds) {
+    if (parentIds.length === 0) {
+        return "_(none - partner-scoped)_";
+    }
+    return parentIds.map((id) => `\`${parentFieldLabels[id]}\``).join(", ");
+}
+function buildEntityRows() {
+    return getSupportedEntityTypes()
+        .map((entityType) => {
+        const config = getEntityConfig(entityType);
+        const supportsBulk = config.supportsBulk ? "✓" : "";
+        const supportsArchive = config.supportsArchive ? "✓" : "";
+        return `| **${entityType}** | ${formatParentIds(config.parentIds)} | \`${config.idField}\` | \`${config.apiPath}\` | \`${config.queryPath}\` | ${supportsBulk} | ${supportsArchive} |`;
+    })
+        .join("\n");
+}
+function formatEntityHierarchyMarkdown() {
+    return `# TTD Entity Hierarchy
+
+## Relationship Diagram
+
+\`\`\`
+Partner (your TTD seat)
+  └── Advertiser
+        ├── Campaign
+        │     └── Ad Group (contains CreativeIds + targeting/bidding)
+        ├── Creative (reusable across ad groups)
+        └── Conversion Tracker (tracking tags)
+\`\`\`
+
+## REST Entity Types (5 total)
+
+| Entity Type | Required Parent IDs | ID Field | API Path | Query Path | Supports Bulk | Supports Archive |
+|-------------|--------------------:|----------|----------|------------|:---:|:---:|
+${buildEntityRows()}
+
+## GraphQL-Only Entities
+
+The following entities have **no REST query endpoints** and must be managed via \`ttd_graphql_query\`:
+
+- **Ads** — TTD has no standalone Ad entity. Ads are the combination of an Ad Group + Creative associations (\`CreativeIds\` on the ad group).
+- **Publisher Lists (Site Lists)** — Managed via GraphQL \`bidListCreate\` mutation with \`PUBLISHER_LIST\` type.
+- **Deals** — Managed via GraphQL \`targetableCommitments\` / \`targetableEndeavors\` on partner or advertiser objects.
+- **Bid Lists** — Managed via GraphQL \`bidList\` query, \`bidListCreate\`/\`bidListUpdate\`/\`bidListDelete\` mutations.
+
+## Key Relationships
+
+### Core Hierarchy: Advertiser → Campaign → Ad Group
+- A campaign belongs to exactly one advertiser (inherits currency).
+- An ad group belongs to exactly one campaign (inherits flight dates).
+- Ad groups contain \`CreativeIds\` to associate creatives (what other platforms call "ads").
+
+### Ancillary Entities
+- **Creatives** are reusable — referenced by ad groups via \`CreativeIds\` in \`RTBAttributes\`.
+- **Conversion Trackers** feed into campaign/ad group ROI optimization.
+- **Bid Lists** (GraphQL) are associated with ad groups via \`AssociatedBidLists\`.
+- **Deals** (GraphQL) are referenced by ad groups via \`ContractTargeting\`.
+
+## Creation Order
+
+Full campaign structure (top-down):
+
+1. **Advertiser** — usually pre-exists; verify with \`ttd_get_entity\`
+2. **Creative(s)** — create before ad groups that reference them
+3. **Conversion Tracker(s)** — create if using CPA/ROAS goals
+4. **Bid List(s)** — create via \`ttd_graphql_query\` if using dimensional bid adjustments
+5. **Deal(s)** — manage via \`ttd_graphql_query\` if using PMP/PG inventory
+6. **Campaign** — requires \`AdvertiserId\`
+7. **Ad Group(s)** — requires \`CampaignId\` + configure targeting/bidding + \`CreativeIds\`
+
+## Deletion / Archive Order
+
+Delete bottom-up to avoid orphan references:
+
+1. **Ad Groups** (use \`ttd_archive_entities\` for batch soft-delete)
+2. **Campaigns** (use \`ttd_archive_entities\` for batch soft-delete)
+3. Ancillary entities (creatives, trackers; bid lists/deals via GraphQL)
+4. _(Advertisers are rarely deleted)_
+
+## Query Patterns
+
+List queries use POST to scoped query endpoints. Each endpoint is scoped to a parent entity type:
+
+| Query | Endpoint | Required Filter | Example |
+|-------|----------|----------------|---------|
+| Advertisers for partner | \`/advertiser/query/partner\` | \`PartnerId\` | \`{ "PartnerId": "partner123" }\` |
+| Campaigns for advertiser | \`/campaign/query/advertiser\` | \`AdvertiserId\` | \`{ "AdvertiserId": "abc123" }\` |
+| Ad Groups for campaign | \`/adgroup/query/campaign\` | \`CampaignId\` | \`{ "CampaignId": "camp456" }\` |
+| Creatives for advertiser | \`/creative/query/advertiser\` | \`AdvertiserId\` | \`{ "AdvertiserId": "abc123" }\` |
+| Trackers for advertiser | \`/trackingtag/query/advertiser\` | \`AdvertiserId\` | \`{ "AdvertiserId": "abc123" }\` |
+
+## Available Tools Summary
+
+| Tool | Purpose | Batch? |
+|------|---------|--------|
+| \`ttd_list_entities\` | List/query entities | |
+| \`ttd_get_entity\` | Get single entity | |
+| \`ttd_create_entity\` | Create single entity | |
+| \`ttd_update_entity\` | Update single entity (PUT) | |
+| \`ttd_delete_entity\` | Delete single entity | |
+| \`ttd_bulk_create_entities\` | Batch create (campaigns/ad groups) | ✓ |
+| \`ttd_bulk_update_entities\` | Batch update (campaigns/ad groups) | ✓ |
+| \`ttd_bulk_update_status\` | Batch pause/resume/archive | ✓ |
+| \`ttd_archive_entities\` | Batch archive (soft-delete) | ✓ |
+| \`ttd_adjust_bids\` | Batch bid adjustments | ✓ |
+| \`ttd_validate_entity\` | Test entity payload (NOT dry-run — creates/updates on success) | |
+| \`ttd_graphql_query\` | GraphQL query/mutation passthrough | |
+| \`ttd_graphql_query_bulk\` | Submit bulk GraphQL query job | ✓ |
+| \`ttd_graphql_mutation_bulk\` | Submit bulk GraphQL mutation job (non-cancelable) | ✓ |
+| \`ttd_graphql_bulk_job\` | Check bulk job status / get result URL | |
+| \`ttd_graphql_cancel_bulk_job\` | Cancel bulk query job (not mutations) | |
+| \`ttd_get_report\` | Generate async report | |
+| \`ttd_download_report\` | Download report CSV and return bounded views | |
+
+## GraphQL Bulk Constraints
+
+| Constraint | Limit |
+|-----------|-------|
+| Max mutation inputs per job | 1,000 |
+| Max lexical tokens per query/mutation string | 15,000 (~60,000 chars) |
+| Mutation jobs cancelable? | **No** — non-cancelable once submitted |
+| Result URL expiry | 1 hour after job completion |
+| Max active jobs per partner | 10 |
+| Max queued jobs per partner | 20 |
+`;
+}
+export const entityHierarchyResource = {
+    uri: "entity-hierarchy://all",
+    name: "TTD Entity Hierarchy",
+    description: "Parent-child relationships between TTD entities, required parent IDs, and creation/deletion ordering",
+    mimeType: "text/markdown",
+    getContent: () => {
+        cachedContent ??= formatEntityHierarchyMarkdown();
+        return cachedContent;
+    },
+};
+//# sourceMappingURL=entity-hierarchy.resource.js.map

package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-hierarchy.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-hierarchy.resource.ts"],"names":[],"mappings":"AASA,OAAO,EACL,eAAe,EACf,uBAAuB,GAExB,MAAM,qCAAqC,CAAC;AAE7C,IAAI,aAAiC,CAAC;AAEtC,MAAM,iBAAiB,GAAgC;IACrD,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;CACvB,CAAC;AAEF,SAAS,eAAe,CAAC,SAAwB;IAC/C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,2BAA2B,CAAC;IACrC,CAAC;IACD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,iBAAiB,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,uBAAuB,EAAE;SAC7B,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;QAClB,MAAM,MAAM,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,OAAO,OAAO,UAAU,QAAQ,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,SAAS,QAAQ,YAAY,MAAM,eAAe,IAAI,CAAC;IACzL,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,6BAA6B;IACpC,OAAO;;;;;;;;;;;;;;;;;EAiBP,eAAe,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0FlB,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAa;IAC/C,GAAG,EAAE,wBAAwB;IAC7B,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,sGAAsG;IACxG,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE;QACf,aAAa,KAAK,6BAA6B,EAAE,CAAC;QAClD,OAAO,aAAa,CAAC;IACvB,CAAC;CACF,CAAC"}

package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts

@@ -0,0 +1,4 @@
+import type { Resource } from "../types.js";
+export declare const entitySchemaResources: Resource[];
+export declare const entitySchemaAllResource: Resource;
+//# sourceMappingURL=entity-schemas.resource.d.ts.map

package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-schemas.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-schemas.resource.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA4T5C,eAAO,MAAM,qBAAqB,EAAE,QAAQ,EAMzC,CAAC;AAEJ,eAAO,MAAM,uBAAuB,EAAE,QASrC,CAAC"}

package/dist/mcp-server/resources/definitions/entity-schemas.resource.js

@@ -0,0 +1,318 @@
+const cachedSchemas = new Map();
+function advertiserSchemaMarkdown() {
+    return `# TTD Advertiser Schema
+
+## Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| \`AdvertiserId\` | string | Read-only | Unique advertiser ID (assigned by TTD) |
+| \`AdvertiserName\` | string | **Yes** | Display name |
+| \`PartnerId\` | string | **Yes** | Partner ID this advertiser belongs to |
+| \`Description\` | string | No | Advertiser description |
+| \`CurrencyCode\` | string | **Yes** | ISO 4217 currency code (e.g., \`USD\`, \`EUR\`) |
+| \`DefaultRightMediaOfferTypeId\` | string | No | Default offer type |
+| \`AttributionClickLookbackWindowInSeconds\` | number | No | Click attribution window |
+| \`AttributionImpressionLookbackWindowInSeconds\` | number | No | Impression attribution window |
+| \`DomainAddress\` | string | No | Advertiser's website |
+| \`LogoURL\` | string | No | URL to advertiser logo |
+| \`IndustryCategoryId\` | number | No | Industry category |
+| \`Availability\` | string | No | \`Available\` or \`Archived\` |
+
+## Notes
+- \`AdvertiserId\` is auto-assigned on creation; do not include in create payloads.
+- \`CurrencyCode\` cannot be changed after creation.
+- Partner-level users can create advertisers; advertiser-level users cannot.
+`;
+}
+function campaignSchemaMarkdown() {
+    return `# TTD Campaign Schema
+
+## Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| \`CampaignId\` | string | Read-only | Unique campaign ID (assigned by TTD) |
+| \`AdvertiserId\` | string | **Yes** | Parent advertiser |
+| \`CampaignName\` | string | **Yes** | Display name |
+| \`Budget\` | object | **Yes** | Budget configuration (see below) |
+| \`StartDate\` | string | **Yes** | ISO 8601 date (\`YYYY-MM-DDTHH:mm:ss\`) |
+| \`EndDate\` | string | No | ISO 8601 date (omit for evergreen) |
+| \`CampaignConversionReportingColumns\` | string[] | No | Conversion columns for reporting |
+| \`PacingMode\` | string | No | \`Off\`, \`PaceAhead\` |
+| \`DailyBudgetInAdvertiserCurrency\` | number | No | Daily budget cap |
+| \`Availability\` | string | No | \`Available\`, \`Paused\`, \`Archived\` |
+| \`FrequencyConfig\` | object | No | Frequency capping settings |
+| \`TimeZone\` | string | No | IANA time zone (e.g., \`America/New_York\`) |
+| \`PartnerCostPercentageFee\` | number | No | Partner cost percentage |
+| \`Description\` | string | No | Campaign description |
+
+## Budget Object
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| \`Amount\` | number | **Yes** | Total budget amount |
+| \`CurrencyCode\` | string | No | Inherited from advertiser if omitted |
+
+## FrequencyConfig Object
+
+| Field | Type | Description |
+|-------|------|-------------|
+| \`MaxImpressions\` | number | Max impressions per user |
+| \`TimeUnitCount\` | number | Number of time units |
+| \`TimeUnit\` | string | \`Minutes\`, \`Hours\`, \`Days\`, \`Weeks\`, \`Months\` |
+
+## Notes
+- \`CampaignId\` is auto-assigned; do not include in create payloads.
+- Budget \`Amount\` is lifetime budget (not daily).
+- \`StartDate\` must be in the future for new campaigns.
+- Set \`Availability\` to \`Paused\` to stop delivery without deleting.
+`;
+}
+function adGroupSchemaMarkdown() {
+    return `# TTD Ad Group Schema
+
+## Core Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| \`AdGroupId\` | string | Read-only | Unique ad group ID (assigned by TTD) |
+| \`CampaignId\` | string | **Yes** | Parent campaign |
+| \`AdvertiserId\` | string | **Yes** | Parent advertiser |
+| \`AdGroupName\` | string | **Yes** | Display name |
+| \`RTBAttributes\` | object | **Yes** | Real-time bidding configuration (see below) |
+| \`Description\` | string | No | Ad group description |
+| \`IsEnabled\` | boolean | No | Whether ad group is active (default: \`true\`) |
+| \`IndustryCategoryId\` | number | No | Industry category |
+| \`Availability\` | string | No | \`Available\`, \`Paused\`, \`Archived\` |
+| \`AssociatedBidLists\` | object[] | No | Bid lists for fine-grained bidding |
+| \`Channel\` | string | No | \`Display\`, \`Video\`, \`Audio\`, \`CTV\`, \`DOOH\`, \`Native\` |
+| \`FunnelLocation\` | string | No | \`Awareness\`, \`Consideration\`, \`Conversion\` |
+| \`MarketType\` | string | No | \`OpenMarket\`, \`PrivateMarketOnly\`, \`ProgrammaticGuaranteed\` |
+| \`ProgrammaticGuaranteedPrivateContractId\` | string | No | PG contract ID (when MarketType is PG) |
+
+## RTBAttributes Object
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| \`BudgetSettings\` | object | **Yes** | Budget configuration |
+| \`BaseBidCPM\` | object | **Yes** | Base bid amount |
+| \`MaxBidCPM\` | object | No | Maximum bid cap |
+| \`ROIGoal\` | object | No | ROI/CPA optimization goal |
+| \`AudienceTargeting\` | object | No | First/third-party audience targeting |
+| \`SiteTargeting\` | object | No | Site/app targeting |
+| \`GeoTargeting\` | object | No | Geographic targeting |
+| \`CreativeCategoryExclusions\` | string[] | No | Excluded creative categories |
+| \`FrequencyConfig\` | object[] | No | Frequency capping (see below) |
+| \`ContractTargeting\` | object | No | PMP/PG contract targeting settings |
+
+## BudgetSettings Object
+
+| Field | Type | Description |
+|-------|------|-------------|
+| \`Budget\` | object | \`{ Amount, CurrencyCode }\` |
+| \`DailyBudget\` | object | \`{ Amount, CurrencyCode }\` |
+| \`PacingMode\` | string | \`Off\`, \`PaceAhead\` |
+
+## BaseBidCPM / MaxBidCPM Object
+
+| Field | Type | Description |
+|-------|------|-------------|
+| \`Amount\` | number | Bid amount in currency |
+| \`CurrencyCode\` | string | ISO 4217 code |
+
+## AudienceTargeting Object
+
+| Field | Type | Description |
+|-------|------|-------------|
+| \`AudienceId\` | string | First-party or third-party audience ID |
+| \`AudienceAcceleratorExclusionsEnabled\` | boolean | Exclude users from audience accelerator |
+| \`AudienceBoosterEnabled\` | boolean | Enable audience boosting (look-alike expansion) |
+| \`AudienceExcluderEnabled\` | boolean | Enable audience exclusion |
+| \`AudiencePredictorEnabled\` | boolean | Enable predictive audience matching |
+| \`CrossDeviceVendorListForAudience\` | number[] | Cross-device graph vendor IDs |
+| \`RecencyExclusionWindowInMinutes\` | number | Exclude recently-seen users |
+| \`TargetTrackableUsersEnabled\` | boolean | Only target users with trackable IDs |
+
+## ROIGoal Object (12 Goal Types)
+
+| Field | Type | Description |
+|-------|------|-------------|
+| \`MaximizeReach\` | boolean | Optimize for maximum unique reach |
+| \`MaximizeLtvIncrementalReach\` | boolean | Optimize for LTV incremental reach |
+| \`CPCInAdvertiserCurrency\` | number | Target cost per click |
+| \`CTRInPercent\` | number | Target click-through rate |
+| \`CPAInAdvertiserCurrency\` | number | Target cost per acquisition |
+| \`ReturnOnAdSpendPercent\` | number | Target ROAS percentage |
+| \`VCRInPercent\` | number | Target video completion rate |
+| \`ViewabilityInPercent\` | number | Target viewability rate |
+| \`VCPMInAdvertiserCurrency\` | number | Target viewable CPM |
+| \`CPCVInAdvertiserCurrency\` | number | Target cost per completed view |
+| \`NielsenOTPInPercent\` | number | Target Nielsen on-target percentage |
+| \`MiaozhenOTPInPercent\` | number | Target Miaozhen on-target percentage |
+
+## FrequencyConfig (Ad Group Level)
+
+| Field | Type | Description |
+|-------|------|-------------|
+| \`CounterName\` | string | Named counter (for cross-campaign coordination) |
+| \`FrequencyCap\` | number | Max impressions per user in window |
+| \`FrequencyGoal\` | number | Target impressions per user |
+| \`ResetIntervalInMinutes\` | number | Frequency window reset interval |
+
+## Flights (Budget Allocation per Campaign Flight)
+
+| Field | Type | Description |
+|-------|------|-------------|
+| \`CampaignFlightId\` | number | Parent campaign flight ID |
+| \`AllocationType\` | string | \`Maximum\` or \`Even\` |
+| \`BudgetInAdvertiserCurrency\` | number | Flight budget in currency |
+| \`BudgetInImpressions\` | number | Flight budget in impressions |
+| \`DailyTargetInAdvertiserCurrency\` | number | Daily spend target |
+| \`DailyTargetInImpressions\` | number | Daily impression target |
+
+## Koa/Kokai AI Optimization Settings
+
+| Field | Type | Description |
+|-------|------|-------------|
+| \`AreFutureKoaFeaturesEnabled\` | boolean | Opt-in to new Kokai AI features |
+| \`PredictiveClearingEnabled\` | boolean | Enable predictive bid clearing |
+
+## ContractTargeting Object
+
+| Field | Type | Description |
+|-------|------|-------------|
+| \`AllowOpenMarketBiddingWhenTargetingContracts\` | boolean | Also bid on open market when targeting PMP contracts |
+
+## AssociatedBidLists
+
+| Field | Type | Description |
+|-------|------|-------------|
+| \`BidListId\` | string | Bid list ID to associate |
+| \`IsEnabled\` | boolean | Whether this bid list is active |
+| \`IsDefaultForDimension\` | boolean | Whether this is the default for its dimension |
+
+## Notes
+- \`AdGroupId\` is auto-assigned; do not include in create payloads.
+- \`RTBAttributes\` is required and must include at minimum \`BudgetSettings\` and \`BaseBidCPM\`.
+- Ad groups inherit campaign flight dates; ad group budget cannot exceed campaign budget.
+- Targeting (geo, audience, device, site) is applied at the ad group level in TTD (not at ad level).
+- Use \`ttd_adjust_bids\` tool for safe read-modify-write bid changes.
+- Use \`Channel\` to specify ad format: Display, Video, Audio, CTV, DOOH.
+- Use \`FunnelLocation\` to align with campaign objectives: Awareness, Consideration, Conversion.
+`;
+}
+function creativeSchemaMarkdown() {
+    return `# TTD Creative Schema
+
+## Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| \`CreativeId\` | string | Read-only | Unique creative ID (assigned by TTD) |
+| \`AdvertiserId\` | string | **Yes** | Parent advertiser |
+| \`CreativeName\` | string | **Yes** | Display name |
+| \`CreativeType\` | string | **Yes** | \`Banner\`, \`Video\`, \`Native\`, \`Audio\`, \`HTML5\` |
+| \`Width\` | number | Varies | Width in pixels (required for Banner/HTML5) |
+| \`Height\` | number | Varies | Height in pixels (required for Banner/HTML5) |
+| \`Tag\` | string | Varies | Third-party ad tag (for third-party served creatives) |
+| \`HostedCreativeAssetUrl\` | string | Varies | URL for TTD-hosted creative asset |
+| \`LandingPageUrl\` | string | No | Default click-through URL |
+| \`ThirdPartyTrackingUrls\` | string[] | No | Third-party tracking pixels |
+| \`IsHTTPS\` | boolean | No | Whether creative is HTTPS-compatible |
+| \`Availability\` | string | No | \`Available\` or \`Archived\` |
+| \`Description\` | string | No | Creative description |
+| \`ExpandedSize\` | object | No | Expanded dimensions for expandable creatives |
+| \`VideoAttributes\` | object | No | VAST URL, duration, skip settings (for video) |
+| \`NativeAttributes\` | object | No | Title, body, icon, image (for native) |
+
+## VideoAttributes Object
+
+| Field | Type | Description |
+|-------|------|-------------|
+| \`VastUrl\` | string | VAST tag URL |
+| \`DurationInSeconds\` | number | Video duration |
+| \`IsSkippable\` | boolean | Whether user can skip |
+| \`SkipOffsetInSeconds\` | number | Seconds before skip button appears |
+
+## Notes
+- Creatives must be created before they can be associated with ads.
+- One creative can be reused across multiple ads and ad groups.
+- Use \`CreativeType\` matching the ad group's \`Channel\` setting.
+`;
+}
+function conversionTrackerSchemaMarkdown() {
+    return `# TTD Conversion Tracker Schema
+
+## Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| \`TrackingTagId\` | string | Read-only | Unique tracker ID (assigned by TTD) |
+| \`AdvertiserId\` | string | **Yes** | Parent advertiser |
+| \`TrackingTagName\` | string | **Yes** | Display name |
+| \`TrackingTagType\` | string | **Yes** | \`Standard\`, \`Custom\`, \`UniversalPixel\` |
+| \`TrackingTagCategory\` | string | No | \`PageView\`, \`Purchase\`, \`SignUp\`, \`AddToCart\`, \`Lead\`, \`Other\` |
+| \`ConversionType\` | string | No | \`PostClick\`, \`PostView\`, \`Both\` |
+| \`ClickLookbackWindowInSeconds\` | number | No | Click attribution window |
+| \`ViewLookbackWindowInSeconds\` | number | No | View-through attribution window |
+| \`CountingMethod\` | string | No | \`OnePerSession\`, \`OnePerUser\`, \`All\` |
+| \`TrackingTagUrl\` | string | Read-only | The pixel URL to deploy |
+| \`Availability\` | string | No | \`Available\` or \`Archived\` |
+| \`Description\` | string | No | Tracker description |
+
+## Notes
+- Deploy the \`TrackingTagUrl\` on your conversion pages after creation.
+- Conversion data feeds into campaign/ad group optimization when using CPA or ROAS ROI goals.
+- \`UniversalPixel\` type supports multiple conversion events on a single tag.
+`;
+}
+const SCHEMA_GENERATORS = {
+    advertiser: advertiserSchemaMarkdown,
+    campaign: campaignSchemaMarkdown,
+    adgroup: adGroupSchemaMarkdown,
+    creative: creativeSchemaMarkdown,
+    conversiontracker: conversionTrackerSchemaMarkdown,
+};
+function getSchemaContent(entityType) {
+    const key = entityType.toLowerCase();
+    if (!cachedSchemas.has(key)) {
+        const generator = SCHEMA_GENERATORS[key];
+        if (generator) {
+            cachedSchemas.set(key, generator());
+        }
+        else {
+            return `# Unknown entity type: ${entityType}\n\nSupported types: ${ENTITY_TYPES.join(", ")}`;
+        }
+    }
+    return cachedSchemas.get(key);
+}
+let cachedAllSchemas;
+function getAllSchemasMarkdown() {
+    return ENTITY_TYPES.map((t) => getSchemaContent(t)).join("\n---\n\n");
+}
+const ENTITY_TYPES = [
+    "advertiser",
+    "campaign",
+    "adGroup",
+    "creative",
+    "conversionTracker",
+];
+export const entitySchemaResources = ENTITY_TYPES.map((entityType) => ({
+    uri: `entity-schema://${entityType}`,
+    name: `TTD ${entityType} Schema`,
+    description: `Field reference for TTD ${entityType} entities including required fields, types, and nested objects`,
+    mimeType: "text/markdown",
+    getContent: () => getSchemaContent(entityType),
+}));
+export const entitySchemaAllResource = {
+    uri: "entity-schema://all",
+    name: "TTD All Entity Schemas",
+    description: "Combined field reference for all TTD entity types",
+    mimeType: "text/markdown",
+    getContent: () => {
+        cachedAllSchemas ??= getAllSchemasMarkdown();
+        return cachedAllSchemas;
+    },
+};
+//# sourceMappingURL=entity-schemas.resource.js.map

package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-schemas.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/entity-schemas.resource.ts"],"names":[],"mappings":"AAWA,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;AAIhD,SAAS,wBAAwB;IAC/B,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAuBR,CAAC;AACF,CAAC;AAED,SAAS,sBAAsB;IAC7B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCR,CAAC;AACF,CAAC;AAED,SAAS,qBAAqB;IAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkIR,CAAC;AACF,CAAC;AAED,SAAS,sBAAsB;IAC7B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCR,CAAC;AACF,CAAC;AAED,SAAS,+BAA+B;IACtC,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAuBR,CAAC;AACF,CAAC;AAID,MAAM,iBAAiB,GAAiC;IACtD,UAAU,EAAE,wBAAwB;IACpC,QAAQ,EAAE,sBAAsB;IAChC,OAAO,EAAE,qBAAqB;IAC9B,QAAQ,EAAE,sBAAsB;IAChC,iBAAiB,EAAE,+BAA+B;CACnD,CAAC;AAEF,SAAS,gBAAgB,CAAC,UAAkB;IAC1C,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IACrC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,SAAS,EAAE,CAAC;YACd,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,OAAO,0BAA0B,UAAU,wBAAwB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/F,CAAC;IACH,CAAC;IACD,OAAO,aAAa,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;AACjC,CAAC;AAED,IAAI,gBAAoC,CAAC;AAEzC,SAAS,qBAAqB;IAC5B,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,YAAY,GAAG;IACnB,YAAY;IACZ,UAAU;IACV,SAAS;IACT,UAAU;IACV,mBAAmB;CACX,CAAC;AAEX,MAAM,CAAC,MAAM,qBAAqB,GAAe,YAAY,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACjF,GAAG,EAAE,mBAAmB,UAAU,EAAE;IACpC,IAAI,EAAE,OAAO,UAAU,SAAS;IAChC,WAAW,EAAE,2BAA2B,UAAU,gEAAgE;IAClH,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,UAAU,CAAC;CAC/C,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,MAAM,uBAAuB,GAAa;IAC/C,GAAG,EAAE,qBAAqB;IAC1B,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,mDAAmD;IAChE,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,GAAG,EAAE;QACf,gBAAgB,KAAK,qBAAqB,EAAE,CAAC;QAC7C,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF,CAAC"}

package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts

@@ -0,0 +1,3 @@
+import type { TemplatedResourceDefinition } from "@cesteral/shared";
+export declare const fieldRulesResource: TemplatedResourceDefinition;
+//# sourceMappingURL=field-rules.resource.d.ts.map

package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-rules.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/field-rules.resource.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAQpE,eAAO,MAAM,kBAAkB,EAAE,2BA4BhC,CAAC"}

package/dist/mcp-server/resources/definitions/field-rules.resource.js

@@ -0,0 +1,28 @@
+import { getEntityTypeEnum, getSupportedEntityTypes, } from "../../tools/utils/entity-mapping.js";
+import { getFieldRulesForEntity } from "../utils/field-rules.js";
+export const fieldRulesResource = {
+    uriTemplate: "ttd-field-rules://{entityType}",
+    name: "TTD Field Rules",
+    description: "Required-field rules, enum suggestions, and read-only field list for a TTD entity type. " +
+        `Valid {entityType}: ${getEntityTypeEnum().join(", ")}.`,
+    mimeType: "application/json",
+    resolveContent: (_uri, variables) => {
+        const raw = variables.entityType;
+        const entityType = (Array.isArray(raw) ? raw[0] : raw);
+        if (!entityType) {
+            throw new Error("ttd-field-rules: missing {entityType} in URI");
+        }
+        if (!getSupportedEntityTypes().includes(entityType)) {
+            throw new Error(`ttd-field-rules: unknown entityType "${entityType}". ` +
+                `Supported: ${getSupportedEntityTypes().join(", ")}.`);
+        }
+        return JSON.stringify(getFieldRulesForEntity(entityType), null, 2);
+    },
+    list: async () => getSupportedEntityTypes().map((t) => ({
+        uri: `ttd-field-rules://${t}`,
+        name: `TTD field rules — ${t}`,
+        description: `Required + enum + read-only fields for TTD ${t}`,
+        mimeType: "application/json",
+    })),
+};
+//# sourceMappingURL=field-rules.resource.js.map

package/dist/mcp-server/resources/definitions/field-rules.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-rules.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/field-rules.resource.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GAExB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,WAAW,EAAE,gCAAgC;IAC7C,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,0FAA0F;QAC1F,uBAAuB,iBAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;IAC1D,QAAQ,EAAE,kBAAkB;IAC5B,cAAc,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE;QAClC,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC;QACjC,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAA8B,CAAC;QACpF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,uBAAuB,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CACb,wCAAwC,UAAU,KAAK;gBACrD,cAAc,uBAAuB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACxD,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,EAAE,KAAK,IAAI,EAAE,CACf,uBAAuB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpC,GAAG,EAAE,qBAAqB,CAAC,EAAE;QAC7B,IAAI,EAAE,qBAAqB,CAAC,EAAE;QAC9B,WAAW,EAAE,8CAA8C,CAAC,EAAE;QAC9D,QAAQ,EAAE,kBAAkB;KAC7B,CAAC,CAAC;CACN,CAAC"}

package/dist/mcp-server/resources/definitions/graphql-reference.resource.d.ts

@@ -0,0 +1,3 @@
+import type { Resource } from "../types.js";
+export declare const graphqlReferenceResource: Resource;
+//# sourceMappingURL=graphql-reference.resource.d.ts.map

package/dist/mcp-server/resources/definitions/graphql-reference.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-reference.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/graphql-reference.resource.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAmb5C,eAAO,MAAM,wBAAwB,EAAE,QAUtC,CAAC"}