npm - @ainyc/canonry - Versions diffs - 4.15.0 → 4.17.1 - Mend

@ainyc/canonry 4.15.0 → 4.17.1

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 (15) hide show

package/README.md +57 -223
package/assets/assets/index-4fWsYFLp.css +1 -0
package/assets/assets/index-C5-Gvl6o.js +302 -0
package/assets/index.html +2 -2
package/dist/{chunk-C32VL5BB.js → chunk-6TWKC3DP.js} +147 -12
package/dist/{chunk-7HBZCGRL.js → chunk-PAZCY4FF.js} +99 -4
package/dist/{chunk-6QTH5NS5.js → chunk-Q2OED5JQ.js} +75 -1
package/dist/{chunk-DLSQXNUN.js → chunk-ZGHD3IAV.js} +485 -150
package/dist/cli.js +248 -45
package/dist/index.js +4 -4
package/dist/{intelligence-service-BCKXIKIL.js → intelligence-service-X3PQLBUV.js} +2 -2
package/dist/mcp.js +9 -3
package/package.json +7 -7
package/assets/assets/index-B6Mi9Fd1.js +0 -302
package/assets/assets/index-D0EPNRDs.css +0 -1

package/assets/index.html CHANGED Viewed

@@ -12,8 +12,8 @@
     <link rel="icon" type="image/png" sizes="32x32" href="./favicon-32.png" />
     <link rel="apple-touch-icon" href="./apple-touch-icon.png" />
     <title>Canonry</title>
-    <script type="module" crossorigin src="./assets/index-B6Mi9Fd1.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-D0EPNRDs.css">
+    <script type="module" crossorigin src="./assets/index-C5-Gvl6o.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-4fWsYFLp.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/{chunk-C32VL5BB.js → chunk-6TWKC3DP.js} RENAMED Viewed

@@ -11,8 +11,11 @@ import {
   queryBatchRequestSchema,
   queryGenerateRequestSchema,
   runTriggerRequestSchema,
-  scheduleUpsertRequestSchema
-} from "./chunk-6QTH5NS5.js";
+  schedulableRunKindSchema,
+  scheduleUpsertRequestSchema,
+  trafficConnectCloudRunRequestSchema,
+  trafficEventKindSchema
+} from "./chunk-Q2OED5JQ.js";
 // src/config.ts
 import fs from "fs";
