@okrlinkhub/agent-bridge 0.1.0 → 0.2.0

package/dist/component/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@okrlinkhub/agent-bridge",
   "description": "A agent bridge component for Convex.",
-  "repository": "github:okrlinkhub/agent-bridge",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/okrlinkhub/agent-bridge.git"
+  },
   "homepage": "https://github.com/okrlinkhub/agent-bridge#readme",
   "bugs": {
     "url": "https://github.com/okrlinkhub/agent-bridge/issues"
   },
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "Apache-2.0",
   "keywords": [
     "convex",

package/src/client/index.ts

@@ -252,6 +252,140 @@ export class AgentBridge {
       limit: opts?.limit,
     });
   }
+
+  // --- Circuit Breaker ---
+
+  /**
+   * Get the current circuit breaker status for an agent on this app.
+   * Returns the counter for the current hour window, or null if none exists.
+   */
+  async getCircuitBreakerStatus(ctx: QueryCtx, agentId: string) {
+    return await ctx.runQuery(this.component.circuitBreaker.getStatus, {
+      agentId,
+      appName: this.appName,
+    });
+  }
+
+  /**
+   * Admin: manually reset a blocked circuit breaker for an agent.
+   */
+  async resetCircuitBreaker(
+    ctx: MutationCtx,
+    agentId: string,
+  ): Promise<boolean> {
+    return await ctx.runMutation(this.component.circuitBreaker.resetCounter, {
+      agentId,
+      appName: this.appName,
+    });
+  }
+
+  /**
+   * Admin: list all currently blocked circuit breakers across all agents.
+   */
+  async listBlockedAgents(ctx: QueryCtx) {
+    return await ctx.runQuery(this.component.circuitBreaker.listBlocked, {});
+  }
+
+  // --- A2A Channels ---
+
+  /**
+   * Admin: create a channel for this app.
+   * Idempotent -- returns existing channel ID if it already exists.
+   */
+  async createChannel(
+    ctx: MutationCtx,
+    channelName: string,
+    description?: string,
+  ): Promise<string> {
+    return await ctx.runMutation(this.component.channels.createChannel, {
+      appName: this.appName,
+      channelName,
+      description,
+    });
+  }
+
+  /**
+   * List active channels for this app.
+   */
+  async listChannels(ctx: QueryCtx) {
+    return await ctx.runQuery(this.component.channels.listChannels, {
+      appName: this.appName,
+    });
+  }
+
+  /**
+   * Admin: deactivate a channel (soft delete).
+   */
+  async deactivateChannel(
+    ctx: MutationCtx,
+    channelName: string,
+  ): Promise<boolean> {
+    return await ctx.runMutation(this.component.channels.deactivateChannel, {
+      appName: this.appName,
+      channelName,
+    });
+  }
+
+  /**
+   * Post a message to a channel on behalf of an authenticated agent.
+   */
+  async postMessage(
+    ctx: MutationCtx,
+    opts: {
+      instanceToken: string;
+      channelName: string;
+      payload: string;
+      priority?: number;
+      ttlMinutes?: number;
+    },
+  ) {
+    return await ctx.runMutation(this.component.channels.postMessage, {
+      instanceToken: opts.instanceToken,
+      appName: this.appName,
+      channelName: opts.channelName,
+      payload: opts.payload,
+      priority: opts.priority,
+      ttlMinutes: opts.ttlMinutes,
+    });
+  }
+
+  /**
+   * Read messages from a channel on behalf of an authenticated agent.
+   */
+  async readMessages(
+    ctx: QueryCtx,
+    opts: {
+      instanceToken: string;
+      channelName: string;
+      limit?: number;
+      after?: number;
+    },
+  ) {
+    return await ctx.runQuery(this.component.channels.readMessages, {
+      instanceToken: opts.instanceToken,
+      appName: this.appName,
+      channelName: opts.channelName,
+      limit: opts.limit,
+      after: opts.after,
+    });
+  }
+
+  /**
+   * Get unread message count for an agent on a channel.
+   */
+  async getUnreadCount(
+    ctx: QueryCtx,
+    opts: {
+      instanceToken: string;
+      channelName: string;
+    },
+  ) {
+    return await ctx.runQuery(this.component.channels.getUnreadCount, {
+      instanceToken: opts.instanceToken,
+      appName: this.appName,
+      channelName: opts.channelName,
+    });
+  }
 }
 
 // --- HTTP Route Registration ---
