@axiom-lattice/gateway 1.0.27 → 1.0.30

package/.turbo/turbo-build.log

@@ -9,13 +9,13 @@
 CLI Cleaning output folder
 CJS Build start
 ESM Build start
-CJS dist/index.js     18.89 KB
-CJS dist/index.js.map 38.81 KB
-CJS ⚡️ Build success in 79ms
-ESM dist/index.mjs     16.85 KB
-ESM dist/index.mjs.map 38.71 KB
-ESM ⚡️ Build success in 80ms
+CJS dist/index.js     25.04 KB
+CJS dist/index.js.map 51.16 KB
+CJS ⚡️ Build success in 114ms
+ESM dist/index.mjs     22.93 KB
+ESM dist/index.mjs.map 51.03 KB
+ESM ⚡️ Build success in 115ms
 DTS Build start
-DTS ⚡️ Build success in 4087ms
-DTS dist/index.d.ts  737.00 B
-DTS dist/index.d.mts 737.00 B
+DTS ⚡️ Build success in 5147ms
+DTS dist/index.d.ts  1.90 KB
+DTS dist/index.d.mts 1.90 KB

package/dist/index.d.mts

@@ -1,10 +1,55 @@
-import * as fastify from 'fastify';
 import * as http from 'http';
+import * as fastify from 'fastify';
+
+declare const defaultSwaggerConfig: {
+    openapi: {
+        openapi: string;
+        info: {
+            title: string;
+            description: string;
+            version: string;
+            contact: {
+                name: string;
+                email: string;
+            };
+        };
+        servers: {
+            url: string;
+            description: string;
+        }[];
+        components: {
+            securitySchemes: {
+                bearerAuth: {
+                    type: "http";
+                    scheme: "bearer";
+                    bearerFormat: string;
+                };
+            };
+        };
+        security: {
+            bearerAuth: never[];
+        }[];
+        tags: {
+            name: string;
+            description: string;
+        }[];
+    };
+};
+declare const defaultSwaggerUiConfig: {
+    routePrefix: string;
+    uiConfig: {
+        docExpansion: "full";
+        deepLinking: boolean;
+    };
+    staticCSP: boolean;
+    transformStaticCSP: (header: string) => string;
+};
 
 declare const LatticeGateway: {
     startAsHttpEndpoint: ({ port }: {
         port: number;
     }) => Promise<void>;
+    configureSwagger: (app: fastify.FastifyInstance, customSwaggerConfig?: Partial<typeof defaultSwaggerConfig>, customSwaggerUiConfig?: Partial<typeof defaultSwaggerUiConfig>) => Promise<void>;
     app: fastify.FastifyInstance<http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>, http.IncomingMessage, http.ServerResponse<http.IncomingMessage>, fastify.FastifyBaseLogger, fastify.FastifyTypeProviderDefault> & PromiseLike<fastify.FastifyInstance<http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>, http.IncomingMessage, http.ServerResponse<http.IncomingMessage>, fastify.FastifyBaseLogger, fastify.FastifyTypeProviderDefault>> & {
         __linterBrands: "SafePromiseLike";
     };

package/dist/index.d.ts

@@ -1,10 +1,55 @@
-import * as fastify from 'fastify';
 import * as http from 'http';
+import * as fastify from 'fastify';
+
+declare const defaultSwaggerConfig: {
+    openapi: {
+        openapi: string;
+        info: {
+            title: string;
+            description: string;
+            version: string;
+            contact: {
+                name: string;
+                email: string;
+            };
+        };
+        servers: {
+            url: string;
+            description: string;
+        }[];
+        components: {
+            securitySchemes: {
+                bearerAuth: {
+                    type: "http";
+                    scheme: "bearer";
+                    bearerFormat: string;
+                };
+            };
+        };
+        security: {
+            bearerAuth: never[];
+        }[];
+        tags: {
+            name: string;
+            description: string;
+        }[];
+    };
+};
+declare const defaultSwaggerUiConfig: {
+    routePrefix: string;
+    uiConfig: {
+        docExpansion: "full";
+        deepLinking: boolean;
+    };
+    staticCSP: boolean;
+    transformStaticCSP: (header: string) => string;
+};
 
 declare const LatticeGateway: {
     startAsHttpEndpoint: ({ port }: {
         port: number;
     }) => Promise<void>;
+    configureSwagger: (app: fastify.FastifyInstance, customSwaggerConfig?: Partial<typeof defaultSwaggerConfig>, customSwaggerUiConfig?: Partial<typeof defaultSwaggerUiConfig>) => Promise<void>;
     app: fastify.FastifyInstance<http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>, http.IncomingMessage, http.ServerResponse<http.IncomingMessage>, fastify.FastifyBaseLogger, fastify.FastifyTypeProviderDefault> & PromiseLike<fastify.FastifyInstance<http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>, http.IncomingMessage, http.ServerResponse<http.IncomingMessage>, fastify.FastifyBaseLogger, fastify.FastifyTypeProviderDefault>> & {
         __linterBrands: "SafePromiseLike";
     };

package/dist/index.js

@@ -451,31 +451,230 @@ var getAgentGraph = async (request, reply) => {
   }
 };
 
+// src/schemas/index.ts
+var createRunSchema = {
+  description: "Create a new agent run",
+  tags: ["Runs"],
+  summary: "Create Agent Run",
+  body: {
+    type: "object",
+    properties: {
+      assistantId: { type: "string", description: "Assistant ID" },
+      threadId: { type: "string", description: "Thread ID" },
+      input: { type: "object", description: "Input data for the run" }
+    },
+    required: ["assistantId", "threadId"]
+  },
+  response: {
+    200: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        data: { type: "object" }
+      }
+    },
+    400: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        error: { type: "string" }
+      }
+    }
+  }
+};
+var getAllMemoryItemsSchema = {
+  description: "Get all memory items for an assistant thread",
+  tags: ["Memory"],
+  summary: "Get All Memory Items",
+  params: {
+    type: "object",
+    properties: {
+      assistantId: { type: "string", description: "Assistant ID" },
+      thread_id: { type: "string", description: "Thread ID" }
+    },
+    required: ["assistantId", "thread_id"]
+  },
+  response: {
+    200: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        data: { type: "array", items: { type: "object" } }
+      }
+    }
+  }
+};
+var getAgentStateSchema = {
+  description: "Get agent state for an assistant thread",
+  tags: ["Memory"],
+  summary: "Get Agent State",
+  params: {
+    type: "object",
+    properties: {
+      assistantId: { type: "string", description: "Assistant ID" },
+      thread_id: { type: "string", description: "Thread ID" }
+    },
+    required: ["assistantId", "thread_id"]
+  },
+  response: {
+    200: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        data: { type: "object" }
+      }
+    }
+  }
+};
+var getMemoryItemSchema = {
+  description: "Get a specific memory item by key",
+  tags: ["Memory"],
+  summary: "Get Memory Item",
+  params: {
+    type: "object",
+    properties: {
+      assistantId: { type: "string", description: "Assistant ID" },
+      key: { type: "string", description: "Memory key" }
+    },
+    required: ["assistantId", "key"]
+  },
+  response: {
+    200: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        data: { type: "object" }
+      }
+    }
+  }
+};
+var setMemoryItemSchema = {
+  description: "Set or update a memory item",
+  tags: ["Memory"],
+  summary: "Set Memory Item",
+  params: {
+    type: "object",
+    properties: {
+      assistantId: { type: "string", description: "Assistant ID" },
+      key: { type: "string", description: "Memory key" }
+    },
+    required: ["assistantId", "key"]
+  },
+  body: {
+    type: "object",
+    description: "Memory item data"
+  },
+  response: {
+    200: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        data: { type: "object" }
+      }
+    }
+  }
+};
+var deleteMemoryItemSchema = {
+  description: "Delete a specific memory item",
+  tags: ["Memory"],
+  summary: "Delete Memory Item",
+  params: {
+    type: "object",
+    properties: {
+      assistantId: { type: "string", description: "Assistant ID" },
+      key: { type: "string", description: "Memory key" }
+    },
+    required: ["assistantId", "key"]
+  },
+  response: {
+    200: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" }
+      }
+    }
+  }
+};
+var clearMemorySchema = {
+  description: "Clear all memory items for an assistant",
+  tags: ["Memory"],
+  summary: "Clear Memory",
+  params: {
+    type: "object",
+    properties: {
+      assistantId: { type: "string", description: "Assistant ID" }
+    },
+    required: ["assistantId"]
+  },
+  response: {
+    200: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" }
+      }
+    }
+  }
+};
+var getAgentGraphSchema = {
+  description: "Get agent graph visualization",
+  tags: ["Graph"],
+  summary: "Get Agent Graph",
+  params: {
+    type: "object",
+    properties: {
+      assistantId: { type: "string", description: "Assistant ID" }
+    },
+    required: ["assistantId"]
+  },
+  response: {
+    200: {
+      type: "object",
+      properties: {
+        success: { type: "boolean" },
+        data: { type: "object" }
+      }
+    }
+  }
+};
+
 // src/routes/index.ts
 var registerRoutes = (app2) => {
-  app2.post("/api/runs", createRun);
+  app2.post("/api/runs", { schema: createRunSchema }, createRun);
   app2.get(
     "/api/assistants/:assistantId/:thread_id/memory",
+    { schema: getAllMemoryItemsSchema },
     getAllMemoryItems
   );
   app2.get(
     "/api/assistants/:assistantId/:thread_id/state",
+    { schema: getAgentStateSchema },
     getAgentState
   );
   app2.get(
     "/api/assistants/:assistantId/memory/:key",
+    { schema: getMemoryItemSchema },
     getMemoryItem
   );
   app2.put(
     "/api/assistants/:assistantId/memory/:key",
+    { schema: setMemoryItemSchema },
     setMemoryItem
   );
   app2.delete(
     "/api/assistants/:assistantId/memory/:key",
+    { schema: deleteMemoryItemSchema },
     deleteMemoryItem
   );
-  app2.delete("/api/assistants/:assistantId/memory", clearMemory);
-  app2.get("/api/assistants/:assistantId/graph", getAgentGraph);
+  app2.delete(
+    "/api/assistants/:assistantId/memory",
+    { schema: clearMemorySchema },
+    clearMemory
+  );
+  app2.get(
+    "/api/assistants/:assistantId/graph",
+    { schema: getAgentGraphSchema },
+    getAgentGraph
+  );
 };
 
 // src/logger/Logger.ts