@@ -545,11 +548,13 @@ var ApiClient = class {
   async putSchedule(project, body) {
     return this.request("PUT", `/projects/${encodeURIComponent(project)}/schedule`, body);
   }
-  async getSchedule(project) {
-    return this.request("GET", `/projects/${encodeURIComponent(project)}/schedule`);
+  async getSchedule(project, kind) {
+    const qs = kind ? `?kind=${encodeURIComponent(kind)}` : "";
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/schedule${qs}`);
   }
-  async deleteSchedule(project) {
-    await this.request("DELETE", `/projects/${encodeURIComponent(project)}/schedule`);
+  async deleteSchedule(project, kind) {
+    const qs = kind ? `?kind=${encodeURIComponent(kind)}` : "";
+    await this.request("DELETE", `/projects/${encodeURIComponent(project)}/schedule${qs}`);
   }
   async createNotification(project, body) {
     return this.request("POST", `/projects/${encodeURIComponent(project)}/notifications`, body);
@@ -768,6 +773,37 @@ var ApiClient = class {
       body ?? {}
     );
   }
+  async trafficListSources(project) {
+    return this.request(
+      "GET",
+      `/projects/${encodeURIComponent(project)}/traffic/sources`
+    );
+  }
+  async trafficStatus(project) {
+    return this.request(
+      "GET",
+      `/projects/${encodeURIComponent(project)}/traffic/status`
+    );
+  }
+  async trafficGetSource(project, sourceId) {
+    return this.request(
+      "GET",
+      `/projects/${encodeURIComponent(project)}/traffic/sources/${encodeURIComponent(sourceId)}`
+    );
+  }
+  async trafficListEvents(project, params) {
+    const search = {};
+    if (params?.since) search.since = params.since;
+    if (params?.until) search.until = params.until;
+    if (params?.kind) search.kind = params.kind;
+    if (params?.limit !== void 0) search.limit = String(params.limit);
+    if (params?.sourceId) search.sourceId = params.sourceId;
+    const qs = Object.keys(search).length ? "?" + new URLSearchParams(search).toString() : "";
+    return this.request(
+      "GET",
+      `/projects/${encodeURIComponent(project)}/traffic/events${qs}`
+    );
+  }
   async wordpressConnect(project, body) {
     return this.request("POST", `/projects/${encodeURIComponent(project)}/wordpress/connect`, body);
   }
@@ -1114,6 +1150,10 @@ var scheduleSetInputSchema = z2.object({
   project: projectNameSchema,
   schedule: scheduleUpsertRequestSchema
 });
+var scheduleReadInputSchema = z2.object({
+  project: projectNameSchema,
+  kind: schedulableRunKindSchema.optional().describe('Schedulable run kind. Defaults to "answer-visibility" if omitted.')
+});
 var agentWebhookAttachInputSchema = z2.object({
   project: projectNameSchema,
   url: z2.string().url()
@@ -1141,6 +1181,27 @@ var memoryForgetInputSchema = z2.object({
   project: projectNameSchema,
   key: z2.string().min(1).max(AGENT_MEMORY_KEY_MAX_LENGTH).describe("Exact key of the note to remove. No-op (status=missing) when no note exists for that key.")
 });
+var trafficConnectCloudRunInputSchema = z2.object({
+  project: projectNameSchema,
+  request: trafficConnectCloudRunRequestSchema
+});
+var trafficSyncInputSchema = z2.object({
+  project: projectNameSchema,
+  sourceId: z2.string().min(1).describe("Traffic source ID returned by canonry_traffic_connect_cloud_run or canonry_traffic_sources_list."),
+  sinceMinutes: z2.number().int().positive().max(7 * 24 * 60).optional().describe("Lookback window in minutes. Defaults to the source's configured window (60 min) when omitted; clamped forward to lastSyncedAt to avoid double-counting.")
+});
+var trafficEventsInputSchema = z2.object({
+  project: projectNameSchema,
+  since: z2.string().optional().describe("ISO 8601 lower bound. Defaults to 24h ago when omitted."),
+  until: z2.string().optional().describe("ISO 8601 upper bound. Defaults to now when omitted."),
+  kind: z2.union([trafficEventKindSchema, z2.literal("all")]).optional().describe('Filter to "crawler" or "ai-referral"; "all" (default) returns both.'),
+  sourceId: z2.string().min(1).optional().describe("Restrict to a single traffic source ID."),
+  limit: z2.number().int().positive().max(5e3).optional().describe("Max combined rows. Defaults to 500, max 5000. Totals always reflect the full window.")
+});
+var trafficSourceIdInputSchema = z2.object({
+  project: projectNameSchema,
+  sourceId: z2.string().min(1).describe("Traffic source ID.")
+});
 var AGENT_WEBHOOK_EVENTS = [
   notificationEventSchema.enum["run.completed"],
   notificationEventSchema.enum["insight.critical"],
@@ -1444,13 +1505,13 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_schedule_get",
     title: "Get schedule",
-    description: "Get the scheduled run configuration for a Canonry project.",
+    description: 'Get the scheduled run configuration for a Canonry project. Pass `kind` to read a non-default schedule (e.g. "traffic-sync"); defaults to "answer-visibility".',
     access: "read",
     tier: "setup",
-    inputSchema: projectInputSchema,
+    inputSchema: scheduleReadInputSchema,
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/schedule"],
-    handler: (client, input) => client.getSchedule(input.project)
+    handler: (client, input) => client.getSchedule(input.project, input.kind)
   }),
   defineTool({
     name: "canonry_backlinks_latest_release",
@@ -1653,6 +1714,80 @@ var canonryMcpTools = [
     openApiOperations: ["GET /api/v1/projects/{name}/ga/session-history"],
     handler: (client, input) => client.gaSessionHistory(input.project, compactStringParams(input, ["window"]))
   }),
+  defineTool({
+    name: "canonry_traffic_sources_list",
+    title: "List traffic sources",
+    description: "List server-side traffic sources for a Canonry project (Cloud Run, etc.). Returns non-archived sources with status, last sync timestamp, last error, and the stored config (gcpProjectId, serviceName, location, authMode). Pair with canonry_traffic_source_get for last-24h totals on a single source.",
+    access: "read",
+    tier: "traffic",
+    inputSchema: projectInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/traffic/sources"],
+    handler: (client, input) => client.trafficListSources(input.project)
+  }),
+  defineTool({
+    name: "canonry_traffic_source_get",
+    title: "Get traffic source detail",
+    description: "Get one traffic source plus 24h totals (crawler hits, AI-referral hits, raw event sample count) and the latest traffic-sync run summary. Use to confirm a source is healthy and observing traffic before drilling into events.",
+    access: "read",
+    tier: "traffic",
+    inputSchema: trafficSourceIdInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/traffic/sources/{id}"],
+    handler: (client, input) => client.trafficGetSource(input.project, input.sourceId)
+  }),
+  defineTool({
+    name: "canonry_traffic_status",
+    title: "Traffic status (all sources)",
+    description: "Single-call composite returning every non-archived traffic source plus its last-24h totals (crawler hits, AI-referral hits, sample count) and latest source-scoped traffic-sync run. Same per-entry shape as canonry_traffic_source_get, but one call covers all sources \u2014 prefer this over a list+per-source fan-out.",
+    access: "read",
+    tier: "traffic",
+    inputSchema: projectInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/traffic/status"],
+    handler: (client, input) => client.trafficStatus(input.project)
+  }),
+  defineTool({
+    name: "canonry_traffic_events",
+    title: "List traffic events",
+    description: 'Read crawler and AI-referral hourly rollups from server-side traffic sources. Returns a discriminated list (kind="crawler" rows carry botId/operator/verificationStatus; kind="ai-referral" rows carry product/sourceDomain/evidenceType) plus totals over the full window even when limit truncates rows. Window defaults to last 24h.',
+    access: "read",
+    tier: "traffic",
+    inputSchema: trafficEventsInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/traffic/events"],
+    handler: (client, input) => {
+      const params = {};
+      if (input.since) params.since = input.since;
+      if (input.until) params.until = input.until;
+      if (input.kind) params.kind = input.kind;
+      if (input.sourceId) params.sourceId = input.sourceId;
+      if (input.limit !== void 0) params.limit = input.limit;
+      return client.trafficListEvents(input.project, params);
+    }
+  }),
+  defineTool({
+    name: "canonry_traffic_connect_cloud_run",
+    title: "Connect Cloud Run traffic source",
+    description: "Connect a Google Cloud Run service as a server-side traffic source. v1 requires service-account JSON content (paste the file contents into `keyJson`); OAuth-mode is not yet supported. Reconnecting an existing source updates the credential and config in place. The private key is stored in ~/.canonry/config.yaml (not the DB) and never echoed back.",
+    access: "write",
+    tier: "traffic",
+    inputSchema: trafficConnectCloudRunInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/traffic/connect/cloud-run"],
+    handler: (client, input) => client.trafficConnectCloudRun(input.project, input.request)
+  }),
+  defineTool({
+    name: "canonry_traffic_sync",
+    title: "Sync Cloud Run traffic source",
+    description: "Pull the most recent Cloud Logging entries for a Cloud Run traffic source, classify them as crawler / AI-referral / unknown, and upsert hourly rollups + raw samples. Returns totals, bucket counts, and the run id. The window auto-clamps forward to lastSyncedAt to avoid double-counting on back-to-back calls.",
+    access: "write",
+    tier: "traffic",
+    inputSchema: trafficSyncInputSchema,
+    annotations: writeAnnotations({ idempotentHint: false, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/traffic/sources/{id}/sync"],
+    handler: (client, input) => client.trafficSync(input.project, input.sourceId, input.sinceMinutes !== void 0 ? { sinceMinutes: input.sinceMinutes } : void 0)
+  }),
   defineTool({
     name: "canonry_project_upsert",
     title: "Create or replace project",
@@ -1838,14 +1973,14 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_schedule_delete",
     title: "Delete schedule",
-    description: "Delete the scheduled run configuration for a Canonry project.",
+    description: 'Delete the scheduled run configuration for a Canonry project. Pass `kind` to delete a non-default schedule (e.g. "traffic-sync"); defaults to "answer-visibility".',
     access: "write",
     tier: "setup",
-    inputSchema: projectInputSchema,
+    inputSchema: scheduleReadInputSchema,
     annotations: writeAnnotations({ idempotentHint: false, destructiveHint: true }),
     openApiOperations: ["DELETE /api/v1/projects/{name}/schedule"],
     handler: async (client, input) => {
-      await client.deleteSchedule(input.project);
+      await client.deleteSchedule(input.project, input.kind);
     }
   }),
   defineTool({

package/dist/{chunk-7HBZCGRL.js → chunk-PAZCY4FF.js} RENAMED Viewed

@@ -8,7 +8,7 @@ import {
   categoryLabel,
   determineAnswerMentioned,
   normalizeProjectDomain
-} from "./chunk-6QTH5NS5.js";
+} from "./chunk-Q2OED5JQ.js";
 // src/intelligence-service.ts
 import { eq, desc, asc, and, or, inArray } from "drizzle-orm";
@@ -104,13 +104,15 @@ var runs = sqliteTable("runs", {
   status: text("status").notNull().default("queued"),
   trigger: text("trigger").notNull().default("manual"),
   location: text("location"),
+  sourceId: text("source_id"),
   startedAt: text("started_at"),
   finishedAt: text("finished_at"),
   error: text("error"),
   createdAt: text("created_at").notNull()
 }, (table) => [
   index("idx_runs_project").on(table.projectId),
-  index("idx_runs_status").on(table.status)
+  index("idx_runs_status").on(table.status),
+  index("idx_runs_source").on(table.sourceId)
 ]);
 var querySnapshots = sqliteTable("query_snapshots", {
   id: text("id").primaryKey(),
@@ -164,17 +166,24 @@ var apiKeys = sqliteTable("api_keys", {
 var schedules = sqliteTable("schedules", {
   id: text("id").primaryKey(),
   projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
+  // Run kind dispatched by this schedule. Must be a value of `RunKinds` —
+  // currently 'answer-visibility' and 'traffic-sync' are user-facing schedulable kinds.
+  // Defaults to 'answer-visibility' for backward compatibility with rows
+  // created before migration 53.
+  kind: text("kind").notNull().default("answer-visibility"),
   cronExpr: text("cron_expr").notNull(),
   preset: text("preset"),
   timezone: text("timezone").notNull().default("UTC"),
   enabled: integer("enabled").notNull().default(1),
   providers: text("providers").notNull().default("[]"),
+  /** Optional traffic-source UUID for traffic-sync schedules. Null for other kinds. */
+  sourceId: text("source_id"),
   lastRunAt: text("last_run_at"),
   nextRunAt: text("next_run_at"),
   createdAt: text("created_at").notNull(),
   updatedAt: text("updated_at").notNull()
 }, (table) => [
-  uniqueIndex("idx_schedules_project").on(table.projectId)
+  uniqueIndex("idx_schedules_project_kind").on(table.projectId, table.kind)
 ]);
 var notifications = sqliteTable("notifications", {
   id: text("id").primaryKey(),
@@ -555,6 +564,11 @@ var trafficSources = sqliteTable("traffic_sources", {
   lastSyncedAt: text("last_synced_at"),
   lastCursor: text("last_cursor"),
   lastError: text("last_error"),
+  // JSON-encoded array of normalized event IDs (e.g. `cloud-run:<ts>:<insertId>`)
+  // observed in the most recent successful sync. Bounded ring buffer used to
+  // dedupe across sync runs at the boundary timestamp where lastSyncedAt
+  // clamping alone leaves a small overlap window.
+  lastEventIds: text("last_event_ids"),
   archivedAt: text("archived_at"),
   configJson: text("config_json").notNull().default("{}"),
   createdAt: text("created_at").notNull(),
@@ -793,7 +807,10 @@ CREATE TABLE IF NOT EXISTS notifications (
 CREATE INDEX IF NOT EXISTS idx_api_keys_prefix ON api_keys(key_prefix);
 CREATE INDEX IF NOT EXISTS idx_usage_scope_period ON usage_counters(scope, period);
-CREATE UNIQUE INDEX IF NOT EXISTS idx_schedules_project ON schedules(project_id);
+-- NOTE: the (project_id) UNIQUE INDEX that used to live here was replaced by
+-- v53's (project_id, kind) index. MIGRATION_SQL re-runs on every boot, so we
+-- must NOT recreate the single-column index \u2014 it would conflict with v53 and
+-- break traffic-sync schedule creation.
 CREATE INDEX IF NOT EXISTS idx_notifications_project ON notifications(project_id);
 -- Migration tracking: records which version has been applied.
@@ -1586,6 +1603,84 @@ var MIGRATION_VERSIONS = [
       tx.run(sql.raw(`CREATE UNIQUE INDEX IF NOT EXISTS idx_ga_ai_ref_unique_v4
          ON ga_ai_referrals(project_id, date, source, medium, source_dimension, channel_group, landing_page)`));
     }
+  },
+  {
+    version: 51,
+    name: "runs-source-id",
+    statements: [
+      `ALTER TABLE runs ADD COLUMN source_id TEXT`,
+      `CREATE INDEX IF NOT EXISTS idx_runs_source ON runs(source_id)`
+    ]
+  },
+  {
+    version: 52,
+    name: "traffic-sources-last-event-ids",
+    statements: [
+      // JSON-encoded array of normalized event IDs from the previous sync,
+      // used for cross-sync boundary-window dedupe so a longer default
+      // sync window (or any overlapping re-sync) cannot double-count.
+      `ALTER TABLE traffic_sources ADD COLUMN last_event_ids TEXT`
+    ]
+  },
+  {
+    version: 53,
+    name: "schedules-kind-and-source",
+    // The legacy schedules table carries an inline `UNIQUE(project_id)`
+    // constraint (see MIGRATION_SQL). SQLite doesn't support dropping inline
+    // table constraints, so we use the canonical table-rebuild pattern:
+    // create a new table with the desired schema, copy the data, drop the
+    // old, rename. All 4 statements run inside the migration runner's
+    // single transaction so a partial failure rolls everything back.
+    statements: [
+      // (project_id, kind) uniqueness is enforced by the explicit
+      // `CREATE UNIQUE INDEX idx_schedules_project_kind` below — that's the
+      // canonical drizzle-side index name (see schema.ts), so don't duplicate
+      // it as an inline UNIQUE() in CREATE TABLE.
+      `CREATE TABLE IF NOT EXISTS schedules_v53 (
+         id          TEXT PRIMARY KEY,
+         project_id  TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+         kind        TEXT NOT NULL DEFAULT 'answer-visibility',
+         cron_expr   TEXT NOT NULL,
+         preset      TEXT,
+         timezone    TEXT NOT NULL DEFAULT 'UTC',
+         enabled     INTEGER NOT NULL DEFAULT 1,
+         providers   TEXT NOT NULL DEFAULT '[]',
+         source_id   TEXT,
+         last_run_at TEXT,
+         next_run_at TEXT,
+         created_at  TEXT NOT NULL,
+         updated_at  TEXT NOT NULL
+       )`,
+      `INSERT INTO schedules_v53 (
+         id, project_id, kind, cron_expr, preset, timezone, enabled,
+         providers, source_id, last_run_at, next_run_at, created_at, updated_at
+       )
+       SELECT id, project_id, 'answer-visibility', cron_expr, preset, timezone, enabled,
+              providers, NULL, last_run_at, next_run_at, created_at, updated_at
+       FROM schedules`,
+      `DROP TABLE schedules`,
+      `ALTER TABLE schedules_v53 RENAME TO schedules`,
+      // The legacy single-column unique index doesn't survive the table
+      // rename, but explicitly DROP IF EXISTS to keep the migration
+      // idempotent across edge-case re-runs.
+      `DROP INDEX IF EXISTS idx_schedules_project`,
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_schedules_project_kind ON schedules(project_id, kind)`
+    ]
+  },
+  {
+    version: 54,
+    name: "drop-resurrected-schedules-project-index",
+    // v53 dropped `idx_schedules_project`, but `MIGRATION_SQL` (which runs on
+    // every boot, before versioned migrations) was still creating it. On any
+    // boot AFTER the one that applied v53, Phase 1 re-created the legacy
+    // single-column UNIQUE index, which then collided with the new
+    // (project_id, kind) semantics and broke traffic-sync schedule creation
+    // (`UNIQUE constraint failed: schedules.project_id`). MIGRATION_SQL no
+    // longer creates that index; this migration removes it from any DB that
+    // already booted past v53 with the resurrected index.
+    statements: [
+      `DROP INDEX IF EXISTS idx_schedules_project`
+    ]
   }
 ];
 function isDuplicateColumnError(err) {

package/dist/{chunk-6QTH5NS5.js → chunk-Q2OED5JQ.js} RENAMED Viewed

@@ -1022,25 +1022,35 @@ var snapshotReportSchema = z9.object({
 // ../contracts/src/schedule.ts
 import { z as z10 } from "zod";
+var schedulableRunKindSchema = z10.enum(["answer-visibility", "traffic-sync"]);
+var SchedulableRunKinds = schedulableRunKindSchema.enum;
 var scheduleDtoSchema = z10.object({
   id: z10.string(),
   projectId: z10.string(),
+  /** Run kind dispatched when this schedule fires. Defaults to 'answer-visibility' for legacy rows. */
+  kind: schedulableRunKindSchema,
   cronExpr: z10.string(),
   preset: z10.string().nullable().optional(),
   timezone: z10.string().default("UTC"),
   enabled: z10.boolean().default(true),
   providers: z10.array(providerNameSchema).default([]),
+  /** Traffic-source UUID for `kind === 'traffic-sync'` schedules. Null otherwise. */
+  sourceId: z10.string().nullable().optional(),
   lastRunAt: z10.string().nullable().optional(),
   nextRunAt: z10.string().nullable().optional(),
   createdAt: z10.string(),
   updatedAt: z10.string()
 });
 var scheduleUpsertRequestSchema = z10.object({
+  /** Run kind. Defaults to 'answer-visibility' so existing callers don't have to change. */
+  kind: schedulableRunKindSchema.optional(),
   preset: z10.string().optional(),
   cron: z10.string().optional(),
   timezone: z10.string().optional().default("UTC"),
   enabled: z10.boolean().optional().default(true),
-  providers: z10.array(providerNameSchema).optional().default([])
+  providers: z10.array(providerNameSchema).optional().default([]),
+  /** Required when kind === 'traffic-sync'. Forbidden for other kinds. Validated server-side. */
+  sourceId: z10.string().optional()
 }).refine(
   (data) => data.preset && !data.cron || !data.preset && data.cron,
   { message: 'Exactly one of "preset" or "cron" must be provided' }
@@ -2251,6 +2261,65 @@ var trafficSyncResponseSchema = z20.object({
   windowStart: z20.string(),
   windowEnd: z20.string()
 });
+var trafficSourceTotalsSchema = z20.object({
+  crawlerHits: z20.number().int().nonnegative(),
+  aiReferralHits: z20.number().int().nonnegative(),
+  sampleCount: z20.number().int().nonnegative()
+});
+var trafficSourceListResponseSchema = z20.object({
+  sources: z20.array(trafficSourceDtoSchema)
+});
+var trafficSourceDetailDtoSchema = trafficSourceDtoSchema.extend({
+  totals24h: trafficSourceTotalsSchema,
+  latestRun: z20.object({
+    runId: z20.string(),
+    status: runStatusSchema,
+    startedAt: z20.string().nullable(),
+    finishedAt: z20.string().nullable(),
+    error: z20.string().nullable()
+  }).nullable()
+});
+var trafficStatusResponseSchema = z20.object({
+  sources: z20.array(trafficSourceDetailDtoSchema)
+});
+var trafficEventKindSchema = z20.enum(["crawler", "ai-referral"]);
+var TrafficEventKinds = trafficEventKindSchema.enum;
+var trafficCrawlerEventEntrySchema = z20.object({
+  kind: z20.literal(TrafficEventKinds.crawler),
+  sourceId: z20.string(),
+  tsHour: z20.string(),
+  botId: z20.string(),
+  operator: z20.string(),
+  verificationStatus: z20.string(),
+  pathNormalized: z20.string(),
+  status: z20.number().int(),
+  hits: z20.number().int().nonnegative()
+});
+var trafficAiReferralEventEntrySchema = z20.object({
+  kind: z20.literal(TrafficEventKinds["ai-referral"]),
+  sourceId: z20.string(),
+  tsHour: z20.string(),
+  product: z20.string(),
+  operator: z20.string(),
+  sourceDomain: z20.string(),
+  evidenceType: z20.string(),
+  landingPathNormalized: z20.string(),
+  status: z20.number().int(),
+  hits: z20.number().int().nonnegative()
+});
+var trafficEventEntrySchema = z20.discriminatedUnion("kind", [
+  trafficCrawlerEventEntrySchema,
+  trafficAiReferralEventEntrySchema
+]);
+var trafficEventsResponseSchema = z20.object({
+  windowStart: z20.string(),
+  windowEnd: z20.string(),
+  totals: z20.object({
+    crawlerHits: z20.number().int().nonnegative(),
+    aiReferralHits: z20.number().int().nonnegative()
+  }),
+  events: z20.array(trafficEventEntrySchema)
+});
 // ../contracts/src/formatting.ts
 function formatRatio(value) {
@@ -2347,6 +2416,8 @@ export {
   formatRunErrorOneLine,
   snapshotRequestSchema,
   resolveSnapshotRequestQueries,
+  schedulableRunKindSchema,
+  SchedulableRunKinds,
   scheduleUpsertRequestSchema,
   parseWindow,
   windowCutoff,
@@ -2389,6 +2460,9 @@ export {
   TrafficEventConfidences,
   TrafficSourceStatuses,
   TrafficSourceAuthModes,
+  trafficConnectCloudRunRequestSchema,
+  trafficEventKindSchema,
+  TrafficEventKinds,
   formatRatio,
   formatNumber,
   formatDate,