@@ -291,6 +425,7 @@ export function registerRoutes(
         instanceToken?: string;
         functionName?: string;
         args?: Record<string, unknown>;
+        estimatedCost?: number;
       };
       try {
         body = await request.json();
@@ -298,7 +433,7 @@ export function registerRoutes(
         return jsonResponse({ error: "Invalid JSON body" }, 400);
       }
 
-      const { instanceToken, functionName, args } = body;
+      const { instanceToken, functionName, args, estimatedCost } = body;
 
       if (!instanceToken || !functionName) {
         return jsonResponse(
@@ -308,13 +443,14 @@ export function registerRoutes(
       }
 
       // Step 1: Authorize the request (mutation -- validates token, checks permissions,
-      // updates counters, returns function handle)
+      // circuit breaker, updates counters, returns function handle)
       const authResult = await ctx.runMutation(
         component.gateway.authorizeRequest,
         {
           instanceToken,
           functionName,
           appName: config.appName,
+          estimatedCost,
         },
       );
 
@@ -324,14 +460,28 @@ export function registerRoutes(
             ? ` (matchedPattern="${authResult.matchedPattern}", permission="${authResult.matchedPermission}")`
             : "";
         // Log the denied access
+        const permission =
+          authResult.statusCode === 429 ? "rate_limited" : "deny";
         await ctx.runMutation(component.gateway.logAccess, {
           agentId: authResult.agentId ?? "unknown",
           appName: config.appName,
           functionCalled: functionName,
-          permission: "deny",
+          permission,
           errorMessage: authResult.error + detailSuffix,
         });
 
+        // For rate-limited responses, include Retry-After header
+        if (
+          authResult.statusCode === 429 &&
+          authResult.retryAfterSeconds !== undefined
+        ) {
+          return jsonResponseWithHeaders(
+            { error: authResult.error },
+            authResult.statusCode,
+            { "Retry-After": String(authResult.retryAfterSeconds) },
+          );
+        }
+
         return jsonResponse(
           { error: authResult.error },
           authResult.statusCode,
@@ -469,9 +619,255 @@ export function registerRoutes(
       }
     }),
   });
+
+  // --- POST /agent-bridge/channels ---
+  // Create a new channel (admin operation)
+  http.route({
+    path: `${prefix}/channels`,
+    method: "POST",
+    handler: httpActionGeneric(async (ctx, request) => {
+      let body: {
+        channelName?: string;
+        description?: string;
+      };
+      try {
+        body = await request.json();
+      } catch {
+        return jsonResponse({ error: "Invalid JSON body" }, 400);
+      }
+
+      const { channelName, description } = body;
+
+      if (!channelName) {
+        return jsonResponse(
+          { error: "Missing required field: channelName" },
+          400,
+        );
+      }
+
+      try {
+        const channelId = await ctx.runMutation(
+          component.channels.createChannel,
+          {
+            appName: config.appName,
+            channelName,
+            description,
+          },
+        );
+
+        return jsonResponse({ channelId, channelName }, 200);
+      } catch (error: unknown) {
+        const errorMessage =
+          error instanceof Error ? error.message : "Failed to create channel";
+        return jsonResponse({ error: errorMessage }, 500);
+      }
+    }),
+  });
+
+  // --- GET /agent-bridge/channels ---
+  // List active channels for this app
+  http.route({
+    path: `${prefix}/channels`,
+    method: "GET",
+    handler: httpActionGeneric(async (ctx) => {
+      try {
+        const channels = await ctx.runQuery(
+          component.channels.listChannels,
+          { appName: config.appName },
+        );
+
+        return jsonResponse({ channels }, 200);
+      } catch (error: unknown) {
+        const errorMessage =
+          error instanceof Error ? error.message : "Failed to list channels";
+        return jsonResponse({ error: errorMessage }, 500);
+      }
+    }),
+  });
+
+  // --- POST /agent-bridge/channels/post ---
+  // Post a message to a channel (requires instanceToken)
+  http.route({
+    path: `${prefix}/channels/post`,
+    method: "POST",
+    handler: httpActionGeneric(async (ctx, request) => {
+      let body: {
+        instanceToken?: string;
+        channelName?: string;
+        payload?: string;
+        priority?: number;
+        ttlMinutes?: number;
+      };
+      try {
+        body = await request.json();
+      } catch {
+        return jsonResponse({ error: "Invalid JSON body" }, 400);
+      }
+
+      const { instanceToken, channelName, payload, priority, ttlMinutes } =
+        body;
+
+      if (!instanceToken || !channelName || !payload) {
+        return jsonResponse(
+          {
+            error:
+              "Missing required fields: instanceToken, channelName, payload",
+          },
+          400,
+        );
+      }
+
+      try {
+        const result = await ctx.runMutation(
+          component.channels.postMessage,
+          {
+            instanceToken,
+            appName: config.appName,
+            channelName,
+            payload,
+            priority,
+            ttlMinutes,
+          },
+        );
+
+        return jsonResponse(result, 200);
+      } catch (error: unknown) {
+        const errorMessage =
+          error instanceof Error ? error.message : "Failed to post message";
+        // Map authentication errors to appropriate status codes
+        if (
+          errorMessage.includes("Invalid instance token") ||
+          errorMessage.includes("expired")
+        ) {
+          return jsonResponse({ error: errorMessage }, 401);
+        }
+        if (
+          errorMessage.includes("revoked") ||
+          errorMessage.includes("does not match")
+        ) {
+          return jsonResponse({ error: errorMessage }, 403);
+        }
+        return jsonResponse({ error: errorMessage }, 500);
+      }
+    }),
+  });
+
+  // --- POST /agent-bridge/channels/read ---
+  // Read messages from a channel (POST because it has body with filters)
+  http.route({
+    path: `${prefix}/channels/read`,
+    method: "POST",
+    handler: httpActionGeneric(async (ctx, request) => {
+      let body: {
+        instanceToken?: string;
+        channelName?: string;
+        limit?: number;
+        after?: number;
+      };
+      try {
+        body = await request.json();
+      } catch {
+        return jsonResponse({ error: "Invalid JSON body" }, 400);
+      }
+
+      const { instanceToken, channelName, limit, after } = body;
+
+      if (!instanceToken || !channelName) {
+        return jsonResponse(
+          {
+            error: "Missing required fields: instanceToken, channelName",
+          },
+          400,
+        );
+      }
+
+      try {
+        const messages = await ctx.runQuery(
+          component.channels.readMessages,
+          {
+            instanceToken,
+            appName: config.appName,
+            channelName,
+            limit,
+            after,
+          },
+        );
+
+        return jsonResponse({ messages }, 200);
+      } catch (error: unknown) {
+        const errorMessage =
+          error instanceof Error ? error.message : "Failed to read messages";
+        if (
+          errorMessage.includes("Invalid instance token") ||
+          errorMessage.includes("expired")
+        ) {
+          return jsonResponse({ error: errorMessage }, 401);
+        }
+        if (
+          errorMessage.includes("revoked") ||
+          errorMessage.includes("does not match")
+        ) {
+          return jsonResponse({ error: errorMessage }, 403);
+        }
+        return jsonResponse({ error: errorMessage }, 500);
+      }
+    }),
+  });
+
+  // --- POST /agent-bridge/channels/mark-read ---
+  // Mark a message as read by an agent
+  http.route({
+    path: `${prefix}/channels/mark-read`,
+    method: "POST",
+    handler: httpActionGeneric(async (ctx, request) => {
+      let body: {
+        instanceToken?: string;
+        messageId?: string;
+      };
+      try {
+        body = await request.json();
+      } catch {
+        return jsonResponse({ error: "Invalid JSON body" }, 400);
+      }
+
+      const { instanceToken, messageId } = body;
+
+      if (!instanceToken || !messageId) {
+        return jsonResponse(
+          {
+            error: "Missing required fields: instanceToken, messageId",
+          },
+          400,
+        );
+      }
+
+      try {
+        const success = await ctx.runMutation(
+          component.channels.markAsRead,
+          {
+            instanceToken,
+            appName: config.appName,
+            messageId,
+          },
+        );
+
+        return jsonResponse({ success }, 200);
+      } catch (error: unknown) {
+        const errorMessage =
+          error instanceof Error ? error.message : "Failed to mark as read";
+        if (
+          errorMessage.includes("Invalid instance token") ||
+          errorMessage.includes("expired")
+        ) {
+          return jsonResponse({ error: errorMessage }, 401);
+        }
+        return jsonResponse({ error: errorMessage }, 500);
+      }
+    }),
+  });
 }
 
