runline 0.32.0 → 0.34.0

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

@@ -1,29 +1,18 @@
-const BASE = "https://api.twist.com/api/v3";
-async function api(token, method, endpoint, body, qs) {
-    const url = new URL(`${BASE}${endpoint}`);
-    if (qs) {
-        for (const [k, v] of Object.entries(qs)) {
-            if (v !== undefined && v !== null)
-                url.searchParams.set(k, String(v));
-        }
-    }
-    const init = {
+import { credentialJson } from "../../_shared/credentials.js";
+import { twistCredential } from "./credentials.js";
+function api(ctx, method, endpoint, body, qs) {
+    return credentialJson(ctx, twistCredential, "twist", {
+        target: "api",
+        path: endpoint.replace(/^\//, ""),
         method,
-        headers: {
-            Authorization: `Bearer ${token}`,
-            "Content-Type": "application/json",
-        },
-    };
-    if (body && Object.keys(body).length > 0)
-        init.body = JSON.stringify(body);
-    const res = await fetch(url.toString(), init);
-    if (!res.ok)
-        throw new Error(`Twist error ${res.status}: ${await res.text()}`);
-    return res.json();
+        query: qs,
+        ...(body && Object.keys(body).length > 0 ? { json: body } : {}),
+    });
 }
 export default function twist(rl) {
     rl.setName("twist");
     rl.setVersion("0.1.0");
+    rl.setCredential(twistCredential);
     rl.setConnectionSchema({
         accessToken: {
             type: "string",
@@ -32,7 +21,6 @@ export default function twist(rl) {
             env: "TWIST_ACCESS_TOKEN",
         },
     });
-    const t = (ctx) => ctx.connection.config.accessToken;
     // ── Channel ─────────────────────────────────────────
     rl.registerAction("channel.create", {
         access: "write",
@@ -42,7 +30,7 @@ export default function twist(rl) {
             name: { type: "string", required: true },
         },
         async execute(input, ctx) {
-            return api(t(ctx), "POST", "/channels/add", {
+            return api(ctx, "POST", "/channels/add", {
                 workspace_id: input.workspaceId,
                 name: input.name,
             });
@@ -53,7 +41,7 @@ export default function twist(rl) {
         description: "Get a channel",
         inputSchema: { id: { type: "number", required: true } },
         async execute(input, ctx) {
-            return api(t(ctx), "GET", "/channels/getone", undefined, {
+            return api(ctx, "GET", "/channels/getone", undefined, {
                 id: input.id,
             });
         },
@@ -67,7 +55,7 @@ export default function twist(rl) {
         },
         async execute(input, ctx) {
             const p = input;
-            const data = (await api(t(ctx), "GET", "/channels/get", undefined, {
+            const data = (await api(ctx, "GET", "/channels/get", undefined, {
                 workspace_id: p.workspaceId,
             }));
             return p.limit ? data.slice(0, p.limit) : data;
@@ -82,7 +70,7 @@ export default function twist(rl) {
             description: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            return api(t(ctx), "POST", "/channels/update", input);
+            return api(ctx, "POST", "/channels/update", input);
         },
     });
     rl.registerAction("channel.delete", {
@@ -90,7 +78,7 @@ export default function twist(rl) {
         description: "Delete a channel",
         inputSchema: { id: { type: "number", required: true } },
         async execute(input, ctx) {
-            return api(t(ctx), "POST", "/channels/remove", undefined, {
+            return api(ctx, "POST", "/channels/remove", undefined, {
                 id: input.id,
             });
         },
@@ -100,7 +88,7 @@ export default function twist(rl) {
         description: "Archive a channel",
         inputSchema: { id: { type: "number", required: true } },
         async execute(input, ctx) {
-            return api(t(ctx), "POST", "/channels/archive", undefined, {
+            return api(ctx, "POST", "/channels/archive", undefined, {
                 id: input.id,
             });
         },
@@ -110,7 +98,7 @@ export default function twist(rl) {
         description: "Unarchive a channel",
         inputSchema: { id: { type: "number", required: true } },
         async execute(input, ctx) {
-            return api(t(ctx), "POST", "/channels/unarchive", undefined, {
+            return api(ctx, "POST", "/channels/unarchive", undefined, {
                 id: input.id,
             });
         },
@@ -126,7 +114,7 @@ export default function twist(rl) {
         },
         async execute(input, ctx) {
             const p = input;
-            return api(t(ctx), "POST", "/threads/add", {
+            return api(ctx, "POST", "/threads/add", {
                 channel_id: p.channelId,
                 title: p.title,
                 content: p.content,
@@ -138,7 +126,7 @@ export default function twist(rl) {
         description: "Get a thread",
         inputSchema: { id: { type: "number", required: true } },
         async execute(input, ctx) {
-            return api(t(ctx), "GET", "/threads/getone", undefined, {
+            return api(ctx, "GET", "/threads/getone", undefined, {
                 id: input.id,
             });
         },
@@ -155,7 +143,7 @@ export default function twist(rl) {
             const qs = { channel_id: p.channelId };
             if (p.limit)
                 qs.limit = p.limit;
-            return api(t(ctx), "GET", "/threads/get", undefined, qs);
+            return api(ctx, "GET", "/threads/get", undefined, qs);
         },
     });
     rl.registerAction("thread.update", {
@@ -167,7 +155,7 @@ export default function twist(rl) {
             content: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            return api(t(ctx), "POST", "/threads/update", input);
+            return api(ctx, "POST", "/threads/update", input);
         },
     });
     rl.registerAction("thread.delete", {
@@ -175,7 +163,7 @@ export default function twist(rl) {
         description: "Delete a thread",
         inputSchema: { id: { type: "number", required: true } },
         async execute(input, ctx) {
-            return api(t(ctx), "POST", "/threads/remove", undefined, {
+            return api(ctx, "POST", "/threads/remove", undefined, {
                 id: input.id,
             });
         },
@@ -190,7 +178,7 @@ export default function twist(rl) {
         },
         async execute(input, ctx) {
             const p = input;
-            return api(t(ctx), "POST", "/comments/add", {
+            return api(ctx, "POST", "/comments/add", {
                 thread_id: p.threadId,
                 content: p.content,
             });
@@ -201,7 +189,7 @@ export default function twist(rl) {
         description: "Get a comment",
         inputSchema: { id: { type: "number", required: true } },
         async execute(input, ctx) {
-            const data = (await api(t(ctx), "GET", "/comments/getone", undefined, {
+            const data = (await api(ctx, "GET", "/comments/getone", undefined, {
                 id: input.id,
             }));
             return data.comment ?? data;
@@ -219,7 +207,7 @@ export default function twist(rl) {
             const qs = { thread_id: p.threadId };
             if (p.limit)
                 qs.limit = p.limit;
-            return api(t(ctx), "GET", "/comments/get", undefined, qs);
+            return api(ctx, "GET", "/comments/get", undefined, qs);
         },
     });
     rl.registerAction("comment.update", {
@@ -230,7 +218,7 @@ export default function twist(rl) {
             content: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            return api(t(ctx), "POST", "/comments/update", input);
+            return api(ctx, "POST", "/comments/update", input);
         },
     });
     rl.registerAction("comment.delete", {
@@ -238,7 +226,7 @@ export default function twist(rl) {
         description: "Delete a comment",
         inputSchema: { id: { type: "number", required: true } },
         async execute(input, ctx) {
-            return api(t(ctx), "POST", "/comments/remove", undefined, {
+            return api(ctx, "POST", "/comments/remove", undefined, {
                 id: input.id,
             });
         },
@@ -254,7 +242,7 @@ export default function twist(rl) {
         },
         async execute(input, ctx) {
             const p = input;
-            return api(t(ctx), "POST", "/conversation_messages/add", {
+            return api(ctx, "POST", "/conversation_messages/add", {
                 workspace_id: p.workspaceId,
                 conversation_id: p.conversationId,
                 content: p.content,
@@ -266,7 +254,7 @@ export default function twist(rl) {
         description: "Get a conversation message",
         inputSchema: { id: { type: "number", required: true } },
         async execute(input, ctx) {
-            return api(t(ctx), "GET", "/conversation_messages/getone", undefined, {
+            return api(ctx, "GET", "/conversation_messages/getone", undefined, {
                 id: input.id,
             });
         },
@@ -276,7 +264,7 @@ export default function twist(rl) {
         description: "List messages in a conversation",
         inputSchema: { conversationId: { type: "number", required: true } },
         async execute(input, ctx) {
-            return api(t(ctx), "GET", "/conversation_messages/get", undefined, {
+            return api(ctx, "GET", "/conversation_messages/get", undefined, {
                 conversation_id: input.conversationId,
             });
         },
@@ -289,7 +277,7 @@ export default function twist(rl) {
             content: { type: "string", required: false },
         },
         async execute(input, ctx) {
-            return api(t(ctx), "POST", "/conversation_messages/update", input);
+            return api(ctx, "POST", "/conversation_messages/update", input);
         },
     });
     rl.registerAction("messageConversation.delete", {
@@ -297,7 +285,7 @@ export default function twist(rl) {
         description: "Delete a conversation message",
         inputSchema: { id: { type: "number", required: true } },
         async execute(input, ctx) {
-            return api(t(ctx), "POST", "/conversation_messages/remove", undefined, {
+            return api(ctx, "POST", "/conversation_messages/remove", undefined, {
                 id: input.id,
             });
         },

package/dist/plugins/twitter/src/credentials.js

@@ -0,0 +1,16 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/**
+ * An OAuth2 token (app-only or user-context), sent as a bearer to the
+ * Twitter/X v2 API origin.
+ */
+export const twitterCredential = staticCredential({
+    id: "twitter",
+    auth: { kind: "bearer" },
+    local: { secret: "bearerToken" },
+    targets: {
+        api: {
+            baseUrl: "https://api.twitter.com/2/",
+            methods: ["GET", "POST", "DELETE"],
+        },
+    },
+});

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

@@ -1,35 +1,23 @@
-const BASE = "https://api.twitter.com/2";
-async function api(token, method, endpoint, body, qs, fullOutput = false) {
-    const url = new URL(`${BASE}${endpoint}`);
-    if (qs) {
-        for (const [k, v] of Object.entries(qs)) {
-            if (v !== undefined && v !== null)
-                url.searchParams.set(k, String(v));
-        }
-    }
-    const init = {
+import { credentialJson, pathSegment } from "../../_shared/credentials.js";
+import { twitterCredential } from "./credentials.js";
+async function api(ctx, method, path, body, qs, fullOutput = false) {
+    const json = (await credentialJson(ctx, twitterCredential, "twitter", {
+        target: "api",
+        path,
         method,
-        headers: {
-            Authorization: `Bearer ${token}`,
-            "Content-Type": "application/json",
-        },
-    };
-    if (body && Object.keys(body).length > 0)
-        init.body = JSON.stringify(body);
-    const res = await fetch(url.toString(), init);
-    if (!res.ok)
-        throw new Error(`Twitter error ${res.status}: ${await res.text()}`);
-    const json = (await res.json());
+        query: qs,
+        ...(body && Object.keys(body).length > 0 ? { json: body } : {}),
+    }));
     return fullOutput ? json : json.data;
 }
-async function paginate(token, endpoint, qs = {}, limit) {
+async function paginate(ctx, path, qs = {}, limit) {
     const results = [];
     let nextToken;
     qs.max_results = limit && limit < 100 ? limit : 10;
     do {
         if (nextToken)
             qs.next_token = nextToken;
-        const res = (await api(token, "GET", endpoint, undefined, { ...qs }, true));
+        const res = (await api(ctx, "GET", path, undefined, { ...qs }, true));
         const data = res.data;
         if (data)
             results.push(...data);
@@ -43,6 +31,7 @@ async function paginate(token, endpoint, qs = {}, limit) {
 export default function twitter(rl) {
     rl.setName("twitter");
     rl.setVersion("0.1.0");
+    rl.setCredential(twitterCredential);
     rl.setConnectionSchema({
         bearerToken: {
             type: "string",
@@ -51,7 +40,6 @@ export default function twitter(rl) {
             env: "TWITTER_BEARER_TOKEN",
         },
     });
-    const t = (ctx) => ctx.connection.config.bearerToken;
     // ── Tweet ───────────────────────────────────────────
     rl.registerAction("tweet.create", {
         access: "write",
@@ -82,7 +70,7 @@ export default function twitter(rl) {
                 body.media = { media_ids: [p.mediaId] };
             if (p.placeId)
                 body.geo = { place_id: p.placeId };
-            return api(t(ctx), "POST", "/tweets", body);
+            return api(ctx, "POST", "tweets", body);
         },
     });
     rl.registerAction("tweet.delete", {
@@ -90,7 +78,7 @@ export default function twitter(rl) {
         description: "Delete a tweet",
         inputSchema: { id: { type: "string", required: true } },
         async execute(input, ctx) {
-            return api(t(ctx), "DELETE", `/tweets/${input.id}`);
+            return api(ctx, "DELETE", `tweets/${pathSegment(input.id)}`);
         },
     });
     rl.registerAction("tweet.like", {
@@ -98,8 +86,8 @@ export default function twitter(rl) {
         description: "Like a tweet (requires user context)",
         inputSchema: { tweetId: { type: "string", required: true } },
         async execute(input, ctx) {
-            const user = (await api(t(ctx), "GET", "/users/me"));
-            return api(t(ctx), "POST", `/users/${user.id}/likes`, {
+            const user = (await api(ctx, "GET", "users/me"));
+            return api(ctx, "POST", `users/${pathSegment(user.id)}/likes`, {
                 tweet_id: input.tweetId,
             });
         },
@@ -109,8 +97,8 @@ export default function twitter(rl) {
         description: "Retweet a tweet (requires user context)",
         inputSchema: { tweetId: { type: "string", required: true } },
         async execute(input, ctx) {
-            const user = (await api(t(ctx), "GET", "/users/me"));
-            return api(t(ctx), "POST", `/users/${user.id}/retweets`, {
+            const user = (await api(ctx, "GET", "users/me"));
+            return api(ctx, "POST", `users/${pathSegment(user.id)}/retweets`, {
                 tweet_id: input.tweetId,
             });
         },
@@ -155,9 +143,9 @@ export default function twitter(rl) {
                 qs["tweet.fields"] = p.tweetFields;
             const limit = p.limit;
             if (limit) {
-                return paginate(t(ctx), "/tweets/search/recent", qs, limit);
+                return paginate(ctx, "tweets/search/recent", qs, limit);
             }
-            return paginate(t(ctx), "/tweets/search/recent", qs);
+            return paginate(ctx, "tweets/search/recent", qs);
         },
     });
     // ── User ────────────────────────────────────────────
@@ -180,13 +168,13 @@ export default function twitter(rl) {
         async execute(input, ctx) {
             const p = input;
             if (p.me)
-                return api(t(ctx), "GET", "/users/me");
+                return api(ctx, "GET", "users/me");
             if (p.username) {
                 const name = p.username.replace(/^@/, "");
-                return api(t(ctx), "GET", `/users/by/username/${name}`);
+                return api(ctx, "GET", `users/by/username/${pathSegment(name)}`);
             }
             if (p.id)
-                return api(t(ctx), "GET", `/users/${p.id}`);
+                return api(ctx, "GET", `users/${pathSegment(p.id)}`);
             throw new Error("Provide username, id, or set me=true");
         },
     });
@@ -200,7 +188,7 @@ export default function twitter(rl) {
         },
         async execute(input, ctx) {
             const p = input;
-            return api(t(ctx), "POST", `/lists/${p.listId}/members`, {
+            return api(ctx, "POST", `lists/${pathSegment(p.listId)}/members`, {
                 user_id: p.userId,
             });
         },
@@ -223,7 +211,7 @@ export default function twitter(rl) {
             const body = { text: p.text };
             if (p.mediaId)
                 body.attachments = [{ media_id: p.mediaId }];
-            return api(t(ctx), "POST", `/dm_conversations/with/${p.userId}/messages`, body);
+            return api(ctx, "POST", `dm_conversations/with/${pathSegment(p.userId)}/messages`, body);
         },
     });
 }

package/dist/plugins/typesafe/src/credentials.js

@@ -0,0 +1,28 @@
+import { httpsBase, staticCredential } from "../../_shared/credentials.js";
+const DEFAULT_BASE = "https://api.typesafe.ai";
+/**
+ * A TypeSafe API key, sent as a bearer to the configured base's /v1/
+ * endpoints. The base URL is public config, defaults to the hosted API,
+ * and must be HTTPS.
+ */
+export const typesafeCredential = staticCredential({
+    id: "typesafe",
+    auth: { kind: "bearer" },
+    local: { secret: "apiKey" },
+    targets: (config) => {
+        const raw = config.baseUrl;
+        const base = typeof raw === "string" && raw.trim() ? raw.trim() : DEFAULT_BASE;
+        return {
+            api: {
+                baseUrl: httpsBase(base, "v1/"),
+                methods: ["GET", "POST"],
+            },
+        };
+    },
+    probe: {
+        target: "api",
+        path: "models",
+        method: "GET",
+        acceptedStatuses: [200],
+    },
+});

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

@@ -1,4 +1,5 @@
 import * as t from "typebox";
+import { typesafeCredential } from "./credentials.js";
 import { GUIDE, GUIDE_TOPICS } from "./guide.js";
 import { choiceRubric, noulRubric, questionsSchema, scoreRubric, toWireQuestion, toWireQuestions, } from "./questions.js";
 import { DEFAULT_BASE, DEFAULT_MODEL, evaluate, modelSchema, request, resolveModel, STRICT, stateSchema, } from "./shared.js";
@@ -25,6 +26,7 @@ const USE_WHEN = "Reach for it whenever a bounded decision is currently costing
 export default function typesafe(rl) {
     rl.setName("typesafe");
     rl.setVersion("0.1.0");
+    rl.setCredential(typesafeCredential);
     rl.setConnectionSchema(t.Object({
         apiKey: t.String({
             env: "TYPESAFE_API_KEY",
@@ -137,7 +139,7 @@ export default function typesafe(rl) {
             "Versioned ids such as 'jev-1.13.0' are accepted whether or not they appear here.",
         inputSchema: t.Object({}, STRICT),
         async execute(_input, ctx) {
-            const body = await request(ctx, "/v1/models");
+            const body = await request(ctx, "models");
             if (!Array.isArray(body.models)) {
                 throw new Error("TypeSafe returned a response with no models list.");
             }

package/dist/plugins/typesafe/src/shared.js

@@ -1,4 +1,6 @@
 import * as t from "typebox";
+import { credentialRequest } from "../../_shared/credentials.js";
+import { typesafeCredential } from "./credentials.js";
 export const STRICT = { additionalProperties: false };
 export const DEFAULT_BASE = "https://api.typesafe.ai";
 export const DEFAULT_MODEL = "jev-latest";
@@ -19,18 +21,6 @@ const CHARS_PER_TOKEN = 4;
 function config(ctx) {
     return ctx.connection?.config ?? {};
 }
-function apiKey(ctx) {
-    const key = config(ctx).apiKey;
-    if (typeof key !== "string" || !key.trim()) {
-        throw new Error("Missing TYPESAFE_API_KEY. Create a key at https://console.typesafe.ai/settings/keys and store it as a secret.");
-    }
-    return key.trim();
-}
-function baseUrl(ctx) {
-    const raw = config(ctx).baseUrl;
-    const base = typeof raw === "string" && raw.trim() ? raw.trim() : DEFAULT_BASE;
-    return base.replace(/\/+$/, "");
-}
 export function resolveModel(ctx, override) {
     if (typeof override === "string" && override.trim())
         return override.trim();
@@ -63,39 +53,36 @@ function retryDelayMs(response, attempt) {
     }
     return Math.min(250 * 2 ** attempt, 8_000);
 }
-function explain(status, body) {
-    const detail = body.slice(0, 500);
+/** By status alone: provider error text can echo request data and is dropped. */
+function explain(status) {
     switch (status) {
         case 401:
-            return `TypeSafe 401: the API key was rejected. ${detail}`;
+            return "TypeSafe 401: the API key was rejected.";
         case 422:
-            return `TypeSafe 422: the request body failed validation — a missing field or a malformed question. ${detail}`;
+            return "TypeSafe 422: the request body failed validation — a missing field or a malformed question.";
         case 429:
-            return `TypeSafe 429: rate limit exceeded (250k tokens/sec, 1,200 req/min). Raise the connection's maxRetries or slow the caller. ${detail}`;
+            return "TypeSafe 429: rate limit exceeded (250k tokens/sec, 1,200 req/min). Raise the connection's maxRetries or slow the caller.";
         case 503:
-            return `TypeSafe 503: the model is unavailable. Transient — retry, and contact TypeSafe if it persists. ${detail}`;
+            return "TypeSafe 503: the model is unavailable. Transient — retry, and contact TypeSafe if it persists.";
         case 529:
-            return `TypeSafe 529: the service is overloaded. Retry after a short delay. ${detail}`;
+            return "TypeSafe 529: the service is overloaded. Retry after a short delay.";
         default:
             return status >= 500
-                ? `TypeSafe ${status}: the service failed this request. Transient — retry after a short delay. ${detail}`
-                : `TypeSafe ${status}: ${detail}`;
+                ? `TypeSafe ${status}: the service failed this request. Transient — retry after a short delay.`
+                : `TypeSafe ${status}: request failed.`;
     }
 }
 async function sleep(ms) {
     await new Promise((resolve) => setTimeout(resolve, ms));
 }
-export async function request(ctx, path, init = {}) {
-    const url = `${baseUrl(ctx)}${path}`;
-    const headers = new Headers(init.headers);
-    headers.set("authorization", `Bearer ${apiKey(ctx)}`);
-    headers.set("accept", "application/json");
-    if (init.body && !headers.has("content-type")) {
-        headers.set("content-type", "application/json");
-    }
+export async function request(ctx, path, json) {
     const attempts = maxRetries(ctx);
     for (let attempt = 0;; attempt++) {
-        const response = await fetch(url, { ...init, headers });
+        const response = await credentialRequest(ctx, typesafeCredential, {
+            target: "api",
+            path,
+            ...(json !== undefined ? { method: "POST", json } : {}),
+        });
         if (response.ok) {
             const text = await response.text();
             if (!text)
@@ -104,14 +91,14 @@ export async function request(ctx, path, init = {}) {
                 return JSON.parse(text);
             }
             catch {
-                throw new Error(`TypeSafe returned a non-JSON body: ${text.slice(0, 200)}`);
+                throw new Error("TypeSafe returned a non-JSON body.");
             }
         }
         if (retryable(response.status) && attempt < attempts) {
             await sleep(retryDelayMs(response, attempt));
             continue;
         }
-        throw new Error(explain(response.status, await response.text()));
+        throw new Error(explain(response.status));
     }
 }
 /** Serialized length, measuring exactly what the request body will carry. */
@@ -142,9 +129,10 @@ export async function evaluate(ctx, state, questions, model) {
         throw new Error("At least one question is required.");
     }
     assertWithinContext(state, questions);
-    const body = await request(ctx, "/v1/systemone", {
-        method: "POST",
-        body: JSON.stringify({ state, model, questions }),
+    const body = await request(ctx, "systemone", {
+        state,
+        model,
+        questions,
     });
     if (!body || typeof body.answers !== "object" || body.answers === null) {
         throw new Error("TypeSafe returned a response with no answers map.");

package/dist/plugins/unleashedSoftware/src/credentials.js

@@ -0,0 +1,21 @@
+import { staticCredential } from "../../_shared/credentials.js";
+/**
+ * An API ID, sent as the api-auth-id header, and an API key that signs
+ * the query of every request: the transport sends its HMAC-SHA256 as
+ * api-auth-signature and never the key itself.
+ */
+export const unleashedSoftwareCredential = staticCredential({
+    id: "unleashedSoftware",
+    auth: {
+        kind: "static",
+        parts: ["apiId", "apiKey"],
+        placements: [
+            { in: "header", part: "apiId", name: "api-auth-id" },
+            { in: "querySignature", part: "apiKey", name: "api-auth-signature" },
+        ],
+    },
+    local: { apiId: "apiId", apiKey: "apiKey" },
+    targets: {
+        api: { baseUrl: "https://api.unleashedsoftware.com/", methods: ["GET"] },
+    },
+});