@relvo/mcp 0.1.2 → 0.1.4

package/dist/schema/platformTriggers.js

@@ -0,0 +1,152 @@
+import { z } from "zod";
+import { projectScopeSchema, platformJsonObjectSchema, platformMicrosSchema } from "./platformPublicExecution.js";
+import { platformMonitorDestinationInputSchema, platformMonitorDestinationSchema, platformMonitorRecipientSchema, PLATFORM_MONITOR_DESTINATION_LIMITS } from "./platformMonitors.js";
+import { platformWorkflowSlugSchema } from "./platformWorkflows.js";
+import { PLATFORM_FREE_TOOL_OVERAGE_MICROS } from "./platformBillingConstants.js";
+export const PLATFORM_TRIGGER_LIMITS = {
+    perProject: 50,
+    perTeam: 100,
+    nameChars: 80,
+    eventsPage: 100,
+    eventDataBytes: 65_536,
+    ingressBodyBytes: 1_048_576,
+    retentionDays: 30,
+    keptEvents: 10_000,
+    eventsPerBatch: 100,
+    typesPage: 100,
+};
+export const PLATFORM_TRIGGER_INTERVALS = { "1m": 60, "5m": 300, "15m": 900, "1h": 3_600 };
+export const platformTriggerIntervalSchema = z.enum(["1m", "5m", "15m", "1h"]);
+export const PLATFORM_TRIGGER_DEFAULT_MAXIMUM_CHARGE_MICROS_PER_POLL = PLATFORM_FREE_TOOL_OVERAGE_MICROS;
+export const PLATFORM_TRIGGER_ID = /^trg_[A-Za-z0-9_-]{1,100}$/;
+export const platformTriggerIdSchema = z.string().regex(PLATFORM_TRIGGER_ID);
+export const PLATFORM_TRIGGER_TYPE = /^[a-z0-9][a-z0-9_]{0,63}\.[a-z0-9][a-z0-9_.]{0,79}$/;
+export const platformTriggerTypeIdSchema = z.string().regex(PLATFORM_TRIGGER_TYPE);
+const toolName = z.string().regex(/^[a-z][a-z0-9_]{1,127}$/);
+const connectionId = z.string().min(1).max(128);
+const pointer = z.string().max(200).regex(/^(\/[^/]*)*$/);
+export const platformTriggerDestinationKindSchema = z.enum(["webhook", "slack", "discord", "email", "workflow"]);
+const workflowDestination = z.object({
+    kind: z.literal("workflow"),
+    label: z.string().trim().max(PLATFORM_MONITOR_DESTINATION_LIMITS.labelChars).default(""),
+    workflow: platformWorkflowSlugSchema,
+    input: z.string().regex(/^[A-Za-z_][A-Za-z0-9_]{0,63}$/).default("event").describe("The workflow input that receives the event object."),
+    maximumChargeMicros: platformMicrosSchema,
+}).strict();
+export const platformTriggerDestinationInputSchema = z.union([platformMonitorDestinationInputSchema, workflowDestination]);
+export const platformTriggerDestinationSchema = platformMonitorDestinationSchema.extend({
+    kind: platformTriggerDestinationKindSchema,
+    workflow: z.object({ slug: platformWorkflowSlugSchema, input: z.string(), maximumChargeMicros: platformMicrosSchema }).nullable().default(null),
+});
+const common = {
+    name: z.string().trim().max(PLATFORM_TRIGGER_LIMITS.nameChars).default("").describe("Empty names the trigger after its type or operation."),
+    connectionId: connectionId.describe("The connection of the app, from /tools/connections."),
+    destinations: z.array(platformTriggerDestinationInputSchema).max(PLATFORM_MONITOR_DESTINATION_LIMITS.perMonitor).default([]),
+};
+export const platformTriggerCreateSchema = z.discriminatedUnion("kind", [
+    z.object({
+        kind: z.literal("poll"),
+        tool: toolName.describe("A read operation of the connected app, for example github__issues_list_for_repo."),
+        arguments: platformJsonObjectSchema.default({}).describe("The operation's arguments without connectionId."),
+        interval: platformTriggerIntervalSchema.default("5m"),
+        itemsPath: pointer.optional().describe("Where the list of items is in the response body. Omit to use the largest list."),
+        maximumChargeMicrosPerPoll: platformMicrosSchema.default(PLATFORM_TRIGGER_DEFAULT_MAXIMUM_CHARGE_MICROS_PER_POLL),
+        ...common,
+    }).strict(),
+    z.object({
+        kind: z.literal("webhook"),
+        type: platformTriggerTypeIdSchema.describe("A trigger type from /trigger-types, for example github.push."),
+        config: platformJsonObjectSchema.default({}).describe("The type's settings, valid against its configSchema."),
+        ...common,
+    }).strict(),
+]);
+export const platformTriggerUpdateSchema = z.object({
+    enabled: z.boolean().optional(),
+    name: z.string().trim().max(PLATFORM_TRIGGER_LIMITS.nameChars).optional().describe("Empty or omitted keeps the name."),
+}).strict();
+export const platformTriggerStatusSchema = z.enum(["active", "disabled", "failed"]);
+export const platformTriggerSchema = z.object({
+    id: platformTriggerIdSchema,
+    name: z.string(),
+    kind: z.enum(["poll", "webhook"]),
+    app: z.string(),
+    connectionId: z.string(),
+    status: platformTriggerStatusSchema,
+    statusReason: z.string().nullable(),
+    tool: z.string().nullable(),
+    arguments: platformJsonObjectSchema.nullable(),
+    interval: platformTriggerIntervalSchema.nullable(),
+    itemsPath: z.string().nullable(),
+    maximumChargeMicrosPerPoll: platformMicrosSchema.nullable(),
+    type: z.string().nullable(),
+    config: platformJsonObjectSchema.nullable(),
+    apiKeyId: z.string(),
+    lastCheckedAt: z.string().nullable(),
+    lastEventAt: z.string().nullable(),
+    nextCheckAt: z.string().nullable(),
+    lastError: z.string().nullable(),
+    createdAt: z.string(),
+    destinations: z.array(platformTriggerDestinationSchema),
+});
+export const platformTriggerEventSchema = z.object({
+    id: z.string().regex(/^\d{1,20}$/),
+    triggerId: platformTriggerIdSchema,
+    type: z.string(),
+    key: z.string(),
+    title: z.string(),
+    url: z.string(),
+    data: platformJsonObjectSchema,
+    receivedAt: z.string(),
+});
+export const platformTriggerEventsQuerySchema = z.object({
+    after: z.string().regex(/^\d{1,20}$/).optional(),
+    limit: z.coerce.number().int().min(1).max(PLATFORM_TRIGGER_LIMITS.eventsPage).default(50),
+}).strict();
+export const platformTriggerEventsSchema = z.object({ events: z.array(platformTriggerEventSchema), nextAfter: z.string().nullable() });
+export const platformTriggerTypeSchema = z.object({
+    type: platformTriggerTypeIdSchema,
+    app: z.string(),
+    name: z.string(),
+    description: z.string(),
+    configSchema: platformJsonObjectSchema,
+    setup: z.enum(["automatic", "app"]),
+    available: z.boolean(),
+    unavailableReason: z.string().nullable(),
+});
+export const platformTriggerOperationSchema = z.object({ tool: toolName, app: z.string(), description: z.string(), inputSchema: platformJsonObjectSchema });
+export const platformTriggerTypesQuerySchema = z.object({
+    app: z.string().regex(/^[a-z0-9][a-z0-9_]{0,63}$/),
+    connectionId: z.string().max(128).optional(),
+    query: z.string().trim().max(100).default(""),
+    offset: z.coerce.number().int().min(0).max(100_000).default(0),
+    limit: z.coerce.number().int().min(1).max(PLATFORM_TRIGGER_LIMITS.typesPage).default(50),
+}).strict();
+export const platformTriggerTypesSchema = z.object({
+    types: z.array(platformTriggerTypeSchema),
+    operations: z.array(platformTriggerOperationSchema),
+    total: z.number().int().min(0),
+});
+export const platformTriggerDeliverySchema = z.object({
+    version: z.literal(1),
+    type: z.literal("trigger.event"),
+    deliveryId: z.string(),
+    trigger: z.object({ id: platformTriggerIdSchema, name: z.string(), kind: z.enum(["poll", "webhook"]), app: z.string(), source: z.string(), connectionId: z.string() }).strict(),
+    event: platformTriggerEventSchema.omit({ triggerId: true }),
+}).strict();
+const projectTrigger = projectScopeSchema.extend({ triggerId: platformTriggerIdSchema });
+export const platformTriggerContracts = {
+    listDeveloperTriggers: { input: projectScopeSchema.strict(), output: z.object({ triggers: z.array(platformTriggerSchema) }).strict() },
+    createDeveloperTrigger: { input: projectScopeSchema.extend({ apiKeyId: z.string().min(1).max(128), trigger: platformTriggerCreateSchema }).strict(),
+        output: z.object({ trigger: platformTriggerSchema }).strict() },
+    updateDeveloperTrigger: { input: projectTrigger.merge(platformTriggerUpdateSchema).strict(), output: z.object({ trigger: platformTriggerSchema }).strict() },
+    deleteDeveloperTrigger: { input: projectTrigger.strict(), output: z.object({ success: z.literal(true) }).strict() },
+    listDeveloperTriggerEvents: {
+        input: projectScopeSchema.extend({ triggerId: platformTriggerIdSchema.optional(), after: platformTriggerEventsQuerySchema.shape.after,
+            limit: z.number().int().min(1).max(PLATFORM_TRIGGER_LIMITS.eventsPage).default(50) }).strict(),
+        output: platformTriggerEventsSchema,
+    },
+    listDeveloperTriggerTypes: { input: projectScopeSchema.merge(platformTriggerTypesQuerySchema).strict(), output: platformTriggerTypesSchema },
+    addDeveloperTriggerDestination: { input: projectTrigger.extend({ destination: platformTriggerDestinationInputSchema }).strict(), output: z.object({ trigger: platformTriggerSchema }).strict() },
+    removeDeveloperTriggerDestination: { input: projectTrigger.extend({ destinationId: platformTriggerDestinationSchema.shape.id }).strict(), output: z.object({ trigger: platformTriggerSchema }).strict() },
+    listDeveloperTriggerRecipients: { input: projectScopeSchema.strict(), output: z.object({ recipients: z.array(platformMonitorRecipientSchema) }).strict() },
+};