-// --- Helper ---
+// --- Helpers ---
 
 function jsonResponse(data: unknown, status: number): Response {
   return new Response(JSON.stringify(data), {
@@ -479,3 +875,14 @@ function jsonResponse(data: unknown, status: number): Response {
     headers: { "Content-Type": "application/json" },
   });
 }
+
+function jsonResponseWithHeaders(
+  data: unknown,
+  status: number,
+  extraHeaders: Record<string, string>,
+): Response {
+  return new Response(JSON.stringify(data), {
+    status,
+    headers: { "Content-Type": "application/json", ...extraHeaders },
+  });
+}

package/src/component/_generated/api.ts

@@ -8,6 +8,8 @@
  * @module
  */
 
+import type * as channels from "../channels.js";
+import type * as circuitBreaker from "../circuitBreaker.js";
 import type * as gateway from "../gateway.js";
 import type * as permissions from "../permissions.js";
 import type * as provisioning from "../provisioning.js";
@@ -21,6 +23,8 @@ import type {
 import { anyApi, componentsGeneric } from "convex/server";
 
 const fullApi: ApiFromModules<{
+  channels: typeof channels;
+  circuitBreaker: typeof circuitBreaker;
   gateway: typeof gateway;
   permissions: typeof permissions;
   provisioning: typeof provisioning;

package/src/component/_generated/component.ts

@@ -23,11 +23,151 @@ import type { FunctionReference } from "convex/server";
  */
 export type ComponentApi<Name extends string | undefined = string | undefined> =
   {
+    channels: {
+      createChannel: FunctionReference<
+        "mutation",
+        "internal",
+        { appName: string; channelName: string; description?: string },
+        string,
+        Name
+      >;
+      deactivateChannel: FunctionReference<
+        "mutation",
+        "internal",
+        { appName: string; channelName: string },
+        boolean,
+        Name
+      >;
+      getUnreadCount: FunctionReference<
+        "query",
+        "internal",
+        { appName: string; channelName: string; instanceToken: string },
+        number,
+        Name
+      >;
+      listChannels: FunctionReference<
+        "query",
+        "internal",
+        { appName: string },
+        Array<{
+          channelName: string;
+          createdAt: number;
+          description?: string;
+          isActive: boolean;
+        }>,
+        Name
+      >;
+      markAsRead: FunctionReference<
+        "mutation",
+        "internal",
+        { appName: string; instanceToken: string; messageId: string },
+        boolean,
+        Name
+      >;
+      postMessage: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          appName: string;
+          channelName: string;
+          instanceToken: string;
+          payload: string;
+          priority?: number;
+          ttlMinutes?: number;
+        },
+        { messageId: string; success: boolean },
+        Name
+      >;
+      readMessages: FunctionReference<
+        "query",
+        "internal",
+        {
+          after?: number;
+          appName: string;
+          channelName: string;
+          instanceToken: string;
+          limit?: number;
+        },
+        Array<{
+          expiresAt: number;
+          fromAgentId: string;
+          messageId: string;
+          metadata: { priority: number; ttl: number };
+          payload: string;
+          readBy: Array<string>;
+          sentAt: number;
+        }>,
+        Name
+      >;
+    };
+    circuitBreaker: {
+      checkAndIncrement: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          agentId: string;
+          appName: string;
+          estimatedCost: number;
+          limits: { requestsPerHour: number; tokenBudget: number };
+        },
+        {
+          allowed: boolean;
+          currentCount: number;
+          currentTokens: number;
+          reason?: string;
+        },
+        Name
+      >;
+      getStatus: FunctionReference<
+        "query",
+        "internal",
+        { agentId: string; appName: string },
+        {
+          agentId: string;
+          appName: string;
+          blockedAt?: number;
+          blockedReason?: string;
+          isBlocked: boolean;
+          requestCount: number;
+          tokenEstimate: number;
+          windowHour: string;
+        } | null,
+        Name
+      >;
+      listBlocked: FunctionReference<
+        "query",
+        "internal",
+        {},
+        Array<{
+          agentId: string;
+          appName: string;
+          blockedAt?: number;
+          blockedReason?: string;
+          isBlocked: boolean;
+          requestCount: number;
+          tokenEstimate: number;
+          windowHour: string;
+        }>,
+        Name
+      >;
+      resetCounter: FunctionReference<
+        "mutation",
+        "internal",
+        { agentId: string; appName: string },
+        boolean,
+        Name
+      >;
+    };
     gateway: {
       authorizeRequest: FunctionReference<
         "mutation",
         "internal",
-        { appName: string; functionName: string; instanceToken: string },
+        {
+          appName: string;
+          estimatedCost?: number;
+          functionName: string;
+          instanceToken: string;
+        },
         | {
             agentId: string;
             appName: string;
@@ -41,6 +181,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
             error: string;
             matchedPattern?: string;
             matchedPermission?: "allow" | "deny" | "rate_limited";
+            retryAfterSeconds?: number;
             statusCode: number;
           },
         Name