@okrlinkhub/agent-bridge 0.1.0 → 2.0.0

package/dist/component/schema.js

@@ -1,92 +1,42 @@
 import { defineSchema, defineTable } from "convex/server";
 import { v } from "convex/values";
 export default defineSchema({
-    // Provisioning Tokens (generated by IT admin, distributed to employees)
-    provisioningTokens: defineTable({
-        tokenHash: v.string(), // SHA-256 hash of the APT (e.g. "apt_live_xxx")
-        employeeEmail: v.string(),
-        department: v.string(),
-        maxApps: v.number(), // How many apps this token can register (default 5)
-        usedCount: v.number(),
-        expiresAt: v.number(), // Token expiration timestamp
-        isActive: v.boolean(),
-        createdBy: v.string(), // Admin email who created the token
-    })
-        .index("by_token_hash", ["tokenHash"])
-        .index("by_email", ["employeeEmail"]),
-    // Registered agents (created on first provisioning)
-    registeredAgents: defineTable({
-        agentId: v.string(), // UUID generated at first provisioning
-        employeeEmail: v.string(),
-        department: v.string(),
-        firstRegisteredAt: v.number(),
-        lastSeenAt: v.number(),
-        isActive: v.boolean(),
-        revokedAt: v.optional(v.number()),
-        revokedBy: v.optional(v.string()),
-    })
-        .index("by_agent_id", ["agentId"])
-        .index("by_email", ["employeeEmail"]),
-    // Per-app per-agent instances (one per app per agent)
-    agentAppInstances: defineTable({
-        agentId: v.string(),
-        appName: v.string(),
-        instanceTokenHash: v.string(), // SHA-256 hash of the instance token
-        registeredAt: v.number(),
-        expiresAt: v.number(),
-        lastActivityAt: v.number(),
-        monthlyRequests: v.number(), // Request counter for this app
+    agents: defineTable({
+        name: v.string(),
+        apiKeyHash: v.string(),
+        enabled: v.boolean(),
+        rateLimit: v.number(),
+        lastUsed: v.optional(v.number()),
+        createdAt: v.number(),
     })
-        .index("by_instance_token_hash", ["instanceTokenHash"])
-        .index("by_agent_and_app", ["agentId", "appName"]),
-    // Function Handle Registry: maps function aliases to actual function handles
-    functionRegistry: defineTable({
-        appName: v.string(),
-        functionName: v.string(), // Alias e.g. "okr:getObjectives"
-        functionHandle: v.string(), // Function handle string from createFunctionHandle()
-        functionType: v.union(v.literal("query"), v.literal("mutation"), v.literal("action")),
-        description: v.optional(v.string()),
-        registeredAt: v.number(),
-    }).index("by_app_and_function", ["appName", "functionName"]),
-    // Dynamic permissions: who can do what on which app
-    functionPermissions: defineTable({
-        agentId: v.string(),
-        appName: v.string(),
-        functionPattern: v.string(), // e.g. "okr:*", "okr:createObjective", "*"
+        .index("by_apiKeyHash", ["apiKeyHash"])
+        .index("by_enabled", ["enabled"]),
+    agentPermissions: defineTable({
+        agentId: v.id("agents"),
+        functionPattern: v.string(),
         permission: v.union(v.literal("allow"), v.literal("deny"), v.literal("rate_limited")),
         rateLimitConfig: v.optional(v.object({
             requestsPerHour: v.number(),
-            tokenBudget: v.number(),
+            tokenBudget: v.optional(v.number()),
         })),
-        createdAt: v.number(),
-        createdBy: v.string(), // Admin email
-    })
-        .index("by_agent_and_app", ["agentId", "appName"])
-        .index("by_app_and_pattern", ["appName", "functionPattern"]),
-    // Audit log for all access attempts
-    accessLog: defineTable({
+        updatedAt: v.number(),
+    }).index("by_agentId", ["agentId"]),
+    agentFunctions: defineTable({
+        key: v.string(),
+        enabled: v.boolean(),
+        globalRateLimit: v.optional(v.number()),
+    }).index("by_key", ["key"]),
+    agentLogs: defineTable({
+        agentId: v.id("agents"),
+        functionKey: v.string(),
+        args: v.any(),
+        result: v.optional(v.any()),
+        error: v.optional(v.string()),
+        duration: v.number(),
         timestamp: v.number(),
-        agentId: v.string(),
-        appName: v.string(),
-        functionCalled: v.string(),
-        permission: v.string(), // "allow", "deny", "rate_limited"
-        errorMessage: v.optional(v.string()),
-        durationMs: v.optional(v.number()),
     })
-        .index("by_agent_and_timestamp", ["agentId", "timestamp"])
-        .index("by_app_and_function", ["appName", "functionCalled"]),
-    // Per-app configuration (no global singleton)
-    appConfigs: defineTable({
-        appName: v.string(),
-        defaultPermissions: v.array(v.object({
-            pattern: v.string(),
-            permission: v.union(v.literal("allow"), v.literal("deny"), v.literal("rate_limited")),
-            rateLimitConfig: v.optional(v.object({
-                requestsPerHour: v.number(),
-                tokenBudget: v.number(),
-            })),
-        })),
-        configuredAt: v.number(),
-    }).index("by_app_name", ["appName"]),
+        .index("by_agentId_and_timestamp", ["agentId", "timestamp"])
+        .index("by_functionKey", ["functionKey"])
+        .index("by_timestamp", ["timestamp"]),
 });
 //# sourceMappingURL=schema.js.map

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":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,eAAe,YAAY,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC;QAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;SACC,KAAK,CAAC,eAAe,EAAE,CAAC,YAAY,CAAC,CAAC;SACtC,KAAK,CAAC,YAAY,EAAE,CAAC,SAAS,CAAC,CAAC;IAEnC,gBAAgB,EAAE,WAAW,CAAC;QAC5B,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC;QACvB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;QAC3B,UAAU,EAAE,CAAC,CAAC,KAAK,CACjB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAClB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EACjB,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAC1B;QACD,eAAe,EAAE,CAAC,CAAC,QAAQ,CACzB,CAAC,CAAC,MAAM,CAAC;YACP,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;YAC3B,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACpC,CAAC,CACH;QACD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,SAAS,CAAC,CAAC;IAEnC,cAAc,EAAE,WAAW,CAAC;QAC1B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KACxC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;IAE3B,SAAS,EAAE,WAAW,CAAC;QACrB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC;QACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC3B,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;SACC,KAAK,CAAC,0BAA0B,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;SAC3D,KAAK,CAAC,gBAAgB,EAAE,CAAC,aAAa,CAAC,CAAC;SACxC,KAAK,CAAC,cAAc,EAAE,CAAC,WAAW,CAAC,CAAC;CACxC,CAAC,CAAC"}

package/dist/react/index.d.ts

@@ -1,3 +1,3 @@
-export { AgentBridge } from "../client/index.js";
-export type { AgentBridgeConfig, FunctionDef, DefaultPermission, } from "../client/index.js";
+export { registerRoutes, normalizeAgentBridgeConfig } from "../client/index.js";
+export type { AgentBridgeConfig, AgentBridgeFunctionDefinition, AgentBridgeFunctionMetadata, AgentBridgeFunctionType, } from "../client/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChF,YAAY,EACV,iBAAiB,EACjB,6BAA6B,EAC7B,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/react/index.js

@@ -1,5 +1,4 @@
 "use client";
-// React hooks and components for the Agent Bridge admin panel.
-// These will be expanded in future versions.
-export { AgentBridge } from "../client/index.js";
+// React helpers for Agent Bridge integrations.
+export { registerRoutes, normalizeAgentBridgeConfig } from "../client/index.js";
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,+DAA+D;AAC/D,6CAA6C;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,+CAA+C;AAC/C,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC"}

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": "2.0.0",
   "license": "Apache-2.0",
   "keywords": [
     "convex",
@@ -39,6 +42,7 @@
     "dist",
     "src"
   ],
+  "bin": "./dist/cli/init.js",
   "exports": {
     "./package.json": "./package.json",
     ".": {
@@ -100,4 +104,4 @@
   },
   "types": "./dist/client/index.d.ts",
   "module": "./dist/client/index.js"
-}
+}

package/src/cli/init.ts

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+import { access, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+
+const cwd = process.cwd();
+
+async function exists(targetPath: string) {
+  try {
+    await access(targetPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function writeIfMissing(
+  relativePath: string,
+  content: string,
+): Promise<"created" | "skipped"> {
+  const absolutePath = path.join(cwd, relativePath);
+  if (await exists(absolutePath)) {
+    return "skipped";
+  }
+
+  await mkdir(path.dirname(absolutePath), { recursive: true });
+  await writeFile(absolutePath, content, "utf8");
+  return "created";
+}
+
+const configTemplate = `import { api } from "./convex/_generated/api";
+import { defineAgentBridgeConfig } from "@okrlinkhub/agent-bridge";
+
+export default defineAgentBridgeConfig({
+  functions: {
+    "cart.calculatePrice": {
+      ref: api.cart.calculatePrice,
+      type: "query",
+    },
+    "cart.applyDiscount": {
+      ref: api.cart.applyDiscount,
+      type: "mutation",
+    },
+  },
+  metadata: {
+    "cart.calculatePrice": {
+      description: "Calcola il prezzo totale del carrello",
+      riskLevel: "low",
+      category: "commerce",
+    },
+  },
+});
+`;
+
+const bridgeHttpTemplate = `import { registerRoutes } from "@okrlinkhub/agent-bridge";
+import { components } from "./_generated/api";
+import config from "../agent-bridge.config";
+
+export function registerAgentBridgeRoutes(
+  http: Parameters<typeof registerRoutes>[0],
+) {
+  registerRoutes(http, components.agentBridge, config, {
+    pathPrefix: "/agent",
+  });
+}
+`;
+
+const integrationNotes = `
+[agent-bridge] Init completed.
+
+Next steps:
+1) Add component in convex/convex.config.ts:
+
+import { defineApp } from "convex/server";
+import agentBridge from "@okrlinkhub/agent-bridge/convex.config.js";
+
+const app = defineApp();
+app.use(agentBridge);
+export default app;
+
+2) Mount routes in convex/http.ts:
+
+import { httpRouter } from "convex/server";
+import { registerAgentBridgeRoutes } from "./agentBridge";
+
+const http = httpRouter();
+registerAgentBridgeRoutes(http);
+export default http;
+
+3) Create agents and permissions with component mutations:
+- components.agentBridge.agents.createAgent
+- components.agentBridge.permissions.setAgentPermissions
+- components.agentBridge.permissions.setFunctionOverrides
+`;
+
+async function main() {
+  const commandArg = process.argv[2];
+  if (commandArg && commandArg !== "init") {
+    console.error(`[agent-bridge] Unknown command "${commandArg}".`);
+    console.error("Usage: npx @okrlinkhub/agent-bridge init");
+    process.exitCode = 1;
+    return;
+  }
+
+  const configResult = await writeIfMissing("agent-bridge.config.ts", configTemplate);
+  const bridgeResult = await writeIfMissing("convex/agentBridge.ts", bridgeHttpTemplate);
+
+  console.log(
+    `[agent-bridge] agent-bridge.config.ts: ${configResult === "created" ? "created" : "skipped (already exists)"}`,
+  );
+  console.log(
+    `[agent-bridge] convex/agentBridge.ts: ${bridgeResult === "created" ? "created" : "skipped (already exists)"}`,
+  );
+  console.log(integrationNotes.trim());
+}
+
+void main();