@relvo/mcp 0.1.1 → 0.1.3

package/dist/schema/platformMetaTools.js

@@ -1,7 +1,8 @@
 import { z } from "zod";
-import { platformCatalogSchema, platformCreateExecutionSchema, platformExecutionIdSchema, platformExecutionStatusSchema, platformMicrosSchema, platformQuoteSchema, platformToolNameSchema, platformToolSessionIdSchema, platformOptionalToolSessionIdSchema, PLATFORM_SANDBOX_LIMITS, platformExecutionSchema, platformExecutionContextSchema } from "./platformPublicExecution.js";
-import { platformConnectionCatalogSchema, platformConnectionProviderSchema } from "./platformConnectionCatalog.js";
+import { platformCatalogSchema, platformCreateExecutionSchema, platformExecutionIdSchema, platformExecutionStatusSchema, platformMicrosSchema, platformQuoteSchema, platformToolNameSchema, platformToolSessionIdSchema, platformOptionalToolSessionIdSchema, PLATFORM_SANDBOX_LIMITS, platformExecutionSchema, platformExecutionContextSchema, platformRequestIntentSchema, validatePlatformArgumentIdentifiers } from "./platformPublicExecution.js";
+import { platformAnyConnectionProviderSchema, platformConnectionCatalogSchema } from "./platformConnectionCatalog.js";
 import { toolDiscoveryInputSchema, toolDiscoveryResultSchema } from "./toolDiscovery.js";
+export { PLATFORM_MCP_DIRECT_TOOLS_MAX, platformMcpDirectToolNames } from "./platformMcpTools.js";
 export const PLATFORM_META_LIMITS = { queries: 4, schemas: 12, batch: 50, concurrency: 4, contextBytes: 24_000,
     requestBytes: 1_048_576, requestTimeoutMs: 90_000, sessionLifetimeMs: 86_400_000, activeSessions: 100,
     codeChars: PLATFORM_SANDBOX_LIMITS.code, commandChars: 16_000, sourceExecutions: PLATFORM_SANDBOX_LIMITS.sourceExecutions, timeoutMs: PLATFORM_SANDBOX_LIMITS.timeoutMs };
