@vellumai/vellum-gateway 0.4.50 → 0.4.51

package/knip.json

@@ -1,8 +1,5 @@
 {
-  "project": [
-    "src/**/*.ts"
-  ],
-  "ignore": [
-    "src/**/__tests__/**"
-  ]
+  "entry": ["src/**/*.test.ts", "src/**/__tests__/**/*.ts"],
+  "project": ["src/**/*.ts"],
+  "ignoreDependencies": ["zod"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/vellum-gateway",
-  "version": "0.4.50",
+  "version": "0.4.51",
   "type": "module",
   "exports": {
     "./twilio/verify": "./src/twilio/verify.ts",
@@ -16,9 +16,10 @@
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "lint": "eslint",
+    "lint:unused": "knip --include files,dependencies,unlisted",
     "typecheck": "bunx tsc --noEmit",
     "prebuild": "cd .. && bun run meta/feature-flags/sync-bundled-copies.ts",
-    "postinstall": "cd .. && (git config core.hooksPath || git config core.hooksPath .githooks 2>/dev/null || true) && (bun run meta/feature-flags/sync-bundled-copies.ts 2>/dev/null || true)"
+    "postinstall": "cd .. && (git config core.hooksPath || git config core.hooksPath .githooks 2>/dev/null || true) && ([ -f meta/feature-flags/sync-bundled-copies.ts ] && bun run meta/feature-flags/sync-bundled-copies.ts 2>/dev/null || true)"
   },
   "dependencies": {
     "file-type": "^21.3.0",

package/src/__tests__/telegram-webhook-handler.test.ts

@@ -246,7 +246,7 @@ describe("telegram webhook handler: gatewayInternalBaseUrl", () => {
 });
 
 describe("telegram webhook handler: /new rejection", () => {
-  test("/start forwards command intent metadata, does not reset conversation, and sends start acknowledgement", async () => {
+  test("/start with payload forwards command intent metadata, does not reset conversation, and suppresses ACK", async () => {
     const config = makeConfig({
       routingEntries: [
         { type: "conversation_id", key: "12345", assistantId: "assistant-a" },
@@ -275,11 +275,11 @@ describe("telegram webhook handler: /new rejection", () => {
     );
     expect(resetCall).toBeUndefined();
 
+    // ACK is suppressed when /start has a payload
     const sendMessageCall = fetchCalls.find((c) =>
       c.url.includes("/sendMessage"),
     );
-    expect(sendMessageCall).toBeDefined();
-    expect((sendMessageCall!.body as any).text).toContain("Starting up");
+    expect(sendMessageCall).toBeUndefined();
   });
 
   test("/start with routing rejection sends setup notice and does not forward", async () => {

package/src/channels/transport-hints.ts

@@ -26,16 +26,6 @@ export const SLACK_CHANNEL_TRANSPORT_HINTS = [
 export const SLACK_CHANNEL_TRANSPORT_UX_BRIEF =
   "Slack is a threaded channel medium. Replies should stay in-thread when a thread_ts is present. Use plain text or Slack mrkdwn formatting; avoid markdown tables and complex block layouts.";
 
-export function buildSlackTransportMetadata(): {
-  hints: string[];
-  uxBrief: string;
-} {
-  return {
-    hints: [...SLACK_CHANNEL_TRANSPORT_HINTS],
-    uxBrief: SLACK_CHANNEL_TRANSPORT_UX_BRIEF,
-  };
-}
-
 export const WHATSAPP_CHANNEL_TRANSPORT_HINTS = [
   "chat-first-medium",
   "channel-safe-onboarding",

package/src/http/routes/contacts-control-plane-proxy.ts

@@ -146,6 +146,10 @@ export function createContactsControlPlaneProxyHandler(config: GatewayConfig) {
       return proxyToRuntime(req, "/v1/contacts/invites/redeem", "");
     },
 
+    async handleCallInvite(req: Request, inviteId: string): Promise<Response> {
+      return proxyToRuntime(req, `/v1/contacts/invites/${inviteId}/call`, "");
+    },
+
     async handleRevokeInvite(
       req: Request,
       inviteId: string,

package/src/http/routes/telegram-webhook.test.ts

@@ -239,7 +239,7 @@ describe("telegram-webhook callback query acknowledgment", () => {
     expect(sendTelegramReplyMock).not.toHaveBeenCalled();
   });
 
-  it("forwards /start as channel command-intent metadata and sends start acknowledgement", async () => {
+  it("forwards /start with payload as channel command-intent metadata without sending ACK", async () => {
     const { handler } = createTelegramWebhookHandler(baseConfig, makeCaches());
     const body = JSON.stringify({
       update_id: 314,
@@ -263,14 +263,8 @@ describe("telegram-webhook callback query acknowledgment", () => {
       type: "start",
       payload: "ref-123",
     });
-    expect(sendTelegramReplyMock).toHaveBeenCalledTimes(1);
-    const sendArgs = sendTelegramReplyMock.mock.calls[0] as unknown as [
-      GatewayConfig,
-      string,
-      string,
-    ];
-    expect(sendArgs[1]).toBe("42");
-    expect(sendArgs[2]).toContain("Starting up");
+    // ACK is suppressed when /start has a payload
+    expect(sendTelegramReplyMock).not.toHaveBeenCalled();
   });
 
   it("does not call answerCallbackQuery for regular text messages", async () => {

package/src/http/routes/telegram-webhook.ts

@@ -357,7 +357,9 @@ export function createTelegramWebhookHandler(
 
       // Forward to runtime with command-intent metadata so the assistant
       // generates a natural greeting via the normal agent loop.
-      if (!normalized.message.callbackQueryId) {
+      // Skip the ACK when the /start includes a payload (e.g. invite token) —
+      // the runtime will send its own contextual reply during ACL enforcement.
+      if (!normalized.message.callbackQueryId && !startCmd.payload) {
         sendTelegramReply(
           config,
           normalized.message.conversationExternalId,

package/src/index.ts

@@ -466,6 +466,13 @@ async function main() {
       auth: "edge",
       handler: (req) => contactsControlPlaneProxy.handleRedeemInvite(req),
     },
+    {
+      path: /^\/v1\/contacts\/invites\/([^/]+)\/call$/,
+      method: "POST",
+      auth: "edge",
+      handler: (req, params) =>
+        contactsControlPlaneProxy.handleCallInvite(req, params[0]),
+    },
     {
       path: /^\/v1\/contacts\/invites\/([^/]+)$/,
       method: "DELETE",

package/src/runtime/client.ts

@@ -90,13 +90,6 @@ function cbOnFailure(): void {
   }
 }
 
-/** Exported for testing — resets circuit breaker to initial state. */
-export function _resetCircuitBreaker(): void {
-  cbState = CircuitState.CLOSED;
-  cbConsecutiveFailures = 0;
-  cbOpenedAt = 0;
-}
-
 /**
  * Build common headers for runtime requests using JWT auth.
  *

package/src/schema.ts

@@ -1145,6 +1145,41 @@ export function buildSchema(): Record<string, unknown> {
           },
         },
       },
+      "/v1/contacts/invites/{inviteId}/call": {
+        post: {
+          summary: "Call a contacts invite",
+          description:
+            "Authenticated gateway endpoint that initiates a call for a contacts invite via the assistant runtime.",
+          operationId: "contactsInvitesCallPost",
+          security: [{ BearerAuth: [] }],
+          parameters: [
+            {
+              name: "inviteId",
+              in: "path",
+              required: true,
+              schema: { type: "string" },
+            },
+          ],
+          requestBody: {
+            required: true,
+            content: {
+              "application/json": {
+                schema: { type: "object", additionalProperties: true },
+              },
+            },
+          },
+          responses: {
+            "200": { description: "Invite call initiated" },
+            "401": {
+              description: "Unauthorized — missing or invalid bearer token",
+            },
+            "404": { description: "Invite not found" },
+            "503": { description: "Bearer token not configured" },
+            "502": { description: "Failed to reach assistant runtime" },
+            "504": { description: "Assistant runtime request timed out" },
+          },
+        },
+      },
       "/v1/contacts/invites/{inviteId}": {
         delete: {
           summary: "Revoke contacts invite",