@apex-inc/mcp-server 0.27.3 → 0.27.5

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.
Files changed (10) hide show
  1. package/dist/adoption-compose.d.ts +30 -0
  2. package/dist/adoption-compose.d.ts.map +1 -0
  3. package/dist/adoption-compose.js +69 -0
  4. package/dist/adoption-compose.js.map +1 -0
  5. package/dist/tools.d.ts +135 -73
  6. package/dist/tools.d.ts.map +1 -1
  7. package/dist/tools.js +93 -44
  8. package/dist/tools.js.map +1 -1
  9. package/package.json +1 -1
  10. package/skills/apex-adoption/SKILL.md +9 -6
package/dist/adoption-compose.d.ts ADDED
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Shared body + preflight for adoption milestone MCP writes.
3
+ * New milestones default to enrollMode "future" so a 1-hour clock does not
4
+ * mail everyone who signed up last year.
5
+ */
6
+ export type AdoptionWriteArgs = {
7
+ name?: string;
8
+ featureKey?: string;
9
+ adoptedWhenKind?: "event" | "trait";
10
+ eventName?: string;
11
+ traitPath?: string;
12
+ traitValue?: string;
13
+ traitOp?: "equals" | "not_equals" | "exists";
14
+ priority?: number;
15
+ order?: number;
16
+ gapDays?: number;
17
+ gapHours?: number;
18
+ gapKind?: "days_since_signup" | "event_not_fired";
19
+ sinceEventName?: string;
20
+ enrollMode?: "all" | "future";
21
+ active?: boolean;
22
+ nudgeJourneyId?: string;
23
+ celebrationJourneyId?: string;
24
+ };
25
+ export declare function milestoneWriteBody(args: AdoptionWriteArgs): Record<string, unknown>;
26
+ export declare function preflightAdoptionMilestone(args: {
27
+ eventName?: string;
28
+ adoptedWhenKind?: "event" | "trait";
29
+ }): Promise<string[]>;
30
+ //# sourceMappingURL=adoption-compose.d.ts.map
package/dist/adoption-compose.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adoption-compose.d.ts","sourceRoot":"","sources":["../src/adoption-compose.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,mBAAmB,GAAG,iBAAiB,CAAC;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoCnF;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CACrC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoCpB"}
package/dist/adoption-compose.js ADDED
@@ -0,0 +1,69 @@
1
+ /**
2
+ * Shared body + preflight for adoption milestone MCP writes.
3
+ * New milestones default to enrollMode "future" so a 1-hour clock does not
4
+ * mail everyone who signed up last year.
5
+ */
6
+ import { apiGet } from "./api-client.js";
7
+ export function milestoneWriteBody(args) {
8
+ const hours = typeof args.gapHours === "number" && Number.isFinite(args.gapHours)
9
+ ? args.gapHours
10
+ : undefined;
11
+ const gapPolicy = {
12
+ kind: args.gapKind === "event_not_fired" ? "event_not_fired" : "days_since_signup",
13
+ days: hours !== undefined ? 0 : (args.gapDays ?? 3),
14
+ ...(hours !== undefined ? { hours } : {}),
15
+ ...(args.sinceEventName ? { sinceEventName: args.sinceEventName } : {}),
16
+ };
17
+ const adoptedWhen = args.adoptedWhenKind === "trait"
18
+ ? {
19
+ kind: "trait",
20
+ traitPath: args.traitPath,
21
+ traitOp: args.traitOp ?? "equals",
22
+ traitValue: args.traitValue,
23
+ }
24
+ : args.adoptedWhenKind === "event"
25
+ ? { kind: "event", eventName: args.eventName }
26
+ : undefined;
27
+ return {
28
+ ...(args.name !== undefined ? { name: args.name } : {}),
29
+ ...(args.featureKey !== undefined ? { featureKey: args.featureKey } : {}),
30
+ ...(args.priority !== undefined ? { priority: args.priority } : {}),
31
+ ...(args.order !== undefined ? { order: args.order } : {}),
32
+ ...(args.active !== undefined ? { active: args.active } : {}),
33
+ ...(args.nudgeJourneyId !== undefined ? { nudgeJourneyId: args.nudgeJourneyId } : {}),
34
+ ...(args.celebrationJourneyId !== undefined
35
+ ? { celebrationJourneyId: args.celebrationJourneyId }
36
+ : {}),
37
+ ...(args.enrollMode !== undefined ? { enrollMode: args.enrollMode } : {}),
38
+ gapPolicy,
39
+ ...(adoptedWhen ? { adoptedWhen } : {}),
40
+ };
41
+ }
42
+ export async function preflightAdoptionMilestone(args) {
43
+ const warnings = [];
44
+ const eventName = args.eventName?.trim();
45
+ if (args.adoptedWhenKind === "event" && eventName) {
46
+ try {
47
+ const listed = await apiGet("/api/adoption/milestones");
48
+ const dup = (listed?.data?.milestones ?? []).find((m) => m.adoptedWhen?.eventName === eventName);
49
+ if (dup) {
50
+ warnings.push(`Another milestone already uses ${eventName}: "${dup.name}" (${dup.id}). You will double-count adoption unless you reuse that row.`);
51
+ }
52
+ }
53
+ catch {
54
+ /* best-effort */
55
+ }
56
+ try {
57
+ const catalog = await apiGet("/api/events/catalog");
58
+ const seen = (catalog?.events ?? []).some((e) => e.eventName === eventName);
59
+ if (!seen) {
60
+ warnings.push(`${eventName} has never been seen in this workspace. The milestone can be created, but nobody will adopt it until that event fires on an identified person.`);
61
+ }
62
+ }
63
+ catch {
64
+ /* best-effort */
65
+ }
66
+ }
67
+ return warnings;
68
+ }
69
+ //# sourceMappingURL=adoption-compose.js.map
package/dist/adoption-compose.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adoption-compose.js","sourceRoot":"","sources":["../src/adoption-compose.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAsBzC,MAAM,UAAU,kBAAkB,CAAC,IAAuB;IACxD,MAAM,KAAK,GACT,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;QACjE,CAAC,CAAC,IAAI,CAAC,QAAQ;QACf,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,SAAS,GAA4B;QACzC,IAAI,EAAE,IAAI,CAAC,OAAO,KAAK,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,mBAAmB;QAClF,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QACnD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxE,CAAC;IACF,MAAM,WAAW,GACf,IAAI,CAAC,eAAe,KAAK,OAAO;QAC9B,CAAC,CAAC;YACE,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,QAAQ;YACjC,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B;QACH,CAAC,CAAC,IAAI,CAAC,eAAe,KAAK,OAAO;YAChC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE;YAC9C,CAAC,CAAC,SAAS,CAAC;IAClB,OAAO;QACL,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrF,GAAG,CAAC,IAAI,CAAC,oBAAoB,KAAK,SAAS;YACzC,CAAC,CAAC,EAAE,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,EAAE;YACrD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,SAAS;QACT,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,IAGhD;IACC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;IACzC,IAAI,IAAI,CAAC,eAAe,KAAK,OAAO,IAAI,SAAS,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAInB,0BAA0B,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,CAC/C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,SAAS,KAAK,SAAS,CAC9C,CAAC;YACF,IAAI,GAAG,EAAE,CAAC;gBACR,QAAQ,CAAC,IAAI,CACX,kCAAkC,SAAS,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,8DAA8D,CACpI,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAEzB,qBAAqB,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;YAC5E,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,QAAQ,CAAC,IAAI,CACX,GAAG,SAAS,gJAAgJ,CAC7J,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
package/dist/tools.d.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  import { z } from "zod";
2
+ import { type AdoptionWriteArgs } from "./adoption-compose.js";
2
3
  declare function switchWorkspaceHandler(args: {
3
4
  workspaceKey?: string;
4
5
  projectKey?: string;
@@ -131,8 +132,8 @@ export declare const toolDefinitions: {
131
132
  runtimeDays: z.ZodOptional<z.ZodNumber>;
132
133
  preview: z.ZodOptional<z.ZodBoolean>;
133
134
  }, "strip", z.ZodTypeAny, {
134
- targetUrl: string;
135
135
  name: string;
136
+ targetUrl: string;
136
137
  controlContent: string;
137
138
  variantContent: string;
138
139
  surface?: "mobile" | "web" | undefined;
@@ -158,8 +159,8 @@ export declare const toolDefinitions: {
158
159
  runtimeDays?: number | undefined;
159
160
  preview?: boolean | undefined;
160
161
  }, {
161
- targetUrl: string;
162
162
  name: string;
163
+ targetUrl: string;
163
164
  controlContent: string;
164
165
  variantContent: string;
165
166
  surface?: "mobile" | "web" | undefined;
@@ -429,9 +430,9 @@ export declare const toolDefinitions: {
429
430
  schema: z.ZodObject<{
430
431
  status: z.ZodOptional<z.ZodEnum<["all", "running", "completed", "draft", "paused", "archived"]>>;
431
432
  }, "strip", z.ZodTypeAny, {
432
- status?: "draft" | "paused" | "all" | "running" | "completed" | "archived" | undefined;
433
+ status?: "all" | "draft" | "paused" | "running" | "completed" | "archived" | undefined;
433
434
  }, {
434
- status?: "draft" | "paused" | "all" | "running" | "completed" | "archived" | undefined;
435
+ status?: "all" | "draft" | "paused" | "running" | "completed" | "archived" | undefined;
435
436
  }>;
436
437
  handler: ({ status }: {
437
438
  status?: string;
@@ -534,9 +535,9 @@ export declare const toolDefinitions: {
534
535
  runtimeDays: z.ZodOptional<z.ZodNumber>;
535
536
  }, "strip", z.ZodTypeAny, {
536
537
  experimentId: string;
538
+ name?: string | undefined;
537
539
  surface?: "mobile" | "web" | undefined;
538
540
  targetUrl?: string | undefined;
539
- name?: string | undefined;
540
541
  predictionId?: string | undefined;
541
542
  primaryMetricEvent?: string | undefined;
542
543
  primaryMetricType?: "rate" | "count" | "revenue" | "duration" | undefined;
@@ -546,9 +547,9 @@ export declare const toolDefinitions: {
546
547
  hypothesis?: string | undefined;
547
548
  }, {
548
549
  experimentId: string;
550
+ name?: string | undefined;
549
551
  surface?: "mobile" | "web" | undefined;
550
552
  targetUrl?: string | undefined;
551
- name?: string | undefined;
552
553
  predictionId?: string | undefined;
553
554
  primaryMetricEvent?: string | undefined;
554
555
  primaryMetricType?: "rate" | "count" | "revenue" | "duration" | undefined;
@@ -1604,7 +1605,7 @@ export declare const toolDefinitions: {
1604
1605
  confirmLiveExperiment: z.ZodOptional<z.ZodBoolean>;
1605
1606
  }, "strip", z.ZodTypeAny, {
1606
1607
  communicationId: string;
1607
- status?: "draft" | "paused" | "active" | undefined;
1608
+ status?: "active" | "draft" | "paused" | undefined;
1608
1609
  subject?: string | undefined;
1609
1610
  slots?: Record<string, string> | undefined;
1610
1611
  channels?: string[] | undefined;
@@ -1613,7 +1614,7 @@ export declare const toolDefinitions: {
1613
1614
  confirmLiveExperiment?: boolean | undefined;
1614
1615
  }, {
1615
1616
  communicationId: string;
1616
- status?: "draft" | "paused" | "active" | undefined;
1617
+ status?: "active" | "draft" | "paused" | undefined;
1617
1618
  subject?: string | undefined;
1618
1619
  slots?: Record<string, string> | undefined;
1619
1620
  channels?: string[] | undefined;
@@ -2375,15 +2376,15 @@ export declare const toolDefinitions: {
2375
2376
  commVersion: z.ZodOptional<z.ZodNumber>;
2376
2377
  channels: z.ZodOptional<z.ZodArray<z.ZodEnum<["email", "in_app_push", "mobile_push", "web_push"]>, "many">>;
2377
2378
  }, "strip", z.ZodTypeAny, {
2378
- journeyId: string;
2379
2379
  kind: "wait" | "send";
2380
+ journeyId: string;
2380
2381
  channels?: ("email" | "web_push" | "mobile_push" | "in_app_push")[] | undefined;
2381
2382
  durationIso?: string | undefined;
2382
2383
  commId?: string | undefined;
2383
2384
  commVersion?: number | undefined;
2384
2385
  }, {
2385
- journeyId: string;
2386
2386
  kind: "wait" | "send";
2387
+ journeyId: string;
2387
2388
  channels?: ("email" | "web_push" | "mobile_push" | "in_app_push")[] | undefined;
2388
2389
  durationIso?: string | undefined;
2389
2390
  commId?: string | undefined;
@@ -2409,6 +2410,42 @@ export declare const toolDefinitions: {
2409
2410
  }[];
2410
2411
  }>;
2411
2412
  };
2413
+ set_journey_send: {
2414
+ description: string;
2415
+ schema: z.ZodObject<{
2416
+ journeyId: z.ZodString;
2417
+ commId: z.ZodString;
2418
+ stepId: z.ZodOptional<z.ZodString>;
2419
+ commVersion: z.ZodOptional<z.ZodNumber>;
2420
+ }, "strip", z.ZodTypeAny, {
2421
+ journeyId: string;
2422
+ commId: string;
2423
+ commVersion?: number | undefined;
2424
+ stepId?: string | undefined;
2425
+ }, {
2426
+ journeyId: string;
2427
+ commId: string;
2428
+ commVersion?: number | undefined;
2429
+ stepId?: string | undefined;
2430
+ }>;
2431
+ handler: (args: {
2432
+ journeyId: string;
2433
+ commId: string;
2434
+ stepId?: string;
2435
+ commVersion?: number;
2436
+ }) => Promise<{
2437
+ content: {
2438
+ type: "text";
2439
+ text: string;
2440
+ }[];
2441
+ isError: boolean;
2442
+ } | {
2443
+ content: {
2444
+ type: "text";
2445
+ text: string;
2446
+ }[];
2447
+ }>;
2448
+ };
2412
2449
  add_journey_branch: {
2413
2450
  description: string;
2414
2451
  schema: z.ZodObject<{
@@ -2421,17 +2458,17 @@ export declare const toolDefinitions: {
2421
2458
  event_name: z.ZodOptional<z.ZodString>;
2422
2459
  window_days: z.ZodOptional<z.ZodNumber>;
2423
2460
  }, "strip", z.ZodTypeAny, {
2424
- kind: "attribute" | "event_fired" | "event_not_fired";
2461
+ kind: "event_not_fired" | "attribute" | "event_fired";
2425
2462
  value?: string | number | boolean | (string | number | boolean)[] | undefined;
2426
2463
  field_path?: string | undefined;
2427
- operator?: "equals" | "not_equals" | "greater_than" | "less_than" | "in" | "exists" | "not_exists" | undefined;
2464
+ operator?: "equals" | "not_equals" | "exists" | "greater_than" | "less_than" | "in" | "not_exists" | undefined;
2428
2465
  event_name?: string | undefined;
2429
2466
  window_days?: number | undefined;
2430
2467
  }, {
2431
- kind: "attribute" | "event_fired" | "event_not_fired";
2468
+ kind: "event_not_fired" | "attribute" | "event_fired";
2432
2469
  value?: string | number | boolean | (string | number | boolean)[] | undefined;
2433
2470
  field_path?: string | undefined;
2434
- operator?: "equals" | "not_equals" | "greater_than" | "less_than" | "in" | "exists" | "not_exists" | undefined;
2471
+ operator?: "equals" | "not_equals" | "exists" | "greater_than" | "less_than" | "in" | "not_exists" | undefined;
2435
2472
  event_name?: string | undefined;
2436
2473
  window_days?: number | undefined;
2437
2474
  }>;
@@ -2441,10 +2478,10 @@ export declare const toolDefinitions: {
2441
2478
  }, "strip", z.ZodTypeAny, {
2442
2479
  journeyId: string;
2443
2480
  condition: {
2444
- kind: "attribute" | "event_fired" | "event_not_fired";
2481
+ kind: "event_not_fired" | "attribute" | "event_fired";
2445
2482
  value?: string | number | boolean | (string | number | boolean)[] | undefined;
2446
2483
  field_path?: string | undefined;
2447
- operator?: "equals" | "not_equals" | "greater_than" | "less_than" | "in" | "exists" | "not_exists" | undefined;
2484
+ operator?: "equals" | "not_equals" | "exists" | "greater_than" | "less_than" | "in" | "not_exists" | undefined;
2448
2485
  event_name?: string | undefined;
2449
2486
  window_days?: number | undefined;
2450
2487
  };
@@ -2454,10 +2491,10 @@ export declare const toolDefinitions: {
2454
2491
  }, {
2455
2492
  journeyId: string;
2456
2493
  condition: {
2457
- kind: "attribute" | "event_fired" | "event_not_fired";
2494
+ kind: "event_not_fired" | "attribute" | "event_fired";
2458
2495
  value?: string | number | boolean | (string | number | boolean)[] | undefined;
2459
2496
  field_path?: string | undefined;
2460
- operator?: "equals" | "not_equals" | "greater_than" | "less_than" | "in" | "exists" | "not_exists" | undefined;
2497
+ operator?: "equals" | "not_equals" | "exists" | "greater_than" | "less_than" | "in" | "not_exists" | undefined;
2461
2498
  event_name?: string | undefined;
2462
2499
  window_days?: number | undefined;
2463
2500
  };
@@ -2863,11 +2900,11 @@ export declare const toolDefinitions: {
2863
2900
  kind: z.ZodEnum<["website", "ios", "android", "server", "pos", "kiosk", "extension", "other"]>;
2864
2901
  name: z.ZodString;
2865
2902
  }, "strip", z.ZodTypeAny, {
2866
- name: string;
2867
2903
  kind: "other" | "ios" | "android" | "website" | "server" | "pos" | "kiosk" | "extension";
2868
- }, {
2869
2904
  name: string;
2905
+ }, {
2870
2906
  kind: "other" | "ios" | "android" | "website" | "server" | "pos" | "kiosk" | "extension";
2907
+ name: string;
2871
2908
  }>;
2872
2909
  handler: ({ kind, name }: {
2873
2910
  kind: string;
@@ -2970,29 +3007,29 @@ export declare const toolDefinitions: {
2970
3007
  note: z.ZodOptional<z.ZodString>;
2971
3008
  wired: z.ZodOptional<z.ZodBoolean>;
2972
3009
  }, "strip", z.ZodTypeAny, {
2973
- surface: "mobile" | "web" | "server";
2974
3010
  name: string;
3011
+ surface: "mobile" | "web" | "server";
2975
3012
  wired?: boolean | undefined;
2976
3013
  note?: string | undefined;
2977
3014
  }, {
2978
- surface: "mobile" | "web" | "server";
2979
3015
  name: string;
3016
+ surface: "mobile" | "web" | "server";
2980
3017
  wired?: boolean | undefined;
2981
3018
  note?: string | undefined;
2982
3019
  }>, "many">;
2983
3020
  summary: z.ZodOptional<z.ZodString>;
2984
3021
  }, "strip", z.ZodTypeAny, {
2985
3022
  events: {
2986
- surface: "mobile" | "web" | "server";
2987
3023
  name: string;
3024
+ surface: "mobile" | "web" | "server";
2988
3025
  wired?: boolean | undefined;
2989
3026
  note?: string | undefined;
2990
3027
  }[];
2991
3028
  summary?: string | undefined;
2992
3029
  }, {
2993
3030
  events: {
2994
- surface: "mobile" | "web" | "server";
2995
3031
  name: string;
3032
+ surface: "mobile" | "web" | "server";
2996
3033
  wired?: boolean | undefined;
2997
3034
  note?: string | undefined;
2998
3035
  }[];
@@ -3023,15 +3060,15 @@ export declare const toolDefinitions: {
3023
3060
  externalId: z.ZodString;
3024
3061
  url: z.ZodOptional<z.ZodString>;
3025
3062
  }, "strip", z.ZodTypeAny, {
3026
- experimentId: string;
3027
3063
  kind: "pr" | "issue";
3064
+ experimentId: string;
3028
3065
  system: "github" | "github-issues" | "linear" | "jira" | "trello";
3029
3066
  externalId: string;
3030
3067
  url?: string | undefined;
3031
3068
  repo?: string | undefined;
3032
3069
  }, {
3033
- experimentId: string;
3034
3070
  kind: "pr" | "issue";
3071
+ experimentId: string;
3035
3072
  system: "github" | "github-issues" | "linear" | "jira" | "trello";
3036
3073
  externalId: string;
3037
3074
  url?: string | undefined;
@@ -3393,17 +3430,17 @@ export declare const toolDefinitions: {
3393
3430
  targetUrl: z.ZodOptional<z.ZodString>;
3394
3431
  isPrimary: z.ZodOptional<z.ZodBoolean>;
3395
3432
  }, "strip", z.ZodTypeAny, {
3396
- type: "form_submit" | "click" | "pageview" | "custom_event" | "file_download" | "engaged_time";
3397
3433
  name: string;
3398
- targetUrl?: string | undefined;
3434
+ type: "form_submit" | "click" | "pageview" | "custom_event" | "file_download" | "engaged_time";
3399
3435
  eventName?: string | undefined;
3436
+ targetUrl?: string | undefined;
3400
3437
  selector?: string | undefined;
3401
3438
  isPrimary?: boolean | undefined;
3402
3439
  }, {
3403
- type: "form_submit" | "click" | "pageview" | "custom_event" | "file_download" | "engaged_time";
3404
3440
  name: string;
3405
- targetUrl?: string | undefined;
3441
+ type: "form_submit" | "click" | "pageview" | "custom_event" | "file_download" | "engaged_time";
3406
3442
  eventName?: string | undefined;
3443
+ targetUrl?: string | undefined;
3407
3444
  selector?: string | undefined;
3408
3445
  isPrimary?: boolean | undefined;
3409
3446
  }>;
@@ -3506,44 +3543,52 @@ export declare const toolDefinitions: {
3506
3543
  eventName: z.ZodOptional<z.ZodString>;
3507
3544
  traitPath: z.ZodOptional<z.ZodString>;
3508
3545
  traitValue: z.ZodOptional<z.ZodString>;
3546
+ traitOp: z.ZodOptional<z.ZodEnum<["equals", "not_equals", "exists"]>>;
3509
3547
  priority: z.ZodOptional<z.ZodNumber>;
3510
3548
  order: z.ZodOptional<z.ZodNumber>;
3511
3549
  gapDays: z.ZodOptional<z.ZodNumber>;
3550
+ gapHours: z.ZodOptional<z.ZodNumber>;
3551
+ gapKind: z.ZodOptional<z.ZodEnum<["days_since_signup", "event_not_fired"]>>;
3552
+ sinceEventName: z.ZodOptional<z.ZodString>;
3553
+ enrollMode: z.ZodOptional<z.ZodEnum<["all", "future"]>>;
3512
3554
  active: z.ZodOptional<z.ZodBoolean>;
3513
3555
  }, "strip", z.ZodTypeAny, {
3514
3556
  name: string;
3515
3557
  featureKey: string;
3516
3558
  adoptedWhenKind: "event" | "trait";
3517
- active?: boolean | undefined;
3559
+ sinceEventName?: string | undefined;
3518
3560
  eventName?: string | undefined;
3519
3561
  traitPath?: string | undefined;
3520
- traitValue?: string | undefined;
3521
3562
  priority?: number | undefined;
3522
3563
  order?: number | undefined;
3564
+ active?: boolean | undefined;
3565
+ enrollMode?: "all" | "future" | undefined;
3566
+ traitValue?: string | undefined;
3567
+ traitOp?: "equals" | "not_equals" | "exists" | undefined;
3523
3568
  gapDays?: number | undefined;
3569
+ gapHours?: number | undefined;
3570
+ gapKind?: "days_since_signup" | "event_not_fired" | undefined;
3524
3571
  }, {
3525
3572
  name: string;
3526
3573
  featureKey: string;
3527
3574
  adoptedWhenKind: "event" | "trait";
3528
- active?: boolean | undefined;
3575
+ sinceEventName?: string | undefined;
3529
3576
  eventName?: string | undefined;
3530
3577
  traitPath?: string | undefined;
3531
- traitValue?: string | undefined;
3532
3578
  priority?: number | undefined;
3533
3579
  order?: number | undefined;
3580
+ active?: boolean | undefined;
3581
+ enrollMode?: "all" | "future" | undefined;
3582
+ traitValue?: string | undefined;
3583
+ traitOp?: "equals" | "not_equals" | "exists" | undefined;
3534
3584
  gapDays?: number | undefined;
3585
+ gapHours?: number | undefined;
3586
+ gapKind?: "days_since_signup" | "event_not_fired" | undefined;
3535
3587
  }>;
3536
- handler: (args: {
3588
+ handler: (args: AdoptionWriteArgs & {
3537
3589
  name: string;
3538
3590
  featureKey: string;
3539
3591
  adoptedWhenKind: "event" | "trait";
3540
- eventName?: string;
3541
- traitPath?: string;
3542
- traitValue?: string;
3543
- priority?: number;
3544
- order?: number;
3545
- gapDays?: number;
3546
- active?: boolean;
3547
3592
  }) => Promise<{
3548
3593
  content: {
3549
3594
  type: "text";
@@ -3560,32 +3605,41 @@ export declare const toolDefinitions: {
3560
3605
  order: z.ZodOptional<z.ZodNumber>;
3561
3606
  active: z.ZodOptional<z.ZodBoolean>;
3562
3607
  gapDays: z.ZodOptional<z.ZodNumber>;
3608
+ gapHours: z.ZodOptional<z.ZodNumber>;
3609
+ gapKind: z.ZodOptional<z.ZodEnum<["days_since_signup", "event_not_fired"]>>;
3610
+ sinceEventName: z.ZodOptional<z.ZodString>;
3611
+ enrollMode: z.ZodOptional<z.ZodEnum<["all", "future"]>>;
3563
3612
  nudgeJourneyId: z.ZodOptional<z.ZodString>;
3613
+ celebrationJourneyId: z.ZodOptional<z.ZodString>;
3564
3614
  }, "strip", z.ZodTypeAny, {
3565
3615
  milestoneId: string;
3616
+ sinceEventName?: string | undefined;
3566
3617
  name?: string | undefined;
3567
- active?: boolean | undefined;
3568
3618
  priority?: number | undefined;
3569
3619
  order?: number | undefined;
3570
- gapDays?: number | undefined;
3620
+ active?: boolean | undefined;
3571
3621
  nudgeJourneyId?: string | undefined;
3622
+ celebrationJourneyId?: string | undefined;
3623
+ enrollMode?: "all" | "future" | undefined;
3624
+ gapDays?: number | undefined;
3625
+ gapHours?: number | undefined;
3626
+ gapKind?: "days_since_signup" | "event_not_fired" | undefined;
3572
3627
  }, {
3573
3628
  milestoneId: string;
3629
+ sinceEventName?: string | undefined;
3574
3630
  name?: string | undefined;
3575
- active?: boolean | undefined;
3576
3631
  priority?: number | undefined;
3577
3632
  order?: number | undefined;
3578
- gapDays?: number | undefined;
3633
+ active?: boolean | undefined;
3579
3634
  nudgeJourneyId?: string | undefined;
3635
+ celebrationJourneyId?: string | undefined;
3636
+ enrollMode?: "all" | "future" | undefined;
3637
+ gapDays?: number | undefined;
3638
+ gapHours?: number | undefined;
3639
+ gapKind?: "days_since_signup" | "event_not_fired" | undefined;
3580
3640
  }>;
3581
- handler: (args: {
3641
+ handler: (args: AdoptionWriteArgs & {
3582
3642
  milestoneId: string;
3583
- name?: string;
3584
- priority?: number;
3585
- order?: number;
3586
- active?: boolean;
3587
- gapDays?: number;
3588
- nudgeJourneyId?: string;
3589
3643
  }) => Promise<{
3590
3644
  content: {
3591
3645
  type: "text";
@@ -3620,9 +3674,14 @@ export declare const toolDefinitions: {
3620
3674
  eventName: z.ZodOptional<z.ZodString>;
3621
3675
  traitPath: z.ZodOptional<z.ZodString>;
3622
3676
  traitValue: z.ZodOptional<z.ZodString>;
3677
+ traitOp: z.ZodOptional<z.ZodEnum<["equals", "not_equals", "exists"]>>;
3623
3678
  priority: z.ZodOptional<z.ZodNumber>;
3624
3679
  order: z.ZodOptional<z.ZodNumber>;
3625
3680
  gapDays: z.ZodOptional<z.ZodNumber>;
3681
+ gapHours: z.ZodOptional<z.ZodNumber>;
3682
+ gapKind: z.ZodOptional<z.ZodEnum<["days_since_signup", "event_not_fired"]>>;
3683
+ sinceEventName: z.ZodOptional<z.ZodString>;
3684
+ enrollMode: z.ZodOptional<z.ZodEnum<["all", "future"]>>;
3626
3685
  active: z.ZodOptional<z.ZodBoolean>;
3627
3686
  scaffold: z.ZodOptional<z.ZodEnum<["both", "celebration", "nudge", "none"]>>;
3628
3687
  journeyName: z.ZodOptional<z.ZodString>;
@@ -3630,40 +3689,43 @@ export declare const toolDefinitions: {
3630
3689
  name: string;
3631
3690
  featureKey: string;
3632
3691
  adoptedWhenKind: "event" | "trait";
3633
- active?: boolean | undefined;
3692
+ sinceEventName?: string | undefined;
3634
3693
  eventName?: string | undefined;
3635
3694
  traitPath?: string | undefined;
3636
- traitValue?: string | undefined;
3637
3695
  priority?: number | undefined;
3638
3696
  order?: number | undefined;
3697
+ active?: boolean | undefined;
3698
+ enrollMode?: "all" | "future" | undefined;
3699
+ traitValue?: string | undefined;
3700
+ traitOp?: "equals" | "not_equals" | "exists" | undefined;
3639
3701
  gapDays?: number | undefined;
3702
+ gapHours?: number | undefined;
3703
+ gapKind?: "days_since_signup" | "event_not_fired" | undefined;
3640
3704
  scaffold?: "none" | "both" | "celebration" | "nudge" | undefined;
3641
3705
  journeyName?: string | undefined;
3642
3706
  }, {
3643
3707
  name: string;
3644
3708
  featureKey: string;
3645
3709
  adoptedWhenKind: "event" | "trait";
3646
- active?: boolean | undefined;
3710
+ sinceEventName?: string | undefined;
3647
3711
  eventName?: string | undefined;
3648
3712
  traitPath?: string | undefined;
3649
- traitValue?: string | undefined;
3650
3713
  priority?: number | undefined;
3651
3714
  order?: number | undefined;
3715
+ active?: boolean | undefined;
3716
+ enrollMode?: "all" | "future" | undefined;
3717
+ traitValue?: string | undefined;
3718
+ traitOp?: "equals" | "not_equals" | "exists" | undefined;
3652
3719
  gapDays?: number | undefined;
3720
+ gapHours?: number | undefined;
3721
+ gapKind?: "days_since_signup" | "event_not_fired" | undefined;
3653
3722
  scaffold?: "none" | "both" | "celebration" | "nudge" | undefined;
3654
3723
  journeyName?: string | undefined;
3655
3724
  }>;
3656
- handler: (args: {
3725
+ handler: (args: AdoptionWriteArgs & {
3657
3726
  name: string;
3658
3727
  featureKey: string;
3659
3728
  adoptedWhenKind: "event" | "trait";
3660
- eventName?: string;
3661
- traitPath?: string;
3662
- traitValue?: string;
3663
- priority?: number;
3664
- order?: number;
3665
- gapDays?: number;
3666
- active?: boolean;
3667
3729
  scaffold?: "both" | "celebration" | "nudge" | "none";
3668
3730
  journeyName?: string;
3669
3731
  }) => Promise<{
@@ -3813,15 +3875,15 @@ export declare const toolDefinitions: {
3813
3875
  op: z.ZodOptional<z.ZodEnum<["is", "is_not", "exists"]>>;
3814
3876
  value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
3815
3877
  }, "strip", z.ZodTypeAny, {
3816
- value?: string | number | boolean | undefined;
3817
3878
  event?: string | undefined;
3879
+ value?: string | number | boolean | undefined;
3818
3880
  attribute?: string | undefined;
3819
3881
  window_days?: number | undefined;
3820
3882
  verb?: "has" | "hasnt" | undefined;
3821
3883
  op?: "exists" | "is" | "is_not" | undefined;
3822
3884
  }, {
3823
- value?: string | number | boolean | undefined;
3824
3885
  event?: string | undefined;
3886
+ value?: string | number | boolean | undefined;
3825
3887
  attribute?: string | undefined;
3826
3888
  window_days?: number | undefined;
3827
3889
  verb?: "has" | "hasnt" | undefined;
@@ -3830,8 +3892,8 @@ export declare const toolDefinitions: {
3830
3892
  }, "strip", z.ZodTypeAny, {
3831
3893
  match: "all" | "any";
3832
3894
  conditions: {
3833
- value?: string | number | boolean | undefined;
3834
3895
  event?: string | undefined;
3896
+ value?: string | number | boolean | undefined;
3835
3897
  attribute?: string | undefined;
3836
3898
  window_days?: number | undefined;
3837
3899
  verb?: "has" | "hasnt" | undefined;
@@ -3840,8 +3902,8 @@ export declare const toolDefinitions: {
3840
3902
  }, {
3841
3903
  match: "all" | "any";
3842
3904
  conditions: {
3843
- value?: string | number | boolean | undefined;
3844
3905
  event?: string | undefined;
3906
+ value?: string | number | boolean | undefined;
3845
3907
  attribute?: string | undefined;
3846
3908
  window_days?: number | undefined;
3847
3909
  verb?: "has" | "hasnt" | undefined;
@@ -3853,8 +3915,8 @@ export declare const toolDefinitions: {
3853
3915
  groups: {
3854
3916
  match: "all" | "any";
3855
3917
  conditions: {
3856
- value?: string | number | boolean | undefined;
3857
3918
  event?: string | undefined;
3919
+ value?: string | number | boolean | undefined;
3858
3920
  attribute?: string | undefined;
3859
3921
  window_days?: number | undefined;
3860
3922
  verb?: "has" | "hasnt" | undefined;
@@ -3866,8 +3928,8 @@ export declare const toolDefinitions: {
3866
3928
  groups: {
3867
3929
  match: "all" | "any";
3868
3930
  conditions: {
3869
- value?: string | number | boolean | undefined;
3870
3931
  event?: string | undefined;
3932
+ value?: string | number | boolean | undefined;
3871
3933
  attribute?: string | undefined;
3872
3934
  window_days?: number | undefined;
3873
3935
  verb?: "has" | "hasnt" | undefined;
@@ -3885,8 +3947,8 @@ export declare const toolDefinitions: {
3885
3947
  groups: {
3886
3948
  match: "all" | "any";
3887
3949
  conditions: {
3888
- value?: string | number | boolean | undefined;
3889
3950
  event?: string | undefined;
3951
+ value?: string | number | boolean | undefined;
3890
3952
  attribute?: string | undefined;
3891
3953
  window_days?: number | undefined;
3892
3954
  verb?: "has" | "hasnt" | undefined;
@@ -3904,8 +3966,8 @@ export declare const toolDefinitions: {
3904
3966
  groups: {
3905
3967
  match: "all" | "any";
3906
3968
  conditions: {
3907
- value?: string | number | boolean | undefined;
3908
3969
  event?: string | undefined;
3970
+ value?: string | number | boolean | undefined;
3909
3971
  attribute?: string | undefined;
3910
3972
  window_days?: number | undefined;
3911
3973
  verb?: "has" | "hasnt" | undefined;