@@ -616,6 +815,68 @@ var Logger = class _Logger {
   }
 };
 
+// src/swagger.ts
+var import_swagger = __toESM(require("@fastify/swagger"));
+var import_swagger_ui = __toESM(require("@fastify/swagger-ui"));
+var defaultSwaggerConfig = {
+  openapi: {
+    openapi: "3.0.0",
+    info: {
+      title: "Axiom Lattice Gateway API",
+      description: "API Gateway for LangGraph agent-based applications",
+      version: "1.0.0",
+      contact: {
+        name: "Axiom Lattice Team",
+        email: "support@axiom-lattice.com"
+      }
+    },
+    servers: [
+      {
+        url: "http://localhost:4001",
+        description: "Development environment"
+      }
+    ],
+    components: {
+      securitySchemes: {
+        bearerAuth: {
+          type: "http",
+          scheme: "bearer",
+          bearerFormat: "JWT"
+        }
+      }
+    },
+    security: [
+      {
+        bearerAuth: []
+      }
+    ],
+    tags: [
+      { name: "Runs", description: "Agent run management" },
+      { name: "Memory", description: "Agent memory management" },
+      { name: "Graph", description: "Agent graph visualization" },
+      { name: "Health", description: "System health checks" }
+    ]
+  }
+};
+var defaultSwaggerUiConfig = {
+  routePrefix: "/api-docs",
+  uiConfig: {
+    docExpansion: "full",
+    deepLinking: false
+  },
+  staticCSP: true,
+  transformStaticCSP: (header) => header
+};
+var configureSwagger = async (app2, customSwaggerConfig, customSwaggerUiConfig) => {
+  const swaggerConfig = { ...defaultSwaggerConfig, ...customSwaggerConfig };
+  const swaggerUiConfig = {
+    ...defaultSwaggerUiConfig,
+    ...customSwaggerUiConfig
+  };
+  await app2.register(import_swagger.default, swaggerConfig);
+  await app2.register(import_swagger_ui.default, swaggerUiConfig);
+};
+
 // src/index.ts
 process.on("unhandledRejection", (reason, promise) => {
   console.error("\u672A\u5904\u7406\u7684Promise\u62D2\u7EDD:", reason);
@@ -676,9 +937,9 @@ app.setErrorHandler((error, request, reply) => {
   });
 });
 app.decorate("logger", logger);
-registerRoutes(app);
 var start = async ({ port }) => {
   try {
+    registerRoutes(app);
     const target_port = port || Number(process.env.PORT) || 4001;
     await app.listen({ port: target_port, host: "0.0.0.0" });
     logger.info(`Lattice Gateway is running on port: ${port}`);
@@ -689,6 +950,7 @@ var start = async ({ port }) => {
 };
 var LatticeGateway = {
   startAsHttpEndpoint: start,
+  configureSwagger,
   app
 };
 // Annotate the CommonJS export names for ESM import in node: