runline 0.1.0 → 0.2.0

package/README.md

@@ -1,273 +1,20 @@
-# runline ⚡
+# runline
 
-Code mode for agents.
+The runline library and CLI. See the [monorepo README](../../README.md) for the full story, quickstart, and plugin catalog.
 
-Turn any API into a callable action. Install a plugin, write JavaScript, call actions. The code runs in a QuickJS WASM sandbox — no filesystem, no network, just plugin actions via a proxy.
+## What lives here
 
-```bash
-npm install -g runline
-```
-
-## Quick Start
-
-```bash
-runline init
-runline plugin install git:github.com/Michaelliv/runline#plugins/brandfetch
-runline connection add bf --plugin brandfetch --set apiKey=xxx
-
-runline exec 'return await brandfetch.brand.getColors({ domain: "nike.com" })'
-# => [{ hex: "#E5E5E5", type: "accent" }, { hex: "#111111", type: "dark" }, ...]
-```
-
-Agent code runs in a QuickJS sandbox. Each installed plugin is a top-level global — no bracket notation, just dot-chain into resource and action. Plugins execute outside the sandbox with full network access; the agent can only reach APIs through the actions you've installed.
-
-```js
-// agent writes this
-const company = await brandfetch.brand.getCompany({ domain: "stripe.com" });
-const deals = await pipedrive.deal.list({ limit: 10 });
-const issue = await github.issue.create({
-  owner: "acme", repo: "api",
-  title: `New lead: ${company.name}`,
-  body: `${deals.length} open deals`
-});
-return { company: company.name, issue: issue.number };
-```
-
-## Plugins
-
-188 plugins covering popular SaaS, DevOps, and productivity APIs. Each wraps a single service's REST/GraphQL API with typed actions.
-
-All plugins install via `runline plugin install git:github.com/Michaelliv/runline#plugins/<name>`.
-
-| Plugin | Actions | Auth |
-|--------|---------|------|
-| **github** | file/issue/pr/release/repo/review/user CRUD, search | Bearer token |
-| **gitlab** | issue/merge request/repo/user CRUD | Bearer token |
-| **jira** | issue/project/user CRUD, transitions | Basic auth |
-| **slack** | channel/message/user/reaction/star/file ops | Bearer token |
-| **discord** | channel/message/member CRUD, reactions | Bot token |
-| **notion** | block/database/page/user CRUD, search | Bearer token |
-| **todoist** | task/project/section/comment/label CRUD | Bearer token |
-| **linear** | issue/project/team/comment CRUD (GraphQL) | Bearer token |
-| **hubspot** | contact/company/deal/ticket/engagement CRUD | Bearer token |
-| **pipedrive** | deal/person/org/activity/lead/note/product CRUD, search | API token |
-| **salesforce** | account/contact/lead/opportunity/case/task CRUD | OAuth2 |
-| **shopify** | order/product/customer CRUD | API key |
-| **stripe** | charge/customer/source/coupon CRUD | Bearer token |
-| **airtable** | base/record CRUD, search, upsert | Bearer token |
-| **supabase** | row CRUD | API key |
-| **docker** | container/image/volume/network ops | Unix socket |
-| **telegram** | message/chat/callback/pin ops | Bot token in URL |
-| **twitter** | tweet/user/dm/list ops | OAuth2 Bearer |
-| **clickup** | task/list/folder/space/comment/checklist/team CRUD | Bearer token |
-| **asana** | task/project/section/subtask/tag/user CRUD | Bearer token |
-| **trello** | board/list/card/checklist/attachment/label/member CRUD | API key |
-| **monday** | board/group/item/column/update (GraphQL) | Bearer token |
-| **mailchimp** | list/member/campaign/tag ops | Bearer token |
-| **sendgrid** | contact/list/email ops | Bearer token |
-| **elasticsearch** | document/index CRUD | Basic auth |
-| **cloudflare** | zone/dns/worker/kv/r2/d1/pages/queue CRUD | Bearer token |
-| **databricks** | sql/files/genie/catalog/table/volume/function/vector search | Bearer token |
-| **splunk** | search/alert/report/user CRUD | Bearer token |
-| **home-assistant** | state/service/history/config/template/event ops | Bearer token |
-| **openweathermap** | current/5-day forecast | API key |
-| **brandfetch** | logos/colors/fonts/company/industry lookup | Bearer token |
-
-<details>
-<summary>All 188 plugins</summary>
-
-actionNetwork, activeCampaign, adalo, affinity, agileCrm, airtable, airtop, apiTemplateIo, asana, autopilot, bambooHr, bannerbear, baserow, beeminder, bitly, bitwarden, box, brandfetch, brevo, bubble, chargebee, circleci, ciscoWebex, clearbit, clickup, clockify, cloudflare, cockpit, coda, coingecko, contentful, convertkit, copper, cortex, currents, customerIo, databricks, deepl, demio, dhl, discord, discourse, disqus, docker, drift, dropbox, dropcontact, egoi, elasticsearch, emelia, erpnext, facebookGraph, freshdesk, freshservice, freshworksCrm, getresponse, ghost, github, gitlab, gong, gotify, gotowebinar, grafana, graphql, grist, hackernews, halopsa, harvest, helpscout, highlevel, homeAssistant, hubspot, humanticAi, hunter, intercom, iterable, jenkins, jira, keap, kobotoolbox, lemlist, line, linear, lingvanex, linkedin, lonescale, magento, mailcheck, mailchimp, mailerlite, mailgun, mailjet, mandrill, marketstack, matrix, mattermost, mautic, medium, messagebird, metabase, misp, mocean, monday, monicaCrm, msg91, nasa, netlify, netscalerAdc, nextcloud, nocodb, notion, npm, odoo, okta, oneSimpleApi, onfleet, openThesaurus, openweathermap, oura, paddle, pagerduty, paypal, peekalink, phantombuster, philipsHue, pipedrive, plivo, postbin, posthog, profitwell, pushbullet, pushcut, pushover, quickbase, quickbooks, quickchart, raindrop, reddit, rocketchat, rundeck, salesforce, salesmate, securityScorecard, segment, sendgrid, sendy, sentry, servicenow, shopify, signl4, slack, sms77, splunk, spotify, stackby, storyblok, strapi, strava, stripe, supabase, syncromsp, tapfiliate, telegram, thehive, thehiveProject, todoist, travisci, trello, twake, twilio, twist, twitter, unleashedSoftware, uplead, uproc, uptimerobot, urlscanio, vero, vonage, wekan, woocommerce, wordpress, xero, yourls, zammad, zendesk, zoho, zoom, zulip
-
-</details>
-
-## Examples
-
-```bash
-# List all available actions
-runline actions
-
-# Get Nike's brand colors
-runline exec 'return await brandfetch.brand.getColors({ domain: "nike.com" })'
-
-# Create a GitHub issue
-runline exec '
-  return await github.issue.create({
-    owner: "acme", repo: "api",
-    title: "Bug: login broken",
-    labels: ["bug", "urgent"]
-  })
-'
-
-# Search Pipedrive deals
-runline exec 'return await pipedrive.deal.search({ term: "Acme" })'
-
-# Chain actions together
-runline exec '
-  const contact = await hubspot.contact.get({ id: "123" });
-  const task = await todoist.task.create({
-    content: `Follow up with ${contact.properties.firstname}`,
-    priority: 4
-  });
-  return { contact: contact.properties.email, taskId: task.id };
-'
-
-# Discover actions from inside the sandbox
-runline exec 'return brandfetch.help()'
-runline exec 'return help()'
-
-# Output as JSON (for agents)
-runline exec 'return await github.repo.list({ owner: "torvalds" })' --json
-```
-
-## Writing a Plugin
-
-Plugins export a function that receives a `RunlinePluginAPI` and registers actions.
-
-```typescript
-import type { RunlinePluginAPI } from "runline";
-
-export default function orders(rl: RunlinePluginAPI) {
-  rl.setName("orders");
-  rl.setVersion("1.0.0");
-
-  // Connection config — env vars override config.json values
-  rl.setConnectionSchema({
-    apiKey: { type: "string", required: true, env: "ORDERS_API_KEY" },
-    baseUrl: { type: "string", required: true, env: "ORDERS_BASE_URL" },
-  });
+- `src/` — the library source (SDK, engine, plugin API, loader, CLI commands)
+- `scripts/` — tooling (e.g. `generate-plugin-table.js` for the root README)
+- `dist/plugins/` — populated at build time by copying `packages/runline-plugins/dist`
 
-  rl.registerAction("list", {
-    description: "List orders for an organization",
-    inputSchema: {
-      orgId: { type: "string", required: true },
-      status: { type: "string", required: false, description: "open, closed, or all" },
-      limit: { type: "number", required: false },
-    },
-    async execute(input, ctx) {
-      const { orgId, status, limit } = input as Record<string, unknown>;
-      const url = new URL(`${ctx.connection.config.baseUrl}/orgs/${orgId}/orders`);
-      if (status) url.searchParams.set("status", status as string);
-      if (limit) url.searchParams.set("limit", String(limit));
-
-      const res = await fetch(url.toString(), {
-        headers: { Authorization: `Bearer ${ctx.connection.config.apiKey}` },
-      });
-      if (!res.ok) throw new Error(`Orders API ${res.status}: ${await res.text()}`);
-      return res.json();
-    },
-  });
-
-  rl.registerAction("create", {
-    description: "Create a new order",
-    inputSchema: {
-      orgId: { type: "string", required: true },
-      customer: { type: "string", required: true },
-      total: { type: "number", required: true },
-    },
-    async execute(input, ctx) {
-      const res = await fetch(`${ctx.connection.config.baseUrl}/orders`, {
-        method: "POST",
-        headers: {
-          Authorization: `Bearer ${ctx.connection.config.apiKey}`,
-          "Content-Type": "application/json",
-        },
-        body: JSON.stringify(input),
-      });
-      if (!res.ok) throw new Error(`Orders API ${res.status}: ${await res.text()}`);
-      return res.json();
-    },
-  });
-}
-```
-
-Key points: `execute` runs **outside** the sandbox with full Node.js access (fetch, fs, etc). The sandbox can only call your actions through the proxy. `ctx.connection.config` holds the resolved config with env var overrides applied.
-
-See [plugins/](plugins/) for 188 real-world examples.
-
-## Sandbox
-
-Agent code runs in a [QuickJS](https://bellard.org/quickjs/) WASM sandbox:
-
-- **No `fetch`** — network access is only through plugin actions
-- **No `fs`** — no filesystem access
-- **Timeout** — configurable, kills infinite loops
-- **Memory limit** — configurable, prevents OOM
-- **`console.log`** — captured and returned in `result.logs`
-- **Plugin globals** — each installed plugin is a top-level proxy (e.g. `github`, `slack`, `brandfetch`). Dot-chain into resource and action: `github.issue.create(input)`
-
-## For Agents
-
-Every command supports `--json`. Use `runline actions --json` for full schemas with input types.
-
-```bash
-runline actions --json          # all actions with schemas
-runline exec '<code>' --json    # structured { result, logs } output
-```
-
-## SDK
-
-```typescript
-import { Runline } from "runline";
-import brandfetch from "runline-plugin-brandfetch";
-
-const rl = Runline.create({
-  plugins: [brandfetch],
-  connections: [{ name: "bf", plugin: "brandfetch", config: { apiKey: "xxx" } }],
-});
-
-const result = await rl.execute(`
-  const colors = await brandfetch.brand.getColors({ domain: "stripe.com" });
-  return colors.filter(c => c.type === "accent");
-`);
-
-console.log(result.result);  // [{ hex: "#635BFF", type: "accent", brightness: 116 }]
-```
-
-## CLI Reference
-
-```bash
-runline exec "<code>"                  # execute JS in sandbox
-runline exec -f ./script.js            # execute a file
-runline actions                        # list all actions
-runline plugin install <source>        # install from git/npm/local
-runline plugin list                    # list installed plugins
-runline plugin remove <name>           # remove a plugin
-runline connection add <n> -p <plugin> -s key=val  # add connection
-runline connection list                # list connections
-runline connection remove <name>       # remove a connection
-runline init                           # create .runline/ directory
-```
-
-## Configuration
-
-`.runline/config.json`:
-
-```json
-{
-  "connections": [
-    { "name": "gh", "plugin": "github", "config": { "token": "ghp_xxx" } },
-    { "name": "bf", "plugin": "brandfetch", "config": { "apiKey": "xxx" } }
-  ],
-  "timeoutMs": 30000,
-  "memoryLimitBytes": 67108864
-}
-```
-
-Env vars override config values. Plugins declare env var names in their connection schema (e.g. `GITHUB_TOKEN`).
-
-## Development
+## Scripts
 
 ```bash
-npm install
-npm run dev -- exec 'return 1 + 2'
-npm test
-npm run check
+bun run dev -- exec 'return 1 + 2'   # run the CLI from source
+bun run build                         # compile + bundle built-in plugins
+bun run test                          # bun test src/tests
+bun run check                         # biome check
 ```
 
-## How It Relates to dripline
-
-[dripline](https://github.com/Michaelliv/dripline) is **query mode** — SQL tables over live APIs. runline is **code mode** — JavaScript actions over the same APIs. Same plugin architecture, same connection config, different interface. Use dripline when you want to `SELECT` rows; use runline when you want to `create`, `update`, `delete`, or chain multiple API calls together.
-
-## License
-
-MIT
+`build` does two things: compiles `src/` with `tsc`, then invokes `bun --filter runline-plugins build` and copies the output into `dist/plugins/` so the published package ships with every built-in plugin.

package/dist/sdk.d.ts

@@ -28,7 +28,10 @@ export declare class Runline {
         name: string;
         version: string;
         actions: string[];
+        connectionConfigSchema?: PluginDef["connectionConfigSchema"];
     }>;
+    /** Return all connections currently configured. */
+    connections(): ConnectionConfig[];
     /**
      * Load runline from a project directory.
      * Discovers .runline/ config and installed plugins, just like the CLI.

package/dist/sdk.js

@@ -54,8 +54,13 @@ export class Runline {
             name: p.name,
             version: p.version,
             actions: p.actions.map((a) => a.name),
+            connectionConfigSchema: p.connectionConfigSchema,
         }));
     }
+    /** Return all connections currently configured. */
+    connections() {
+        return [...this._config.connections];
+    }
     /**
      * Load runline from a project directory.
      * Discovers .runline/ config and installed plugins, just like the CLI.

package/package.json

@@ -1,41 +1,51 @@
 {
   "name": "runline",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Code mode for agents — turn any API or command into a callable action",
   "type": "module",
   "main": "dist/index.js",
   "exports": {
-    ".": "./dist/index.js",
-    "./utils/http": "./dist/utils/http.js",
-    "./utils/cli": "./dist/utils/cli.js"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./utils/http": {
+      "types": "./dist/utils/http.d.ts",
+      "import": "./dist/utils/http.js",
+      "default": "./dist/utils/http.js"
+    },
+    "./utils/cli": {
+      "types": "./dist/utils/cli.d.ts",
+      "import": "./dist/utils/cli.js",
+      "default": "./dist/utils/cli.js"
+    }
   },
   "bin": {
     "runline": "./dist/main.js"
   },
   "files": [
-    "dist",
-    ".pi/extensions"
+    "dist"
   ],
-  "pi": {
-    "extensions": [
-      ".pi/extensions/runline-context"
-    ]
-  },
   "scripts": {
-    "build": "tsc && tsc -p tsconfig.plugins.json --noCheck",
-    "prepublishOnly": "npm run build",
-    "dev": "npx tsx src/main.ts",
-    "test": "npx tsx --test src/tests/**/*.test.ts",
-    "format": "npx @biomejs/biome format --write src/",
-    "lint": "npx @biomejs/biome lint src/",
-    "check": "npx @biomejs/biome check src/"
+    "build": "tsc && bun --filter runline-plugins build && rm -rf dist/plugins && cp -R ../runline-plugins/dist dist/plugins",
+    "prepublishOnly": "bun run build",
+    "dev": "bun run src/main.ts",
+    "test": "bun test src/tests",
+    "format": "bunx @biomejs/biome format --write src/",
+    "lint": "bunx @biomejs/biome lint src/",
+    "check": "bunx @biomejs/biome check src/"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Michaelliv/runline.git"
   },
   "homepage": "https://github.com/Michaelliv/runline#readme",
+  "bugs": {
+    "url": "https://github.com/Michaelliv/runline/issues"
+  },
   "keywords": [
+    "pi-package",
     "agent",
     "tools",
     "mcp",
@@ -45,8 +55,8 @@
   "license": "MIT",
   "devDependencies": {
     "@biomejs/biome": "^2.3.14",
+    "@types/bun": "^1.2.17",
     "@types/node": "^25.5.0",
-    "tsx": "^4.21.0",
     "typescript": "^5.8.0"
   },
   "dependencies": {

package/.pi/extensions/runline-context/index.ts

@@ -1,135 +0,0 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import { Markdown, Text } from "@mariozechner/pi-tui";
-import { Runline } from "../../../src/sdk.js";
-
-function formatActions(
-  actions: Array<{
-    plugin: string;
-    action: string;
-    description?: string;
-    inputSchema?: Record<string, { type: string; required?: boolean; description?: string }>;
-  }>,
-): string {
-  const grouped = new Map<string, typeof actions>();
-  for (const a of actions) {
-    const list = grouped.get(a.plugin) ?? [];
-    list.push(a);
-    grouped.set(a.plugin, list);
-  }
-
-  const lines: string[] = [];
-  for (const [plugin, entries] of grouped) {
-    lines.push(`### ${plugin}`);
-    for (const a of entries) {
-      const inputs = a.inputSchema
-        ? Object.entries(a.inputSchema)
-            .map(
-              ([k, v]) =>
-                `${k}: ${v.type}${v.required ? "" : "?"}`,
-            )
-            .join(", ")
-        : "";
-      const sig = inputs
-        ? `\`${plugin}.${a.action}({ ${inputs} })\``
-        : `\`${plugin}.${a.action}()\``;
-      const desc = a.description ? ` — ${a.description}` : "";
-      lines.push(`- ${sig}${desc}`);
-    }
-    lines.push("");
-  }
-
-  return lines.join("\n");
-}
-
-export default function (pi: ExtensionAPI) {
-  pi.registerMessageRenderer(
-    "runline-context",
-    (message, { expanded }, theme) => {
-      if (!expanded) {
-        const label = theme.fg("customMessageLabel", "⚡ runline actions");
-        const hint = theme.fg("dim", " — Ctrl+O to expand");
-        return new Text(label + hint, 1, 0);
-      }
-      return new Markdown(
-        message.content,
-        1,
-        0,
-        {
-          heading: (t) => theme.fg("mdHeading", t),
-          link: (t) => theme.fg("mdLink", t),
-          linkUrl: (t) => theme.fg("mdLinkUrl", t),
-          code: (t) => theme.fg("mdCode", t),
-          codeBlock: (t) => theme.fg("mdCodeBlock", t),
-          codeBlockBorder: (t) => theme.fg("mdCodeBlockBorder", t),
-          quote: (t) => theme.fg("mdQuote", t),
-          quoteBorder: (t) => theme.fg("mdQuoteBorder", t),
-          hr: (t) => theme.fg("mdHr", t),
-          listBullet: (t) => theme.fg("mdListBullet", t),
-          bold: (t) => theme.bold(t),
-          italic: (t) => theme.italic(t),
-          strikethrough: (t) => theme.strikethrough(t),
-          underline: (t) => theme.underline(t),
-        },
-        { color: (t) => theme.fg("customMessageText", t) },
-      );
-    },
-  );
-
-  pi.on("session_start", async (_event, ctx) => {
-    const rl = await Runline.fromProject(ctx.cwd);
-
-    if (!rl) {
-      if (ctx.hasUI) {
-        ctx.ui.setStatus("runline", ctx.ui.theme.fg("dim", "runline: no .runline/"));
-      }
-      return;
-    }
-
-    const actions = rl.actions();
-    const plugins = rl.plugins();
-
-    if (actions.length === 0) {
-      if (ctx.hasUI) {
-        ctx.ui.setStatus("runline", ctx.ui.theme.fg("dim", "runline: no plugins"));
-      }
-      return;
-    }
-
-    // Check if already injected
-    const alreadyInjected = ctx.sessionManager
-      .getEntries()
-      .some(
-        (e: any) =>
-          e.type === "message" &&
-          e.message.role === "custom" &&
-          e.message.customType === "runline-context",
-      );
-
-    if (!alreadyInjected) {
-      const header =
-        "## Runline actions\n\n" +
-        "This project has runline installed. You can execute JavaScript in a sandbox " +
-        "where each installed plugin is a top-level global. Chain actions together, " +
-        "call `help()` or `pluginName.help()` inside the sandbox for discovery.\n\n" +
-        `**${plugins.length} plugins, ${actions.length} actions available.**\n\n` +
-        "Use `runline exec '<code>'` to run code. Examples:\n" +
-        "```js\n" +
-        "return await github.issue.create({ owner: \"acme\", repo: \"api\", title: \"Bug\" })\n" +
-        "```\n\n";
-
-      ctx.sessionManager.appendCustomMessageEntry(
-        "runline-context",
-        header + formatActions(actions),
-        true,
-      );
-    }
-
-    if (ctx.hasUI) {
-      const theme = ctx.ui.theme;
-      ctx.ui.setStatus(
-        "runline",
-        `⚡${theme.fg("dim", ` runline: ${plugins.length} plugins, ${actions.length} actions`)}`,
-      );
-    }
-  });
-}

package/.pi/extensions/runline-context/package.json

@@ -1,17 +0,0 @@
-{
-  "name": "@miclivs/pi-runline-context",
-  "version": "0.1.0",
-  "description": "Pi extension — injects runline actions into agent context",
-  "type": "commonjs",
-  "keywords": ["pi-package"],
-  "files": ["index.ts", "README.md"],
-  "pi": {
-    "extensions": ["."]
-  },
-  "peerDependencies": {
-    "@mariozechner/pi-coding-agent": "*",
-    "@mariozechner/pi-tui": "*"
-  },
-  "author": "michaelliv",
-  "license": "MIT"
-}