@flowy-agent-store/sdk 0.1.0-beta.8 → 0.1.0-beta.9

package/README.md

@@ -65,9 +65,13 @@ result.danglingSkills;       // 声明了但本机取不到的技能：{ id, err
   expert-pack.json           # 线上 pack 逐字节
   persona.md                 # 仅 agent 形态（团没有自己的 persona）
   members/<id>/persona.md    # 仅 team 形态，每个成员一个
-  skills/<name>/…            # 成员声明去重后的技能字节
+  skills/<name>/…            # 团包级技能与成员声明合并去重后的技能字节
 ```
 
+团的技能有**两个来源**，`materializePack` 把两者合并后按 id 去重：顶层 `pack.skills`（该团**包级**声明、
+装机时已物化到托管技能根目录的技能）与 `team.members[].skills`（各成员 frontmatter 的 `skills:` 声明）。
+官方团大多**只在包级声明**技能（例如 `stock-partner-team`：包级 3 个、7 名成员零声明），所以两者都要算进来。
+
 错误语义：wire 导出失败（`agent_not_installed` / `agent_disabled` / `policy_denied` /
 `version_mismatch` / `response_too_large`…）**先于任何写盘**，不留半成品目录；`skill/files`
 失败进 `danglingSkills` 并继续；`skill/file` 在列文件成功后失败则**抛出**——那是宿主 I/O 错误，

package/dist/index.cjs

@@ -210,11 +210,30 @@ const KILL_GRACE_MS = 2e3;
 function assertProtocolCompatible(runtimeVersion) {
 	if (runtimeVersion !== _flowy_agent_store_protocol.APP_SERVER_PROTOCOL_VERSION) throw new Error(`protocol version mismatch: runtime speaks ${runtimeVersion}, SDK expects ${_flowy_agent_store_protocol.APP_SERVER_PROTOCOL_VERSION}`);
 }
+/**
+* The host-policy environment the typed options above expand to.
+*
+* The spawned host cannot be handed backend CLI flags: `apps/agent-store` parses
+* its own argv (`--host` / `--port` / `--data-dir` / `--no-open`) and has no
+* `--agent-store-config`, so a flag would make clap exit before the readiness
+* line. The parent environment is therefore the only channel a launcher has —
+* the same conclusion `NOMI_LOG_LEVEL` already documents for the log filter.
+*/
+function hostPolicyEnv(options) {
+	const env = {};
+	if (options.marketDownload !== void 0) env["AGENT_STORE_MARKET_DOWNLOAD"] = options.marketDownload;
+	if (options.configPath !== void 0) env["AGENT_STORE_CONFIG"] = options.configPath;
+	return env;
+}
 async function spawnAppServer(options = {}) {
 	const bin = resolveAppServerBin(options.bin);
 	const ownedDir = options.dataDir === void 0;
 	const dataDir = ownedDir ? await (0, node_fs_promises.mkdtemp)((0, node_path.join)((0, node_os.tmpdir)(), "agent-store-sdk-")) : options.dataDir;
 	const port = options.port ?? 0;
+	const policyEnv = {
+		...hostPolicyEnv(options),
+		...options.env
+	};
 	const { child, exited } = spawnRuntimeChild(bin, [
 		"--host",
 		"127.0.0.1",
@@ -224,7 +243,11 @@ async function spawnAppServer(options = {}) {
 		dataDir,
 		"--no-open",
 		...options.extraArgs ?? []
-	], options);
+	], {
+		...Object.keys(policyEnv).length > 0 ? { env: policyEnv } : {},
+		cwd: options.cwd,
+		onExit: options.onExit
+	});
 	const stderrTail = [];
 	child.stderr?.on("data", (chunk) => {
 		for (const line of String(chunk).split(/\r?\n/)) {

package/dist/index.d.cts

@@ -116,9 +116,38 @@ interface SpawnOptions {
   port?: number;
   /** Extra CLI args appended after the managed ones. */
   extraArgs?: string[];
+  /**
+   * What the spawned host does with its default marketplace sources at boot
+   * (doc `37` §3.1). Sent as `AGENT_STORE_MARKET_DOWNLOAD`.
+   *
+   * - `"lazy"` — register the declared sources and download nothing; the
+   *   archives wait for an explicit `market/refresh` / `refreshMarketplace()`;
+   * - `"none"` — register nothing at all, so `store/list` starts empty;
+   * - `"eager"` — fetch every declared source during boot.
+   *
+   * Omitted = the host's own policy (`download_on_start` per source, default
+   * `true`, so a declared source *is* downloaded unless it says otherwise).
+   * This is a process-scoped override: nothing is written to the user's config.
+   */
+  marketDownload?: "eager" | "lazy" | "none";
+  /**
+   * Config file for this child only (doc `37` §3.1). Sent as
+   * `AGENT_STORE_CONFIG`.
+   *
+   * Without it the host reads the per-user `~/.agent-store/config.toml` — which
+   * a spawned, SDK-owned host should not have to share. The data directory is
+   * independent of this (`dataDir`, always explicit).
+   */
+  configPath?: string;
   /** How long to wait for the readiness line. Defaults to 120s (cold DB init). */
   readyTimeoutMs?: number;
-  /** Extra environment variables, merged over the parent's `process.env`. */
+  /**
+   * Extra environment variables, merged over the parent's `process.env`.
+   *
+   * An entry here **wins over the typed options above** (`marketDownload`,
+   * `configPath`): the raw map is the caller's most specific statement, and
+   * nothing this factory derives should silently overwrite it.
+   */
   env?: Record<string, string | undefined>;
   /** Working directory for the child. Defaults to the parent's cwd. */
   cwd?: string;

package/dist/index.d.mts

@@ -116,9 +116,38 @@ interface SpawnOptions {
   port?: number;
   /** Extra CLI args appended after the managed ones. */
   extraArgs?: string[];
+  /**
+   * What the spawned host does with its default marketplace sources at boot
+   * (doc `37` §3.1). Sent as `AGENT_STORE_MARKET_DOWNLOAD`.
+   *
+   * - `"lazy"` — register the declared sources and download nothing; the
+   *   archives wait for an explicit `market/refresh` / `refreshMarketplace()`;
+   * - `"none"` — register nothing at all, so `store/list` starts empty;
+   * - `"eager"` — fetch every declared source during boot.
+   *
+   * Omitted = the host's own policy (`download_on_start` per source, default
+   * `true`, so a declared source *is* downloaded unless it says otherwise).
+   * This is a process-scoped override: nothing is written to the user's config.
+   */
+  marketDownload?: "eager" | "lazy" | "none";
+  /**
+   * Config file for this child only (doc `37` §3.1). Sent as
+   * `AGENT_STORE_CONFIG`.
+   *
+   * Without it the host reads the per-user `~/.agent-store/config.toml` — which
+   * a spawned, SDK-owned host should not have to share. The data directory is
+   * independent of this (`dataDir`, always explicit).
+   */
+  configPath?: string;
   /** How long to wait for the readiness line. Defaults to 120s (cold DB init). */
   readyTimeoutMs?: number;
-  /** Extra environment variables, merged over the parent's `process.env`. */
+  /**
+   * Extra environment variables, merged over the parent's `process.env`.
+   *
+   * An entry here **wins over the typed options above** (`marketDownload`,
+   * `configPath`): the raw map is the caller's most specific statement, and
+   * nothing this factory derives should silently overwrite it.
+   */
   env?: Record<string, string | undefined>;
   /** Working directory for the child. Defaults to the parent's cwd. */
   cwd?: string;

package/dist/index.mjs

@@ -209,11 +209,30 @@ const KILL_GRACE_MS = 2e3;
 function assertProtocolCompatible(runtimeVersion) {
 	if (runtimeVersion !== APP_SERVER_PROTOCOL_VERSION) throw new Error(`protocol version mismatch: runtime speaks ${runtimeVersion}, SDK expects ${APP_SERVER_PROTOCOL_VERSION}`);
 }
+/**
+* The host-policy environment the typed options above expand to.
+*
+* The spawned host cannot be handed backend CLI flags: `apps/agent-store` parses
+* its own argv (`--host` / `--port` / `--data-dir` / `--no-open`) and has no
+* `--agent-store-config`, so a flag would make clap exit before the readiness
+* line. The parent environment is therefore the only channel a launcher has —
+* the same conclusion `NOMI_LOG_LEVEL` already documents for the log filter.
+*/
+function hostPolicyEnv(options) {
+	const env = {};
+	if (options.marketDownload !== void 0) env["AGENT_STORE_MARKET_DOWNLOAD"] = options.marketDownload;
+	if (options.configPath !== void 0) env["AGENT_STORE_CONFIG"] = options.configPath;
+	return env;
+}
 async function spawnAppServer(options = {}) {
 	const bin = resolveAppServerBin(options.bin);
 	const ownedDir = options.dataDir === void 0;
 	const dataDir = ownedDir ? await mkdtemp(join(tmpdir(), "agent-store-sdk-")) : options.dataDir;
 	const port = options.port ?? 0;
+	const policyEnv = {
+		...hostPolicyEnv(options),
+		...options.env
+	};
 	const { child, exited } = spawnRuntimeChild(bin, [
 		"--host",
 		"127.0.0.1",
@@ -223,7 +242,11 @@ async function spawnAppServer(options = {}) {
 		dataDir,
 		"--no-open",
 		...options.extraArgs ?? []
-	], options);
+	], {
+		...Object.keys(policyEnv).length > 0 ? { env: policyEnv } : {},
+		cwd: options.cwd,
+		onExit: options.onExit
+	});
 	const stderrTail = [];
 	child.stderr?.on("data", (chunk) => {
 		for (const line of String(chunk).split(/\r?\n/)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowy-agent-store/sdk",
-  "version": "0.1.0-beta.8",
+  "version": "0.1.0-beta.9",
   "description": "Node.js host for the Agent Store App Server: spawn the runtime binary and connect over loopback (docs/agent-store/12 P1-3)",
   "type": "module",
   "license": "Apache-2.0",
@@ -25,8 +25,8 @@
     "dist"
   ],
   "dependencies": {
-    "@flowy-agent-store/client": "0.1.0-beta.8",
-    "@flowy-agent-store/protocol": "0.1.0-beta.8"
+    "@flowy-agent-store/client": "0.1.0-beta.9",
+    "@flowy-agent-store/protocol": "0.1.0-beta.9"
   },
   "scripts": {
     "build": "tsdown",
@@ -40,10 +40,10 @@
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "optionalDependencies": {
-    "@flowy-agent-store/runtime-win32-x64": "0.1.0-beta.8",
-    "@flowy-agent-store/runtime-linux-x64": "0.1.0-beta.8",
-    "@flowy-agent-store/runtime-linux-arm64": "0.1.0-beta.8",
-    "@flowy-agent-store/runtime-darwin-x64": "0.1.0-beta.8",
-    "@flowy-agent-store/runtime-darwin-arm64": "0.1.0-beta.8"
+    "@flowy-agent-store/runtime-win32-x64": "0.1.0-beta.9",
+    "@flowy-agent-store/runtime-linux-x64": "0.1.0-beta.9",
+    "@flowy-agent-store/runtime-linux-arm64": "0.1.0-beta.9",
+    "@flowy-agent-store/runtime-darwin-x64": "0.1.0-beta.9",
+    "@flowy-agent-store/runtime-darwin-arm64": "0.1.0-beta.9"
   }
 }