runline 0.12.0 → 0.14.0

package/dist/plugins/_shared/googleSchemas.js

@@ -0,0 +1,23 @@
+import * as t from "typebox";
+/** Common TypeBox primitives for Google plugin action inputs. */
+export const NonEmptyString = t.String({ minLength: 1, pattern: "\\S" });
+export const Id = t.String({ minLength: 1 });
+export const PositiveInteger = t.Integer({ minimum: 1 });
+export const NonNegativeInteger = t.Integer({ minimum: 0 });
+export const StringArray = t.Array(t.String());
+export const NonEmptyStringArray = t.Array(NonEmptyString, { minItems: 1 });
+export const StringOrNumber = t.Union([t.String(), t.Number()]);
+export const StringOrStringArray = t.Union([t.String(), t.Array(t.String())]);
+/** JSON-compatible data whose provider-specific shape is intentionally open. */
+export const RawGoogleObject = t.Object({}, { additionalProperties: true });
+export const JsonValue = t.Unknown({
+    description: "Any JSON-compatible value",
+});
+export const JsonArray = t.Array(JsonValue);
+export const StringMap = t.Record(t.String(), t.String());
+export const GoogleTimestamp = t.Union([NonEmptyString, t.Number()], {
+    description: "ISO datetime, epoch milliseconds, or epoch seconds",
+});
+export function stringEnum(values) {
+    return t.Union(values.map((value) => t.Literal(value)));
+}

package/dist/plugins/gmail/src/index.js

@@ -20,7 +20,9 @@
  * raw Gmail API response (including base64url `raw` for format=raw,
  * or parsed `payload` tree for format=full).
  */
+import * as t from "typebox";
 import { googleAccessToken } from "../../_shared/googleAuth.js";
