@aixyz/config 0.1.2 → 0.2.4

package/index.ts

@@ -1,17 +1,27 @@
 import { resolve } from "path";
-import { loadEnvConfig } from "@next/env";
 
 import { z } from "zod";
 
 export type Network = `${string}:${string}`;
 
 export type AixyzConfig = {
+  /**
+   * The name of the agent will be used in the agent card.
+   */
   name: string;
+  /**
+   * A short description of the agent.
+   * This will be used in the agent card.
+   */
   description: string;
   /**
    * Version of the agent.
    */
   version: string;
+  /**
+   * The URL of the agent, required for canonical urls.
+   * Defaults to `process.env.VERCEL_URL` for Vercel deployments.
+   */
   url?: string;
   x402: {
     /**
@@ -25,7 +35,16 @@ export type AixyzConfig = {
      */
     network: string;
   };
-  skills: GetAixyzConfig["skills"];
+  build?: {
+    /**
+     * Output format for `aixyz build`.
+     * - `"standalone"`: Bundles into a single executable file (default).
+     * - `"vercel"`: Generates Vercel Build Output API v3 structure.
+     * Overrides the `VERCEL=1` environment variable, but is overridden by the `--output` CLI flag.
+     */
+    output?: "standalone" | "vercel";
+  };
+  skills?: InferredAixyzConfig["skills"];
 };
 
 const NetworkSchema = z.custom<Network>((val) => {
@@ -58,26 +77,43 @@ const AixyzConfigSchema = z.object({
     payTo: z.string(),
     network: NetworkSchema,
   }),
-  skills: z.array(
-    z.object({
-      id: z.string().nonempty(),
-      name: z.string().nonempty(),
-      description: z.string().nonempty(),
-      tags: z.array(z.string()),
-      examples: z.array(z.string()).optional(),
-      inputModes: z.array(z.string()).optional(),
-      outputModes: z.array(z.string()).optional(),
-      security: z.array(z.record(z.string(), z.array(z.string()))).optional(),
-    }),
-  ),
+  build: z
+    .object({
+      output: z.enum(["standalone", "vercel"]).optional(),
+    })
+    .optional(),
+  skills: z
+    .array(
+      z.object({
+        id: z.string().nonempty(),
+        name: z.string().nonempty(),
+        description: z.string().nonempty(),
+        tags: z.array(z.string()),
+        examples: z.array(z.string()).optional(),
+        inputModes: z.array(z.string()).optional(),
+        outputModes: z.array(z.string()).optional(),
+        security: z.array(z.record(z.string(), z.array(z.string()))).optional(),
+      }),
+    )
+    .default([]),
 });
 
+type InferredAixyzConfig = z.infer<typeof AixyzConfigSchema>;
+
 /**
+ * Subset of `AixyzConfig` that is expose and materialized at runtime.
+ *
  * This is the materialized config object that is cached for performance.
  * It is the result of parsing and validating the user's `aixyz.config.ts` file,
  * with environment variables loaded and applied.
  */
-export type GetAixyzConfig = z.infer<typeof AixyzConfigSchema>;
+export type AixyzConfigRuntime = {
+  name: AixyzConfig["name"];
+  description: AixyzConfig["description"];
+  version: AixyzConfig["version"];
+  url: AixyzConfig["url"];
+  skills: NonNullable<AixyzConfig["skills"]>;
+};
 
 /**
  * Environment variables are looked up in the following places, in order, stopping once the variable is found.
@@ -92,11 +128,12 @@ export type GetAixyzConfig = z.infer<typeof AixyzConfigSchema>;
  *
  * In production:
  * This is a materialized config object that is cached for performance.
+ *
+ * @deprecated Use `getAixyzConfigRuntime()` instead, which is designed for runtime use.
+ * This will be deprecated in the next major version—when we materialize the config for downstream.
  */
-export function getAixyzConfig(): GetAixyzConfig {
+export function getAixyzConfig(): InferredAixyzConfig {
   const cwd = process.cwd();
-  loadEnvConfig(cwd);
-
   const configPath = resolve(cwd, "aixyz.config.ts");
   const mod = require(configPath);
   const config = mod.default;
@@ -110,5 +147,21 @@ export function getAixyzConfig(): GetAixyzConfig {
     throw new Error(`aixyz.config.ts: ${parsedConfig.error}`);
   }
 
-  return parsedConfig.data as GetAixyzConfig;
+  return parsedConfig.data as InferredAixyzConfig;
+}
+
+/**
+ * Returns the subset of `aixyz.config.ts` that is safe to expose at runtime.
+ * Unlike `getAixyzConfig()`, which is intended for the build/CLI phase only,
+ * this function is designed to be available in the deployed runtime bundle.
+ */
+export function getAixyzConfigRuntime(): AixyzConfigRuntime {
+  const config = getAixyzConfig();
+  return {
+    name: config.name,
+    description: config.description,
+    version: config.version,
+    url: config.url,
+    skills: config.skills,
+  };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aixyz/config",
-  "version": "0.1.2",
+  "version": "0.2.4",
   "description": "",
   "keywords": [
     "ai",
@@ -26,7 +26,6 @@
     "**/*.ts"
   ],
   "dependencies": {
-    "@next/env": "^16.1.6",
-    "zod": "^4.3.6"
+    "zod": "^4"
   }
 }