@aixyz/config 0.2.0 → 0.4.2

package/index.ts

@@ -5,12 +5,23 @@ 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: {
     /**
@@ -24,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) => {
@@ -57,6 +77,11 @@ const AixyzConfigSchema = z.object({
     payTo: z.string(),
     network: NetworkSchema,
   }),
+  build: z
+    .object({
+      output: z.enum(["standalone", "vercel"]).optional(),
+    })
+    .optional(),
   skills: z
     .array(
       z.object({
@@ -73,12 +98,22 @@ const AixyzConfigSchema = z.object({
     .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.
@@ -93,8 +128,11 @@ 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();
   const configPath = resolve(cwd, "aixyz.config.ts");
   const mod = require(configPath);
@@ -109,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,20 +1,15 @@
 {
   "name": "@aixyz/config",
-  "version": "0.2.0",
-  "description": "",
+  "version": "0.4.2",
+  "description": "Payment-native SDK for AI Agent",
   "keywords": [
     "ai",
+    "payments",
     "agent",
-    "a2a",
-    "mcp",
-    "x402",
-    "erc-8004",
-    "framework"
+    "aixyz"
   ],
   "homepage": "https://ai-xyz.dev",
-  "bugs": {
-    "url": "https://github.com/AgentlyHQ/aixyz/issues"
-  },
+  "bugs": "https://github.com/AgentlyHQ/aixyz/issues",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/AgentlyHQ/aixyz.git"