@relvo/mcp 0.1.2 → 0.1.3

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?.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,
+    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,13 @@
+import { z } from "zod";
+import { platformCustomToolNameSchema } from "./platformCustomTools.js";
+const connectionId = z.string().regex(/^[A-Za-z0-9-]{1,64}$/);
+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 memberToolAccessSchema = z.array(z.union([platformCustomToolNameSchema, platformConnectionGrantSchema, platformConnectionOperationGrantSchema])).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"]);

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() },
+};