@@ -10,6 +11,7 @@ export const platformToolSessionSchema = z.object({ id: platformToolSessionIdSch
     sandbox: z.enum(["new", "ready", "busy", "needs_review", "state_lost"]), activeExecutionId: platformExecutionIdSchema.nullable() });
 const sessionInput = { sessionId: platformToolSessionIdSchema };
 export const platformMetaSearchSchema = z.object({ sessionId: platformOptionalToolSessionIdSchema.describe("Continue a returned session. Omit or use an empty string to open a new session."),
+    intent: platformRequestIntentSchema,
     queries: z.array(toolDiscoveryInputSchema).min(1).max(PLATFORM_META_LIMITS.queries)
         .describe("Independent capability queries, one action per query. Use exact app names when known; omit private account data.") }).strict();
 export const platformMetaSearchResultSchema = z.object({ session: platformToolSessionSchema,
@@ -20,15 +22,16 @@ export const platformMetaSchemasSchema = z.object({ ...sessionInput,
 export const platformMetaSchemasResultSchema = z.object({ session: platformToolSessionSchema,
     tools: platformCatalogSchema.shape.tools, remaining: z.array(platformToolNameSchema) });
 export const platformMetaConnectionsSchema = z.object({ ...sessionInput,
-    providers: z.array(platformConnectionProviderSchema).max(platformConnectionProviderSchema.options.length).default([])
-        .describe("OAuth providers to inspect. Empty means all supported providers. Data-provider API keys are managed by Relvo.") }).strict();
+    providers: z.array(platformAnyConnectionProviderSchema).max(32).default([])
+        .describe("Providers to inspect: OAuth providers or connected apps as app:<id> (e.g. app:airtable). Empty means every connection. Data-provider API keys are managed by Relvo.") }).strict();
 export const platformMetaConnectionsResultSchema = z.object({ session: platformToolSessionSchema,
     developerOrganizationId: z.string(), developerProjectId: z.string(),
     manageUrl: z.url(), connections: platformConnectionCatalogSchema.shape.connections,
-    total: z.number().int().nonnegative(), providers: z.array(z.object({ provider: platformConnectionProviderSchema,
+    total: z.number().int().nonnegative(), providers: z.array(z.object({ provider: platformAnyConnectionProviderSchema,
         status: z.enum(["connected", "reauth_required", "not_connected"]) })),
     instruction: z.string() });
-const item = platformCreateExecutionSchema.omit({ sessionId: true }).extend({ idempotencyKey: z.string().regex(/^[A-Za-z0-9._:-]{8,128}$/) }).strict();
+const item = z.object(platformCreateExecutionSchema.shape).omit({ sessionId: true }).extend({ idempotencyKey: z.string().regex(/^[A-Za-z0-9._:-]{8,128}$/) }).strict()
+    .superRefine((value, context) => validatePlatformArgumentIdentifiers(value.tool, value.arguments, context));
 export const platformMetaExecuteSchema = z.object({ ...sessionInput,
     maximumChargeMicros: platformMicrosSchema.describe("Accepted total reservation ceiling across this batch, in addition to each accepted quote."),
     tools: z.array(item).min(1).max(PLATFORM_META_LIMITS.batch)
@@ -46,6 +49,7 @@ export const platformMetaExecuteResultSchema = z.object({ session: platformToolS
         errorCode: z.string().optional() })),
     instruction: z.string() });
 const remote = { ...sessionInput, timeoutMs: z.number().int().min(1000).max(PLATFORM_META_LIMITS.timeoutMs).default(30_000),
+    intent: platformRequestIntentSchema,
     sourceExecutionIds: z.array(platformExecutionIdSchema).max(PLATFORM_META_LIMITS.sourceExecutions).default([])
         .refine(ids => new Set(ids).size === ids.length, "Source execution IDs must be unique"),
     quote: platformQuoteSchema,

package/dist/schema/platformMonitorSchedule.js

@@ -0,0 +1,123 @@
+import { z } from "zod";
+import { isCronTooFrequent, isValidCron, parseCron } from "./cronValidator.js";
+import { ScheduleTimeZone } from "./scheduleTimeZone.js";
+export const PLATFORM_MONITOR_INTERVALS = { "15m": 900, "1h": 3600, "1d": 86_400 };
+export const platformMonitorIntervalSchema = z.enum(["15m", "1h", "1d"]);
+export const PLATFORM_MONITOR_DEFAULT_INTERVAL = "1h";
+export const PLATFORM_MONITOR_DEFAULT_TIME_ZONE = "UTC";
+export const PLATFORM_MONITOR_MIN_CRON_MINUTES = 15;
+export const PLATFORM_MONITOR_CRON_CHARS = 100;
+const cronText = z.string().trim().max(PLATFORM_MONITOR_CRON_CHARS)
+    .refine(isValidCron, "platform_monitor_cron_invalid")
+    .refine(cron => !isCronTooFrequent(cron, PLATFORM_MONITOR_MIN_CRON_MINUTES), "platform_monitor_cron_too_frequent");
+export const platformMonitorCronSchema = z.union([z.literal(""), cronText]);
+export const platformMonitorTimeZoneSchema = z.union([z.literal(""), ScheduleTimeZone]);
+export const normalizeMonitorCron = (cron) => cron.trim().split(/\s+/).map(field => field.toUpperCase()).join(" ");
+export class PlatformMonitorScheduleError extends Error {
+}
+export function resolvePlatformMonitorSchedule(input, after = Date.now()) {
+    if (!input.cron) {
+        if (input.timeZone)
+            throw new PlatformMonitorScheduleError("platform_monitor_time_zone_needs_cron");
+        return { interval: input.interval ?? PLATFORM_MONITOR_DEFAULT_INTERVAL };
+    }
+    if (input.interval)
+        throw new PlatformMonitorScheduleError("platform_monitor_schedule_conflict");
+    const zone = ScheduleTimeZone.safeParse(input.timeZone || PLATFORM_MONITOR_DEFAULT_TIME_ZONE);
+    if (!zone.success)
+        throw new PlatformMonitorScheduleError("platform_monitor_time_zone_invalid");
+    const cron = normalizeMonitorCron(input.cron), timeZone = zone.data;
+    if (nextCronFire(cron, timeZone, after) === null)
+        throw new PlatformMonitorScheduleError("platform_monitor_cron_never_runs");
+    return { cron, timeZone };
+}
+const MINUTE = 60_000, HOUR = 3_600_000, DAY = 86_400_000;
+const SEARCH_DAYS = 366 * 8;
+const formatters = new Map();
+function offsetAt(timeZone, at) {
+    let format = formatters.get(timeZone);
+    if (!format) {
+        format = new Intl.DateTimeFormat("en-US", { timeZone, hourCycle: "h23", year: "numeric", month: "numeric", day: "numeric", hour: "numeric", minute: "numeric", second: "numeric" });
+        formatters.set(timeZone, format);
+    }
+    const part = {};
+    for (const { type, value } of format.formatToParts(at))
+        if (type !== "literal")
+            part[type] = Number(value);
+    return Date.UTC(part.year, part.month - 1, part.day, part.hour, part.minute, part.second) - Math.floor(at / 1000) * 1000;
+}
+function instantOf(timeZone, wall) {
+    const before = offsetAt(timeZone, wall - DAY), after = offsetAt(timeZone, wall + DAY);
+    const candidates = [...new Set([wall - before, wall - after])].sort((a, b) => a - b);
+    const valid = candidates.filter(at => offsetAt(timeZone, at) === wall - at);
+    if (valid.length)
+        return valid[0];
+    let low = candidates[0], high = candidates[candidates.length - 1];
+    if (low === high)
+        return low;
+    const lowOffset = offsetAt(timeZone, low);
+    while (high - low > MINUTE) {
+        const mid = low + Math.floor((high - low) / (2 * MINUTE)) * MINUTE;
+        if (offsetAt(timeZone, mid) === lowOffset)
+            low = mid;
+        else
+            high = mid;
+    }
+    return high;
+}
+const dayMatches = (parsed, year, month, day) => {
+    if (!parsed.months.has(month))
+        return false;
+    const dom = parsed.daysOfMonth.has(day), dow = parsed.daysOfWeek.has(new Date(Date.UTC(year, month - 1, day)).getUTCDay());
+    return parsed.dayRestrictionOr ? dom || dow : dom && dow;
+};
+const ascending = (values) => [...values].sort((a, b) => a - b);
+export function nextCronFire(cron, timeZone, after) {
+    const parsed = parseCron(cron);
+    if (!parsed)
+        return null;
+    const hours = ascending(parsed.hours), minutes = ascending(parsed.minutes);
+    const wallAfter = after + offsetAt(timeZone, after);
+    const first = new Date(wallAfter);
+    const start = Date.UTC(first.getUTCFullYear(), first.getUTCMonth(), first.getUTCDate()) - DAY;
+    for (let index = 0; index < SEARCH_DAYS; index++) {
+        const dayStart = start + index * DAY, date = new Date(dayStart);
+        if (!dayMatches(parsed, date.getUTCFullYear(), date.getUTCMonth() + 1, date.getUTCDate()))
+            continue;
+        for (const hour of hours)
+            for (const minute of minutes) {
+                const wall = dayStart + hour * HOUR + minute * MINUTE;
+                if (wall < wallAfter - 6 * HOUR)
+                    continue;
+                const at = instantOf(timeZone, wall);
+                if (at > after)
+                    return at;
+            }
+    }
+    return null;
+}
+export function upcomingCronFires(cron, timeZone, after, count) {
+    const fires = [];
+    for (let at = after; fires.length < count;) {
+        const next = nextCronFire(cron, timeZone, at);
+        if (next === null)
+            break;
+        fires.push(next);
+        at = next;
+    }
+    return fires;
+}
+export function monitorRunsPerMonth(schedule) {
+    if (!("cron" in schedule))
+        return Math.round((365 / 12) * 86_400 / PLATFORM_MONITOR_INTERVALS[schedule.interval]);
+    const parsed = parseCron(schedule.cron);
+    if (!parsed)
+        return 0;
+    let days = 0;
+    for (let index = 0; index < 365; index++) {
+        const date = new Date(Date.UTC(2026, 0, 1 + index));
+        if (dayMatches(parsed, date.getUTCFullYear(), date.getUTCMonth() + 1, date.getUTCDate()))
+            days++;
+    }
+    return Math.round(days * parsed.hours.size * parsed.minutes.size / 12);
+}

package/dist/schema/platformMonitors.js

@@ -0,0 +1,159 @@
+import { z } from "zod";
+import { projectScopeSchema, platformJsonObjectSchema, platformMicrosSchema } from "./platformPublicExecution.js";
+import { platformMonitorCronSchema, platformMonitorIntervalSchema, platformMonitorTimeZoneSchema } from "./platformMonitorSchedule.js";
+export { PLATFORM_MONITOR_INTERVALS, platformMonitorIntervalSchema } from "./platformMonitorSchedule.js";
+export const PLATFORM_MONITOR_LIMITS = {
+    perProject: 25,
+    nameChars: 80,
+    eventsPage: 100,
+    eventItemBytes: 8_192,
+    snapshotItems: 500,
+    retentionDays: 30,
+    popularMinimumOrganizations: 3,
+    popularPage: 50,
+};
+export const PLATFORM_MONITOR_DESTINATION_LIMITS = {
+    perMonitor: 5,
+    emailRecipients: 5,
+    labelChars: 80,
+    urlChars: 512,
+    digestEvents: 10,
+};
+export const PLATFORM_MONITOR_EMAIL_PRICE_MICROS = 900;
+export const platformMonitorDestinationKindSchema = z.enum(["webhook", "slack", "discord", "email"]);
+const httpsUrl = (value) => {
+    try {
+        const url = new URL(value);
+        return url.protocol === "https:" && !url.username && !url.password && url.hash === "" ? url : null;
+    }
+    catch {
+        return null;
+    }
+};
+export const isPlatformWebhookUrl = (value) => {
+    const url = httpsUrl(value);
+    return Boolean(url && url.port === "");
+};
+export const isPlatformSlackWebhookUrl = (value) => {
+    const url = httpsUrl(value);
+    return Boolean(url && url.hostname === "hooks.slack.com" && url.port === "" && url.search === "" && /^\/services\/[A-Za-z0-9]+\/[A-Za-z0-9]+\/[A-Za-z0-9]+$/.test(url.pathname));
+};
+export const isPlatformDiscordWebhookUrl = (value) => {
+    const url = httpsUrl(value);
+    return Boolean(url && ["discord.com", "discordapp.com"].includes(url.hostname) && url.port === "" && url.search === "" &&
+        /^\/api(\/v\d{1,2})?\/webhooks\/\d{1,25}\/[A-Za-z0-9_-]{1,200}$/.test(url.pathname));
+};
+const destinationUrl = z.string().trim().max(PLATFORM_MONITOR_DESTINATION_LIMITS.urlChars);
+const destinationLabel = z.string().trim().max(PLATFORM_MONITOR_DESTINATION_LIMITS.labelChars).default("");
+const memberId = z.string().min(1).max(64);
+export const platformMonitorDestinationInputSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("webhook"), label: destinationLabel, url: destinationUrl.refine(isPlatformWebhookUrl, "platform_monitor_destination_url_invalid") }).strict(),
+    z.object({ kind: z.literal("slack"), label: destinationLabel, url: destinationUrl.refine(isPlatformSlackWebhookUrl, "platform_monitor_destination_url_invalid") }).strict(),
+    z.object({ kind: z.literal("discord"), label: destinationLabel, url: destinationUrl.refine(isPlatformDiscordWebhookUrl, "platform_monitor_destination_url_invalid") }).strict(),
+    z.object({ kind: z.literal("email"), label: destinationLabel,
+        memberIds: z.array(memberId).min(1).max(PLATFORM_MONITOR_DESTINATION_LIMITS.emailRecipients) }).strict(),
+]);
+export const platformMonitorDestinationSchema = z.object({
+    id: z.string().regex(/^dst_[A-Za-z0-9_-]{1,100}$/),
+    kind: platformMonitorDestinationKindSchema,
+    label: z.string(),
+    target: z.string(),
+    memberIds: z.array(z.string()),
+    createdAt: z.string(),
+    lastDeliveredAt: z.string().nullable(),
+    lastStatus: z.enum(["ok", "failed"]).nullable(),
+    lastError: z.string().nullable(),
+    signingSecret: z.string().optional(),
+});
+export const platformMonitorRecipientSchema = z.object({ memberId, email: z.string(), name: z.string() });
+const toolName = z.string().regex(/^[a-z][a-z0-9_]{1,63}$/);
+export const PLATFORM_MONITOR_ID = /^mon_[A-Za-z0-9_-]{1,100}$/;
+const monitorId = z.string().regex(PLATFORM_MONITOR_ID);
+export const platformMonitorCreateSchema = z.object({
+    tool: toolName,
+    arguments: platformJsonObjectSchema.default({}),
+    provider: z.string().trim().max(64).default(""),
+    interval: platformMonitorIntervalSchema.optional().describe("Run every 15m, 1h (default) or 1d. Omit when using cron."),
+    cron: platformMonitorCronSchema.optional().describe("5-field cron for fixed times, at least 15 minutes between runs, for example '0 9 * * 1-5' (weekdays 09:00). Omit when using interval."),
+    timeZone: platformMonitorTimeZoneSchema.optional().describe("IANA time zone the cron is read in, for example Asia/Tokyo; UTC when omitted. Only with cron."),
+    name: z.string().trim().max(PLATFORM_MONITOR_LIMITS.nameChars).default(""),
+    maximumChargeMicrosPerRun: platformMicrosSchema.default(0),
+    destinations: z.array(platformMonitorDestinationInputSchema).max(PLATFORM_MONITOR_DESTINATION_LIMITS.perMonitor).default([]),
+}).strict();
+export const platformMonitorPoolSchema = z.object({
+    chargeCeilingMicros: platformMicrosSchema,
+    members: z.number().int().min(0),
+    shareMicros: platformMicrosSchema,
+});
+export const platformMonitorQuoteSchema = platformMonitorCreateSchema.pick({ tool: true, arguments: true, provider: true, interval: true, cron: true, timeZone: true }).strict();
+export const platformMonitorQuoteResultSchema = platformMonitorPoolSchema.extend({
+    joined: z.boolean(),
+    payers: z.number().int().min(1),
+});
+export const platformMonitorResumeSchema = z.object({ maximumChargeMicrosPerRun: platformMicrosSchema.optional() }).strict();
+export const platformMonitorSchema = z.object({
+    id: monitorId,
+    name: z.string(),
+    tool: toolName,
+    provider: z.string(),
+    arguments: platformJsonObjectSchema,
+    interval: platformMonitorIntervalSchema.nullable(),
+    cron: z.string().nullable().default(null),
+    timeZone: z.string().nullable().default(null),
+    subscribers: z.number().int().min(1),
+    lastCheckedAt: z.string().nullable(),
+    lastChangedAt: z.string().nullable(),
+    nextCheckAt: z.string().nullable(),
+    lastError: z.string().nullable(),
+    createdAt: z.string(),
+    maximumChargeMicrosPerRun: platformMicrosSchema,
+    pool: platformMonitorPoolSchema,
+    status: z.enum(["active", "suspended"]),
+    suspendedReason: z.string().nullable(),
+    destinations: z.array(platformMonitorDestinationSchema).default([]),
+});
+const changeValue = z.union([z.string(), z.number(), z.boolean(), z.null()]);
+export const platformMonitorEventSchema = z.object({
+    id: z.string().regex(/^\d{1,20}$/),
+    monitorId: monitorId,
+    kind: z.enum(["added", "changed", "removed"]),
+    itemKey: z.string(),
+    title: z.string(),
+    url: z.string(),
+    item: platformJsonObjectSchema,
+    changes: z.array(z.object({ field: z.string(), before: changeValue, after: changeValue })),
+    detectedAt: z.string(),
+});
+export const platformMonitorEventsQuerySchema = z.object({
+    after: z.string().regex(/^\d{1,20}$/).optional(),
+    limit: z.coerce.number().int().min(1).max(PLATFORM_MONITOR_LIMITS.eventsPage).default(50),
+}).strict();
+export const platformMonitorEventsSchema = z.object({ events: z.array(platformMonitorEventSchema), nextAfter: z.string().nullable() });
+export const platformPopularMonitorSchema = z.object({
+    tool: toolName, provider: z.string(), arguments: platformJsonObjectSchema,
+    interval: platformMonitorIntervalSchema.nullable(), cron: z.string().nullable().default(null), timeZone: z.string().nullable().default(null),
+    organizations: z.number().int().min(1),
+    chargeCeilingMicros: platformMicrosSchema,
+});
+export const platformMonitorableToolSchema = z.object({ name: toolName, provider: z.string(), chargeCeilingMicros: platformMicrosSchema });
+export function platformMonitorWire(monitor) {
+    const { cron, timeZone, destinations, ...rest } = monitor;
+    return { ...rest, ...(cron == null ? {} : { cron }), ...(timeZone == null ? {} : { timeZone }), ...(destinations?.length ? { destinations } : {}) };
+}
+export const platformMonitorContracts = {
+    listDeveloperMonitors: { input: projectScopeSchema.strict(), output: z.object({ monitors: z.array(platformMonitorSchema) }).strict() },
+    createDeveloperMonitor: { input: projectScopeSchema.extend({ monitor: platformMonitorCreateSchema }).strict(), output: z.object({ monitor: platformMonitorSchema }).strict() },
+    deleteDeveloperMonitor: { input: projectScopeSchema.extend({ monitorId }).strict(), output: z.object({ success: z.literal(true) }).strict() },
+    quoteDeveloperMonitor: { input: projectScopeSchema.extend({ monitor: platformMonitorQuoteSchema }).strict(), output: z.object({ quote: platformMonitorQuoteResultSchema }).strict() },
+    resumeDeveloperMonitor: { input: projectScopeSchema.extend({ monitorId }).merge(platformMonitorResumeSchema).strict(), output: z.object({ monitor: platformMonitorSchema }).strict() },
+    listDeveloperMonitorEvents: {
+        input: projectScopeSchema.extend({ monitorId: monitorId.optional(), after: platformMonitorEventsQuerySchema.shape.after,
+            limit: z.number().int().min(1).max(PLATFORM_MONITOR_LIMITS.eventsPage).default(50) }).strict(),
+        output: platformMonitorEventsSchema,
+    },
+    addDeveloperMonitorDestination: { input: projectScopeSchema.extend({ monitorId, destination: platformMonitorDestinationInputSchema }).strict(), output: z.object({ monitor: platformMonitorSchema }).strict() },
+    removeDeveloperMonitorDestination: { input: projectScopeSchema.extend({ monitorId, destinationId: platformMonitorDestinationSchema.shape.id }).strict(), output: z.object({ monitor: platformMonitorSchema }).strict() },
+    listDeveloperMonitorRecipients: { input: projectScopeSchema.strict(), output: z.object({ recipients: z.array(platformMonitorRecipientSchema) }).strict() },
+    listPopularMonitors: { input: projectScopeSchema.strict(), output: z.object({ monitors: z.array(platformPopularMonitorSchema) }).strict() },
+    listMonitorableTools: { input: projectScopeSchema.strict(), output: z.object({ tools: z.array(platformMonitorableToolSchema) }).strict() },
+};

package/dist/schema/platformOAuth.js

@@ -0,0 +1,7 @@
+import { z } from "zod";
+export const platformOAuthScopeAlternativesSchema = z.array(z.array(z.string().min(1).max(256)).max(128)).min(1).max(128);
+export const platformOAuthPermissionSchema = z.object({
+    status: z.enum(["available", "missing_scopes", "unknown_grant", "unknown_requirements", "not_applicable"]),
+    required: platformOAuthScopeAlternativesSchema.optional(),
+    missing: z.array(z.string()).optional(),
+});

package/dist/schema/platformPublicExecution.js

@@ -1,16 +1,24 @@
 import { z } from "zod";
-import { TOOL_RESULT_CONTEXT_MAX_BYTES, toolResultContextSchema, toolResultPageSchema } from "./toolResultContext.js";
+import { fitToolResultPage, TOOL_RESULT_CONTEXT_MAX_BYTES, toolResultContextSchema, toolResultPageSchema } from "./toolResultContext.js";
+import { platformOAuthPermissionSchema } from "./platformOAuth.js";
 export const PLATFORM_EXECUTION_MAX_STEPS = 20;
+export const PLATFORM_EXECUTION_MAX_WAIT_SECONDS = 25;
 export const PLATFORM_STEP_OUTPUT_MAX_BYTES = 1_048_576;
 export const PLATFORM_EXECUTION_RESPONSE_MAX_BYTES = PLATFORM_EXECUTION_MAX_STEPS * PLATFORM_STEP_OUTPUT_MAX_BYTES + 65_536;
 export const platformJsonObjectSchema = z.record(z.string(), z.json());
+export const organizationScopeSchema = z.object({ developerOrganizationId: z.string().min(1).max(128) });
+export const projectScopeSchema = organizationScopeSchema.extend({ developerProjectId: z.string().min(1).max(128) });
 export const developerKeyScopeSchema = z.enum(["project:read", "usage:read", "tools:read", "tools:execute", "executions:read"]);
+export const developerKeyAnyScopeSchema = z.enum([...developerKeyScopeSchema.options, "access:write"]);
 export const PLATFORM_INPUT_MAX_BYTES = 12 * 1024 * 1024;
+export const PLATFORM_FILE_CHUNK_MAX_BYTES = 32 * 1024 * 1024;
 export const PLATFORM_UPLOAD_MAX_BYTES = 16 * 1024 * 1024 + 4096;
 export const platformInputFileIdSchema = z.string().regex(/^f_[a-f0-9]{64}$/);
 export const platformInputMimeSchema = z.enum(["image/jpeg", "image/png", "image/webp", "audio/wav", "audio/mpeg", "video/mp4", "video/quicktime"]);
-export const platformInputUploadSchema = z.object({ mimeType: platformInputMimeSchema, data: z.string().min(4).max(16 * 1024 * 1024) }).strict();
-export const platformInputFileSchema = z.object({ id: platformInputFileIdSchema, mimeType: platformInputMimeSchema,
+export const platformInputFileMimeSchema = z.string().max(255).regex(/^[a-z0-9!#$&^_.+-]+\/[a-z0-9!#$&^_.+-]+$/);
+export const platformInputUploadSchema = z.object({ mimeType: platformInputFileMimeSchema, data: z.string().min(4).max(16 * 1024 * 1024),
+    purpose: z.literal("file").optional().describe("file stores opaque bytes for provider uploads, including GIF, documents, archives and local upload chunks. Omit for validated AI media.") }).strict();
+export const platformInputFileSchema = z.object({ id: platformInputFileIdSchema, mimeType: platformInputFileMimeSchema,
     sizeBytes: z.number().int().positive().max(PLATFORM_INPUT_MAX_BYTES), sha256: z.string().regex(/^[a-f0-9]{64}$/), expiresAt: z.iso.datetime() });
 export const platformMicrosSchema = z.number().int().min(0).max(1_000_000_000_000);
 export const platformToolNameSchema = z.string().regex(/^[a-z][a-z0-9_]{1,63}$/);
@@ -21,30 +29,55 @@ export const PLATFORM_SANDBOX_LIMITS = { code: 64000, sourceExecutions: 10, time
 export const platformProviderChoiceSchema = z.string().trim().regex(/^(?:[a-z][a-z0-9_]{0,63})?$/)
     .transform(value => value === "" || value === "auto" ? undefined : value).optional()
     .describe("Omit, use auto, or use an empty string for automatic routing. A catalog provider ID strictly selects that compatible provider; no other provider is substituted.");
+export const platformRelevanceCheckSchema = z.enum(["", "auto", "light"])
+    .transform(value => value === "light" ? "light" : undefined).optional()
+    .describe("Auto result filtering: auto (default) or light, a cheaper check that keeps rows it cannot decide.");
+export const platformInvalidArgumentFieldsSchema = z.array(z.string().max(200).regex(/^[\w.-]*$/)).max(50);
+export const PLATFORM_REQUEST_INTENT_MAX_CHARS = 1000;
+export const platformRequestIntentSchema = z.string().trim().max(PLATFORM_REQUEST_INTENT_MAX_CHARS).transform(value => value || undefined).optional()
+    .describe("Brief user goal without secrets or private content. Empty means omitted.");
 export const platformExecutionStatusSchema = z.enum(["queued", "running", "waiting", "succeeded", "failed", "cancelled", "needs_review"]);
-export const platformFundingSchema = z.enum(["relvo", "toolhub", "provider", "mixed"])
-    .transform(value => value === "toolhub" ? "relvo" : value);
-const platformModelFundingSchema = z.enum(["relvo", "toolhub", "provider"])
-    .transform(value => value === "toolhub" ? "relvo" : value);
+export const platformFundingSchema = z.enum(["relvo", "provider", "mixed"]);
+const platformModelFundingSchema = z.enum(["relvo", "provider"]);
 const workspaceArgumentNames = new Set(["workspaceid", "workspaceids", "teamid", "provideraccountid", "provideraccountids", "datasetid", "datasetids", "knowledgebaseid", "sessionid", "skillid"]);
-const standaloneArgumentsSchema = z.record(z.string(), z.unknown()).pipe(platformJsonObjectSchema).superRefine((value, context) => {
-    for (const key of Object.keys(value))
-        if (workspaceArgumentNames.has(key.replaceAll("_", "").toLowerCase())) {
-            context.addIssue({ code: "custom", path: [key], message: "Workspace-owned data is unavailable on the standalone Platform." });
+export function validatePlatformArgumentIdentifiers(tool, input, context, field = "arguments") {
+    if (tool?.startsWith("custom__"))
+        return;
+    const nativeFields = tool?.startsWith("tikhub_") ? ["session_id"]
+        : tool?.startsWith("brightdata_") ? ["dataset_id"]
+            : tool?.startsWith("firecrawl_") ? ["dataset_id", "session_id", "team_id"] : [];
+    for (const key of Object.keys(input))
+        if (workspaceArgumentNames.has(key.replaceAll("_", "").toLowerCase()) && !nativeFields.includes(key)) {
+            context.addIssue({ code: "custom", path: [field, key], message: "Workspace-owned data is unavailable on the standalone Platform." });
         }
-}).describe("Self-contained tool arguments: prompts, public URLs or public account identifiers. Web workspace identifiers are not supported.");
+}
+const standaloneArgumentsSchema = z.record(z.string(), z.unknown()).pipe(platformJsonObjectSchema)
+    .describe("Self-contained tool arguments: prompts, public URLs or public account identifiers. Web workspace identifiers are not supported.");
 export const platformToolInputSchema = z.object({ tool: platformToolNameSchema.describe("Tool name from the standalone Platform catalog."), arguments: standaloneArgumentsSchema,
     provider: platformProviderChoiceSchema,
-    sessionId: platformOptionalToolSessionIdSchema.describe("Relvo tool session returned by platform_search_tools. Omit or use an empty string for standalone executions.") }).strict();
+    relevanceCheck: platformRelevanceCheckSchema,
+    intent: platformRequestIntentSchema,
+    sessionId: platformOptionalToolSessionIdSchema.describe("Relvo tool session returned by platform_search_tools. Omit or use an empty string for standalone executions.") }).strict()
+    .superRefine((value, context) => validatePlatformArgumentIdentifiers(value.tool, value.arguments, context));
+export const platformQuoteRequestSchema = platformToolInputSchema.extend({
+    maximumChargeMicros: platformMicrosSchema.optional()
+        .describe("Optional cap: an Auto quote above it returns the best plan within it as plan; execute with plan's fields."),
+}).strict();
+export const platformRunRequestHashSchema = z.string().regex(/^[a-f0-9]{64}$/);
+export const platformRecoverExecutionSchema = z.object({ idempotencyKey: z.string().regex(/^[A-Za-z0-9._:-]{8,128}$/),
+    requestHash: platformRunRequestHashSchema.optional() }).strict();
 export const platformCreateExecutionSchema = platformToolInputSchema.extend({
     maximumChargeMicros: platformMicrosSchema,
     priceVersion: z.string().min(1).max(100),
+    runRequestHash: platformRunRequestHashSchema.optional(),
 }).strict();
 export const platformQuoteSchema = z.object({
     tool: platformToolNameSchema, priceVersion: z.string(), currency: z.literal("usd"),
     minimumChargeMicros: platformMicrosSchema, maximumChargeMicros: platformMicrosSchema,
+    lowestChargeMicros: platformMicrosSchema.optional(),
     expiresAt: z.string(),
     funding: platformFundingSchema.optional(), externalBillingProviders: z.array(z.string()).optional(),
+    plan: z.object({ provider: z.string().optional(), relevanceCheck: z.literal("light").optional() }).strict().optional(),
 });
 export const platformExecutionSchema = z.object({
     id: platformExecutionIdSchema, tool: platformToolNameSchema, status: platformExecutionStatusSchema, cancelRequested: z.boolean(),
@@ -88,6 +121,9 @@ export function platformExecutionResultPageContext(result, options) {
     if (executionContextBytes(result) <= maximumBytes)
         return result;
     const { executionId, page } = result.data;
+    const fitted = { data: { executionId, page: fitToolResultPage(page, candidate => executionContextBytes({ data: { executionId, page: candidate } }) <= maximumBytes) } };
+    if (executionContextBytes(fitted) <= maximumBytes)
+        return fitted;
     const compact = { data: platformExecutionResultPageSchema.parse({ executionId, page: { ...page,
                 context: { ...page.context, offloaded: true, preview: null, reference: { ...page.context.reference,
                         executionId, readWith: options.readWith, path: page.path, offset: page.offset } },
@@ -108,20 +144,31 @@ export const platformExecutionListSchema = z.object({
 });
 export const platformArtifactIdSchema = z.string().regex(/^a_[A-Za-z0-9_-]{1,100}$/);
 export const platformArtifactSchema = z.object({
-    id: platformArtifactIdSchema, mimeType: z.enum(["image/jpeg", "image/png", "image/webp", "audio/wav", "audio/mpeg", "audio/flac", "audio/l16", "audio/mulaw", "audio/alaw", "video/mp4", "video/quicktime", "model/gltf-binary", "application/zip"]),
+    id: platformArtifactIdSchema, mimeType: z.enum(["image/jpeg", "image/png", "image/webp", "image/svg+xml", "audio/wav", "audio/mpeg", "audio/flac", "audio/l16", "audio/mulaw", "audio/alaw", "video/mp4", "video/quicktime", "model/gltf-binary", "application/zip"]),
     sizeBytes: z.number().int().positive().max(64 * 1024 * 1024), sha256: z.string().regex(/^[a-f0-9]{64}$/),
     generation: z.string().regex(/^\d{1,30}$/), expiresAt: z.iso.datetime(),
 });
 export const platformArtifactDownloadSchema = z.object({ url: z.url().refine((value) => { const url = new URL(value); return url.protocol === "https:" && !url.username && !url.password; }), expiresAt: z.iso.datetime() });
-export const platformCatalogSchema = z.object({
-    priceVersion: z.string(), currency: z.literal("usd"), executionEnabled: z.boolean(),
-    tools: z.array(z.object({
-        name: platformToolNameSchema, title: z.string().optional(), description: z.string(), category: z.enum(["research", "seo", "social", "generation", "enrichment"]),
-        available: z.boolean(), inputSchema: platformJsonObjectSchema, example: platformJsonObjectSchema,
-        providers: z.array(z.object({ id: z.string(), name: z.string(), available: z.boolean(),
-            role: z.enum(["primary", "fallback", "alternative"]), condition: z.string().optional() })).optional(),
-        models: z.array(z.object({ id: z.string(), available: z.boolean(), example: platformJsonObjectSchema, priceDescription: z.string(), funding: platformModelFundingSchema.optional() })).optional(),
-        price: z.object({ minimumChargeMicros: platformMicrosSchema, unit: z.string(), unitPriceMicros: platformMicrosSchema.nullable(), unitPriceCeilingMicros: platformMicrosSchema.optional(), description: z.string(),
-            funding: platformFundingSchema.optional(), externalBillingProviders: z.array(z.string()).optional() }),
-    })),
+export const platformUnavailableReasonSchema = z.enum(["setup", "own_key", "connection", "permission", "retired"]);
+export const platformCatalogToolSchema = z.object({
+    name: platformToolNameSchema, title: z.string().optional(), description: z.string(), category: z.enum(["research", "seo", "social", "generation", "enrichment", "finance", "news"]),
+    available: z.boolean(), unavailable: platformUnavailableReasonSchema.optional(), inputSchema: platformJsonObjectSchema, example: platformJsonObjectSchema,
+    permission: platformOAuthPermissionSchema.optional(),
+    providers: z.array(z.object({ id: z.string(), name: z.string(), available: z.boolean(), unavailable: platformUnavailableReasonSchema.optional(),
+        role: z.enum(["primary", "fallback", "alternative"]), condition: z.string().optional() })).optional(),
+    models: z.array(z.object({ id: z.string(), available: z.boolean(), unavailable: platformUnavailableReasonSchema.optional(), example: platformJsonObjectSchema, priceDescription: z.string(), funding: platformModelFundingSchema.optional() })).optional(),
+    price: z.object({ minimumChargeMicros: platformMicrosSchema, unit: z.string(), unitPriceMicros: platformMicrosSchema.nullable(), unitPriceCeilingMicros: platformMicrosSchema.optional(), description: z.string(),
+        unitsPerRequest: z.object({ minimum: z.number().int().positive(), maximum: z.number().int().positive() }).refine(range => range.minimum <= range.maximum).optional(),
+        funding: platformFundingSchema.optional(), externalBillingProviders: z.array(z.string()).optional() }),
 });
+const platformCatalogHeader = { priceVersion: z.string(), currency: z.literal("usd"), executionEnabled: z.boolean() };
+export const platformCatalogSchema = z.object({ ...platformCatalogHeader, tools: z.array(platformCatalogToolSchema) });
+export const PLATFORM_CATALOG_PAGE_MAX = 50;
+export const PLATFORM_READ_UNIT_BYTES = 262_144;
+export const platformCatalogPageQuerySchema = z.object({
+    offset: z.number().int().min(0).max(Number.MAX_SAFE_INTEGER).default(0),
+    limit: z.number().int().min(1).max(PLATFORM_CATALOG_PAGE_MAX).default(PLATFORM_CATALOG_PAGE_MAX),
+}).strict();
+export const platformCatalogPageSchema = platformCatalogSchema.extend({ total: z.number().int().min(0), nextOffset: z.number().int().min(0).nullable() });
+export const platformCatalogSummarySchema = z.object({ ...platformCatalogHeader, tools: z.array(platformCatalogToolSchema.omit({ inputSchema: true })) });
+export const platformCatalogToolDetailSchema = z.object({ ...platformCatalogHeader, tool: platformCatalogToolSchema });

package/dist/schema/platformRoutes.js

@@ -0,0 +1,119 @@
+const TOOL = "[a-z][a-z0-9_]{1,63}";
+const EXECUTION = "[A-Za-z0-9_-]{1,128}";
+const ARTIFACT = "a_[A-Za-z0-9_-]{1,100}";
+const MONITOR = "mon_[A-Za-z0-9_-]{1,100}";
+const CUSTOM_TOOL = "custom__[a-z][a-z0-9_]{1,39}";
+const TEAM_SKILL = "[a-z][a-z0-9_]{1,39}";
+const WORKFLOW = "[a-z][a-z0-9_]{1,39}";
+const WORKFLOW_RUN = "wfr_[A-Za-z0-9_-]{1,100}";
+const TRIGGER = "trg_[A-Za-z0-9_-]{1,100}";
+const MEMBER = "[A-Za-z0-9-]{1,128}";
+export const PLATFORM_ROUTES = {
+    tools: "/v1/tools",
+    connections: "/v1/connections",
+    quote: "/v1/quote",
+    project: "/v1/project",
+    usage: "/v1/usage",
+    executions: "/v1/executions",
+    executionRecovery: "/v1/executions/recover",
+    execution: `/v1/executions/:id{${EXECUTION}}`,
+    executionContext: `/v1/executions/:id{${EXECUTION}}/context`,
+    executionResult: `/v1/executions/:id{${EXECUTION}}/result`,
+    executionCancel: `/v1/executions/:id{${EXECUTION}}/cancel`,
+    artifactDownload: `/v1/executions/:id{${EXECUTION}}/artifacts/:artifact{${ARTIFACT}}/download`,
+    monitors: "/v1/monitors",
+    monitorTools: "/v1/monitors/tools",
+    monitorsPopular: "/v1/monitors/popular",
+    monitorQuote: "/v1/monitors/quote",
+    monitorResume: `/v1/monitors/:id{${MONITOR}}/resume`,
+    monitor: `/v1/monitors/:id{${MONITOR}}`,
+    monitorDelete: `/v1/monitors/:id{${MONITOR}}/delete`,
+    monitorEvents: `/v1/monitors/:id{${MONITOR}}/events`,
+    monitorDestinations: `/v1/monitors/:id{${MONITOR}}/destinations`,
+    monitorDestinationDelete: `/v1/monitors/:id{${MONITOR}}/destinations/:destinationId{dst_[A-Za-z0-9_-]{1,100}}/delete`,
+    monitorRecipients: "/v1/monitor-recipients",
+    monitorFeed: "/v1/monitor-events",
+    customTools: "/v1/custom-tools",
+    customTool: `/v1/custom-tools/:name{${CUSTOM_TOOL}}`,
+    customToolUpdate: `/v1/custom-tools/:name{${CUSTOM_TOOL}}/update`,
+    customToolDelete: `/v1/custom-tools/:name{${CUSTOM_TOOL}}/delete`,
+    customToolVersions: `/v1/custom-tools/:name{${CUSTOM_TOOL}}/versions`,
+    customToolRestore: `/v1/custom-tools/:name{${CUSTOM_TOOL}}/restore`,
+    teamSkills: "/v1/team-skills",
+    teamSkill: `/v1/team-skills/:slug{${TEAM_SKILL}}`,
+    teamSkillUpdate: `/v1/team-skills/:slug{${TEAM_SKILL}}/update`,
+    teamSkillDelete: `/v1/team-skills/:slug{${TEAM_SKILL}}/delete`,
+    teamSkillVersions: `/v1/team-skills/:slug{${TEAM_SKILL}}/versions`,
+    teamSkillRestore: `/v1/team-skills/:slug{${TEAM_SKILL}}/restore`,
+    workflows: "/v1/workflows",
+    workflow: `/v1/workflows/:slug{${WORKFLOW}}`,
+    workflowUpdate: `/v1/workflows/:slug{${WORKFLOW}}/update`,
+    workflowDelete: `/v1/workflows/:slug{${WORKFLOW}}/delete`,
+    workflowVersions: `/v1/workflows/:slug{${WORKFLOW}}/versions`,
+    workflowRuns: `/v1/workflows/:slug{${WORKFLOW}}/runs`,
+    workflowRun: `/v1/workflow-runs/:id{${WORKFLOW_RUN}}`,
+    workflowRunCancel: `/v1/workflow-runs/:id{${WORKFLOW_RUN}}/cancel`,
+    triggers: "/v1/triggers",
+    trigger: `/v1/triggers/:id{${TRIGGER}}`,
+    triggerUpdate: `/v1/triggers/:id{${TRIGGER}}/update`,
+    triggerDelete: `/v1/triggers/:id{${TRIGGER}}/delete`,
+    triggerEvents: `/v1/triggers/:id{${TRIGGER}}/events`,
+    triggerDestinations: `/v1/triggers/:id{${TRIGGER}}/destinations`,
+    triggerDestinationDelete: `/v1/triggers/:id{${TRIGGER}}/destinations/:destinationId{dst_[A-Za-z0-9_-]{1,100}}/delete`,
+    triggerFeed: "/v1/trigger-events",
+    triggerTypes: "/v1/trigger-types",
+    suggestions: "/v1/suggestions",
+    access: "/v1/access",
+    memberAccess: `/v1/access/members/:id{${MEMBER}}/update`,
+    definition: `/tools/definition/:name{${TOOL}}`,
+    tool: `/tools/:tool{${TOOL}}`,
+    discover: "/tools/discover",
+    upload: "/tools/upload",
+    skills: "/tools/skills",
+    metaSearch: "/tools/meta/search",
+    metaSchemas: "/tools/meta/schemas",
+    metaConnections: "/tools/meta/connections",
+    metaExecute: "/tools/meta/execute",
+    metaWorkbench: "/tools/meta/workbench",
+    metaBash: "/tools/meta/bash",
+};
+export const PLATFORM_TRIGGER_INGRESS_ROUTES = {
+    endpoint: "/v1/trigger-ingress/:endpoint{tep_[a-f0-9]{32}}",
+    app: "/v1/trigger-ingress/app/:app{[a-z0-9][a-z0-9_]{0,63}}",
+};
+export const PLATFORM_WALLET_ROUTES = {
+    signIn: "/v1/wallet/sign-in",
+    topUp: "/v1/wallet/top-up",
+};
+export const PLATFORM_META_ROUTES = [PLATFORM_ROUTES.metaSearch, PLATFORM_ROUTES.metaSchemas, PLATFORM_ROUTES.metaConnections,
+    PLATFORM_ROUTES.metaExecute, PLATFORM_ROUTES.metaWorkbench, PLATFORM_ROUTES.metaBash];
+export const PLATFORM_BRIDGE_ROUTES = [
+    PLATFORM_ROUTES.tools, PLATFORM_ROUTES.connections, PLATFORM_ROUTES.quote, PLATFORM_ROUTES.project, PLATFORM_ROUTES.usage,
+    PLATFORM_ROUTES.executions, PLATFORM_ROUTES.executionRecovery, PLATFORM_ROUTES.execution, PLATFORM_ROUTES.executionContext, PLATFORM_ROUTES.executionResult,
+    PLATFORM_ROUTES.executionCancel, PLATFORM_ROUTES.artifactDownload, PLATFORM_ROUTES.definition, PLATFORM_ROUTES.tool,
+];
+const ALIASED = "(?:project|usage|quote|executions|connections)(?:\\/|$)";
+const TOOLS_ALIASES = new RegExp(`^\\/tools\\/${ALIASED}`), V1_ALIASED = new RegExp(`^\\/v1\\/(?=${ALIASED})`);
+export function platformRoutePath(pathname) {
+    if (pathname === "/tools")
+        return PLATFORM_ROUTES.tools;
+    return TOOLS_ALIASES.test(pathname) ? pathname.replace(/^\/tools\//, "/v1/") : pathname;
+}
+const PARAMETER = /:([A-Za-z]+)\{((?:[^{}]|\{[^{}]*\})*)\}/g;
+export function platformToolsPath(route, values = {}) {
+    const path = route === PLATFORM_ROUTES.tools ? "/tools" : route.replace(V1_ALIASED, "/tools/");
+    return path.replace(PARAMETER, (_, name) => values[name] ?? `{${name}}`);
+}
+function routeExpression(pattern) {
+    let source = "", last = 0;
+    for (const match of pattern.matchAll(PARAMETER)) {
+        source += escapeLiteral(pattern.slice(last, match.index)) + `(?:${match[2]})`;
+        last = match.index + match[0].length;
+    }
+    return source + escapeLiteral(pattern.slice(last));
+}
+const escapeLiteral = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+const BRIDGE_PATH = new RegExp(`^(?:${PLATFORM_BRIDGE_ROUTES.map(routeExpression).join("|")})$`);
+export function isPlatformBridgePath(pathname) {
+    return BRIDGE_PATH.test(platformRoutePath(pathname));
+}

package/dist/schema/platformSkills.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 export const PLATFORM_SKILLS_MAX_BYTES = 1_048_576;
 export const PLATFORM_SKILL_MAX_BYTES = 65_536;
-export const platformSkillSchema = z.object({ name: z.string().regex(/^(?:relvo|toolhub)(?:-[a-z0-9]+)*$/).max(64),
+export const platformSkillSchema = z.object({ name: z.string().regex(/^relvo(?:-[a-z0-9]+)*$/).max(64),
     description: z.string().min(1).max(1000), sha256: z.string().regex(/^[a-f0-9]{64}$/),
     content: z.string().min(1).max(PLATFORM_SKILL_MAX_BYTES).refine(value => new TextEncoder().encode(value).byteLength <= PLATFORM_SKILL_MAX_BYTES) }).strict();
 export const platformSkillsBundleSchema = z.object({ version: z.string().regex(/^[a-f0-9]{64}$/),

package/dist/schema/platformTeamSecretName.js

@@ -0,0 +1,3 @@
+import { z } from "zod";
+export const PLATFORM_TEAM_SECRET_NAME = /^[A-Za-z_][A-Za-z0-9_]{0,63}$/;
+export const platformTeamSecretNameSchema = z.string().regex(PLATFORM_TEAM_SECRET_NAME).describe("Letters, digits and underscores, not starting with a digit, e.g. STRIPE_API_KEY.");