@amaster.ai/runtime-cli 1.1.27 → 1.1.29

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { createAmasterClient, resolveAppCode } from './cli.cjs';
+export { createAmasterClient, resolveAppCode, resolveInitBaseURL } from './cli.cjs';
 import '@amaster.ai/client';
 
 interface AmasterConfig {
@@ -40,9 +40,20 @@ interface SkillManifest {
 
 interface AppConfig {
     baseURL: string;
+    registry?: string;
+    registryBaseURL?: string;
     ossEndpoint?: string;
     initializedAt: string;
 }
+interface RegistryConfig {
+    baseURL: string;
+    createdAt: string;
+}
+interface ResolvedRegistry {
+    name: string;
+    baseURL: string;
+    builtin: boolean;
+}
 interface AuthSession {
     accessToken: string;
     refreshToken?: string;
@@ -57,6 +68,8 @@ interface AuthSession {
 interface RuntimeConfig {
     apps: Record<string, AppConfig>;
     currentApp?: string;
+    registries?: Record<string, RegistryConfig>;
+    currentRegistry?: string;
 }
 declare function getConfig(): RuntimeConfig;
 declare function saveConfig(config: RuntimeConfig): void;
@@ -66,6 +79,15 @@ declare function removeApp(appCode: string): void;
 declare function setCurrentApp(appCode: string): boolean;
 declare function getCurrentApp(): string | null;
 declare function listApps(): string[];
+declare function listRegistries(): ResolvedRegistry[];
+declare function getCurrentRegistry(): string;
+declare function setCurrentRegistry(registryRef: string): ResolvedRegistry;
+declare function getRegistryConfig(name: string): RegistryConfig | null;
+declare function ensureRegistry(registryRef: string): ResolvedRegistry;
+declare function resolveRegistry(registryRef?: string): ResolvedRegistry;
+declare function normalizeRegistryBaseURL(value: string): string;
+declare function resolveAppBaseURL(appCode: string, registryRef?: string): string;
+declare function inferRegistryBaseURLFromAppBaseURL(appBaseURL: string, appCode?: string): string;
 declare function getBaseURL(appCode?: string): string | null;
 declare function getAuthSession(appCode: string): AuthSession | null;
 declare function saveAuthSession(appCode: string, session: AuthSession): void;
@@ -74,4 +96,4 @@ declare function isAuthenticated(appCode: string): boolean;
 declare function getAccessToken(appCode: string): string | null;
 declare function shouldRefreshToken(appCode: string): boolean;
 
-export { type AmasterConfig, type AppConfig, type AuthSession, type McpServerConfig, type OpenClawConfig, type RuntimeConfig, type SkillManifest, addApp, clearAuthSession, getAccessToken, getAppConfig, getAuthSession, getBaseURL, getConfig, getCurrentApp, isAuthenticated, listApps, removeApp, saveAuthSession, saveConfig, setCurrentApp, shouldRefreshToken };
+export { type AmasterConfig, type AppConfig, type AuthSession, type McpServerConfig, type OpenClawConfig, type RegistryConfig, type ResolvedRegistry, type RuntimeConfig, type SkillManifest, addApp, clearAuthSession, ensureRegistry, getAccessToken, getAppConfig, getAuthSession, getBaseURL, getConfig, getCurrentApp, getCurrentRegistry, getRegistryConfig, inferRegistryBaseURLFromAppBaseURL, isAuthenticated, listApps, listRegistries, normalizeRegistryBaseURL, removeApp, resolveAppBaseURL, resolveRegistry, saveAuthSession, saveConfig, setCurrentApp, setCurrentRegistry, shouldRefreshToken };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { createAmasterClient, resolveAppCode } from './cli.js';
+export { createAmasterClient, resolveAppCode, resolveInitBaseURL } from './cli.js';
 import '@amaster.ai/client';
 
 interface AmasterConfig {
@@ -40,9 +40,20 @@ interface SkillManifest {
 
 interface AppConfig {
     baseURL: string;
+    registry?: string;
+    registryBaseURL?: string;
     ossEndpoint?: string;
     initializedAt: string;
 }
+interface RegistryConfig {
+    baseURL: string;
+    createdAt: string;
+}
+interface ResolvedRegistry {
+    name: string;
+    baseURL: string;
+    builtin: boolean;
+}
 interface AuthSession {
     accessToken: string;
     refreshToken?: string;
@@ -57,6 +68,8 @@ interface AuthSession {
 interface RuntimeConfig {
     apps: Record<string, AppConfig>;
     currentApp?: string;
+    registries?: Record<string, RegistryConfig>;
+    currentRegistry?: string;
 }
 declare function getConfig(): RuntimeConfig;
 declare function saveConfig(config: RuntimeConfig): void;
@@ -66,6 +79,15 @@ declare function removeApp(appCode: string): void;
 declare function setCurrentApp(appCode: string): boolean;
 declare function getCurrentApp(): string | null;
 declare function listApps(): string[];
+declare function listRegistries(): ResolvedRegistry[];
+declare function getCurrentRegistry(): string;
+declare function setCurrentRegistry(registryRef: string): ResolvedRegistry;
+declare function getRegistryConfig(name: string): RegistryConfig | null;
+declare function ensureRegistry(registryRef: string): ResolvedRegistry;
+declare function resolveRegistry(registryRef?: string): ResolvedRegistry;
+declare function normalizeRegistryBaseURL(value: string): string;
+declare function resolveAppBaseURL(appCode: string, registryRef?: string): string;
+declare function inferRegistryBaseURLFromAppBaseURL(appBaseURL: string, appCode?: string): string;
 declare function getBaseURL(appCode?: string): string | null;
 declare function getAuthSession(appCode: string): AuthSession | null;
 declare function saveAuthSession(appCode: string, session: AuthSession): void;
@@ -74,4 +96,4 @@ declare function isAuthenticated(appCode: string): boolean;
 declare function getAccessToken(appCode: string): string | null;
 declare function shouldRefreshToken(appCode: string): boolean;
 
-export { type AmasterConfig, type AppConfig, type AuthSession, type McpServerConfig, type OpenClawConfig, type RuntimeConfig, type SkillManifest, addApp, clearAuthSession, getAccessToken, getAppConfig, getAuthSession, getBaseURL, getConfig, getCurrentApp, isAuthenticated, listApps, removeApp, saveAuthSession, saveConfig, setCurrentApp, shouldRefreshToken };
+export { type AmasterConfig, type AppConfig, type AuthSession, type McpServerConfig, type OpenClawConfig, type RegistryConfig, type ResolvedRegistry, type RuntimeConfig, type SkillManifest, addApp, clearAuthSession, ensureRegistry, getAccessToken, getAppConfig, getAuthSession, getBaseURL, getConfig, getCurrentApp, getCurrentRegistry, getRegistryConfig, inferRegistryBaseURLFromAppBaseURL, isAuthenticated, listApps, listRegistries, normalizeRegistryBaseURL, removeApp, resolveAppBaseURL, resolveRegistry, saveAuthSession, saveConfig, setCurrentApp, setCurrentRegistry, shouldRefreshToken };

package/dist/index.js

@@ -24,18 +24,27 @@ var config_exports = {};
 __export(config_exports, {
   addApp: () => addApp,
   clearAuthSession: () => clearAuthSession,
+  ensureRegistry: () => ensureRegistry,
   getAccessToken: () => getAccessToken,
   getAppConfig: () => getAppConfig,
   getAuthSession: () => getAuthSession,
   getBaseURL: () => getBaseURL,
   getConfig: () => getConfig,
   getCurrentApp: () => getCurrentApp,
+  getCurrentRegistry: () => getCurrentRegistry,
+  getRegistryConfig: () => getRegistryConfig,
+  inferRegistryBaseURLFromAppBaseURL: () => inferRegistryBaseURLFromAppBaseURL,
   isAuthenticated: () => isAuthenticated,
   listApps: () => listApps,
+  listRegistries: () => listRegistries,
+  normalizeRegistryBaseURL: () => normalizeRegistryBaseURL,
   removeApp: () => removeApp,
+  resolveAppBaseURL: () => resolveAppBaseURL,
+  resolveRegistry: () => resolveRegistry,
   saveAuthSession: () => saveAuthSession,
   saveConfig: () => saveConfig,
   setCurrentApp: () => setCurrentApp,
+  setCurrentRegistry: () => setCurrentRegistry,
   shouldRefreshToken: () => shouldRefreshToken
 });
 function getConfig() {
@@ -98,6 +107,137 @@ function listApps() {
   const config = getConfig();
   return Object.keys(config.apps);
 }
+function listRegistries() {
+  const config = getConfig();
+  const currentRegistry = config.currentRegistry || DEFAULT_REGISTRY_NAME;
+  const registryMap = /* @__PURE__ */ new Map();
+  for (const [name, baseURL] of Object.entries(BUILTIN_REGISTRY_DEFINITIONS)) {
+    registryMap.set(name, {
+      name,
+      baseURL,
+      builtin: true
+    });
+  }
+  for (const [name, registry] of Object.entries(config.registries || {})) {
+    registryMap.set(name, {
+      name,
+      baseURL: registry.baseURL,
+      builtin: false
+    });
+  }
+  const registries = Array.from(registryMap.values()).sort((left, right) => left.name.localeCompare(right.name));
+  const currentResolved = resolveRegistry(currentRegistry);
+  return registries.map((registry) => ({
+    ...registry,
+    name: registry.name === currentResolved.name ? registry.name : registry.name
+  }));
+}
+function getCurrentRegistry() {
+  const config = getConfig();
+  return config.currentRegistry || DEFAULT_REGISTRY_NAME;
+}
+function setCurrentRegistry(registryRef) {
+  const resolved = ensureRegistry(registryRef);
+  const config = getConfig();
+  config.currentRegistry = resolved.name;
+  saveConfig(config);
+  return resolved;
+}
+function getRegistryConfig(name) {
+  const config = getConfig();
+  return config.registries?.[name] || null;
+}
+function ensureRegistry(registryRef) {
+  const normalizedRef = registryRef.trim();
+  if (!normalizedRef) {
+    throw new Error("Registry cannot be empty");
+  }
+  const builtinBaseURL = BUILTIN_REGISTRY_DEFINITIONS[normalizedRef];
+  if (builtinBaseURL) {
+    return {
+      name: normalizedRef,
+      baseURL: builtinBaseURL,
+      builtin: true
+    };
+  }
+  const config = getConfig();
+  const existing = config.registries?.[normalizedRef];
+  if (existing) {
+    return {
+      name: normalizedRef,
+      baseURL: existing.baseURL,
+      builtin: false
+    };
+  }
+  const normalizedBaseURL = normalizeRegistryBaseURL(normalizedRef);
+  for (const [name, baseURL] of Object.entries(BUILTIN_REGISTRY_DEFINITIONS)) {
+    if (normalizeRegistryBaseURL(baseURL) === normalizedBaseURL) {
+      return {
+        name,
+        baseURL,
+        builtin: true
+      };
+    }
+  }
+  const inferredName = inferRegistryName(normalizedBaseURL);
+  const current = config.registries?.[inferredName];
+  const nextRegistry = {
+    baseURL: normalizedBaseURL,
+    createdAt: current?.createdAt || (/* @__PURE__ */ new Date()).toISOString()
+  };
+  config.registries = {
+    ...config.registries || {},
+    [inferredName]: nextRegistry
+  };
+  saveConfig(config);
+  return {
+    name: inferredName,
+    baseURL: normalizedBaseURL,
+    builtin: false
+  };
+}
+function resolveRegistry(registryRef) {
+  return ensureRegistry(registryRef || getCurrentRegistry());
+}
+function normalizeRegistryBaseURL(value) {
+  const trimmed = value.trim();
+  if (!trimmed) {
+    throw new Error("Registry cannot be empty");
+  }
+  const withProtocol = /^https?:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`;
+  const parsed = new URL(withProtocol);
+  if (parsed.username || parsed.password || parsed.search || parsed.hash) {
+    throw new Error(`Unsupported registry URL: ${value}`);
+  }
+  if (parsed.pathname && parsed.pathname !== "/") {
+    throw new Error(`Registry URL must not include a path: ${value}`);
+  }
+  parsed.pathname = "";
+  return parsed.toString().replace(/\/$/, "");
+}
+function resolveAppBaseURL(appCode, registryRef) {
+  const resolved = resolveRegistry(registryRef);
+  const registryUrl = new URL(resolved.baseURL);
+  if (isLocalLikeHost(registryUrl.hostname)) {
+    throw new Error(`Cannot infer app URL from registry ${resolved.baseURL}; please pass --url explicitly`);
+  }
+  return `${registryUrl.protocol}//${appCode}.${registryUrl.host}`;
+}
+function inferRegistryBaseURLFromAppBaseURL(appBaseURL, appCode) {
+  const parsed = new URL(appBaseURL);
+  const hostnameParts = parsed.hostname.split(".");
+  if (hostnameParts.length <= 2 || isLocalLikeHost(parsed.hostname)) {
+    parsed.pathname = "";
+    return parsed.toString().replace(/\/$/, "");
+  }
+  if (appCode && parsed.hostname.startsWith(`${appCode}.`)) {
+    parsed.hostname = parsed.hostname.slice(appCode.length + 1);
+  } else {
+    parsed.hostname = hostnameParts.slice(1).join(".");
+  }
+  parsed.pathname = "";
+  return parsed.toString().replace(/\/$/, "");
+}
 function getBaseURL(appCode) {
   const code = appCode || getCurrentApp();
   if (!code) return null;
@@ -152,11 +292,29 @@ function shouldRefreshToken(appCode) {
   const fiveMinutes = 5 * 60 * 1e3;
   return expiresAt.getTime() - now.getTime() < fiveMinutes;
 }
-var AMASTER_CONFIG_DIR, CONFIG_FILE;
+function inferRegistryName(baseURL) {
+  const parsed = new URL(baseURL);
+  return parsed.hostname.replace(/\./g, "-");
+}
+function isLocalLikeHost(hostname) {
+  if (hostname === "localhost") {
+    return true;
+  }
+  if (/^\d{1,3}(\.\d{1,3}){3}$/.test(hostname)) {
+    return true;
+  }
+  return false;
+}
+var AMASTER_CONFIG_DIR, CONFIG_FILE, DEFAULT_REGISTRY_NAME, BUILTIN_REGISTRY_DEFINITIONS;
 var init_config = __esm({
   "src/config.ts"() {
     AMASTER_CONFIG_DIR = join(homedir(), ".amaster");
     CONFIG_FILE = join(AMASTER_CONFIG_DIR, "config.json");
+    DEFAULT_REGISTRY_NAME = "helige";
+    BUILTIN_REGISTRY_DEFINITIONS = {
+      helige: "https://helige.cn",
+      "helige-int": "https://helige-int.cn"
+    };
   }
 });
 
@@ -2792,6 +2950,8 @@ async function initOpenClaw(options) {
     }
     addApp(options.appCode, {
       baseURL: options.baseURL,
+      registry: options.registry,
+      registryBaseURL: options.registryBaseURL,
       ossEndpoint,
       initializedAt: (/* @__PURE__ */ new Date()).toISOString()
     });
@@ -2805,6 +2965,8 @@ async function initOpenClaw(options) {
           {
             appCode: options.appCode,
             baseURL: options.baseURL,
+            registry: options.registry || null,
+            registryBaseURL: options.registryBaseURL || null,
             ossEndpoint,
             openClawDetected: false,
             installedSkills: 0,
@@ -2820,6 +2982,9 @@ async function initOpenClaw(options) {
       console.log(chalk4.blue("\n\u{1F4CB} Configuration:\n"));
       console.log(`  App Code: ${chalk4.green(options.appCode)}`);
       console.log(`  Base URL: ${chalk4.gray(options.baseURL)}`);
+      if (options.registryBaseURL) {
+        console.log(`  Registry: ${chalk4.gray(`${options.registry || "custom"} -> ${options.registryBaseURL}`)}`);
+      }
       console.log();
     }
     spinner.start("Downloading skills...");
@@ -2873,12 +3038,16 @@ async function initOpenClaw(options) {
       const config = getAppConfig(app);
       return {
         appCode: app,
-        baseURL: config?.baseURL || null
+        baseURL: config?.baseURL || null,
+        registry: config?.registry || null,
+        registryBaseURL: config?.registryBaseURL || null
       };
     });
     const summary = {
       appCode: options.appCode,
       baseURL: options.baseURL,
+      registry: options.registry || null,
+      registryBaseURL: options.registryBaseURL || null,
       ossEndpoint,
       openClawDetected: true,
       installedSkills,
@@ -3059,6 +3228,24 @@ function createAmasterClient(appCode) {
   }
   return client;
 }
+function resolveInitBaseURL(options) {
+  if (options.url) {
+    const resolvedRegistry2 = resolveRegistry(
+      options.registry || inferRegistryBaseURLFromAppBaseURL(options.url, options.appCode)
+    );
+    return {
+      baseURL: options.url,
+      registryName: resolvedRegistry2.name,
+      registryBaseURL: resolvedRegistry2.baseURL
+    };
+  }
+  const resolvedRegistry = resolveRegistry(options.registry);
+  return {
+    baseURL: resolveAppBaseURL(options.appCode, resolvedRegistry.name),
+    registryName: resolvedRegistry.name,
+    registryBaseURL: resolvedRegistry.baseURL
+  };
+}
 var program = new Command();
 program.name("amaster").description("CLI for Amaster SDK - Multi-app support for OpenClaw").version(resolveCliVersion());
 program.command("apps").description("List all configured apps").addOption(createFormatOption()).action((options) => {
@@ -3069,6 +3256,8 @@ program.command("apps").description("List all configured apps").addOption(create
     return {
       appCode,
       baseURL: config?.baseURL || null,
+      registry: config?.registry || null,
+      registryBaseURL: config?.registryBaseURL || null,
       authenticated: isAuthenticated(appCode),
       current: appCode === current
     };
@@ -3085,6 +3274,9 @@ program.command("apps").description("List all configured apps").addOption(create
           const prefix = app.current ? chalk4.green("\u2192 ") : "  ";
           console.log(`${prefix}${chalk4.bold(app.appCode)}${app.current ? chalk4.green(" (current)") : ""}`);
           console.log(`     ${chalk4.gray(app.baseURL || "No URL")}`);
+          if (app.registryBaseURL) {
+            console.log(`     ${chalk4.gray(`registry: ${app.registry} -> ${app.registryBaseURL}`)}`);
+          }
           console.log(
             `     ${app.authenticated ? chalk4.green("\u25CF Authenticated") : chalk4.yellow("\u25CB Not authenticated")}`
           );
@@ -3095,6 +3287,45 @@ program.command("apps").description("List all configured apps").addOption(create
     }
   });
 });
+var registryCmd = program.command("registry").description("Manage addon and app registries");
+registryCmd.command("list").alias("ls").description("List available registries").addOption(createFormatOption()).action((options) => {
+  const currentRegistry = getCurrentRegistry();
+  const registries = listRegistries().map((registry) => ({
+    ...registry,
+    current: registry.name === currentRegistry
+  }));
+  renderOutput(registries, {
+    format: options.format,
+    pretty: () => {
+      console.log(chalk4.blue("\n\u{1F310} Registries\n"));
+      for (const registry of registries) {
+        const prefix = registry.current ? chalk4.green("\u2192 ") : "  ";
+        const builtin = registry.builtin ? chalk4.gray("builtin") : chalk4.gray("custom");
+        console.log(`${prefix}${chalk4.bold(registry.name)}${registry.current ? chalk4.green(" (current)") : ""}`);
+        console.log(`     ${chalk4.gray(registry.baseURL)}  ${builtin}`);
+      }
+      console.log();
+    }
+  });
+});
+registryCmd.command("use <registry>").description("Set the default registry by name or URL").addOption(createFormatOption()).action((registry, options) => {
+  const resolved = setCurrentRegistry(registry);
+  renderOutput(
+    {
+      name: resolved.name,
+      baseURL: resolved.baseURL,
+      builtin: resolved.builtin,
+      current: true
+    },
+    {
+      format: options.format,
+      pretty: () => {
+        console.log(chalk4.green(`\u2705 Now using registry: ${resolved.name}`));
+        console.log(chalk4.gray(resolved.baseURL));
+      }
+    }
+  );
+});
 program.command("use <app-code>").description("Set the default app for subsequent commands").addOption(createFormatOption()).action((appCode, options) => {
   if (setCurrentApp(appCode)) {
     renderOutput(
@@ -3114,10 +3345,17 @@ program.command("use <app-code>").description("Set the default app for subsequen
     process.exit(1);
   }
 });
-program.command("init").description("Initialize an app for OpenClaw integration").requiredOption("--app-code <code>", "Application code (e.g., fhv94bto1)").requiredOption("--url <url>", "Base URL (e.g., https://fhv94bto1.helige.cn)").option("--api-key <key>", "API Key for OSS access").option("--oss-endpoint <endpoint>", "OSS endpoint").option("--force", "Reinitialize an existing app").addOption(createFormatOption()).action(async (options) => {
+program.command("init").description("Initialize an app for OpenClaw integration").requiredOption("--app-code <code>", "Application code (e.g., fhv94bto1)").option("--url <url>", "Base URL (e.g., https://fhv94bto1.helige.cn)").option("--registry <registry>", "Registry name or URL (default: current registry)").option("--api-key <key>", "API Key for OSS access").option("--oss-endpoint <endpoint>", "OSS endpoint").option("--force", "Reinitialize an existing app").addOption(createFormatOption()).action(async (options) => {
+  const resolvedInit = resolveInitBaseURL({
+    appCode: options.appCode,
+    url: options.url,
+    registry: options.registry
+  });
   await initOpenClaw({
     appCode: options.appCode,
-    baseURL: options.url,
+    baseURL: resolvedInit.baseURL,
+    registry: resolvedInit.registryName,
+    registryBaseURL: resolvedInit.registryBaseURL,
     apiKey: options.apiKey,
     ossEndpoint: options.ossEndpoint,
     force: options.force,
@@ -3671,6 +3909,6 @@ if (isDirectCliExecution()) {
   );
 }
 
-export { addApp, clearAuthSession, createAmasterClient, getAccessToken, getAppConfig, getAuthSession, getBaseURL, getConfig, getCurrentApp, isAuthenticated, listApps, removeApp, resolveAppCode, saveAuthSession, saveConfig, setCurrentApp, shouldRefreshToken };
+export { addApp, clearAuthSession, createAmasterClient, ensureRegistry, getAccessToken, getAppConfig, getAuthSession, getBaseURL, getConfig, getCurrentApp, getCurrentRegistry, getRegistryConfig, inferRegistryBaseURLFromAppBaseURL, isAuthenticated, listApps, listRegistries, normalizeRegistryBaseURL, removeApp, resolveAppBaseURL, resolveAppCode, resolveInitBaseURL, resolveRegistry, saveAuthSession, saveConfig, setCurrentApp, setCurrentRegistry, shouldRefreshToken };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map