rewind-mcp-server 0.10.0 → 1.0.0

package/dist/tools/schemas/cross-domain.js

@@ -0,0 +1,107 @@
+/**
+ * Output schemas for the cross-domain tools (issue #105).
+ *
+ * These schemas are the source of truth for the cross-domain tools'
+ * return shapes: `cross-domain.ts` derives its `SearchResult` /
+ * `FeedItem` / `OnThisDay` types from them via `z.infer`, so the
+ * declared schema and the TypeScript type cannot drift.
+ *
+ * Every object schema uses `.passthrough()` so the JSON Schema advertised
+ * to clients stays `additionalProperties`-open -- a field the Rewind API
+ * adds later does not break client-side validation. See schemas/shared.ts.
+ */
+import { z } from 'zod';
+import { imageSchema, searchPaginationSchema, feedPaginationSchema, } from './shared.js';
+// --- Element schemas ------------------------------------------------------
+/**
+ * A single cross-domain search result, as listed by `search` and
+ * `semantic_search`. The item mixes entries from every domain, so the
+ * domain-specific URL fields (`url`, `instapaper_url`, etc.) are all
+ * optional. `score` is present on semantic / hybrid results, optional on
+ * keyword results.
+ */
+export const searchResultSchema = z
+    .object({
+    domain: z.string(),
+    entity_type: z.string(),
+    entity_id: z.string(),
+    title: z.string(),
+    subtitle: z.string().nullable(),
+    image: imageSchema().optional(),
+    url: z.string().nullish(),
+    instapaper_url: z.string().nullish(),
+    instapaper_app_url: z.string().nullish(),
+    author: z.string().nullish(),
+    score: z.number().optional(),
+})
+    .passthrough();
+/** A single entry in the unified activity feed, as listed by `get_feed`. */
+export const feedItemSchema = z
+    .object({
+    domain: z.string(),
+    event_type: z.string(),
+    occurred_at: z.string(),
+    title: z.string(),
+    subtitle: z.string().nullable(),
+})
+    .passthrough();
+/** A single item inside an `get_on_this_day` year group. */
+const onThisDayItemSchema = z
+    .object({
+    domain: z.string(),
+    event_type: z.string(),
+    title: z.string(),
+    subtitle: z.string().nullable(),
+})
+    .passthrough();
+/** One year's worth of items inside an `get_on_this_day` response. */
+const onThisDayYearSchema = z
+    .object({
+    year: z.number(),
+    items: z.array(onThisDayItemSchema),
+})
+    .passthrough();
+// --- Tool output schemas --------------------------------------------------
+/**
+ * outputSchema for `search`. The empty-state branch returns
+ * `{ items: [], pagination }`, which satisfies the same schema -- no
+ * union needed.
+ */
+export const searchOutputSchema = z
+    .object({
+    items: z.array(searchResultSchema),
+    pagination: searchPaginationSchema(),
+})
+    .passthrough();
+/**
+ * outputSchema for `semantic_search`. Same shape as `search` -- both
+ * return `{ items, pagination }` with cross-domain result items.
+ */
+export const semanticSearchOutputSchema = z
+    .object({
+    items: z.array(searchResultSchema),
+    pagination: searchPaginationSchema(),
+})
+    .passthrough();
+/**
+ * outputSchema for `get_feed`. The empty-state branch returns
+ * `{ items: [], pagination }`, which satisfies the same schema.
+ */
+export const feedOutputSchema = z
+    .object({
+    items: z.array(feedItemSchema),
+    pagination: feedPaginationSchema(),
+})
+    .passthrough();
+/**
+ * outputSchema for `get_on_this_day`. The empty-state branch returns the
+ * same `{ month, day, years: [] }` shape with an empty `years` array.
+ */
+export const onThisDayOutputSchema = z
+    .object({
+    month: z.number(),
+    day: z.number(),
+    years: z.array(onThisDayYearSchema),
+})
+    .passthrough();
+//# sourceMappingURL=cross-domain.js.map

package/dist/tools/schemas/cross-domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-domain.js","sourceRoot":"","sources":["../../../src/tools/schemas/cross-domain.ts"],"names":[],"mappings":"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"}