package/dist/schema/platformWorkflows.js

@@ -0,0 +1,100 @@
+import { z } from "zod";
+import { platformExecutionIdSchema, platformJsonObjectSchema, platformMicrosSchema, platformProviderChoiceSchema, platformToolNameSchema } from "./platformPublicExecution.js";
+import { platformCustomToolInputSchemaSchema } from "./platformCustomTools.js";
+export const PLATFORM_WORKFLOW_LIMITS = {
+    perProject: 50,
+    steps: 20,
+    versions: 50,
+    activeRunsPerProject: 10,
+    titleChars: 80,
+    descriptionChars: 1_000,
+    stepsBytes: 32_768,
+    inputBytes: 16_384,
+};
+export const PLATFORM_WORKFLOW_SLUG = /^[a-z][a-z0-9_]{1,39}$/;
+export const platformWorkflowSlugSchema = z.string().regex(PLATFORM_WORKFLOW_SLUG).describe("Lowercase letters, digits and underscores, starting with a letter.");
+export const platformWorkflowStepIdSchema = z.string().regex(/^[a-z][a-z0-9_]{0,39}$/);
+export const platformWorkflowRunIdSchema = z.string().regex(/^wfr_[A-Za-z0-9_-]{1,100}$/);
+const pointerSchema = z.string().max(500).regex(/^(?:\/(?:[^~/]|~[01])*)*$/, "A JSON Pointer such as /data/companies/0/name");
+const referenceSchema = z.union([z.object({ $input: z.string(), path: z.string().optional() }).strict(), z.object({ $step: z.string(), path: z.string().optional() }).strict()]);
+export function platformWorkflowReference(value) {
+    const parsed = referenceSchema.safeParse(value);
+    if (!parsed.success)
+        return undefined;
+    const path = parsed.data.path ?? "";
+    return "$input" in parsed.data ? { kind: "input", name: parsed.data.$input, path } : { kind: "step", step: parsed.data.$step, path };
+}
+export function platformWorkflowReferences(value) {
+    const reference = platformWorkflowReference(value);
+    if (reference)
+        return [reference];
+    if (Array.isArray(value))
+        return value.flatMap(platformWorkflowReferences);
+    if (value !== null && typeof value === "object")
+        return Object.values(value).flatMap(platformWorkflowReferences);
+    return [];
+}
+export const platformWorkflowStepSchema = z.object({
+    id: platformWorkflowStepIdSchema.describe("Names the step for later steps' references: lowercase letters, digits and underscores."),
+    tool: platformToolNameSchema.describe("A tool of the project's catalog."),
+    arguments: platformJsonObjectSchema.describe("The tool's arguments. Write {\"$input\":\"name\"} for a run input or {\"$step\":\"id\",\"path\":\"/data/0/url\"} for a value of an earlier step's output."),
+    provider: platformProviderChoiceSchema,
+}).strict();
+const byteLength = (value) => new TextEncoder().encode(JSON.stringify(value)).byteLength;
+const inputNames = (inputSchema) => {
+    const properties = inputSchema.properties;
+    return new Set(properties !== null && typeof properties === "object" && !Array.isArray(properties) ? Object.keys(properties) : []);
+};
+const definitionShape = {
+    title: z.string().trim().min(1).max(PLATFORM_WORKFLOW_LIMITS.titleChars),
+    description: z.string().trim().min(1).max(PLATFORM_WORKFLOW_LIMITS.descriptionChars).describe("What the workflow does and returns; agents choose workflows by it."),
+    inputSchema: platformCustomToolInputSchemaSchema.describe("JSON Schema of the run inputs, e.g. {\"type\":\"object\",\"properties\":{\"domain\":{\"type\":\"string\"}},\"required\":[\"domain\"]}."),
+    steps: z.array(platformWorkflowStepSchema).min(1).max(PLATFORM_WORKFLOW_LIMITS.steps).describe("Tool calls in the order they run; each starts after the previous one succeeded."),
+};
+function checkDefinition(definition, context) {
+    if (byteLength(definition.steps) > PLATFORM_WORKFLOW_LIMITS.stepsBytes)
+        context.addIssue({ code: "custom", path: ["steps"], message: "The steps are too large" });
+    const inputs = inputNames(definition.inputSchema), earlier = new Set();
+    definition.steps.forEach((step, index) => {
+        if (earlier.has(step.id))
+            context.addIssue({ code: "custom", path: ["steps", index, "id"], message: "Each step id is used once" });
+        for (const reference of platformWorkflowReferences(step.arguments)) {
+            if (!pointerSchema.safeParse(reference.path).success)
+                context.addIssue({ code: "custom", path: ["steps", index, "arguments"], message: `Invalid path ${reference.path}` });
+            else if (reference.kind === "input" && !inputs.has(reference.name))
+                context.addIssue({ code: "custom", path: ["steps", index, "arguments"], message: `No input named ${reference.name}` });
+            else if (reference.kind === "step" && !earlier.has(reference.step))
+                context.addIssue({ code: "custom", path: ["steps", index, "arguments"], message: `No earlier step named ${reference.step}` });
+        }
+        earlier.add(step.id);
+    });
+}
+export const platformWorkflowDefinitionSchema = z.object(definitionShape).strict().superRefine(checkDefinition);
+export const platformWorkflowCreateSchema = z.object({ ...definitionShape, slug: platformWorkflowSlugSchema }).strict().superRefine(checkDefinition);
+export const platformWorkflowUpdateSchema = z.object({ ...definitionShape, expectedVersion: z.number().int().min(1) }).strict().superRefine(checkDefinition);
+export const platformWorkflowSchema = z.object({ slug: platformWorkflowSlugSchema, title: z.string(), description: z.string(), inputSchema: platformJsonObjectSchema,
+    steps: z.array(platformWorkflowStepSchema), version: z.number().int().min(1), createdAt: z.string(), updatedAt: z.string() });
+export const platformWorkflowSummarySchema = platformWorkflowSchema.omit({ inputSchema: true, steps: true });
+export const platformWorkflowVersionSchema = z.object({ version: z.number().int().min(1), title: z.string(), createdAt: z.string() });
+export const platformWorkflowRunCreateSchema = z.object({
+    inputs: platformJsonObjectSchema.default({}).refine(value => byteLength(value) <= PLATFORM_WORKFLOW_LIMITS.inputBytes, "The inputs are too large")
+        .describe("Values for the workflow's input schema."),
+    maximumChargeMicros: platformMicrosSchema.describe("The most the whole run may charge, in micros of USD. A step whose price no longer fits stops the run before it is bought."),
+    version: z.number().int().min(1).optional().describe("Run an earlier kept version; omit for the current one."),
+}).strict();
+export const platformWorkflowRunStatusSchema = z.enum(["running", "succeeded", "failed", "needs_review", "cancelled"]);
+export const platformWorkflowRunStepSchema = z.object({
+    id: platformWorkflowStepIdSchema, tool: platformToolNameSchema,
+    status: z.enum(["pending", "queued", "running", "waiting", "succeeded", "failed", "cancelled", "needs_review"]),
+    executionId: platformExecutionIdSchema.nullable(), chargedMicros: platformMicrosSchema, errorCode: z.string().nullable(),
+}).strict();
+export const platformWorkflowRunSchema = z.object({
+    id: platformWorkflowRunIdSchema, workflow: platformWorkflowSlugSchema, version: z.number().int().min(1), status: platformWorkflowRunStatusSchema,
+    cancelRequested: z.boolean(), errorCode: z.string().nullable(), inputs: platformJsonObjectSchema,
+    maximumChargeMicros: platformMicrosSchema, chargedMicros: platformMicrosSchema, steps: z.array(platformWorkflowRunStepSchema),
+    resultExecutionId: platformExecutionIdSchema.nullable(),
+    createdAt: z.string(), updatedAt: z.string(), completedAt: z.string().nullable(),
+}).strict();
+export const platformWorkflowRunSummarySchema = platformWorkflowRunSchema.omit({ inputs: true, steps: true });
+export const platformWorkflowRunListQuerySchema = z.object({ before: platformWorkflowRunIdSchema.optional(), limit: z.coerce.number().int().min(1).max(50).default(20) }).strict();
+export const platformWorkflowRunListSchema = z.object({ runs: z.array(platformWorkflowRunSummarySchema), nextBefore: platformWorkflowRunIdSchema.nullable() }).strict();

