@cloudbase/agent-server 0.0.13 → 0.0.14

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @cloudbase/agent-server
 
+## 1.0.1-alpha.8
+
+### Patch Changes
+
+- alpha release 0.1.2-alpha.1
+  - Update all public packages to version 0.1.2-alpha.1
+  - Trigger automated alpha release workflow
+  - Includes latest features and improvements
+
+- Updated dependencies
+  - @cloudbase/agent-shared@1.0.1-alpha.8
+
+## 1.0.1-alpha.7
+
+### Patch Changes
+
+- alpha release 0.1.2-alpha.1
+  - Update all public packages to version 0.1.2-alpha.1
+  - Trigger automated alpha release workflow
+  - Includes latest features and improvements
+
+- Updated dependencies
+  - @cloudbase/agent-shared@1.0.1-alpha.7
+
 ## 1.0.1-alpha.6
 
 ### Patch Changes

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import * as _ag_ui_client from '@ag-ui/client';
 import { AbstractAgent, RunAgentInput } from '@ag-ui/client';
 import cors from 'cors';
 import { Logger, SendMessageInput } from '@cloudbase/agent-shared';
-export { LogFn, Logger, createConsoleLogger, noopLogger } from '@cloudbase/agent-shared';
+export { LogFn, Logger, createConsoleLogger, isErrorWithCode, noopLogger } from '@cloudbase/agent-shared';
 import { Repeater } from '@repeaterjs/repeater';
 import * as _whatwg_node_server from '@whatwg-node/server';
 import { OpenAI } from 'openai';
