@relvo/mcp 0.1.2 → 0.1.4

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,17 +1,24 @@
 import { z } from "zod";
 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}$/);
@@ -22,34 +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?.includes("__"))
+        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,
+    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();
+    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(),
@@ -121,16 +149,26 @@ export const platformArtifactSchema = z.object({
     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 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(), inputSchema: platformJsonObjectSchema, example: platformJsonObjectSchema,
-    providers: z.array(z.object({ id: z.string(), name: z.string(), available: z.boolean(),
+    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(), example: platformJsonObjectSchema, priceDescription: z.string(), funding: platformModelFundingSchema.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

@@ -1,6 +1,13 @@
 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",
@@ -8,11 +15,56 @@ export const PLATFORM_ROUTES = {
     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",
@@ -25,11 +77,19 @@ export const PLATFORM_ROUTES = {
     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.execution, PLATFORM_ROUTES.executionContext, PLATFORM_ROUTES.executionResult,
+    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)(?:\\/|$)";

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.");

package/dist/schema/platformTeamSkills.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { projectScopeSchema } from "./platformPublicExecution.js";
+import { PLATFORM_CUSTOM_TOOL_LIMITS, platformVersionAuthorSchema } from "./platformCustomTools.js";
+export const PLATFORM_TEAM_SKILL_LIMITS = {
+    perProject: 200,
+    versions: 50,
+    titleChars: 80,
+    descriptionChars: 500,
+    contentBytes: 32_768,
+};
+export const PLATFORM_TEAM_SKILL_SLUG = /^[a-z][a-z0-9_]{1,39}$/;
+export const platformTeamSkillSlugSchema = z.string().regex(PLATFORM_TEAM_SKILL_SLUG).describe("Lowercase letters, digits and underscores, starting with a letter.");
+export const platformTeamSkillDefinitionSchema = z.object({
+    title: z.string().trim().min(1).max(PLATFORM_TEAM_SKILL_LIMITS.titleChars),
+    description: z.string().trim().min(1).max(PLATFORM_TEAM_SKILL_LIMITS.descriptionChars).describe("When an agent should follow this skill; agents choose skills by it."),
+    content: z.string().trim().min(1).refine(value => new TextEncoder().encode(value).byteLength <= PLATFORM_TEAM_SKILL_LIMITS.contentBytes, "The content is too long")
+        .describe("Markdown: the steps, the tools to use (by name) and what to check. No secrets."),
+}).strict();
+export const platformTeamSkillCreateSchema = platformTeamSkillDefinitionSchema.extend({ slug: platformTeamSkillSlugSchema }).strict();
+export const platformTeamSkillUpdateSchema = platformTeamSkillDefinitionSchema.extend({ expectedVersion: z.number().int().min(1) }).strict();
+export const platformTeamSkillRestoreSchema = z.object({ version: z.number().int().min(1), expectedVersion: z.number().int().min(1) }).strict();
+export const platformTeamSkillSchema = z.object({ slug: platformTeamSkillSlugSchema, title: z.string(), description: z.string(), content: z.string(),
+    version: z.number().int().min(1), createdAt: z.string(), updatedAt: z.string() });
+export const platformTeamSkillSummarySchema = platformTeamSkillSchema.omit({ content: true });
+export const platformTeamSkillVersionSchema = z.object({ version: z.number().int().min(1), title: z.string(), createdAt: z.string() });
+export const platformSuggestionSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("custom_tool"), occurrences: z.number().int().min(2), lastSeenAt: z.string(),
+        executions: z.array(z.string()).min(1).max(3),
+        code: z.string().min(1).max(PLATFORM_CUSTOM_TOOL_LIMITS.codeChars) }),
+    z.object({ kind: z.literal("skill"), occurrences: z.number().int().min(2), lastSeenAt: z.string(), tools: z.array(z.string()).min(2).max(3) }),
+]);
+export const platformSuggestionsSchema = z.object({ suggestions: z.array(platformSuggestionSchema).max(20), since: z.string() });
+export const platformTeamSkillHistorySchema = platformTeamSkillVersionSchema.extend({ author: platformVersionAuthorSchema });
+export const platformTeamSkillVersionDetailSchema = platformTeamSkillSchema.pick({ title: true, description: true, content: true })
+    .extend({ version: z.number().int().min(1), createdAt: z.string(), author: platformVersionAuthorSchema });
+const skillInput = projectScopeSchema.extend({ slug: platformTeamSkillSlugSchema });
+const skillResult = z.object({ skill: platformTeamSkillSchema }).strict();
+export const platformTeamSkillContracts = {
+    listDeveloperTeamSkills: { input: projectScopeSchema.strict(), output: z.object({ skills: z.array(platformTeamSkillSummarySchema.extend({ canEdit: z.boolean(), canDelete: z.boolean() })),
+            canCreate: z.boolean() }).strict() },
+    getDeveloperTeamSkill: { input: skillInput.strict(), output: skillResult },
+    createDeveloperTeamSkill: { input: projectScopeSchema.extend({ skill: platformTeamSkillCreateSchema }).strict(), output: skillResult },
+    updateDeveloperTeamSkill: { input: skillInput.extend({ skill: platformTeamSkillUpdateSchema }).strict(), output: skillResult },
+    restoreDeveloperTeamSkill: { input: skillInput.merge(platformTeamSkillRestoreSchema).strict(), output: skillResult },
+    deleteDeveloperTeamSkill: { input: skillInput.strict(), output: z.object({ success: z.literal(true) }).strict() },
+    listDeveloperTeamSkillVersions: { input: skillInput.strict(), output: z.object({ versions: z.array(platformTeamSkillHistorySchema) }).strict() },
+    getDeveloperTeamSkillVersion: { input: skillInput.extend({ version: z.number().int().min(1) }).strict(), output: z.object({ version: platformTeamSkillVersionDetailSchema }).strict() },
+    listDeveloperSuggestions: { input: projectScopeSchema.strict(), output: platformSuggestionsSchema },
+};

package/dist/schema/platformToolAccess.js

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import { platformCustomToolNameSchema } from "./platformCustomTools.js";
+import { PLATFORM_TEAM_SECRET_NAME } from "./platformTeamSecretName.js";
+import { PLATFORM_TEAM_SKILL_SLUG } from "./platformTeamSkills.js";
+const connectionId = z.string().regex(/^[A-Za-z0-9-]{1,64}$/), projectId = connectionId;
+export const platformConnectionGrantSchema = z.templateLiteral(["connection:", connectionId]);
+export const platformConnectionOperationGrantSchema = z.templateLiteral(["connection:", connectionId, "/", z.string().regex(/^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$/)]);
+export const platformSkillGrantSchema = z.templateLiteral(["skill:", projectId, "/", z.string().regex(PLATFORM_TEAM_SKILL_SLUG)]);
+export const platformSecretGrantSchema = z.templateLiteral(["secret:", projectId, "/", z.string().regex(PLATFORM_TEAM_SECRET_NAME)]);
+export const memberToolAccessSchema = z.array(z.union([platformCustomToolNameSchema, platformConnectionGrantSchema, platformConnectionOperationGrantSchema,
+    platformSkillGrantSchema, platformSecretGrantSchema])).max(20_000).nullable();
+export const keyToolAccessSchema = memberToolAccessSchema;
+export const platformTeamAccessSchema = z.object({
+    members: z.array(z.object({ memberId: z.string(), email: z.string(), name: z.string().nullable(), role: z.string(), toolAccess: memberToolAccessSchema }).loose()),
+    invitations: z.array(z.object({ id: z.string(), email: z.string(), role: z.string(), expiresAt: z.string(), toolAccess: memberToolAccessSchema }).loose()),
+});
+export const platformMemberAccessUpdateSchema = z.object({ toolAccess: memberToolAccessSchema }).strict();
+export const memberTeamSkillAccessSchema = z.enum(["EDIT", "OWN", "READ"]);