package/dist/schema/scheduleTimeZone.js

@@ -0,0 +1,15 @@
+import { z } from "zod";
+export function isScheduleTimeZone(value) {
+    if (!/^[A-Za-z][A-Za-z0-9_+-]*(\/[A-Za-z0-9_+-]+)*$/.test(value))
+        return false;
+    try {
+        new Intl.DateTimeFormat("en-US", { timeZone: value });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export const ScheduleTimeZone = z.string().max(64)
+    .refine(isScheduleTimeZone, "Invalid time zone (must be an IANA tz-database name).")
+    .transform(value => new Intl.DateTimeFormat("en-US", { timeZone: value }).resolvedOptions().timeZone);

package/dist/schema/toolDiscovery.js

@@ -1,10 +1,11 @@
 import { z } from "zod";
-import { platformCatalogSchema, platformMicrosSchema, platformQuoteSchema, platformRequestIntentSchema, platformToolInputSchema, platformToolNameSchema } from "./platformPublicExecution.js";
+import { platformCatalogSchema, platformMicrosSchema, platformQuoteSchema, platformRequestIntentSchema, platformToolInputSchema, platformToolNameSchema, validatePlatformArgumentIdentifiers } from "./platformPublicExecution.js";
 export const MAX_DISCOVERED_TOOLS = 16;
 export const SINGLE_QUERY_TOOL_LIMIT = 12;
 export const TOOL_DISCOVERY_CONTEXT_MAX_BYTES = 24_000;
 export const TOOL_DISCOVERY_REQUEST_TIMEOUT_MS = 60_000;
 export const TOOL_DISCOVERY_FILTER_MAX_VALUES = 32;
+export const TOOL_DISCOVERY_APP_MAX_CHARS = 120;
 const scopeFilterSchema = z.object({
     tools: z.array(platformToolNameSchema).max(TOOL_DISCOVERY_FILTER_MAX_VALUES).default([]),
     providers: z.array(z.string().regex(/^[a-z][a-z0-9_]{1,63}$/)).max(TOOL_DISCOVERY_FILTER_MAX_VALUES).default([]),
@@ -12,7 +13,10 @@ const scopeFilterSchema = z.object({
 }).strict();
 export const toolDiscoveryInputSchema = z.object({
     intent: platformRequestIntentSchema,
-    query: z.string().trim().max(512).transform(value => value || undefined).optional().describe("Describe a capability or exact tool/model name; empty means browse. Omit private content."),
+    query: z.string().trim().max(512).transform(value => value || undefined).optional()
+        .describe("Short English words for one capability (e.g. list open pull requests), preserving the requested action and resource, or an exact tool/model name. Put the connected service in app. Empty means browse. Omit private content."),
+    app: z.string().trim().max(TOOL_DISCOVERY_APP_MAX_CHARS).transform(value => value || undefined).optional()
+        .describe("Connected app name/ID, e.g. GitHub: search its indexed API operations only. Unknown/ambiguous or unindexed apps return explicitly unscoped results. Omit or use empty for public-data targets and known tool IDs. Discovery only; does not pin execution."),
     category: z.union([z.literal("all"), z.literal(""), platformCatalogSchema.shape.tools.element.shape.category])
         .transform(value => value === "all" || value === "" ? undefined : value).optional().describe("all or empty means any category."),
     provider: z.string().trim().regex(/^(?:[a-z][a-z0-9_]{1,63})?$/).transform(value => value || undefined).optional()
@@ -32,7 +36,13 @@ export const toolDiscoveryInputSchema = z.object({
     summary: z.boolean().default(true).describe("Summaries for comparing candidates. false requests schemas/examples; oversized definitions are omitted and remain inspectable."),
     limit: z.number().int().min(1).max(SINGLE_QUERY_TOOL_LIMIT).default(8),
     mode: z.enum(["auto", "keyword", "semantic"]).default("auto"),
-}).strict();
+}).strict().superRefine((value, context) => {
+    if (value.quoteArguments == null)
+        return;
+    const named = value.include?.tools.length ? value.include.tools.length === 1 ? value.include.tools[0] : undefined
+        : platformToolNameSchema.safeParse(value.query).data;
+    validatePlatformArgumentIdentifiers(named, value.quoteArguments, context, "quoteArguments");
+});
 const toolSummary = platformCatalogSchema.shape.tools.element.omit({ inputSchema: true, example: true }).extend({
     discoveryQuote: platformQuoteSchema.extend({ basis: z.enum(["arguments", "example"]) }).optional(),
     inputSchema: platformCatalogSchema.shape.tools.element.shape.inputSchema.optional(),
@@ -41,7 +51,14 @@ const toolSummary = platformCatalogSchema.shape.tools.element.omit({ inputSchema
         example: platformCatalogSchema.shape.tools.element.shape.example.optional(),
     })).optional(),
 });
+export const PLATFORM_CONNECTABLE_APPS_MAX = 3;
+export const platformConnectableAppsSchema = z.object({
+    instruction: z.string(),
+    apps: z.array(z.object({ app: z.string(), name: z.string(), status: z.enum(["not_connected", "reauth_required"]), connectUrl: z.url() }))
+        .min(1).max(PLATFORM_CONNECTABLE_APPS_MAX),
+});
 export const toolDiscoveryResultSchema = platformCatalogSchema.extend({ tools: z.array(toolSummary),
     discovery: z.object({ mode: z.enum(["browse", "keyword", "semantic"]), candidateCount: z.number().int().nonnegative(), returnedCount: z.number().int().nonnegative(),
         truncated: z.boolean(), warning: z.string().optional() }),
+    connectableApps: platformConnectableAppsSchema.optional(),
 });

package/dist/schema/toolInputRepair.js

@@ -0,0 +1,110 @@
+import { z } from "zod";
+const isNode = (value) => typeof value === "object" && value !== null;
+const OMITTED = Symbol("omitted");
+const jsonStructure = (text) => {
+    if (!/^\s*[[{]/.test(text))
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+};
+function evidentValue(issue, sent) {
+    if (sent === null || sent === "")
+        return OMITTED;
+    if (issue.code === "invalid_type") {
+        if (typeof sent === "string" && issue.expected === "boolean")
+            return sent.toLowerCase() === "true" ? true : sent.toLowerCase() === "false" ? false : undefined;
+        if (typeof sent === "number" && issue.expected === "boolean")
+            return sent === 1 ? true : sent === 0 ? false : undefined;
+        if (typeof sent === "string" && (issue.expected === "number" || issue.expected === "int"))
+            return /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/.test(sent) ? Number(sent) : undefined;
+        const structure = typeof sent === "string" ? jsonStructure(sent) : undefined;
+        if (issue.expected === "array" && Array.isArray(structure))
+            return structure;
+        if ((issue.expected === "object" || issue.expected === "record") && isNode(structure) && !Array.isArray(structure))
+            return structure;
+        if (issue.expected === "array" && structure === undefined && ["string", "number", "boolean"].includes(typeof sent) && !String(sent).includes(","))
+            return [sent];
+        if (issue.expected === "array" && isNode(sent) && !Array.isArray(sent))
+            return [sent];
+    }
+    if (issue.code === "invalid_format" && (issue.format === "url" || issue.format === "regex" && /^\^https\??:\/\//.test((issue.pattern ?? "").replace(/^\//, "").replaceAll("\\/", "/")))
+        && typeof sent === "string" && /^[a-z0-9-]+(?:\.[a-z0-9-]+)+(?::\d+)?(?:[/?#]\S*)?$/i.test(sent))
+        return `https://${sent}`;
+    if (issue.code === "invalid_value" && typeof sent === "string") {
+        const options = issue.values.filter(value => ["string", "number", "boolean"].includes(typeof value));
+        for (const form of [(text) => text.toLowerCase(), (text) => text.toLowerCase().replace(/[\s_-]/g, "")]) {
+            const matches = options.filter(value => form(String(value)) === form(sent));
+            if (matches.length)
+                return matches.length === 1 ? matches[0] : undefined;
+        }
+    }
+    return undefined;
+}
+const valueAt = (root, path) => path.reduce((node, step) => isNode(node) && typeof step !== "symbol" ? node[String(step)] : undefined, root);
+function repairableIssues(issues, input) {
+    return issues.flatMap(issue => issue.code !== "invalid_union" ? [issue] : issue.errors
+        .map(option => repairableIssues(option.map(inner => ({ ...inner, path: [...issue.path, ...inner.path] })), input))
+        .find(option => option.length > 0 && option.every(inner => evidentValue(inner, valueAt(input, inner.path)) !== undefined)) ?? []);
+}
+function repaired(input, issues) {
+    const target = structuredClone(input), changes = [];
+    for (const issue of issues) {
+        const last = issue.path.at(-1), node = valueAt(target, issue.path.slice(0, -1));
+        if (last === undefined || typeof last === "symbol" || !isNode(node))
+            continue;
+        const key = String(last), sent = node[key], value = evidentValue(issue, sent);
+        if (value === undefined || value === OMITTED && Array.isArray(node))
+            continue;
+        if (value === OMITTED)
+            delete node[key];
+        else
+            node[key] = value;
+        changes.push({ path: issue.path, node, key, sent });
+    }
+    return { target, changes };
+}
+function unionOptions(schema) {
+    const source = schema instanceof z.ZodPipe ? schema.in : schema;
+    return source instanceof z.ZodUnion ? source.options.filter((option) => option instanceof z.ZodType) : [];
+}
+function repairPass(schema, input) {
+    const parsed = schema.safeParse(input);
+    if (parsed.success)
+        return input;
+    const { target, changes } = repaired(input, repairableIssues(parsed.error.issues, input));
+    const checked = schema.safeParse(target);
+    if (checked.success)
+        return target;
+    for (const option of unionOptions(schema)) {
+        const repairedOption = withEvidentValues(option, input);
+        if (repairedOption !== input && schema.safeParse(repairedOption).success)
+            return repairedOption;
+    }
+    const evident = (issue) => {
+        const inner = repairableIssues([issue], target);
+        return inner.length > 0 && inner.every(item => evidentValue(item, valueAt(target, item.path)) !== undefined);
+    };
+    const kept = changes.filter(change => {
+        const refused = checked.error.issues.some(issue => change.path.every((step, index) => issue.path[index] === step)
+            && (issue.path.length <= change.path.length || !evident(issue)));
+        if (refused)
+            change.node[change.key] = change.sent;
+        return !refused;
+    });
+    return kept.length ? target : input;
+}
+const REPAIR_PASSES = 32;
+export function withEvidentValues(schema, input) {
+    let current = input;
+    for (let pass = 0; pass < REPAIR_PASSES; pass++) {
+        const next = repairPass(schema, current);
+        if (next === current)
+            break;
+        current = next;
+    }
+    return current;
+}

package/dist/schema/toolResultContext.js

@@ -9,7 +9,7 @@ export const toolResultSelectionSchema = z.object({
     limit: z.number().int().min(1).max(TOOL_RESULT_PAGE_MAX_ITEMS).default(20),
     maxChars: z.number().int().min(1).max(TOOL_RESULT_PAGE_MAX_CHARS).default(4_000),
     fields: z.array(z.string().max(256)).max(TOOL_RESULT_PAGE_MAX_FIELDS).optional()
-        .describe("Top-level keys to keep from each object in an array page. Empty keeps every field. Full stored data is unchanged."),
+        .describe("Top-level keys to keep from one object or each object in an array page. Object offsets page the selected keys. Empty keeps every field. Full stored data is unchanged."),
 }).strict();
 export const toolResultContextSchema = z.object({
     offloaded: z.boolean(), totalBytes: z.number().int().nonnegative(), preview: z.json(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relvo/mcp",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Relvo stdio MCP server for research, SEO, social data and media generation.",
   "type": "module",
   "bin": {

package/dist/schema/amazonAds.js

@@ -1,13 +0,0 @@
-import { z } from "zod";
-export const amazonAdsRegionSchema = z.enum(["na", "eu", "fe"]);
-export const amazonAdsProfileIdSchema = z.string().regex(/^[1-9][0-9]{0,18}$/)
-    .pipe(z.string().refine(value => BigInt(value) <= 9223372036854775807n));
-export const amazonAdsProfileResourceIdSchema = z.string().regex(/^(?:na|eu|fe):[1-9][0-9]{0,18}$/)
-    .pipe(z.string().refine(value => BigInt(value.slice(3)) <= 9223372036854775807n));
-export function amazonAdsProfileResourceId(region, profileId) {
-    return amazonAdsProfileResourceIdSchema.parse(`${region}:${profileId}`);
-}
-export function parseAmazonAdsProfileResourceId(input) {
-    const [region, profileId] = amazonAdsProfileResourceIdSchema.parse(input).split(":");
-    return z.object({ region: amazonAdsRegionSchema, profileId: amazonAdsProfileIdSchema }).parse({ region, profileId });
-}

package/dist/schema/oauth2.js

@@ -1,64 +0,0 @@
-import { z } from "zod";
-export const oauth2ProviderSchema = z.enum(["google", "x", "github", "notion", "slack", "linear", "linkedin", "pinterest", "tiktok", "microsoft", "amazon"]);
-export const AMAZON_OAUTH_AUTHORIZATION_URLS = { na: "https://www.amazon.com/ap/oa", eu: "https://eu.account.amazon.com/ap/oa", fe: "https://apac.account.amazon.com/ap/oa" };
-export const oauth2TokenResponseSchema = z.object({
-    access_token: z.string().min(1),
-    refresh_token: z.string().min(1).optional(),
-    expires_in: z.number().positive().finite().optional(),
-    scope: z.string().optional(),
-    token_type: z.string().optional(),
-    error: z.never().optional(),
-});
-export const oauth2ExpiringTokenResponseSchema = oauth2TokenResponseSchema.extend({
-    expires_in: oauth2TokenResponseSchema.shape.expires_in.unwrap(),
-});
-export const oauth2ErrorResponseSchema = z.object({
-    error: z.string().min(1), error_description: z.string().optional(), log_id: z.string().optional(),
-});
-export const OAUTH2_PROVIDERS = {
-    google: { name: "Google", authorizeUrl: "https://accounts.google.com/o/oauth2/v2/auth", tokenUrl: "https://oauth2.googleapis.com/token", clientAuth: "body", encoding: "form", scopeSeparator: " ", pkce: true,
-        documentation: "https://developers.google.com/identity/protocols/oauth2/web-server" },
-    x: { name: "X", authorizeUrl: "https://x.com/i/oauth2/authorize", tokenUrl: "https://api.x.com/2/oauth2/token", clientAuth: "basic", encoding: "form", scopeSeparator: " ", pkce: true,
-        documentation: "https://docs.x.com/fundamentals/authentication/oauth-2-0/authorization-code" },
-    github: { name: "GitHub", authorizeUrl: "https://github.com/login/oauth/authorize", tokenUrl: "https://github.com/login/oauth/access_token", clientAuth: "body", encoding: "json", scopeSeparator: " ", pkce: true,
-        documentation: "https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps" },
-    notion: { name: "Notion", authorizeUrl: "https://api.notion.com/v1/oauth/authorize", tokenUrl: "https://api.notion.com/v1/oauth/token", clientAuth: "basic", encoding: "json", scopeSeparator: " ", pkce: false,
-        documentation: "https://developers.notion.com/guides/get-started/authorization" },
-    slack: { name: "Slack", authorizeUrl: "https://slack.com/oauth/v2/authorize", tokenUrl: "https://slack.com/api/oauth.v2.access", clientAuth: "basic", encoding: "form", scopeSeparator: ",", pkce: false,
-        documentation: "https://docs.slack.dev/authentication/installing-with-oauth/" },
-    linear: { name: "Linear", authorizeUrl: "https://linear.app/oauth/authorize", tokenUrl: "https://api.linear.app/oauth/token", clientAuth: "body", encoding: "form", scopeSeparator: ",", pkce: true,
-        documentation: "https://linear.app/developers/oauth-2-0-authentication" },
-    linkedin: { name: "LinkedIn", authorizeUrl: "https://www.linkedin.com/oauth/v2/authorization", tokenUrl: "https://www.linkedin.com/oauth/v2/accessToken", clientAuth: "body", encoding: "form", scopeSeparator: " ", pkce: false,
-        documentation: "https://learn.microsoft.com/en-us/linkedin/shared/authentication/authorization-code-flow" },
-    pinterest: { name: "Pinterest", authorizeUrl: "https://www.pinterest.com/oauth/", tokenUrl: "https://api.pinterest.com/v5/oauth/token", clientAuth: "basic", encoding: "form", scopeSeparator: ",", pkce: false,
-        documentation: "https://developers.pinterest.com/docs/getting-started/set-up-authentication-and-authorization/" },
-    tiktok: { name: "TikTok", authorizeUrl: "https://www.tiktok.com/v2/auth/authorize/", tokenUrl: "https://open.tiktokapis.com/v2/oauth/token/", clientAuth: "body", encoding: "form", scopeSeparator: ",", pkce: false,
-        documentation: "https://developers.tiktok.com/docs/en/oauth-user-access-token-management" },
-    microsoft: { name: "Microsoft Advertising", authorizeUrl: "https://login.microsoftonline.com/common/oauth2/v2.0/authorize", tokenUrl: "https://login.microsoftonline.com/common/oauth2/v2.0/token", clientAuth: "body", encoding: "form", scopeSeparator: " ", pkce: true,
-        documentation: "https://learn.microsoft.com/en-us/advertising/guides/authentication-oauth-consent?view=bingads-13" },
-    amazon: { name: "Amazon Advertising", authorizeUrl: AMAZON_OAUTH_AUTHORIZATION_URLS.na, tokenUrl: "https://api.amazon.com/auth/o2/token", clientAuth: "body", encoding: "form", scopeSeparator: " ", pkce: true,
-        documentation: "https://developer.amazon.com/docs/login-with-amazon/authorization-code-grant.html" },
-};
-export const OAUTH2_TOKEN_PROTOCOLS = {
-    ...OAUTH2_PROVIDERS,
-    wix: { tokenUrl: "https://www.wixapis.com/oauth2/token", clientAuth: "body", encoding: "json",
-        documentation: "https://dev.wix.com/docs/build-apps/develop-your-app/auth/authenticate-using-oauth" },
-    wordpress: { tokenUrl: "https://public-api.wordpress.com/oauth2/token", clientAuth: "body", encoding: "form",
-        documentation: "https://developer.wordpress.com/docs/api/oauth2/" },
-    snapchatMarketing: { tokenUrl: "https://accounts.snapchat.com/login/oauth2/access_token", clientAuth: "body", encoding: "form",
-        documentation: "https://developers.snap.com/marketing-api/Ads-API/authentication" },
-    hubspot: { tokenUrl: "https://api.hubapi.com/oauth/2026-03/token", clientAuth: "body", encoding: "form",
-        documentation: "https://developers.hubspot.com/docs/api-reference/legacy/authentication/oauth-tokens/v1/migration-guide" },
-    attio: { tokenUrl: "https://app.attio.com/oauth/token", clientAuth: "body", encoding: "form",
-        documentation: "https://docs.attio.com/docs/oauth/token" },
-    pipedrive: { tokenUrl: "https://oauth.pipedrive.com/oauth/token", clientAuth: "basic", encoding: "form",
-        documentation: "https://pipedrive.readme.io/docs/marketplace-oauth-authorization" },
-};
-export function isOAuth2AuthorizationUrl(provider, candidate) {
-    const actual = new URL(candidate);
-    const allowed = provider === "amazon" ? Object.values(AMAZON_OAUTH_AUTHORIZATION_URLS) : [OAUTH2_PROVIDERS[provider].authorizeUrl];
-    return !actual.username && !actual.password && !actual.hash && allowed.some(value => {
-        const expected = new URL(value);
-        return actual.origin === expected.origin && actual.pathname === expected.pathname;
-    });
-}