@rolino/cli 0.6.0 → 0.7.1

package/dist/bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCli
-} from "./chunk-3WBZCTM5.js";
+} from "./chunk-KSPZKKBG.js";
 
 // src/bin.ts
 void runCli().then(

package/dist/{chunk-3WBZCTM5.js → chunk-KSPZKKBG.js}

@@ -123,12 +123,18 @@ function removeExistingCodexEntry(source, newline) {
   return kept.join(newline).trimEnd();
 }
 function codexBlock(server, newline) {
+  const configuration = server.transport === "http" ? [
+    `url = ${tomlString(server.url)}`,
+    `auth = ${tomlString(server.auth)}`
+  ] : [
+    `command = ${tomlString(server.command)}`,
+    `args = [${server.args.map(tomlString).join(", ")}]`,
+    `env = { ROLINO_URL = ${tomlString(server.env.ROLINO_URL)} }`
+  ];
   return [
     CODEX_BEGIN,
     "[mcp_servers.rolino]",
-    `command = ${tomlString(server.command)}`,
-    `args = [${server.args.map(tomlString).join(", ")}]`,
-    `env = { ROLINO_URL = ${tomlString(server.env.ROLINO_URL)} }`,
+    ...configuration,
     CODEX_END
   ].join(newline);
 }
@@ -137,13 +143,12 @@ function updateCodexConfig(source, server) {
   const block = codexBlock(server, newline);
   const begin = source.indexOf(CODEX_BEGIN);
   const end = source.indexOf(CODEX_END);
-  if (begin === -1 !== (end === -1) || begin !== -1 && end < begin) {
-    throw new TypeError("Codex config contains an incomplete Rolino-managed block.");
-  }
   let unmanagedSource = source;
-  if (begin !== -1) {
+  if (begin !== -1 && end !== -1 && end > begin) {
     const after = end + CODEX_END.length;
     unmanagedSource = `${source.slice(0, begin)}${source.slice(after)}`;
+  } else if (begin !== -1 || end !== -1) {
+    unmanagedSource = source.split(/\r?\n/).filter((line) => line.trim() !== CODEX_BEGIN && line.trim() !== CODEX_END).join(newline);
   }
   const withoutRolino = removeExistingCodexEntry(unmanagedSource, newline);
   return `${withoutRolino ? `${withoutRolino}${newline}${newline}` : ""}${block}${newline}`;
@@ -168,7 +173,12 @@ function updateClaudeProjectConfig(source, server) {
     ...parsed,
     mcpServers: {
       ...currentServers,
-      rolino: { type: "stdio", ...server }
+      rolino: server.transport === "http" ? { type: "http", url: server.url } : {
+        type: "stdio",
+        command: server.command,
+        args: server.args,
+        env: server.env
+      }
     }
   }, null, 2)}
 `;
@@ -200,6 +210,7 @@ async function setupCodex(options, server) {
     backupPath,
     changed,
     dryRun: options.dryRun ?? false,
+    transport: server.transport,
     server
   };
 }
@@ -220,6 +231,7 @@ async function setupClaudeCode(options, server) {
       backupPath,
       changed,
       dryRun: options.dryRun ?? false,
+      transport: server.transport,
       server
     };
   }
@@ -232,6 +244,7 @@ async function setupClaudeCode(options, server) {
       backupPath: null,
       changed: true,
       dryRun: true,
+      transport: server.transport,
       server
     };
   }
@@ -245,7 +258,12 @@ async function setupClaudeCode(options, server) {
     "mcp",
     "add-json",
     "rolino",
-    JSON.stringify({ type: "stdio", ...server }),
+    JSON.stringify(server.transport === "http" ? { type: "http", url: server.url } : {
+      type: "stdio",
+      command: server.command,
+      args: server.args,
+      env: server.env
+    }),
     "--scope",
     "user"
   ], options);
@@ -261,14 +279,51 @@ async function setupClaudeCode(options, server) {
     backupPath: null,
     changed: true,
     dryRun: false,
+    transport: server.transport,
     server
   };
 }
+function remoteMcpUrl(baseUrl) {
+  return new URL("mcp", `${baseUrl.replace(/\/$/, "")}/`).toString();
+}
+async function advertisedRemoteMcp(options) {
+  const fetchImplementation = options.fetch ?? globalThis.fetch;
+  try {
+    const response = await fetchImplementation(
+      new URL("api/v1/meta", `${options.baseUrl.replace(/\/$/, "")}/`),
+      {
+        headers: { accept: "application/json" },
+        signal: AbortSignal.timeout(5e3)
+      }
+    );
+    if (!response.ok) return false;
+    const payload = await response.json();
+    return payload.data?.mcp?.streamableHttp === true;
+  } catch {
+    return false;
+  }
+}
+async function resolveTransport(options) {
+  const requested = options.transport ?? "stdio";
+  if (requested === "stdio") return "stdio";
+  if (await advertisedRemoteMcp(options)) return "http";
+  if (requested === "http") {
+    throw new TypeError(
+      "This Rolino instance does not advertise Streamable HTTP MCP. Use --transport stdio, or enable and verify remote MCP on the server."
+    );
+  }
+  return "stdio";
+}
 async function setupMcp(options) {
-  const serverPath = await resolveServerPath(options);
-  const server = {
+  const transport = await resolveTransport(options);
+  const server = transport === "http" ? {
+    transport: "http",
+    url: remoteMcpUrl(options.baseUrl),
+    auth: "oauth"
+  } : {
+    transport: "stdio",
     command: options.nodePath,
-    args: [serverPath],
+    args: [await resolveServerPath(options)],
     env: { ROLINO_URL: options.baseUrl }
   };
   return options.client === "codex" ? setupCodex(options, server) : setupClaudeCode(options, server);
@@ -285,7 +340,7 @@ import { Command, CommanderError, InvalidArgumentError } from "commander";
 // package.json
 var package_default = {
   name: "@rolino/cli",
-  version: "0.6.0",
+  version: "0.7.1",
   description: "Agent-friendly command-line interface for Rolino",
   type: "module",
   license: "MIT",
@@ -342,9 +397,9 @@ var package_default = {
     dev: "tsx src/bin.ts"
   },
   dependencies: {
-    "@rolino/contracts": "0.6.0",
-    "@rolino/local-auth": "0.6.0",
-    "@rolino/sdk": "0.6.0",
+    "@rolino/contracts": "0.7.1",
+    "@rolino/local-auth": "0.7.1",
+    "@rolino/sdk": "0.7.1",
     commander: "^15.0.0",
     open: "^11.0.0"
   },
@@ -360,6 +415,7 @@ var package_default = {
 import {
   PostStatusSchema,
   AgentBlogDraftUpdateSchema,
+  BacklinkProspectStageSchema,
   ProjectCreateInputSchema,
   ProjectTypeSchema,
   ProviderDeliveryOptionsProviderSchema,
@@ -381,6 +437,7 @@ import {
 // src/browser-login.ts
 import { createHash, randomBytes, timingSafeEqual } from "crypto";
 import { createServer } from "http";
+import { AGENT_CAPABILITIES } from "@rolino/contracts";
 import {
   oauthConfiguration
 } from "@rolino/local-auth";
@@ -388,13 +445,9 @@ import open from "open";
 var OAUTH_CALLBACK_PORT = 48391;
 var OAUTH_CALLBACK_PATH = "/oauth/callback";
 var OAUTH_TIMEOUT_MS = 5 * 60 * 1e3;
-var DEFAULT_SCOPES = [
+var AUTHORIZATION_REQUEST_SCOPES = [
   "offline_access",
-  "identity:read",
-  "projects:read",
-  "posts:read",
-  "integrations:read",
-  "calendar:read"
+  ...AGENT_CAPABILITIES
 ];
 function escapeHtml(value) {
   return value.replace(/[&<>"']/g, (character) => ({
@@ -434,7 +487,7 @@ function createBrowserAuthorizationRequest(baseUrl) {
   url.searchParams.set("response_type", "code");
   url.searchParams.set("client_id", configuration.clientId);
   url.searchParams.set("redirect_uri", redirectUri);
-  url.searchParams.set("scope", DEFAULT_SCOPES.join(" "));
+  url.searchParams.set("scope", AUTHORIZATION_REQUEST_SCOPES.join(" "));
   url.searchParams.set("resource", configuration.resource);
   url.searchParams.set("state", state);
   url.searchParams.set("code_challenge", codeChallenge);
@@ -473,7 +526,7 @@ async function exchangeAuthorizationCode(options) {
     accessTokenExpiresAt: new Date(Date.now() + expiresIn * 1e3).toISOString(),
     refreshToken: payload.refresh_token,
     refreshTokenExpiresAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1e3).toISOString(),
-    scopes: typeof payload.scope === "string" ? payload.scope.split(/\s+/).filter(Boolean) : [...DEFAULT_SCOPES]
+    scopes: typeof payload.scope === "string" ? payload.scope.split(/\s+/).filter(Boolean) : [...AUTHORIZATION_REQUEST_SCOPES]
   };
 }
 async function loginWithBrowser(options) {
@@ -943,6 +996,10 @@ function mcpScope(value) {
   if (value === "user" || value === "project") return value;
   throw new InvalidArgumentError("MCP setup scope must be user or project.");
 }
+function mcpTransport(value) {
+  if (value === "auto" || value === "http" || value === "stdio") return value;
+  throw new InvalidArgumentError("MCP transport must be auto, http, or stdio.");
+}
 function isoDateTime(value) {
   const date = new Date(value);
   if (Number.isNaN(date.getTime())) {
@@ -1003,13 +1060,21 @@ function requireBlogExecutionConsent(options) {
   throw new TypeError("This Blog execute command requires explicit consent. Review the confirmed operation and pass --yes.");
 }
 function formatMcpSetupPreview(result) {
+  const connection = result.server.transport === "http" ? [
+    `Transport: Streamable HTTP`,
+    `Endpoint: ${result.server.url}`,
+    "Authentication: OAuth in the MCP client"
+  ] : [
+    "Transport: local STDIO",
+    `Command: ${result.server.command}`,
+    `Arguments: ${result.server.args.join(" ")}`,
+    `Rolino URL: ${result.server.env.ROLINO_URL}`
+  ];
   return [
     `Client: ${result.client === "codex" ? "Codex" : "Claude Code"}`,
     `Scope: ${result.scope}`,
     `Target: ${result.target}`,
-    `Command: ${result.server.command}`,
-    `Arguments: ${result.server.args.join(" ")}`,
-    `Rolino URL: ${result.server.env.ROLINO_URL}`,
+    ...connection,
     "No token will be written to MCP configuration."
   ].join("\n");
 }
@@ -1472,7 +1537,7 @@ async function runCli(argv = process.argv, overrides = {}) {
     });
   });
   const setup = program.command("setup").description("Configure local agent tools for Rolino");
-  setup.command("mcp").description("Configure the Rolino stdio MCP server for a supported client").requiredOption("--client <client>", "codex or claude-code", mcpClient).option("--scope <scope>", "user or project", mcpScope, "user").option("--server-path <path>", "absolute or working-directory-relative MCP server path").option("--dry-run", "show the intended configuration without writing it").option("--yes", "apply without an interactive confirmation").option("--force", "replace an existing Claude Code user-scoped Rolino server").action(async (local) => {
+  setup.command("mcp").description("Configure Rolino MCP with Streamable HTTP or local STDIO").requiredOption("--client <client>", "codex or claude-code", mcpClient).option("--scope <scope>", "user or project", mcpScope, "user").option("--transport <transport>", "auto, http, or stdio", mcpTransport, "auto").option("--server-path <path>", "absolute or working-directory-relative MCP server path").option("--dry-run", "show the intended configuration without writing it").option("--yes", "apply without an interactive confirmation").option("--force", "replace an existing Claude Code user-scoped Rolino server").action(async (local) => {
     const global = program.opts();
     commandExitCode = await execute({
       command: "setup mcp",
@@ -1485,7 +1550,8 @@ async function runCli(argv = process.argv, overrides = {}) {
           cwd: runtime.cwd,
           env: runtime.env,
           nodePath: runtime.nodePath,
-          cliEntryPath: runtime.cliEntryPath
+          cliEntryPath: runtime.cliEntryPath,
+          fetch: runtime.fetch
         };
         const preview = await setupMcp({ ...setupOptions, dryRun: true });
         let result = preview;
@@ -1512,11 +1578,12 @@ async function runCli(argv = process.argv, overrides = {}) {
             `${state} Rolino MCP for ${clientLabel}.`,
             `Scope: ${result.scope}`,
             `Target: ${result.target}`,
+            `Transport: ${result.transport === "http" ? "Streamable HTTP" : "local STDIO"}`,
             ...result.backupPath && !result.dryRun ? [`Backup: ${result.backupPath}`] : [],
             `Rolino URL: ${client.baseUrl}`,
             "No token was written to MCP configuration."
           ].join("\n"),
-          result.client === "codex" ? ["codex mcp list", "rolino auth login"] : ["claude mcp get rolino", "rolino auth login"]
+          result.client === "codex" ? result.transport === "http" ? ["codex mcp login rolino", "codex mcp list"] : ["rolino auth login", "codex mcp list"] : result.transport === "http" ? ["claude mcp get rolino", "Complete OAuth when Claude prompts you"] : ["rolino auth login", "claude mcp get rolino"]
         );
       }
     });
@@ -2255,6 +2322,106 @@ Revision: ${local.revision}` });
       writeSuccess(context, data, JSON.stringify(data, null, 2));
     } });
   });
