@vellumai/assistant 0.8.3 → 0.8.4

package/src/daemon/first-greeting.ts

@@ -102,6 +102,16 @@ function resolveTone(raw?: string): Tone {
   return raw && VALID_TONES.has(raw) ? (raw as Tone) : "grounded";
 }
 
+export function buildScanFirstMessage(
+  url: string,
+  variant: "website" | "content-source",
+): string {
+  if (variant === "content-source") {
+    return `Here's a page with content I'd like you to look at: ${url}`;
+  }
+  return `Here's my website: ${url}`;
+}
+
 function buildPersonalizedGreeting(ctx: OnboardingGreetingContext): string {
   const name = ctx.userName?.trim();
   const assistant = ctx.assistantName?.trim();

package/src/daemon/handlers/__tests__/config-a2a-accept.test.ts

@@ -0,0 +1,498 @@
+/**
+ * Tests for the self-hosted A2A invite accept broker (acceptA2AInvite).
+ *
+ * Uses the real DB (via `initializeDb()`) and the test preload which sets
+ * `VELLUM_WORKSPACE_DIR` to a per-file temp directory. Global `fetch` is
+ * mocked to simulate the outbound call to the sender's gateway.
+ */
+
+import { afterEach, beforeEach, describe, expect, mock, test } from "bun:test";
+
+mock.module("../../../util/logger.js", () => ({
+  getLogger: () =>
+    new Proxy({} as Record<string, unknown>, {
+      get: () => () => {},
+    }),
+}));
+
+import {
+  invalidateConfigCache,
+  loadRawConfig,
+  saveRawConfig,
+  setNestedValue,
+} from "../../../config/loader.js";
+import {
+  getAssistantContactMetadata,
+  getContact,
+  searchContacts,
+} from "../../../contacts/contact-store.js";
+import { getSqlite } from "../../../memory/db-connection.js";
+import { initializeDb } from "../../../memory/db-init.js";
+import { acceptA2AInvite, createA2AInvite } from "../config-a2a.js";
+
+initializeDb();
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function resetTables(): void {
+  const sqlite = getSqlite();
+  sqlite.run("DELETE FROM assistant_ingress_invites");
+  sqlite.run("DELETE FROM assistant_contact_metadata");
+  sqlite.run("DELETE FROM contact_channels");
+  sqlite.run("DELETE FROM contacts");
+}
+
+function setConfig(opts: {
+  a2aEnabled?: boolean;
+  publicBaseUrl?: string;
+  ingressEnabled?: boolean;
+  assistantName?: string;
+}): void {
+  const raw = loadRawConfig();
+  if (opts.a2aEnabled !== undefined) {
+    setNestedValue(raw, "a2a.enabled", opts.a2aEnabled);
+  }
+  if (opts.publicBaseUrl !== undefined) {
+    setNestedValue(raw, "ingress.publicBaseUrl", opts.publicBaseUrl);
+  }
+  if (opts.ingressEnabled !== undefined) {
+    setNestedValue(raw, "ingress.enabled", opts.ingressEnabled);
+  }
+  saveRawConfig(raw);
+  invalidateConfigCache();
+}
+
+const SENDER_GATEWAY_URL = "https://sender.example.com";
+const SENDER_ASSISTANT_ID = "sender-assistant-abc";
+const RECEIVER_GATEWAY_URL = "https://receiver.example.com";
+
+interface MockFetchOptions {
+  status?: number;
+  body?: Record<string, unknown>;
+  networkError?: string;
+}
+
+function mockFetchOnce(opts: MockFetchOptions): void {
+  const originalFetch = globalThis.fetch;
+  const mockFn = mock(
+    async (_input: RequestInfo | URL, _init?: RequestInit) => {
+      // Restore after first call
+      globalThis.fetch = originalFetch;
+
+      if (opts.networkError) {
+        throw new Error(opts.networkError);
+      }
+      return new Response(JSON.stringify(opts.body ?? {}), {
+        status: opts.status ?? 200,
+        headers: { "Content-Type": "application/json" },
+      });
+    },
+  );
+  globalThis.fetch = mockFn as unknown as typeof fetch;
+}
+
+/** Track the outbound fetch call and return a mock response. */
+function mockFetchCapture(opts: MockFetchOptions): {
+  getCall: () => { url: string; body: Record<string, unknown> } | null;
+} {
+  const originalFetch = globalThis.fetch;
+  let captured: { url: string; body: Record<string, unknown> } | null = null;
+  const mockFn = mock(async (input: RequestInfo | URL, init?: RequestInit) => {
+    globalThis.fetch = originalFetch;
+    captured = {
+      url: String(input),
+      body: JSON.parse((init?.body as string) ?? "{}") as Record<
+        string,
+        unknown
+      >,
+    };
+    if (opts.networkError) {
+      throw new Error(opts.networkError);
+    }
+    return new Response(JSON.stringify(opts.body ?? {}), {
+      status: opts.status ?? 200,
+      headers: { "Content-Type": "application/json" },
+    });
+  });
+  globalThis.fetch = mockFn as unknown as typeof fetch;
+  return { getCall: () => captured };
+}
+
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+
+describe("acceptA2AInvite", () => {
+  let savedFetch: typeof globalThis.fetch;
+
+  beforeEach(() => {
+    savedFetch = globalThis.fetch;
+    resetTables();
+    setConfig({
+      a2aEnabled: true,
+      publicBaseUrl: RECEIVER_GATEWAY_URL,
+      ingressEnabled: true,
+    });
+  });
+
+  afterEach(() => {
+    globalThis.fetch = savedFetch;
+  });
+
+  // ── Happy path ──────────────────────────────────────────────────────
+
+  test("happy path: creates local contact from sender identity", async () => {
+    // Create an invite on the sender side so we have a valid token
+    const created = createA2AInvite({});
+    expect(created.success).toBe(true);
+
+    mockFetchOnce({
+      body: {
+        success: true,
+        sender: {
+          assistantId: SENDER_ASSISTANT_ID,
+          displayName: "Sender Bot",
+          gatewayUrl: SENDER_GATEWAY_URL,
+        },
+      },
+    });
+
+    const result = await acceptA2AInvite({
+      senderGatewayUrl: SENDER_GATEWAY_URL,
+      senderAssistantId: SENDER_ASSISTANT_ID,
+      token: "any-token",
+    });
+
+    expect(result.success).toBe(true);
+    expect(result.contactId).toBeDefined();
+    expect(result.alreadyConnected).toBeFalsy();
+
+    // Verify the contact was created with correct identity
+    const contact = getContact(result.contactId!);
+    expect(contact).not.toBeNull();
+    expect(contact!.channels).toHaveLength(1);
+    expect(contact!.channels[0]!.type).toBe("a2a");
+    expect(contact!.channels[0]!.status).toBe("active");
+
+    // Verify assistant metadata
+    const metadata = getAssistantContactMetadata(result.contactId!);
+    expect(metadata).not.toBeNull();
+    expect(metadata!.metadata).toEqual({
+      assistantId: SENDER_ASSISTANT_ID,
+      gatewayUrl: SENDER_GATEWAY_URL,
+    });
+  });
+
+  test("uses invite-link values for sender identity, not daemon response", async () => {
+    const maliciousGateway = "https://evil.example.com";
+    const maliciousId = "evil-assistant";
+
+    mockFetchOnce({
+      body: {
+        success: true,
+        sender: {
+          // Sender daemon tries to misrepresent identity
+          assistantId: maliciousId,
+          displayName: "Legit Bot",
+          gatewayUrl: maliciousGateway,
+        },
+      },
+    });
+
+    const result = await acceptA2AInvite({
+      senderGatewayUrl: SENDER_GATEWAY_URL,
+      senderAssistantId: SENDER_ASSISTANT_ID,
+      token: "any-token",
+    });
+
+    expect(result.success).toBe(true);
+
+    // Verify contact uses invite-link values, NOT the daemon response
+    const metadata = getAssistantContactMetadata(result.contactId!);
+    expect(metadata!.metadata).toEqual({
+      assistantId: SENDER_ASSISTANT_ID,
+      gatewayUrl: SENDER_GATEWAY_URL,
+    });
+  });
+
+  test("uses sender displayName from complete response", async () => {
+    mockFetchOnce({
+      body: {
+        success: true,
+        sender: {
+          assistantId: SENDER_ASSISTANT_ID,
+          displayName: "My Cool Bot",
+          gatewayUrl: SENDER_GATEWAY_URL,
+        },
+      },
+    });
+
+    const result = await acceptA2AInvite({
+      senderGatewayUrl: SENDER_GATEWAY_URL,
+      senderAssistantId: SENDER_ASSISTANT_ID,
+      token: "any-token",
+    });
+
+    expect(result.success).toBe(true);
+    const contact = getContact(result.contactId!);
+    expect(contact!.displayName).toBe("My Cool Bot");
+  });
+
+  test("falls back to senderAssistantId when displayName is missing", async () => {
+    mockFetchOnce({
+      body: {
+        success: true,
+        sender: {
+          assistantId: SENDER_ASSISTANT_ID,
+          // No displayName
+          gatewayUrl: SENDER_GATEWAY_URL,
+        },
+      },
+    });
+
+    const result = await acceptA2AInvite({
+      senderGatewayUrl: SENDER_GATEWAY_URL,
+      senderAssistantId: SENDER_ASSISTANT_ID,
+      token: "any-token",
+    });
+
+    expect(result.success).toBe(true);
+    const contact = getContact(result.contactId!);
+    expect(contact!.displayName).toBe(SENDER_ASSISTANT_ID);
+  });
+
+  test("sends correct request to sender's invite/complete endpoint", async () => {
+    const capture = mockFetchCapture({
+      body: {
+        success: true,
+        sender: {
+          assistantId: SENDER_ASSISTANT_ID,
+          displayName: "Sender Bot",
+          gatewayUrl: SENDER_GATEWAY_URL,
+        },
+      },
+    });
+
+    await acceptA2AInvite({
+      senderGatewayUrl: SENDER_GATEWAY_URL,
+      senderAssistantId: SENDER_ASSISTANT_ID,
+      token: "test-token-123",
+    });
+
+    const call = capture.getCall();
+    expect(call).not.toBeNull();
+    expect(call!.url).toBe(
+      `${SENDER_GATEWAY_URL}/v1/integrations/a2a/invite/complete`,
+    );
+    expect(call!.body).toEqual({
+      token: "test-token-123",
+      senderAssistantId: SENDER_ASSISTANT_ID,
+      acceptor: {
+        assistantId: RECEIVER_GATEWAY_URL,
+        displayName: "Vellum Assistant",
+        gatewayUrl: RECEIVER_GATEWAY_URL,
+      },
+    });
+  });
+
+  test("strips trailing slashes from senderGatewayUrl in fetch URL and stored metadata", async () => {
+    const capture = mockFetchCapture({
+      body: {
+        success: true,
+        sender: {
+          assistantId: SENDER_ASSISTANT_ID,
+          displayName: "Bot",
+          gatewayUrl: SENDER_GATEWAY_URL,
+        },
+      },
+    });
+
+    const result = await acceptA2AInvite({
+      senderGatewayUrl: `${SENDER_GATEWAY_URL}///`,
+      senderAssistantId: SENDER_ASSISTANT_ID,
+      token: "test-token",
+    });
+
+    // Fetch URL is normalized
+    const call = capture.getCall();
+    expect(call!.url).toBe(
+      `${SENDER_GATEWAY_URL}/v1/integrations/a2a/invite/complete`,
+    );
+
+    // Stored contact metadata is also normalized (no trailing slashes)
+    expect(result.success).toBe(true);
+    const contact = getContact(result.contactId!);
+    expect(contact).toBeTruthy();
+    const meta = getAssistantContactMetadata(result.contactId!);
+    expect((meta?.metadata as { gatewayUrl?: string } | null)?.gatewayUrl).toBe(
+      SENDER_GATEWAY_URL,
+    );
+  });
+
+  // ── Already connected ───────────────────────────────────────────────
+
+  test("returns alreadyConnected without calling sender when already a contact", async () => {
+    // First accept — creates the contact
+    mockFetchOnce({
+      body: {
+        success: true,
+        sender: {
+          assistantId: SENDER_ASSISTANT_ID,
+          displayName: "Sender Bot",
+          gatewayUrl: SENDER_GATEWAY_URL,
+        },
+      },
+    });
+    const first = await acceptA2AInvite({
+      senderGatewayUrl: SENDER_GATEWAY_URL,
+      senderAssistantId: SENDER_ASSISTANT_ID,
+      token: "token-1",
+    });
+    expect(first.success).toBe(true);
+
+    // Second accept — should short-circuit before any outbound call.
+    // No mockFetchOnce here: if fetch is called, it hits the real
+    // (unmocked) fetch and the test would fail or hang.
+    const second = await acceptA2AInvite({
+      senderGatewayUrl: SENDER_GATEWAY_URL,
+      senderAssistantId: SENDER_ASSISTANT_ID,
+      token: "token-2",
+    });
+    expect(second.success).toBe(true);
+    expect(second.alreadyConnected).toBe(true);
+  });
+
+  // ── Sender unreachable ──────────────────────────────────────────────
+
+  test("returns sender_unreachable when fetch throws", async () => {
+    mockFetchOnce({ networkError: "Connection refused" });
+
+    const result = await acceptA2AInvite({
+      senderGatewayUrl: SENDER_GATEWAY_URL,
+      senderAssistantId: SENDER_ASSISTANT_ID,
+      token: "any-token",
+    });
+
+    expect(result.success).toBe(false);
+    expect(result.errorCode).toBe("sender_unreachable");
+    expect(result.error).toContain("Connection refused");
+  });
+
+  // ── Sender returns error ────────────────────────────────────────────
+  // The daemon HTTP adapter always converts RouteError throws into the
+  // standard envelope: { error: { code, message } } (see http-errors.ts).
+  // These mocks match the real wire format.
+
+  test("returns complete_failed when sender returns 400 with token error", async () => {
+    mockFetchOnce({
+      status: 400,
+      body: {
+        error: {
+          code: "BAD_REQUEST",
+          message: "Invite token has expired or was already claimed",
+        },
+      },
+    });
+
+    const result = await acceptA2AInvite({
+      senderGatewayUrl: SENDER_GATEWAY_URL,
+      senderAssistantId: SENDER_ASSISTANT_ID,
+      token: "expired-token",
+    });
+
+    expect(result.success).toBe(false);
+    expect(result.error).toBe(
+      "Invite token has expired or was already claimed",
+    );
+    expect(result.errorCode).toBe("complete_failed");
+  });
+
+  test("returns complete_failed when sender returns 400 for validation", async () => {
+    mockFetchOnce({
+      status: 400,
+      body: {
+        error: {
+          code: "BAD_REQUEST",
+          message:
+            "acceptor must include non-empty assistantId, displayName, and gatewayUrl",
+        },
+      },
+    });
+
+    const result = await acceptA2AInvite({
+      senderGatewayUrl: SENDER_GATEWAY_URL,
+      senderAssistantId: SENDER_ASSISTANT_ID,
+      token: "any-token",
+    });
+
+    expect(result.success).toBe(false);
+    expect(result.error).toContain("acceptor must include");
+    expect(result.errorCode).toBe("complete_failed");
+  });
+
+  test("falls back to generic message when error envelope is malformed", async () => {
+    mockFetchOnce({
+      status: 500,
+      body: { unexpected: "shape" },
+    });
+
+    const result = await acceptA2AInvite({
+      senderGatewayUrl: SENDER_GATEWAY_URL,
+      senderAssistantId: SENDER_ASSISTANT_ID,
+      token: "any-token",
+    });
+
+    expect(result.success).toBe(false);
+    expect(result.error).toBe("Invite completion failed");
+    expect(result.errorCode).toBe("complete_failed");
+  });
+
+  // ── No public base URL ──────────────────────────────────────────────
+
+  test("returns no_public_url when publicBaseUrl is not configured", async () => {
+    setConfig({ publicBaseUrl: "", ingressEnabled: true });
+
+    const result = await acceptA2AInvite({
+      senderGatewayUrl: SENDER_GATEWAY_URL,
+      senderAssistantId: SENDER_ASSISTANT_ID,
+      token: "any-token",
+    });
+
+    expect(result.success).toBe(false);
+    expect(result.errorCode).toBe("no_public_url");
+    expect(result.error).toContain("public base URL");
+  });
+
+  test("returns no_public_url when ingress is disabled", async () => {
+    setConfig({ ingressEnabled: false });
+
+    const result = await acceptA2AInvite({
+      senderGatewayUrl: SENDER_GATEWAY_URL,
+      senderAssistantId: SENDER_ASSISTANT_ID,
+      token: "any-token",
+    });
+
+    expect(result.success).toBe(false);
+    expect(result.errorCode).toBe("no_public_url");
+  });
+
+  // ── No existing contacts leaked ─────────────────────────────────────
+
+  test("does not create a contact when sender returns failure", async () => {
+    mockFetchOnce({
+      status: 400,
+      body: { error: { code: "BAD_REQUEST", message: "Invalid token" } },
+    });
+
+    await acceptA2AInvite({
+      senderGatewayUrl: SENDER_GATEWAY_URL,
+      senderAssistantId: SENDER_ASSISTANT_ID,
+      token: "bad-token",
+    });
+
+    const contacts = searchContacts({ channelType: "a2a" });
+    expect(contacts).toHaveLength(0);
+  });
+});

package/src/daemon/handlers/config-a2a.ts

@@ -5,7 +5,9 @@
  * - setA2AConfig()     — set a2a.enabled = true
  * - clearA2AConfig()   — set a2a.enabled = false
  * - createA2AInvite()  — create a shareable invite token for link-based contact creation
+ * - completeA2AInvite() — sender-side: claim token and return sender identity
  * - redeemA2AInvite()  — receiver-side: create trusted contact from sender identity
+ * - acceptA2AInvite()  — self-hosted broker: orchestrate complete + redeem across daemons
  */
 
 import {
@@ -29,7 +31,11 @@ import {
   hashToken,
 } from "../../memory/invite-store.js";
 import { assistantContactMetadata } from "../../memory/schema.js";
+import type { HttpErrorResponse } from "../../runtime/http-errors.js";
+import { getLogger } from "../../util/logger.js";
 import { getAssistantName } from "../identity-helpers.js";
+const log = getLogger("config-a2a");
+
 // ── Result types ────────────────────────────────────────────────────
 
 export interface A2AConfigResult {
@@ -61,6 +67,14 @@ export interface RedeemA2AInviteResult {
   error?: string;
 }
 
+export interface AcceptA2AInviteResult {
+  success: boolean;
+  contactId?: string;
+  alreadyConnected?: boolean;
+  error?: string;
+  errorCode?: string;
+}
+
 // ── Config operations ───────────────────────────────────────────────
 
 export function getA2AConfig(): A2AConfigResult {
@@ -287,3 +301,149 @@ export function redeemA2AInvite(params: {
 
   return { success: true, contactId: contact.id };
 }
+
+// ── Self-hosted broker ──────────────────────────────────────────────
+
+const ACCEPT_TIMEOUT_MS = 15_000;
+
+/**
+ * Extract a human-readable error message from a daemon HTTP error
+ * response. The daemon always returns `{ error: { code, message } }`
+ * (see `HttpErrorResponse` in `runtime/http-errors.ts`).
+ */
+function extractDaemonErrorMessage(
+  body: Record<string, unknown>,
+): string | undefined {
+  const envelope = body as Partial<HttpErrorResponse>;
+  if (
+    typeof envelope.error === "object" &&
+    envelope.error !== null &&
+    typeof envelope.error.message === "string"
+  ) {
+    return envelope.error.message;
+  }
+  return undefined;
+}
+
+/**
+ * Orchestrate cross-daemon A2A invite acceptance for self-hosted
+ * deployments. Calls the sender's `invite/complete` endpoint, then
+ * creates a local contact via `redeemA2AInvite`.
+ *
+ * Trust model: the user explicitly chose to connect to `senderGatewayUrl`
+ * and provided a token from the sender's invite link. We trust the
+ * invite-link values (`senderAssistantId`, `senderGatewayUrl`) as the
+ * canonical sender identity, and only use the `complete` response for the
+ * sender's display name (which has no other source in self-hosted mode).
+ */
+export async function acceptA2AInvite(params: {
+  senderGatewayUrl: string;
+  senderAssistantId: string;
+  token: string;
+}): Promise<AcceptA2AInviteResult> {
+  const senderGatewayUrl = params.senderGatewayUrl.replace(/\/+$/, "");
+
+  // 1. Validate local config
+  const displayName = getAssistantName() ?? "Vellum Assistant";
+  let localGatewayUrl: string;
+  try {
+    localGatewayUrl = getPublicBaseUrl(getConfig());
+  } catch {
+    return {
+      success: false,
+      error:
+        "No public base URL configured. Set ingress.publicBaseUrl in config.",
+      errorCode: "no_public_url",
+    };
+  }
+
+  // 2. Short-circuit if already connected — avoids a network round-trip
+  //    and consuming a token on the sender side.
+  const existing = findContactByAddress("a2a", params.senderAssistantId);
+  if (
+    existing &&
+    existing.channels.some((ch) => ch.type === "a2a" && ch.status === "active")
+  ) {
+    return { success: true, alreadyConnected: true, contactId: existing.id };
+  }
+
+  // 3. Call the sender's invite/complete endpoint
+  const completeUrl = `${senderGatewayUrl}/v1/integrations/a2a/invite/complete`;
+  const completeBody = {
+    token: params.token,
+    senderAssistantId: params.senderAssistantId,
+    acceptor: {
+      assistantId: localGatewayUrl,
+      displayName,
+      gatewayUrl: localGatewayUrl,
+    },
+  };
+
+  let completeData: Record<string, unknown>;
+  try {
+    const response = await fetch(completeUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(completeBody),
+      signal: AbortSignal.timeout(ACCEPT_TIMEOUT_MS),
+    });
+
+    completeData = (await response.json()) as Record<string, unknown>;
+
+    if (!response.ok) {
+      const error =
+        extractDaemonErrorMessage(completeData) ?? "Invite completion failed";
+      log.warn(
+        { senderGatewayUrl, status: response.status, error },
+        "Sender invite/complete returned error",
+      );
+      return { success: false, error, errorCode: "complete_failed" };
+    }
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    log.warn(
+      { senderGatewayUrl, error: message },
+      "Failed to reach sender for invite/complete",
+    );
+    return {
+      success: false,
+      error: `Failed to reach sender: ${message}`,
+      errorCode: "sender_unreachable",
+    };
+  }
+
+  // 4. Extract sender display name from the complete response; use
+  //    invite-link values for assistantId and gatewayUrl (trusted source).
+  const senderFromResponse = completeData.sender as
+    | { displayName?: string }
+    | undefined;
+
+  const senderIdentity = {
+    assistantId: params.senderAssistantId,
+    displayName:
+      (typeof senderFromResponse?.displayName === "string" &&
+        senderFromResponse.displayName) ||
+      params.senderAssistantId,
+    gatewayUrl: senderGatewayUrl,
+  };
+
+  // 5. Create the sender as a local trusted contact
+  const redeemResult = redeemA2AInvite({ sender: senderIdentity });
+  if (!redeemResult.success) {
+    log.warn(
+      { error: redeemResult.error },
+      "Local invite/redeem failed after successful complete",
+    );
+    return {
+      success: false,
+      error: redeemResult.error ?? "Failed to create sender contact",
+      errorCode: "redeem_failed",
+    };
+  }
+
+  return {
+    success: true,
+    contactId: redeemResult.contactId,
+    alreadyConnected: redeemResult.alreadyConnected,
+  };
+}

package/src/daemon/handlers/config-model.test.ts

@@ -65,6 +65,7 @@ describe("projectProviderForWire", () => {
     const wire = projectProviderForWire(gemini!);
     const modelIds = wire.models.map((model) => model.id);
     const expectedGemini3ModelIds = [
+      "gemini-3.5-flash",
       "gemini-3.1-pro-preview",
       "gemini-3.1-pro-preview-customtools",
       "gemini-3-flash-preview",