+import { GoogleTimestamp, Id, NonEmptyString, stringEnum, } from "../../_shared/googleSchemas.js";
 // ─── Auth ────────────────────────────────────────────────────────
 async function accessToken(ctx) {
     return googleAccessToken(ctx, "gmail", SCOPES);
@@ -503,6 +505,82 @@ const SCOPES = [
     "https://www.googleapis.com/auth/gmail.compose",
     "https://www.googleapis.com/auth/gmail.labels",
 ];
+// ─── Action input schemas ────────────────────────────────────────
+const strict = { additionalProperties: false };
+const EmptyInput = t.Object({}, strict);
+const IdInput = t.Object({ id: Id }, strict);
+const MessageFormat = stringEnum(["minimal", "full", "raw", "metadata"]);
+const ThreadFormat = stringEnum(["minimal", "full", "metadata"]);
+const ReadStatus = stringEnum(["read", "unread", "both"]);
+const LabelListVisibility = stringEnum([
+    "labelShow",
+    "labelShowIfUnread",
+    "labelHide",
+]);
+const MessageListVisibility = stringEnum(["show", "hide"]);
+const MetadataHeaders = t.Array(t.String());
+const LabelIds = t.Array(NonEmptyString, { minItems: 1 });
+const MaxResults = t.Integer({ minimum: 1, maximum: 500 });
+const AttachmentContent = t.Union([
+    t.String(),
+    t.Object({ contentBase64: t.String() }, strict),
+]);
+const Attachment = t.Object({
+    name: t.Optional(t.String()),
+    filename: t.Optional(t.String()),
+    mimeType: t.Optional(t.String()),
+    contentBase64: AttachmentContent,
+}, strict);
+const Attachments = t.Array(Attachment);
+const HasMessageContent = {
+    anyOf: [
+        {
+            required: ["text"],
+            properties: { text: { type: "string", minLength: 1, pattern: "\\S" } },
+        },
+        {
+            required: ["html"],
+            properties: { html: { type: "string", minLength: 1, pattern: "\\S" } },
+        },
+        {
+            required: ["attachments"],
+            properties: { attachments: { type: "array", minItems: 1 } },
+        },
+    ],
+};
+const ReplyFields = {
+    text: t.Optional(t.String()),
+    html: t.Optional(t.String()),
+    cc: t.Optional(t.String()),
+    bcc: t.Optional(t.String()),
+    replyToSenderOnly: t.Optional(t.Boolean()),
+    replyToRecipientsOnly: t.Optional(t.Boolean()),
+    attachments: t.Optional(Attachments),
+};
+const ReplyOptions = {
+    ...strict,
+    ...HasMessageContent,
+    not: {
+        required: ["replyToSenderOnly", "replyToRecipientsOnly"],
+        properties: {
+            replyToSenderOnly: { const: true },
+            replyToRecipientsOnly: { const: true },
+        },
+    },
+};
+const ListFields = {
+    q: t.Optional(t.String({ description: "Gmail search query" })),
+    sender: t.Optional(t.String()),
+    readStatus: t.Optional(ReadStatus),
+    receivedAfter: t.Optional(GoogleTimestamp),
+    receivedBefore: t.Optional(GoogleTimestamp),
+    labelIds: t.Optional(t.Array(NonEmptyString)),
+    maxResults: t.Optional(MaxResults),
+    pageToken: t.Optional(t.String()),
+    includeSpamTrash: t.Optional(t.Boolean()),
+    returnAll: t.Optional(t.Boolean()),
+};
+const ListInput = t.Object(ListFields, strict);
 export default function gmail(rl) {
     rl.setName("gmail");
     rl.setVersion("0.1.0");
@@ -618,30 +696,18 @@ export default function gmail(rl) {
     rl.registerAction("message.send", {
         access: "write",
         description: "Send an email",
-        inputSchema: {
-            to: {
-                type: "string",
-                required: true,
-                description: "Comma-separated recipient list",
-            },
-            subject: { type: "string", required: true },
-            text: { type: "string", required: false, description: "Plain body" },
-            html: { type: "string", required: false, description: "HTML body" },
-            cc: { type: "string", required: false },
-            bcc: { type: "string", required: false },
-            replyTo: { type: "string", required: false },
-            from: {
-                type: "string",
-                required: false,
-                description: 'Override From (e.g. "Name <me@x.com>")',
-            },
-            threadId: { type: "string", required: false },
-            attachments: {
-                type: "array",
-                required: false,
-                description: "[{name, mimeType, contentBase64}]",
-            },
-        },
+        inputSchema: t.Object({
+            to: NonEmptyString,
+            subject: t.String(),
+            text: t.Optional(t.String({ description: "Plain body" })),
+            html: t.Optional(t.String({ description: "HTML body" })),
+            cc: t.Optional(t.String()),
+            bcc: t.Optional(t.String()),
+            replyTo: t.Optional(t.String()),
+            from: t.Optional(t.String({ description: 'Override From (e.g. "Name <me@x.com>")' })),
+            threadId: t.Optional(Id),
+            attachments: t.Optional(Attachments),
+        }, { ...strict, ...HasMessageContent }),
         async execute(input, ctx) {
             const p = (input ?? {});
             const email = {
@@ -664,16 +730,7 @@ export default function gmail(rl) {
     rl.registerAction("message.reply", {
         access: "write",
         description: "Reply to a message, preserving threadId and In-Reply-To/References headers",
-        inputSchema: {
-            messageId: { type: "string", required: true },
-            text: { type: "string", required: false },
-            html: { type: "string", required: false },
-            cc: { type: "string", required: false },
-            bcc: { type: "string", required: false },
-            replyToSenderOnly: { type: "boolean", required: false },
-            replyToRecipientsOnly: { type: "boolean", required: false },
-            attachments: { type: "array", required: false },
-        },
+        inputSchema: t.Object({ messageId: Id, ...ReplyFields }, ReplyOptions),
         async execute(input, ctx) {
             const p = (input ?? {});
             return replyToMessage(ctx, p.messageId, p);
@@ -682,20 +739,14 @@ export default function gmail(rl) {
     rl.registerAction("message.get", {
         access: "read",
         description: "Get a message by ID",
-        inputSchema: {
-            id: { type: "string", required: true },
-            format: {
-                type: "string",
-                required: false,
-                description: "minimal | full | raw | metadata (default: full)",
-            },
-            metadataHeaders: { type: "array", required: false },
-            simple: {
-                type: "boolean",
-                required: false,
+        inputSchema: t.Object({
+            id: Id,
+            format: t.Optional(MessageFormat),
+            metadataHeaders: t.Optional(MetadataHeaders),
+            simple: t.Optional(t.Boolean({
                 description: "Flatten headers, resolve labels to names, and decode text/html bodies",
-            },
-        },
+            })),
+        }, strict),
         async execute(input, ctx) {
             const p = (input ?? {});
             const qs = { format: p.format ?? "full" };
@@ -711,30 +762,7 @@ export default function gmail(rl) {
     rl.registerAction("message.list", {
         access: "read",
         description: "List messages. Supports Gmail search syntax via `q`, plus friendly filters: sender, readStatus ('read'|'unread'), receivedAfter/Before (ISO string, ms, or seconds).",
-        inputSchema: {
-            q: { type: "string", required: false, description: "Gmail search query" },
-            sender: { type: "string", required: false },
-            readStatus: {
-                type: "string",
-                required: false,
-                description: "read | unread | both (default: both)",
-            },
-            receivedAfter: {
-                type: "string",
-                required: false,
-                description: "ISO datetime, epoch ms, or epoch seconds",
-            },
-            receivedBefore: { type: "string", required: false },
-            labelIds: { type: "array", required: false },
-            maxResults: { type: "number", required: false },
-            pageToken: { type: "string", required: false },
-            includeSpamTrash: { type: "boolean", required: false },
-            returnAll: {
-                type: "boolean",
-                required: false,
-                description: "Paginate until exhausted",
-            },
-        },
+        inputSchema: ListInput,
         async execute(input, ctx) {
             const p = (input ?? {});
             const qs = buildListQuery(p);
@@ -749,7 +777,7 @@ export default function gmail(rl) {
     rl.registerAction("message.delete", {
         access: "write",
         description: "Permanently delete a message",
-        inputSchema: { id: { type: "string", required: true } },
+        inputSchema: IdInput,
         async execute(input, ctx) {
             const { id } = input;
             return gmailRequest(ctx, "DELETE", `/messages/${id}`);
@@ -758,7 +786,7 @@ export default function gmail(rl) {
     rl.registerAction("message.trash", {
         access: "write",
         description: "Move a message to trash (recoverable)",
-        inputSchema: { id: { type: "string", required: true } },
+        inputSchema: IdInput,
         async execute(input, ctx) {
             const { id } = input;
             return gmailRequest(ctx, "POST", `/messages/${id}/trash`);
@@ -767,7 +795,7 @@ export default function gmail(rl) {
     rl.registerAction("message.untrash", {
         access: "write",
         description: "Remove a message from trash",
-        inputSchema: { id: { type: "string", required: true } },
+        inputSchema: IdInput,
         async execute(input, ctx) {
             const { id } = input;
             return gmailRequest(ctx, "POST", `/messages/${id}/untrash`);
@@ -776,7 +804,7 @@ export default function gmail(rl) {
     rl.registerAction("message.markAsRead", {
         access: "write",
         description: "Remove the UNREAD label",
-        inputSchema: { id: { type: "string", required: true } },
+        inputSchema: IdInput,
         async execute(input, ctx) {
             const { id } = input;
             return gmailRequest(ctx, "POST", `/messages/${id}/modify`, {
@@ -787,7 +815,7 @@ export default function gmail(rl) {
     rl.registerAction("message.markAsUnread", {
         access: "write",
         description: "Add the UNREAD label",
-        inputSchema: { id: { type: "string", required: true } },
+        inputSchema: IdInput,
         async execute(input, ctx) {
             const { id } = input;
             return gmailRequest(ctx, "POST", `/messages/${id}/modify`, {
@@ -798,10 +826,7 @@ export default function gmail(rl) {
     rl.registerAction("message.addLabels", {
         access: "write",
         description: "Add labels to a message",
-        inputSchema: {
-            id: { type: "string", required: true },
-            labelIds: { type: "array", required: true },
-        },
+        inputSchema: t.Object({ id: Id, labelIds: LabelIds }, strict),
         async execute(input, ctx) {
             const { id, labelIds } = input;
             return gmailRequest(ctx, "POST", `/messages/${id}/modify`, {
@@ -812,10 +837,7 @@ export default function gmail(rl) {
     rl.registerAction("message.removeLabels", {
         access: "write",
         description: "Remove labels from a message",
-        inputSchema: {
-            id: { type: "string", required: true },
-            labelIds: { type: "array", required: true },
-        },
+        inputSchema: t.Object({ id: Id, labelIds: LabelIds }, strict),
         async execute(input, ctx) {
             const { id, labelIds } = input;
             return gmailRequest(ctx, "POST", `/messages/${id}/modify`, {
@@ -826,10 +848,7 @@ export default function gmail(rl) {
     rl.registerAction("message.getAttachment", {
         access: "read",
         description: "Download an attachment by ID (returns {size, data} where data is base64url)",
-        inputSchema: {
-            messageId: { type: "string", required: true },
-            attachmentId: { type: "string", required: true },
-        },
+        inputSchema: t.Object({ messageId: Id, attachmentId: Id }, strict),
         async execute(input, ctx) {
             const { messageId, attachmentId } = input;
             return gmailRequest(ctx, "GET", `/messages/${messageId}/attachments/${attachmentId}`);
@@ -839,20 +858,14 @@ export default function gmail(rl) {
     rl.registerAction("thread.get", {
         access: "read",
         description: "Get a thread by ID",
-        inputSchema: {
-            id: { type: "string", required: true },
-            format: {
-                type: "string",
-                required: false,
-                description: "minimal | full | metadata",
-            },
-            metadataHeaders: { type: "array", required: false },
-            simple: {
-                type: "boolean",
-                required: false,
+        inputSchema: t.Object({
+            id: Id,
+            format: t.Optional(ThreadFormat),
+            metadataHeaders: t.Optional(MetadataHeaders),
+            simple: t.Optional(t.Boolean({
                 description: "Return an array of simplified messages instead of the raw thread",
-            },
-        },
+            })),
+        }, strict),
         async execute(input, ctx) {
             const p = (input ?? {});
             const qs = { format: p.format ?? "full" };
@@ -868,18 +881,7 @@ export default function gmail(rl) {
     rl.registerAction("thread.list", {
         access: "read",
         description: "List threads. Same filter sugar as `message.list` (sender, readStatus, receivedAfter/Before).",
-        inputSchema: {
-            q: { type: "string", required: false },
-            sender: { type: "string", required: false },
-            readStatus: { type: "string", required: false },
-            receivedAfter: { type: "string", required: false },
-            receivedBefore: { type: "string", required: false },
-            labelIds: { type: "array", required: false },
-            maxResults: { type: "number", required: false },
-            pageToken: { type: "string", required: false },
-            includeSpamTrash: { type: "boolean", required: false },
-            returnAll: { type: "boolean", required: false },
-        },
+        inputSchema: ListInput,
         async execute(input, ctx) {
             const p = (input ?? {});
             const qs = buildListQuery(p);
@@ -893,7 +895,7 @@ export default function gmail(rl) {
     rl.registerAction("thread.delete", {
         access: "write",
         description: "Permanently delete a thread",
-        inputSchema: { id: { type: "string", required: true } },
+        inputSchema: IdInput,
         async execute(input, ctx) {
             const { id } = input;
             return gmailRequest(ctx, "DELETE", `/threads/${id}`);
@@ -902,7 +904,7 @@ export default function gmail(rl) {
     rl.registerAction("thread.trash", {
         access: "write",
         description: "Move a thread to trash",
-        inputSchema: { id: { type: "string", required: true } },
+        inputSchema: IdInput,
         async execute(input, ctx) {
             const { id } = input;
             return gmailRequest(ctx, "POST", `/threads/${id}/trash`);
@@ -911,7 +913,7 @@ export default function gmail(rl) {
     rl.registerAction("thread.untrash", {
         access: "write",
         description: "Remove a thread from trash",
-        inputSchema: { id: { type: "string", required: true } },
+        inputSchema: IdInput,
         async execute(input, ctx) {
             const { id } = input;
             return gmailRequest(ctx, "POST", `/threads/${id}/untrash`);
@@ -920,10 +922,7 @@ export default function gmail(rl) {
     rl.registerAction("thread.addLabels", {
         access: "write",
         description: "Add labels to all messages in a thread",
-        inputSchema: {
-            id: { type: "string", required: true },
-            labelIds: { type: "array", required: true },
-        },
+        inputSchema: t.Object({ id: Id, labelIds: LabelIds }, strict),
         async execute(input, ctx) {
             const { id, labelIds } = input;
             return gmailRequest(ctx, "POST", `/threads/${id}/modify`, {
@@ -934,10 +933,7 @@ export default function gmail(rl) {
     rl.registerAction("thread.removeLabels", {
         access: "write",
         description: "Remove labels from all messages in a thread",
-        inputSchema: {
-            id: { type: "string", required: true },
-            labelIds: { type: "array", required: true },
-        },
+        inputSchema: t.Object({ id: Id, labelIds: LabelIds }, strict),
         async execute(input, ctx) {
             const { id, labelIds } = input;
             return gmailRequest(ctx, "POST", `/threads/${id}/modify`, {
@@ -948,16 +944,7 @@ export default function gmail(rl) {
     rl.registerAction("thread.reply", {
         access: "write",
         description: "Reply to the last message in a thread (convenience wrapper over message.reply)",
-        inputSchema: {
-            id: { type: "string", required: true, description: "Thread ID" },
-            text: { type: "string", required: false },
-            html: { type: "string", required: false },
-            cc: { type: "string", required: false },
-            bcc: { type: "string", required: false },
-            replyToSenderOnly: { type: "boolean", required: false },
-            replyToRecipientsOnly: { type: "boolean", required: false },
-            attachments: { type: "array", required: false },
-        },
+        inputSchema: t.Object({ id: Id, ...ReplyFields }, ReplyOptions),
         async execute(input, ctx) {
             const p = (input ?? {});
             const thread = (await gmailRequest(ctx, "GET", `/threads/${p.id}`, undefined, { format: "minimal" }));
@@ -972,23 +959,21 @@ export default function gmail(rl) {
     rl.registerAction("draft.create", {
         access: "write",
         description: "Create a draft",
-        inputSchema: {
-            to: { type: "string", required: false },
-            subject: { type: "string", required: false },
-            text: { type: "string", required: false },
-            html: { type: "string", required: false },
-            cc: { type: "string", required: false },
-            bcc: { type: "string", required: false },
-            replyTo: { type: "string", required: false },
-            from: { type: "string", required: false },
-            fromAlias: {
-                type: "string",
-                required: false,
+        inputSchema: t.Object({
+            to: t.Optional(t.String()),
+            subject: t.Optional(t.String()),
+            text: t.Optional(t.String()),
+            html: t.Optional(t.String()),
+            cc: t.Optional(t.String()),
+            bcc: t.Optional(t.String()),
+            replyTo: t.Optional(t.String()),
+            from: t.Optional(t.String()),
+            fromAlias: t.Optional(t.String({
                 description: "Send-as alias address (e.g. 'me+alt@x.com'); sets the From header",
-            },
-            threadId: { type: "string", required: false },
-            attachments: { type: "array", required: false },
-        },
+            })),
+            threadId: t.Optional(Id),
+            attachments: t.Optional(Attachments),
+        }, strict),
         async execute(input, ctx) {
             const p = (input ?? {});
             const from = p.from ?? p.fromAlias;
@@ -1024,10 +1009,7 @@ export default function gmail(rl) {
     rl.registerAction("draft.get", {
         access: "read",
         description: "Get a draft by ID",
-        inputSchema: {
-            id: { type: "string", required: true },
-            format: { type: "string", required: false },
-        },
+        inputSchema: t.Object({ id: Id, format: t.Optional(MessageFormat) }, strict),
         async execute(input, ctx) {
             const p = (input ?? {});
             const qs = { format: p.format ?? "full" };
@@ -1037,13 +1019,13 @@ export default function gmail(rl) {
     rl.registerAction("draft.list", {
         access: "read",
         description: "List drafts",
-        inputSchema: {
-            q: { type: "string", required: false },
-            maxResults: { type: "number", required: false },
-            pageToken: { type: "string", required: false },
-            includeSpamTrash: { type: "boolean", required: false },
-            returnAll: { type: "boolean", required: false },
-        },
+        inputSchema: t.Object({
+            q: t.Optional(t.String()),
+            maxResults: t.Optional(MaxResults),
+            pageToken: t.Optional(t.String()),
+            includeSpamTrash: t.Optional(t.Boolean()),
+            returnAll: t.Optional(t.Boolean()),
+        }, strict),
         async execute(input, ctx) {
             const p = (input ?? {});
             const qs = {};
@@ -1063,7 +1045,7 @@ export default function gmail(rl) {
     rl.registerAction("draft.delete", {
         access: "write",
         description: "Delete a draft",
-        inputSchema: { id: { type: "string", required: true } },
+        inputSchema: IdInput,
         async execute(input, ctx) {
             const { id } = input;
             return gmailRequest(ctx, "DELETE", `/drafts/${id}`);
@@ -1072,7 +1054,7 @@ export default function gmail(rl) {
     rl.registerAction("draft.send", {
         access: "write",
         description: "Send an existing draft",
-        inputSchema: { id: { type: "string", required: true } },
+        inputSchema: IdInput,
         async execute(input, ctx) {
             const { id } = input;
             return gmailRequest(ctx, "POST", "/drafts/send", { id });
@@ -1082,19 +1064,11 @@ export default function gmail(rl) {
     rl.registerAction("label.create", {
         access: "write",
         description: "Create a label",
-        inputSchema: {
-            name: { type: "string", required: true },
-            labelListVisibility: {
-                type: "string",
-                required: false,
-                description: "labelShow | labelShowIfUnread | labelHide",
-            },
-            messageListVisibility: {
-                type: "string",
-                required: false,
-                description: "show | hide",
-            },
-        },
+        inputSchema: t.Object({
+            name: NonEmptyString,
+            labelListVisibility: t.Optional(LabelListVisibility),
+            messageListVisibility: t.Optional(MessageListVisibility),
+        }, strict),
         async execute(input, ctx) {
             const p = (input ?? {});
             const body = { name: p.name };
@@ -1110,7 +1084,7 @@ export default function gmail(rl) {
     rl.registerAction("label.get", {
         access: "read",
         description: "Get a label by ID",
-        inputSchema: { id: { type: "string", required: true } },
+        inputSchema: IdInput,
         async execute(input, ctx) {
             const { id } = input;
             return gmailRequest(ctx, "GET", `/labels/${id}`);
@@ -1119,6 +1093,7 @@ export default function gmail(rl) {
     rl.registerAction("label.list", {
         access: "read",
         description: "List all labels",
+        inputSchema: EmptyInput,
         async execute(_input, ctx) {
             const res = (await gmailRequest(ctx, "GET", "/labels"));
             return res.labels ?? [];
@@ -1127,7 +1102,7 @@ export default function gmail(rl) {
     rl.registerAction("label.delete", {
         access: "write",
         description: "Delete a label",
-        inputSchema: { id: { type: "string", required: true } },
+        inputSchema: IdInput,
         async execute(input, ctx) {
             const { id } = input;
             return gmailRequest(ctx, "DELETE", `/labels/${id}`);
@@ -1136,12 +1111,19 @@ export default function gmail(rl) {
     rl.registerAction("label.update", {
         access: "write",
         description: "Update a label",
-        inputSchema: {
-            id: { type: "string", required: true },
-            name: { type: "string", required: false },
-            labelListVisibility: { type: "string", required: false },
-            messageListVisibility: { type: "string", required: false },
-        },
+        inputSchema: t.Object({
+            id: Id,
+            name: t.Optional(NonEmptyString),
+            labelListVisibility: t.Optional(LabelListVisibility),
+            messageListVisibility: t.Optional(MessageListVisibility),
+        }, {
+            ...strict,
+            anyOf: [
+                { required: ["name"] },
+                { required: ["labelListVisibility"] },
+                { required: ["messageListVisibility"] },
+            ],
+        }),
         async execute(input, ctx) {
             const p = (input ?? {});
             const body = {};
@@ -1160,6 +1142,7 @@ export default function gmail(rl) {
     rl.registerAction("profile.get", {
         access: "read",
         description: "Get the authenticated user's profile",
+        inputSchema: EmptyInput,
         async execute(_input, ctx) {
             return gmailRequest(ctx, "GET", "/profile");
         },
@@ -1167,6 +1150,7 @@ export default function gmail(rl) {
     rl.registerAction("alias.list", {
         access: "read",
         description: "List configured send-as aliases",
+        inputSchema: EmptyInput,
         async execute(_input, ctx) {
             const res = (await gmailRequest(ctx, "GET", "/settings/sendAs"));
             return res.sendAs ?? [];