+  const backlinks = program.command("backlinks").description("Review backlink prospects and public contact drafts. Rolino never sends email.");
+  const backlinkTargets = backlinks.command("targets");
+  backlinkTargets.command("list").requiredOption("--project <project-id>").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks targets list", global, runtime, async action(context, client) {
+      const data = await client.backlinks.targets.list(local.project, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  backlinkTargets.command("add").requiredOption("--project <project-id>").requiredOption("--url <url>").requiredOption("--label <label>").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks targets add", global, runtime, async action(context, client) {
+      const data = await client.backlinks.targets.add(local.project, { url: local.url, label: local.label }, context.requestId, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  backlinks.command("discover").requiredOption("--project <project-id>").option("--limit <number>", "maximum saved prospects", Number, 20).option("--idempotency-key <key>").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks discover", global, runtime, async action(context, client) {
+      const data = await client.backlinks.discoveries.start(local.project, { limit: local.limit }, local.idempotencyKey ?? context.requestId, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  const backlinkRuns = backlinks.command("runs");
+  backlinkRuns.command("get").requiredOption("--project <project-id>").requiredOption("--run <run-id>").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks runs get", global, runtime, async action(context, client) {
+      const data = await client.backlinks.discoveries.get(local.project, local.run, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  const backlinkProspects = backlinks.command("prospects");
+  backlinkProspects.command("list").requiredOption("--project <project-id>").option("--stage <stage>").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks prospects list", global, runtime, async action(context, client) {
+      const stage = local.stage ? BacklinkProspectStageSchema.parse(local.stage.toUpperCase()) : void 0;
+      const data = await client.backlinks.prospects.list(local.project, { stage }, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  backlinkProspects.command("get").requiredOption("--project <project-id>").requiredOption("--prospect <prospect-id>").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks prospects get", global, runtime, async action(context, client) {
+      const data = await client.backlinks.prospects.get(local.project, local.prospect, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  backlinkProspects.command("approve").requiredOption("--project <project-id>").requiredOption("--prospect <prospect-id>").requiredOption("--expected-version <number>", "current optimistic version", Number).action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks prospects approve", global, runtime, async action(context, client) {
+      const data = await client.backlinks.prospects.updateStage(local.project, local.prospect, { stage: "APPROVED", expectedVersion: local.expectedVersion }, context.requestId, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  const backlinkContacts = backlinks.command("contacts");
+  backlinkContacts.command("research").requiredOption("--project <project-id>").requiredOption("--prospect <prospect-id>").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks contacts research", global, runtime, async action(context, client) {
+      const data = await client.backlinks.prospects.researchContact(local.project, local.prospect, context.requestId, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  backlinkContacts.command("list").requiredOption("--project <project-id>").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks contacts list", global, runtime, async action(context, client) {
+      const data = await client.backlinks.contacts.list(local.project, { limit: 50 }, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  backlinkContacts.command("export").requiredOption("--project <project-id>").option("--format <format>", "json or csv", "csv").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks contacts export", global, runtime, async action(context, client) {
+      const data = await client.backlinks.contacts.list(local.project, { limit: 50 }, { requestId: context.requestId });
+      if (local.format !== "csv") return writeSuccess(context, data, JSON.stringify(data, null, 2));
+      const cell = (value) => {
+        let text = String(value ?? "").replace(/[\r\n]+/g, " ");
+        if (/^[=+\-@\t]/.test(text)) text = `'${text}`;
+        return `"${text.replaceAll('"', '""')}"`;
+      };
+      const csv = ["prospectId,name,role,email,sourceUrl,checkedAt", ...data.items.map((item) => [item.prospectId, item.name, item.role, item.email, item.sourceUrl, item.checkedAt].map(cell).join(","))].join("\n");
+      context.stdout.write(`${csv}
+`);
+    } });
+  });
+  const backlinkOutreach = backlinks.command("outreach");
+  backlinkOutreach.command("update").requiredOption("--project <project-id>").requiredOption("--prospect <prospect-id>").requiredOption("--file <file>").requiredOption("--expected-version <number>", "current draft version", Number).action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks outreach update", global, runtime, async action(context, client) {
+      const payload = JSON.parse(await readFile2(resolve2(runtime.cwd, local.file), "utf8"));
+      const data = await client.backlinks.prospects.updateOutreach(local.project, local.prospect, { ...payload, expectedVersion: local.expectedVersion }, context.requestId, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  backlinks.command("verify").requiredOption("--project <project-id>").requiredOption("--prospect <prospect-id>").requiredOption("--url <url>").requiredOption("--expected-version <number>", "current prospect version", Number).action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks verify", global, runtime, async action(context, client) {
+      const data = await client.backlinks.prospects.verify(local.project, local.prospect, { url: local.url, expectedVersion: local.expectedVersion }, context.requestId, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
   const seo = program.command("seo").description("Read authorized SEO opportunities and weekly reports");
   const seoOpportunities = seo.command("opportunities").description("Read accepted SEO opportunities");
   seoOpportunities.command("list").description("List bounded SEO opportunities").requiredOption("--project <project-id>", "exact Rolino project ID").option("--limit <number>", "maximum opportunities to return", (value) => {
@@ -2420,4 +2587,4 @@ export {
   ROLINO_CLI_VERSION,
   runCli
 };
-//# sourceMappingURL=chunk-3WBZCTM5.js.map
+//# sourceMappingURL=chunk-KSPZKKBG.js.map