@nimbus-dev/connectors 0.2.3 → 0.3.0

package/connectors/apple/src/server.ts

@@ -12,6 +12,7 @@
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { requireProcessEnv } from "../../../shared/mcp-tool-kit.ts";
 import {
   createAppleCalDavClient,
@@ -39,7 +40,10 @@ try {
   // non-fatal; listEvents/list tools will re-discover on demand
 }
 
-const server = new McpServer({ name: "nimbus-apple", version: "0.1.0" });
+const server = new McpServer(
+  { name: "nimbus-apple", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerAppleTools(server, {
   client: createAppleImapClient(email, appPw),

package/connectors/aws/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerAwsTools } from "./tools.ts";
 
-const mcp = new McpServer({ name: "nimbus-aws", version: "0.1.0" });
+const mcp = new McpServer(
+  { name: "nimbus-aws", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerAwsTools(mcp);
 

package/connectors/azure/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerAzureTools } from "./tools.ts";
 
-const mcp = new McpServer({ name: "nimbus-azure", version: "0.1.0" });
+const mcp = new McpServer(
+  { name: "nimbus-azure", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerAzureTools(mcp);
 

package/connectors/bitbucket/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerBitbucketTools } from "./tools.ts";
 
-const server = new McpServer({ name: "nimbus-bitbucket", version: "0.1.0" });
+const server = new McpServer(
+  { name: "nimbus-bitbucket", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerBitbucketTools(server);
 

package/connectors/circleci/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerCircleciTools } from "./tools.ts";
 
-const mcp = new McpServer({ name: "nimbus-circleci", version: "0.1.0" });
+const mcp = new McpServer(
+  { name: "nimbus-circleci", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerCircleciTools(mcp);
 

package/connectors/confluence/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerConfluenceTools } from "./tools.ts";
 
-const server = new McpServer({ name: "nimbus-confluence", version: "0.1.0" });
+const server = new McpServer(
+  { name: "nimbus-confluence", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerConfluenceTools(server);
 

package/connectors/fastmail/src/server.ts

@@ -1,9 +1,13 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { createFetchJmapClient } from "./jmap-client.ts";
 import { registerFastmailTools } from "./tools.ts";
 
-const server = new McpServer({ name: "nimbus-fastmail", version: "0.1.0" });
+const server = new McpServer(
+  { name: "nimbus-fastmail", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 registerFastmailTools(server, createFetchJmapClient());
 
 await server.connect(new StdioServerTransport());

package/connectors/gcp/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerGcpTools } from "./tools.ts";
 
-const mcp = new McpServer({ name: "nimbus-gcp", version: "0.1.0" });
+const mcp = new McpServer(
+  { name: "nimbus-gcp", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerGcpTools(mcp);
 

package/connectors/github/src/server.ts

@@ -1,10 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerGithubTools } from "./tools.ts";
 
 const server = new McpServer(
   { name: "nimbus-github", version: "0.1.0" },
   {
+    capabilities: CONSENT_SERVER_CAPABILITIES,
     // Machine-readable security tiering, so a client can surface it rather than relying on a
     // human having read the NOTICE file.
     instructions:

package/connectors/github-actions/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerGithubActionsTools } from "./tools.ts";
 
-const mcp = new McpServer({ name: "nimbus-github-actions", version: "0.1.0" });
+const mcp = new McpServer(
+  { name: "nimbus-github-actions", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerGithubActionsTools(mcp);
 

package/connectors/gitlab/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerGitlabTools } from "./tools.ts";
 
-const server = new McpServer({ name: "nimbus-gitlab", version: "0.1.0" });
+const server = new McpServer(
+  { name: "nimbus-gitlab", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerGitlabTools(server);
 

package/connectors/gmail/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerGmailTools } from "./tools.ts";
 
-const server = new McpServer({ name: "nimbus-gmail", version: "0.1.0" });
+const server = new McpServer(
+  { name: "nimbus-gmail", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerGmailTools(server);
 

package/connectors/google-drive/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerGoogleDriveTools } from "./tools.ts";
 
-const server = new McpServer({ name: "nimbus-google-drive", version: "0.1.0" });
+const server = new McpServer(
+  { name: "nimbus-google-drive", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerGoogleDriveTools(server);
 

package/connectors/iac/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerIacTools } from "./tools.ts";
 
-const mcp = new McpServer({ name: "nimbus-iac", version: "0.1.0" });
+const mcp = new McpServer(
+  { name: "nimbus-iac", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerIacTools(mcp);
 

package/connectors/iac/src/tools.ts

@@ -1,5 +1,8 @@
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
 import { z } from "zod";
-import { awsCliArg, awsCliDocument, cliArg } from "../../../shared/cli-json-kit.ts";
+import { awsCliArg, cliArg } from "../../../shared/cli-json-kit.ts";
 import type { ConsentServer } from "../../../shared/consent-kit.ts";
 import { createWriteToolRegistrar } from "../../../shared/consent-kit.ts";
 import {
@@ -9,6 +12,49 @@ import {
 } from "../../../shared/mcp-tool-kit.ts";
 import { runCliOkThrowing } from "../../../shared/run-cli-json.ts";
 
+/**
+ * The most a template may be when it is deployed without an S3 bucket, which this tool does not
+ * take: `aws cloudformation deploy` refuses a larger one itself, and only after the prompt.
+ */
+const TEMPLATE_MAX_BYTES = 51_200;
+
+/**
+ * A CloudFormation template. It reaches the AWS CLI as a file, never as an argument (see
+ * {@link withTemplateFile}), so none of the argument rules apply to it: a YAML template may well
+ * start with `---`. Its size is refused here, in the schema, because no consent can lift it: a
+ * larger template would be put to the human, spend a unit of write budget, and then fail. The
+ * character bound is the one a client is shown; no string over it can be within the byte bound.
+ */
+const templateDocument = z
+  .string()
+  .min(1)
+  .max(TEMPLATE_MAX_BYTES)
+  .refine((t) => new TextEncoder().encode(t).length <= TEMPLATE_MAX_BYTES, {
+    message: `must be at most ${String(TEMPLATE_MAX_BYTES)} bytes as UTF-8, the most aws cloudformation deploy takes without an S3 bucket`,
+  });
+
+/**
+ * Run `body` with `template` written to a file of its own, removed afterwards however `body` ends.
+ *
+ * `aws cloudformation deploy` takes a template only as `--template-file`, and passing one as an
+ * argument would not work anyway: a template can run past the 32,767 characters a Windows command
+ * line holds, and an `aws` that is a batch file, as a pip-installed v1 is, has cmd.exe parse every
+ * quote in it.
+ */
+async function withTemplateFile<T>(
+  template: string,
+  body: (path: string) => Promise<T>,
+): Promise<T> {
+  const dir = await mkdtemp(join(tmpdir(), "nimbus-cfn-"));
+  try {
+    const path = join(dir, "template");
+    await writeFile(path, template, { encoding: "utf8", mode: 0o600, flag: "wx" });
+    return await body(path);
+  } finally {
+    await rm(dir, { recursive: true, force: true });
+  }
+}
+
 /** Tool names exposed by this connector — for contract/introspection tests. */
 export const IAC_TOOL_NAMES = [
   "iac_terraform_plan",
@@ -42,9 +88,12 @@ export function registerIacTools(
     "Run terraform plan in a directory.",
     z.object({ workingDirectory: cliArg }),
     async (p) => {
-      await runCliOkThrowing(["terraform", "-chdir", p.workingDirectory, "plan", "-input=false"], {
-        ...processEnv,
-      });
+      await runCliOkThrowing(
+        ["terraform", `-chdir=${p.workingDirectory}`, "plan", "-input=false"],
+        {
+          ...processEnv,
+        },
+      );
       return jsonResult({ ok: true });
     },
   );
@@ -60,7 +109,7 @@ export function registerIacTools(
     z.object({ workingDirectory: cliArg }),
     async (p) => {
       await runCliOkThrowing(
-        ["terraform", "-chdir", p.workingDirectory, "apply", "-auto-approve", "-input=false"],
+        ["terraform", `-chdir=${p.workingDirectory}`, "apply", "-auto-approve", "-input=false"],
         { ...processEnv },
       );
       return jsonResult({ ok: true });
@@ -82,7 +131,7 @@ export function registerIacTools(
     z.object({ workingDirectory: cliArg }),
     async (p) => {
       await runCliOkThrowing(
-        ["terraform", "-chdir", p.workingDirectory, "destroy", "-auto-approve", "-input=false"],
+        ["terraform", `-chdir=${p.workingDirectory}`, "destroy", "-auto-approve", "-input=false"],
         { ...processEnv },
       );
       return jsonResult({ ok: true });
@@ -99,22 +148,30 @@ export function registerIacTools(
     "Deploy a CloudFormation stack via AWS CLI.",
     z.object({
       stackName: awsCliArg,
-      templateBody: awsCliDocument,
+      templateBody: templateDocument,
     }),
     async (p) => {
-      await runCliOkThrowing(
-        [
-          "aws",
-          "cloudformation",
-          "deploy",
-          "--stack-name",
-          p.stackName,
-          "--template-body",
-          p.templateBody,
-          "--capabilities",
-          "CAPABILITY_IAM",
-        ],
-        { ...processEnv },
+      await withTemplateFile(p.templateBody, (templateFile) =>
+        runCliOkThrowing(
+          [
+            "aws",
+            "cloudformation",
+            "deploy",
+            "--stack-name",
+            p.stackName,
+            "--template-file",
+            templateFile,
+            "--capabilities",
+            "CAPABILITY_IAM",
+            // A deploy of a template that changes nothing has done what was asked, not failed.
+            "--no-fail-on-empty-changeset",
+          ],
+          // The file is UTF-8. Left to itself the CLI reads it in the locale's encoding, and on a
+          // Windows machine using cp1252 a template holding "Á" fails to decode while one holding
+          // "é" deploys as "é". AWS CLI v2 reads AWS_CLI_FILE_ENCODING and ignores PYTHONUTF8; v1,
+          // plain Python, reads PYTHONUTF8 and ignores the other. Both are set.
+          { ...processEnv, AWS_CLI_FILE_ENCODING: "UTF-8", PYTHONUTF8: "1" },
+        ),
       );
       return jsonResult({ ok: true });
     },

package/connectors/imap/src/server.ts

@@ -10,6 +10,7 @@
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { envInt } from "../../../shared/imap-tool-kit.ts";
 import { createImapFlowClient, createNodemailerMailer } from "../../../shared/imapflow-adapter.ts";
 import { requireProcessEnv } from "../../../shared/mcp-tool-kit.ts";
@@ -22,7 +23,10 @@ const SMTPS_PORT = 465;
 
 const smtpPort = envInt("IMAP_SMTP_PORT", DEFAULT_SMTP_PORT);
 
-const server = new McpServer({ name: "nimbus-imap", version: "0.1.0" });
+const server = new McpServer(
+  { name: "nimbus-imap", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerImapTools(
   server,

package/connectors/jenkins/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerJenkinsTools } from "./tools.ts";
 
-const mcp = new McpServer({ name: "nimbus-jenkins", version: "0.1.0" });
+const mcp = new McpServer(
+  { name: "nimbus-jenkins", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerJenkinsTools(mcp);
 

package/connectors/jira/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerJiraTools } from "./tools.ts";
 
-const server = new McpServer({ name: "nimbus-jira", version: "0.1.0" });
+const server = new McpServer(
+  { name: "nimbus-jira", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerJiraTools(server);
 

package/connectors/kubernetes/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerKubernetesTools } from "./tools.ts";
 
-const mcp = new McpServer({ name: "nimbus-kubernetes", version: "0.1.0" });
+const mcp = new McpServer(
+  { name: "nimbus-kubernetes", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerKubernetesTools(mcp);
 

package/connectors/linear/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerLinearTools } from "./tools.ts";
 
-const server = new McpServer({ name: "nimbus-linear", version: "0.1.0" });
+const server = new McpServer(
+  { name: "nimbus-linear", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerLinearTools(server);
 

package/connectors/notion/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerNotionTools } from "./tools.ts";
 
-const server = new McpServer({ name: "nimbus-notion", version: "0.1.0" });
+const server = new McpServer(
+  { name: "nimbus-notion", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerNotionTools(server);
 

package/connectors/obsidian/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerObsidianTools } from "./tools.ts";
 
-const server = new McpServer({ name: "nimbus-obsidian", version: "0.1.0" });
+const server = new McpServer(
+  { name: "nimbus-obsidian", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerObsidianTools(server);
 

package/connectors/onedrive/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerOnedriveTools } from "./tools.ts";
 
-const server = new McpServer({ name: "nimbus-onedrive", version: "0.1.0" });
+const server = new McpServer(
+  { name: "nimbus-onedrive", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerOnedriveTools(server);
 

package/connectors/outlook/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerOutlookTools } from "./tools.ts";
 
-const server = new McpServer({ name: "nimbus-outlook", version: "0.1.0" });
+const server = new McpServer(
+  { name: "nimbus-outlook", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerOutlookTools(server);
 

package/connectors/pagerduty/src/server.ts

@@ -1,8 +1,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { registerPagerdutyTools } from "./tools.ts";
 
-const mcp = new McpServer({ name: "nimbus-pagerduty", version: "0.1.0" });
+const mcp = new McpServer(
+  { name: "nimbus-pagerduty", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerPagerdutyTools(mcp);
 

package/connectors/protonmail/src/server.ts

@@ -9,6 +9,7 @@
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONSENT_SERVER_CAPABILITIES } from "../../../shared/consent-kit.ts";
 import { optionalEnv } from "../../../shared/env-json-api.ts";
 import { envInt } from "../../../shared/imap-tool-kit.ts";
 import { createImapFlowClient, createNodemailerMailer } from "../../../shared/imapflow-adapter.ts";
@@ -28,7 +29,10 @@ const DEFAULT_SMTP_PORT = 1025;
  */
 const BRIDGE_TLS = { secure: false, rejectUnauthorized: false } as const;
 
-const server = new McpServer({ name: "nimbus-protonmail", version: "0.1.0" });
+const server = new McpServer(
+  { name: "nimbus-protonmail", version: "0.1.0" },
+  { capabilities: CONSENT_SERVER_CAPABILITIES },
+);
 
 registerProtonmailTools(
   server,

package/connectors/readwise/nimbus.extension.json

@@ -1,7 +1,7 @@
 {
   "id": "com.nimbus.readwise",
   "displayName": "Readwise",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Readwise connector (read-only). Surfaces the user's saved book/article highlights as `readwise:highlight` items in the local index — the highlighted excerpt text, the user's note, the parent book/article id, the location + location type, the color, tags, and the source article URL (for web highlights) — plus their parent books/articles as `readwise:book` items (title, author, category, source, highlight count, document note, tags, ASIN, source + Readwise book-review URLs), so a highlight's `book_id` resolves to a real indexed record. Useful for answering reading questions (\"what did I highlight about retries?\", \"which book was that note in?\") without leaving Nimbus. Token API-token auth (`Authorization: Token <token>` — Django-REST-Framework token auth, NOT Bearer). The SaaS host (readwise.io) is fixed. Readwise paginates both `/api/v2/highlights/` and `/api/v2/books/` by page number (DRF `{ count, next, previous, results }` envelope, page_size=1000). `highlighted_at` / `last_highlight_at` / `updated` are ISO-8601 (converted to epoch-ms on index). Book `external_id`s are namespaced `book/<id>` because Readwise numbers books and highlights in separate sequences. Documents / daily-review and the Reader v3 API remain deferred follow-ups.",
   "author": "Nimbus",
   "entrypoint": "dist/server.js",
@@ -11,5 +11,13 @@
   },
   "hitlRequired": [],
   "syncInterval": 600,
+  "sync": {
+    "contract": "1",
+    "intervalSeconds": 600,
+    "itemTypes": ["highlight", "book"]
+  },
+  "credentials": {
+    "token": { "env": "READWISE_TOKEN" }
+  },
   "minNimbusVersion": "0.2.0"
 }