@@ -188,4 +188,24 @@ declare function extractRequestId(headers: Headers | Record<string, string | str
  */
 declare function getOrGenerateRequestId(headers: Headers | Record<string, string | string[] | undefined>, prefix?: string): string;
 
-export { type AgentCreator, type AgentCreatorContext, index as agui, createExpressRoutes, createExpressServer, extractRequestId, generateRequestId, getOrGenerateRequestId, run };
+/**
+ * AG-Kit Error Handling
+ *
+ * Error handling follows these rules:
+ * 1. Pre-stream errors: Return JSON `{error: {code, message}, requestId}`
+ * 2. In-stream errors: Emit RunError event `{type: "RUN_ERROR", code, message}`
+ *
+ * Adapters can:
+ * - Directly emit RunError events into the stream
+ * - Throw errors with a `code` property (server extracts and converts to RunError)
+ * - Throw other errors (server uses fallback INTERNAL_ERROR code)
+ */
+declare const ErrorCode: {
+    /** Invalid request format or parameters (400) */
+    readonly INVALID_REQUEST: "INVALID_REQUEST";
+    /** Internal server error (500) */
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+};
+type ErrorCodeType = (typeof ErrorCode)[keyof typeof ErrorCode];
+
+export { type AgentCreator, type AgentCreatorContext, ErrorCode, type ErrorCodeType, index as agui, createExpressRoutes, createExpressServer, extractRequestId, generateRequestId, getOrGenerateRequestId, run };

package/dist/index.js

@@ -29,6 +29,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ErrorCode: () => ErrorCode,
   agui: () => agui_exports,
   createConsoleLogger: () => import_agent_shared2.createConsoleLogger,
   createExpressRoutes: () => createExpressRoutes,
@@ -36,6 +37,7 @@ __export(index_exports, {
   extractRequestId: () => extractRequestId,
   generateRequestId: () => generateRequestId,
   getOrGenerateRequestId: () => getOrGenerateRequestId,
+  isErrorWithCode: () => import_agent_shared3.isErrorWithCode,
   noopLogger: () => import_agent_shared2.noopLogger,
   run: () => run
 });
@@ -266,6 +268,126 @@ function getOrGenerateRequestId(headers, prefix = "req") {
   return extractRequestId(headers) || generateRequestId(prefix);
 }
 
+// src/agui/sendMessageAGUI/schemas.ts
+var import_v4 = require("zod/v4");
+var FunctionCallSchema = import_v4.z.object({
+  name: import_v4.z.string(),
+  arguments: import_v4.z.string()
+});
+var ToolCallSchema = import_v4.z.object({
+  id: import_v4.z.string(),
+  type: import_v4.z.literal("function"),
+  function: FunctionCallSchema
+});
+var ToolSchema = import_v4.z.object({
+  name: import_v4.z.string(),
+  description: import_v4.z.string(),
+  parameters: import_v4.z.any()
+});
+var TextInputContentSchema = import_v4.z.object({
+  type: import_v4.z.literal("text"),
+  text: import_v4.z.string()
+});
+var BinaryInputContentObjectSchema = import_v4.z.object({
+  type: import_v4.z.literal("binary"),
+  mimeType: import_v4.z.string(),
+  id: import_v4.z.string().optional(),
+  url: import_v4.z.string().optional(),
+  data: import_v4.z.string().optional(),
+  filename: import_v4.z.string().optional()
+});
+var ensureBinaryPayload = (value, ctx) => {
+  if (!value.id && !value.url && !value.data) {
+    ctx.addIssue({
+      code: import_v4.z.ZodIssueCode.custom,
+      message: "BinaryInputContent requires at least one of id, url, or data.",
+      path: ["id"]
+    });
+  }
+};
+var BinaryInputContentSchema = BinaryInputContentObjectSchema.superRefine((value, ctx) => {
+  ensureBinaryPayload(value, ctx);
+});
+var InputContentBaseSchema = import_v4.z.discriminatedUnion("type", [
+  TextInputContentSchema,
+  BinaryInputContentObjectSchema
+]);
+var InputContentSchema = InputContentBaseSchema.superRefine(
+  (value, ctx) => {
+    if (value.type === "binary") {
+      ensureBinaryPayload(value, ctx);
+    }
+  }
+);
+var BaseMessageSchema = import_v4.z.object({
+  id: import_v4.z.string(),
+  role: import_v4.z.string(),
+  content: import_v4.z.string().optional(),
+  name: import_v4.z.string().optional()
+});
+var DeveloperMessageSchema = BaseMessageSchema.extend({
+  role: import_v4.z.literal("developer"),
+  content: import_v4.z.string()
+});
+var SystemMessageSchema = BaseMessageSchema.extend({
+  role: import_v4.z.literal("system"),
+  content: import_v4.z.string()
+});
+var AssistantMessageSchema = BaseMessageSchema.extend({
+  role: import_v4.z.literal("assistant"),
+  content: import_v4.z.string().optional(),
+  toolCalls: import_v4.z.array(ToolCallSchema).optional()
+});
+var UserMessageSchema = BaseMessageSchema.extend({
+  role: import_v4.z.literal("user"),
+  content: import_v4.z.union([import_v4.z.string(), import_v4.z.array(InputContentSchema)])
+});
+var ToolMessageSchema = import_v4.z.object({
+  id: import_v4.z.string(),
+  content: import_v4.z.string(),
+  role: import_v4.z.literal("tool"),
+  toolCallId: import_v4.z.string(),
+  error: import_v4.z.string().optional()
+});
+var ActivityMessageSchema = import_v4.z.object({
+  id: import_v4.z.string(),
+  role: import_v4.z.literal("activity"),
+  activityType: import_v4.z.string(),
+  content: import_v4.z.record(import_v4.z.string(), import_v4.z.any())
+});
+var MessageSchema = import_v4.z.discriminatedUnion("role", [
+  DeveloperMessageSchema,
+  SystemMessageSchema,
+  AssistantMessageSchema,
+  UserMessageSchema,
+  ToolMessageSchema,
+  ActivityMessageSchema
+]);
+var ContextSchema = import_v4.z.object({
+  description: import_v4.z.string(),
+  value: import_v4.z.string()
+});
+var ServerRunAgentInputSchema = import_v4.z.object({
+  threadId: import_v4.z.string().optional(),
+  // Modified: optional instead of required
+  runId: import_v4.z.string(),
+  parentRunId: import_v4.z.string().optional(),
+  state: import_v4.z.any(),
+  messages: import_v4.z.array(MessageSchema),
+  tools: import_v4.z.array(ToolSchema),
+  context: import_v4.z.array(ContextSchema),
+  forwardedProps: import_v4.z.any()
+});
+
+// src/errors/index.ts
+var import_agent_shared3 = require("@cloudbase/agent-shared");
+var ErrorCode = {
+  /** Invalid request format or parameters (400) */
+  INVALID_REQUEST: "INVALID_REQUEST",
+  /** Internal server error (500) */
+  INTERNAL_ERROR: "INTERNAL_ERROR"
+};
+
 // src/agui/sendMessageAGUI/server.ts
 function createServerAdapter2(createAgent, options) {
   var _a;
@@ -286,7 +408,7 @@ function createServerAdapter2(createAgent, options) {
         ...rawInput,
         runId: typeof rawInput.runId === "string" && rawInput.runId ? rawInput.runId : (0, import_uuid3.v4)()
       };
-      return import_client2.RunAgentInputSchema.parse(inputWithDefaults);
+      return ServerRunAgentInputSchema.parse(inputWithDefaults);
     });
     if ("error" in inputRes) {
       const { error } = inputRes;
@@ -297,7 +419,10 @@ function createServerAdapter2(createAgent, options) {
       );
       return new Response(
         JSON.stringify({
-          error: error instanceof Error ? error.message : String(error),
+          error: {
+            code: ErrorCode.INVALID_REQUEST,
+            message: error instanceof Error ? error.message : String(error)
+          },
           requestId
         }),
         {
@@ -333,9 +458,14 @@ function createServerAdapter2(createAgent, options) {
     if ("error" in createAgentRes) {
       const { error } = createAgentRes;
       (_h = logger.error) == null ? void 0 : _h.call(logger, { err: error }, "Agent creation failed");
+      const errorCode = (0, import_agent_shared3.isErrorWithCode)(error) ? error.code : ErrorCode.INTERNAL_ERROR;
+      const errorMessage = error instanceof Error ? error.message : String(error);
       return new Response(
         JSON.stringify({
-          error: error instanceof Error ? error.message : String(error),
+          error: {
+            code: errorCode,
+            message: errorMessage
+          },
           requestId
         }),
         {
@@ -344,7 +474,10 @@ function createServerAdapter2(createAgent, options) {
         }
       );
     }
-    const events = handler2(inputRes.result, createAgentRes.result.agent);
+    const events = handler2(
+      inputRes.result,
+      createAgentRes.result.agent
+    );
     let heartbeat;
     let cleanupCalled = false;
     const safeCleanup = () => {
@@ -383,9 +516,12 @@ function createServerAdapter2(createAgent, options) {
           (_c2 = logger.info) == null ? void 0 : _c2.call(logger, { eventCount }, "Request completed");
         } catch (error) {
           (_d2 = logger.error) == null ? void 0 : _d2.call(logger, { err: error }, "Stream error");
+          const errorCode = (0, import_agent_shared3.isErrorWithCode)(error) ? error.code : ErrorCode.INTERNAL_ERROR;
+          const errorMessage = error instanceof Error ? error.message : String(error);
           const errorEvent = {
             type: import_client2.EventType.RUN_ERROR,
-            message: error instanceof Error ? error.message : String(error)
+            code: errorCode,
+            message: errorMessage
           };
           controller.enqueue(
             encoder.encode(`data: ${JSON.stringify(errorEvent)}
@@ -755,6 +891,7 @@ function isCorsOptions(cors2) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ErrorCode,
   agui,
   createConsoleLogger,
   createExpressRoutes,
@@ -762,6 +899,7 @@ function isCorsOptions(cors2) {
   extractRequestId,
   generateRequestId,
   getOrGenerateRequestId,
+  isErrorWithCode,
   noopLogger,
   run
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudbase/agent-server",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "main": "dist/index.js",
   "files": [
     "dist/",
@@ -20,13 +20,16 @@
     "express": "^5.1.0",
     "openai": "6.3.0",
     "uuid": "^10.0.0",
-    "zod": "^4.1.12",
-    "@cloudbase/agent-shared": "^0.0.13"
+    "@cloudbase/agent-shared": "^0.0.14"
+  },
+  "peerDependencies": {
+    "zod": "^3.25.0 || ^4.0.0"
   },
   "devDependencies": {
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.3",
-    "tsup": "^8.5.0"
+    "tsup": "^8.5.0",
+    "zod": "^4.0.0"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",