ai-fly 0.1.1 → 0.3.0-alpha.2

package/dist/ai-fly.js

@@ -7,27 +7,46 @@ import { match } from "ts-pattern";
 //#region src/bin.ts
 const USAGE = `ai-fly — peer-to-peer HTTP/WebSocket bridge with AI-ready presets (OpenDWeb fabric)
 
+Daemon:
+  ai-fly                       run the provider daemon (foreground; Ctrl+C stops)
+  ai-fly daemon start [--detach] [--data <dir>] [--relay <url>]... [--proxy <url|env|none>]
+  ai-fly daemon stop [--force] | info | restart [--detach] | log [--lines <n>]
+  ai-fly serve                 alias of 'daemon start'
+
 Provider:
-  ai-fly serve    [--data <dir>] [--relay <url>]...        run the provider daemon
-  ai-fly service  add|list|remove ...                      manage services
-  ai-fly group    add|set-services|list ...                  manage groups
-  ai-fly key      issue|list|revoke --group <name>         manage group keys
-  ai-fly share    --group <name> [--ttl <dur>]             mint a share link (token + key)
-  ai-fly revoke   <endpointId>                             eject a device (fabric-level)
-  ai-fly status   [provider|consumer] [--verbose]          snapshot (auto: both if present)
+  ai-fly service add <name> [--upstream <url> | --preset <id>] [--route <local>=<up>[@forms]]...
+                               [--route-pattern <match>=<template>]... [--secret <name>]
+                               [--port <n>] [--match <type>:<value>]... [--data <dir>]
+  ai-fly service list|get|remove <name> [--data <dir>]
+  ai-fly service test <name> [--form …] [--content <text>] [--model <id>] [--local-prefix /v1]
+  ai-fly group add|set-services|set-limits|list|remove ...
+  ai-fly key issue|list|revoke --group <name>
+  ai-fly secret set|list|remove ...                     (values never leave the store - no get)
+  ai-fly share --group <name> [--ttl <dur>]             mint a share link (token + key)
+  ai-fly revoke <endpointId>                            eject a device (fabric-level)
+  ai-fly presets [search] [--json]                      featured + models.dev long tail
 
 Consumer:
-  ai-fly join     <dweb1-token> [--data <dir>]             admit this device (fabric layer)
-  ai-fly key      add <sk-aifly-key> --provider <id>       bare key into an existing ring
-  ai-fly import   <aifly1-link> [--run] [--preview]        bundle link: join + keyring
-  ai-fly run      [--data <dir>] [--strict-ports]          run the local gateway
-  ai-fly ports    [--data <dir>] [<serviceId> --port <n>]  view/override mapped ports
-  ai-fly status   [provider|consumer] [--verbose]          snapshot (auto: both if present)
-  ai-fly forget   <endpointId|8-char-prefix>               drop an imported provider
+  ai-fly join <dweb1-token> [--data <dir>] [--proxy …]  admit this device (fabric layer)
+  ai-fly import <aifly1-link> [--run] [--preview] [--proxy …]  bundle link: join + keyring
+  ai-fly run [--data <dir>] [--strict-ports] [--proxy …]      run the local gateway
+  ai-fly ports [--data <dir>] [<serviceId> --port <n>]  view/override mapped ports
+  ai-fly test [--data <dir>] [--service <name>] [--form …] [--content <text>]
+                               single AI request through the local gateway
+  ai-fly key add <sk-aifly-key> --provider <id>         bare key into an existing ring
+  ai-fly forget <endpointId|8-char-prefix>              drop an imported provider
+
+Config:
+  ai-fly settings list
+  ai-fly settings set theme dark|light|system | models-dev on|off | relay <url>... | relay --default
+  ai-fly relay list|set ...                             alias of 'settings … relay'
+
+Info:
+  ai-fly status [provider|consumer] [--verbose]         snapshot (auto: both if present)
 
 Options:
   --data <dir>    storage location (tilde expanded; role-specific default)
-  --relay <url>   relay entry URL (repeatable; flag > AIFLY_RELAY env > ~/.aifly/config.json)
+  --relay <url>   relay entry URL (repeatable; flag > AIFLY_RELAY env > settings.json > ~/.aifly/config.json)
   --help, -h      show this help`;
 async function dispatch(command, rest) {
 	const providerDirExists = () => existsSync(join(homedir(), ".aifly", "provider"));
@@ -41,17 +60,17 @@ async function dispatch(command, rest) {
 	const lazy = (load) => {
 		return (argv, ctx) => load().then((m) => m.run([...argv], ctx));
 	};
-	return match(command).with("serve", () => lazy(() => import("./serve-R03mDBwd.mjs"))(rest)).with("service", () => lazy(() => import("./service-Cd4R47n4.mjs"))(rest)).with("group", () => lazy(() => import("./group-Csy9VmFb.mjs"))(rest)).with("share", () => lazy(() => import("./share-DGM2TOft.mjs"))(rest)).with("revoke", () => lazy(() => import("./revoke-CyrOzc8t.mjs"))(rest)).with("join", () => lazy(() => import("./join-E1_-Rt-7.mjs"))(rest)).with("import", () => lazy(() => import("./import-BVAFw5Tx.mjs"))(rest)).with("run", () => lazy(() => import("./run-Be8H-IRf.mjs"))(rest)).with("ports", () => lazy(() => import("./ports-BQukx7wS.mjs"))(rest)).with("forget", () => lazy(() => import("./forget-BEbNwPip.mjs"))(rest)).with("key", () => {
-		if (rest[0] === "add") return lazy(() => import("./key-Bt4EWiuO.mjs"))(rest);
-		return lazy(() => import("./key-CK77IYXp.mjs"))(rest);
+	return match(command).with("serve", () => lazy(() => import("./serve-DSBlodTF.mjs"))(rest)).with("daemon", () => lazy(() => import("./daemon-DklsEniO.mjs"))(rest)).with("presets", () => lazy(() => import("./presets-C73CAMZ6.mjs"))(rest)).with("secret", () => lazy(() => import("./secret-SA37VND5.mjs"))(rest)).with("settings", async () => (await import("./settings-DU0YqNDt.mjs")).runAsSettings(rest, {})).with("relay", async () => (await import("./settings-DU0YqNDt.mjs")).runAsRelay(rest, {})).with("test", () => lazy(() => import("./test-Bc0OKBAi.mjs"))(rest)).with("service", () => lazy(() => import("./service-B5uORhl3.mjs"))(rest)).with("group", () => lazy(() => import("./group-B96IKEDF.mjs"))(rest)).with("share", () => lazy(() => import("./share-Cug0944N.mjs"))(rest)).with("revoke", () => lazy(() => import("./revoke-CkpvK33Q.mjs"))(rest)).with("join", () => lazy(() => import("./join-DsKUAibH.mjs"))(rest)).with("import", () => lazy(() => import("./import-tilxdbTH.mjs"))(rest)).with("run", () => lazy(() => import("./run-DbPXAm6h.mjs"))(rest)).with("ports", () => lazy(() => import("./ports-rRppuBgo.mjs"))(rest)).with("forget", () => lazy(() => import("./forget-B17zGwj4.mjs"))(rest)).with("key", () => {
+		if (rest[0] === "add") return lazy(() => import("./key-CNufbB__.mjs"))(rest);
+		return lazy(() => import("./key-BiEp995L.mjs"))(rest);
 	}).with("status", async () => {
 		const [scope, ...tail] = rest;
 		const wantProvider = scope === "provider" || scope !== "consumer" && providerDirExists();
 		const wantConsumer = scope === "consumer" || scope !== "provider" && consumersRootExists();
 		const argv = scope === "provider" || scope === "consumer" ? tail : rest;
 		let code = 0;
-		if (wantProvider) code = Math.max(code, await lazy(() => import("./status-W2OS7WB6.mjs"))(argv));
-		if (wantConsumer) code = Math.max(code, await lazy(() => import("./status-DRaKNvqz.mjs"))(argv));
+		if (wantProvider) code = Math.max(code, await lazy(() => import("./status-SkNsxGnk.mjs"))(argv));
+		if (wantConsumer) code = Math.max(code, await lazy(() => import("./status-B-j454u2.mjs"))(argv));
 		if (!wantProvider && !wantConsumer) process.stdout.write("nothing to report: no provider storage and no imported consumers\n");
 		return code;
 	}).otherwise(() => {
@@ -60,12 +79,19 @@ async function dispatch(command, rest) {
 }
 async function main(argv) {
 	const first = argv[0];
-	if (first === void 0 || first === "--help" || first === "-h") {
+	if (first === "--help" || first === "-h") {
 		process.stdout.write(`${USAGE}\n`);
-		return first === void 0 ? 2 : 0;
+		return 0;
 	}
+	if (first === void 0) return dispatch("daemon", []);
 	return dispatch(first, argv.slice(1));
 }
+process.stdout?.on?.("error", (err) => {
+	if (err.code === "EPIPE") process.exit(0);
+});
+process.stderr?.on?.("error", (err) => {
+	if (err.code === "EPIPE") process.exit(0);
+});
 try {
 	const code = await main(process.argv.slice(2));
 	process.exitCode = code;

package/dist/args-CSxXW9eD.mjs

@@ -0,0 +1,69 @@
+import { n as UsageError, t as CliError } from "./errors-BGtxPkM7.mjs";
+//#region src/cli/args.ts
+function expandTilde(value, homedir) {
+	if (value === "~") return homedir;
+	if (value.startsWith("~/")) return homedir + value.slice(1);
+	return value;
+}
+/**
+* 解析带 ms|s|m|h|d 后缀的时长；裸数字按毫秒（与 opendweb-example 同规）。
+* 语法错误抛 CliError；值域检查由调用方按各选项边界执行。
+*/
+function parseDurationMs(raw, label) {
+	const m = /^([0-9]+(?:\.[0-9]+)?)(ms|s|m|h|d)?$/.exec(String(raw).trim());
+	if (!m) throw new CliError(`error: invalid ${label} value: ${raw} (expected <number>[ms|s|m|h|d])`);
+	const ms = Number(m[1]) * ({
+		ms: 1,
+		s: 1e3,
+		m: 6e4,
+		h: 36e5,
+		d: 864e5
+	}[m[2] ?? "ms"] ?? 1);
+	if (!Number.isFinite(ms) || ms > Number.MAX_SAFE_INTEGER) return Number.POSITIVE_INFINITY;
+	return ms;
+}
+function assertDurationRange(ms, minMs, maxMs, label, rangeText) {
+	if (!(ms >= minMs && ms <= maxMs)) throw new CliError(`error: ${label} out of range (${rangeText})`);
+}
+function parseArgv(argv, spec, ctx = {}) {
+	const homedir = ctx.homedir ?? "";
+	const options = {};
+	const positionals = [];
+	const known = Object.keys(spec);
+	for (let i = 0; i < argv.length; i++) {
+		const tok = argv[i];
+		if (tok === "--") {
+			for (let j = i + 1; j < argv.length; j++) positionals.push(argv[j]);
+			break;
+		}
+		if (tok.startsWith("--")) {
+			const eq = tok.indexOf("=");
+			const name = (eq >= 0 ? tok.slice(2, eq) : tok.slice(2)).trim();
+			const inlineValue = eq >= 0 ? tok.slice(eq + 1) : void 0;
+			const decl = spec[name];
+			if (!decl) throw new UsageError(`error: unknown option --${name} (known: ${known.map((k) => `--${k}`).join(", ")})`);
+			if (decl.type === "boolean") {
+				if (inlineValue !== void 0) throw new UsageError(`error: option --${name} does not take a value`);
+				options[name] = true;
+			} else {
+				let value = inlineValue;
+				if (value === void 0) {
+					if (i + 1 >= argv.length) throw new UsageError(`error: option --${name} requires a value`);
+					value = argv[++i];
+				}
+				if (decl.tilde) value = expandTilde(value, homedir);
+				if (decl.type === "multi") {
+					const list = Array.isArray(options[name]) ? options[name] : [];
+					list.push(value);
+					options[name] = list;
+				} else options[name] = value;
+			}
+		} else positionals.push(tok);
+	}
+	return {
+		options,
+		positionals
+	};
+}
+//#endregion
+export { parseArgv as n, parseDurationMs as r, assertDurationRange as t };

package/dist/common-CgxCXeTt.mjs

@@ -0,0 +1,83 @@
+import { n as resolveRelayUrls, t as loadConfig } from "./config-BlZnFqx7.mjs";
+import { n as loadSdk, t as resolveHttpProxy } from "./proxy-D7VMUVEg.mjs";
+import { t as loadSettings } from "./settings-C1Hb4zwd.mjs";
+import { homedir } from "node:os";
+//#region src/cli/commands/consumer/common.ts
+function ctxOut(ctx) {
+	return ctx.out ?? ((line) => process.stdout.write(`${line}\n`));
+}
+function ctxHomedir(ctx) {
+	return ctx.homedir ?? homedir();
+}
+/**
+* 真实 Fabric 工厂（CLI 层唯一触 SDK 的位置）：动态 import 规避 vitest worker 与
+* 原生模块的不兼容；relay 配置映射为 SDK FabricOptions.relay（custom urls），
+* 未配置时缺省走 SDK 默认（n0）。
+* 解析层级（Owner 裁决 2026-09-13：链接带来的会合点优先于环境/配置默认——
+* provider 在那个 relay 上，不拨它就永远会不了面）：逐次解析为
+* flag > ring/链接内嵌 relay（opts.relayUrls，调用侧按 ring 传入）> env > file。
+* @param linkRelayUrls aifly1. 链接内嵌 relay（import 的 join 阶段用；空 = 缺席）
+* @param proxyFlag --proxy 旗标值（url | 'env' | 'none'；缺省回落 AIFLY_PROXY env）
+*/
+async function createSdkFabricFactory(relayFlag, ctx = {}, linkRelayUrls, proxyFlag) {
+	const sdk = await loadSdk();
+	const httpProxy = resolveHttpProxy(proxyFlag);
+	let relaySettings = null;
+	try {
+		relaySettings = loadSettings(ctxHomedir(ctx)).relayUrls;
+	} catch {}
+	const toOpts = (opts) => {
+		const fabricOpts = { dataDir: opts.dataDir };
+		if (httpProxy !== void 0) fabricOpts.httpProxy = httpProxy;
+		const link = opts.relayUrls ?? linkRelayUrls;
+		const urls = resolveRelayUrls({
+			...relayFlag !== void 0 ? { flag: relayFlag } : {},
+			...link !== void 0 ? { link } : {},
+			env: process.env.AIFLY_RELAY,
+			settings: relaySettings,
+			file: loadConfig(ctxHomedir(ctx))
+		});
+		if (urls !== void 0 && urls.length > 0) fabricOpts.relay = {
+			mode: "custom",
+			urls
+		};
+		return fabricOpts;
+	};
+	return {
+		open: async (opts) => await sdk.Fabric.open(toOpts(opts)),
+		joinWithToken: async (opts, token) => await sdk.Fabric.joinWithToken(toOpts(opts), token)
+	};
+}
+/** 等待 SIGINT/SIGTERM（run / import --run 长驻阻塞；测试不触达）。 */
+function waitForSignals() {
+	return new Promise((resolve) => {
+		let done = false;
+		const finish = () => {
+			if (done) return;
+			done = true;
+			process.off("SIGINT", finish);
+			process.off("SIGTERM", finish);
+			resolve();
+		};
+		process.on("SIGINT", finish);
+		process.on("SIGTERM", finish);
+	});
+}
+/** 打印引擎监听清单（run 启动横幅与 status 共用）。 */
+function printListeners(out, info) {
+	if (info.length === 0) {
+		out("local endpoints: (none - no authorized services yet)");
+		return;
+	}
+	out("local endpoints:");
+	for (const l of info) {
+		const note = l.autoAssigned ? `  [NOTICE: requested ${l.requested} was unavailable]` : "";
+		out(`  127.0.0.1:${l.port}  <-  ${l.alias} / ${l.name}  [${l.serviceId}]${note}`);
+	}
+}
+/** 引擎所需钥环集合加载（run/import --run/status 共用）。 */
+function ringsForRun(rings) {
+	return rings.filter((r) => r.keys.length > 0 || r.services.length > 0);
+}
+//#endregion
+export { ringsForRun as a, printListeners as i, ctxHomedir as n, waitForSignals as o, ctxOut as r, createSdkFabricFactory as t };

package/dist/common-CqxqIg6D.mjs

@@ -0,0 +1,86 @@
+import { n as UsageError } from "./errors-BGtxPkM7.mjs";
+import { n as resolveRelayUrls, t as loadConfig } from "./config-BlZnFqx7.mjs";
+import { t as ProviderStore } from "./store-CrTUwskE.mjs";
+import { t as loadSettings } from "./settings-C1Hb4zwd.mjs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+//#region src/cli/commands/provider/common.ts
+function resolveDataDir(flag, home = homedir()) {
+	if (flag === void 0 || flag === "") return join(home, ".aifly", "provider");
+	return flag;
+}
+/** relay 解析（flag > AIFLY_RELAY env > config file）；exactOptionalPropertyTypes 安全组装。 */
+function resolvedRelayUrls(options, home) {
+	const input = {};
+	try {
+		input.settings = loadSettings(home).relayUrls;
+	} catch {}
+	if (Array.isArray(options.relay)) input.flag = options.relay;
+	const env = process.env.AIFLY_RELAY;
+	if (env !== void 0) input.env = env;
+	input.file = loadConfig(home);
+	return resolveRelayUrls(input);
+}
+function str(value) {
+	if (typeof value === "string") return value;
+}
+function multi(value) {
+	if (Array.isArray(value)) return value;
+	if (typeof value === "string") return [value];
+	return [];
+}
+function requireString(value, label) {
+	if (value === void 0 || value === "") throw new UsageError(`error: missing required option --${label}`);
+	return value;
+}
+function parsePositiveInt(raw, label) {
+	const n = Number(raw);
+	if (!Number.isInteger(n) || n < 1 || n > Number.MAX_SAFE_INTEGER) throw new UsageError(`error: invalid ${label} value: ${raw} (expected a positive integer)`);
+	return n;
+}
+function parsePortNumber(raw, label) {
+	const n = parsePositiveInt(raw, label);
+	if (n > 65535) throw new UsageError(`error: invalid ${label} value: ${raw} (expected 1..65535)`);
+	return n;
+}
+/** "type:value"（value 为剩余整体；type in exact|suffix|regex）。 */
+function parseMatchSpec(raw) {
+	const idx = raw.indexOf(":");
+	if (idx <= 0) throw new UsageError(`error: invalid --match value: ${raw} (expected <exact|suffix|regex>:<value>)`);
+	const type = raw.slice(0, idx);
+	const value = raw.slice(idx + 1);
+	if (type !== "exact" && type !== "suffix" && type !== "regex") throw new UsageError(`error: invalid --match type: ${type} (expected exact|suffix|regex)`);
+	if (value === "") throw new UsageError(`error: invalid --match value: ${raw} (value must not be empty)`);
+	return {
+		type,
+		value
+	};
+}
+/** "Name=value"（首个 = 分割；Name 小写化）。 */
+function parseHeaderSetSpec(raw) {
+	const idx = raw.indexOf("=");
+	if (idx <= 0) throw new UsageError(`error: invalid --header-set value: ${raw} (expected <name>=<value>, value may be $env:VAR)`);
+	return {
+		name: raw.slice(0, idx).trim().toLowerCase(),
+		value: raw.slice(idx + 1)
+	};
+}
+/** 各命令的 rewrite 组装（仅在存在任一重写选项时构造）。 */
+function buildRewrite(input) {
+	const rewrite = {};
+	if (input.host !== void 0) rewrite.hostHeader = input.host;
+	if (input.strip !== void 0) rewrite.pathPrefixStrip = input.strip;
+	if (input.append !== void 0) rewrite.pathPrefixAppend = input.append;
+	if (input.headerSet.length > 0) {
+		const headerSet = {};
+		for (const h of input.headerSet) headerSet[h.name] = h.value;
+		rewrite.headerSet = headerSet;
+	}
+	if (input.headerRemove.length > 0) rewrite.headerRemove = input.headerRemove;
+	return Object.keys(rewrite).length === 0 ? void 0 : rewrite;
+}
+function openStore(dataDir) {
+	return ProviderStore.open(dataDir);
+}
+//#endregion
+export { parseMatchSpec as a, requireString as c, str as d, parseHeaderSetSpec as i, resolveDataDir as l, multi as n, parsePortNumber as o, openStore as r, parsePositiveInt as s, buildRewrite as t, resolvedRelayUrls as u };

package/dist/config-BlZnFqx7.mjs

@@ -0,0 +1,59 @@
+import { t as CliError } from "./errors-BGtxPkM7.mjs";
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { z } from "zod";
+//#region src/cli/config.ts
+const configFileSchema = z.object({ 
+/** relay 入口 URL 列表（自托管 gateway 地址，如 http://192.168.2.13:8787） */
+relayUrls: z.array(z.string().url()).optional() });
+function configDir(base = homedir()) {
+	return join(base, ".aifly");
+}
+function configPath(base = homedir()) {
+	return join(configDir(base), "config.json");
+}
+/** 读取并校验配置文件；不存在返回 {}；损坏/非法时抛 CliError（不静默重置）。 */
+function loadConfig(base = homedir()) {
+	const p = configPath(base);
+	if (!existsSync(p)) return {};
+	let raw;
+	try {
+		raw = readFileSync(p, "utf8");
+	} catch (err) {
+		throw new CliError(`error: cannot read config ${p}: ${err.message}`);
+	}
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		throw new CliError(`error: config ${p} is not valid JSON (fix or remove it manually)`);
+	}
+	const result = configFileSchema.safeParse(parsed);
+	if (!result.success) throw new CliError(`error: config ${p} failed validation: ${result.error.message}`);
+	return result.data;
+}
+/**
+* 解析生效的 relay 入口：flag > 链接内嵌（import 消费侧）> env(AIFLY_RELAY，逗号
+* 分隔) > config file。返回 undefined 表示走 SDK 默认（n0 公共 relay）。
+* 链接层级的语义：aifly1. 链接内嵌的 relayUrls 是提供方签发 invite 的入口——
+* 兑换与后续连接都必须发生在同一 relay 网，故高于机器级 env/config（2026-09-09
+* 实机踩坑：不带 --relay 时落 SDK 公网默认，兑换成功但连接永败且无提示）。
+*/
+function resolveRelayUrls(input) {
+	const fromFlag = input.flag?.filter((u) => u.length > 0);
+	if (fromFlag && fromFlag.length > 0) return [...fromFlag];
+	const fromLink = input.link?.filter((u) => u.length > 0);
+	if (fromLink && fromLink.length > 0) return [...fromLink];
+	const envRaw = input.env?.trim();
+	if (envRaw) {
+		const urls = envRaw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+		if (urls.length > 0) return urls;
+	}
+	const fromSettings = input.settings?.filter((u) => u.length > 0);
+	if (fromSettings && fromSettings.length > 0) return [...fromSettings];
+	const fromFile = input.file?.relayUrls;
+	if (fromFile && fromFile.length > 0) return [...fromFile];
+}
+//#endregion
+export { resolveRelayUrls as n, loadConfig as t };